I’ve been really hoping that Claude Code would shift to support AGENTS.md as a standard for providing default instructions about a project. Sadly, that hasn’t happened yet. I’ve been hacking around this by symlinking CLAUDE.md to AGENTS.md. It works, but I find it to be subpar and maybe even a big gross.

Simon Willison has dug up another way you can do this in the Claude Code on the web documentation:

If you have an AGENTS.md file, you can source it in your CLAUDE.md using @AGENTS.md to maintain a single source of truth.

It’s less gross, I guess. And it has the benefit of letting you add specific instructions for Claude.