Відповідність

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

Відповідність існує для того, щоб «AI-first» був обʼєктивною, перевірюваною властивістю, а не враженням. Репозиторій або задовольняє наведені нижче критерії, або ні. Суб-скіл verify (/dwp-verify) перевіряє їх механічно.

Відповідний репозиторій

Відповідний DWP репозиторій MUST задовольняти все наведене нижче. Кожен артефакт MUST бути осмислений для репозиторію — адаптований до його реальних мов, фреймворків та команд. Загальна заглушка, плейсхолдер чи вміст, скопійований з іншого репозиторію, не задовольняє критерій.

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. Робочий простір .dwp/ у gitignore. Репозиторій MUST містити каталог .dwp/ з plans/ та drafts/, і .dwp/ MUST бути в gitignore. Робочий простір tmp/ SHOULD існувати та SHOULD бути в gitignore.
6. Скіл методології розвʼязуваний. Скіл Deep Work Plan MUST бути встановлений чи на нього є посилання так, щоб агент у репозиторії міг викликати його суб-скіли.

Репозиторій є повністю відповідним з нульовою кількістю add-on. Add-on (devcontainer, Dailybot, dependency-upgrade) приймаються явно та MUST NOT бути обовʼязковими для відповідності.

Коректний план

Deep Work Plan у .dwp/plans/ є коректним, коли:

1. Кожне завдання MUST оголошувати явний обсяг, критерії приймання та щонайменше один валідаційний gate (команду чи перевірку, що обʼєктивно проходить або ні).
2. План MUST зберігати прогрес, щоб робота переживала переривання та могла бути відновлена іншим агентом.
3. План MUST містити два обовʼязкові фінальні завдання — Skills & Agents Discovery та Executive Report.
4. Завдання SHOULD заново привʼязуватися до мети плану перед виконанням, щоб запобігти дрейфу на тривалому горизонті.

Перевірка відповідності

Відповідність SHOULD перевірятися механічно, а не оглядом. Запуск /dwp-verify видає звіт «пройдено/не пройдено» за наведеними вище критеріями: наявність та реальний вміст AGENTS.md, розвʼязання CLAUDE.md, категорії docs/, відповідність каталогу .agents/ диску, статус gitignore для .dwp/ та tmp/, а для плану — що кожне завдання несе критерії приймання та валідаційний gate.

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