AI For Dummies — Agents and trees
← ROUTE MAP
02 / AGENTS & TREES
field guide ↗
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
FRAME
Orchestrator
Owns scope, task graph, boundaries, and integration.
HAND OFF
Worker
Owns one coherent slice and one worktree.
PROVE
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.
Previous: models →
Rules case study →
Try the rules lab →
