spec-first: открытый плагин, где спека проходит ревью свежим агентом до первой строки кода
Этап AI SDLC: Требования → Спека-агентMIT-плагин превращает спека-первую разработку в конвейер: спека с фактами «файл:строка», скрипт проверяет каждую ссылку, свежий агент без истории чата ревьюит спеку до кода (BUILD / BUILD WITH CUTS / REFUSE), коммит проходит только через зелёные проверки. На методе построена открытая фабрика Agent Smith: 1 300+ спек, 650+ через гейт.
Что произошло
27 октября на Hacker News вышло обсуждение spec-first — открытого (MIT) метода и плагина для Claude Code, оформляющего спека-первую разработку как конвейер из четырёх команд. create-spec пишет цель, шаги, критерии готовности и факты со ссылками на файлы и строки — в отдельной ветке и worktree, ещё без кода. review-spec сначала скриптом проверяет, что каждая ссылка на файл и строку существует, затем свежий агент без истории чата атакует спеку против кода; вердикт — BUILD, BUILD WITH CUTS или REFUSE, каждая находка — с файлом и строкой. apply-spec строит по спеке и логирует неочевидные выборы в decisions/, deliver-spec проводит коммит через гейт: пока сборка и тесты зелёные, коммит не пройдёт.
Каждая спека живёт в своей ветке и worktree; серии спек собираются параллельно группами, где файлы не пересекаются, и сходятся в один pull request. Помимо Claude Code, тот же порядок работает в Codex, Cursor и Copilot — через AGENTS.md и git-хук на коммит.
Метод вырос из открытой «агентной фабрики» Agent Smith, которая строится этим же способом: по счётчикам на сайте, в октябре 2026 там выполнено более 1 300 спек, написано 1 190+ файлов решений и 650+ спек прошли через гейт. Обсуждение на HN собрало 34 балла; сам репозиторий молодой — 32 звезды.
Почему это важно
Требования — этап, где агент чаще всего молча строит не то: ошибка спеки обходится дороже всего, а ловится позже всех. Показательна связка проверок: подтверждение фактов (каждая ссылка резолвится в коде), adversarial-ревью свежим экземпляром без «заражённого» чатом контекста и гейт на коммит. Это три дешёвые механики, которые переносятся в любой харнесс и без плагина. Экономика простая: REFUSE на спеке стоит одну спеку, без ревью та же ошибка стоила бы ветку. Ограничения: проект автора метода, цифры — из его собственной фабрики, независимых внедрений пока немного.
Что с этим делать
- Заберите паттерн «ревью спеки свежим агентом»: новый экземпляр без истории чата, код как есть, вердикт с файлом и строкой по каждой находке.
- Проверьте свои спеки скриптом: ссылка на файл:строку, которая не открывается, — это допущение, и оно должно быть помечено как допущение.
- Для крупных изменений попробуйте серии: независимые спеки строятся параллельно в разных worktree и сходятся в один PR.