928 B
928 B
HANDOFF block (the return contract)
Every specialist returns this exact shape as its final message. It is what makes work resumable cold. Keep it short — links and paths over prose. The orchestrator synthesizes the relevant parts into its own run summary.
## HANDOFF — <agent-name> — <YYYY-MM-DD HH:MM>
**Asked:** one line — what this run was dispatched to do.
**Did:** bullet list of concrete actions. Reference files as path:line.
- …
**State now:** build = pass/fail · tests = N pass / M fail · what compiles, what doesn't.
**Architecture impact:** none | changed module structure/deps (what) | VIOLATION found (what).
**Blockers / open questions:** decisions or info needed before continuing. "none" if clean.
**Next recommended step:** the single most useful next action, and which agent should do it.
**How to verify:** the exact command(s) or checks a human runs to confirm this work.