Handoff Note та Fresh Reviewer Pattern

Handoff — це відтворюваний стан

Handoff не зводиться до повідомлення «майже готово». Наступний учасник має зрозуміти, що зроблено, які файли змінено, які рішення прийнято, що підтверджено перевірками, які ризики залишилися і який конкретний наступний крок.

Інформація повинна спиратися на артефакти та докази, а не на памʼять автора.

Структура HANDOFF_NOTE.md

# HANDOFF_NOTE.md

## Мета
...

## Специфікація
- TASK_SPEC.md: ...
- Scope: ...

## Змінені файли
- ...

## Рішення
- ...

## Докази
- ...

## Тести та перевірки
- команда: результат

## Ризики
- ...

## Наступний крок
- ...

Пакет для fresh reviewer

• Fresh reviewer не повинен отримувати всю історію переписки.
• Окремий контекст зменшує вплив авторських припущень.
• Reviewer перевіряє scope, edge cases, API та відповідність handoff фактичним змінам.

1. Передайте TASK_SPEC.md.
2. Передайте HANDOFF_NOTE.md.
3. Додайте diff відносно базової гілки.
4. Додайте результати тестів і перевірок.
5. Опишіть фокус ревʼю та пріоритетні ризики.
6. Попросіть підтверджувати зауваження посиланням на diff, тест або інший доказ.

Не плутайте інженерні артефакти

Якісний handoff завершує milestone

Після handoff задача стає незалежнішою від памʼяті автора: інша сесія або людина може відновити контекст, перевірити прогалини та визначити наступну дію. Це фінальний артефакт контрольованої передачі, а не формальність перед завершенням.