Updated on 2026-08-14

.claude/docs/agent-toolkit/templates/HANDOFF.md

@@ -0,0 +1,24 @@
+# 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.
+```