Claude Code Human Review

자동 검증이 증명한 범위와 사람이 직접 판단할 문제를 구분하고, 실제 결과를 검토해 필요한 수정을 요청합니다

Overview

테스트와 빌드가 모두 통과해도 화면의 정보 배치가 의도에 맞는지, 중요한 위험을 받아들일 수 있는지까지 자동으로 결정할 수는 없습니다. 그렇다고 사람이 AI가 만든 코드를 처음부터 끝까지 다시 읽는다면 자동화의 이점이 줄어듭니다.

이번 Lesson에서는 human-review로 실제 결과와 검증 근거를 확인하고, 자동으로 판정할 수 없는 문제만 직접 판단합니다.

학습 목표

자동 검증이 증명한 범위와 사람이 직접 판단해야 할 문제를 구분합니다.
실제 결과와 검증 근거를 확인하고 필요한 수정을 요청합니다.

자동 검증 뒤에 사람이 확인할 것

Lesson 3에서는 테스트와 빌드, 실행한 서비스의 실제 동작과 자동 코드 리뷰로 Feedme가 Spec의 완료 기준을 충족하는지 확인했습니다. 사람은 이 검증을 처음부터 반복할 필요가 없습니다.

사람의 주의는 자동으로 판정할 수 없는 곳에만 씁니다. 실제 결과가 의도한 모습과 사용 흐름으로 완성됐는지, 함께 제시된 근거가 그 결과를 충분히 뒷받침하는지 보는 일입니다.

`human-review`: 판단할 결과만 보여주기

human-review는 spec.md, 변경 코드, 실제 실행 결과와 검증 근거를 확인한 뒤 다음 내용을 담은 임시 검토 화면을 만듭니다.

사용자가 직접 보고 눌러볼 수 있는 완성된 결과
그 결과를 만들려고 무엇을 바꿨는지 정리한 요약
테스트와 빌드 결과, 브라우저에서 확인한 기록처럼 의심스러울 때 직접 열어볼 수 있는 근거
사람이 답해야 할 질문

이 Skill이 하는 일은 무엇을 물어볼지 고르는 것입니다. Spec에서 이미 정한 내용은 결과로 보여주기만 하고 다시 묻지 않습니다. 이미 드러난 결함도 승인받을 일이 아니라 고칠 일입니다. 물어보는 것은 두 가지뿐입니다. Spec에 없던 선택인데 구현하면서 결과를 크게 바꾼 것, 그리고 사람이 알고 받아들여야 할 위험입니다.

수정할 점이 있다면 검토 화면에서 바로 답합니다. AI는 그 내용을 구현과 검증으로 이어갑니다.