01시작 전 확인
Claude Code·Codex에 입력튜터 요청
3장을 처음 시작하거나 현재 장의 시작 조건을 확인해 달라고 요청할 때
먼저 확인 · 2장의 기준 자료·보고서·Test가 정상인 상태입니다. 이미 확인된 장·프로젝트는 다시 묻지 않고 현재 기록과 실제 상태를 대조합니다.
3장 시작해.문제가 생기면, 고치기 전에 원인부터 찾습니다
의도적으로 만든 오류를 재현하고 근거로 원인을 찾아 고칩니다.
이어갈 프로젝트 · movie-report
2장의 기준 자료·보고서·Test가 정상인 상태입니다.
이번 장의 준비와 서비스
필요한 도구 · Python · 기존 Test
이미 준비한 계정과 기능은 그대로 이어갑니다.
의도적 오류를 관찰 전에 고치거나 기준 자료·TOP 20 상세·Test를 바꾸지 않습니다.
순서대로 입력하는 커맨드
현재 단계와 입력 위치를 확인한 뒤 하나씩 복사하세요.
02정상 보고서에 오류 하나를 만듭니다
Claude Code·Codex에 입력실습
정상 보고서에 의도적 합계 오류를 넣는 학습을 시작할 때
먼저 확인 · 2장의 기준 자료·상세 데이터·기존 Test와 정상 실행 결과를 확인합니다. 이미 오류를 관찰한 상태라면 다시 만들지 않습니다.
문제 해결 연습을 위해 의도적인 오류 하나를 만들어줘.
작업 당시 보존한 KOBIS 기준 자료와
TOP 20 영화별 상세 데이터, 기존 Test는 바꾸지 마.
보고서의 TOP 20 총 관객수 계산에서
20위 영화 한 편만 빠지게 해줘.
오류를 만든 뒤 기존 Test를 모두 실행하고 멈춰줘.03같은 실패인지 다시 확인합니다
Claude Code·Codex에 입력실습
의도적 합계 실패를 같은 조건에서 재현할 때
먼저 확인 · 앞 단계에서 실패한 Test와 입력을 확인합니다. 아직 코드나 기준 자료를 고치지 않았는지 확인합니다.
아직 아무것도 수정하지 말고,
실패한 같은 Test를 다시 실행해줘.
같은 문제가 다시 나타나는지 결과만 알려줘.04보존한 기준 자료부터 차례로 비교합니다
Claude Code·Codex에 입력실습
같은 실패를 확인한 뒤 처음 값이 달라지는 위치를 찾을 때
먼저 확인 · 재현한 실패와 source/kobis-2024-source.xlsx·movie-report-2024.xlsx를 확인합니다.
아직 수정하지 마.
아래 순서로 바로 앞 단계와 값을 비교해줘.
1. source/kobis-2024-source.xlsx에 보존한 기준 자료
2. movie-report-2024.xlsx의 영화별 TOP 20 상세 데이터
3. 같은 보고서의 요약 총 관객수
어디까지 같고 처음 어디에서 달라지는지
코드 대신 사람이 이해할 수 있는 결과로 설명해줘.05사실과 추측을 나눕니다
Claude Code·Codex에 입력실습
최초 차이를 찾은 뒤 사실과 추측을 나누고 원인을 확인할 때
먼저 확인 · 앞 단계의 실제 값 비교 결과를 확인합니다. 20위 누락이라는 예상만으로 원인을 확정하지 않습니다.
지금까지 확인된 사실과 아직 추측인 내용을 나눠 보여줘.
그다음 실제 값과 요약의 계산 범위를 증거로
문제가 생긴 가장 근본적인 원인을 확인해줘.
코드는 보여주지 말고, 아직 수정하지 마.06확인된 원인만 고치고 전체 Test를 다시 실행합니다
Claude Code·Codex에 입력실습
요약 총 관객수의 계산 범위가 원인으로 확인된 뒤 고칠 때
먼저 확인 · 근본 원인 확인 결과와 보존할 기준 자료·상세 데이터·기존 Test를 확인합니다.
확인된 원인에 필요한 부분만 고쳐줘.
요약 총 관객수 계산에 20위 영화가 포함되게 하고,
작업 당시 보존한 기준 자료와 TOP 20 상세 데이터,
기존 Test와 다른 계산은 바꾸지 마.
먼저 실패했던 같은 Test를 다시 실행하고,
그다음 기존 Test 전체도 다시 실행해 결과를 알려줘.07이 장을 마쳤는지 확인합니다
Claude Code·Codex에 입력튜터 요청
3장의 실습 결과를 장별 완료 조건과 대조할 때
먼저 확인 · 앞 단계 실행 결과와 사람이 직접 확인할 항목을 확인합니다. 요청문을 보여주거나 실행했다고 완료로 세지 않습니다.
장 완료 확인해줘.이 장에서 막혔을 때
디버깅 → 내 정상 기록으로 복구 → 장별 Source로 재시작Git 명령을 외우거나 직접 입력할 필요는 없습니다. 아래 요청문을 그대로 붙여넣으면 Claude Code가 확인하고 처리합니다.
1. 디버깅 — 먼저 무엇이 어긋났는지 그대로 말하고 고쳐봅니다. 대부분 여기서 해결됩니다.
지금 작업이 책과 다르게 진행됐어.
현재 상태와 화면에 나온 문제를 확인하고 원인을 찾아서 고쳐줘.이 장에서 특히 자주 막히는 자리는 연습용 오류가 의도한 곳보다 넓게 들어간 경우입니다.
연습용 오류가 요약 총 관객수 계산 말고 다른 곳까지 바뀐 것 같아.
보존한 기준 자료와 TOP 20 상세 데이터, 기존 Test가
그대로인지 확인하고 어긋난 곳만 되돌려줘.2. 내 정상 기록으로 복구 — 해결되지 않으면 실습하면서 내 프로젝트에 남겨둔 정상 기록으로 돌아갑니다. 지금까지 한 작업은 먼저 따로 보존합니다.
현재 작업은 잃지 않도록 먼저 별도로 보존해줘.
이 프로젝트에서 마지막으로 정상 동작했던 상태를 찾아 안전하게 복구해줘.3. 장별 Source로 재시작 — 그래도 이어갈 수 없을 때 사용합니다. 3장의 남은 실습은 건너뛰게 되므로 마지막 수단입니다.
내 현재 작업을 먼저 안전하게 보존해줘.
아래 3장 완성 Source에서 다시 시작해줘.
https://github.com/buildyourownai-lab/develop-like-a-pro-with-ai/tree/main/chapters/ch03/source/movie-report
준비가 끝나면 3장을 마친 상태인지 확인해줘.방향부터 확인하고, 더 필요할 때 다음 힌트를 펼치세요.
실패가 나왔음
1단계 — 방향
지금이 오류를 만드는 단계인지 확인하세요.
2단계 — 범위
합계 검사와 상세 데이터 검사 중 무엇이 실패했는지 나눕니다.
3단계 — 위치·원인 후보
기준 자료→상세 데이터→요약 계산에서 처음 달라진 자리를 찾습니다.
정답을 요청했을 때
요약 계산에서 20위를 제외한 부분을 확인한 뒤, 수정 요청이 있으면 포함 범위를 바로잡고 동일 Test를 다시 실행합니다.
검증 주의
이 설명만으로 원인이 확인됐거나 수정됐다고 말하지 않습니다. 현재 프로젝트의 근거를 먼저 대조합니다.
고쳐도 다시 실패함
1단계 — 방향
해결했다고 한 설명보다 같은 입력의 결과를 봅니다.
2단계 — 범위
변경한 코드와 실행한 코드가 같은 파일인지 확인합니다.
3단계 — 위치·원인 후보
오래된 Excel을 보고 있는지 생성 시각과 실행 경로를 대조합니다.
정답을 요청했을 때
실행 경로를 맞춘 뒤 보고서를 다시 생성하고 기존 기준으로 검사합니다. 기준값을 바꿔 통과시키지 않습니다.
검증 주의
이 설명만으로 원인이 확인됐거나 수정됐다고 말하지 않습니다. 현재 프로젝트의 근거를 먼저 대조합니다.
이번 장의 완료 체크리스트
- 원본 보호기준 자료·상세·Test를 보존
- 의도적 실패20위 누락에 따른 합계 검사 실패를 확인
- 재현동일 입력에서 같은 실패인지 확인
- 원인 추적최초 값 차이와 원인을 증거로 구분
- 최소 수정확인된 원인 부분만 고침
- 회귀 검사실패했던 검사와 기존 검사 다시 통과
장 완료 확인해줘.실제 프로젝트에서 튜터와 확인합니다. 사이트를 열어본 기록은 학습 완료가 아닙니다.
장별 소스와 저자 검증 기록
저자는 빈 폴더에서 1·2장을 다시 만든 뒤 3장을 이어서 2회 돌렸습니다. 두 번 모두 합계 검사가 실패했고, 최초로 값이 달라지는 지점이 상세 데이터에서 요약으로 넘어가는 곳이었으며, 두 합계의 차이가 20위 영화 한 편의 관객수와 정확히 같았습니다. 한 줄만 고친 뒤 두 번 모두 기존 검사가 전부 통과했습니다. 근거는 verification/chapter-03/에 있습니다.
장별 소스는 해당 장까지의 기준 상태입니다. 정상 실습은 내 프로젝트를 이어가고, 완성 소스는 비교·복구할 때 사용합니다.
자료 판본 1c784213이 장의 개발 용어
- Test
- 정한 완료 조건을 반복 확인하는 검사. 검사하지 않은 전체 정확성을 보증하지 않습니다.