부록 B · 막혔을 때 다시 시작하는 법

이 부록으로 하는 일

막혀서 더 나아가지 못하는 실습을 다시 이어갑니다. 순서가 정해져 있습니다.

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

위에서부터 시도하고, 해결되지 않으면 다음으로 내려갑니다. 장별 Source는 마지막 수단입니다. Git 명령을 외우거나 직접 입력할 필요는 없습니다. 세 단계 모두 요청문을 그대로 붙여넣으면 Claude Code가 확인하고 처리합니다.

프롬프트

prompts.md에 이 부록에서 Claude Code에 입력하는 문장이 책의 순서대로 있습니다.

순서대로 합니다

1. 디버깅 --- 지금까지 작업하던 대화창에 그대로 알려줍니다. 그 대화창이 지금까지 한 작업을 알고 있습니다. 오류 메시지는 해석하지 말고 그대로 붙여넣는 것이 더 정확합니다. 요청문은 prompts.md의 「1단계. 디버깅」에 있습니다.

같은 자리에서 두세 번 고쳐도 계속 막힌다면 다음으로 넘어갑니다.

2. 내 정상 기록으로 복구 --- 돌아갈 곳은 책이 주는 파일이 아니라 실습하면서 내 프로젝트에 남겨둔 정상 기록입니다. 지금까지 한 작업을 먼저 보존한 뒤에 돌아갑니다. 요청문은 prompts.md의 「2단계. 내 정상 기록으로 복구」에 있습니다.

복구한 뒤 막혔던 자리를 다시 요청합니다. 같은 요청이라도 정상 상태에서 다시 시작하면 다른 결과가 나오는 경우가 많습니다.

3. 장별 Source로 재시작 --- 앞의 두 방법으로도 해결되지 않았을 때만 씁니다. 이번에는 저자가 그 장을 끝낸 상태의 파일을 받아 그 자리에서 다시 출발합니다. 요청문은 prompts.md의 「3단계. 장별 Source로 재시작」에 있습니다.

내가 발급받은 인증값은 Source에 들어 있지 않습니다. 부록 D에서 값을 넣을 자리를 확인한 뒤 직접 채웁니다. Source로 바꾼 뒤에는 막힌 장을 처음부터 다시 읽지 않고 다음 장부터 이어서 읽습니다.

되돌리기 전에 보존한 작업은 사라지지 않았습니다. 살릴 것이 있는지 물어보면 됩니다. 요청문은 prompts.md의 「보존한 작업은 사라지지 않았습니다」에 있습니다.

보존한 자리에는 아직 Git에 기록되지 않은 파일도 함께 들어갑니다. 방금 만들어둔 메모나 설정 파일이 여기에 해당하므로 「Git에 기록되지 않았던 파일까지 포함해서」 줄을 꼭 함께 넣습니다. 그 줄이 없으면 Git에 기록된 파일만 확인하고 가져올 것이 없다고 답할 수 있습니다.

함께 보는 곳

그 장의 Source가 어디에 있는지는 chapters/의 장별 폴더입니다.
지금까지 남긴 기록과 보존한 작업을 화면으로 보고 싶으면 부록 C를 봅니다.
정상 기록을 남기는 방법 자체는 5장에서 만듭니다.

이 부록의 프롬프트는 모두 Claude Code에 입력합니다.

책에 나오는 순서대로 담았습니다. 책을 읽으면서 그 자리에 왔을 때 사용하세요. 직접 타이핑해도 되고 복사해서 붙여넣어도 됩니다.

위에서부터 시도하고, 해결되지 않으면 다음으로 내려갑니다. Git 명령을 외우거나 직접 입력할 필요는 없습니다.

1단계. 디버깅

방금 무엇을 하려고 했고, 무엇을 기대했고, 실제로 무엇이 일어났는지 알려줄게.
바로 고치지 말고 같은 문제가 다시 일어나는지 먼저 확인해줘.
원인을 찾으면 그 부분만 고치고, 같은 문제가 해결됐는지 다시 확인해줘.

지금까지 작업하던 대화창에 그대로 붙여넣습니다.

2단계. 내 정상 기록으로 복구

현재 작업을 먼저 안전하게 보존하고, 이 프로젝트에서 마지막으로 정상
동작했던 상태를 찾아줘.

현재 상태와 무엇이 다른지 확인한 뒤 마지막 정상 상태로 안전하게
복구해줘.

복구가 끝나면 관련 테스트를 다시 실행해 정상적으로 돌아왔는지 확인해줘.

같은 자리에서 두세 번 고쳐도 계속 막힐 때 사용합니다.

3단계. 장별 Source로 재시작

이 책의 공식 실습 저장소
https://github.com/buildyourownai-lab/develop-like-a-pro-with-ai
에서 지금 진행 중인 장의 Source를 찾아줘.

내 현재 작업을 먼저 안전하게 보존해줘.

그 장을 끝낸 Source에서 다시 시작하고 관련 테스트를 실행해줘.

앞의 두 방법으로도 해결되지 않았을 때만 사용합니다.

보존한 작업은 사라지지 않았습니다

되돌리기 전에 보존해둔 작업이 지금 어디에 있는지 알려줘.
Git에 기록되지 않았던 파일까지 포함해서 파일과 변경 목록을 보여줘.
인증값 파일은 위치와 존재 여부만 알려주고 실제 값은 출력하지 마.
그중에 지금 상태로 다시 가져올 만한 것이 있으면 알려줘.

되돌린 뒤에 살릴 것이 있는지 확인할 때 사용합니다.