Приложение A. Как учебник соотносится со Spec Kit и Kiro
В этом учебнике используется авторский диалект SDD для Qwen Code:
mission.md
tech-stack.md
roadmap.md
requirements.md
plan.md
validation.mdЭто не единственный возможный формат. Spec Kit и Kiro решают похожую задачу, но называют артефакты иначе и по-другому делят этапы.
Главное различие
В учебнике validation.md вынесен в отдельный файл. Это сделано намеренно: агенту и человеку нужен явный набор фактов, который решает, можно ли сливать ветку.
В других системах эта идея может быть распределена по задачам, проверочным спискам, анализу плана или критериям приёмки.
Таблица соответствия
| Учебник | Spec Kit | Kiro | Смысл |
|---|---|---|---|
mission.md | конституция проекта | steering-файлы | зачем существует проект |
tech-stack.md | конституция и план | steering-файлы, design | технические ограничения |
roadmap.md | порядок спецификаций и задач | список фич и задач | порядок фаз |
requirements.md | /speckit.specify и /speckit.clarify | requirements | что нужно построить |
plan.md | /speckit.plan и /speckit.tasks | design и tasks | как разбить реализацию |
| validation.md | частично /speckit.analyze, проверочные списки и задачи | критерии в задачах и тестах | какие факты допускают к слиянию | | QWEN.md | правила агента для интеграции | steering-файлы | как агент должен вести себя в проекте | | навыки Qwen Code | команды, расширения и пресеты | agent hooks и steering | повторяемый процесс |
Как переносить процесс
Если команда использует Spec Kit, не обязательно навязывать ей имена файлов из этого учебника. Переносите смысл:
- конституция проекта должна быть явной;
- неоднозначности нужно уточнять до плана;
- план должен отделять архитектурные решения от списка задач;
- проверочные факты должны быть видны до реализации;
- реализация должна сравниваться с артефактами, а не с памятью чата.
Если команда использует Kiro, переносите три слоя:
- steering-файлы для постоянных правил;
- specs для конкретных фич;
- задачи и тесты как проверяемый путь к реализации.
Зачем учебнику свой формат
Формат учебника специально проще, чем промышленные наборы команд.
Причины:
- файлы легко прочитать без специальной CLI-утилиты;
- Qwen Code может работать с ними напрямую;
validation.mdделает проверку отдельным этапом мышления;
- структура подходит для маленького проекта и для переноса в другой агент;
- читатель видит процесс, а не только команду вроде
/speckit.implement.
Недостаток тоже есть: в большой команде придётся добавить соглашения о запросах на слияние, владельцах дорожной карты, ревью спецификаций и шаблонах задач. Эти темы раскрыты в части 16.
Как выбрать формат
Используйте формат учебника, если:
- вы учитесь SDD;
- проект маленький;
- команда хочет видеть все решения в обычных Markdown-файлах;
- нужен процесс без зависимости от конкретной платформы.
Используйте Spec Kit, если:
- команда хочет готовые команды и шаблоны;
- нужен отдельный шаг уточнения неоднозначностей;
- важны расширения, пресеты и повторяемые рабочие процессы;
- проектов несколько и требуется единый стандарт.
Используйте Kiro, если:
- команда уже работает в Kiro;
- нужны встроенные specs, steering-файлы и агентные хуки;
- важна тесная интеграция с IDE-процессом.
Формат не должен становиться религией. Главное, чтобы намерение, план, проверка и решения жили в ревьюируемых артефактах.