From claude-commands
Invokes Agent Orchestrator with strict parameter fidelity, verifying spawned sessions match requested agent, runtime, and project. Reports session IDs, target PRs, and worker health.
How this command is triggered — by the user, by Claude, or both
Slash command
/claude-commands:aocommands/The summary Claude sees in its command listing — used to decide when to auto-load this command
# /ao — Strict AO usage Use AO with parameter fidelity. User-specified AO constraints are mandatory. ## Read first - `~/.hermes/agent-orchestrator.yaml` — **ALWAYS read this first** to resolve `--agent` shorthands (e.g. `agy`=`antigravity`); `defaults.agent` is the default when none specified - `~/.claude/skills/agent-orchestrator/SKILL.md` — default workflow (start / spawn / status / send / cleanup) ⚠️ FILE MISSING — skill not yet created - `~/.claude/skills/ao-worker-dispatch/SKILL.md` — pre-dispatch checklist (venv, commit discipline, branch drift, CodeRabbit verify) - `~/.claude/skil...
Use AO with parameter fidelity. User-specified AO constraints are mandatory.
~/.hermes/agent-orchestrator.yaml — ALWAYS read this first to resolve --agent shorthands (e.g. agy=antigravity); defaults.agent is the default when none specified~/.claude/skills/agent-orchestrator/SKILL.md — default workflow (start / spawn / status / send / cleanup) ⚠️ FILE MISSING — skill not yet created~/.claude/skills/ao-worker-dispatch/SKILL.md — pre-dispatch checklist (venv, commit discipline, branch drift, CodeRabbit verify)~/.claude/skills/ao-operator-discipline/SKILL.md — strict parameter fidelity + post-spawn verification~/.claude/skills/ao-spawn-gate/SKILL.md — pre-spawn safety gate~/.claude/skills/ao-session-monitor/SKILL.md — proper tmux inspection for live workers~/.claude/skills/ao-model-override/SKILL.md — override the worker's model (e.g. claude-sonnet-4-6, claude-opus-4-7) WITHOUT editing ~/.hermes/agent-orchestrator.yaml. Use whenever the user names a specific model and the project default isn't it (e.g. "use claude sonnet with AO"). ao spawn has NO --model flag; the only inline override is AO_CONFIG_PATH pointing at a temp copy of the config — the skill ships spawn-with-model.sh for this.Respect explicit AO parameters exactly:
--agent--runtime--project--claim-prNever substitute another agent/runtime because defaults exist.
After every ao spawn, verify the spawned session file under ~/.agent-orchestrator/.../sessions/<session>:
agent=<expected>runtimeHandle.data.launchCommand contains the expected CLIIf the user asked for Codex workers, the session must show:
agent=codexlaunchCommand contains codexAfter metadata verification, inspect the tmux pane with at least 20 lines:
tmux capture-pane -pt <tmux-session>:0.0 -S -40If verification fails, kill and replace the worker. Do not continue with a mismatched worker.
When reporting AO setup or supervision, include:
agent=<expected>launchCommand$ARGUMENTS
npx claudepluginhub jleechanorg/claude-commands --plugin claude-commands/cc-orchestrateDeploys pre-built agent team templates for multi-agent orchestration in development tasks. Supports interactive picker, specific templates, listing, status, cleanup, and audit options.
/session-initInitializes Claude session as Main Agent orchestrator with delegation-first workflow rules for task analysis, subagent coordination, parallelization, and reviews.
/orchestrateRuns a sequential multi-agent workflow for complex tasks — planning, implementation, review, and security audit — with structured handoffs and a final report.
/orchestrate-taskDecomposes complex development tasks into structured YAML workflows with agent assignments, dependencies, priorities, and parallel execution groups.