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