grey-haven-context-management

# Context Management Skill

Multi-agent workflow orchestration with state persistence, handoff patterns, and resumable workflows.

## Description

This skill enables sophisticated multi-agent workflows through context save/restore operations, supporting sequential handoffs, parallel execution, conditional routing, and long-running resumable workflows.

## Token Efficiency Awareness

Multi-agent architectures have significant token costs. Understand the multipliers:

| Architecture | Token Multiplier | Example (10K input) |
|--------------|------------------|---------------------|
| Single agent | 1x | 10K tokens |
| Agent + tools | 4x | 40K tokens |
| Multi-agent | 15x | 150K tokens |

**Key insight**: A 3-agent workflow costs ~15x more than a single agent. Design accordingly.

## What's Included

### Examples (`examples/`)
- **Sequential handoff** - Linear 4-phase workflow (Design → Implement → Test → Deploy)
- **Parallel execution** - Full-stack feature with frontend + backend + tests (2.25x speedup)
- **Conditional routing** - Dynamic agent selection based on results
- **Resumable workflows** - Checkpoint-based long-running tasks

### Reference Guides (`reference/`)
- **Complete reference** - Save/restore operations, workflow patterns, performance optimization
- **Token efficiency** - Token multipliers, attention budget, context optimization strategies
- **Troubleshooting guide** - 6 issue categories with solutions (save failures, restore failures, performance, corruption)
- **Best practices** - Context design, handoff patterns, error handling, security

### Templates (`templates/`)
- **JSON Schema** - Context structure validation with required/optional fields
- **Context templates** - Ready-to-use structures for different workflow types

### Checklists (`checklists/`)
- **100-point verification** - Comprehensive validation across 10 categories with weighted scoring

## Workflow Patterns

1. **Sequential Handoff** - Agent A → Context Save → Agent B → Context Save