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

요약

코딩 에이전트의 설정 파일(AGENTS.md, CLAUDE.md)에서 발생하는 일반적인 문제점인 '설정 스멜(Configuration Smells)'을 정의하고 분석한 연구입니다. 오픈 소스 저장소 분석을 통해 린트 누출, 컨텍스트 비대화 등 6가지 주요 스멜을 식별하고 이를 탐지하기 위한 자동화된 휴리스틱을 제안합니다.

핵심 포인트

• 코딩 에이전트 설정 파일의 품질 저하 문제(스멜)를 최초로 카탈로그화함
• 린트 누출(62%), 컨텍스트 비대화(42%), 기술 누출(35%) 등 주요 스멜 식별
• 설정 스멜을 탐지하기 위한 자동화된 휴리스틱 방법론 제안
• 오픈 소스 저장소 분석을 통해 설정 스멜이 널리 퍼져 있음을 증명