86 lines
2.9 KiB
Markdown
86 lines
2.9 KiB
Markdown
# 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.
|
|
|
|
## 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
|
|
- **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 → Agent C
|
|
2. **Parallel Execution** - Parent spawns 3 agents → Merge results → Integration
|
|
3. **Conditional Routing** - Analyze → Route based on conditions → Targeted agent
|
|
4. **Resumable Long-Running** - Checkpoints enable resume after interruption
|
|
|
|
## Performance Metrics
|
|
|
|
- **Context Size**: Target <100KB for 80% of workflows
|
|
- **Serialization**: <200ms (P99)
|
|
- **Restore**: <500ms (P99)
|
|
- **Speedup**: 2-3x faster with parallel execution
|
|
|
|
## Use This Skill When
|
|
|
|
- Building multi-agent workflows
|
|
- Need state persistence across sessions
|
|
- Coordinating multiple agents on complex tasks
|
|
- Implementing resumable long-running processes
|
|
- Optimizing workflow execution time
|
|
|
|
## Related Agents
|
|
|
|
- `context-manager` - Automated context save/restore with validation
|
|
- `tdd-orchestrator` - Multi-agent TDD workflows
|
|
- `incident-responder` - Multi-phase incident response
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
# View workflow examples
|
|
cat examples/feature-development-handoff.md
|
|
cat examples/parallel-workflow-example.md
|
|
|
|
# Check reference guides
|
|
cat reference/INDEX.md
|
|
cat reference/workflow-best-practices.md
|
|
|
|
# Use context schema
|
|
cat templates/context-schema-template.json
|
|
|
|
# Validate context
|
|
cat checklists/context-verification-checklist.md
|
|
```
|
|
|
|
## Security
|
|
|
|
- ✅ Never save secrets in context (use secret references)
|
|
- ✅ Implement access control for context files
|
|
- ✅ Sanitize before saving (remove API keys, passwords)
|
|
- ✅ Use relative file paths (not absolute)
|
|
|
|
---
|
|
|
|
**Skill Version**: 1.0
|
|
**Last Updated**: 2025-01-15
|