02-구조

02. 구조 — 6층 진단 트리

증상 발생
   │
   ▼
[L5] 컨텍스트 층
  ─ 사용량 70%+? → /compact 또는 새 세션
  ─ CLAUDE.md 모순/비대? → 디렉티브 정리
   │
   ▼
[L3] 도구 디스패치 층
  ─ 도구 결과가 모호한 빈 출력? → 명시 메시지로 래핑
  ─ MCP 도구 카탈로그 비대? → 임시 비활성화 후 재현
  ─ 도구 description이 모호? → ACI 재설계
   │
   ▼
[L4] 루프 층
  ─ 무한 루프? → MAX_STEPS, 도구 결과 형식 점검
  ─ 조기 종료? → 사용자 요청 명시도, Plan Mode 상태
  ─ stop_reason은? → tool_use/end_turn/max_tokens 분기 확인
   │
   ▼
[L2] 권한 게이트 층
  ─ 권한 모드는? default/auto/plan/acceptEdits/bubble
  ─ deny/ask가 모델의 행동을 막고 있나? → settings.json 점검
  ─ canUseTool 거부 로그?
   │
   ▼
[L6/hooks] hooks 층
  ─ PreToolUse hook이 차단 중인가? exit code 확인
  ─ PostToolUse hook이 결과를 변형 중인가?
   │
   ▼
[L1] 실행 환경/sandbox 층
  ─ Devcontainer 안인가? 호스트인가?
  ─ 환경변수, 자격 증명, OS 차이?
   │
   ▼
모델 교체 (마지막 수단)

각 층별 “10초 점검”

층	10초 명령
L5 컨텍스트	/cost 또는 사용량 인디케이터 보기
L3 도구	claude --debug에서 tools_available 라인
L4 루프	--debug에서 stop_reason 검색
L2 권한	cat .claude/settings.json 확인
L6 hooks	.claude/hooks/ 디렉터리, 최근 로그
L1 sandbox	pwd, whoami, env