Skill: Craft Handoff
"A handoff is a gift to your future self."
When
Create a handoff when:
- Ending a session
- Task is complete
- Blocked and switching focus
- Delegating to a sub-agent
The Standard
- Location:
handoffs/NNN-topic.mdin branch memory. - Sequence: Increment NNN from last handoff.
- Content: What was done, decisions, next steps, learnings.
- Brevity: One page max. Future you needs signal, not noise.
The Protocol
- Determine trigger: Why are we creating this handoff?
- Summarize done: What was accomplished this session?
- List decisions: What choices were made and why?
- Define next: What should the next session do first?
- Extract learnings: What patterns or insights emerged?
- Save: Write to
handoffs/NNN-topic.md.
The Anti-Patterns
| Don't | Do | Why |
|---|---|---|
| Dump full context | Summarize key points | Brevity is clarity |
| Skip decisions | Record with rationale | Decisions are cheap to forget |
| Omit blockers | State what's stuck | Prevents wasted cycles |
| Forget learnings | Capture insights | Compound knowledge |
Template
See templates/handoff.md.
Loading
Handoffs are loaded automatically on session resume. Your future self will see it.