AGENTS.md 생성기 — 4개 AI 도구 통합
AGENTS.md 표준 하나로 Cursor, GitHub Copilot, Claude Code, OpenAI Codex가 같은 규칙을 공유하게 하세요.
AGENTS.md는 OpenAI가 Linux Foundation에 기증한 오픈 표준으로, 60,000개 이상의 GitHub 저장소에서 사용되고 있습니다. 한 파일로 4개 AI 도구의 동작을 통일할 수 있습니다.
주요 특징
표준 채택
60,000+ 저장소가 채택한 사실상의 업계 표준
다도구 호환
Cursor, Copilot, Codex가 직접 인식. Claude Code는 @AGENTS.md 임포트
6대 핵심 섹션
Commands / Testing / Project Structure / Code Style / Git Workflow / Boundaries
자유 형식 Markdown
frontmatter 없는 단순 마크다운으로 누구나 읽고 편집 가능
생성되는 파일 예시
# Agent Instructions
This file provides shared instructions for AI coding agents.
Following the AGENTS.md open standard (https://agents.md).
## Code Style
- Never use the `any` type in TypeScript. Prefer `unknown` with type narrowing.
- Use functional components exclusively. Manage state with hooks.
## Git Workflow
- All commit messages must follow Conventional Commits: `<type>(<scope>): <description>`.
## Boundaries
### ✅ Always do
- Always run the test suite after making changes.
### 🚫 Never do
- Never commit secrets, API keys, tokens, or credentials.
자주 묻는 질문
-
AGENTS.md는 어떤 표준인가요?
AGENTS.md는 OpenAI가 Linux Foundation에 기증한 오픈 표준 문서로, AI 코딩 에이전트가 프로젝트 컨벤션을 이해하도록 돕는 단일 파일입니다. 60,000개 이상의 GitHub 저장소에서 채택되어 사실상의 업계 표준 위치를 차지하고 있습니다. -
어떤 AI 도구가 AGENTS.md를 직접 읽나요?
OpenAI Codex가 1차 컨텍스트로 AGENTS.md를 직접 읽습니다. Cursor와 GitHub Copilot도 공식적으로 인식합니다. Claude Code는 직접 읽지 않으므로 CLAUDE.md에서 @AGENTS.md 임포트 한 줄로 동일 규칙을 공유하게 됩니다. -
어떤 섹션을 포함해야 하나요?
GitHub Blog가 분석한 2,500개 이상 저장소 패턴 기준으로 Commands / Testing / Project Structure / Code Style / Git Workflow / Boundaries 6대 섹션이 가장 영향력이 큽니다. ConfigDeck은 이 6대 섹션을 자동 생성합니다. -
AGENTS.md에 길이 제한이 있나요?
OpenAI Codex는 AGENTS.md를 최대 32KiB까지 읽습니다. 그 이상은 잘릴 수 있으므로 자주 사용하는 핵심 규칙만 남기고, 상세 가이드는 별도 문서로 분리하는 것이 좋습니다. -
기존 .cursorrules나 다른 설정 파일에서 마이그레이션할 수 있나요?
AGENTS.md는 자유 형식 Markdown이므로 기존 인스트럭션을 그대로 옮겨 쓸 수 있습니다. ConfigDeck은 스택과 베스트 프랙티스를 입력으로 받아 6대 섹션 구조로 자동 정리해주므로, 흩어진 규칙을 단일 진실원으로 통합하는 데 유용합니다.