AGENTS.md *국제 표준화 경쟁* — Anthropic·OpenAI·Google·GitHub·Cursor 의 *''*AI 가 *내 코드베이스를 읽는 단 한 파일*''* 전쟁
’‘표준 전쟁이 시작됐다’’* — 2024 년 말 AGENTS.md 라는 한 파일 이 ’‘’‘‘AI 가 *’‘‘내 코드베이스를 ’‘‘first read’‘’’ 하는 ’‘‘표준 진입점’‘’‘’‘’‘’‘’’ 으로 ’‘‘자연 발생’‘’‘. 그러나 ’‘‘1 년이 지난 2026 년 *’‘‘5 월 현재’‘’’ — ’‘‘Anthropic, OpenAI, Google, GitHub, Cursor 가 각자 *’‘‘자신만의 first-read 파일’‘’‘’‘’‘’’ 을 ’‘‘밀고 있다’‘. *’‘‘PNG vs WebP vs AVIF’’ 처럼 ’‘’‘‘표준이 *’‘‘경쟁 중’‘’‘’‘’‘. 이 글은 ’‘‘그 경쟁의 *지도’‘’‘’‘’’* 와 ’‘‘각 도구의 ’‘‘설계 철학’‘’‘, 그리고 ’‘‘조직이 ’‘‘무엇을 ’‘‘first-class artifact 로 가야 하는지’‘’‘’’* 를 정리한다.
1. ’‘‘표준의 ’‘‘자연 발생’‘’‘’’*
2024 년 봄~여름, ’‘‘개발자들이 ’‘‘각자 ’‘‘AI 도구의 ’‘‘어딘가에’’* ’‘‘룰을 적어두기 시작’‘’‘’‘’‘’‘’‘’‘’’ 했다. Cursor 의 .cursor/rules, Claude 의 CLAUDE.md, Codex 의 .codex/instructions, Copilot 의 .github/copilot-instructions.md, Continue 의 .continuerc.json — ’‘‘5 개 도구 = 5 개 형식’‘’‘’‘’‘’‘. *’‘‘같은 정보를 ’‘‘5 번 복사 + 5 번 sync’‘’‘’’* 라는 ’‘‘실용적 지옥’‘’‘*.
2024 년 말, Anthropic 의 Boris Cherny (Claude Code 리드) 가 *’‘‘AGENTS.md 라는 ’‘‘중립적 이름’‘’‘’‘’’ 을 ’‘‘먼저 제안’’ 한다. ’‘‘Cursor, GitHub, Codex 가 ’‘‘몇 개월 안에 ’‘’”“AGENTS.md 를 *first-read 로 인정””’‘’‘’‘’‘’‘’‘’‘’‘’‘. 2025 년 봄에는 *’‘’‘community 표준””’’* (agents.md 도메인 + spec 사이트) 으로 ’‘‘정착’‘. Cursor 는 *’‘’.cursor/rules 와 ’‘‘AGENTS.md 둘 다 ’‘‘지원’‘’‘’‘’‘. ’‘‘Codex 는 ’‘’‘AGENTS.md 만 ’‘‘기본””’‘’‘’‘’‘’‘’‘.
’‘‘그러나 ’‘‘2025 년 하반기 들어 ’‘‘다시 분기 시작’‘’‘’‘’‘’‘’‘. *’‘‘Anthropic 이 ’‘‘SKILL.md 라는 ’‘‘새 layer’‘’’ 를 ’‘‘추가’‘’‘. ’‘‘OpenAI 가 ’‘‘Custom GPT + Codex CLI 를 ’‘‘결합’‘’‘. ’‘‘Google 이 ’‘‘Gemini Code Assist 안 자체 형식’‘’’ 을 ’‘‘밀기 시작’‘. *’‘‘경쟁이 ’‘‘다시 살아났다’‘*.
2. 각 공급자의 *’‘‘전략과 형식’‘’’
2.1. Anthropic — ’‘‘AGENTS.md + CLAUDE.md + SKILL.md + MCP’‘
Anthropic 의 ’‘‘레이어드 설계’‘’‘’‘*:
| 파일 | 역할 |
|---|---|
| AGENTS.md (repo root) | ’‘‘모든 AI 도구 공통 진입점’‘’’* |
| CLAUDE.md (private) | ’‘‘Claude 전용 ’‘‘추가 룰 / 사용자 개인 글로벌 룰’‘’’ |
| .claude/skills/X/SKILL.md | ’‘‘재사용 가능 기술 skill 묶음 (Anthropic 표준 형식 v2)’‘’’* |
| .mcp.json | ’‘‘Model Context Protocol — ’‘‘외부 도구 연결 명세’‘’‘’’ |
설계 철학 — ’‘'’AI = ’‘‘도구 + skill + context’‘’‘’‘’‘. *AGENTS.md 는 *’‘‘context’‘, SKILL.md 는 *’‘‘재사용 능력’‘, MCP 는 *’‘‘도구’‘. ’‘‘셋이 ’‘‘orthogonal’‘’‘’‘’‘.
MCP (Model Context Protocol) 가 ’‘‘핵심 차별점’‘’‘. ’‘‘AI 가 ’‘‘외부 도구를 ’‘‘호출하는 ’‘‘공식 표준””’’* 으로 ’‘‘2024 년 11 월 발표’‘’‘. ’‘‘GitHub, Linear, Slack, Notion 등 ’‘‘주요 SaaS 들이 ’‘‘MCP 서버 ’‘‘공식 제공’‘’‘’‘’‘’‘’‘. ’‘‘2026 년 5 월 현재 ’‘‘MCP 가 ’‘‘사실상 표준화 ’‘‘리드’‘’‘’‘’‘*.
2.2. OpenAI — ’‘‘.codex + Custom GPT + Codex CLI’‘
OpenAI 의 접근:
- Codex CLI (2024 말 출시) — ’‘‘AGENTS.md 를 first-read’‘’’
- Custom GPT — ’‘‘Builder Studio 에서 ’‘‘AI 에 GPT 별 instructions 박음””’‘’‘’‘’‘’’*
- .codex/ 디렉토리 — ’‘‘추가 설정’‘’’
OpenAI 가 ’‘‘AGENTS.md 를 ’‘‘먼저 인정한 ’‘‘주요 회사’‘’‘’‘’‘. 이유 추측 — *’‘‘Cursor 에 ’‘‘GPT-4 가 ’‘‘기본 모델로 들어가있던 시기 ’‘‘유저 경험 통합””’‘’‘’‘’‘’‘’‘’‘’‘’‘’‘. ’‘‘그러나 ’‘‘2025 년 후반 Codex 가 ’‘‘독립 제품화””’‘’’ 되면서 ’‘‘Codex 만의 ’‘‘.codex/ 디렉토리 확장””’‘’‘’‘’‘’’* 도 ’‘‘추가””’‘. *’‘‘AGENTS.md + .codex 의 ’‘‘이중 형식””’‘’‘’‘*.
2.3. Google — ’‘‘Gemini Code Assist + Gemini.md’‘
Google 의 후발 진입:
- Gemini Code Assist (구 Duet AI) — VS Code 확장
- Gemini.md (2025 제안) — ’‘‘AGENTS.md 와 별도 ’‘‘Google 전용 ’‘‘분리””’‘’’ 추구
- Project IDX → Firebase Studio — ’‘‘클라우드 IDE 통합””’‘’’
Google 의 ’‘‘전략은 ’‘‘아직 명확하지 않다””’‘’‘’‘. *’‘‘Gemini.md 를 밀지만 ’‘‘커뮤니티 채택률 ’‘‘낮다””’‘’‘. ’‘‘대안으로 ’‘‘Gemini Code Assist 가 ’‘‘AGENTS.md 도 ’‘‘읽도록 ’‘‘2025 4Q 업데이트””’‘’‘’‘’‘’‘’‘’‘’‘. ’‘‘Google 의 ’‘‘압도적 강점은 ’‘‘2M 컨텍스트 (Gemini 2.5)””’‘’‘’’* — ’‘‘AGENTS.md 보다 ’‘‘전체 코드베이스를 ’‘‘그냥 다 읽기’‘’‘’‘’’ 라는 ’‘‘반대 방향의 ’‘‘베팅””’‘’‘’‘’‘.
2.4. GitHub Copilot — ’‘‘.github/copilot-instructions.md + Workspace’‘
GitHub 의 ’‘‘2 단계 진화””’‘*:
- 2024 —
.github/copilot-instructions.md’‘‘레포 단위 instructions””’’* - 2025 — Copilot Workspace ’‘‘에이전트 IDE””’’* + ’‘‘AGENTS.md 부분 지원””’’*
’‘‘GitHub 의 강점 — ’‘‘레포 자체에 ’‘‘네이티브 통합””’‘’‘’‘. *’‘‘Pull Request, Issues, Actions 와 ’‘‘유기적 연결””’‘’‘’‘’‘. ’‘‘단점 — ’‘‘AGENTS.md 와 copilot-instructions.md 의 ’‘‘이중 운영””’‘’‘’‘’‘’‘. *’‘‘2026 년 들어 ’‘‘copilot-instructions 를 ’‘‘AGENTS.md 의 ’‘‘extension 으로 ’‘‘명시””’‘’‘’‘’‘’‘’‘’‘’‘’‘’‘’‘*.
2.5. Cursor — ’‘‘.cursor/rules + AGENTS.md + MDC’‘
Cursor 의 ’‘‘MDC (Markdown Composer)’‘’’* 형식 — ’‘‘Cursor 만의 ’‘‘독자 형식””’‘’‘:
---
description: Apply when editing TypeScript files
globs: ["**/*.ts", "**/*.tsx"]
alwaysApply: false
---
# Rule body in markdown
’‘‘장점 — ’‘‘룰 마다 ’‘‘언제 적용할지 ’‘‘세밀 제어””’‘’‘’‘’‘. ’‘‘단점 — ’‘‘Cursor 전용””’‘’‘. ’‘‘AGENTS.md 도 ’‘‘동시 지원””’’* 하지만 ’‘‘.cursor/rules 가 ’‘‘우선””’‘’‘.
2.6. JetBrains AI Assistant
’‘‘.junie/guidelines.md 라는 ’‘‘독자 형식””’‘’’ 도입 (2025). ’‘‘IntelliJ / WebStorm / PyCharm 통합””’‘. *’‘‘AGENTS.md 도 ’‘‘2025 4Q 부터 ’‘‘읽기 시작””’‘’‘’‘’‘’‘’‘’‘*.
3. 공통 패턴 — ’‘‘표준이 ’‘‘5 가지로 ’‘‘수렴””’‘’‘’‘’’
여러 형식이 있지만 ’‘‘공통 패턴 5 가지””’‘’’ 가 나타났다:
- Markdown — ’‘‘XML / JSON 은 ’‘‘사라짐””’‘’‘’‘’‘. ’‘‘사람도 AI 도 ’‘‘가장 잘 읽음””’’*
- 레포 root 또는 .[tool]/ 디렉토리 — ’‘‘위치 ’‘‘예측 가능””’’*
- First-read on session start — ’‘‘AI 가 ’‘‘대화 시작시 ’‘‘우선 로드””’‘’’
- 자연어 + 코드 예시 — ’‘‘JSON schema 같은 ’‘‘기계 형식 ’‘‘쇠퇴””’‘’’
- *사람도 *’‘‘같은 파일 읽음””’‘’‘’’* — ’‘‘AI 전용 파일이 ’‘‘사람에게도 ’‘‘문서로 가치 있음””’‘’‘’‘’‘’’*
4. 차이점 — ’‘‘세부 경쟁축 4 가지””’‘’‘’‘’’*
4.1. 컨텍스트 크기 가정
- ’‘‘Anthropic — ’‘‘200K 컨텍스트 (Claude Opus 4.7) + 1M 옵션””’‘. *’‘‘AGENTS.md 가 ’‘‘간결할 것을 권장””’’*
- ’‘‘OpenAI — ’‘‘128K (GPT-4 Turbo)””’‘. *’‘‘AGENTS.md 가 ’‘‘중간 길이””’’*
- ’‘‘Google — ’‘‘2M (Gemini 2.5)””’‘. *’‘‘AGENTS.md ’‘‘덜 중요””’‘. *’‘‘전체 읽기””’’*
→ ’‘‘*Google 만 *’‘‘다른 베팅””’‘’‘’‘’‘’‘. *’‘‘위험 — ’‘‘2M 도 ’‘‘대형 monorepo 에선 ’‘‘부족””’‘’‘’‘’‘. ’‘‘안전한 패턴은 ’‘‘AGENTS.md + 선택적 로드””’‘’‘’‘’‘.
4.2. 도구 호출 표준
- ’‘‘Anthropic — ’‘‘MCP””’’* (open standard, 빠른 채택)
- ’‘‘OpenAI — ’‘‘Function Calling + Custom GPT Actions””’‘’‘. ’‘‘폐쇄적””’’*
- ’‘‘Google — ’‘‘Function Calling API + Vertex Tools””’‘. *’‘‘Google Cloud 중심””’’*
- ’‘‘GitHub — ’‘‘Copilot Extensions””’‘’‘’’* (자체 표준)
’‘‘*MCP 가 *’‘‘압도적 채택률””’‘’‘’‘. *’‘‘GitHub, Linear, Notion, Slack, Stripe, Sentry, Datadog 모두 ’‘‘MCP 서버 ’‘‘공식 출시””’‘’‘’‘’‘’‘’‘. ’‘‘2026 년 ’‘‘MCP 가 ’‘‘사실상 ’‘‘표준화 리드””’‘’‘’‘’‘’‘*.
4.3. 권한 모델
- ’‘‘Claude Code — ’‘‘세밀한 권한 (settings.json)””’‘. *’‘‘Bash, Read, Write 각각””’’*
- ’‘‘Cursor — ’‘‘mode (ask, edit, agent)””’’* + ’‘‘rules””’’*
- ’‘‘Codex — ’‘‘sandbox 우선””’’*
- ’‘‘Gemini Code Assist — ’‘‘IDE 가 ’‘‘중재””’‘’’
4.4. 개인화 vs 팀 표준
- ’‘‘AGENTS.md (root) = ’‘‘팀 표준””’‘’‘’’*
- ’‘‘CLAUDE.md / .codex/instructions = ’‘‘개인 + 팀 추가””’‘’’
- ’‘’~/.claude/ = ’‘‘개인 글로벌””’‘’’
’‘‘3 단계 ’‘‘레이어 (개인 글로벌 / 레포 / 개인 추가) 가 ’‘‘사실상 표준””’‘’‘’‘’‘’‘’‘. ’‘‘Claude 가 ’‘‘*가장 먼저 *3 단계 명시**””’‘’‘’‘’‘. *’‘‘다른 도구도 ’‘‘따라옴””’‘*.
5. ’‘‘*왜 *’‘‘AGENTS.md 가 ’‘‘winner 가 될까* (또는 ’‘‘안 될까)’‘’‘’‘’‘’‘’’
5.1. ’‘‘Winner 가능성”“’’*
- ’‘‘Anthropic / OpenAI / Cursor 가 ’‘‘동시에 인정”“’‘’’ — ’‘‘경쟁자가 ’‘‘합의한 한 점””’‘’’
- ’‘‘중립적 이름”“’’* — ’‘‘특정 회사 종속 아님””’’*
- ’‘‘Markdown — 누구나 읽음”“’’*
- ’‘‘디렉토리 위치 명확”“’’*
5.2. ’‘‘Winner 가 못 될 가능성”“’’*
- ’‘‘Google 이 ’‘‘계속 ’‘‘독자 노선”“*’‘’‘’’ (Gemini.md)
- ’‘‘MCP / Skill 같은 ’‘‘바깥 layer 가 ’‘‘더 중요해질 수도”“*’‘’‘’’
- ’‘‘Anthropic 의 ’‘‘SKILL.md 가 ’‘‘AGENTS.md 를 ’‘‘대체할 가능성”“*’‘’‘’‘’’*
5.3. ’‘‘가장 가능성 높은 시나리오”“’’*
’‘‘AGENTS.md = ’‘‘표준 진입점 (entry)”“’‘’‘. ’‘‘MCP = ’‘‘표준 도구 호출”“’‘. *’‘‘Skill.md = ’‘‘표준 재사용 단위”“’‘. *’‘‘도구별 ’‘‘추가 파일은 ’‘‘있되 ’‘‘optional”“’‘’‘’‘’‘.
= ’‘‘AGENTS.md 가 ’‘‘단독 winner 가 아니라 ’‘‘3 층 표준의 ’‘‘한 층”“*’‘’‘’‘’‘’‘’‘’‘.
6. 조직 입장 — ’‘‘무엇을 ’‘‘first-class artifact 로 가야 하나”“’‘’‘’’*
2026 년 현재 ’‘‘조직이 ’‘‘박아야 할 4 가지 파일”“’‘’‘’‘*:
- AGENTS.md — ’‘‘모든 AI 도구 공통””’‘. *’‘‘2,000 자 이하””’’*
- docs/adr/ — ’‘‘결정 history””’‘. *’‘‘AI 가 ’‘‘why 를 학습””’’*
- .mcp.json — ’‘‘외부 도구 통합””’’*
- CONTRIBUTING.md — ’‘‘사람에게도 가치””’‘. *’‘‘AI 가 ’‘‘사람과 ’‘‘같은 정보 접근””’‘’’
선택적:
- ’‘‘.claude/skills/X/SKILL.md — ’‘‘Claude 전용 ’‘‘재사용 skill””’’*
- ’‘‘.cursor/rules — ’‘‘Cursor 사용 시 ’‘‘세밀 룰””’’*
’‘‘5 개 ’‘‘도구별 파일을 ’‘‘다 만들 필요 없다”“’‘’‘. ’‘‘AGENTS.md 한 개로 ’‘‘대부분 커버”“’‘*.
7. ’‘‘2026 ~ 2028 의 3 가지 시나리오’’*
7.1. 시나리오 A — ’‘‘AGENTS.md 가 ’‘‘완전 표준화’‘
- ’‘‘ISO / IEEE 표준화”“’‘’’ 또는 ’‘‘community spec 정착”“’’*
- ’‘‘Google 도 ’‘‘Gemini.md ’‘‘폐기 후 ’‘‘AGENTS.md 채택”“’‘’‘’‘’’
- ’‘‘확률 — ’‘‘40%”“’’*
7.2. 시나리오 B — ’‘‘다중 표준 공존’‘
- ’‘‘AGENTS.md (공통) + 도구별 ’‘‘추가 파일”“’‘’‘’’*
- ’‘‘현재 상태 ’‘‘고착”“’‘’’
- ’‘‘확률 — ’‘‘45%”“’’*
7.3. 시나리오 C — ’‘‘AGENTS.md ’‘‘무용화’‘
- ’‘‘컨텍스트가 ’‘‘전체 코드베이스를 ’‘‘다 읽을 만큼 ’‘‘커져서 ’‘‘AGENTS.md 불필요”“*’‘’‘’‘’‘’’
- ’‘‘Google 의 베팅이 ’‘‘옳았던 경우”“’‘’‘’’*
- ’‘‘확률 — ’‘‘15%”“’’*
8. ’‘‘*한국 IT 의 *’‘‘대응”“**’’
- ’‘‘카카오 / 네이버 / 토스”“ — ’‘‘AGENTS.md 채택 가속화””’‘’‘. ’‘‘사내 ’‘‘reference template 표준화””’’*
- ’‘‘라인”“ — ’‘‘Cursor + Claude Code 병용 + AGENTS.md 표준 “”’‘’’
- ’‘‘쿠팡”“ — ’‘‘전사 ’‘‘GitHub Copilot Enterprise + AGENTS.md”“’‘’‘’‘’‘’’*
- ’‘‘스타트업”“ — ’‘‘AGENTS.md 가 ’‘‘기본 cookiecutter 의 ’‘‘포함 항목”“’‘’‘’‘’’
9. 결론 — ’‘‘표준의 ’‘‘진짜 ’‘‘winner 는 ’‘‘단순함”“**’‘’‘’‘’‘’‘’’*
’‘‘기술 표준 전쟁의 ’‘‘가장 자주 등장하는 ’‘‘결말”“’‘’‘’’* — ’‘‘가장 단순한 형식이 ’‘‘가장 오래 살아남는다”“’‘’‘’‘’‘. ’‘‘Markdown + root 위치 + first-read”“’‘’‘’’* — ’‘‘이 3 가지가 ’‘‘복잡한 다른 형식 (XML, JSON schema, 도구별 디렉토리) 을 ’‘‘모두 이기는 ’‘‘유일한 이유”“*’‘’‘’‘’‘’‘’‘’‘.
’‘‘AGENTS.md 가 ’‘‘100% winner 일 가능성은 낮다”“’‘’‘’‘. *’‘‘그러나 ’‘‘80% 의 케이스에서 ’‘‘충분히 좋은 표준”“’‘’‘’‘’’ 일 가능성은 ’‘‘높다”“’‘. *’‘‘그게 ’‘‘기술 표준의 ’‘‘합리적 결말”“*’‘’‘’‘’‘*.
’‘‘’‘HTML 이 *’‘‘XHTML 을 ’‘‘이긴 이유는 ’‘‘simpler 였다’‘’‘’‘’‘’‘’‘’’ — ’‘‘같은 메커니즘이 ’‘‘*2026 년 *’‘‘AGENTS.md 에도 ’‘‘적용되고 있다’‘’‘’‘’‘’‘’‘’‘’‘*.
더 읽을 거리
- AGENTS.md community spec — https://agents.md/
- Anthropic Model Context Protocol — https://modelcontextprotocol.io/
- Cursor Rules Documentation — https://docs.cursor.com/rules
- GitHub Copilot Instructions — https://docs.github.com/en/copilot
- OpenAI Codex CLI — https://github.com/openai/codex
- Gemini Code Assist Documentation
- Boris Cherny — *’‘‘Why AGENTS.md’’ (Anthropic blog, 2024)
다음 글: 한국 IT 의 AI 도입 산업군별 *’‘‘실제 사례’‘. 카카오 / 토스 / 쿠팡 / 네이버 / 무신사 / 라인 / 우아한형제들 — ’‘‘공개된 후기 + 추론 가능한 패턴’‘’‘.