AGENTS.md 탐색 순서와 우선순위

기본 패턴

탐색 순서의 큰 흐름
1. ~/.codex/AGENTS.override.md 또는 ~/.codex/AGENTS.md
2. 저장소 루트의 AGENTS.override.md 또는 AGENTS.md
3. 현재 작업 디렉터리까지 내려오며 더 가까운 AGENTS 파일

원칙
- 더 가까운 디렉터리 지침이 더 강합니다.
- 여러 파일은 root -> leaf 순서로 합쳐집니다.

설명

• 공식 가이드에 따르면 Codex는 전역 지침과 저장소 지침을 모두 읽고, 현재 작업 위치에 가까운 파일일수록 더 구체적인 규칙으로 취급합니다.
• 각 디렉터리에서는 AGENTS.override.md가 있으면 먼저 보고, 없으면 AGENTS.md를 봅니다.
• 저장소 루트에서 현재 작업 디렉터리까지 여러 파일이 있으면 root에서 leaf 순으로 병합되며, 가까운 지침이 앞선 지침을 덮어씁니다.
• 비어 있는 파일은 건너뛰고, 전체 읽기 크기에도 기본 상한이 있으므로 장황한 문서 여러 개를 누적하는 방식은 좋지 않습니다.
• 하위 패키지에만 적용되는 규칙은 그 패키지 가까이에 두고, 전역 커뮤니케이션 스타일 같은 내용은 ~/.codex에 두는 편이 자연스럽습니다.

짧은 예제

codex --ask-for-approval never "Summarize the current instructions."
codex --cd packages/api --ask-for-approval never "Show which instruction files are active."

빠른 정리

주의할 점