error-detective

# Error Detective - Systematic Debugging and Error Resolution

## 개요 (Overview)

Error Detective는 에러를 효율적으로 식별, 분석 및 해결하기 위해 체계적인 방법론을 적용하는 종합적인 디버깅 SKILL입니다. TRACE 프레임워크와 구조화된 분석 기법을 사용하여 에러의 초기 발견부터 검증된 해결까지 디버깅 과정을 안내합니다.

## 핵심 역량 (Core Capabilities)

### 스택 트레이스 분석 (Stack Trace Analysis)
- 여러 언어에 걸친 스택 트레이스 파싱 및 해석
- 근본 원인(root cause)과 증상 에러(symptom errors) 구분
- 관련 파일 경로 및 라인 번호 추출
- 호출 체인 및 에러 전파 과정 이해

### 에러 패턴 인식 (Error Pattern Recognition)
- 유형별 에러 분류 (syntax, runtime, logic, integration)
- 공통 에러 패턴 및 안티 패턴 식별
- 프레임워크별 특화 에러 인식
- 에러를 발생 가능한 근본 원인에 매핑

### 근본 원인 분석 (Root Cause Analysis)
- 증상과 기저 이슈의 구분
- 에러 체인을 따라 원래 발생 지점 추적
- 환경 이슈와 코드 이슈의 실별
- 설정 및 종속성 문제 감지

### 디버깅 워크플로우 관리
- 구조화된 조사 프로세스
- 가설 생성 및 테스트
- 이해도에 대한 반복적 정밀화
- 조사 결과 및 해결책 문서화

## TRACE 프레임워크

TRACE는 어떤 에러든 디버깅할 수 있는 체계적인 5단계 접근 방식입니다:

### T - Trace the Error (에러 추적)
**목표**: 완전한 에러 정보와 컨텍스트 캡처

1. **전체 에러 메시지 수집**
   - 전체 스택 트레이스 (처음 몇 줄만이 아닌 전체)
   - 에러 유형 및 메시지
   - 타임스탬프 및 발생 빈도
   - 에러가 발생한 환경

2. **에러 위치 식별**
   - 정확한 파일 및 라인 번호
   - 에러가 발생한 함수 또는 메서드
   - 코드 컨텍스트 (주변 라인)
   - 진입점부터 에러 지점까지의 호출 스택

3. **재현 단계 갈무리**
   - 재현을 위한 최소한의 단계
   - 사용된 입력 데이터 또는 파라미터
   - 기대 결과 vs. 실제 동작
   - 재현의 일관성 (항상 발생, 간헐적 발생, 드물게 발생)

### R - Read the Error Message (에러 메시지 읽기)
**목표**: 에러 자체에서 모든 정보 추출

1. **에러 구성 요소 파싱**
   - 에러 유형/클래스 (TypeError, ValueError 등)
   - 에러 메시지 내용
   - 권장 수정 사항 (제공되는 경우)
   - 관련 에러 또는 경고

2. **에러 시맨틱 이해**
   - 해당 언어/프레임워크에서 해당 에러 유형이 의미하는 바
   - 어떤 조건이 이 에러를 유발하는지
   - 에러 메시지가 구체적으로 무엇을 말하고 있는지
   - 에러 코드 또는 상태 코드

3. **에러 카테고리 식별**
   - Syntax error (코드 파싱 불가)
   - Runtime error (실행 중 크래시 발생)
   - Logic error (결과가 틀림, 크래시 없음)
   - Integration error (외부 시스템 실패)
   - Performance error (타임아웃, 리소스 고갈)

### A - Analyze the Context (컨텍스트 분석)
**목표**: 에러 주변의 더 넓은 컨텍스트 이해

1. **코드 분석**
   - 실패한 라인과 주변 코드 검토
   - 해당 코드의 최근 변경 사항 확인
   - 함수/메서드 시그니처 및 사용법 검토
   - 실패한 코드를 호출하거나 호출되는 관련 코드 검토

2. **데이터 분석**
   - 실패 시점의 입력값 조사
   - 데이터 타입 및 구조 확인
   - 데이터가 예상된 형식/제약 사항을 충족하는지 검증
   - 엣지 케