feat: add Atomizer HQ multi-agent cluster infrastructure
- 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
This commit is contained in:
40
hq/workspaces/manager/TOOLS.md
Normal file
40
hq/workspaces/manager/TOOLS.md
Normal file
@@ -0,0 +1,40 @@
|
||||
# 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/`
|
||||
Reference in New Issue
Block a user