Конфигурационные «запахи» в файлах AGENTS.md

Кодинг-агенты всё чаще применяются для автоматизации задач инженерии ПО. Чтобы направлять их поведение, эти агенты обычно опираются на конфигурационные файлы - как правило, с именами AGENTS.md или CLAUDE.md, - которые дают инструкции об архитектуре, воркфлоу, конвенциях кодирования и практиках тестирования. Несмотря на их растущую важность, мало известно о типичных проблемах, затрагивающих определение и сопровождение таких файлов.

В этой работе авторы представляют первый каталог «запахов» (smells) для конфигурационных файлов кодинг-агентов. Чтобы выявить такие запахи, они сначала провели обзор «серой» литературы и анализ майнинга репозиториев. В результате выделено шесть конфигурационных запахов и предложены автоматические эвристики для их детекции.

Чтобы оценить распространённость предложенных запахов, авторы проанализировали 100 популярных open-source-репозиториев, содержащих файл AGENTS.md или CLAUDE.md. Результаты показывают, что конфигурационные запахи широко распространены. Самым частым оказался Lint Leakage (утечка lint), затронувший 62% файлов, за ним следуют Context Bloat (раздувание контекста, 42%) и Skill Leakage (утечка навыков, 35%). Авторы также показывают, что несколько запахов часто встречаются совместно - в особенности Context Bloat, Skill Leakage и Conflicting Instructions (противоречивые инструкции).