Search papers, labs, and topics across Lattice.
This paper catalogs common configuration smells found in AGENTS.md files used by coding agents, revealing significant issues in their definition and maintenance. Through a grey literature review and repository mining, the authors identified six prevalent smells, with "Lint Leakage" being the most common, affecting 62% of analyzed files. The findings underscore the widespread nature of these configuration issues, which often co-occur, highlighting the need for improved practices in coding agent configuration.
Configuration smells in coding agent files are not just common鈥攖hey're rampant, with "Lint Leakage" impacting over 60% of cases.
Coding agents are increasingly used to automate software engineering tasks. To guide their behavior, these agents commonly rely on configuration files, typically named AGENTS.md or CLAUDE.md, which provide instructions about architecture, workflows, coding conventions, and testing practices. Despite their growing importance, little is known about common problems affecting the definition and maintenance of these files. In this paper, we present the first catalog of smells for coding-agent configuration files. To identify such smells, we first conducted a grey literature review and a repository mining analysis. As a result, we identified six configuration smells and proposed automated heuristics to detect them. To evaluate the prevalence of the proposed smells, we analyzed 100 popular open-source repositories containing either an AGENTS.md or a CLAUDE.md file. Our results show that configuration smells are widespread. Lint Leakage was the most common smell, affecting 62% of the files, followed by Context Bloat (42%) and Skill Leakage (35%). We further show that several smells frequently co-occur, particularly Context Bloat, Skill Leakage, and Conflicting Instructions.
