Evaluating AGENTS.md: Are Repository-Level Context Files Helpful for Coding Agents?
Authors: Thibaud Gloaguen, Niels Mündler, Mark Müller, Veselin Raychev, Martin Vechev
AI-generated Key Points
- Context files are commonly used in software development to tailor coding agents to repositories either manually or automatically.
- A comprehensive evaluation was conducted by the researchers using two settings: established SWE-bench tasks with LLM-generated context files and a novel collection of issues with developer-committed context files.
- The study found that context files tended to decrease task success rates and increase inference cost by over 20% compared to providing no repository context.
- Both LLM-generated and developer-provided context files encouraged broader exploration but ultimately made tasks harder due to unnecessary requirements.
- The study introduced AGENTBENCH, a benchmark for assessing the impact of context files on coding agents' performance in real-world tasks.
- Evaluation on AGENTBENCH and SWE-BENCH LITE revealed that LLM-generated context files generally decreased agent performance, while developer-written context files showed a slight improvement.
- Context files led to more thorough testing and exploration by coding agents according to an in-depth analysis of agent traces.
- Human-written context files should only include minimal requirements to avoid unnecessarily challenging coding agents.
Abstract: A widespread practice in software development is to tailor coding agents to repositories using context files, such as AGENTS.md, by either manually or automatically generating them. Although this practice is strongly encouraged by agent developers, there is currently no rigorous investigation into whether such context files are actually effective for real-world tasks. In this work, we study this question and evaluate coding agents' task completion performance in two complementary settings: established SWE-bench tasks from popular repositories, with LLM-generated context files following agent-developer recommendations, and a novel collection of issues from repositories containing developer-committed context files. Across multiple coding agents and LLMs, we find that context files tend to reduce task success rates compared to providing no repository context, while also increasing inference cost by over 20%. Behaviorally, both LLM-generated and developer-provided context files encourage broader exploration (e.g., more thorough testing and file traversal), and coding agents tend to respect their instructions. Ultimately, we conclude that unnecessary requirements from context files make tasks harder, and human-written context files should describe only minimal requirements.
Tools for this paper
Ask questions about this paper to our AI assistant
You can also chat with multiple papers at once here.
Similar papers summarized with our AI tools
Navigate through even more similar papers through a
tree representationLook for similar papers (in beta version)
We compare the title and abstract with papers indexed in our database. For arXiv papers, we search within the same category; for DOI and other sources, we search across sources and subjects. You can rerun the search as our database grows.
Disclaimer: The AI-based summarization tool and virtual assistant provided on this website may not always provide accurate and complete summaries or responses. We encourage you to carefully review and evaluate the generated content to ensure its quality and relevance to your needs.