@alex_prompter: Two AI agents editing the same codebase will wreck each other's work unless you give them this instruction. Run two age…

X AI KOLs Timeline News

Summary

A practical tip for running multiple AI agents on the same codebase: use a shared notes.md file for coordination to prevent conflicts.

Two AI agents editing the same codebase will wreck each other's work unless you give them this instruction. Run two agents in the same repo at once, and they start undoing each other's changes. One refactors a file, the other decides it looks broken and reverts it. You end up debugging your agents instead of your code. You don't need worktrees or an orchestration framework for this. The fix is one shared markdown file that both agents can write to. Add this line to each agent's prompt. "You're not the only agent working on this project. If something changes that you didn't touch, it was probably another agent. Use notes.md to leave messages for each other. Never block each other's work, resolve conflicts together, and delete your messages from the file when you're done." Now they coordinate instead of colliding. One agent drops a note saying it's rewriting the auth module, the other reads it and stays out of that folder until the note clears. It works across different models, too. The file is the protocol, so it doesn't matter whose agent is reading it. Try it next time you run agents in parallel.
Original Article
View Cached Full Text

Cached at: 07/16/26, 08:15 AM

Two AI agents editing the same codebase will wreck each other’s work unless you give them this instruction.

Run two agents in the same repo at once, and they start undoing each other’s changes. One refactors a file, the other decides it looks broken and reverts it. You end up debugging your agents instead of your code.

You don’t need worktrees or an orchestration framework for this. The fix is one shared markdown file that both agents can write to.

Add this line to each agent’s prompt.

“You’re not the only agent working on this project. If something changes that you didn’t touch, it was probably another agent. Use notes.md to leave messages for each other. Never block each other’s work, resolve conflicts together, and delete your messages from the file when you’re done.”

Now they coordinate instead of colliding. One agent drops a note saying it’s rewriting the auth module, the other reads it and stays out of that folder until the note clears.

It works across different models, too. The file is the protocol, so it doesn’t matter whose agent is reading it.

Try it next time you run agents in parallel.

Similar Articles

How I stopped juggling AI agents and let them talk to each other

Reddit r/AI_Agents

The author describes the hassle of manually coordinating multiple AI coding agents and introduces Accord Agents, an open-source shared workspace that enables agents to discuss and review each other's work while keeping the process transparent to the human.