같은 실수는 두 번 하지 않게 합니다

좋은 작업 방식을 공통 규칙과 프로젝트 규칙으로 나누어 남깁니다.

이어갈 프로젝트 · movie-report

3장의 수정과 회귀 확인을 마쳤습니다.

이번 장의 준비와 서비스

필요한 도구 · Claude Code 지침 파일

이미 준비한 계정과 기능은 그대로 이어갑니다.

튜터 관리 블록이나 기존 사용자 지침을 덮어쓰지 않고 모든 일회성 사건을 규칙으로 만들지 않습니다.

순서대로 입력하는 커맨드

현재 단계와 입력 위치를 확인한 뒤 하나씩 복사하세요.

01시작 전 확인

Claude Code·Codex에 입력튜터 요청

4장을 처음 시작하거나 현재 장의 시작 조건을 확인해 달라고 요청할 때

먼저 확인 · 3장의 수정과 회귀 확인을 마쳤습니다. 이미 확인된 장·프로젝트는 다시 묻지 않고 현재 기록과 실제 상태를 대조합니다.

4장 시작해.

02공통 작업 원칙을 만듭니다

Claude Code·Codex에 입력실습

3장에서 사용한 문제 해결 방법을 공통 원칙과 상세 절차로 남길 때

먼저 확인 · 3장의 최소 수정과 회귀 확인을 마쳤는지 봅니다. 기존 공통 CLAUDE.md와 상위 사용자·조직 정책을 먼저 확인합니다.

지금까지 movie-report 프로젝트에서 사용한 작업 방식 가운데
다른 프로젝트에서도 계속 지킬 공통 원칙을
~/.claude/CLAUDE.md에 정리해줘.

작업을 끝내기 전에 관련 Test와 검사를 실행하고,
하나라도 실패하면 완료했다고 말하지 마.

문제가 생기면 바로 수정하지 말고
같은 문제를 확인한 뒤 증거로 원인을 좁혀줘.
원인을 확인하면 필요한 부분만 수정하고,
수정 뒤에는 실패했던 Test와 관련 기존 Test를 다시 실행해줘.

기존 공통 CLAUDE.md가 있다면 먼저 확인하고,
관련 없는 기존 내용은 지우거나 덮어쓰지 마.

문제가 생겼을 때 따를 자세한 절차는
현재 movie-report 프로젝트의
docs/debug-procedure.md에 따로 정리해줘.

절차는 이 순서로 적어줘.
고치지 않은 채로 같은 실패를 다시 확인하고,
보존한 기준 자료부터 값을 차례로 비교해
처음 달라지는 지점을 찾고,
확인된 사실과 아직 추측인 것을 나눠 적고,
증거로 원인을 확인한 뒤 필요한 부분만 고치고,
실패했던 Test와 기존 Test 전체를 다시 실행하는 순서야.

03프로젝트에만 필요한 규칙은 따로 둡니다

Claude Code·Codex에 입력실습

영화 보고서에만 필요한 규칙을 프로젝트에 남길 때

먼저 확인 · 공통 원칙과 상세 절차를 확인하고 현재 movie-report/CLAUDE.md의 기존 사용자 규칙·튜터 연결을 읽습니다.

현재 movie-report 프로젝트의 맨 위에
CLAUDE.md가 있는지 먼저 확인하고, 기존 사용자 규칙과 튜터 연결을 보존하면서
필요한 프로젝트 규칙을 추가해줘. 파일 전체를 덮어쓰지 마.

이 프로젝트에서는 영화 흥행 데이터를
KOBIS 공식 자료를 기준으로 확인하고,
보고서에는 KOBIS 출처와 조회 기준 연도를 남겨줘.

데이터에서 직접 확인할 수 없는
흥행 원인이나 이유는 추측하지 않는다는 규칙도 넣어줘.

모든 프로젝트에서 사용할 Test, 문제 확인,
수정 후 재검사 같은 공통 작업 원칙은
여기에 중복해서 넣지 마.

한 번 있었던 오류나
다음 작업에 필요 없는 사건 자체도 규칙으로 남기지 마.

04이제 변경만 요청합니다

Claude Code·Codex에 입력실습

저장한 원칙이 다음 작은 변경에서 적용되는지 시험할 때

먼저 확인 · 공통·프로젝트 규칙을 남긴 뒤 정상 보고서에서 제목만 바꾸는 단계인지 확인합니다.

보고서 첫 화면의 제목을
'2024년 영화 흥행 TOP 20'으로 변경해줘.

05이 장을 마쳤는지 확인합니다

Claude Code·Codex에 입력튜터 요청

4장의 실습 결과를 장별 완료 조건과 대조할 때

먼저 확인 · 앞 단계 실행 결과와 사람이 직접 확인할 항목을 확인합니다. 요청문을 보여주거나 실행했다고 완료로 세지 않습니다.

장 완료 확인해줘.

이 장에서 막혔을 때

디버깅 → 내 정상 기록으로 복구 → 장별 Source로 재시작

Git 명령을 외우거나 직접 입력할 필요는 없습니다. 아래 요청문을 그대로 붙여넣으면 Claude Code가 확인하고 처리합니다.

1. 디버깅 — 먼저 무엇이 어긋났는지 그대로 말하고 고쳐봅니다. 대부분 여기서 해결됩니다.

지금 작업이 책과 다르게 진행됐어.
현재 상태와 화면에 나온 문제를 확인하고 원인을 찾아서 고쳐줘.

이 장에서 특히 자주 막히는 자리는 공통 규칙과 프로젝트 규칙이 뒤섞이는 경우입니다.

~/.claude/CLAUDE.md와 movie-report/CLAUDE.md의 내용이 섞인 것 같아.
모든 프로젝트에서 쓸 원칙과 이 프로젝트에만 필요한 규칙을
다시 나눠서 정리해줘.

2. 내 정상 기록으로 복구 — 해결되지 않으면 실습하면서 내 프로젝트에 남겨둔 정상 기록으로 돌아갑니다. 지금까지 한 작업은 먼저 따로 보존합니다.

현재 작업은 잃지 않도록 먼저 별도로 보존해줘.
이 프로젝트에서 마지막으로 정상 동작했던 상태를 찾아 안전하게 복구해줘.

3. 장별 Source로 재시작 — 그래도 이어갈 수 없을 때 사용합니다. 4장의 남은 실습은 건너뛰게 되므로 마지막 수단입니다.

내 현재 작업을 먼저 안전하게 보존해줘.
아래 4장 완성 Source에서 다시 시작해줘.
https://github.com/buildyourownai-lab/develop-like-a-pro-with-ai/tree/main/chapters/ch04/source/movie-report
준비가 끝나면 4장을 마친 상태인지 확인해줘.

방향부터 확인하고, 더 필요할 때 다음 힌트를 펼치세요.

규칙 파일이 이미 있음

1단계 — 방향

새 파일을 만들기 전에 기존 내용을 읽어야 합니다.

2단계 — 범위

튜터 연결과 독자가 직접 정한 규칙을 구분합니다.

3단계 — 위치·원인 후보

관리 블록 밖의 문장을 보존하는 변경안인지 확인합니다.

정답을 요청했을 때

기존 파일 전체를 교체하지 않고 필요한 규칙을 병합합니다. 변경 뒤 튜터와 기존 규칙이 모두 남았는지 확인합니다.

검증 주의

이 설명만으로 원인이 확인됐거나 수정됐다고 말하지 않습니다. 현재 프로젝트의 근거를 먼저 대조합니다.

규칙을 적었는데 실행 안 함

1단계 — 방향

파일 저장과 행동 적용은 별개입니다.

2단계 — 범위

현재 프로젝트가 맞고 해당 지침이 읽혔는지 확인합니다.

3단계 — 위치·원인 후보

새 대화에서 참고한 지침 경로를 알려달라고 요청합니다.

정답을 요청했을 때

연결을 맞춘 뒤 작은 작업으로 다시 확인합니다. 실패를 숨기지 말고 실제로 한 검사와 안 한 검사를 나눕니다.

검증 주의

이 설명만으로 원인이 확인됐거나 수정됐다고 말하지 않습니다. 현재 프로젝트의 근거를 먼저 대조합니다.

디버깅 → 정상 기록 복구 → 장별 소스로 재시작 →

이번 장의 완료 체크리스트

범위 결정공통·프로젝트·상세 절차를 나눔
기존 지침 확인기존 지침과 튜터 연결을 먼저 읽음
공통 규칙반복할 작업 원칙을 적절한 범위에 저장
프로젝트 규칙KOBIS 출처와 추측 금지를 프로젝트에 저장
적용 확인제목 변경 요청에서 참고한 규칙과 실제 검사를 확인
한계 확인지침은 강제 장치가 아님을 구분

장 완료 확인해줘.

실제 프로젝트에서 튜터와 확인합니다. 사이트를 열어본 기록은 학습 완료가 아닙니다.

장별 소스와 저자 검증 기록

저자가 3장 도착점에서 시작해 4장 요청문만으로 두 번 돌렸고, 두 번 모두 두 규칙이 중복 없이 나뉘고 제목 변경만 요청했는데도 Claude가 검사 8개를 스스로 실행해 전부 통과를 확인한 뒤 완료를 보고했습니다. 근거는 verification/chapter-04/에 있습니다.

4장 완성 소스 ↗저자 검증 상세 기록 ↗

장별 소스는 해당 장까지의 기준 상태입니다. 정상 실습은 내 프로젝트를 이어가고, 완성 소스는 비교·복구할 때 사용합니다.

자료 판본 1c784213

이 장의 개발 용어

Test: 정한 완료 조건을 반복 확인하는 검사. 검사하지 않은 전체 정확성을 보증하지 않습니다.

튜터 사용 안내 실습 자료 업데이트

지금까지 movie-report 프로젝트에서 사용한 작업 방식 가운데 다른 프로젝트에서도 계속 지킬 공통 원칙을 ~/.claude/CLAUDE.md에 정리해줘. 작업을 끝내기 전에 관련 Test와 검사를 실행하고, 하나라도 실패하면 완료했다고 말하지 마. 문제가 생기면 바로 수정하지 말고 같은 문제를 확인한 뒤 증거로 원인을 좁혀줘. 원인을 확인하면 필요한 부분만 수정하고, 수정 뒤에는 실패했던 Test와 관련 기존 Test를 다시 실행해줘. 기존 공통 CLAUDE.md가 있다면 먼저 확인하고, 관련 없는 기존 내용은 지우거나 덮어쓰지 마. 문제가 생겼을 때 따를 자세한 절차는 현재 movie-report 프로젝트의 docs/debug-procedure.md에 따로 정리해줘. 절차는 이 순서로 적어줘. 고치지 않은 채로 같은 실패를 다시 확인하고, 보존한 기준 자료부터 값을 차례로 비교해 처음 달라지는 지점을 찾고, 확인된 사실과 아직 추측인 것을 나눠 적고, 증거로 원인을 확인한 뒤 필요한 부분만 고치고, 실패했던 Test와 기존 Test 전체를 다시 실행하는 순서야.

현재 movie-report 프로젝트의 맨 위에 CLAUDE.md가 있는지 먼저 확인하고, 기존 사용자 규칙과 튜터 연결을 보존하면서 필요한 프로젝트 규칙을 추가해줘. 파일 전체를 덮어쓰지 마. 이 프로젝트에서는 영화 흥행 데이터를 KOBIS 공식 자료를 기준으로 확인하고, 보고서에는 KOBIS 출처와 조회 기준 연도를 남겨줘. 데이터에서 직접 확인할 수 없는 흥행 원인이나 이유는 추측하지 않는다는 규칙도 넣어줘. 모든 프로젝트에서 사용할 Test, 문제 확인, 수정 후 재검사 같은 공통 작업 원칙은 여기에 중복해서 넣지 마. 한 번 있었던 오류나 다음 작업에 필요 없는 사건 자체도 규칙으로 남기지 마.

내 현재 작업을 먼저 안전하게 보존해줘. 아래 4장 완성 Source에서 다시 시작해줘. https://github.com/buildyourownai-lab/develop-like-a-pro-with-ai/tree/main/chapters/ch04/source/movie-report 준비가 끝나면 4장을 마친 상태인지 확인해줘.