Claude Code Bug Linked AGENTS.md Context File Reading to Telemetry Settings
An analysis revealed that Anthropic's Claude Code tool only read project AGENTS.md files when telemetry was enabled. An Anthropic engineer confirmed this was an unintended bug caused by feature flag implementation and patched it in version 2.1.281. Developers who disabled telemetry for privacy reasons inadvertently had their project instructions ignored, reducing agent accuracy. The incident underscores the risks of tightly coupling remote feature management with user telemetry systems in developer tools. The bug occurred because remote feature flags could not be received when telemetry was turned off. Additionally, community members noted that Claude Code prioritizes CLAUDE.md over AGENTS.md by default unless explicitly configured to read both using the 'claude-md-and-agents-md' setting.
## BACKGROUND
AGENTS.md is an open format standard designed to provide AI coding agents with technical guidelines, build commands, and project conventions separate from human-oriented README files. Claude Code is Anthropic's terminal-based AI coding assistant that uses these context files to understand and edit codebases.