Спершу специфікація.І ви читаєте її раніше за код.

Цикл: специфікація, рев’ю, план, рев’ю, завдання, збірка

Замість одного великого запиту й купи коду робота проходить через документи, і кожен ви перевіряєте до того, як буде написано наступний.

1. Специфікація: що й навіщо

   Що функція має робити, для кого і чого робити не повинна. Поки без назв файлів і вибору технологій.

2. План: як

   Підхід: які частини змінюються, в якому порядку, з якими ризиками. План підпорядкований специфікації.

3. Завдання: маленькі кроки

   Чек-лист, яким агент іде й позначає пункти; кожне завдання достатньо мале, щоб його перевірити.

4. Збірка

   Лише тепер агент пише код, спираючись на документи, які ви вже прочитали.

Короткий шаблон специфікації

Специфікація не мусить бути довгою. Шести заголовків досить, щоб упіймати більшість непорозумінь:

# Feature name

## Goal
## Non-goals
## Users
## Requirements
## Edge cases
## Open questions

Non-goals і Open questions — ті розділи, які люди пропускають, а агентам вони потрібніші за все. Агент, якому сказали, чого не будувати й що ще не вирішено, запитає, а не гадатиме.

Як це робити в Claude Code, Codex і Cursor

Усі три вміють писати документи, і в кожного є plan mode для кроку планування: plan mode у Claude Code, plan mode у Codex і plan mode у Cursor.

Щоб рев’ю відбувалося автоматично, додайте в CLAUDE.md або AGENTS.md одне правило: написавши специфікацію чи план, надішли їх мені через request_review у DotMD і чекай. Тоді агент зупиняється після кожного документа й чекає ваших коментарів або затвердження, не витрачаючи токени. DotMD може додати правило за вас: див. CLAUDE.md і AGENTS.md.

Рев’ю, що масштабується

Чат — погане місце для рев’ю документа. Натомість ви читаєте специфікацію відмальованою в DotMD, виділяєте хибний уривок і натискаєте ⌥⌘M. Коментар прив’язаний до своїх рядків, тож агент точно знає, що ви маєте на увазі. Можна спершу написати всі коментарі й надіслати їх одразу.

Коли агент їх виправив, кожну зміну видно у файлі: старий текст червоним, новий зеленим, поруч із коментарем, на який вона відповідає. Кожну — Accept або Reopen. DotMD також перелічує зміни, про які ніхто не просив. Див. Перевірка змін.

Для другої думки нехай спершу перевірить інший агент. Специфікація, написана Claude Code і прокоментована Codex, приходить до вас із уже позначеними очевидними прогалинами, а ви вирішуєте, які зауваження отримає автор: Агент перевіряє агента.

Інструменти для розробки через специфікації

• Звичайний Markdown у репозиторії. Тека docs/specs і шаблон вище — це повноцінне налаштування.
• Plan mode. Власний спосіб кожного агента планувати, перш ніж будувати.
• GitHub Spec Kit. Набір інструментів із відкритим кодом, який дає вашому агентові команди для кожного кроку й пише за вас spec.md, plan.md і tasks.md: GitHub Spec Kit.

Що б ви не обрали, документи — це Markdown-файли, і DotMD прочитає будь-який із них.

Запитання про розробку через специфікації

Інші запитання