- name
- handoff
- description
- >
- version
- 1.0.0
- author
- Adapted from Gas Town
Handoff - Session Cycling
Hand off your current session while preserving work context.
Triggers
| Command | Action |
|---|---|
ho | Auto-detect mode (create or resume) |
ho [message] | Create handoff with context notes |
ho create | Force CREATE mode |
ho resume | Force RESUME mode |
ho resume <track> | Resume specific track |
/conductor-finish | Complete track (extract learnings, archive, handoff) |
Aliases: ho, /handoff, /conductor-handoff
When to Use
- Context getting full (approaching token limit)
- Finished a logical chunk of work
- Need a fresh perspective on a problem
- Session cycling requested
Quick Start
# Simple handoff
ho
# With context notes
ho "Found bug in auth.go line 145"
# Resume in new session
ho resumeWhat Persists vs Resets
| Persists | Resets |
|---|---|
Beads state (bd) | Conversation context |
| Git state | TodoWrite items |
| Handoff files | In-memory state |
| Agent Mail messages |
Implementation
See references for detailed workflows:
- create.md - CREATE mode (9 steps)
- resume.md - RESUME mode (9 steps)
- template.md - Handoff file template
Auto-Detect Logic
IF first_message AND recent_handoff_exists(<7d)
→ RESUME mode
ELSE IF handoff_exists(>=7d)
→ WARN "Stale handoff" → CREATE mode
ELSE
→ CREATE modeDirectory Structure
conductor/handoffs/
├── <track-id>/
│ ├── index.md # Log of all handoffs
│ └── YYYY-MM-DD_HH-MM_*.md # Individual handoffs
└── general/
└── index.mdAgent Mail Integration
- Subject:
[HANDOFF:<trigger>] <track> - <context> - Thread:
handoff-<track_id> - Search:
search_messages(query="HANDOFF")
Error Handling
| Scenario | Action |
|---|---|
| Agent Mail unavailable | Markdown-only |
bd unavailable | Skip Beads sync |
| Stale handoff (>7d) | Warn, suggest fresh start |
| No handoffs found | Suggest /handoff create |
Related Skills
- tracking - Issue tracking
- maestro-core - Workflow routing