Почему handoff должен быть самодостаточным
Учимся передавать агенту состояние проекта, решения, ограничения и критерии приемки без длинной переписки.
Handoff — это не архив всей переписки. Это компактный документ, который позволяет следующему агенту продолжить работу без повторного открытия каждого старого решения. Хороший handoff отвечает на четыре вопроса: что за проект, что уже принято, чем владеет агент сейчас и как понять, что работа закончена.
В кейсе AI Academy handoff менялся по мере развития. Сначала он описывал большую архитектуру Knowledge Hub. Затем задача была сужена до Phase 1 MVP. После этого появился отдельный handoff на аудит persistence: не менять UI, изучить auth/database infrastructure, выбрать A/B/C и не изобретать новый DB stack. Каждый handoff передавал не историю эмоций, а актуальное состояние решения.
Шаблон handoff
# Project context
What Grand Service is and where this feature lives.
# Current state
What is already implemented and accepted.
# Owned scope
Files and behavior the agent may change.
# Forbidden scope
Files, modules and infrastructure that must not change.
# Task
The next concrete objective.
# Constraints
Technical and product limits.
# Validation
Commands and manual checks.
# Final report
What must be reported at the end.Самодостаточность не означает длинноту. Наоборот: handoff должен быть сжатым. Если в нем 40 пунктов истории, агент начнет терять приоритет. Если в нем нет текущего состояния, агент будет угадывать. Сильный handoff похож на техническое задание для одного рывка: достаточно контекста, минимум шума, ясный критерий готовности.
- Много исторических деталей.
- Решения размазаны по сообщениям.
- Неясно, что актуально сейчас.
- Сложно передать другому агенту.
- Фиксирует текущее состояние.
- Отделяет scope от forbidden scope.
- Содержит проверки.
- Готов к передаче без устных пояснений.
Если уже принято решение не добавлять PostgreSQL client, это должно быть написано. Если Scanner запрещен, это должно быть написано. Иначе агент может выбрать «логичный» путь, который конфликтует с текущей фазой проекта.
- Handoff можно понять без старой переписки.
- Есть Current state.
- Есть Owned scope и Forbidden scope.
- Есть validation commands.
- Есть ожидаемый final report.
Practice
A real WorkerHubs scenario for this lesson.
Представь, что ты передаешь другому агенту модуль, где UI готов, но persistence еще временный. Напиши handoff, который не скрывает этот technical gap.