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

Соответствие

Версия 1.0. Статус: стабильная. Этот документ определяет, что значит для репозитория быть соответствующим Deep Work Plan — то есть AI-first и пилотируемым агентами. Ключевые слова MUST, MUST NOT, SHOULD, SHOULD NOT и MAY следует трактовать так, как описано в RFC 2119.

Соответствие существует для того, чтобы «AI-first» был объективным, проверяемым свойством, а не впечатлением. Репозиторий либо отвечает приведённым ниже критериям, либо нет. Под-навык verify (/dwp-verify) проверяет их механически.

Соответствующий репозиторий

Соответствующий DWP репозиторий MUST удовлетворять всему перечисленному. Каждый артефакт MUST быть осмыслен под репозиторий — адаптирован к его реальным языкам, фреймворкам и командам. Универсальная заглушка, placeholder или содержимое, скопированное из другого репозитория, не удовлетворяет критерию.

  1. AGENTS.md в корне. Репозиторий MUST содержать корневой AGENTS.md, который включает (a) индекс документации, (b) обязательные правила для репозитория и (c) блок Quick Commands, команды которого реальны и исполнимы в этом репозитории. Команды-заглушки (например, npm test в репозитории, не использующем npm) MUST NOT присутствовать.
  2. CLAUDE.md разрешается в AGENTS.md. CLAUDE.md MUST существовать и разрешаться в AGENTS.md (символьная ссылка или эквивалент, гарантирующий единый источник истины). Эти два файла MUST NOT расходиться.
  3. Иерархия docs/. Репозиторий MUST содержать каталог docs/, охватывающий стандартные категории (архитектура, стандарты, тестирование, команды разработки, безопасность и онбординг агента) с реальным, специфичным для репозитория содержимым. Сложные модули SHOULD нести собственный README.md.
  4. Дом .agents/. Репозиторий MUST содержать каталог .agents/ с agents/, commands/ и skills/, а также каталог в .agents/docs/, который соответствует тому, что есть на диске. Команды dwp-* MUST быть тонкими делегаторами к установленному навыку. Путь .claude MUST разрешаться в .agents.
  5. Игнорируемое git-ом рабочее пространство .dwp/. Репозиторий MUST содержать каталог .dwp/ с plans/ и drafts/, и .dwp/ MUST быть игнорируемым git-ом. Черновое пространство tmp/ SHOULD существовать и SHOULD быть игнорируемым git-ом.
  6. Навык методологии разрешим. Навык Deep Work Plan MUST быть установлен или подключён так, чтобы агент в репозитории мог вызывать его под-навыки.

Репозиторий полностью соответствует стандарту и с нулём дополнений. Дополнения (devcontainer, Dailybot, dependency-upgrade) принимаются по желанию и MUST NOT требоваться для соответствия.

Хорошо сформированный план

Deep Work Plan в .dwp/plans/ хорошо сформирован, когда:

  1. Каждая задача MUST объявлять явные границы, критерии приёмки и хотя бы один validation gate (команду или проверку, которая объективно проходит или не проходит).
  2. План MUST сохранять прогресс так, чтобы работа переживала прерывание и могла быть возобновлена другим агентом.
  3. План MUST включать две обязательные финальные задачи — Skills & Agents Discovery и Executive Report.
  4. Задачи SHOULD заново привязываться к цели плана перед выполнением, чтобы предотвратить отклонение на длинном горизонте.

Проверка соответствия

Соответствие SHOULD проверяться механически, а не осмотром. Запуск /dwp-verify формирует отчёт «прошёл/не прошёл» относительно приведённых выше критериев: наличие и реальное содержимое AGENTS.md, разрешение CLAUDE.md, категории docs/, совпадение каталога .agents/ с диском, статус gitignore для .dwp/ и tmp/, а для плана — то, что каждая задача несёт критерии приёмки и validation gate.

Репозиторий SHOULD перепроверяться после онбординга и после каждого завершённого плана, чтобы соответствие поддерживалось, а не утверждалось единожды.