AGENTS.md의 Codex Code Review 규칙 (2026년 7월)

2026년 7월 OpenAI는 Codex용 커스텀 Code Review 규칙을 출시했습니다. 또 하나의 스타일 린터가 아니라, 소수 리뷰어 머릿속에만 있던 판단을 저장소에 적는 방식입니다 — 깨면 안 되는 API 계약, 구 클라이언트를 위해 남겨야 하는 필드, 로그에 나가면 안 되는 데이터.

무엇이 바뀌었나

• 같은 AGENTS.md, 새 역할 — 코딩 작업을 안내하던 파일이 이제 GitHub 리뷰도 안내합니다.
• ## Code Review Rules — 전용 섹션을 추가하세요. Codex는 변경 파일에 해당하는 규칙을 적용하고 finding에 인용합니다.
• 루트 + 중첩 — 저장소 전역은 루트, 서비스별은 해당 코드 근처에.
• 트리거 — PR에 @codex review를 달거나 Codex 설정에서 자동 리뷰를 켭니다.

본전 뽑는 최소 규칙

리뷰어가 반복해서 설명하는 체크부터 시작하세요. OpenAI 자체 Codex 저장소는 Cloud 소비자가 아직 의존하는 실험적 이벤트 이름을 보호합니다. 여러분 버전은 예를 들어:

• 불변조건을 명시합니다(무엇이 항상 참이어야 하는지).
• 안전한 경로를 제시합니다(이름 유지, 또는 하위 호환 이벤트 추가).
• 짧게 유지 — 너무 넓으면 노이즈, 범위를 좁히면 깨끗한 diff를 어지럽히지 않습니다.

이번 주 시도 방법

1. 저장소에 Codex cloud + Code Review를 켭니다.
2. 가장 가까운 AGENTS.md의 ## Code Review Rules에 규칙 2~3개를 추가합니다.
3. 규칙을 트리거할 PR, 안전한 반례, 무관한 변경을 준비합니다.
4. @codex review를 요청 — 시끄러운 문구를 다듬고 깔끔히 맞는 규칙을 남깁니다.

Skills와의 관계

규칙은 Skills·MCP와 나란히 둡니다. Skills는 어떻게, AGENTS.md는 절대 깨면 안 되는 것. 무료 한도 팁은 Try Codex, 설치형 playbook은 업데이트된 Skills 디렉터리. 공식 글: Custom Code Review rules for Codex.

에이전트 때문에 PR이 늘고 리뷰가 병목이라면, 반복해서 설명하던 한 가지를 AGENTS.md에 한 번 쓰고 Codex가 매 PR에서 인용하게 하세요.