Claude Code’s AGENTS.md Rejection Sparks Developer Backlash

Post LinkedIn

📚Read original on InfoQ中国

#coding-agents#developer-workflowsclaude-codeanthropicclaude-codeagents.md

💡Claude Code’s stance on AGENTS.md could affect agent compatibility, repository workflows, and tool switching.

⚡ 30-Second TL;DR

What Changed

The controversy centers on Claude Code’s lack of support for the widely adopted AGENTS.md convention.

Why It Matters

If Claude Code does not reliably recognize AGENTS.md, teams may need to duplicate instructions or maintain tool-specific configuration. This could weaken interoperability among AI coding agents and increase migration costs for engineering teams.

What To Do Next

Test Claude Code against a representative repository containing AGENTS.md, then mirror any critical instructions into Claude-specific configuration until behavior is verified.

Who should care:Developers & AI Engineers

Key Points

•The controversy centers on Claude Code’s lack of support for the widely adopted AGENTS.md convention.
•Developers view the behavior as a compatibility and workflow problem for agent-based coding projects.
•Anthropic issued a response, but it reportedly failed to resolve community concerns and intensified criticism.

🧠 Deep Insight

Background and context from public sources — not the original article. 13 sources cited.

🔑 Enhanced Key Takeaways

•The AGENTS.md standard, managed under the Linux Foundation since August 2025, has achieved adoption across more than 60,000 open-source repositories.
•Shopify CEO Tobi Lütke has publicly threatened to ban Claude Code from internal development environments unless Anthropic adopts the industry-standard AGENTS.md format.
•Anthropic officially closed GitHub Issue 6235, which requested AGENTS.md support and had gathered over 5,000 upvotes, in August 2026 without providing the requested functionality.
•A February 2026 study from ETH Zurich indicated that while configuration files like AGENTS.md provide guidance, they can increase inference costs by over 20% due to excessive agentic file traversal.
•In May 2026, a security incident involving Apple accidentally shipping internal CLAUDE.md files in a production app update highlighted the risks of proprietary AI configuration files.

📊 Competitor Analysis▸ Show

Feature	Claude Code	Cursor (Composer)	Windsurf
Config Format	CLAUDE.md (Proprietary)	.cursorrules	.windsurfrules
AGENTS.md Support	No	Partial (via community plugins)	Partial (via community plugins)
Pricing	Usage-based (API)	Subscription	Subscription
Primary Focus	CLI-first agentic coding	IDE-integrated agentic coding	IDE-integrated agentic coding

🛠️ Technical Deep Dive

Claude Code utilizes a proprietary CLAUDE.md file for system instructions, which lacks native parsing for the industry-standard AGENTS.md schema.
Anthropic suggests using symbolic links (ln -s AGENTS.md CLAUDE.md) or manual import statements within the CLAUDE.md file to bridge the compatibility gap.
Recent internal updates to Claude Code have shifted tool execution patterns, prioritizing bash-based tool usage over dedicated read/write file system APIs.
The agentic architecture relies on recursive file traversal, which, according to ETH Zurich research, can lead to increased token consumption and latency when context files are improperly structured.

🔮 Future ImplicationsAI analysis grounded in cited sources

Anthropic will face declining enterprise adoption in large-scale monorepo environments.

The 'complexity tax' of maintaining redundant configuration files is driving major engineering organizations to evaluate more interoperable alternatives.

The Linux Foundation will formalize a stricter specification for AGENTS.md to combat fragmentation.

The ongoing public friction between proprietary formats and the open standard necessitates a more rigid governance model to ensure cross-tool compatibility.