ai-scaffold-agents-md
/ai-scaffold-agents-md — One Agent-Context File, Two Names
Agents look for their context in different files. Codex, Cursor, Copilot, and Gemini CLI read
AGENTS.md; Claude Code reads CLAUDE.md. Two files with content drift apart, and each agent then
works from a different set of rules. This skill makes AGENTS.md the only file that holds content,
and writes beside each one a CLAUDE.md pointer whose only loaded content is @AGENTS.md —
Claude Code's import syntax — so Claude loads exactly the text every other agent reads.
A symlink from CLAUDE.md to AGENTS.md would do the same with no file to maintain, and is not used:
a checkout on Windows without symlink support turns it into a text file holding the target path, and
some tools read the link rather than its target.
Edit Scope
Write only inside the repository or working directory this session was invoked in.
Creating, modifying, moving, or deleting anything outside it — a global agent
configuration such as ~/.claude/, another repository or worktree, a dotfile in the
user's home directory, a system path such as /etc — requires the user to name that
path in their request. Reading outside it is unrestricted.