디버깅 결정 트리

목차

• 01 — 5개 분기와 우선순위
• 02 — 결정 트리(텍스트 다이어그램)
• 03 — 분기별 명령어/체크
• anti-patterns
• checklist
• references

디버깅 결정 트리

“Debugging an LLM agent is debugging the harness, not the model.” 의역: “에이전트 디버깅은 모델이 아니라 하네스(Harness)를 디버깅하는 일이다.” — Wavespeed, Claude Code Harness Breakdown

한 줄 요약

“클로드가 이상해요”의 80%는 5개 분기로 좁혀진다. 결정 트리(Decision Tree) 한 장으로 답을 찾는다.

누구를 위한 챕터

• 클로드가 갑자기 멍청해진 개발자
• 실패가 모델 탓인지, 컨텍스트 탓인지, 권한 탓인지 헷갈리는 사람

선수 지식

• Part 2/08 — 하네스 디버깅 체크리스트
• Part 5/12 — 디버깅·트러블슈팅 가이드

구성

• 01-개념.md — 5개 분기와 우선순위
• 02-구조.md — 결정 트리(텍스트 다이어그램)
• 03-실전.md — 분기별 명령어/체크
• examples/, cases/
• anti-patterns.md, checklist.md, references.md

빌드 명령

ralph: compile-wiki --part part11-치트시트 --chapter 04-디버깅-결정-트리 until verifier passes