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 Worker
Owns one coherent slice and one worktree.
Verifier
Re-runs gates and reports remaining gaps.
Handoff
Context that
can travel.
Brief Goal, owned files, dependencies, non-goals, acceptance.
Isolation One branch and worktree per independent change.
Evidence Commands, result, changed files, screenshots, gaps.