실전 패치 루프

Codex의 기본 산출물은 설명이 아니라 리뷰 가능한 패치입니다. 좋은 작업 루프는 범위 정하기 → diff 만들기 → 검증하기 → 리뷰 메모 → handoff 순서로 닫힙니다.

이 문서를 읽으면

작은 버그 하나를 골라 “수정 전 재현 증거”와 “수정 후 통과 증거”를 모두 남기게 하세요. 둘 중 하나가 없으면 아직 완료가 아닙니다.

루프	목적	닫히는 증거
저장소 탐색	처음 보는 저장소의 진입점과 위험 파악	저장소 지도, 실행 후보 명령
버그 수정	재현 가능한 실패를 작게 수정	failing/passing test evidence
기능 수정	새 기능을 좁은 diff로 구현	diff, 수락 기준 확인
UI 검증	화면 구현과 브라우저/스크린샷 확인	screenshot note, 반응형 확인
CI 재실행	실패 job을 로컬/CI 차이로 분리	실패 분류, rerun 결과
PR 리뷰	사람이 볼 위험을 먼저 드러냄	review note, requested changes

어려운 작업은 한 번에 끝내려고 하지 말고, 점수를 매기고 다시 돌릴 수 있는 루프로 만듭니다. 이때 “더 해봐”가 아니라 다음 반복에서 무엇을 더 좋아지게 할지 한 가지 기준을 정합니다.

반복 기준	다음 요청 예시
실패 재현	“아직 재현 증거가 약합니다. 실패 조건을 하나 더 좁히고 로그를 남겨주세요.”
테스트 범위	“수정 파일 주변의 가장 작은 테스트만 추가하고, 전체 테스트는 마지막에 돌려주세요.”
UI 품질	“모바일 스크린샷에서 겹침과 넘침만 다시 확인하고 필요한 CSS만 고쳐주세요.”
리뷰 품질	“요약을 줄이고 리뷰어가 봐야 할 위험 3개와 파일 위치를 먼저 적어주세요.”

반복이 끝나는 기준은 “설명이 그럴듯함”이 아니라 같은 검증 명령, 같은 화면, 같은 PR 기준에서 더 이상 새 문제가 나오지 않는 상태입니다.

작업이 끝났다는 말은 짧아도 됩니다. 대신 리뷰어가 바로 확인할 수 있는 증거가 있어야 합니다.

약한 보고	좋은 보고
수정했습니다	`packets.md`에 예시 섹션을 추가했고, `npm.cmd run build`가 통과했습니다. 남은 위험은 예시가 실제 팀 도메인과 다를 수 있다는 점입니다.
테스트는 못 했지만 될 것 같습니다	빌드는 통과했습니다. 브라우저 확인은 하지 못했고, 모바일 긴 문장 overflow는 남은 확인 항목입니다.
CI 고쳤습니다	실패 job은 lockfile 불일치였고, package version 고정 후 로컬 build와 redirect check가 통과했습니다. CI rerun은 아직 필요합니다.

완료 보고는 성과 자랑이 아니라 다음 사람이 시간을 덜 쓰게 하는 압축된 handoff입니다.