name: debug
description: 버그, 에러, 크래시, 비정상 동작 발생 시 자동 활성화됩니다. 재현→진단→최소 수정→리그레션 검증 순서로 진행합니다.

디버깅 해결사

활성화 조건

• 런타임 에러, 크래시, 비정상 동작
• 테스트 실패 및 리그레션
• 간헐적 실패/레이스 컨디션

모드

1) full-debug (기본)

모듈 경계를 넘나드는 깊은 조사.

2) focused-debug

빠른 수정/근본 원인/핫픽스를 명시적으로 요청할 때.

Thinking Cycle (필수)

모든 작업에 사고 사이클을 적용한다. 상세: ../_shared/resources/thinking-cycle.md

1. 질문: 실행 전 최소 1개 소크라테스 질문 → 답변 전 진행 금지
2. 결정: 트레이드오프 존재 시 선택지 제시 → 근거 있는 선택 요구
3. 실행: Phase 0, 1 완료 후에만 진입
4. 코드 리딩: 변경 코드 이해도 점검 (레벨 C 기본)
5. 회고: 작업 완료 후 사용자 회고 → .claude/reflections/YYYY-MM-DD.md에 기록

핵심 규칙

1. 재현 우선: 먼저 재현하고, 그 다음 진단.
2. 근본 원인 수정: 증상이 아닌 원인을 고친다.
3. 최소 안전 변경: 영향 범위를 최소화한 수정 적용.
4. 리그레션 검증: 수정 후 회귀 테스트 추가.
5. 유사 패턴 스캔: 같은 패턴이 다른 곳에도 있는지 확인.

실행 절차

1. 에러 정보 수집 (로그, 스택트레이스, 환경)
2. 버그 재현 (최소 재현 케이스 구성)
3. 근본 원인 진단 (코드 추적, 참조 심볼 분석)
4. 최소 수정안 제안 → 사용자 확인 필수
5. 수정 적용 및 리그레션 테스트 작성
6. 유사 패턴 스캔
7. 버그 문서화

보고 형식

## 버그 리포트
- **증상**: [관찰된 동작]
- **근본 원인**: [왜 발생했는지]
- **수정**: [적용한 변경]
- **리그레션 테스트**: [추가한 테스트]
- **유사 패턴**: [발견된 유사 케이스]

참조 리소스

resources/ 참조:
- 실행 프로토콜: execution-protocol.md
- 디버깅 체크리스트: debugging-checklist.md
- 보고 템플릿: report-template.md
- 버그 보고 템플릿: bug-report-template.md
- 공통 패턴: common-patterns.md
- 에러 대응: error-playbook.md