# Приложение A. Как учебник соотносится со Spec Kit и Kiro

В этом учебнике используется авторский диалект SDD для Qwen Code:

```text
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-процессом.

Формат не должен становиться религией. Главное, чтобы намерение, план, проверка и решения жили в ревьюируемых артефактах.