Symlink AGENTS.md to CLAUDE.md to keep AI agent instructions in sync
Most AI coding agents — including Codex, Cursor, Copilot, and Gemini CLI — natively read a file called AGENTS.md for project instructions, but Claude Code reads CLAUDE.md instead. A simple Unix symlink (ln -s AGENTS.md CLAUDE.md) lets both filenames point to a single file on disk, eliminating the risk of two copies drifting out of sync over time. Maintaining two separate files with identical content is considered bad practice, as teams inevitably end up shipping mismatched instructions after editing only one copy. In monorepos, the symlink should be repeated at every directory level that contains an AGENTS.md file. Windows users may need to enable Git developer mode for symlink support, and committing the symlink to version control is recommended so it is available immediately after cloning.
This is an AI-generated summary. ShortSingh links to the original source for the complete article.
Discussion (0)
Log in to join the discussion and vote.
Log in