용어 · AI 코딩
AGENTS.md
여러 AI 코딩 에이전트가 공통으로 읽는 저장소의 지침 파일로, 에이전트용 README 역할을 한다.
실무에서 뜻하는 것
AGENTS.md는 사람용 README와 따로 두는 AI 에이전트용 작업 설명서입니다. 빌드·테스트 명령, 코드 규칙, 하지 말아야 할 일을 적습니다. 파일은 저장소 루트에 둡니다. 하위 프로젝트마다 별도 파일을 둘 수 있고, 작업 위치에 가장 가까운 파일이 우선합니다. 코덱스, Cursor, Gemini CLI, GitHub Copilot 같은 도구가 이 형식을 읽습니다. 관리는 Linux Foundation 산하 Agentic AI Foundation이 맡습니다.
리텐션에서 쓴 예
GPT-5.4/Codex 프롬프트 구조 글은 Codex 프로젝트 루트에 AGENTS.md를 두라고 권했습니다. 예시 파일에는 규칙 네 줄을 적었습니다. 작업은 끝까지 마칠 것, 꼭 필요할 때만 질문할 것, 완료 전에 테스트를 돌릴 것, 동작하는 전체 코드를 낼 것입니다. 글은 이 파일이 없으면 세션마다 같은 규칙을 프롬프트에 다시 넣어야 한다고 적었습니다.
헷갈리기 쉬운 것
CLAUDE.md는 Claude Code 전용 지침 파일입니다. 2026-10 기준 Claude Code는 기본 설정에서 CLAUDE.md가 없을 때만 AGENTS.md를 읽습니다. 두 파일을 함께 쓰려면 CLAUDE.md 첫 줄에 @AGENTS.md를 넣어 가져옵니다.
이 용어가 나오는 글
관련 용어
출처: AGENTS.md 공식 사이트 · Claude가 프로젝트를 기억하는 방법: AGENTS.md (Claude Code 공식 문서)
수정 · Markdown 원문