academylessonsgood final handoff

AI Academy

Active
AI Academy/Building Grand Service with AI/Проверка и передача результата

Как выглядит хороший финальный handoff

Учимся писать честный итоговый отчет: что сделано, что проверено, какие gaps остались и что запрещенный scope не тронут.

Not started25 min

Финальный handoff — это момент, где AI-агент либо помогает следующему шагу, либо создает туман. Плохой отчет говорит: «Всё готово». Хороший отчет разделяет факты: UI готов, progress работает через demo adapter, PostgreSQL runtime отсутствует, production storage disabled, проверки прошли, Scanner не изменялся. Такой отчет может быть менее эффектным, но он полезнее для реальной разработки.

В Grand Service финальный отчет особенно важен, потому что платформа модульная. Reviewer должен быстро понять, какие files созданы, какие изменены, какие dependencies добавлены или не добавлены, где migration, какие команды прошли, что осталось до production и были ли затронуты forbidden modules.

Структура итогового отчета

  1. 1
    Что сделано

    Коротко перечисли пользовательские и технические изменения.

  2. 2
    Архитектурные решения

    Объясни, почему выбран именно этот подход, особенно если есть fallback или scenario C.

  3. 3
    Файлы

    Раздели created и changed files. Не прячь shared changes.

  4. 4
    Проверки

    Укажи команды и результат. Для smoke опиши, какие сценарии проверялись.

  5. 5
    Ограничения

    Честно назови production gaps и следующий шаг.

  6. 6
    Forbidden scope

    Отдельно подтверди, что запрещенные файлы не изменялись.

Слабый отчет
  • «Всё готово».
  • Не говорит про storage fallback.
  • Не перечисляет проверки.
  • Не упоминает production gaps.
  • Не подтверждает forbidden scope.
Сильный отчет
  • UI и state описаны отдельно.
  • Fallback назван явно.
  • Проверки перечислены.
  • Production gaps видны.
  • Forbidden scope подтвержден.
Хороший handoff не пытается убедить, что всё идеально. Он дает следующему человеку точную карту реальности.
Практика AI-assisted delivery
final-report-outline.mdmd
## 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-модуль и handoff

Финальное задание курса: придумай feature-модуль для Grand Service, напиши Codex handoff, определи forbidden scope, acceptance criteria и production gaps.

Опиши feature и один вертикальный срез.
Напиши handoff для Codex.
Составь ownership map и forbidden scope.
Определи проверки и финальный отчет.
Отдельно назови, что не будет production ready в первой итерации.

Resources