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

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

Версія 1.1. Статус: стабільний. Цей документ визначає, що означає, аби репозиторій був відповідним 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. Посібник із тестування MUST визначати реальний інструментарій тестів, lint і перевірки типів — або, для репозиторію, що його не має, конкретне налаштування, запропоноване зі стеку під час онбордингу. Порожній посібник із тестування чи «без тестів» не задовольняє цей критерій: без визначеного способу валідувати поведінку план не має обʼєктивного валідаційного gate.
  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, design-system) приймаються явно та MUST NOT бути обовʼязковими для відповідності.

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

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

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

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

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

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