Приложение C. Чек-листы и шаблоны

Это приложение можно использовать как быстрый справочник во время работы с проектом.

Чек-лист перед созданием спецификации

• понятна цель фичи;
• известна аудитория;
• есть границы работы;
• есть то, что не входит в работу;
• известны ограничения стека;
• есть хотя бы один проверяемый результат;
• понятно, какая фаза дорожной карты реализуется;
• не требуется секрет или доступ, которого нет в локальной среде.

Чек-лист перед реализацией

• requirements.md создан;
• plan.md создан;
• validation.md создан;
• спецификация закоммичена;
• агенту переданы ссылки на файлы, а не длинная история чата;
• текущая ветка чистая или понятна;
• границы фичи не спорят с tech-stack.md;
• в плане нет несвязанных рефакторингов.

Чек-лист перед запросом на слияние

• все изменённые файлы связаны с фичей;
• обязательные факты из validation.md проверены;
• проваленные факты явно перечислены;
• отложенные факты имеют причину;
• новые хуки и MCP-серверы ревьюились;
• секреты не попали в спецификации, логи и память;
• CHANGELOG.md обновлён, если проект его ведёт;
• дорожная карта обновлена или есть причина не обновлять её в этой ветке.

Шаблон запроса на слияние

## Спецификация

- Папка: `specs/YYYY-MM-DD-feature-name/`
- Фаза дорожной карты:

## Что изменено

- 

## Факты проверки

- [ ] `npm run typecheck`
- [ ] `npm test`
- [ ] 

## Непроверенные или отложенные факты

- 

## Изменения вне границ фичи

- Нет / перечислить:

## Что ревьюеру проверить особенно внимательно

- 

Шаблон ретроспективы

# Ретроспектива SDD

## Что спецификация описала правильно

## Что агенту пришлось вывести самому

## Что поймала проверка

## Какие факты были слабыми

## Что перенести в QWEN.md или specs/

## Что убрать из процесса

Чек-лист для новой сессии после /clear

• агент прочитал QWEN.md или AGENTS.md;
• агент прочитал mission.md;
• агент прочитал tech-stack.md;
• агент прочитал нужную папку фичи;
• агент знает, какие файлы нельзя менять;
• агент знает, какие команды проверки ожидаются;
• агент остановится после отчёта, если задача только исследовательская.

Минимальный запрос для ревью реализации

/clear
Прочитай @QWEN.md, спецификацию текущей фичи и git diff.
Сравни реализацию с requirements.md, plan.md и validation.md.
Покажи:
- совпадения;
- расхождения;

- непроверенные факты;
- изменения вне границ фичи.
Файлы не изменяй.

Минимальный запрос для перепланирования

/clear
Прочитай @specs/mission.md, @specs/tech-stack.md, @specs/roadmap.md,
недавние спецификации фич и @CHANGELOG.md.
Покажи, что нужно обновить перед следующей фазой.
Файлы не изменяй, пока я не одобрю.