Handoff Workflow
Write a handoff file when work is incomplete and a future agent needs context beyond what TASKS.md contains.
Steps
- Update TASKS.md with current status, next steps, and any newly discovered tasks
- Write the handoff file at
handoffs/<name>.mdusing the template atreferences/template.md - Verify claims — re-read key files referenced in the handoff. Check that paths exist, stated facts match current code/data, and branch state is accurate. Handoffs with stale claims waste the next agent's time.
- Commit the handoff file and TASKS.md update