에이전트 지침 파일
모든 코딩 에이전트는 작업을 시작하기 전에 프로젝트의 상시 지침 파일을 불러옵니다. 각 도구가 파일을 찾는 위치, 인식하는 frontmatter, 전역·프로젝트·중첩 파일의 병합 방식을 정리했습니다. 2026-10-01 기준으로 각 업체의 문서를 확인했습니다.
도구별로 읽는 파일
| 도구 | 읽는 파일 | AGENTS.md |
|---|---|---|
| OpenAI Codex | AGENTS.mdAGENTS.override.md~/.codex/AGENTS.md | 기본 지원 |
| Claude Code | CLAUDE.mdCLAUDE.local.md.claude/rules/*.md~/.claude/CLAUDE.mdAGENTS.md | 기본 지원 |
| Cursor | .cursor/rules/*.mdcAGENTS.md | 기본 지원 |
| GitHub Copilot | .github/copilot-instructions.md.github/instructions/*.instructions.mdAGENTS.mdCLAUDE.mdGEMINI.md | 기본 지원 |
| Gemini CLI | GEMINI.md~/.gemini/GEMINI.md.gemini/settings.json | 설정 필요 |
| Devin Desktop (구 Windsurf) | .devin/rules/*.md.windsurf/rules/*.md.windsurfrules~/.codeium/windsurf/memories/global_rules.mdAGENTS.md | 기본 지원 |
| Cline | .clinerules/*.md.cline/rules/*.mdAGENTS.md.cursorrules.windsurfrules | 기본 지원 |
| Aider | .aider.conf.yml | 설정 필요 |
| OpenClaw | AGENTS.mdSOUL.mdIDENTITY.mdUSER.mdMEMORY.md | 기본 지원 |
AGENTS.md 하나를 단일 기준으로 유지하고 나머지 도구가 이를 참조하도록 설정하세요. 위의 9개 도구 중 7개는 별도 설정 없이 AGENTS.md를 읽습니다. Gemini CLI와 Aider에는 설정 한 줄이 필요하며, @AGENTS.md만 적은 CLAUDE.md를 두면 이전 버전의 Claude Code도 최신 지침을 따릅니다. AGENTS.md로 표현할 수 없는 경로별 규칙에만 각 도구의 자체 규칙 형식을 사용하세요.
모든 지침 파일
AGENTS.mdAGENTS.md
AGENTS.md는 대부분의 코딩 에이전트가 별도 설정 없이 읽는 일반 Markdown 형식의 프로젝트 지침 파일입니다. OpenAI는 이 파일을 Linux Foundation 산하 Agentic AI Foundation에 기여했으며, 6만 개가 넘는 오픈소스 프로젝트에서 사용합니다.
CLAUDE.mdCLAUDE.md (Claude Code)
CLAUDE.md는 Claude Code가 시작할 때 홈 디렉터리, 프로젝트, 모든 상위 디렉터리에서 불러오는 메모리 파일입니다. .claude/rules/의 경로별 규칙은 일치하는 파일을 읽을 때만 적용되는 추가 지침을 제공합니다.
GEMINI.mdGEMINI.md (Gemini CLI)
GEMINI.md는 Gemini CLI가 모든 prompt와 함께 보내는 컨텍스트 파일입니다. context.fileName을 설정하면 AGENTS.md나 다른 이름의 파일도 읽을 수 있습니다.
.cursor/rules/*.mdcCursor Project Rules (.cursor/rules/*.mdc)
Cursor Project Rules는 .cursor/rules/에 있는 .mdc 파일이며, frontmatter에서 각 규칙을 적용할 시점을 지정합니다. Cursor는 AGENTS.md도 읽으며, 저장소 외부에서 설정하는 User Rules와 Team Rules도 지원합니다.
.github/copilot-instructions.mdGitHub Copilot custom instructions
GitHub Copilot은 저장소 전체에 적용되는 .github/copilot-instructions.md 파일 하나와 경로별 .instructions.md 파일을 읽습니다. AGENTS.md도 따르며, 대안으로 루트에 CLAUDE.md 또는 GEMINI.md 파일 하나를 둘 수 있습니다.
.devin/rules/*.mdDevin Desktop (Windsurf) rules
2026-06-02부터 Windsurf의 새 이름인 Devin Desktop은 .devin/rules/의 규칙 파일을 읽으며, .windsurf/rules/와 레거시 .windsurfrules도 계속 지원합니다. 각 규칙의 trigger에 따라 항상 적용하거나, glob으로 일치시키거나, 모델이 선택하거나, 수동으로 호출할 수 있습니다.
.clinerules/Cline Rules (.clinerules/)
Cline Rules는 .clinerules/의 Markdown 파일로, Cline은 이를 전역 규칙 및 AGENTS.md와 함께 적용합니다. 선택 사항인 paths 프런트매터를 사용하면 규칙을 일치하는 파일에만 적용할 수 있습니다.
~/.openclaw/workspace/AGENTS.mdOpenClaw workspace bootstrap files
OpenClaw는 워크스페이스의 Markdown 부트스트랩 파일을 바탕으로 각 에이전트의 컨텍스트를 구성합니다. 필수 파일인 AGENTS.md가 그 중심입니다. 이 파일은 새 세션이 시작될 때마다 첫 턴의 system prompt에 삽입됩니다.