| name | handoff |
| description | Use when work needs to survive losing context โ before a /clear on a long task, when pausing something unfinished, when handing over to a teammate or the next session, or when the context window is filling up on multi-day work. |
MasterMind โ Handoff
Context is the fundamental constraint (~/.mastermind/engineering/core/agent-loop.md); a long task shouldn't lose its thread to a
reset. Capture just enough to resume cold โ high signal, low tokens.
Capture
- Goal โ the outcome being built, in one line.
- State โ Done / In-progress / Next, as a short checklist. Be honest about what's not verified.
- Key decisions & why โ the non-obvious choices and their rationale (so they aren't relitigated).
- Map โ where the relevant code/files/config live; the entry points.
- Gotchas โ traps, failing things, env quirks, anything that bit you.
- How to resume & verify โ the exact command(s)/check to pick up and confirm green.
Rules
Summarize, don't dump โ link or point to detail rather than pasting it. Write it where the next session
will look (HANDOFF.md, a scratch file, or the issue). Prune it when the work completes.
Output
A tight HANDOFF.md: goal, state checklist, decisions, file map, gotchas, resume+verify steps.