AGENTS.md
Repository-level context file providing project-specific guidance to AI coding agents (e.g., structure, conventions, key functions). Commonly used alongside CLAUDE.md files.
Key Findings (ETH Zurich Study, 2026)
- AGENTS.md and CLAUDE.md context files degrade AI agent performance in coding tasks
- Contradicts industry practice of using such files to improve agent effectiveness
- Study titled “Evaluating AGENTS.md: Are Repository-Level Context Files Helpful for Coding Agents?” (ETH Zurich, Feb 2026)
Implications
- Context files may introduce noise or misdirection for AI agents
- Requires reevaluation of repository setup practices
- Suggests minimal context may be preferable to structured context files
References
- Study: Evaluating AGENTS.md: Are Repository-Level Context Files Helpful for Coding Agents? (ETH Zurich, Feb 2026)
- Video: AI can work worse with Claude.md and agents.md files (Channel Theo)
- Source Note: 2026 04 14 AI can work worse with Claudemd and agentsmd files Channel Theo