Skip to content
← Усі документи специфікації

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

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

Визначення

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

DWP є spec-driven: план є специфікацією, і агенти MUST виконувати за його явними критеріями приймання та валідаційними gate, а не імпровізувати. Специфікація — а не транскрипт чату — є стійким джерелом істини, тож робота є перевірюваною та відновлюваною між сесіями й агентами. Це також 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 жити під каталогом .dwp/ у gitignore в корені репозиторію.

Версіонування

Ця специфікація дотримується семантичного версіонування.