| name | handoff |
| description | Manages context transfer between AI coding sessions. Activates when HANDOFF.md exists, when user mentions handoff/resume, or when ending significant work. |
Handoff Detection
On Session Start
Check if HANDOFF.md exists in the working directory. If found:
- Read it silently
- Tell the user: "Found a handoff from a previous session: [title]. [1-sentence goal]. Resume from here?"
- If they agree, follow
/handoff:resume flow
Trigger Words
Activate when user says: "handoff", "hand off", "pass this to", "continue later", "pick up where", "transfer context", "save state", "resume", "take over"
Creating vs Resuming
- User wants to create: They're wrapping up or switching agents → use
/handoff:create
- User wants to resume: They're starting fresh with existing handoff → use
/handoff:resume
Proactive Suggestions
Consider suggesting a handoff when:
- User says "I need to go" or "let's stop here"
- A significant milestone is reached
- You've been working for a long time with lots of context
Say: "Want me to create a handoff so you (or another agent) can continue later?"
Commands
| Command | Use When |
|---|
/handoff:create | Full handoff with all context |
/handoff:quick | Minimal handoff, just essentials |
/handoff:resume | Continue from existing handoff |
