Сначала спецификация, потом план и задачи, и только затем код. Spec Kit превращает этот порядок в набор команд в чате вашего агента: 148 661 звезда на GitHub и 43 ключа интеграций на 08.11.2026.
Spec-Driven Development (SDD) — способ работы, при котором агент сначала фиксирует, что и зачем строится, затем раскладывает это на план и задачи, и только после этого пишет код. GitHub Spec Kit — открытый набор инструментов под MIT, который делает такой порядок механическим: каждая фаза это команда в чате агента, а результат каждой фазы — файл в репозитории, который можно прочитать и отревьюить.
uv tool install specify-cli и specify init app --integration claude (ключ интеграции — под вашего агента). Дальше в чате агента: /speckit-constitution, /speckit-specify, /speckit-plan, /speckit-tasks, /speckit-implement, /speckit-converge — по одной команде за раз, с ревью результата. Нужны Python 3.11+ и пакетный менеджер uv.Кодинг-агент без спецификации додумывает требования: сам выбирает структуру, сам решает, что считать готовым, и уходит в сторону на третьем шаге. Спецификация превращает разговор в контракт: требования, границы, критерии приёмки. Дальше агент не «творит», а исполняет контракт — и это резко повышает долю задач, которые доходят до результата.
Spec Kit появился 21.08.2025 и к 08.11.2026 собрал 148 661 звезду и 13 355 форков при 1 898 коммитах за последние 52 недели — по данным GitHub API. В октябре 2026 проект вышел на версию 1.0 с расширенным набором инструментов (об этом авторы говорят в официальном видео Open Source Friday), а текущий релиз — v1.3.2.
Тренд шире одного инструмента: репозитории, которые формализуют контекст и правила для агентов, растут быстрее остальных. Ниже — сопоставимые цифры по четырём таким проектам.
В Spec Kit 1.x SDD — не единственный вход. Документация описывает три независимых процесса: сборка по спецификации, починка бага и оценка идеи. Это не обязательные фазы одного конвейера: багфикс и оценка ставятся отдельными расширениями и запускаются, когда нужны.
| Процесс | Как включить | Результат |
|---|---|---|
| SDD (сборка функции) | входит в ядро | спецификация, план, задачи, код и отчёт о сходимости |
| Bug fixing | specify extension add bug | оценка причины, ограниченный фикс, записанная проверка |
| Idea assessment | specify extension add assess | решение go / needs-clarification / kill с обоснованием |
Практический смысл: не нужно тащить полный цикл SDD ради исправления одной кнопки. Команды багфикса работают в отдельной папке .specify/bugs/<slug>/ и заканчиваются вердиктом verified, partial или failed — только первый означает, что симптом действительно ушёл.
Минимальный поток выглядит так: конституция проекта заводится один раз, остальные шаги повторяются для каждой функции. Команды выполняются в чате агента, по одной, с просмотром результата перед следующей — это прямое требование документации, а не стилистическая рекомендация.
| Команда | Что делает | Артефакт |
|---|---|---|
| /speckit-constitution | фиксирует принципы проекта | конституция в .specify/ |
| /speckit-specify | описывает функцию и критерии приёмки | спецификация |
| /speckit-plan | выбирает стек и структуру | план реализации |
| /speckit-tasks | режет план на задачи | список задач |
| /speckit-implement | пишет код по задачам | изменения в репозитории |
| /speckit-converge | сверяет результат со спецификацией | отчёт Converged |
Синтаксис слэш-команд зависит от агента: документация даёт таблицу интеграций и отдельную страницу про то, как вызывать команды в каждом ханессе. Поэтому примеры из статей «для Copilot» у вас в Claude Code или Codex могут выглядеть иначе — сверяйтесь с разделом интеграций.
Нужны Python 3.11+ и uv (официальный установщик пакетов от Astral). CLI ставится как обычный инструмент, затем инициализируется проект с ключом вашего агента — именно ключ определяет, в каком формате Spec Kit положит команды и шаблоны.
uv tool install specify-cli
specify init app --integration claude
cd app
/speckit-constitution
/speckit-specify
Ключи интеграций перечислены в разделе Integrations: claude, codex, copilot, cursor-agent, gemini, cline, opencode, qwen, goose, zed, tabnine, droid, amp, kimi, junie и другие — всего 43 строки в таблице, включая generic и none. Для существующего проекта есть отдельный how-to: Spec Kit умеет начинать с уже написанного кода, а не только с пустого каталога.
Spec Kit не требует принимать его методологию целиком. В README есть таблица механизмов: расширения добавляют команды и гейты, пресеты меняют шаблоны и терминологию, воркфлоу автоматизируют последовательности, оверлеи правят установленный воркфлоу без форка, а бандлы собирают готовую настройку под роль или команду.
specify extension search.SDD — это процесс, а не кнопка «сделай хорошо». Ниже — то, на чём чаще всего спотыкаются при внедрении, и чем подход отличается от привычных вариантов работы с агентом.
| Подход | Что даёт агенту | Где ломается |
|---|---|---|
| Один длинный промпт | задачу целиком | требования теряются, критериев готовности нет |
| План в чате | порядок шагов | план живёт в переписке и не ревьюится |
| SDD в Spec Kit | контракт и артефакты в репозитории | нужна дисциплина: одна команда — одно ревью |
Ограничение по существу одно: Spec Kit не оценивает качество вашей спецификации. Он гарантирует, что она существует, лежит в репозитории и связана с планом, задачами и кодом. Смысл требований остаётся на человеке — и это, пожалуй, самая честная часть подхода.
.specify/ и версионируются вместе с кодом, поэтому их можно ревьюить, сравнивать и передавать другому человеку или агенту.