Issue #6235 asks for one thing: let Claude Code read AGENTS.md. Opened August 21, 2025, it has piled up 5,200+ reactions and 300+ comments — 4x the second-place request, the single biggest unmet ask in the entire Claude Code tracker. In May, Anthropic finally answered: “not planned for now.” This week the issue hit the HN front page again, 263 points and counting.
Why one Markdown file started a war
AGENTS.md is a plain Markdown file at repo root telling any AI coding agent how to build, test, and contribute. It’s a Linux Foundation open standard now, sitting in 60,000+ repos, read natively by Codex, Cursor, Copilot, Gemini CLI, Amp, Windsurf, and Zed. Claude Code — the market-leading coding agent — is the only holdout, insisting on its own CLAUDE.md.
Anthropic’s answer is a symlink
The official fix: ln -s AGENTS.md CLAUDE.md, or import the file from inside CLAUDE.md. That’s literally in the docs now. Anthropic’s argument: CLAUDE.md carries semantics AGENTS.md can’t — imports, hierarchy, skills mounting. The community reads it differently: when you’re winning, you don’t join standards. You ignore them.
You Might Also Like
- Google Labs Releases Stitch Skills Official Stitch Plugins for Claude Code Cursor and Codex
- Anthropic Just Launched Code Review in Claude Code and 54 of prs now get Real Feedback
- 27k Github Stars in Weeks Learn Claude Code by Shareai lab Breaks Down ai Coding Agents Into 12 Lessons
- 27 Agents 109 Skills 88k Github Stars is Everything Claude Code Genius or Over Engineering
- Addy Osmani Open Sources Agent Skills 19 Workflows That Make ai Agents Code Like Google Engineers

Leave a comment