Claude Code Feature Request Urges Adoption of Universal AGENTS.md Standard
Developers are pushing Anthropic to support AGENTS.md alongside CLAUDE.md in Claude Code. The open standard is rapidly becoming the universal context format across AI coding agents including Cursor, Codex, and Amp.
Impact: Medium
Why it matters
Adopting AGENTS.md allows developers to maintain a single repository instructions file that works seamlessly across all AI coding assistants without vendor lock-in.
TL;DR
- 01Use a symbolic link `ln -s AGENTS.md CLAUDE.md` to share context between agents today.
- 02Standardize project rules in AGENTS.md to support Cursor, Codex, and Claude Code simultaneously.
Key facts
- GitHub Issue
- #6235
- Specification
- agents.md
- Supported Agents
- Codex, Amp, Cursor
Standardization Across AI Coding Agents
The AI developer ecosystem is consolidating project context conventions around AGENTS.md. Originally designed as an open specification, AGENTS.md provides coding agents with essential rules, architecture diagrams, testing commands, and style guides in a vendor-neutral Markdown file.
The Friction with Tool-Specific Contexts
Claude Code currently looks for CLAUDE.md in the repository root. When teams use a mix of Claude Code, Cursor, and Codex CLI, developers must maintain duplicate instruction files or rely on symbolic links (ln -s AGENTS.md CLAUDE.md). Issue #6235 proposes native recognition of AGENTS.md to streamline multi-agent workflows.
Try it in 2 minutes
ln -s AGENTS.md CLAUDE.mdbash
✓ When to use
- Setting up repository guidelines for multi-agent workflows
- Sharing context across Cursor, Codex, and Claude Code
✕ When NOT to use
- Single-developer projects exclusively using Claude Code without other assistants
What to do today
- Create an AGENTS.md file in your repository root.
- Symlink CLAUDE.md to AGENTS.md for compatibility with Claude Code.
What the community says
“ln -s AGENTS.md CLAUDE.md”
“For agent skills and MCP servers, https://github.com/agentplugins/agent-plugins-spec is trying to standardize the packaging/distribution layer with a minimal common spec”
Sources