Worktrees

Coordinate multiple Claude agents working in parallel on the same codebase using git worktrees.

Key Concept

Workers are separate Claude sessions, not subagents. The Manager creates worktrees, then the user opens a new terminal in each worktree and runs claude. Each Claude instance operates independently.

Concepts

• PLAN.md — Coordination document listing workstreams, file ownership, and decisions
• STATUS-{name}.md — Progress updates from each workstream (REQUIRED before merge)
• Manager — Plans on main branch, creates/merges worktrees, monitors progress
• Worker — Executes in worktree, respects file ownership, writes status

Determine Your Role