handoff-protocols
Installation
SKILL.md
Handoff Protocols
A handoff is the moment one agent passes work to another — or to a human. It's where multi-agent systems most commonly fail. A dropped handoff means lost context, repeated work, or abandoned tasks.
Anatomy of a Handoff
Every handoff has:
- Trigger: What causes the handoff? (task completion, scope boundary, failure, user request)
- Source: Who is handing off?
- Destination: Who is receiving?
- Payload: What information transfers? (context, partial results, user state, instructions)
- Acknowledgment: How does the source know the destination received the handoff?
- User experience: What does the user see during the handoff?
Handoff Types
- Sequential: Agent A finishes, passes results to Agent B who continues. Like a relay race.
- Parallel fan-out: One agent distributes subtasks to multiple agents simultaneously.
- Parallel fan-in: Multiple agents' results converge back to one agent for synthesis.
- Escalation: An agent can't handle the task and passes up to a more capable agent or human.
- Fallback: The primary agent fails and a backup takes over.
- Human handoff: AI passes work to a human for review, decision, or completion.
Context Transfer
The most common handoff failure is context loss. Design what transfers:
- Full context: Everything the source agent knew. Safe but potentially overwhelming.