handoff

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:

1. Read it silently
2. Tell the user: "Found a handoff from a previous session: [title]. [1-sentence goal]. Resume from here?"
3. 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