Conclusion
We evaluate the impact of context files on coding agent performance for four common coding agents
on SWE-BENCH and the novel CTXBENCH, built from recent GitHub issues and less popular
repositories containing developer-written context files. We find that all context files consistently
increase the cost and number of steps required to complete tasks. LLM-generated context files have
a marginal negative effect on task success rates, while developer-written ones provide a marginal
performance gain, neither statistically significant.
Our trace analyses show that instructions in context files are generally followed and lead to more test-
ing and broader exploration; however, they do not function as effective repository overviews. Over-
all, our results suggest that context files don’t improve coding agent performance, and should only
contain specific additional instructions beyond what is already available in the codebase. This high-
lights a concrete gap between current agent-developer recommendations and observed outcomes,
and motivates future work on principled ways to automatically generate concise, task-relevant guid-
ance for coding agents.
What is the difference between the models writing code “well” and their performance in this context? Are we referring to readability?
Genuine question. If we use agents to read, edit, and review code, why do we care about readability? That’s a human constraint. Unless attempting to do those three is not effective and thus requires human attention to correct issues which would justify readable code. If that’s the case; why use the agent to edit the code in the first place?
Two, there is a decent body of evidence to suggest that this method does not actually speed up development unless you go full lights out software factory which… Why would you want to do that?
EDIT:
As an aside this actually reminds me of the Xerox park study into efficiency gains for keyboard heavy workflows vice mouse heavy workflows. Keyboards were perceived as faster by subjects but when actually measured the mouse was faster.
Agents md file doesn’t actually do anything except using more tokens https://arxiv.org/pdf/2602.11988
I feel like you either didn’t read your article or didn’t read the post article
To quote the research paper conclusion…
Conclusion We evaluate the impact of context files on coding agent performance for four common coding agents on SWE-BENCH and the novel CTXBENCH, built from recent GitHub issues and less popular repositories containing developer-written context files. We find that all context files consistently increase the cost and number of steps required to complete tasks. LLM-generated context files have a marginal negative effect on task success rates, while developer-written ones provide a marginal performance gain, neither statistically significant. Our trace analyses show that instructions in context files are generally followed and lead to more test- ing and broader exploration; however, they do not function as effective repository overviews. Over- all, our results suggest that context files don’t improve coding agent performance, and should only contain specific additional instructions beyond what is already available in the codebase. This high- lights a concrete gap between current agent-developer recommendations and observed outcomes, and motivates future work on principled ways to automatically generate concise, task-relevant guid- ance for coding agents.
That sounds like “Agents.MD doesn’t work” to me.
Am I missing something?
Agents.md doesn’t exist to make sure generated code functions, it’s there to make sure it’s written well.
What is the difference between the models writing code “well” and their performance in this context? Are we referring to readability?
Genuine question. If we use agents to read, edit, and review code, why do we care about readability? That’s a human constraint. Unless attempting to do those three is not effective and thus requires human attention to correct issues which would justify readable code. If that’s the case; why use the agent to edit the code in the first place?
Agents for generation, humans for review
One, that sounds truly miserable.
Two, there is a decent body of evidence to suggest that this method does not actually speed up development unless you go full lights out software factory which… Why would you want to do that?
https://ide.mit.edu/insights/ai-productivity-and-roi/
EDIT: As an aside this actually reminds me of the Xerox park study into efficiency gains for keyboard heavy workflows vice mouse heavy workflows. Keyboards were perceived as faster by subjects but when actually measured the mouse was faster.