Configuring Agentic AI Coding Tools: An Exploratory Study
이 연구는 2,923 개의 GitHub 저장소를 분석하여 Agentic AI 코딩 도구들의 설정 메커니즘을 체계적으로 조사한 결과, `AGENTS.md` 파일이 표준으로 자리 잡은 반면 고급 기능은 아직 표면적으로만 활용되고 있으며 도구별 설정 문화가 형성되고 있음을 밝혔습니다.
원본 논문은 CC BY 4.0 (http://creativecommons.org/licenses/by/4.0/) 라이선스로 제공됩니다. 이것은 아래 논문에 대한 AI 생성 설명입니다. 저자가 작성하거나 승인한 것이 아닙니다. 기술적 정확성을 위해서는 원본 논문을 참조하세요. 전체 면책 조항 읽기
이 논문은 **"지능형 AI 코딩 도구들을 어떻게 '가르치고' '조종'하는가?"**에 대한 탐구 연구입니다.
마치 새로운 직원이 입사했을 때, 우리는 그에게 회사의 규칙, 업무 방식, 그리고 우리가 원하는 태도를 알려주죠. 이 논문은 개발자들이 AI 코딩 도구 (Claude Code, GitHub Copilot, Cursor 등) 에게 그런 '지침서'를 어떻게 작성하고 있는지, 그리고 실제로 얼마나 잘 활용하고 있는지를 조사한 결과입니다.
이 복잡한 연구를 세 가지 핵심 비유로 쉽게 설명해 드리겠습니다.
1. 연구의 배경: AI 직원을 채용했다면?
과거의 AI 는 개발자가 "이거 짜줘"라고 말하면 바로 짜주는 수동적인 비서였습니다. 하지만 최근의 '에이전트 (Agentic)' AI 는 스스로 목표를 세우고, 파일을 수정하고, 코드를 실행하는 능동적인 동료가 되었습니다.
하지만 이 AI 들이 제멋대로 행동하면 혼란이 생깁니다. 그래서 개발자들은 AI 에게 **"우리 프로젝트는 이런 규칙을 따르고, 이런 방식으로 일해"**라고 알려주는 설정 파일들을 만듭니다. 연구진은 이 설정 파일들이 어떤 종류가 있고, 실제로 어떻게 쓰이는지 2,923 개의 GitHub 프로젝트 (오픈소스 코드 저장소) 를 분석했습니다.
2. 핵심 발견 1: "공통 매뉴얼" (AGENTS.md) 의 등장
연구진은 8 가지 종류의 설정 방식 (Context Files, Skills, Subagents 등) 을 발견했습니다. 그중에서 가장 눈에 띄는 것은 **'Context Files(맥락 파일)'**입니다.
- 비유: 마치 회사에 새로 온 직원에게 주는 **'회사 소개서'**나 **'업무 매뉴얼'**입니다.
- 현실: 가장 많이 쓰이는 파일은
CLAUDE.md(클로드 전용) 나AGENTS.md(공통 표준) 입니다. - 재미있는 점: 처음에는 각 AI 도구마다 자기만의 매뉴얼 (
CLAUDE.md등) 을 쓰다가, 점차 **모든 AI 가 읽을 수 있는 공통 매뉴얼인AGENTS.md**로 통일되는 추세입니다. 마치 여러 브랜드의 스마트폰이 모두 'USB-C' 케이블을 쓰게 된 것과 비슷합니다. 개발자들은 각기 다른 AI 도구를 써도AGENTS.md하나만 잘 만들어두면 모든 AI 가 이해할 수 있기를 바라고 있습니다.
3. 핵심 발견 2: "심화 과정"은 아직 많이 쓰지 않음 (Skills & Subagents)
AI 에게 더 복잡한 일을 시킬 수 있는 고급 기능들이 있습니다.
Skills(기술): AI 가 특정 작업을 반복할 때 쓸 수 있는 '스킬북'이나 '매크로'입니다.
Subagents(하위 에이전트): 큰 일을 맡긴 AI 가, 세부적인 일을 처리할 다른 작은 AI 를 부르는 것입니다.
비유: 이는 마치 직원을 채용할 때, 단순히 "회사의 규칙을 알려주는 것"을 넘어 "특수한 공구 (Skills)"를 주거나 "전문가 팀 (Subagents)"을 구성해 주는 것과 같습니다.
현실: 하지만 연구 결과, 대부분의 개발자는 이 고급 기능들을 거의 쓰지 않습니다.
- 대부분은 매뉴얼 (
Context Files) 만 만들고 끝냅니다. - Skills 를 만든다고 해도, 실제로 실행 가능한 복잡한 스크립트를 넣기보다는 단순한 텍스트 설명 (문서) 만 넣어두는 경우가 많습니다.
- 마치 "이건 자동화 스크립트야!"라고 말하면서 실제로는 그냥 종이로 된 설명서만 붙여놓은 것과 같습니다. 개발자들은 복잡한 설정을 만드는 게 귀찮아서, 가장 쉬운 방법 (매뉴얼) 만 선택하는 경향이 있습니다.
- 대부분은 매뉴얼 (
4. 핵심 발견 3: 도구마다 '문화'가 다름
각 AI 도구를 쓰는 개발자들의 성향도 달랐습니다.
- Claude Code 사용자: 가장 다양한 설정 방식을 사용합니다. (가장 호기심 많고 실험적인 직원들)
- Cursor 사용자: '규칙 (Rules)'을 중요하게 여깁니다. (엄격한 규칙을 따르는 직원들)
- Copilot 사용자: 기본 매뉴얼만 주로 사용합니다. (가장 보수적인 직원들)
이처럼 각 도구마다 고유한 '설정 문화'가 형성되고 있습니다.
📝 결론: 이 연구가 우리에게 주는 메시지
- 가장 쉬운 게 최고입니다: AI 를 설정할 때 복잡한 기능을 다 쓸 필요는 없습니다. **
AGENTS.md**라는 공통 매뉴얼 하나를 잘 작성하는 것이 가장 효과적이고, 모든 AI 가 이해할 수 있는 시작점입니다. - 아직은 '문서'가 '자동화'보다 낫습니다: AI 가 스스로 복잡한 작업을 하도록 설정 (Skills) 하는 기술은 아직 초기 단계입니다. 지금은 AI 에게 "어떻게 일할지"를 텍스트로 잘 설명해주는 것이 더 중요합니다.
- 앞으로의 변화: AI 도구들이 서로 겹치는 기능이 많아지면, 각기 다른 설정 방식들이 하나로 통합될 것입니다. 하지만 지금은 개발자들이 각자 도구를 선택하고, 그에 맞는 설정 방식을 만들어가는 '서부 개척 시대'와 같습니다.
한 줄 요약:
"AI 코딩 도구를 쓸 때는 복잡한 설정보다 **공통된 매뉴얼 (
AGENTS.md)**을 잘 만드는 게 중요하며, 아직은 AI 가 스스로 복잡한 일을 하도록 가르치는 '고급 기술'은 많이 쓰이지 않고 있습니다."
연구 분야의 논문에 파묻히고 계신가요?
연구 키워드에 맞는 최신 논문의 일일 다이제스트를 받아보세요 — 기술 요약 포함, 당신의 언어로.