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

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

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

Related Skills

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