WEBBOOK CHAPTER

AI가 짠 코드, 어디서부터 고칠까: 13장 Codex와 검증 계약을 맺는다

13장 Codex와 검증 계약을 맺는다

Codex에게는 목표, 관련 파일, 제약, 완료 조건을 준다. 저장소의 반복 규칙은 AGENTS.md에 둔다.


# AGENTS.md

- 예약 도메인 변경 뒤 `npm test`를 실행한다.
- 라이브 결제·메일·문자를 호출하지 않는다.
- 시간 테스트에는 고정된 `now`를 주입한다.
- 완료 보고에는 바뀐 파일과 실행한 검증을 적는다.

AGENTS.md는 마법의 품질 보증서가 아니다. 실제 명령이 맞고 빠르게 실행되어야 한다. 규칙이 길어지면 반복 실수와 관계없는 설명을 덜어 낸다.

좋은 작업 요청은 작다.


RoomRelay의 겹침 예약만 수정해 줘.
현재 [start,end) 규칙을 유지하고 시간대 변환은 건드리지 마.
실패 테스트를 먼저 추가한 뒤 최소 구현으로 통과시켜.
전체 테스트와 변경 diff를 검토하고 남은 위험을 보고해.

AI가 구현과 테스트를 모두 작성했으면 독자는 실패 테스트가 수정 전 코드에서 실제로 실패했는지 확인한다. 이것이 “테스트도 있습니다”와 회귀를 잡는 테스트의 차이다.