1인 개발자로서 여러 제품에 걸쳐 Claude Code를 매일 사용해 왔습니다. 어떤 작업이든 마지막 20%를 처리하는 데 처음 80%를 하는 것보다 더 오랜 시간이 걸리곤 했는데, 마침내 그 이유를 알아냈습니다. 저는 계속해서 "이것을 마무리해줘 / 버그를 수정해줘"와 같은 모호한 프롬프트(prompt)를 던지며 모델이 자유롭게 실행되도록 내버려 두었습니다. 그 결과 모델은 세 가지 문제를 절반만 고쳐놓고, 네 번째 문제는 조용히 퇴보(regress)시키곤 했습니다. 이 루프를 끊어준 세 가지 규칙은 다음과 같습니다:

1. 프롬프트당 하나의 구체적인 실패 사례만 다룰 것. "버그를 수정해줘"가 아니라 "장바구니가 비어있을 때 결제 버튼을 누르면 충돌이 발생합니다. 여기 트레이스(trace)가 있으니 이것만 수정하세요"라고 해야 합니다. 실제로 작동하는지 확인한 다음, 그다음 사례로 넘어가세요. 속도는 더 느리게 느껴질 수 있지만, 결과적으로 훨씬 더 빠릅니다.

2. 버그를 기록만 하고 아무것도 수정하지 않는 단계를 한 번 거칠 것. 문제를 찾는 도중에 수정을 시작하는 순간, 전체적인 지도(map)를 잃어버리고 사이드 퀘스트(side quests)로 빠져들게 됩니다. 먼저 모든 것을 찾아낸 다음, 우선순위를 정하십시오(triage).

3. 모델이 매 세션 시작 시 읽을 수 있는 실행 중인 결정 문서(decisions doc)를 작성할 것. 컨텍스트(context)가 압축될 때마다 모델은 왜 그런 결정을 내렸는지 잊어버리고, 3일 전에 이미 결정된 사항을 다시 논쟁하려 듭니다. 결정을 한 번 글로 적어두면 그런 논쟁을 영구적으로 끝낼 수 있습니다.

이 중 어느 것도 영리한 방법은 아닙니다. "테스트하기에 충분히 괜찮은" 상태란 해피 패스(happy path)가 처음부터 끝까지 실행되는 것을 의미하며, 그것이 실현될 때까지 미적인 부분은 무시하십시오. 다른 사람들은 마지막 단계(last mile)를 위해 무엇을 사용하는지 궁금합니다. 단순히 "프롬프트를 더 강하게" 입력하는 것 말고 다른 방법이 있을까요?