I fell into the obvious trap with AI coding agents:
“If one agent helps, three agents should help more.”
So I did what everyone does. I opened more tabs, spun up more sessions, and gave each agent a task.
Instead of shipping faster, I got chaos.
At some point I realized the uncomfortable truth:
The problem wasn’t the agents.
The problem was that I had zero structure.
And once I started building a real solution, I made another decision:
I’m open-sourcing it.
Because if a tool is going to orchestrate multiple agents touching your repo, it shouldn’t be a black box.
The “more agents” phase (and how it failed)
At first it felt great. The first few minutes always look promising:
• one agent scaffolds a feature
• another starts writing tests
• another refactors or “reviews”
Then the failure modes show up.
Failure mode #1: duplicated work
Two agents would solve the same problem from different angles.
Both diffs looked reasonable. Together, they were incompatible.
I wasn’t getting speed — I was generating parallel universes.
Failure mode #2: conflicting edits
Even if I tried to split tasks cleanly, they still collided in the same gravitational wells:
• shared config
• common types/interfaces
• utilities everyone touches
• the “one file” that always gets edited
The more agents I added, the more merge work I created.
Failure mode #3: context drift (the silent killer)
This one is subtle and brutal.
An agent starts correct… then drifts:
• assumes an older API
• invents patterns your repo doesn’t use
• “fixes” unrelated warnings
• changes things because it thinks it’s being helpful
If you don’t have a system that keeps agents aligned, drift is guaranteed.
Failure mode #4: I became the bottleneck
The irony was painful: more agents didn’t reduce my workload — it multiplied it.
Now I had to:
• prevent overlapping work
• reconcile contradictions
• review multiple diffs
• rerun tests constantly
• restate constraints again and again
I wasn’t running a dev team. I was babysitting a group chat.
The “aha”: multi-agent isn’t the magic — orchestration is
I stopped thinking of agents as “autocomplete” and started treating them like teammates.
Enthusiastic teammates. Capable, but they need structure.
When humans collaborate, three things keep teams from imploding:
1. Isolation — separate workspaces so parallel work is safe
2. Decomposition — clear tickets + acceptance criteria
3. Coordination — shared decisions + handoffs
I wasn’t missing intelligence. I was missing those three primitives.
What I changed (small structure, big difference)
If two agents share the same repo state, conflict isn’t a risk — it’s the default.
So I moved to: each agent gets its own isolated workspace.
No accidental cross-contamination. No “format everything” surprise. No stepping on toes.
Instead of vague prompts like “implement feature X,” I started assigning ownership like a team:
• “You own /frontend and the user flow.”
• “You own /api and the endpoint contract.”
• “You own tests/CI until green.”
Agents do way better with ownership + a done definition than with “do something generally helpful.”
I added a dedicated reviewer agent whose only job was:
• read the diff
• check assumptions
• point out missing edge cases
• block merging until issues are addressed
That single loop made things feel like a real team:
builder → reviewer → fix → tester → merge
And suddenly I wasn’t managing chaos — I was running a process.
The moment it clicked: my dev loop stopped being a queue
Before, everything was sequential:
1. ask an agent to implement
2. wait
3. review
4. fix
5. test
6. repeat
With structure, I could safely parallelize:
• builder works while tester runs
• reviewer checks while tests run
• I step in for decisions, not babysitting
That’s what I expected multi-agent coding to feel like in the first place.
So I built AgentsMesh — and I’m open-sourcing it
After a while, doing the “structured approach” manually became its own overhead:
• creating isolated workspaces
• tracking who’s doing what
• coordinating handoffs
• reusing workflows that worked
So I started building AgentsMesh to give agents structure.
And I’m open-sourcing it for a few reasons:
• Trust & auditability: tools that orchestrate code changes shouldn’t be opaque.
• Self-hosting/BYOK: people want predictable cost and control over where code touches the outside world.
• Community workflows > secret sauce: the real value is the patterns and templates that make multi-agent work repeatable.
My goal isn’t “look, I have more agents.”
It’s: multi-agent coding that doesn’t collapse into chaos.
If you want to help: I’m looking for testers + contributors
If you’ve tried multi-agent coding and hit:
• duplicated work
• conflicting edits
• context drift
• constant babysitting
…you’re exactly who I’d love feedback from.
Repo (open source): https://github.com/AgentsMesh/AgentsMesh
The most useful feedback for me right now:
1. Where does your agent workflow break today?
2. What structure do you already use (even informally)?
3. Which template would you want most: FE/BE split, tester pod, or reviewer loop?