Codex검증과 협업

검증과 리뷰 루프

재현 절차, 최소 테스트, diff 검토, /review까지 연결해 Codex 산출물을 신뢰 가능한 결과로 바꾸는 검증 루프를 정리합니다.

마지막 수정 2026년 3월 20일

기본 패턴

text
검증 루프
1. 재현 절차를 먼저 준다.
2. 최소 수정으로 고치게 한다.
3. 가장 작은 관련 테스트를 다시 돌리게 한다.
4. git diff를 검토한다.
5. 필요하면 /review로 한 번 더 점검한다.

설명

  • OpenAI의 Prompting 가이드는 Codex가 자기 작업을 검증할 수 있을 때 품질이 높아진다고 설명합니다.
  • 버그 수정이라면 증상 설명보다 재현 절차가 더 중요하며, "무엇이 실패인지"가 분명해야 수정 후 재검증도 가능합니다.
  • 검증은 가능한 한 작은 범위부터 시작하는 것이 좋습니다. 전체 테스트보다 관련 테스트, 최소 린트, 직접 재현 확인이 먼저입니다.
  • 수정 후에는 명령 결과뿐 아니라 git diff도 같이 읽어야, 테스트는 통과하지만 설계상 어색한 변경을 걸러낼 수 있습니다.
  • 로컬 작업이 끝나면 /review로 working tree를 다시 훑게 하여 빠진 예외 처리나 테스트 누락을 한 번 더 점검할 수 있습니다.

짧은 예제

text
수정 요청 예시
- 먼저 버그를 재현해라.
- 수정은 최소화해라.
- 수정 후 npm test -- auth 관련 테스트만 다시 돌려라.
- 마지막에 실행한 명령, 결과, git diff에서 핵심 변경을 요약해라.

빠른 정리

단계확인할 것
재현실패 상태가 실제로 보이는가
수정범위가 최소한으로 유지되는가
테스트가장 작은 관련 검증이 통과하는가
diff 검토수정 이유와 변경 범위가 일치하는가
추가 리뷰빠진 테스트나 회귀 위험이 없는가

주의할 점

"테스트 통과"만으로 끝내면, 우연히 통과한 수정이나 과도한 변경을 놓치기 쉽습니다. Codex 사용에서는 명령 결과와 diff 검토를 항상 짝으로 보는 습관이 중요합니다.

참고 링크

3 sources