Docs/Multi-agent

Orchestrator

A planner and merger that splits big goals into parallel tasks.

The Orchestrator (Orchestra, OrchestraModal.tsx) is built for big engineering goals.

Flow

  1. Planner — breaks the goal into independent subtasks (tasks) with a dependency graph (DAG).
  2. Workers — each task runs in parallel in its own isolated Git worktree (e.g. three agents at once: Claude, AGY, Codex) and passes its own tests.
  3. Merge and conflict resolution — finished task branches are merged; if a conflict appears, the Planner resolves it automatically.
  4. Reviewer — reviews the merged change as a whole, then applies it to your working tree or opens a new branch + pull request in one click.

Run it from the terminal

orchestrate orchestra "Move the REST API endpoints to a GraphQL schema" \
  --planner claude \
  --workers claude,agy,codex \
  --reviewer claude \
  --parallel 3 \
  --max-rounds 2