Repository-level context files
Files in repository root (e.g., AGENTS.md, [[concepts/claude-ai|CLAUDE]].md) providing context to AI agents for coding tasks. Common practice to guide AI behavior.
- ETH Zurich study (2026): Repository-level context files (e.g.,
AGENTS.md,CLAUDE.md) can degrade AI agent performance, contradicting industry practice. - Study title: “Evaluating AGENTS.md: Are Repository-Level Context Files Helpful for Coding Agents?”
- Performance Impact: Claude.md and agents.md files can cause Claude to perform worse.
- Source: Channel Theo (https://www.youtube.com/watch?v=GcNu6wrLTJc)
- Backlink: 2026 04 14 AI can work worse with Claudemd and agentsmd files Channel Theo
Source Notes
- 2026-04-14: https://www.youtube.com/watch?v=GcNu6wrLTJc Analysis regarding the effectiveness of Repository-Level Context Files.
- 2026-04-23: https://www.youtube.com/watch?v=0J2_YGuNrDo Building an Autonomous AI Work Team with Claude Code.