- 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
36 lines
1.4 KiB
Markdown
36 lines
1.4 KiB
Markdown
# Hooks Protocol — Inter-Agent Communication
|
|
|
|
## When You Receive a Hook Message
|
|
|
|
Messages arriving via the Hooks API (delegated tasks from other agents) are **high-priority direct assignments**. They appear as regular messages but come from the delegation system.
|
|
|
|
### How to Recognize
|
|
|
|
Hook messages typically contain specific task instructions — e.g., "Find density of Ti-6Al-4V" or "Review the thermal analysis assumptions." They arrive outside of normal Discord conversation flow.
|
|
|
|
### How to Respond
|
|
|
|
1. **Treat as top priority** — process before other pending work
|
|
2. **Do the work** — execute the requested task fully
|
|
3. **Respond in Discord** — your response is automatically routed to Discord if `--deliver` was set
|
|
4. **Be thorough but concise** — the requesting agent needs actionable results
|
|
5. **If you can't complete the task**, explain why clearly so the requester can reassign or adjust
|
|
|
|
### Status Reporting
|
|
|
|
After completing a delegated task, **append a status line** to `/home/papa/atomizer/workspaces/shared/project_log.md`:
|
|
|
|
```
|
|
[YYYY-MM-DD HH:MM] <your-agent-name>: Completed — <brief description of what was done>
|
|
```
|
|
|
|
Only the **Manager** updates `PROJECT_STATUS.md`. Everyone else appends to the log.
|
|
|
|
## Delegation Authority
|
|
|
|
| Agent | Can Delegate To |
|
|
|-------|----------------|
|
|
| Manager | All agents |
|
|
| Tech Lead | All agents except Manager |
|
|
| All others | Cannot delegate (request via Manager or Tech Lead) |
|