Member-only story
Three files, three models, one decision you make once. #
Read the article for free
[.]here Over 4,300 engineers upvoted the same GitHub issue asking if Claude Code could please read AGENTS.md natively. As of Claude Code 2.1.201 in July 2026, the answer remains no.
Anthropic updated its own memory documentation to tell developers how to force the behavior anyway. The official command is ln -s AGENTS.md CLAUDE.md
right in the terminal. Anthropic ships the workaround for the file its own tool refuses to read.
The engineering under this is more interesting than the argument. A single line inside the claude-api
SKILL.md in Anthropic's public skills repository explains the situation. The answer lies in the description field of the YAML frontmatter. Unlike CLAUDE.md and AGENTS.md, that description is the reason Claude reads the rest of the file.
Three files, three models, and the decision only becomes obvious once you see the gate.
The Context Reshuffle of Late 2025 #
The timeline explains how the industry arrived at this split. In August 2025, the AGENTS.md specification launched to give AI coding assistants a…