AGENTS.md 파일의 설정 스멜(Configuration Smells): 코딩 에이전트 설정 시 발생하는 흔한 실수들

코딩 에이전트(Coding agents)는 소프트웨어 엔지니어링 작업을 자동화하기 위해 점점 더 많이 사용되고 있습니다. 에이전트의 행동을 안내하기 위해, 이러한 에이전트들은 일반적으로 아키텍처, 워크플로(workflows), 코딩 컨벤션(coding conventions), 그리고 테스트 관행에 대한 지침을 제공하는 "AGENTS.md" 또는 "CLAUDE.md"라는 이름의 설정 파일에 의존합니다. 이러한 중요성이 커지고 있음에도 불구하고, 이 파일들의 정의 및 유지 관리 과정에서 발생하는 일반적인 문제들에 대해서는 알려진 바가 거의 없습니다. 본 논문에서 우리는 코딩 에이전트 설정 파일에 대한 최초의 스멜(smells) 카탈로그를 제시합니다. 이러한 스멜을 식별하기 위해, 우리는 먼저 회색 문헌 검토(grey literature review)와 리포지토리 마이닝(repository mining) 분석을 수행했습니다. 그 결과, 우리는 6가지 설정 스멜을 식별하였으며 이를 탐지하기 위한 자동화된 휴리스틱(heuristics)을 제안했습니다. 제안된 스멜의 유병률을 평가하기 위해, 우리는 "AGENTS.md" 또는 "CLAUDE.md" 파일을 포함하는 100개의 인기 있는 오픈 소스 리포지토리(open-source repositories)를 분석했습니다. 연구 결과, 설정 스멜이 광범위하게 퍼져 있음을 보여줍니다. 린트 누출(Lint Leakage)이 파일의 62%에 영향을 미쳐 가장 흔한 스멜로 나타났으며, 컨텍스트 비대화(Context Bloat, 42%)와 스킬 누출(Skill Leakage, 35%)이 그 뒤를 이었습니다. 나아가 우리는 여러 스멜이 빈번하게 함께 발생하는 것을 보여주었으며, 특히 컨텍스트 비대화(Context Bloat), 스킬 누출(Skill Leakage), 그리고 상충하는 지침(Conflicting Instructions)이 그러했습니다.