01-개념

01 — 5개 분기와 우선순위

하네스 디버깅 = “어떤 층이 망가졌나”를 빠르게 좁히는 일.

5개 층(Layer)

#	층	의역	증상 키워드
1	Permission	권한층	”권한이 없습니다”, 도구 호출이 막힘
2	Context	컨텍스트층	직전 결정 망각, “어떤 파일?” 반복 질문
3	Tool loop	도구 루프	같은 도구를 무한 호출, 종료 못 함
4	Prompt	프롬프트층	형식 어긋남, 한영 혼합
5	Model	모델층	위 4개 다 정상인데 결과만 이상

근거: 06-harness-engineering/claude-code-harness-anatomy.md, wavespeed-claude-code-harness-breakdown.md, tool-loop-design.md.

우선순위 규칙

“Always check the cheapest layer first.” — safety-rails 의역: “가장 싼 층부터 점검해라.”

순서: 1→2→3→4→5. 위쪽일수록 점검이 빠르고 비용이 작다. 모델층(5)을 먼저 의심하면 시간 낭비가 가장 크다.

한 줄 정리

5개 층을 1번부터 차례로 두드려라. 80%는 1~3번에서 잡힌다.