agent-orchestrator

Load rule: Formal SoT below. Expand references/english-procedure.md only if a phase or handoff is still ambiguous. CLT: on-the-fly pre-filter ../rules/clt-dual-load.mdc (A8 DualLoad) — expand ../control-graph/references/clt-load-balance.md only if human/agent load tradeoff is ambiguous.

Purpose

Coordinate non-trivial work so workers implement and the orchestrator re-runs verify. Skip for one-file typo fixes.

Prerequisites

• Target repo AGENTS.md for verify cmds.
• Git worktrees for concurrent workers (git-worktrees).
• Brief template: references/task-brief.md.

Instructions

Orch ≔ coordinator   // you
W    ≔ workers        // one brief, one workspace, one DoD each
Triage ∈ { single_shot, light, full }
Wave  ∈ { spike, foundation, feature, hygiene }

A1  Workers never self-verify as final truth — Orch re-runs verify cmds
A2  Brief before delegate; commit in workspace before "done"
A3  Merge ≻ cp   // integration via git only ([git-worktrees](../git-worktrees/SKILL.md))
A4  Spike hard/unknown BEFORE mega-feature brief
A5  Resume = gap-only brief  — never re-delegate full original scope
A6  Compose control shape with [control-graph](../control-graph/SKILL.md); this skill = multi-worker logistics

Pair: git-worktrees · concurrent-cli-agents · split-to-prs · domain skills per worker.

Triage (~10s)

request → triage → single_shot | light | full
escalate: single_shot grows past ~2 files / new unknowns → stop → light|full

Full path

ORIENT → DECOMPOSE → SPIKE? → BRIEF → DELEGATE → VERIFY ⇄ fix-brief → INTEGRATE → REPORT

Orch may implement only if trivial or verify failed twice and inline fix is faster — say so.

Brief minimum

1. Problem · 2. Outcome (observable) · 3. Non-goals · 4. Standards (skills)
2. Files may/must-not · 6. Verify cmds (exact) · 7. Workspace · 8. Done artifact (commit)

Worker handback: SHA · cmds+exit · 2-sentence approach · limits.

Verify (Orch-owned)

Fail → fix brief (gap only), same workspace if possible. Never merge on testimony alone.

Resume

read last brief → git log/diff/worktree list → remaining gap (1¶) → "Resume: …" brief only

Defaults (override from target AGENTS.md): frozen lockfile when deps change; type-check + lint; React → react-client-expert; deps → fix-dependency-security; minimal diff.

Stack handoff: leave a pushed linear branch + per-PR SHAs. Confirm the final branch name with the user. Detail: references/english-procedure.md.

Examples

User: "Split this refactor across two agents. Do not merge on their word."

Agent: triage full. Write two disjoint briefs with exact verify cmds. Each worker gets one worktree. Orch re-runs every verify cmd, then merges via git (never cp). Report SHAs + leftover gaps.

User: "Fix the typo in README."

Agent: triage single_shot. Edit + verify. No worktree, no brief.

Limitations

• Not for one-file typo fixes (single_shot is the skip path).
• Orch must not both implement and "verify" the same large feature.
• Does not replace domain skills; workers load those.
• Graphite/gt session of the agent may not be the user's authenticated shell.

Troubleshooting

Report template

## Orchestrator summary
**Goal:** …
**Workers:** tool/branch → pass/fail
### Verified — commands + exit
### Integrated — merges
### Leftovers / next wave

Done when: triage mode chosen; if full — verify cmds passed on integration; user has report + leftovers.