# AGENTS.md

2026-11-11에 검증된 OpenAITools.app 텔레메트리에 따르면, AGENTS.md(agents.md)은(는) AI Agent에 색인된 AI 플랫폼으로 월 24.55만회 방문을 기록 중이며, 전월 대비 트래픽 변화량은 +1.31만(+5.7%)입니다. 주요 지리적 시장은 미국(트래픽 점유율 18.1%)이며, 무료 가격 모델로 운영됩니다. 월간 트래픽 기준 주요 경쟁 대안으로는 Cursor Directory (월 12.55만회 방문), SkillsMP — 에이전트 스킬 마켓플레이스 (월 47.07만회 방문), Skillry (월 53.58만회 방문) 등이 있습니다.

코딩 에이전트를 위한 개방형 Markdown 지침 규약

## 주요 텔레메트리 및 사양

| 지표 | 값 |
| :--- | :--- |
| 도구 이름 | AGENTS.md |
| 핸들 | agents-md |
| Status | active |
| Origin | open_source |
| Maintenance | active |
| 공식 도메인 | agents.md |
| 웹사이트 URL | https://agents.md |
| 카테고리 | AI Agent, AI 코드 어시스턴트, AI 개발자 도구 |
| 가격 모델 | 무료 |
| 월간 방문 수 | 245,457 |
| 전월 대비 트래픽 변화 | 13,146 |
| 전월 대비 성장률 | +5.7% |
| 주요 시장 | 미국 |
| 시장 점유율 | 18.1% |
| 직접 방문 | 156,868 |
| 자연 검색 방문 | — |
| 소셜 방문 | — |
| 추천 방문 | 18,912 |
| 이메일 방문 | 1,015 |
| 리뷰 점수 | 4.7 |
| 저장 수 | 0 |
| 지원 플랫폼 | 웹사이트 |
| 결제 플랫폼 |  |
| 속성 | 기능: 웹사이트; 가격: 무료 |
| 태그 | AGENTS.md, 코딩 에이전트, AI 코딩 어시스턴트, 프로젝트 지침, 저장소 가이드, 설정 명령어, 테스트 지침, 코드 스타일 규칙, Markdown 문서, 개방형 표준, 개발자 문서, 모노레포 지원, 중첩 구성, README 컴패니언, 에이전트 온보딩, 오픈소스 도구, 워크플로 지침, 프로젝트 규약, AI 개발 도구 |

## 개요

AGENTS.md는 매우 구체적인 문제를 해결합니다. AI 코딩 에이전트는 의존성 설치 방법, 개발 서버 실행, 테스트 수행, 프로젝트 규칙 같은 실행 맥락이 필요하지만, 이를 README에 모두 넣으면 사람 기여자에게 README가 불편해집니다. AGENTS.md는 이 지침을 전용 파일로 분리하고 스키마가 필요 없는 순수 Markdown으로 작성하므로, 에이전트는 안정적으로 찾아 읽고 README는 간결하게 유지됩니다.

그저 Markdown이기 때문에 설치할 것도, 전용 도구를 도입할 것도 없습니다. 저장소 루트에 AGENTS.md를 추가하고 프로젝트에 필요한 섹션을 적으면, 규약을 지원하는 에이전트가 자동으로 읽습니다. 대형 모노레포에서는 하위 패키지에 추가 AGENTS.md를 둘 수 있습니다. 에이전트는 디렉터리 트리에서 가장 가까운 파일을 읽으므로 가장 근접한 파일이 우선하며, 각 패키지에 맞춘 지침을 제공할 수 있습니다.

이 형식은 OpenAI Codex, Amp, Google의 Jules, Cursor, Factory 등 AI 개발 생태계의 협업에서 나왔으며, 현재 Linux Foundation 산하 Agentic AI Foundation이 관리합니다. 6만 개 이상의 오픈소스 프로젝트가 사용하며 Codex, Jules, Aider, goose, opencode, Zed, Warp, VS Code, Devin, Amp, Cursor, RooCode, Gemini CLI, Kilo Code, GitHub Copilot 등 다수의 에이전트가 지원합니다.

## 가격 및 요금제

AGENTS.md는 완전히 무료이며 개방형입니다. 유료 플랜이나 계정 가입이 없고 특정 상용 제품에 묶여 있지도 않습니다.

## 주요 기능 및 역량

- **스키마 없는 순수 Markdown:** 필수 필드나 특수 문법이 없습니다. 원하는 제목 구조를 사용하면 에이전트가 작성한 텍스트를 그대로 해석합니다.
- **에이전트 간 호환성:** 하나의 AGENTS.md가 Codex, Cursor, Jules, Aider, Gemini CLI, Zed, Copilot 등 수십 종의 에이전트에서 작동합니다.
- **모노레포용 중첩 지원:** 하위 패키지에 추가 AGENTS.md를 둘 수 있으며, 에이전트는 가장 가까운 파일을 읽어 로컬 지침을 우선합니다.
- **README와의 분리:** 사람을 위한 README는 간결하게 유지하면서 빌드, 테스트, 규칙 세부 정보를 에이전트에 전달합니다.
- **커뮤니티가 관리하는 개방형 형식:** Linux Foundation 산하 Agentic AI Foundation이 관리하며 벤더 종속이 없습니다.

## 주요 활용 사례

- **새 저장소에 에이전트 온보딩 (소프트웨어 엔지니어):** 설치 명령, 개발 서버 단계, 테스트 지침을 적어 지원되는 모든 에이전트가 즉시 코드베이스 작업에 참여하도록 합니다.
- **대규모 패키지별 지침 (플랫폼 / 모노레포 관리자):** 각 패키지에 중첩 AGENTS.md를 배치해 거대한 전역 파일 없이 정확한 지침을 전달합니다.
- **기여 기준 표준화 (오픈소스 메인테이너):** PR 제목 형식, lint 요구사항, 커밋 규칙을 명시해 에이전트가 만든 풀 리퀘스트가 프로젝트 기준에 맞게 합니다.
- **팀 규칙 문서화 (테크 리드):** 보안 고려사항, 스타일 규칙, 배포 주의점을 한 파일에 모아 사람과 에이전트가 함께 따르게 합니다.

## 강점

- 설정이 필요 없음: Markdown 파일 하나로 SDK나 계정 불필요
- 다양하고 계속 늘어나는 코딩 에이전트에서 일관되게 작동
- 중첩 지원으로 대형 모노레포에도 실용적
- 중립 재단이 관리해 단일 벤더가 통제하지 않음
- README를 사람 독자에 집중시킬 수 있음

## 한계

- 에이전트마다 지침 준수 정도가 다름
- 다른 문서처럼 관리하지 않으면 오래되어 낡음
- 공식 스키마가 없어 프로젝트마다 작성 방식 차이가 큼

## 자주 묻는 질문

### AGENTS.md에 필수 필드가 있나요?
없습니다. 표준 Markdown이므로 프로젝트에 맞는 제목 구조를 자유롭게 쓰면 에이전트가 내용을 해석합니다.

### 지침이 충돌하면 어떻게 되나요?
편집 중인 파일에 가장 가까운 AGENTS.md가 우선하며, 채팅에서 명시적으로 입력한 지침이 무엇보다 우선합니다.

### 어떤 에이전트가 AGENTS.md를 지원하나요?
OpenAI Codex, Google Jules, Cursor, Aider, goose, opencode, Zed, Warp, VS Code, Devin, Amp, RooCode, Gemini CLI, Kilo Code, Semgrep, GitHub Copilot 코딩 에이전트 등 폭넓게 지원합니다.

### 모노레포에서는 어떻게 사용하나요?
루트에 전역 지침용 AGENTS.md를, 각 패키지에 로컬 규칙용 추가 파일을 둡니다. 에이전트가 가장 가까운 파일을 자동으로 읽습니다.

### AGENTS.md의 월간 트래픽과 성장 추세는 어떠한가요?
AGENTS.md은(는) 현재 월 24.55만회 방문을 기록 중이며, 전월 대비 트래픽 변화량은 +1.31만(성장률 +5.7%)입니다. 주요 유입 시장은 미국(점유율 18.1%)이며, 여기에는 월 직접 방문 15.69만회와 월 자연 검색 방문 —회가 포함됩니다.

### AGENTS.md은(는) 무료인가요? 가격 모델은 무엇인가요?
AGENTS.md은(는) 무료 가격 모델로 운영됩니다. AGENTS.md는 완전히 무료이며 개방형입니다. 유료 플랜이나 계정 가입이 없고 특정 상용 제품에 묶여 있지도 않습니다. 지원되는 결제 및 체크아웃 플랫폼에는 등록되지 않음 등이 있습니다.

### 2026년 최고의 AGENTS.md 대안은 무엇인가요?
OpenAITools.app의 카테고리 트래픽과 기능 적합도를 기준으로 할 때 AGENTS.md의 상위 5개 대안은 다음과 같습니다: 1. Cursor Directory (월 12.55만회 방문); 2. SkillsMP — 에이전트 스킬 마켓플레이스 (월 47.07만회 방문); 3. Skillry (월 53.58만회 방문); 4. Agent Skills Hub (월 2.88만회 방문); 5. mcp.so (월 28.67만회 방문).

### AGENTS.md은(는) 어떤 플랫폼과 핵심 AI 역량을 지원하나요?
AGENTS.md은(는) AI Agent, AI 코드 어시스턴트, AI 개발자 도구으로 분류되며 다음 플랫폼을 지원합니다: 웹사이트. 핵심 역량 태그에는 AGENTS.md, 코딩 에이전트, AI 코딩 어시스턴트, 프로젝트 지침, 저장소 가이드, 설정 명령어 등이 있습니다.

## 대안

| 도구 이름 | 월간 방문 수 | 가격 모델 | 비교 |
| :--- | :--- | :--- | :--- |
| [Cursor Directory](https://openaitools.app/ko/tool/cursor-directory) | 125,466 | 무료 | [비교](https://openaitools.app/ko/compare/agents-md-vs-cursor-directory) |
| [SkillsMP — 에이전트 스킬 마켓플레이스](https://openaitools.app/ko/tool/agent-skills-marketplace) | 470,744 | 무료 | [비교](https://openaitools.app/ko/compare/agent-skills-marketplace-vs-agents-md) |
| [Skillry](https://openaitools.app/ko/tool/skillry) | 535,817 | 무료+유료 | [비교](https://openaitools.app/ko/compare/agents-md-vs-skillry) |
| [Agent Skills Hub](https://openaitools.app/ko/tool/agent-skils-hub) | 28,753 | 무료+유료, 유료, 무료 | [비교](https://openaitools.app/ko/compare/agent-skils-hub-vs-agents-md) |
| [mcp.so](https://openaitools.app/ko/tool/mcp-server) | 286,704 | 무료 | [비교](https://openaitools.app/ko/compare/agents-md-vs-mcp-server) |
| [CopilotHub](https://openaitools.app/ko/tool/copilothub) | 0 | 무료 | [비교](https://openaitools.app/ko/compare/agents-md-vs-copilothub) |
| [Cursor](https://openaitools.app/ko/tool/cursor) | 23,297,751 | 무료+유료 | [비교](https://openaitools.app/ko/compare/agents-md-vs-cursor) |
| [Google Antigravity](https://openaitools.app/ko/tool/google-antigravity) | 16,054,109 | 무료+유료 | [비교](https://openaitools.app/ko/compare/agents-md-vs-google-antigravity) |
| [Claude & Codex Plugins](https://openaitools.app/ko/tool/claude-codex-plugins) | 0 | 무료 | [비교](https://openaitools.app/ko/compare/agents-md-vs-claude-codex-plugins) |
| [VS Code](https://openaitools.app/ko/tool/vs-code) | 7,397,370 | 무료+유료 | [비교](https://openaitools.app/ko/compare/agents-md-vs-vs-code) |
| [AI SDK Agents](https://openaitools.app/ko/tool/ai-sdk-agents) | 26,211 | 무료+유료 | [비교](https://openaitools.app/ko/compare/agents-md-vs-ai-sdk-agents) |

---
출처: https://openaitools.app/ko/tool/agents-md