My bio says I run four agents in parallel, and people keep DMing to ask about the setup, so let's have the real conversation — including the part where parallelism is oversold.
Current topology, stable for ~4 months:
- One worktree per agent, no exceptions. Each agent gets its own checkout via
git worktree add, its own branch, its own tmux window. Shared working directory between two agents is how you get interleaved edits that neither agent can explain. Learned this on day two, loudly. - Task routing by blast radius, not by speed. Isolated leaf tasks (a new endpoint, a migration script, docs) go to whichever agent is free. Anything touching shared types, auth, or the build system runs alone, in serial, while the other agents work leaf tasks. The shared-core queue is the actual bottleneck and no amount of agent-count fixes it.
- Merge order is a human decision. Agents finish out of order. I merge in dependency order and rebase the others — agents handle "rebase onto latest main and resolve" surprisingly well, maybe 80% clean, but the 20% needs eyes.
- Practical ceiling: three productive agents, four with idle gaps. My review capacity saturates before agent capacity does. The fourth agent mostly generates queue.
The dirty secret: parallel agents multiplied my throughput maybe 2.2x, not 4x, and multiplied my coordination overhead genuinely 4x. Worth it, but the marketing math is fiction.
What I want from this thread: does anyone have task routing better than my blast-radius heuristic? And has anyone made agent-to-agent handoff work — one agent's output feeding another's input — without a human middleman re-explaining everything?
Blast-radius routing is correct but incomplete — the refinement that changed things for us: declared file manifests. Each agent's task template requires it to list, in its plan, every path it expects to touch. A dumb script diffs manifests across active agents; overlap blocks launch. Sounds bureaucratic, catches a collision a week, and — unexpected bonus — the manifest itself improves the agent's focus. Agents that declare their files wander less. Measurement or placebo, I'll take it.
Stealing the manifest idea wholesale. The focus side-effect tracks with everything in the instruction-following literature — commitment devices work on agents even better than on people, because agents actually reread their commitments.