Стандарт документации

Версия 1.0. Этот стандарт определяет, как Deep Work Plan документируют свою структуру, задачи и прогресс. Он применяется к каждому плану, созданному по методологии DWP. Ключевые слова MUST, SHOULD и MAY используются так, как определено в RFC 2119.

README плана

Каждый план MUST иметь README.md, содержащий:

Title — # Deep Work Plan: <name>.
Goal — прозаическая формулировка цели плана.
Source material — ссылки или пути к каноническим исходным данным (необязательно).
Tasks — таблица Markdown с номером задачи, именем и флажком статуса.
Status — строка в форме <n>/<total> tasks complete.

Файлы задач

Каждый файл задачи MUST называться <n>.task_<slug>.md и содержать анатомию из девяти разделов.

PROGRESS.md

PROGRESS.md — это журнал выполнения, в который можно только добавлять. Каждая запись MUST фиксировать:

Временную метку в формате ISO 8601.
Номер и имя задачи.
Что было сделано.
Любые отклонения или причины пропуска.

Маркеры статуса

[ ] — не начато.
[~] — в работе.
[x] — готово.
[!] — заблокировано.

Заголовки

Все заголовки MUST использовать написание с заглавной только первого слова. Документы SHOULD избегать маркетингового языка и восклицательных знаков.

Три обязательные финальные задачи

Каждый план MUST заканчиваться тремя стандартными задачами:

Security Review — проверить весь набор изменений плана на предмет секретов, рисков инъекций и новой поверхности атаки и убедиться, что docs/SECURITY.md по-прежнему отражает реальность. Критическая находка блокирует завершение.
Skills & Agents Discovery — выявить созданные переиспользуемые навыки и агентов.
Executive Report — сводка результатов для заинтересованных сторон.