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
41 lines
2.4 KiB
Markdown
41 lines
2.4 KiB
Markdown
# 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-protocols` skill
|
|
|
|
## 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
|
|
- **`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/`
|
|
- **`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
|
|
- **Agent Registry:** `/home/papa/atomizer/workspaces/shared/AGENTS_REGISTRY.json`
|
|
- **`[DELEGATE:agent "task"]` syntax does NOT work** — never use it. Always use `orchestrate.sh` or 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/`
|