“AI Disruption” Publication 10,500 Subscriptions 20% Discount Offer Link.
To be honest, the thing that’s annoyed me most over the past six months is maintaining two “instruction manuals” for the same repo.
The repo has an AGENTS.md for Cursor and other tools, and then I also have to keep a CLAUDE.md for Claude Code. About 90% of the content is duplicated: build commands, directory layout, coding conventions. Every time the build script changes, I have to remember to sync both places. Forget once, and one day Claude runs the old command, fails, and leaves you staring at a wall of errors.
Most people paper over this with a symlink or an @AGENTS.md import. It works, but it’s still a patch.
Good news: starting with v2.1.277, Claude Code natively supports AGENTS.md. If the repo already has an AGENTS.md, you don’t need a CLAUDE.md, don’t need an import, and don’t need to change any config. It just works.
After reading the official docs, though, I found a few traps. If you don’t know them ahead of time, you will step on them. This post covers them all at once.
