[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8},"actionData","errors","root",{"_28":-5,"_38":-5,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":56,"_57":58},"routes/_store+/_readers+/email_author.$slug/route",{"_9":10,"_11":-5},"book",{"_12":13,"_14":15,"_16":17,"_18":19,"_20":21,"_22":23},"currentUser","id","Z2lkOi8vbGVhbnB1Yi9TdG9yZTo6Qm9va1Byb2R1Y3QvNzk1NDU","title","Claude Code AGENTS.md Interop Handbook","state","published","contactAuthorMethod","email","aboutText","

Stop maintaining CLAUDE.md and AGENTS.md as two files that drift apart. Claude Code reads CLAUDE.md; Codex, Amp, and GitHub Copilot read AGENTS.md natively; Cursor, Windsurf, and Cline read their own files; Aider and Gemini CLI read AGENTS.md only after you configure them. That gap is the single largest open feature request in Claude Code — issue #6235, 5,200+ reactions, still unaddressed nine months on — and a duplication tax on everyone who runs more than one AI coding tool. This handbook removes it: a verified 9-tool matrix (which file each tool reads, whether it needs setup, and the one thing to watch, checked against every tool's official docs on 2026-06-02); six sync paths ranked by trade-off (the official @AGENTS.md import, symlink, pre-commit sync, SessionStart hook, direnv, CI drift check); copy-paste templates for all nine tools plus a complete repo layout; a rollback-safe migration runbook to move CLAUDE.md to AGENTS.md without losing Claude-only behavior; and a team drift guard that makes divergence fail loudly. 21 pages, dense and practical, with free updates as conventions change. By an independent operator who runs Claude Code 800+ hours and maintains cc-safe-setup (free MIT hooks, 1,700+ users). Try the free AGENTS.md Setup Generator and field-guide Gist first; buy this for the full matrix, the runbook, and the templates in one place. Independent handbook — not affiliated with Anthropic, OpenAI, GitHub, or Google.

","authors",[24],{"_12":25,"_26":27,"_28":29},"Z2lkOi8vbGVhbnB1Yi9TdG9yZTo6UHJvZHVjdEF1dGhvci84NTExNQ","name","yurukusa","user",{"_30":31},"avatar",{"_32":33,"_34":35,"_36":37},"url","https://secure.gravatar.com/avatar/80619124a2b944a990032412aae8daa6?r=pg&d=mm","styleName","medium","exists",true,"shoppingCartId","shoppingCart",{"_12":71,"_72":73,"_74":37,"_75":76,"_77":78,"_79":80,"_81":37},"locale","en","readerTheme","light","constants",{"_69":70},"publishers",{"_65":66,"_67":68},"learnerOrganizations",[],"needsLocaleCookieSync",false,"announcements",{"_59":60,"_61":-5},"sentryEnvironment","production","sentryRelease","06fff6bf2a3f19ff2ef76f94f389bccdbec7f9bd","announcement_store",{"_62":52,"_63":64},"announcement_authors","flag","text","

Kick off your book project, get started with GhostAI, get better at marketing, or spend the day doing all three! Free live workshops on Zoom. Saturday, June 27, 2026.

\n","companies",[],"universities",[],"paypalClientId","AX53Cwz8jR6rVVzzZiZNWWXl0dGagi-GZrjG-S3Ua14E5nrKMn7DxDQ730O4R8LusLPp49ALn6aRVaEy","no-cart","count",0,"free","updatedAt","","paymentGateway","STRIPE","cartItems",[],"loading"]

Email the Author