Как выглядит хороший финальный handoff
Учимся писать честный итоговый отчет: что сделано, что проверено, какие gaps остались и что запрещенный scope не тронут.
Финальный handoff — это момент, где AI-агент либо помогает следующему шагу, либо создает туман. Плохой отчет говорит: «Всё готово». Хороший отчет разделяет факты: UI готов, progress работает через demo adapter, PostgreSQL runtime отсутствует, production storage disabled, проверки прошли, Scanner не изменялся. Такой отчет может быть менее эффектным, но он полезнее для реальной разработки.
В Grand Service финальный отчет особенно важен, потому что платформа модульная. Reviewer должен быстро понять, какие files созданы, какие изменены, какие dependencies добавлены или не добавлены, где migration, какие команды прошли, что осталось до production и были ли затронуты forbidden modules.
Структура итогового отчета
- 1Что сделано
Коротко перечисли пользовательские и технические изменения.
- 2Архитектурные решения
Объясни, почему выбран именно этот подход, особенно если есть fallback или scenario C.
- 3Файлы
Раздели created и changed files. Не прячь shared changes.
- 4Проверки
Укажи команды и результат. Для smoke опиши, какие сценарии проверялись.
- 5Ограничения
Честно назови production gaps и следующий шаг.
- 6Forbidden scope
Отдельно подтверди, что запрещенные файлы не изменялись.
- «Всё готово».
- Не говорит про storage fallback.
- Не перечисляет проверки.
- Не упоминает production gaps.
- Не подтверждает forbidden scope.
- UI и state описаны отдельно.
- Fallback назван явно.
- Проверки перечислены.
- Production gaps видны.
- Forbidden scope подтвержден.
Хороший handoff не пытается убедить, что всё идеально. Он дает следующему человеку точную карту реальности.
## Done
Implemented Phase 1 Academy content.
## Changed files
- src/features/ai-academy/content/courses.ts
## Validation
- tsc passed
- lint passed
- tests passed
- build passed
## Known limits
Persistence/auth/Docker unchanged.
## Forbidden scope
Scanner files were not modified.После хорошего handoff следующий агент или человек понимает, что можно деплоить, что нужно проверить вручную и какой technical debt остался.
- Есть список сделанного.
- Есть архитектурные решения.
- Есть created/changed files.
- Есть migrations и dependencies.
- Есть проверки.
- Есть known limitations.
- Есть production gaps.
- Есть forbidden scope confirmation.
Practice
A real WorkerHubs scenario for this lesson.
Финальное задание курса: придумай feature-модуль для Grand Service, напиши Codex handoff, определи forbidden scope, acceptance criteria и production gaps.