Blog

Notes on agent instruction files: CLAUDE.md, AGENTS.md, Cursor rules, and keeping one document right across repos, tools and people.

• Study

  CLAUDE.md vs AGENTS.md in 596 repos: 1 in 8 keep copies, and 4 in 10 copies differ

  We read CLAUDE.md and AGENTS.md in 596 public repos. Most link them; 1 in 8 keep two copies, and 4 in 10 of those copies already differ.October 26, 2026 · 3 min read
• Reference

  Which coding agent reads which instruction file (October 2026)

  CLAUDE.md, AGENTS.md, .cursor/rules, copilot-instructions.md, GEMINI.md: which file each coding agent reads, and which one wins. Checked October 2026.October 26, 2026 · 4 min read
• Explainer

  Why your CLAUDE.md, AGENTS.md and Cursor rules drift apart

  Every coding agent reads its own instruction file, in every repo. Why CLAUDE.md, AGENTS.md and Cursor rules drift, and the six workarounds teams use.October 26, 2026 · 3 min read