AGENTS.md — AI 코딩 에이전트의 합의 표준

1. 요약

AGENTS.md 는 2024년 OpenAI Codex, Cursor, Google Jules, Factory, Amp 등 주요 AI 코딩 도구 회사들이 공동 합의 한 오픈 표준 이다. 2025년 GitHub Copilot 도 native 지원 추가. 현재 Linux Foundation 산하 Agentic AI Foundation 이 관리. "AI 도구를 위한 README" 라는 단순한 정의.

2. 배경 (이전 도구의 한계)

2024년 AI 코딩 도구 생태계가 심각하게 분열 됐다:

• Cursor → .cursor/rules/ (or 구 .cursorrules)
• GitHub Copilot → .github/copilot-instructions.md
• Claude Code → CLAUDE.md
• Aider → .aider.conf.yml
• Continue → .continue/

같은 프로젝트에 여러 AI 도구를 쓰면 5~6 개 파일을 동기화 해야 했다. 1990년대 OO 표기법 카오스 (Booch / OMT / OOSE) 의 데자뷰. 답: 통합 표준.

3. 핵심 개념·표기법

AGENTS.md 의 원칙:

• Plain Markdown
• 필수 필드 ❌, 강제 형식 ❌
• README for agents 로 생각
• 프로젝트 루트 또는 sub-directory 별 AGENTS.md 가능

전형적 AGENTS.md 예시:

# Project Agents Guide

## Setup
- Run `npm install`
- Use Node 20+

## Code Style
- TypeScript strict mode
- ESLint + Prettier

## Testing
- Run `npm test` before commit
- Use Jest

## Don'ts
- Don't use `any` type
- Don't commit to main directly

4. 언어·OS 매핑 (★ 강의 핵심)

★ AGENTS.md 는 AI 도구 무관 — Codex·Cursor·Claude Code·Copilot·Jules·Aider 모두 같은 파일 읽음. 1997년 UML 통합과 정확히 같은 패턴.

5. 현대까지의 영향

• Linux Foundation Agentic AI Foundation — 거버넌스
• awesome-cursorrules → awesome-agents-md 전환
• .gitignore 와 같은 프로젝트 표준 파일 위상 확보
• AI Agent 시대의 표준 인터페이스

6. 주요 인물·사건

7. 강의 활용

★ 분열에서 통합으로 — 1990년대 OO 카오스 → UML (1997) 통합과 정확히 같은 곡선. 본 강의에서 "역사는 반복된다" 의 사례. 표준화는 도구의 성숙 신호 — AGENTS.md 가 산업 표준이 됐다는 것은 AI 코딩 도구가 기반 기술 단계로 진입했다는 의미. 본 강의의 Vibe Coding 시대 가 이미 시작 됐음을 증명.

출처

• AGENTS.md — Official site
• AGENTS.md — OpenAI Codex Docs
• agents.md: Complete Guide — PRPM
• openai/codex AGENTS.md — GitHub

그룹 시리즈

→ synthesis/group-se_g6 (시대 그룹 종합 카드)