리뷰를 시켰더니 3분 만에 잘 정리된 지적 네 개가 돌아옵니다. 종료코드는 0입니다. 그런데 그 워커가 정말 그 파일을 열긴 열었는지, 확인해 보신 적 있으신가요.

이 전자책은 Claude Code로 에이전트를 부리는 개발자를 위한 증거 설계 안내서입니다. 더 좋은 프롬프트를 쓰는 법이 아니라, 돌아온 응답을 확인 가능한 형태로 바꾸는 법을 다룹니다.

노력이 부족해서 생기는 일이 아닙니다. 원인은 대개 한 곳입니다 — 지시는 있는데 확인 장치가 없다는 것. 규칙은 문서에 있고, 워커는 대답을 하고, 종료코드는 0입니다. 이 셋 중 어느 것도 일이 실제로 되었다는 증거가 아닙니다.

도구가 다르고 쓰는 언어가 달라도 증상은 같습니다. 자기가 만든 테스트를 자기가 통과시키고, 그 결과를 성공이라고 보고합니다. 진짜 문제는 그 보고가 틀렸다는 것이 아니라, 틀렸는지 확인할 방법이 우리 쪽에 없다는 것입니다.

이 책은 "됐다 / 안 됐다"의 2단 판정을 버리고 7단계 등급으로 봅니다. 등급을 나누면 두 가지가 생깁니다. 지금 몇 칸에 서 있는지 말할 수 있게 되고, 다음에 무엇을 붙여야 한 칸 올라가는지가 정해집니다.

중요한 건 5칸과 6칸의 차이입니다. 돌았다는 것과 결과가 맞다는 것은 다릅니다. 대부분의 파이프라인은 여기서 멈춰 있으면서 완료라고 부릅니다.

각 장은 같은 순서로 씌어 있습니다 — 증상 → 원인 → 붙일 장치(전문 코드) → 그래도 부족했던 지점. 마지막 절이 있는 이유는, 한계를 감춘 글이 독자를 같은 함정으로 밀어 넣기 때문입니다.

이렇게 보시면 됩니다

• 목차에서 지금 겪고 있는 증상을 찾습니다. 1장부터 읽지 않아도 됩니다.

• 그 장의 코드를 복사해 붙입니다. 의사코드나 "이하 생략"은 넣지 않았습니다.

• 8장의 뮤테이션 드릴로 그 장치가 진짜 작동하는지 확인합니다. 일부러 깨뜨려서 빨간불이 켜지는지 봅니다.

• 빨간불이 안 켜지면 그건 장치가 아니라 장식입니다. 그 판별법이 8장입니다.

앞의 목소리들이 남의 이야기였다면, 위 일곱 건은 이 책과 팩을 만들면서 제 검사 장치가 직접 잡아낸 것입니다. 전부 "완료했습니다" 뒤에 숨어 있었습니다.

국내 매체 분석에도 같은 지적이 있습니다 — "거의 모든 개발자가 AI가 생성한 코드를 완전히 신뢰하지는 않는다"고 하면서도, "커밋 전에 코드를 검토하는 개발자는 아마도 절반도 안 될 것"이라는 것입니다(측정치가 아니라 필자의 관찰입니다). 신뢰하지 않으면서 확인도 하지 않는 상태가 가장 위험합니다.

저는 이 책에 담은 장치들을 제 작업에 붙여 쓰고 있습니다. 달라진 것은 실패가 없어진 게 아닙니다. 실패가 조용히 지나가지 않게 된 것입니다.

이런 분께 권합니다

• Claude Code로 서브에이전트를 실제로 돌려보신 분

• "완료했습니다"를 받고도 직접 열어 확인하느라 시간을 쓰시는 분

• 훅·CLAUDE.md를 써봤지만 몇 턴 뒤 무시되는 것을 겪으신 분

• 팀에 위임 규칙을 세워야 하는데 근거가 필요하신 분

이런 분께는 권하지 않습니다

• Claude Code를 아직 설치하지 않으신 분 — 먼저 써보신 뒤가 좋습니다.

• 설치만 하면 끝나는 완성형 프레임워크를 찾으시는 분 — 이 책은 직접 붙이고 직접 깨뜨려 보는 방식입니다.

• 특정 모델의 최신 기능 정리를 원하시는 분 — 오래 가도록 티어 개념으로 썼습니다.

자주 묻는 질문

Q. 환불이 되나요?
A. 다운로드형 디지털 콘텐츠라 결제 후 취소가 되지 않습니다. 위 목차와 예시를 충분히 보시고 결정해 주세요. 파일이 열리지 않는 등 전달 자체에 문제가 있으면 아래 메일로 연락 주시면 바로 처리해 드립니다.

Q. 난이도가 어느 정도인가요?
A. Claude Code와 CLAUDE.md를 한 번이라도 써보신 개발자 기준입니다. 명령어 설명서가 아니라 운영 방법서라, 완전한 입문자에게는 이릅니다.

Q. 코드는 그대로 돌아가나요?
A. 본문에 실린 코드는 전문을 그대로 실었고, 빈 폴더에 설치해 작동을 확인한 뒤 넣었습니다. 다만 각자의 환경은 다르므로, 8장의 드릴로 본인 환경에서 한 번 확인하시길 권합니다.

Q. 업데이트는요?
A. 무료입니다. 구매하신 메일로 보내 드립니다.

Q. 파일은 어떻게 받나요?
A. 결제 후 바로 다운로드됩니다. 회원가입은 필요하지 않습니다.

Q. 런칭 할인은 언제까지인가요?
A. 2026년 8월 17일까지입니다. 그 뒤에는 정가 29,000원으로 돌아갑니다. 이 기간은 래피드에 타임딜로 걸어 두었기 때문에 제가 손으로 늘리거나 앞당길 수 없습니다. 수량 제한(선착순 N명)은 두지 않았습니다 — 남은 개수를 정직하게 셀 방법이 없어서입니다. 날짜는 셀 수 있어서 날짜로 했습니다.

문의: alphamates.sy@gmail.com