사람이 판단할 결과 검토하기 | Human Review

Overview

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

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

학습 목표

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

자동 검증 뒤에는 무엇이 남을까?

Lesson 3에서는 테스트와 빌드, 자동 코드 리뷰로 Feedme가 Spec을 충족하는지 확인했습니다.

human-review는 이 검증을 사람이 반복하는 단계가 아닙니다. 실제 결과와 검증 근거를 한곳에 모아 보여줍니다.

Feedme가 Spec대로 동작하고 브라우저 확인까지 끝났다면 다시 질문하지 않습니다. 검토 화면에 결과와 근거만 보여주면 됩니다.

구현 중 합의하지 않은 문제가 발견됐다면 사람의 판단이 필요합니다. 예를 들어 외부 서비스의 제약 때문에 합의한 사용 방식이나 개인정보 처리를 바꿔야 하는 경우입니다.

확인된 결함은 질문하지 않고 수정합니다. 결과를 바꾸는 미확정 선택만 사람에게 묻습니다. 이런 선택이 없다면 질문이 0개인 것도 정상입니다.

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

구현과 검증이 끝난 feedme-clone 저장소에서 다음과 같이 실행합니다.

/human-review

human-review는 spec.md, 변경 코드, 실제 실행 결과와 검증 근거를 확인합니다. 그런 다음 임시 검토 화면에 다음 내용을 모읍니다.

• 사용자가 실제로 보거나 조작할 결과
• 결과를 만든 변경의 요약
• 테스트, 빌드와 브라우저 확인처럼 다시 확인할 수 있는 근거
• 사람이 답해야 할 중요한 질문 최대 세 개

이미 정한 내용은 실제 결과로 보여주고 다시 묻지 않습니다. 확인된 결함은 승인 대상이 아니라 수정 대상입니다. 사람에게는 결과를 바꿀 미확정 선택이나 명시적인 위험 수용만 묻습니다.

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

[미션] Feedme 결과 검토하기

Lesson 3에서 구현과 검증을 마친 feedme-clone 저장소를 사용합니다.

Step 1: 검토 화면 만들기

Claude Code에서 다음 명령을 실행합니다.

/human-review

생성된 임시 검토 화면에서 Feedme의 실제 결과, 변경 요약과 검증 근거를 확인합니다.

Step 2: 수정할 내용 전달하기

수정할 점이 있다면 검토 화면에서 바로 답합니다. AI가 수정과 검증을 이어갑니다. 수정할 점이 없다면 검토를 마칩니다.

핵심 포인트 정리

1. 검증된 동작: 테스트와 빌드로 확인한 내용은 다시 질문하지 않고 근거로 보여줍니다.
2. 사람의 판단: 결과를 바꾸는 미확정 선택만 질문하고, 수정할 점은 검토 화면에서 바로 전달합니다.

이어서 배울 내용

검토를 통과한 Feedme는 로컬에서 의도한 결과를 만들고 있습니다. 다음 Lesson에서는 변경을 배포하고, 실제 배포 URL에서도 URL 입력부터 결과 내보내기까지 동작하는지 확인합니다.