Files
Atomizer/hq/workspaces/manager/TOOLS.md
Antoine 3289a76e19 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
2026-02-15 21:18:18 +00:00

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-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/