코드 리뷰

사용자가 branch, PR, 특정 commit 이후 변경, spec 준수 또는 구현 결과의 독립 검토를 요청했거나 현재 변경에 수정과 분리된 review가 필요할 때 사용하세요. 코드 수정, 원인 불명 결함 진단 또는 전면 architecture 재설계 요청에는 사용하지 마세요.

계약

코드를 편집하거나 자동 재review하지 말고 fixed point 확정 → diff 규모 분류 → 전체 diff bounded inspection → Standards 근거 확인 → Spec 근거 확인 → 축별 finding → verdict 순서를 지키세요. fixed point, diff 또는 필수 근거에 접근할 수 없으면 Unverifiable, 사용자 결정이나 권한이 없어 진행할 수 없으면 Blocked, 실제 위반이 있으면 Changes requested입니다.

모든 finding에는 severity, 제목, file:line evidence, basis, impact가 필요합니다. 일부 파일이나 축만 읽고 전체 review를 통과로 보고하지 마세요. Pass는 고정한 diff 전체와 적용 가능한 축을 검사했고 미검증 범위가 없을 때만 사용하세요.

Workflow

1. fixed point: 입력은 사용자의 review 범위와 저장소 ref이고, 출력은 검증된 기준 commit과 review-head commit입니다.
2. diff inventory: 입력은 기준 commit과 review-head이고, 출력은 변경 파일·변경량·범위 log, small | large | size_unknown 분류와 inspection 경로입니다.
3. standards evidence: 입력은 선택한 경로로 전체 파일·hunk를 확인한 결과와 저장소 지침이고, 출력은 적용 가능한 Standards 근거, 조건부 high-risk signal과 축별 findings입니다.
4. spec evidence: 입력은 선택한 경로로 전체 파일·hunk를 확인한 결과와 우선순위에 따른 spec/ticket source이고, 출력은 적용 가능한 Spec ID별 상태·누락·위반 findings 또는 spec 없음 판정입니다.
5. axis verdict: 입력은 Standards와 Spec 결과이고, 출력은 두 축을 합치지 않은 상태별 verdict입니다.
6. receipt: 입력은 fixed point, 검사 범위, findings, 미검증 항목이고, 출력은 Fixed point / Standards / Spec / Verdict 보고서입니다.