잘되던 때로 돌아갈 곳을 만들어둡니다

최근 변경을 되돌리고 검증한 상태를 Git과 GitHub에 보관합니다.

이어갈 프로젝트 · movie-report

4장의 규칙과 정상 보고서·Test가 있습니다.

이번 장의 준비와 서비스

필요한 도구 · Git · Claude Code Checkpointing

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

github 준비 안내 →

미기록 메모·인증값을 잃거나 프로젝트 밖 지침까지 복원했다고 주장하지 않습니다.

순서대로 입력하는 커맨드

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

01시작 전 확인

Claude Code·Codex에 입력튜터 요청

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

먼저 확인 · 4장의 규칙과 정상 보고서·Test가 있습니다. 이미 확인된 장·프로젝트는 다시 묻지 않고 현재 기록과 실제 상태를 대조합니다.

5장 시작해.

02방금 한 변경은 빠르게 되돌립니다

Claude Code·Codex에 입력실습

최근 변경을 되돌리는 연습을 위해 제목을 크게 바꿀 때

먼저 확인 · 4장의 정상 보고서와 Test를 확인합니다. 이 변경은 뒤의 Checkpointing 연습 대상입니다.

보고서를 만드는 코드에서 첫 화면의 제목을
지금보다 훨씬 크게 바꾸고, 그 코드로 보고서를 다시 만들어줘.

03방금 한 변경은 빠르게 되돌립니다

Claude Code·Codex에 입력실습

Checkpointing으로 코드를 되돌린 뒤 Excel 결과물을 다시 만들 때

먼저 확인 · 독자가 작성 중인 입력을 지우고 Esc 두 번으로 제목 변경 요청을 선택한 뒤 파일만 복구하고 대화는 유지했는지 확인합니다. 실제 복구 여부가 불명확하면 먼저 확인합니다.

방금 되돌린 코드로 보고서를 다시 만들고
관련 Test도 실행해줘.

04잘되던 상태를 오래 남겨둡니다

Claude Code·Codex에 입력실습

복구한 정상 상태를 Git 기준으로 남길 때

먼저 확인 · 제목이 복구된 실제 Excel과 관련 Test를 확인합니다. 프로젝트 밖 공통 지침은 이 Git 기록에 포함되지 않습니다.

지금 상태를 나중에 돌아올 정상 기준으로 남기고 싶어.

먼저 관련 Test를 모두 실행해줘.

모두 통과하면 기록하면 안 되는 정보나 개인정보,
불필요한 임시 파일이 없는지 확인한 뒤
지금 상태를 Git으로 기록해줘.

문제가 있다면 기록하지 말고 먼저 알려줘.
무엇을 기록하고 무엇을 제외했는지도 쉽게 설명해줘.

05되돌릴 변경과 남길 변경을 함께 만듭니다

Claude Code·Codex에 입력실습

Git 정상 기록과 비교할 변경 및 보존할 새 메모를 만들 때

먼저 확인 · 방금 남긴 정상 커밋을 식별합니다. 기존 메모가 있다면 임의로 덮어쓰지 않도록 현재 파일을 확인합니다.

복구 연습을 위해 두 가지 작업을 해줘.

보고서를 만드는 코드에서 요약 시트 2행 높이를 42로 바꾸고
보고서를 다시 만들어줘.

그리고 notes/next-ideas.md를 새로 만들어
다음 보고서에서 검토할 아이디어 두 가지를 적어줘.

작업이 끝나면 관련 Test를 실행하고 결과를 알려줘.

그다음 방금 기록한 정상 상태와 지금 상태를 비교해서
어떤 기존 파일이 바뀌었고 어떤 새 파일이 생겼는지 알려줘.

아직 아무것도 되돌리지 말고,
각 파일을 복구하면 무엇을 잃는지도 쉽게 설명해줘.

06필요한 변경만 이전 상태로 돌립니다

Claude Code·Codex에 입력실습

Diff를 읽고 행 높이 변경만 선택적으로 복구할 때

먼저 확인 · 복구 기준 커밋과 행 높이 변경, 아직 기록하지 않은 notes/next-ideas.md를 구분합니다.

요약 시트 2행 높이 변경만
방금 기록한 정상 상태로 되돌려줘.
그 높이를 만든 코드까지 함께 되돌려줘.

notes/next-ideas.md는 새로 만든 메모이니
그대로 남겨줘.

복구하기 전에 무엇이 되돌아가고
무엇이 유지되는지 먼저 알려줘.

되돌린 뒤에는 기존 Test 전체를 다시 실행하고
notes/next-ideas.md가 그대로 있는지도 확인해줘.

7. GitHub 계정과 저장소를 준비합니다 선택·문제 발생 시

Claude Code·Codex에 입력선택·문제 발생 시

GitHub 가입을 진행하는 독자가 현재 화면의 도움을 요청할 때만

먼저 확인 · 독자가 GitHub 공식 가입 화면에 있는지 확인합니다. 비밀번호·인증번호는 직접 입력하며 이미 가입·로그인했다면 이 단계를 건너뜁니다.

지금 GitHub 회원가입을 진행하고 있어.

내가 직접 입력하거나 확인해야 하는 것만
현재 화면을 기준으로 하나씩 안내해줘.

비밀번호나 인증번호처럼 다른 사람에게 알려주면 안 되는 값은
너에게 보내지 않고 내가 직접 입력할게.

08GitHub 계정과 저장소를 준비합니다

Claude Code·Codex에 입력실습

GitHub 로그인 후 movie-report 비공개 저장소를 처음 만들 때

먼저 확인 · 독자가 가입·로그인을 마쳤는지 확인합니다. 같은 프로젝트의 저장소가 이미 있다면 새로 만들지 말고 연결 상태를 확인합니다.

GitHub 가입과 로그인이 끝났어.

지금 작업 중인 movie-report 프로젝트를 보관할
비공개 GitHub 저장소를 만들어줘.

저장소 이름은 movie-report로 해줘.

로그인이나 GitHub 승인처럼 내가 직접 해야 하는 일이 나오면
그 지점에서 기다리고 무엇을 해야 하는지 안내해줘.

아직 프로젝트 파일은 올리지 말고,
저장소가 만들어졌는지만 확인해줘.

09내 정상 기록을 GitHub에 올립니다

Claude Code·Codex에 입력실습

준비한 비공개 저장소에 정상 Git 기록을 처음 보낼 때

먼저 확인 · 대상 movie-report 비공개 저장소와 현재 정상 커밋을 확인합니다. 기록하지 않은 새 파일과 전송할 기록을 구분합니다.

방금 만든 movie-report 비공개 Repository에
현재 프로젝트를 연결해줘.

먼저 다른 사람에게 보여주면 안 되는 정보나 개인정보,
불필요한 파일이 Git 기록에 포함되지 않았는지 다시 확인해줘.

문제가 있으면 올리지 말고 먼저 알려줘.

문제가 없다면 지금까지 만든 정상 기록을
GitHub 저장소에 보내고 성공했는지 확인해줘.

10중요한 작업이 끝나면 정상 상태를 기록하게 합니다

Claude Code·Codex에 입력실습

정상 상태 기록과 작업 마무리 전송 원칙을 공통 지침에 추가할 때

먼저 확인 · Git 기록·선택적 복구·원격 전송을 실제로 확인했고 기존 공통 지침을 보존할 수 있는지 봅니다.

이번에 Git으로 정상 상태를 기록하고
필요할 때 복구하는 방법을 확인했어.

앞으로 주요 작업이 끝나면 완료 조건과
관련 Test, 검사를 먼저 실행해서 확인해줘.

모두 통과하면 기록하면 안 되는 Secret이나 개인정보,
불필요한 파일이 없는지 확인하고
그 상태를 나중에 돌아올 수 있도록 Git에 기록해줘.

Test와 검사가 모두 통과한 뒤에 또 파일을 바꾸게 되면
새 작업을 시작하기 전에
통과한 상태를 먼저 기록해줘.

Test나 검사가 실패했거나
기록하면 안 되는 정보가 발견되면
정상 상태로 기록하지 말고 먼저 알려줘.

작은 문구 수정이나 사소한 변경마다
새 기록을 만들 필요는 없어.

내가 작업을 마무리하자고 말하면
정상 상태를 확인해서 기록한 뒤
그 기록을 연결한 GitHub 저장소에도 보내고
실제로 올라갔는지 확인해줘.

이 원칙을 앞으로 다른 프로젝트에서도 사용할 수 있도록
공통 ~/.claude/CLAUDE.md에 추가해줘.
기존 공통 원칙은 지우거나 중복해서 만들지 마.

11중요한 작업이 끝나면 정상 상태를 기록하게 합니다

Claude Code·Codex에 입력실습

추가한 공통 원칙에 따라 이번 작업을 마무리하거나 새 연도 작업 후 다시 마무리할 때

먼저 확인 · 현재 미기록 변경과 대상 GitHub 저장소를 확인합니다. 본문은 새 연도 작업 뒤 이 요청을 다시 사용하므로 동일 문장이라는 이유만으로 막지 않습니다.

이번 작업을 마무리하고
GitHub 저장소에도 보내줘.

12이제 내가 고른 연도로 바꿉니다

Claude Code·Codex에 입력실습

2024년 자료를 보존하면서 본문의 2019년 보고서를 추가할 때

먼저 확인 · 기존 2024년 보고서·기준 자료·Test와 정상 기록을 확인합니다. 정본은 2019년 예시이며 다른 선택 연도로 임의 치환하지 않습니다.

2024년 보고서와 기준 자료는 그대로 두고, 같은 보고서를 내가 고른 연도로 하나 더
만들어줘. 2019년 연도별 박스오피스 TOP 20이야. 1장에서 사용한 KOBIS 공식통계의
연도별 박스오피스에서 그 연도를 조회해서 가져와줘. 그 연도의 기준 자료와 Test도
함께 만들고, 출처와 조회 시점을 남기는 방식은 지금과 같게 해줘.

자료를 가져올 수 없으면 숫자를 채워 넣지 말고 먼저 알려줘.

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

Claude Code·Codex에 입력튜터 요청

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

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

장 완료 확인해줘.

이 장에서 막혔을 때

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

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

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

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

Git으로 정상 상태를 기록하기 전에 확인이 필요하다는 답을 받으면 이렇게 물어봅니다.

Git으로 기록하기 전에 확인이 필요한 게 있다고 나왔어.
무엇을 확인해야 하는지 쉬운 말로 설명해줘.

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

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

3. 장별 Source로 재시작 — 그래도 이어갈 수 없을 때 사용합니다. movie-report의 마지막 장이므로, 이 수단을 쓰면 PART 1 실습을 마친 것으로 보고 6장으로 넘어가면 됩니다.

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

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

코드를 되돌렸는데 Excel은 그대로

1단계 — 방향

코드와 생성된 결과물을 구분합니다.

2단계 — 범위

복구한 파일 목록에 Excel이 포함됐는지 봅니다.

3단계 — 위치·원인 후보

복구한 코드로 다시 생성해야 하는 결과인지 확인합니다.

정답을 요청했을 때

필요하면 복구한 코드로 Excel을 새로 생성한 뒤 다시 열어 확인합니다. 새 메모는 유지합니다.

검증 주의

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

무엇을 보존해야 할지 모르겠음

1단계 — 방향

복구 전에 기록되지 않은 파일을 먼저 봅니다.

2단계 — 범위

기존 수정과 새 메모·설정 파일을 나눕니다.

3단계 — 위치·원인 후보

Git이 추적하지 않는 것까지 보존 목록에 포함됐는지 확인합니다.

정답을 요청했을 때

별도 안전 사본을 확인한 후 필요한 변경만 복구합니다. 인증값은 공개 저장소에 보내지 않습니다.

검증 주의

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

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

이번 장의 완료 체크리스트

최근 변경되돌릴 변경과 생성 결과물의 범위를 구분
정상 기록검사한 정상 상태를 Git에 기록
차이 확인복구할 변경과 남길 새 작업을 분리
선택적 복구코드와 필요 결과물을 복원하고 새 메모 보존
원격 보관대상 저장소와 실제 전송한 커밋 확인
새 연도 분리다른 연도 보고서와 기존 결과를 구분

장 완료 확인해줘.

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

장별 소스와 저자 검증 기록

저자는 4장 도착점에서 시작해 5장 요청문만으로 2회 돌렸습니다. 두 번 모두 검사 8개 통과를 확인한 뒤 정상 기준을 기록했고, 보고서와 새 메모를 함께 바꾼 다음 보고서만 그 기준으로 되돌리고 메모는 남기는 데까지 갔습니다. 복구한 뒤 검사 8개도 다시 전부 통과했습니다. 근거는 verification/chapter-05/에 있습니다.

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

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

자료 판본 1c784213

이 장의 개발 용어

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

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

지금 상태를 나중에 돌아올 정상 기준으로 남기고 싶어. 먼저 관련 Test를 모두 실행해줘. 모두 통과하면 기록하면 안 되는 정보나 개인정보, 불필요한 임시 파일이 없는지 확인한 뒤 지금 상태를 Git으로 기록해줘. 문제가 있다면 기록하지 말고 먼저 알려줘. 무엇을 기록하고 무엇을 제외했는지도 쉽게 설명해줘.

복구 연습을 위해 두 가지 작업을 해줘. 보고서를 만드는 코드에서 요약 시트 2행 높이를 42로 바꾸고 보고서를 다시 만들어줘. 그리고 notes/next-ideas.md를 새로 만들어 다음 보고서에서 검토할 아이디어 두 가지를 적어줘. 작업이 끝나면 관련 Test를 실행하고 결과를 알려줘. 그다음 방금 기록한 정상 상태와 지금 상태를 비교해서 어떤 기존 파일이 바뀌었고 어떤 새 파일이 생겼는지 알려줘. 아직 아무것도 되돌리지 말고, 각 파일을 복구하면 무엇을 잃는지도 쉽게 설명해줘.

요약 시트 2행 높이 변경만 방금 기록한 정상 상태로 되돌려줘. 그 높이를 만든 코드까지 함께 되돌려줘. notes/next-ideas.md는 새로 만든 메모이니 그대로 남겨줘. 복구하기 전에 무엇이 되돌아가고 무엇이 유지되는지 먼저 알려줘. 되돌린 뒤에는 기존 Test 전체를 다시 실행하고 notes/next-ideas.md가 그대로 있는지도 확인해줘.

지금 GitHub 회원가입을 진행하고 있어. 내가 직접 입력하거나 확인해야 하는 것만 현재 화면을 기준으로 하나씩 안내해줘. 비밀번호나 인증번호처럼 다른 사람에게 알려주면 안 되는 값은 너에게 보내지 않고 내가 직접 입력할게.

GitHub 가입과 로그인이 끝났어. 지금 작업 중인 movie-report 프로젝트를 보관할 비공개 GitHub 저장소를 만들어줘. 저장소 이름은 movie-report로 해줘. 로그인이나 GitHub 승인처럼 내가 직접 해야 하는 일이 나오면 그 지점에서 기다리고 무엇을 해야 하는지 안내해줘. 아직 프로젝트 파일은 올리지 말고, 저장소가 만들어졌는지만 확인해줘.

방금 만든 movie-report 비공개 Repository에 현재 프로젝트를 연결해줘. 먼저 다른 사람에게 보여주면 안 되는 정보나 개인정보, 불필요한 파일이 Git 기록에 포함되지 않았는지 다시 확인해줘. 문제가 있으면 올리지 말고 먼저 알려줘. 문제가 없다면 지금까지 만든 정상 기록을 GitHub 저장소에 보내고 성공했는지 확인해줘.

이번에 Git으로 정상 상태를 기록하고 필요할 때 복구하는 방법을 확인했어. 앞으로 주요 작업이 끝나면 완료 조건과 관련 Test, 검사를 먼저 실행해서 확인해줘. 모두 통과하면 기록하면 안 되는 Secret이나 개인정보, 불필요한 파일이 없는지 확인하고 그 상태를 나중에 돌아올 수 있도록 Git에 기록해줘. Test와 검사가 모두 통과한 뒤에 또 파일을 바꾸게 되면 새 작업을 시작하기 전에 통과한 상태를 먼저 기록해줘. Test나 검사가 실패했거나 기록하면 안 되는 정보가 발견되면 정상 상태로 기록하지 말고 먼저 알려줘. 작은 문구 수정이나 사소한 변경마다 새 기록을 만들 필요는 없어. 내가 작업을 마무리하자고 말하면 정상 상태를 확인해서 기록한 뒤 그 기록을 연결한 GitHub 저장소에도 보내고 실제로 올라갔는지 확인해줘. 이 원칙을 앞으로 다른 프로젝트에서도 사용할 수 있도록 공통 ~/.claude/CLAUDE.md에 추가해줘. 기존 공통 원칙은 지우거나 중복해서 만들지 마.

2024년 보고서와 기준 자료는 그대로 두고, 같은 보고서를 내가 고른 연도로 하나 더 만들어줘. 2019년 연도별 박스오피스 TOP 20이야. 1장에서 사용한 KOBIS 공식통계의 연도별 박스오피스에서 그 연도를 조회해서 가져와줘. 그 연도의 기준 자료와 Test도 함께 만들고, 출처와 조회 시점을 남기는 방식은 지금과 같게 해줘. 자료를 가져올 수 없으면 숫자를 채워 넣지 말고 먼저 알려줘.

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