Spec Kit

Основная идея

Docs объясняют продукт человеку, а Spec Kit превращает эти решения в проверяемые требования и задачи. Для 0.1.0 и 0.2.0 созданы отдельные спецификации, планы, контракты и сценарии приёмки. Агент начинает с выбранной спецификации и сохраняет согласованные границы версии. Наличие плана не означает, что функции уже реализованы.

Где что лежит

Путь в репозитории	Содержание
.specify/memory/constitution.md	Принципы: простота, права команды, изоляция, работа с копией и проверяемый результат
specs/product-context.md	Миссия, рынок, цена, пользовательский путь, UI и будущие эксперименты
specs/001-mvp-site-security/	0.1.0: свой агент, снимок, scan, исправление и восстановление копии
specs/002-securify-agent-chat/	0.2.0: чат Securify и Agentfy/Bridle под капотом
specs/sources.md	Соответствие всех страниц docs спецификациям
specs/analysis.md	Проверка согласованности и вопросы до реализации

Внутри версии spec.md описывает требования, plan.md — архитектуру, tasks.md — порядок работ. research.md хранит принятые и открытые решения, data-model.md и contracts/ — данные и операции, quickstart.md — приёмку. Подробности установки и работы находятся в specs/README.md.

Как работать с агентом

Например:

Прочитай AGENTS.md, конституцию и specs/001-mvp-site-security. Возьми следующую незавершённую задачу, проверь её зависимости и открытые решения. Сначала объясни ожидаемый результат и способ проверки.

В новых сессиях Codex доступны навыки $speckit-clarify, $speckit-plan, $speckit-tasks, $speckit-analyze, $speckit-implement и другие. Это команды агенту, не команды терминала. Для существующего плана просите обновить нужный документ; не создавайте заново тот же scope через specify.

Для проверки файлов выбранной версии из корня:

SPECIFY_FEATURE_DIRECTORY=specs/001-mvp-site-security   .specify/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasks

Установлен Spec Kit 0.13.0, Codex skills mode. Шаблоны и навыки находятся в репозитории, runtime-зависимости приложений не менялись. На другом компьютере CLI можно установить через uv tool install 'specify-cli==0.13.0' --python 3.11. Повторный init после клонирования не нужен.

Как не получить две разные правды

Изменили решение — обновите spec и соответствующую страницу docs в одной задаче. Ссылки на источники есть в specs/sources.md. Код показывает фактическое состояние; спецификация — требуемое. Новое явное решение пользователя важнее старого документа. При противоречии агент фиксирует его и синхронизирует тексты.

В 0.1.0 локальные задачи связаны с эпиками SECU-1…SECU-8. Основа SECU-9 помечена выполненной по merge commit; остальные задачи — план, а не созданные issues Jira. Задачи 0.2.0 тоже пока локальные. Автоматически отправлять их в Jira или GitHub не нужно.

Что предстоит уточнить

Вход, миграции и матрица прав решены в G01 (specs/001-mvp-site-security/research.md), но не реализованы; антивирус, образ и профиль изоляции решены в G04. До соответствующей реализации: лимиты хранения, конкретный MCP-клиент, первый класс исправления, политика FTP. Для 0.2.0 дополнительно — реальный контракт Agentfy/Bridle, хранение диалога и восстановление соединения. Эти вопросы имеют свои задачи и не спрятаны за выдуманными значениями по умолчанию.

Архитектура 0.1.0 · Архитектура 0.2.0 · Официальный Spec Kit