AI 에이전트가 프로젝트를 이해하고 올바르게 행동하도록 가이드하는 마크다운 문서. CLAUDE.md의 멀티에이전트 버전이다.
CLAUDE.md가 Claude에게 프로젝트 컨텍스트를 주는 파일이라면, AGENTS.md는 여러 AI 에이전트 시스템(Codex, Gemini, 커스텀 에이전트 등)이 공통으로 참조할 수 있는 표준화된 지침 파일이다. 코딩 컨벤션, 브랜치 전략, 테스트 방법, 배포 절차 같은 정보를 담아두면 어떤 에이전트가 작업하든 일관된 방식을 따르게 된다.
리포지토리 루트에 AGENTS.md를 두고 "PR은 feature/ 브랜치에서, 커밋 메시지는 Conventional Commits 형식, 테스트는 npm test로 확인"처럼 작성해두면, Claude Code든 Codex든 이 파일을 읽고 규칙에 맞게 작업한다. 하위 디렉토리에 별도 AGENTS.md를 두면 해당 영역에 특화된 지침을 추가할 수 있다.