AGENTS.md vs CLAUDE.md: Rules for Repositories with Multiple Agents

When Codex, Claude Code, Cursor, and other agents share a repository, rule conflicts can be more damaging than code conflicts. Put tool-neutral requirements in a repository contract: tests, boundaries, directory ownership, and release checks. Keep tool-specific shortcuts in CLAUDE.md or the relevant adapter file.nnNever assume every tool merges these files the same way. Make the source of truth explicit, keep adapters short, and test the rules like code. A useful contract defines required checks, forbidden actions, and what a completion report must contain. VelaNote can hold cross-tool decisions while the repository file remains the executable contract.

Sources

See the linked primary sources in the Chinese edition.