← use cases

Ship parallel features

You want to ship feature A, feature B, and feature C. Each takes roughly two hours of agent time and twenty minutes of your review. Serially that is six and a half hours. In parallel it is about two and a half. The math is simple. The blocker is the working copy.

the problem

agents stepping on each other

If two Claude Code agents both write to the same working directory, they corrupt each other's output. Agent 1 edits src/auth/login.ts. Agent 2 reads the same file for context, then writes a different version. One agent's work wins. The other is lost.

the worktree fix

Git worktrees give each agent its own checkout of the repository on its own branch. The files do not share a directory. Both agents can write simultaneously. Conflicts only surface at merge time, when you're ready to handle them — not mid-task, when they corrupt the work.

walkthrough

when this breaks down

Parallel features are safe when the features are independent. The model breaks when two features touch the same shared artifact:

- - - - - - - - - - - - - - - -

See also: Pane vs Conductor for a comparison of parallel-agent workflows across tools. Read more about worktree isolation at /worktrees.