The latest articles on DEV Community by shitianfang (@shitianfang). https://dev.to/shitianfang https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F1026686%2Fa40ffe41-ff7e-47c2-bd54-eb8df8abbada.png https://dev.to/shitianfang en shitianfang Tue, 07 Apr 2026 01:17:43 +0000 https://dev.to/shitianfang/how-we-stopped-merge-hell-in-our-ai-first-dev-team-44ae https://dev.to/shitianfang/how-we-stopped-merge-hell-in-our-ai-first-dev-team-44ae <h2> The Problem No One Talks About </h2> <p>Everyone's excited about vibe coding. But here's what happens <br> when a team of 3 uses Claude Code / Cursor simultaneously:</p> <ul> <li>Dev A's agent: <code>GET /api/users/:id</code> → <code>{ userId, name }</code> </li> <li>Dev B's agent: <code>GET /api/users/:id</code> → <code>{ user_id, username }</code> </li> <li>Dev C's frontend: expects <code>{ id, displayName }</code> </li> </ul> <p>Merge day = disaster. Every. Single. Time.</p> <h2> Why This Happens </h2> <p>AI agents are stateless. Each session starts fresh with no <br> knowledge of what your teammates' agents decided. They make <br> reasonable but incompatible assumptions about the same API.</p> <h2> The Fix: Shared Living Specs </h2> <p>I built <a href="https://coware.team" rel="noopener noreferrer">Coware</a> around one idea: <br> every agent reads the same spec before writing code.</p> <ol> <li>Paste one prompt into your AI agent</li> <li>Agent reads <code>/llms.txt</code> → auto-setup</li> <li>Scans codebase → generates interface specs (Markdown)</li> <li>Specs sync to server → every teammate's agent pulls them</li> <li>All agents code against the same contract</li> </ol> <h2> Results </h2> <ul> <li>API merge conflicts: <strong>zero</strong> </li> <li>Time re-explaining context to agents: <strong>zero</strong> </li> <li>Setup: <strong>30 seconds, one paste</strong> </li> </ul> <p>Open source, self-hostable, works with Claude Code, Cursor, <br> Copilot, Windsurf.</p> <p>👉 <a href="https://coware.team" rel="noopener noreferrer">coware.team</a><br><br> 👉 <a href="https://github.com/livespecs/coware-living-spec" rel="noopener noreferrer">GitHub</a></p> <p>Curious how other teams handle this — what's your workflow?</p> agents ai showdev vibecoding