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

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