← All pillsAgents and automation · 8 Nov 2026Pro

Parallel AI Agents: 5 Rules to Avoid the Chaos

How do you get several AI agents to work together without clashing? Five rules tested on real projects: split tasks, small teams, roles and routing.

Several AI agents working together can finish a job in a third of the time. Or they trip over each other and leave you redoing half the code. Five rules make the difference, and you can use them in your next session.

What It Is

Running agents in parallel means having several sessions open at once, each on one piece of the work. They can be several windows of the same agent (for example several Claude Code sessions) or agents with different roles: one plans, one writes, one reviews. You coordinate them, or an agent that hands out the tasks does.

Why It Matters

A single agent does one thing at a time, and you wait. In our tests, parallel work paid off: five Claude Code sessions on independent tasks in the same project ran 3.7 times faster than a single session (March 2026).

But 12% of the work had to be redone, because the sessions collided on the same parts of the code. The bottleneck was not the model. It was the way we had split the work. The rules below keep the speed and remove the collisions.

1. Split the Work by Area, Not by File

What it is: giving each agent an area of the product (payments, search, user profile) instead of a list of files.

Why it matters: locking one file at a time is not enough. Two agents editing different files of the same feature still collide, because they change the same rules from two sides. In our tests, this is where almost all the rework came from.

How to do it:

  1. Before starting the sessions, ask an agent to split the work into independent tasks by area.
  2. If two tasks touch the same area, merge them or run them one after the other.
  3. Give each session its own copy of the project. In git this is a worktree: a separate folder for each branch of work, so nobody overwrites anybody else.
  4. Merge the results one at a time, starting with the smallest.

Ready to copy:

Ready to copy

I want several agents to work in parallel on this project. Here is the work: [list the changes]. Split it into independent tasks by product AREA, not by file. For each task write: name, area, files it will probably touch, what it must NOT touch. Then check for overlaps: if two tasks touch the same area or the same files, flag it and suggest whether to merge them or queue them. No more than four tasks in parallel. If more are needed, put them in a second wave.

2. Keep the Team Small: Three or Four Agents

What it is: a cap on how many agents work together.

Why it matters: more agents do not mean more intelligence. They mean more coordination to pay for. In our experience, the team that works is three or four agents: beyond that, the time spent coordinating eats the gain.

How to do it: start with two or three. Let agents talk rarely and only when needed: no constant back-and-forth, but a written handoff at the end of each task (what I did, what I changed, what is left). Only the coordinator reads every handoff. This is the rule that holds up best in production: rare, clear communication beats constant chatter.

3. Give Every Agent a Role and Put a Reviewer on the Team

What it is: a small team with fixed jobs, like a real one.

Why it matters: an agent that writes with nobody reading its work produces mediocre code. When we rewrote three features of a business management system with a team of four agents (planner, backend, frontend, reviewer), the work went 2.8 times faster than a single agent (February 2026, with Claude Opus 4.6). The more useful number is another one: the code was ready to merge on the first pass, because review happened inside the team.

How to do it: write a short brief for each role. The reviewer writes no code: it reads, tests and sends work back.

Ready to copy

You are the REVIEWER on this team. You do not write new code. For each handoff you receive: read the changes, run the tests, check that the task only touched its own area. Reply with APPROVED or REDO. If REDO, write at most three precise points, with file and reason, and send it back to the agent that wrote it. Do not approve anything you have not tested.

4. Let a Small Model Route the Tasks

What it is: a router, a lightweight agent that reads each request and passes it to the right specialist.

Why it matters: we replaced one do-everything agent with seven specialists (frontend, backend, SQL, testing, security, documentation, review) and a router built on Claude Haiku, the small, fast model. Across 300 real client tasks, the router picked the right agent 91% of the time. In a blind review, output quality rose 23% and total cost fell 31%. The router cost less than a tenth of the work it routed. The pattern: a small model to route, a bigger one (Sonnet, in our case) to do the work. As models become more alike, how you organise them matters more.

How to do it: the router should answer with one word, so it is fast and cheap. Give it the list of specialists and a way out for unclear cases.

Ready to copy

You are a router. Read the request and reply with ONE word from this list: frontend, backend, sql, testing, security, documentation, review. If the request touches several areas, pick the one with the main change. If you are not sure, reply: ask. REQUEST: [text]

To choose which model to use at each step based on cost, read cost-aware routing.

5. Make Every Agent's Work Visible

What it is: one place where you see every session, every task and what is already done.

Why it matters: chat was built for taking turns. Working with several agents is not a conversation, it is a desk with several threads open at once. While building Quack, our editor, we kept seeing the same five habits: parallel sessions, visible agents, shared skills, an automatic diary and a task board. One by one they look like details. Together they change how you work, with any tool.

How to do it:

  1. A task board (kanban), even a plain text file: one line per task, with agent and status.
  2. A status line each agent updates when it starts, gets stuck or finishes.
  3. Shared skills: the same written procedures apply to every agent, so nobody invents its own way.
  4. An automatic diary: at the end of a task, each agent writes one line on what it did and what it learned.
Ready to copy

When you start, get stuck or finish, update your line in the board file with this format: [task] · [agent] · IN PROGRESS / BLOCKED / DONE · [one sentence on what you are doing or what you need] When the task is done, add one line to today's diary: what you did and one thing the next agent needs to know.

Small Test

Half an hour. Take two small tasks from different areas, for example a text change in the footer and a check to add to a form. Split them with the rule 1 prompt, open two sessions in two separate worktrees and start them together. Time it.

It worked if the two changes merge without conflicts and the total time is lower than doing them one after the other. If there is a conflict, look at where: it is almost always an area the split prompt should have flagged.

Watch Out For

  • More agents cost more. Every session uses up credits. Parallel work pays when the time you save is worth more than the extra usage.
  • The numbers come from our own tests, on specific projects and tasks. Measure yours: total time and rework.
  • Linked tasks do not belong in parallel. If the second needs the result of the first, queue them.
  • The router makes mistakes. In our case about one time in ten. That is what the "ask" way out is for.
  • "Ready to merge" means ready for your final review, not a replacement for it.

Next step: agents that work together need to remember what already happened. Read how to give AI agents a memory.


In short: More agents pay off only when tasks are truly independent, the team stays at three or four, every agent has a role and someone reviews the work.

Newsletter

AI that actually works, in your inbox.

New pills, the tools we use and what we learn on real projects. Few emails, only when there is something useful.

No spam. Unsubscribe in one click.