본문으로 건너뛰기
· workflow · 2분 읽기

AI 코드 리뷰에서 역할과 검증 근거를 나누는 방법

AI 리뷰 결과가 길어도 바로 수정할 수 없는 경우가 있다. “동시성 문제가 있을 수 있다”는 말만 있고 어떤 요청 순서에서 어떤 값이 틀리는지 없으면 다시 분석해야 한다.

리뷰를 맡길 때 역할뿐 아니라 관찰 범위와 결과 형식을 정한다. 코드 구조를 보는 리뷰와 업무 흐름을 보는 리뷰는 같은 diff를 읽어도 확인할 질문이 다르다.

먼저 변경 범위를 고정한다

리뷰 대상은 브랜치 이름만으로 식별하지 않는다. 기준 커밋과 대상 커밋, 변경 파일, 생성 파일 여부, 관련 계약을 기록한다. 리뷰 도중 코드가 바뀌면 근거가 어느 버전에 대한 것인지 분리한다.

yaml
base: BASE_COMMIT
head: HEAD_COMMIT
scope:
  - 주문 생성과 취소의 상태 전이
  - 변경된 gRPC 계약의 소비자
excluded:
  - 코드 포맷
  - 변경 없는 관리자 화면

예제의 커밋 값은 자리표시자다. 실제 리뷰에서는 고정된 SHA를 쓴다. 제외한 범위는 안전하다고 판정한 범위가 아니라 이번에 보지 않은 범위다.

코드 리뷰와 흐름 리뷰의 질문

코드 리뷰는 자원 수명, 오류 전파, 데이터 경합, 입력 검증, 함수 계약을 본다. 흐름 리뷰는 요청이 재시도되거나 순서가 바뀌어도 업무 결과가 유지되는지 본다.

역할같은 변경에 대한 질문
코드 리뷰트랜잭션 오류를 반환하는가? rows를 닫는가?
업무 흐름 리뷰승인 후 저장 실패 시 다음 요청은 무엇을 하는가?
검증 담당위 실패 조건을 테스트가 실제로 실행하는가?

역할을 나눴다고 반드시 여러 에이전트를 동시에 실행할 필요는 없다. 하나의 리뷰에서도 체크 단계를 분리할 수 있다. 병렬로 진행할 때는 서로의 결론을 먼저 복사하기보다 독립적인 근거를 확보한 뒤 중복을 합친다.

지적 하나에 필요한 정보

증상: 재시도 요청이 이미 처리한 수량을 다시 차감할 수 있음
조건: DB 커밋 후 응답 전 연결 종료 → 같은 요청 재전송
위치: 요청키 저장과 수량 변경이 분리된 구간
근거: 요청키 기록이 실패해도 수량 커밋은 유지됨
영향: 재고 중복 차감
검증: 재현 테스트 미실행, 트랜잭션 경계는 코드에서 확인

이것은 가상의 지적 예시다. 확정 버그처럼 보이게 쓰려면 실제 해당 코드와 재현 증거가 필요하다. 원인이 추정이라면 관찰한 사실과 추정을 같은 문장으로 합치지 않는다.

심각도는 문장의 강도가 아니라 영향 범위와 발생 조건으로 정한다. 모든 예외 경로를 최상위 장애로 분류하면 실제 우선순위를 고르기 어려워진다.

테스트 근거를 별도로 남긴다

“테스트 통과”에는 명령, 대상 커밋, 환경, 관찰 결과가 필요하다. 테스트 이름만 적으면 존재를 확인한 것인지 실제 실행한 것인지 구분되지 않는다.

command: go test ./internal/orders -run TestRetryAfterCommit -count=1
revision: HEAD_COMMIT
environment: 고정된 Go 및 PostgreSQL 버전
result: 실행 후 기록
coverage: 커밋 후 응답 유실 경로
not covered: 외부 제공자의 멱등키 만료

테스트 결과를 적기 전에 테스트가 문제 조건을 만드는지도 읽는다. mock이 항상 성공하거나 경합이 일어나기 전에 goroutine이 끝나면 초록색 결과의 의미가 다르다.

리뷰 의견을 처리하는 상태

지적은 수용·반려뿐 아니라 미확인 상태도 필요하다. 수용한 지적은 수정 커밋과 재검증을 연결한다. 반려는 “괜찮음” 대신 조건이 불가능한 이유나 이미 있는 방어를 적는다.

검증 환경이 없어 못 본 항목을 반려로 닫으면 근거 없는 안전 판정이 된다. 미확인 항목은 필요한 입력과 실행 환경을 남기고, 배포 판단에 영향을 주는지 구분한다.

리뷰 후 코드가 바뀌면 영향을 받는 지적과 테스트를 다시 확인한다. 사소한 문구 수정과 트랜잭션 경계 변경에 같은 재리뷰 비용을 쓰지는 않는다.

리뷰 평가 항목

리뷰 시간과 결함 탐지율은 측정하지 않았다. 평가 입력에는 결함을 주입한 합성 diff와 정상 diff를 함께 포함한다.

측정할 항목은 유효 지적 수, 오탐 수, 재현 가능한 지적 비율, 수정 후 회귀 여부다. 코드 리뷰와 흐름 리뷰가 같은 지적을 반복하는지, 한쪽만 찾는 결함이 있는지도 구분한다.

리뷰 기록에는 확인한 범위, 유효 지적, 실행한 검증, 미확인 항목을 남긴다.

공유하기 X LinkedIn

관련 글