Orchestrator
Owns scope, task graph, boundaries, and integration.
Subagent workflow
One branch
per hand.
Agents work when roles, files, and evidence are bounded. A worktree gives each worker its own checkout while the orchestrator protects intent.
The tree
Split at
the seam.
MAIN / ORCHESTRATOR
├── agent/ui → components + visual states
├── agent/tests → acceptance + regressions
└── agent/docs → guide + examples
merge after each leaf returns a diff and evidence Orchestrator main ● clean
UI worker agent/ui ● working
Test worker agent/tests ● ready
Docs worker agent/docs ● review
Worker
Owns one coherent slice and one worktree.
Verifier
Re-runs gates and reports remaining gaps.
Handoff
Context that
can travel.
-
01 Brief Goal, owned files, dependencies, non-goals, acceptance. -
02 Isolation One branch and worktree per independent change. -
03 Evidence Commands, result, changed files, screenshots, gaps.