Menu

AGENTS.md vs CLAUDE.md: What 3,387 Agent Instruction Files Leave Out
📰

AGENTS.md vs CLAUDE.md: What 3,387 Agent Instruction Files Leave Out

DEV Community: github·StackChief·10 days ago
#w2GU5CwH
#devtogithub#technology#devto#dev#files
Reading 0:00
15s threshold

If your repo has an AGENTS.md, a CLAUDE.md, or both, a new preprint has numbers on what teams actually put in them, and what they leave out.

On November 2, 2026, four researchers (Shanto, Islam, Asaduzzaman and Ngom) posted to arXiv a study of 3,387 agent instruction files (AGENTS.md, CLAUDE.md, copilot-instructions.md and .cursorrules) from 1,000 GitHub repositories , drawn from the public AIDev dataset of agent-authored pull requests. It's version 1 of a preprint that hasn't been peer reviewed, so treat the numbers as a first look.

Popular repos pile up formats

66.2% of the higher-star half had at least one instruction file, against 50.2% of the lower-star half.

AGENTS.md led in both: 50.0% of popular repos had one, ahead of CLAUDE.md at 40.4%.

42.2% of instruction-bearing popular repos keep more than one format (21.6% in the other half).…

Continue reading — create a free account

Join HashtagPLUS to read full articles, follow hashtags, vote, and join the conversation.