Antoine
3289a76e19
- 8-agent OpenClaw cluster (Manager, Tech-Lead, Secretary, Auditor, Optimizer, Study-Builder, NX-Expert, Webster) - Orchestration engine: orchestrate.py (sync delegation + handoffs) - Workflow engine: YAML-defined multi-step pipelines - Agent workspaces: SOUL.md, AGENTS.md, MEMORY.md per agent - Shared skills: delegate, orchestrate, atomizer-protocols - Capability registry (AGENTS_REGISTRY.json) - Cluster management: cluster.sh, systemd template - All secrets replaced with env var references
2.1 KiB
2.1 KiB
OP_09 — Agent Handoff Protocol
Purpose
Defines how agents pass work to each other in a structured, traceable way.
When to Use
- Manager assigns work to a specialist
- One agent's output becomes another's input
- An agent needs help from another agent's expertise
Handoff Format
When handing off work, include ALL of the following:
## Handoff: [Source Agent] → [Target Agent]
**Task:** [What needs to be done — clear, specific, actionable]
**Context:** [Why this is needed — project, deadline, priority]
**Inputs:** [What the target agent needs — files, data, previous analysis]
**Expected Output:** [What should come back — format, level of detail]
**Protocol:** [Which protocol applies — OP_01, SYS_15, etc.]
**Deadline:** [When this is needed — explicit or "ASAP"]
**Thread:** [Link to relevant Slack thread for context]
Rules
- Manager initiates most handoffs. Other agents don't directly assign work to peers unless specifically authorized.
- Always include context. The target agent shouldn't need to search for background.
- One handoff per message. Don't bundle multiple tasks.
- Acknowledge receipt. Target agent confirms they've received and understood the handoff.
- Report completion. Target agent posts results in the same thread and notifies the source.
Escalation
If the target agent can't complete the handoff:
- Reply in the same thread explaining why
- Propose alternatives
- Manager decides next steps
Examples
Good Handoff
## Handoff: Manager → Technical Lead
**Task:** Break down the StarSpec M1 WFE optimization requirements
**Context:** New client project. Contract attached. Priority: HIGH.
**Inputs:** Contract PDF (attached), model files in knowledge_base/projects/starspec-m1/
**Expected Output:** Parameter list, objectives, constraints, solver recommendation
**Protocol:** OP_01 (Study Lifecycle) + OP_10 (Project Intake)
**Deadline:** EOD today
**Thread:** #starspec-m1-wfe (this thread)
Bad Handoff
@technical do the breakdown thing for the new project
(Missing: context, inputs, expected output, deadline, protocol)