investigate

Investigate — 5 Why 근본 원인 체인 추적

이 커맨드는 gstack의 /investigate를 Jarvis 페르소나·한국어 환경에 맞춰 이식한 것입니다. 목적은 증상 억제가 아니라 근본 원인(root cause) 발견입니다.

---

🎯 발동 조건

• 크론 작업 실패, LaunchAgent 비정상 종료, 봇 무응답 등 장애
• 재현 가능한 버그의 원인 추적
• "왜 실패했어?" / "근본 원인이 뭐야?" / "investigate" 요청

---

🧭 기존 Jarvis 도구와의 역할 구분

세 스킬은 상호 보완 관계입니다. 혼동 금지.

• doctor (증상 레벨) — "지금 다 정상이야?"
• /investigate (원인 레벨) — "왜 실패했지?"
• crisis (조치 레벨) — "봇 죽었어, 일단 살려"

흐름 예: crisis로 지혈 → /investigate로 원인 추적 → doctor로 정기 점검.

---

🏛️ Iron Law

근본 원인 확인 없이 수정 금지 (NO FIXES WITHOUT ROOT CAUSE).

증상만 고치는 수정은 다음 버그를 더 찾기 어렵게 만듭니다.

---

🔗 Phase 0 — 사전 조사

0.1 auto-diagnose 결과 수집

if [ -x ~/jarvis/scripts/auto-diagnose.sh ]; then
  ~/jarvis/scripts/auto-diagnose.sh --json > /tmp/investigate-symptoms.json
fi

이 결과는 증상 스냅샷입니다. 이 스킬의 역할은 원인 체인을 찾는 것.

0.2 오답노트 스캔

if [ -f ~/jarvis/runtime/wiki/meta/learned-mistakes.md ]; then
  grep -A 3 -i "$KEYWORD" ~/jarvis/runtime/wiki/meta/learned-mistakes.md || true
fi

과거 패턴 매칭 시 주인님께 즉시 보고: "이전 학습된 실수 패턴과 유사합니다. 파일: [경로], 발생일: [날짜]."

---

📋 Phase 1 — 근본 원인 조사

1.1 증상 수집

• 에러 메시지, 스택 트레이스, 재현 절차 전문 확보
• AskUserQuestion으로 한 번에 하나씩 질문
• 로그: ~/.jarvis/logs/, ~/Library/Logs/jarvis/

1.2 코드 경로 추적

• Grep으로 증상 발생 지점부터 역방향 추적
• Read로 각 호출 지점 로직 확인
• 전체 파일 읽기 금지 — Serena MCP 활용

1.3 최근 변경 확인 (회귀)

git log --oneline -20 -- <파일>
git diff HEAD~5 -- <파일>

이전에 동작했다면 회귀(regression). 근본 원인은 diff 안에 있습니다.

1.4 결정론적 재현

• 타이밍 의존 → 경쟁 상태
• 환경 의존 → 환경 변수 / DB 상태 / 캐시
• 재현 불가 버그에 추측 수정 금지. 로깅 추가 → 다음 발생 대기.

1.5 5 Why 체인

증상: 크론 작업 실패 (exit 1)
  └─ 왜? 스크립트 내 source 명령 실패
    └─ 왜? 설정 파일이 없음
      └─ 왜? launchd가 cwd를 $HOME로 설정
        └─ 왜? plist에 WorkingDirectory 누락
          └─ 왜? 초기 작성 시 체크리스트 없었음 ← 구조적 근본 원인

5단계 도달 전 멈추지 마십시오. 3단계에서 멈추면 증상 수정.

---

🧪 Phase 2 — 패턴 매칭

알려진 패턴:

• 경쟁 상태: 간헐적, 타이밍 의존, 공유 상태 동시 접근
• Null 전파: NoneType, TypeError, 옵셔널 가드 누락
• 상태 손상: 부분 업데이트, 트랜잭션, 콜백
• 통합 실패: 타임아웃, 외부 API, 서비스 경계
• 설정 드리프트: 로컬 OK, 프로덕션 실패, env vars / DB 상태
• 캐시 오염: 오래된 데이터, Redis / CDN / 브라우저