Skip to content
← Все документы спецификации

Спецификация DWP

Версия 1.0. Статус: стабильная. Этот документ является нормативной спецификацией методологии Deep Work Plan (DWP). Ключевые слова MUST, MUST NOT, SHOULD, SHOULD NOT и MAY следует трактовать так, как описано в RFC 2119.

Определение

Deep Work Plan — это структурированный артефакт на основе только Markdown, описывающий сложную инженерную задачу, разложенную на последовательные, пригодные для ревью единицы работы, и предназначенный для создания, выполнения и сопровождения ИИ-агентами разработки, работающими автономно.

DWP является spec-driven: план — это спецификация, и агенты MUST выполнять работу по её явным критериям приёмки и validation gates, а не импровизировать. Спецификация, а не чат-транскрипт, является долговечным источником истины, поэтому работа проверяема и возобновляема между сессиями и агентами. Это также harness-инженерия, ставшая переносимой: контекст, цикл управления, ограничители и возобновляемое состояние, которые делают агента надёжным, устанавливаются в сам репозиторий как обычный Markdown, так что любой соответствующий агент MAY пилотировать репозиторий без фреймворка, привязанного к инструменту.

Структура плана

План MUST быть каталогом в .dwp/plans/ с именем PLAN_<slug>/. Каталог MUST содержать:

  • README.md — обзор плана, цель, таблица задач и статус.
  • По одному файлу на задачу с именем <n>.task_<slug>.md.
  • PROGRESS.md — текущий журнал выполнения.

Анатомия задачи

Каждый файл задачи MUST содержать эти девять разделов по порядку:

  1. Goal — формулировка в один абзац того, чего достигает задача.
  2. Context — предыстория, ссылки и почему эта задача существует.
  3. Steps — упорядоченные, конкретные действия для выполнения.
  4. Acceptance criteria — чек-лист условий, определяющих готовность.
  5. Validation — команды или тесты, которые нужно запустить для проверки.
  6. Files — пути, которые предполагается создать или изменить.
  7. Dependencies — другие задачи или внешние предпосылки.
  8. Risks — что может пойти не так и меры по смягчению.
  9. Completion & Log — маркер статуса плюс хронологические заметки.

Цикл выполнения

DWP определяет пять операций:

  • create — создаёт новый план из цели.
  • execute — выполняет план задача за задачей.
  • refine — изменяет существующий план.
  • resume — возобновляет прерванный план.
  • status — отчитывается о статусе плана без выполнения.

Выходное рабочее пространство

Все артефакты DWP MUST жить в игнорируемом git-ом каталоге .dwp/ в корне репозитория.

Версионирование

Эта спецификация следует семантическому версионированию.