Your two AI agents had one job: research a topic and write a summary. Simple, right?
One agent Googled the company. The other agent also Googled the company. Then the first agent decided the summary was wrong and rewrote it. The second agent disagreed and rewrote it back. Twenty-seven API calls later, you had a $3 bill and a summary worse than what ChatGPT gives you for free.
Welcome to multi-agent coordination — the feature nobody warns you about when they show you that slick demo.
Here's the dirty secret of multi-agent systems: two agents working together are often worse than one agent working alone.
Not because the individual agents are bad. Because nobody told them how to not step on each other's toes.
Think of it like a group project in college. Five smart people, zero coordination, one Google Doc with seventeen conflicting edits at 11:59 PM. Sound familiar?
Multi-agent AI systems fail the exact same way. Agent A fetches data. Agent B fetches the same data (because nobody told it Agent A already did). Agent A formats a response. Agent B reformats it differently. They loop, they duplicate, they contradict — and your token bill climbs while quality drops.
The pitch is seductive: "Need research AND writing? Add a researcher agent and a writer agent!"
But here's what actually happens without coordination:
researcher_result = researcher.run("Find Q3 revenue for Acme Corp")
writer_result = writer.run(f"Summarize this: {researcher_result}")
researcher_result = researcher.run("Find Q3 revenue for Acme Corp")
The fix isn't removing agents. It's adding something dumber than AI: a contract.
The counterintuitive truth: the best multi-agent systems aren't the ones with the smartest agents. They're the ones with the strictest handoff rules.
Here's a minimal coordination contract that stops 80% of multi-agent chaos:
class AgentContract:
def __init__(self):
self.completed_tasks = {}
self.ownership = {}
def claim_task(self, agent_id: str, task: str) -> bool:
"""Only one agent can own a task. No duplicates."""
if task in self.ownership:
return False # Already claimed
self.ownership[task] = agent_id
return True
def submit_result(self, agent_id: str, task: str, result: str):
"""Once submitted, it's done. No rewrites by other agents."""
if self.ownership.get(task) != agent_id:
raise ValueError(f"{agent_id} doesn't own '{task}'")
self.completed_tasks[task] = result
return True
def get_result(self, task: str) -> str:
"""Read-only access to completed work."""
return self.completed_tasks.get(task, None)
No machine learning. No embeddings. No vector databases. Just a dictionary that says "this task belongs to this agent, and once it's done, it's done."
After watching dozens of multi-agent setups spiral, here's what actually works:
Rule 1: Claim before you work. Every agent must call claim_task() before starting. If someone else claimed it, you skip it. Zero duplication.
Rule 2: One writer, many readers. The agent that claims a task is the only one that writes the result. Everyone else gets read-only access via get_result(). No conflicting edits.
Rule 3: Disagree forward, never backward. If Agent B thinks Agent A's result is wrong, it doesn't rewrite it. It creates a new task — "revision_of_research" — claims it, and writes its improved version. The audit trail stays clean, and you can actually debug what happened.
contract = AgentContract()
contract.claim_task("researcher", "find_q3_revenue")
data = researcher.run("Find Q3 revenue for Acme Corp")
contract.submit_result("researcher", "find_q3_revenue", data)
research = contract.get_result("find_q3_revenue")
contract.claim_task("writer", "write_summary")
summary = writer.run(f"Summarize: {research}")
contract.submit_result("writer", "write_summary", summary)
contract.claim_task("writer", "research_revision_request")
contract.submit_result("writer", "research_revision_request",
"Q3 revenue figure seems outdated — please re-check")
Most teams don't need multi-agent systems at all. A single well-prompted agent with good tools beats two agents arguing in a loop every single time for 90% of use cases.
Multi-agent coordination is worth it when — and only when — you genuinely have tasks that benefit from different system prompts, different tool sets, or different trust boundaries. If your "researcher" and "writer" could be the same agent with two different function calls, you don't have a multi-agent problem. You have a single agent with a task list.
The agents aren't the hard part. The coordination is. And the best coordination looks a lot less like AI and a lot more like boring software engineering.
Have you shipped a multi-agent system that actually stayed coordinated in production? What handoff pattern saved you? Drop your setup in the comments — I'm especially curious about the agent count and whether contracts or message queues worked better for you.