Сначала спецификация.И вы читаете её раньше кода.

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

Вместо одного большого запроса и кучи кода работа проходит через документы, и каждый вы проверяете до того, как будет написан следующий.

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 прочтёт любой из них.

Вопросы о разработке через спецификации

Другие вопросы