1장 · 저자 검증 기록
확인 목록 7/7 · 서로 독립된 빈 폴더에서 3회 실행 · 3회 모두 통과 KOBIS 공식통계 20편 대조 일치 · 최종 확인 2026-08-29
실제로 만들어봤습니다
책에 인쇄된 요청문만으로 보고서를 완성할 수 있는지 확인했습니다.
- 요청문은 책 1장에 나오는 문장을 글자까지 그대로 썼습니다.
- 빈 폴더에서 시작했습니다. 데이터도 코드도 미리 넣지 않았습니다.
- 책에 없는 추가 지시를 보태지 않았습니다.
- 서로 독립된 빈 폴더 3개에서 각각 새 세션으로 돌렸습니다.
1장의 완료 기준은 책이 「눈으로 확인합니다」라고 적은 확인 목록 7개입니다. 세 실행 모두 7개 전부 통과했습니다.
| 확인 항목 | 실행 3회 | |
|---|---|---|
| 1 | movie-report-2024.xlsx 파일이 실제로 생겼다 | 통과 |
| 2 | 파일이 정상적으로 열린다 | 통과 |
| 3 | 영화 TOP 20이 보인다 | 통과 |
| 4 | 관객수와 매출액이 보인다 | 통과 |
| 5 | 핵심 요약이 있다 | 통과 |
| 6 | 실제 데이터를 이용한 차트가 있다 | 통과 |
| 7 | KOBIS 출처와 조회 기준 연도, 다시 찾을 수 있는 정보가 있다 | 통과 |
5번은 요약에 적힌 합계를 상세 표 20행의 합계와 직접 계산해 비교했습니다. 칸이 있는지만 본 것이 아닙니다. 6번은 차트가 실제 셀을 참조하는지 확인했습니다. 그림처럼 보이기만 해서는 통과하지 않습니다.
검사 코드는 시트 이름도 열 번호도 알지 못하고 내용으로 찾습니다. 그래서 보고서 배치가 실행마다 달라도 같은 기준으로 확인됩니다.
완성된 결과를 공개합니다
1장을 끝낸 상태의 프로젝트
chapters/ch01/source/movie-report/
| 파일 | 무엇인가 |
|---|---|
| build_movie_report.py | movie-report-2024.xlsx를 만드는 코드. 위 실행에서 Claude Code가 실제로 작성한 코드 그대로입니다 |
이 폴더만 빈 폴더에 복사해 단독으로 돌려, 보고서가 만들어지고 확인 목록 7개를 모두 통과하는 것까지 확인했습니다. 독자가 받는 코드가 그 자체로 동작합니다.
실제로 만들어진 보고서
artifacts/movie-report-2024.xlsx --- 위 실행이 만든 파일 그대로입니다. 내려받아 열어보시면 됩니다. 시트 4개입니다.
| 시트 | 내용 |
|---|---|
| TOP20 | 순위·영화명·개봉일·관객수·매출액 20행과 합계 행 |
| 차트 | 관객수·매출액 막대 차트 2개. TOP20 시트의 실제 셀을 참조합니다 |
| 요약 | 조회 조건과 핵심 요약. 각 항목에 산출 방식을 함께 적었습니다 |
| 출처 | 조회 URL·기준 연도·수집 일시·재확인 방법 |
이 파일은 위 확인 목록 7개를 통과한 그 파일이고, 아래 「공식 자료와 비교했습니다」의 숫자가 들어 있는 파일입니다.
시트 이름과 표가 시작하는 행은 3회 실행에서 모두 달랐습니다. 여러분의 보고서가 이 파일과 다르게 생겼어도 괜찮습니다. 위 확인 목록 7개가 보이면 제대로 만들어진 것입니다.
자동 검사도 해봤습니다
1장의 완료 기준은 위 확인 목록 7개입니다. 자동 검사를 독자가 직접 만드는 것은 2장이고, 그 Test 코드는 2장 Source에 있습니다.
| 항목 | 수 |
|---|---|
| 1장 Source에서 돌린 Test | 0개 |
| 1장에서 새로 추가된 Test | 0개 |
대신 저자는 두 가지 검사를 직접 돌려 확인했습니다. 아래 두 코드는 이 폴더에 그대로 공개했고, 여러분도 같은 명령으로 돌릴 수 있습니다.
| 저자가 돌린 검사 | 무엇을 확인하는가 | 결과 |
|---|---|---|
check7.py --- python3 check7.py movie-report-2024.xlsx | 확인 목록 7개를 보고서에서 실제로 찾을 수 있는가 | 3회 실행 모두 7/7 통과 |
fetch_kobis.py --- python3 fetch_kobis.py | 보고서의 20편 숫자가 공식통계와 같은가 | 20/20 일치 |
check7.py의 5번과 6번이 특히 중요합니다. 요약에 적힌 합계를 상세 20행의 합계와 다시 계산해 비교하고, 차트가 실제 셀을 참조하는지 확인합니다. 칸이 있는지만 보는 검사는 틀린 보고서도 통과시키기 때문입니다.
공식 자료와 비교했습니다
보고서가 그럴듯해 보이는 것과 숫자가 맞는 것은 다른 문제입니다. 그래서 KOBIS 공식통계에 따로 조회해 보고서와 대조했고, 3회의 실행 모두 20편의 영화명·관객수·매출액이 전부 일치했습니다.
| 항목 | 값 |
|---|---|
| 1위 파묘 | 11,913,725명 / 115,148,478,414원 |
| 20위 퓨리오사: 매드맥스 사가 | 1,605,454명 |
| TOP 20 관객수 합계 | 78,454,312명 |
| TOP 20 매출액 합계 | 756,816,908,335원 |
이 숫자는 저희 주장이 아니라 공개된 공식 기록입니다. 2026-08-29에 조회한 결과이고, 페이지에 표기된 최종 기준년월은 2026/07이었습니다.
https://www.kobis.or.kr/kobis/business/stat/offc/findYearlyBoxOfficeList.do
직접 확인해볼 수 있습니다
책의 1장을 그대로 따라 하시면 됩니다. 요청문은 chapters/ch01/prompts.md에 책에 나오는 순서대로 있습니다.
만든 보고서가 확인 목록 7개를 통과하는지는 저자가 쓴 검사 코드를 그대로 돌려 확인할 수 있습니다.
python3 check7.py <경로>/movie-report-2024.xlsx시트 이름과 열 번호를 알지 못하는 검사이므로 보고서 배치가 저자와 달라도 그대로 돌아갑니다.
숫자가 공식 기록과 같은지 확인하려면 위 KOBIS 주소에서 조회 기준 연도 2024를 선택해 나란히 놓고 비교해도 되고, Claude에게 맡겨도 됩니다.
방금 만든 movie-report-2024.xlsx의 TOP 20 관객수와 매출액이
KOBIS 공식통계 조회 기준 연도 2024 결과와 같은지 대조해줘.
다른 값이 있으면 순위와 항목을 알려줘.저자가 확인할 때 실제로 돌린 파일도 함께 공개합니다.
| 파일 | 무엇인가 |
|---|---|
| artifacts/checklist-result.json | 확인 결과와 측정 조건, 실행 환경 |
| artifacts/check7.py | 확인 목록 7개를 검사한다 |
| artifacts/fetch_kobis.py | KOBIS 공식통계를 따로 조회해 보고서와 대조한다 |
| artifacts/kobis-2024-top20.json | 대조에 사용한 조회 결과 |
이런 한계가 있습니다
- KOBIS 공식통계는 월마감으로 갱신됩니다. 위 숫자는 2026-08-29 조회 결과이므로 지금 다시 조회하면 보정된 값이 나올 수 있습니다. 숫자가 다르다면 그동안 원본이 갱신된 것입니다.
- 보고서의 시트 구성과 배치는 실행마다 달라집니다. 3회 실행에서 시트 이름, 표가 시작하는 행, 관객수·매출액 열 번호가 모두 달랐습니다. 같았던 것은 책이 지정한 파일 이름 하나였습니다. 확인 항목 7개가 보이면 정상입니다.