У бандлов оговорены гарантии, которые редко кто формулирует явно: info показывает ровно то, что добавит install; установка идемпотентна и не выходит за корень проекта; remove не трогает компоненты, которые нужны другому установленному бандлу; и все команды работают офлайн против локальных или закреплённых источников.
Два бандла ядра идут с расширениями, которые стоит знать отдельно. Расширение bug даёт повторяемый цикл "оценить, починить, проверить" - чтобы агент не прыгал от описания бага сразу к патчу, не подтвердив диагноз. Расширение assess превращает сырую идею в решение "делаем, надо уточнить, не делаем" через отдельный процесс из пяти шагов.
Чужой код никто не смотрел
Это надо прочитать до первой команды extension add. Предупреждение стоит в репозитории дважды, слово в слово:
Сопровождающие только проверяют, что запись в каталоге полна и корректно оформлена, - они не проводят ревью, не аудируют, не одобряют и не поддерживают код самого расширения. Изучайте исходный код расширения перед установкой и используйте на своё усмотрение.
При 158 общественных расширениях в каталоге это не формальность.
Что значит 1.0
Версия 1.0.0 вышла 21 августа 2026 года, ровно через год после первого коммита. И тут проект делает то, чего от юбилейного релиза обычно не ждут.
В README прямо сказано: 1.0.0 достигнута не потому, что работа закончена или форма проекта заморожена, а потому, что проект вырос во что-то связное и полезное. Юбилейный пост ведущего сопровождающего определяет смысл цифры ещё резче: теперь это просто число. Логика такая - раз агенты делают адаптацию к изменениям радикально дешевле, ценность смещается от стабильности к приспосабливаемости.
Список изменений это подтверждает: в записи 1.0.0 нет ни одного слома совместимости, там обычные правки и обновления каталогов. Смены мажорной версии в привычном смысле не произошло.
Темп при этом такой, что закреплять тег релиза при установке - совет не теоретический. В журнале изменений 217 выпусков. В июле 2026 года их было двадцать восемь, то есть примерно каждый день.
Что стоит знать заранее
Проект заточен под новое, а не под существующее. Фазы развития перечислены прямо: разработка с нуля, параллельное исследование вариантов и итеративное развитие. Для существующего кода есть отдельное руководство и правило разделять обновление инструментария и эволюцию артефактов в specs/, но входить в чужую кодовую базу этим процессом заметно сложнее, чем начинать с пустого каталога.
Цифры на витрине живут своей жизнью. Документация заявляет 38 интеграций, 157 расширений, 33 пресета и 270 с лишним участников. Первое и третье сошлись с подсчётом по каталогам, во втором каталог на одну запись впереди текста. Это нормальный люфт, но брать эти числа как измерение не стоит.
Версия в исходниках не равна версии релиза. В pyproject.toml на основной ветке стоит 1.0.2.dev0, тогда как последний релиз - 1.0.1. Это обычная последовательность разработки, а не расхождение.
Git значится в требованиях README без оговорок, хотя руководство по установке помечает его как опциональный, нужный только при включённом расширении git. Верно второе.
Всё работает офлайн. Проверка окружения, установка из локально собранных пакетов, каталоги на своём хостинге - для закрытых контуров это предусмотрено отдельно, а не получилось случайно.
Ошибки первого знакомства
Начать со /speckit.plan. Без спецификации планировать нечего: только specify обязателен перед plan.
Обсуждать стек в спецификации. Это единственное правило, которое повторяется в документации чаще всех остальных: в спеке - что и зачем, стек - в плане.
Проставить галочки в чеклисте за ревьюера. Они означают, что человек проверил качество требований, а не что код написан. Агент их менять не должен.
Считать, что git checkout переключает фичу. Не переключает: активная фича лежит в .specify/feature.json.
Запустить implement одним куском на крупной фиче. Документация советует резать по фазам и проверять результат каждой.
Остановиться после implement. Цикл закрывает converge, и повторять его надо, пока не сойдётся.
Поставить общественное расширение не глядя. Их код никто не смотрел, и авторы говорят об этом прямым текстом.
Запустить specify init в CI без --non-interactive. Команда повиснет на выборе агента стрелками.
Установить без закреплённого тега. При двадцати восьми релизах в месяц воспроизводимость держится только на теге.
Если свести к одной фразе: Spec Kit продаёт не автоматизацию, а порядок - и главная его ценность не в том, что агент напишет код быстрее, а в том, что к моменту написания вы уже приняли решения, которые иначе принял бы за вас он.
Источники
Статья сверена с репозиторием github/spec-kit (ветка main) 25 августа 2026 года: README, pyproject.toml, CHANGELOG.md, docs/index.md, docs/quickstart.md, docs/installation.md, docs/reference/core.md, docs/reference/agentic-sdd.md, extensions/README.md и каталоги catalog.json и catalog.community.json для интеграций, расширений и пресетов. Количества интеграций, расширений и пресетов пересчитаны по каталогам, а не взяты из текста документации. Звёзды, форки и номер последнего релиза сняты в тот же день; проект выпускает релизы почти ежедневно, поэтому версии устаревают за считанные дни.
