DUJINLABS · AI workflow

AI 코드 검토: 응답 종료·커밋·게시의 완료 기준

AI의 완료 선언과 실제 동작을 분리하고, 실패를 검출하는 검사부터 공개 반영까지 연결합니다.

요구사항: 입력과 기대 결과 / 재현 검사: 잘못된 결과 검출 / 수정 검토: 권한·실패 상태 / 공개 확인: 리비전과 실제 URL
앞 단계를 통과했다고 해서 다음 단계의 검증을 건너뛸 수 있는 것은 아닙니다. 설명용 관계도이며 실제 실행 결과가 아닙니다.

요청을 관찰 가능한 결과로 바꿉니다

“예약이 된다”보다 “같은 시간에 두 요청이 와도 예약은 하나만 확정된다”가 검사하기 쉽습니다. 입력, 허용 결과, 거부 결과, 변경하지 않을 범위를 먼저 적습니다. AI가 코드를 수정했다고 해서 요구사항이 충족된 것은 아닙니다.

변경 전 재현 사례가 실패하는지 확인하고 수정 후 같은 사례를 다시 실행합니다. 기존 기능 검사도 함께 돌립니다. 격리된 검사 환경에서만 되돌릴 수 있는 작은 오류를 넣어 검사가 실제로 실패하는지 볼 수 있습니다. 실제 사용자 데이터나 운영 서비스에 오류를 넣는 방법은 아닙니다.

검사 통과도 잘못 정한 정답을 바로잡지는 못합니다. 숫자·단위·권한·실패 상태가 요구사항과 맞는지는 사람이 사례와 함께 검토해야 합니다.

서로 다른 세 단계를 구분합니다

단계검사하는 순간이것만으로 확인되지 않는 것
응답 종료 훅에이전트가 답변을 마치려 할 때사용자 중단·API 오류·다른 경로의 실행
Git pre-commit로컬 커밋 직전원격 병합·배포 전체의 차단
원격 필수 검사보호 규칙이 적용된 변경의 반영 전검사에 없는 결함과 설정상 예외

Claude Code의 Stop은 정상 응답 종료 때 실행되며 사용자 중단에서는 실행되지 않습니다. API 오류는 별도 StopFailure 이벤트입니다. PreToolUse의 차단과도 다릅니다. 명령 훅의 종료 코드 2는 이를 지원하는 이벤트에서 차단하지만, 일반 실패를 모두 같은 차단으로 해석하면 안 됩니다. onFailure: block은 v2.1.295 이상에서 지원되는 이벤트에 적용되며 Stop 계열에는 같은 방식으로 적용되지 않습니다. 공식 훅의 이벤트별 계약

Git pre-commit은 0 아닌 종료 코드로 커밋을 막을 수 있지만 --no-verify로 건너뛸 수 있습니다. 따라서 운영 반영 조건은 별도로 설계합니다. GitHub 필수 상태 검사를 사용할 때도 관리자·예외 권한과 실제 적용 브랜치를 확인해야 합니다. 이 글은 어떤 저장소의 설정을 변경하거나 보호가 활성화됐다고 확인한 기록이 아닙니다. Git 훅 · GitHub 보호 브랜치

리뷰 결과는 구체적인 실패 사례로 연결합니다

정확성·보안·성능·가독성 관점을 나누더라도 동의한 리뷰어 수로 합격을 정하지 않습니다. 각 지적에는 파일 위치, 문제가 생기는 입력·상태, 영향, 재현 또는 확인 방법이 필요합니다. SQL 문자열 조합이 의심된다면 실제 입력에서 쿼리 생성까지 흐름을 따라가고, 매개변수 바인딩과 권한 조건을 확인합니다.

한 줄짜리 PR에도 검토자가 같은 결과를 얻을 수 있도록 준비 상태, 실행 동작, 기대 결과를 적습니다. 예를 들어 재시도 중복 방지를 바꿨다면 격리된 테스트에서 첫 저장을 성공시킨 뒤 완료 응답 직전에 실패를 주입합니다. 같은 이벤트 ID로 재시도하고 최종 저장 건수가 한 건인지 확인합니다. 검토자가 실행할 명령과 조회할 필드도 남깁니다.

Claude Code의 /code-review 같은 명령도 실제 비교 범위와 발견 내용을 읽어야 합니다. 정리용 /simplify와 결함 검토를 같은 것으로 취급하지 않습니다. 도구 이름에 보안 검토가 들어 있다고 전체 시스템의 안전이 증명되지는 않습니다. 명령별 현재 범위

커뮤니티 gstack의 careful은 해당 명령 패턴을 발견하면 경고하고 사용자의 진행·취소 선택을 요청합니다. 모든 파괴적 동작을 무조건 막는 장치라고 소개하지 않습니다. 패턴 검사에 걸리지 않았다고 해서 수정 결과가 검증된 것은 아니며, 공개 이슈의 제안을 구현된 기능처럼 소개하지도 않습니다. careful 원문

완료 기록에는 결과와 한계를 함께 남깁니다

  1. 기준 리비전과 실제 변경 파일을 기록하고 각 변경을 요청과 연결합니다.
  2. 검사 이름·조건·결과와 미실행 항목을 나눕니다. 종료 코드만 아니라 무엇을 검사했는지도 봅니다.
  3. 화면 기능은 정상·오류·빈 상태와 좁은 화면에서 확인합니다. 버튼이 눌렸다고 해서 예약·가입 데이터가 저장된 것은 아닙니다.
  4. 게시 대상 리비전, 배포 결과, 실제 URL의 내용이 일치하는지 확인합니다. 로컬 검사와 공개 확인을 따로 기록합니다.

화면 수정 요청에는 대상 요소의 이름이나 선택자, 화면 폭, 재현 순서, 기대 결과를 함께 남깁니다. 작업 기록이 있다면 관련 변경을 찾는 데 활용합니다. 수정은 Git diff에서 확인하고, 같은 조건에서 동작을 다시 검증합니다. 예를 들어 좁은 화면에서 모바일 메뉴가 닫히지 않는 경우라면, 화면 폭과 메뉴를 열고 닫는 순서를 기록한 뒤 수정 후 같은 폭과 순서에서 메뉴가 닫히는지 확인합니다.

이 글은 검증 절차를 설명합니다. 특정 제작자의 무사고 횟수, “99%” 효과, 계획에 쓰는 시간 비율을 실측 성과로 인용하지 않습니다. 예시는 설명용이며 여기서 결제·보안 공격·원격 보호 설정 시험을 실행한 것은 아닙니다.

자료 범위

2026년 10월 29일 공식 문서와 저장된 원고를 대조했습니다. 기능의 제공 조건은 버전·계정·환경에 따라 달라집니다. 본문의 예시와 확인 절차는 실제로 실행하거나 성능을 측정한 결과가 아닙니다.

AI 분야의 다른 글 · 웹개발 글