Claude Code가 작업을 마쳤고 요약에는 기능이 완성되었다고 적혀 있습니다. 다음 요청을 하기 전에 실제 동작이 어떻게 바뀌었는지 이해하고 싶다면, Yenpo에서 같은 로컬 프로젝트를 열고 diff부터 읽어 보세요.

로컬 Git 저장소와 macOS용 Yenpo가 필요합니다. 코드와 diff를 읽는 데 모델 연결은 필요하지 않습니다. AI Reader의 도움을 받을 때만 연결하면 됩니다.

1. 이번 작업에 속한 변경을 구분하기

작업 전에 Claude Code가 수정할 디렉터리에서 읽기 전용 명령을 실행합니다.

git rev-parse --show-toplevel
git rev-parse HEAD
git status --short

시작 커밋 ID와 기존 수정 및 추적되지 않는 파일을 기록합니다. 시작 상태가 깨끗하면 이후 diff의 출처를 구분하기 쉽습니다. 진행 중인 작업은 보존하고 평소 검토 도구로 시작 시점의 내용까지 남기세요. 파일 목록만으로는 같은 파일에 겹친 수정을 분리할 수 없습니다.

Claude Code의 파일 쓰기가 끝나면 다시 실행합니다. 브랜치뿐 아니라 디렉터리도 확인하세요. 별도 worktree를 썼다면 Yenpo에서도 그 디렉터리를 열어야 합니다.

종료 상태 검토할 대상
새 커밋이 없고 시작 상태가 깨끗했음 시작 커밋 대비 로컬 변경
새 커밋이 있음 시작 커밋 → 마지막 커밋, 이후 남은 로컬 변경
시작 전부터 변경이 있었음 기록한 시작 내용과 비교한 뒤 Claude Code의 변경을 구분

Yenpo는 Git 상태를 읽습니다. Claude Code 대화의 각 차례를 자동으로 복원하지는 않습니다. 수정된 시작 상태를 기록하지 않았다면 범위를 “이번 변경만”이 아닌 “현재 변경”으로 다루세요.

2. Yenpo에서 로컬 diff 읽기

프로젝트 폴더를 열고 사이드바의 더하기/빼기 모양 “변경 사항” 버튼을 누릅니다. “로컬 변경 사항”는 HEAD 대비 현재 변경을 집계합니다. 파일을 선택하면 인라인 diff를 볼 수 있습니다.

요청한 동작을 구현하는 파일부터 호출자와 테스트 순으로 읽습니다. 새 테스트와 설정 파일도 빠뜨리지 마세요. 집계에는 Yenpo에서 저장하지 않은 텍스트가 포함될 수 있습니다. 명령줄 Git과 비교하거나 테스트하기 전에 유지할 편집 내용을 저장합니다.

커밋이 생겼다면 “버전 비교…”의 “커밋” 모드에서 각 관련 커밋과 첫 번째 부모의 차이를 읽습니다. 이후 “변경 사항”에서 미커밋 내용을 확인합니다. 한 차례 작업의 순변경은 아래 자리표시자를 기록한 시작·종료 ID로 바꾸고 읽기 전용 명령을 실행해 확인하세요. Yenpo의 “비교” 모드는 브랜치를 선택합니다. 버전 선택 안내도 참고하세요.

git diff START_COMMIT END_COMMIT --

3. 변경된 줄 너머로 동작 추적하기

검색어를 바꾼 뒤 이전 결과가 나타나는 문제를 수정했다고 가정해 봅시다. 수정된 함수에서 시작해 호출자와 화면 결과를 갱신하는 지점까지 읽습니다.

  1. 무엇이 요청을 시작하며 어떤 값이 현재 검색어를 구분하나요?
  2. 첫 요청이 두 번째 요청보다 늦게 끝나면 어떻게 되나요?
  3. 테스트가 완료 순서를 제어하나요, 아니면 함수를 두 번 호출하기만 하나요?

파일 검색을 쓰고, 언어 서버가 있다면 정의 및 참조 이동도 사용하세요. 탭이 diff와 같은 버전인지 확인해야 합니다. 현재 파일은 비교 중인 커밋과 다를 수 있습니다.

4. AI Reader에 범위가 분명한 질문하기

모델 연결 후 로컬 변경 헤더의 “AI에 모든 변경 사항 검토 요청”를 누르면 초안이 준비됩니다. 커밋 비교에는 “AI에 이 비교 검토 요청”를 사용하고 비교 첨부를 유지합니다.

보내기 전에 질문을 다듬습니다.

검색 결과 처리의 변경을 설명해 주세요. 호출자부터 화면 갱신까지 추적하고 이전 요청이 마지막에 끝나는 경우를 확인해 주세요. 각 판단에 코드 참조를 붙이고 기존 동작과 새 동작을 구분하며, 이 완료 순서를 실제로 다루는 테스트를 알려 주세요. 검토만 하고 파일은 수정하지 마세요.

편집 권한은 끈 상태로 둡니다. 답변의 참조를 눌러 코드를 확인하고, 조건이나 호출자가 필요하면 전체 파일을 여세요. 참조 검증 가이드에 예제가 있습니다.

5. Claude Code가 실행할 수 있는 피드백 쓰기

후속 요청에는 발생 조건과 기대 결과를 넣습니다.

검색 A가 B보다 먼저 시작하고 늦게 끝나면 A가 B의 결과를 덮어쓸 수 있습니다. 결과 대입 경로를 확인하고 B를 먼저 완료시키는 테스트를 추가해 주세요. 단일 요청이 성공할 때의 기존 동작은 유지해 주세요.

자신의 코드에서 문제를 확인한 뒤 사용하세요. “더 안전하게” 같은 요청 대신 필요한 동작을 구체적으로 적습니다. 수정 후 관련 diff를 다시 읽고 프로젝트 테스트를 실행한 뒤, 실행한 명령과 결과를 기록하세요.

6. 짧은 검토 기록 남기기

시작·종료 커밋 ID, 읽은 파일, 동작 변화 한 문장, 남은 질문을 기록합니다. 미커밋 파일을 포함했는지와 실제 실행한 검사도 남기면 다음 작업의 기준이 됩니다.

작업이 브랜치로 정리되었다면 main과 브랜치 비교하기로 이어갈 수 있습니다. Claude Code가 만든 브랜치에도 같은 Git 절차를 적용합니다.