리뷰 게이트: 머지 전 체크리스트
리뷰 게이트는 변경이 라이브로 가기 전에 반드시 참이어야 하는 것들의 짧은 목록이다. 직접 훑거나, AI가 각 항목을 확인하게 하라:
- 디프를 읽었고 무엇이 왜 바뀌었는지 이해한다
- 변경이 내가 실제로 요청한 것으로 한정되어 있다
- 테스트가 통과한다 (그리고 새 동작에는 테스트가 있다)
- 타입 체크와 린터가 깨끗하다
- 남겨진 비밀, 디버그 로그, 주석 처리된 코드가 없다
- 안전 점검이 조용히 제거되지 않았다
- 적어도 정상 경로만이라도 직접 변경을 써봤다
박스 하나를 체크할 수 없다면, 끝난 게 아니다.
체크리스트가 의도적으로 짧은 이유는, 당신이 건너뛰는 게이트는 게이트가 아니기 때문이다. 특히 빠르게 움직이고 변경이 "괜찮아 보일" 때, 그냥 통과시키고 싶은 유혹이 있다. 사용자에게 노출되는 무엇에 대해서든 그 유혹에 저항하라. 유용한 요령은 AI가 당신을 위해 채우게 하는 것이다 — 목록을 붙여넣고 물어라: "방금 한 변경에 대해 이 리뷰 게이트를 훑어라. 각 항목에 대해 PASS 또는 FAIL을, 한 줄짜리 증거와 함께 말하라." AI는 테스트를 돌리지 않고서는 정직하게 "테스트 통과"라고 쓸 수 없고, 줄마다 증거를 대게 강제하면 막연한 "좋아 보임"이 감사 가능한 무언가로 바뀐다.