Claude Code doesn't read your AGENTS.md

Most coding agents (Codex, Cursor, Copilot, etc. have standardized on AGENTS.md as the shared instruction file. Only Claude uses CLAUDE.md, never AGENTS.md. If your repo only has an AGENTS.md, Claude Code silently ignores it.

Fix A: Import AGENTS.md into CLAUDE.md

Create a CLAUDE.md at the repo root that imports your AGENTS.md:

@AGENTS.md

Claude loads the imported file at session start.

All your rules can stay in AGENT.md. If you have anything Claude-specific you can append it to CLAUDE.md.

Fix B: Check in a symlink

You can also symlink AGENTS.md as CLAUDE.md:

ln -s AGENTS.md CLAUDE.md

Then commit that symlink to Git.