Study: Coding agents prefer AGENTS.md over API docs
rohanpaul_ai · x · 2026-08-30
Rohan Paul shares an empirical study on how coding agents discover, read, and write technical documentation. Tracking 3,033 documentation events across 557 real agent coding sessions and 33,097 agent-written pull requests, the authors found:
- Instruction files dominate: AGENTS.md and CLAUDE.md accounted for 35.4% of activity, while the agent's own plans and notes made up 25.1%.
- API docs ignored: API references were only 1.3%, and troubleshooting guides 0.4%.
- Non-linear workflow: The assumed "read-docs-then-write-code" loop barely appeared. Only 3 of 1,328 documentation reads led straight to a code edit, and no cases of agents checking work against docs were found.
The conclusion: Developers should prioritize writing AGENTS.md over API references, as that is what agents actually read.
More from coding & agent
- Seeking recommendations for MCP gateway management tools — Signal-Zone-346 · 2026-08-30
- Accio Open-Sources CommerceAgentBench, Claude Passes 52% — dr_cintas · 2026-08-30
- Role-Play Prompts are Keyholes, Not Magic Spells — gerardsans · 2026-08-30
- Code World Model: Coding Agent as World Brain — Charuru · 2026-08-30
- Rethinking context management: Maybe conversation summaries are a bad idea now — awitod · 2026-08-30
- Agentic Hivemind Concept: Infinite Context and Permanent Memory — Kyrannio · 2026-08-30