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:resumeflow
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 |
Source: willseltzer/claude-handoff — distributed by TomeVault.