Skip to content

Source paper

Agent READMEs: An Empirical Study of Context Files for Agentic Coding

Worawalan Chatlatanagulchai, Hao Li, Yutaro Kashiwa and 8 more

Worawalan Chatlatanagulchai, Hao Li, Yutaro Kashiwa, Brittany Reid, Kundjanasith Thonglek, Pattara Leelaprute, Arnon Rungsawang, Bundit Manaskasemsak, Bram Adams, Ahmed E. Hassan, Hajimu Iida

arXiv 2511.12884 · 202510 upvotes on Hugging Face

Research ideas from this paper (3)

Generated by AI. The paper’s authors did not write these.

AI summary

This paper presents the first large-scale empirical study of agent context files (such as CLAUDE.md and AGENTS.md), analyzing 2,303 files from 1,925 repositories. The study characterizes these files as complex, 'configuration-as-code' artifacts that are frequently maintained but lack critical non-functional requirements like security and performance.

How it works (AI summary)

The researchers employed a multi-faceted empirical approach including repository mining, readability analysis using the Flesch Reading Ease (FRE) metric, commit history analysis for maintenance patterns, and a two-stage content classification process using both manual inspection and GPT-5 for automated labeling.