---

name: handoff description: > Hand off to a fresh session. Use when context is full, you've finished a logical chunk of work, or need a fresh perspective. Integrates with Maestro workflow. 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

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 resume

What 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 mode

Directory Structure

conductor/handoffs/
├── <track-id>/
│   ├── index.md                    # Log of all handoffs
│   └── YYYY-MM-DD_HH-MM_*.md       # Individual handoffs
└── general/
    └── index.md

Agent 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

• beads - Issue tracking
• maestro-core - Workflow routing