01시작 전 확인
Claude Code·Codex에 입력튜터 요청
2장을 처음 시작하거나 현재 장의 시작 조건을 확인해 달라고 요청할 때
먼저 확인 · 1장의 생성 코드와 열어본 Excel 보고서가 있습니다. 이미 확인된 장·프로젝트는 다시 묻지 않고 현재 기록과 실제 상태를 대조합니다.
2장 시작해.Claude가 제대로 만들었는지 확인합니다
공식 기준 자료와 보고서를 대조하고 반복 확인할 Test를 만듭니다.
이어갈 프로젝트 · movie-report
1장의 생성 코드와 열어본 Excel 보고서가 있습니다.
이번 장의 준비와 서비스
필요한 도구 · Python · 테스트 도구
이미 준비한 계정과 기능은 그대로 이어갑니다.
일부 원본 대조와 전체 원본 검증을 혼동하거나 Test 기대값을 보고서에 맞춰 바꾸지 않습니다.
순서대로 입력하는 커맨드
현재 단계와 입력 위치를 확인한 뒤 하나씩 복사하세요.
02이번에 사용한 기준 자료도 함께 남깁니다
Claude Code·Codex에 입력실습
공식 원본 일부를 직접 대조한 뒤 작업 당시 기준 자료를 남길 때
먼저 확인 · 독자가 KOBIS 공식통계에서 2024년을 선택하고 보고서의 상위·중간·마지막 순위 중 몇 편의 영화명·관객수·매출액과 출처를 직접 비교했는지 확인합니다.
이번 보고서를 만들고 확인할 때 사용한 KOBIS 데이터를
작업 당시의 기준 자료로 프로젝트 안에 보관해줘.
파일 이름은 source/kobis-2024-source.xlsx로 해줘.
출처와 조회 기준 연도 같은 기준 정보도 함께 남겨줘.03반복 확인은 자동 검사에 맡깁니다
Claude Code·Codex에 입력실습
보관한 기준 자료와 보고서의 완료 조건을 자동 검사로 만들 때
먼저 확인 · 보고서와 기준 자료가 있고 TOP 20·필수값·출처·연도·합계라는 비교 조건을 확인했는지 봅니다.
movie-report-2024.xlsx가 다음 조건을 만족하는지
다음에도 반복해서 확인할 수 있게 자동 검사를 만들어줘.
- TOP 20이 빠짐없이 있어야 해
- 순위는 1위부터 20위까지 있어야 해
- 영화명이 빠지면 안 돼
- 모든 영화에 관객수와 매출액이 있어야 해
- TOP 20의 영화명, 관객수, 매출액이
보관한 source/kobis-2024-source.xlsx와 같아야 해
- 조회 기준 연도 2024와 KOBIS 출처가 남아 있어야 해
- 영화별 관객수를 모두 더한 값과
요약에 적힌 총 관객수가 같아야 해
필요한 검사 파일은 tests 폴더 아래에 관리하고,
결과는 처음 보는 사람도 이해할 수 있게 설명해줘.
모든 검사를 실행한 뒤 결과를 알려줘.
하나라도 실패하면 완료했다고 말하지 말아줘.04같은 Test는 다음부터 바로 실행하게 합니다
Claude Code·Codex에 입력실습
만든 영화 보고서 Test를 다시 실행하고 반복 실행 허용 범위를 익힐 때
먼저 확인 · 기존 Test의 첫 실행 결과를 확인합니다. 승인 화면이 나오면 명령의 대상과 범위를 살피고 필요하면 Ctrl+E로 설명을 읽습니다.
방금 만든 영화 보고서 Test를
다시 실행하고 결과를 알려줘.05반복할 작업은 미리 정해둘 수도 있습니다
도구 자체 명령실습
실제로 적용된 권한 규칙을 입력창에서 직접 열어볼 때
먼저 확인 · 이 블록은 자연어 작업 요청이 아닌 Claude Code의 /permissions 슬래시 명령입니다. 독자가 Code 입력창에 정본을 직접 입력하게 안내하고 진행해를 셸 실행이나 권한 변경으로 바꾸지 않습니다.
/permissions6. 반복할 작업은 미리 정해둘 수도 있습니다 선택·문제 발생 시
Claude Code·Codex에 입력선택·문제 발생 시
독자가 반복 작업의 권한 분류 제안을 보고 싶을 때
먼저 확인 · 현재 프로젝트에서 실제 해본 반복 작업과 /permissions의 허용 범위를 확인합니다. 권한 설정은 사람이 판단합니다.
앞으로 이 프로젝트에서 반복할 작업을 살펴보고,
바로 실행해도 될 저위험 반복 작업과
계속 나에게 확인해야 할 작업을 나눠서 제안해줘.
아직 권한은 바꾸지 마.
왜 그렇게 나눴는지도 쉽게 설명해줘.07큰 변경은 실행하기 전에 계획부터 봅니다
Claude Code·Codex에 입력실습
큰 변경을 실행하지 않고 계획만 보는 연습을 할 때
먼저 확인 · 독자가 입력창에서 Plan mode로 바꿨는지 확인합니다. 이번 장은 요약본·상세본 분리를 실제 구현하는 단계가 아닙니다.
이 보고서를 경영진이 볼 요약본과
분석가가 볼 상세본으로 나누는
큰 변경을 검토하고 있어.
Plan mode에서 아직 파일은 수정하지 말고,
영향받는 파일과 작업 순서, 확인할 Test,
위험 요소를 먼저 계획으로 보여줘.08이 장을 마쳤는지 확인합니다
Claude Code·Codex에 입력튜터 요청
2장의 실습 결과를 장별 완료 조건과 대조할 때
먼저 확인 · 앞 단계 실행 결과와 사람이 직접 확인할 항목을 확인합니다. 요청문을 보여주거나 실행했다고 완료로 세지 않습니다.
장 완료 확인해줘.이 장에서 막혔을 때
디버깅 → 내 정상 기록으로 복구 → 장별 Source로 재시작Git 명령을 외우거나 직접 입력할 필요는 없습니다. 아래 요청문을 그대로 붙여넣으면 Claude Code가 확인하고 처리합니다.
1. 디버깅 — 먼저 무엇이 어긋났는지 그대로 말하고 고쳐봅니다. 대부분 여기서 해결됩니다.
지금 작업이 책과 다르게 진행됐어.
현재 상태와 화면에 나온 문제를 확인하고 원인을 찾아서 고쳐줘.검사가 실패했을 때는 실패한 항목을 그대로 알려주면 됩니다.
자동 검사에서 실패한 항목이 있어. 화면에 나온 내용을 그대로 알려줄게.
기준 자료와 보고서 중 어느 쪽이 잘못됐는지 확인하고 고쳐줘.2. 내 정상 기록으로 복구 — 해결되지 않으면 실습하면서 내 프로젝트에 남겨둔 정상 기록으로 돌아갑니다. 지금까지 한 작업은 먼저 따로 보존합니다.
현재 작업은 잃지 않도록 먼저 별도로 보존해줘.
이 프로젝트에서 마지막으로 정상 동작했던 상태를 찾아 안전하게 복구해줘.3. 장별 Source로 재시작 — 그래도 이어갈 수 없을 때 사용합니다. 2장의 남은 실습은 건너뛰게 되므로 마지막 수단입니다.
내 현재 작업을 먼저 안전하게 보존해줘.
아래 2장 완성 Source에서 다시 시작해줘.
https://github.com/buildyourownai-lab/develop-like-a-pro-with-ai/tree/main/chapters/ch02/source/movie-report
준비가 끝나면 2장을 마친 상태인지 확인해줘.방향부터 확인하고, 더 필요할 때 다음 힌트를 펼치세요.
Test는 통과했는데 불안함
1단계 — 방향
무엇과 무엇을 비교했는지 먼저 봅니다.
2단계 — 범위
공식 웹 원본 대조인지 로컬 기준본 대조인지 구분합니다.
3단계 — 위치·원인 후보
검사 대상의 연도·행 수·필드와 기준 파일 출처를 확인합니다.
정답을 요청했을 때
확인하지 않은 항목에 별도 완료 조건을 세웁니다. 기존 PASS를 전체 정확성 인증으로 확대하지 않습니다.
검증 주의
이 설명만으로 원인이 확인됐거나 수정됐다고 말하지 않습니다. 현재 프로젝트의 근거를 먼저 대조합니다.
권한 화면에서 막힘
1단계 — 방향
반복 작업인지 외부 상태를 바꾸는지 구분하세요.
2단계 — 범위
하려는 명령의 대상과 변경 범위를 읽습니다.
3단계 — 위치·원인 후보
허용·확인·금지 중 어떤 수준인지 실제로 한 작업을 기준으로 판단합니다.
정답을 요청했을 때
예상하지 않은 설치·삭제·외부 전송이면 멈춰 이유를 묻습니다. 전체 권한 해제를 정답으로 사용하지 않습니다.
검증 주의
이 설명만으로 원인이 확인됐거나 수정됐다고 말하지 않습니다. 현재 프로젝트의 근거를 먼저 대조합니다.
이번 장의 완료 체크리스트
- 완료 조건비교할 연도·항목·단위·범위를 먼저 정함
- 기준 자료출처와 조회 조건을 확인한 자료를 보관
- 직접 대조공식 원본과 선택한 항목을 대조하고 범위를 남김
- Test 구현보관한 자료와 보고서를 비교하는 검사 작성
- 실행 결과관련 Test 실행 결과 확인
- 범위 설명Test가 확인하지 않은 항목을 구분
장 완료 확인해줘.실제 프로젝트에서 튜터와 확인합니다. 사이트를 열어본 기록은 학습 완료가 아닙니다.
장별 소스와 저자 검증 기록
저자는 서로 독립된 빈 폴더에서 1장 도착점을 다시 만든 뒤 2장을 이어서 두 번 돌렸습니다. 두 번 모두 기준 자료가 만들어지고 자동 검사가 전항목 통과했습니다. 보고서의 TOP 20 영화명·관객수·매출액은 두 번 모두 기준 자료와 전건 일치했습니다. 근거는 verification/chapter-02/에 있습니다.
장별 소스는 해당 장까지의 기준 상태입니다. 정상 실습은 내 프로젝트를 이어가고, 완성 소스는 비교·복구할 때 사용합니다.
자료 판본 1c784213이 장의 개발 용어
- Test
- 정한 완료 조건을 반복 확인하는 검사. 검사하지 않은 전체 정확성을 보증하지 않습니다.