- 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.4 KiB
2.4 KiB
TOOLS.md — Manager
Shared Resources
- Atomizer repo:
/home/papa/repos/Atomizer/(read-only) - Obsidian vault:
/home/papa/obsidian-vault/(read-only) - Job queue:
/home/papa/atomizer/job-queue/(read-write)
Skills
atomizer-protocols— Company protocols (load every session)atomizer-company— Company identity + LAC critical lessons
Key Files
- QUICK_REF:
/home/papa/repos/Atomizer/docs/QUICK_REF.md - Protocols: loaded via
atomizer-protocolsskill
Agent Communication
orchestrate.sh— Synchronous delegation with result return (PRIMARY)- Script:
/home/papa/atomizer/workspaces/shared/skills/orchestrate/orchestrate.sh - Usage:
bash orchestrate.sh <agent> "<task>" [--timeout N] [--context file] [--retries N] [--validate] [--caller manager] [--no-deliver] - Returns structured JSON:
{"status":"complete|partial|blocked|failed", "result":"...", "confidence":"high|medium|low", "notes":"..."} - Handoff dir:
/home/papa/atomizer/handoffs/ - Max 2 attempts total (1 original + 1 retry). Then stop and report failure.
- Chaining: Save result to file → pass via
--context→ describe contents in task text
- Script:
workflow.py— YAML workflow engine for multi-step orchestration- Script:
/home/papa/atomizer/workspaces/shared/skills/orchestrate/workflow.py - Wrapper:
/home/papa/atomizer/workspaces/shared/skills/orchestrate/workflow.sh - Usage:
python3 workflow.py <workflow-name-or-path> [--input key=value ...] [--caller manager] [--dry-run] [--non-interactive] [--timeout N] - Workflows dir:
/home/papa/atomizer/workspaces/shared/workflows/
- Script:
metrics.py— Orchestration metrics and stats- Script:
/home/papa/atomizer/workspaces/shared/skills/orchestrate/metrics.py - Usage:
python3 metrics.py [json|text] - Shows: per-agent success rates, latencies, workflow completion stats
- Script:
- Agent Registry:
/home/papa/atomizer/workspaces/shared/AGENTS_REGISTRY.json [DELEGATE:agent "task"]syntax does NOT work — never use it. Always useorchestrate.shor Discord @mentions.- Discord @mentions — For ongoing work, discussions, FYI (fire-and-forget)
sessions_send/sessions_spawn— OpenClaw internal (within same instance only)
Knowledge Base
- LAC insights:
/home/papa/repos/Atomizer/knowledge_base/lac/ - Project contexts:
/home/papa/repos/Atomizer/knowledge_base/projects/