Разработка по спецификациям (Spec-Driven Development) строится на простом правиле: сначала фиксируется, что делаем, затем агент реализует задачу правил проекта. Официальный Spec Kit от GitHub предлагает полный конвейер: шаги constitution, specify, plan, tasks, implement и каталог.specify. В туториале на Habr описана адаптация без полного Spec Kit под один репозиторий в Cursor, когда разворачивать универсальный CLI нецелесообразно. Автор сокращает конвейер до формулы «черновик → спецификация → agreed → реализация» и трёх команд.
Вместо шести шагов остаются конституция, спецификация задачи и явное согласование человеком. Конституция в memory/constitution.md фиксирует цель проекта, границы, конвейер и запреты: агент не использует plan и tasks, не выставляет себе статус agreed и помечает неизвестное как [НЕ ИЗВЕСТНО]. Два слоя не смешиваются: слой смысла (Markdown, JSON, rules/skills) и слой результата (код, тесты, публикуемые документы). Пока нет статуса agreed, результат не пишется. В Cursor это собирается из.cursor/rules/*.mdc,.cursor/skills/*/SKILL.md и артефактов в репозитории.
| Слой | Назначение |
|---|---|
| Смысл и управление (Markdown, JSON, rules/skills) | Конституция, спецификации, черновики, фокус агента |
| Результат (код, тесты, публикуемые документы) | То, что попадает в продукт или на сайт документации |
Три команды: /project-init настраивает конституцию, видение 001 и feature.json; команда /project-specify превращает черновик в specs/NNN-*.md и обновляет указатель активной спецификации; команда /project-implement запускается только после согласования человеком. Автор замечает, что отдельные plan, clarify, tasks и массовая пересборка часто избыточны: они множат файлы и увеличивают шум для модели. Роли аналитика или технического писателя задаются текстом конституции, а не отдельными skill'ами. Такой минимальный Spec Kit сохраняет дисциплину методологии, но не требует тяжёлой инфраструктуры.
