Trace

개요

Trace는 "왜 이런 결과가 나왔는가?"라는 모호하고 인과적이며 증거가 중요한 질문을 다루는 스킬입니다. 관찰을 재진술하고, 경쟁하는 설명을 생성하고, 병렬로 증거를 수집하고, 설명의 순위를 매기고, 불확실성을 가장 빠르게 줄일 수 있는 다음 조사를 제안합니다.

단순 디버깅 요약이나 코드 수정 루프와 달리, 가설 간 경쟁으로 가장 설득력 있는 설명을 찾습니다.

사용법

/oh-my-claudecode:trace "why is the API returning 500 errors intermittently?"

적합한 사례

• 런타임 버그와 회귀
• 성능/지연/리소스 동작 분석
• 아키텍처 사전/사후 분석
• 실험 결과 추적
• 설정/라우팅/오케스트레이션 동작 설명

핵심 추적 계약

항상 다음 구분을 유지합니다.

1. 관찰 (Observation): 실제로 관찰된 것
2. 가설 (Hypotheses): 경쟁하는 설명들
3. 지지 증거 (Evidence For): 각 설명을 뒷받침하는 것
4. 반증/갭 (Evidence Against): 모순되거나 누락된 것
5. 현재 최선의 설명: 현재 선두 설명
6. 핵심 미지수 (Critical Unknown): 상위 설명을 구분하는 누락된 사실
7. 판별 조사 (Discriminating Probe): 불확실성을 줄일 최고 가치의 다음 단계

기본 가설 레인

3개의 tracer 레인이 팀 모드로 병렬 실행됩니다.

1. 코드 경로/구현 원인: 코드 동작에서 원인 추적
2. 설정/환경/오케스트레이션 원인: 인프라/설정에서 원인 추적
3. 측정/아티팩트/가정 불일치 원인: 관측 자체의 오류 가능성 추적

증거 강도 계층

증거는 순위가 있습니다 (강한 순).

1. 통제된 재현/직접 실험/고유하게 판별하는 아티팩트
2. 엄격한 출처의 1차 소스 아티팩트 (로그, 메트릭, git 히스토리)
3. 같은 설명을 가리키는 여러 독립 소스
4. 단일 소스 코드 경로 또는 동작 추론
5. 약한 정황 단서 (타이밍, 유사성)
6. 직관/유추/추측

반증 라운드

종료 전 선두 가설에 대한 반증 라운드를 실행합니다.

• 비선두 레인이 선두에 대한 최선의 반론 제시
• 선두는 증거로 응답 (주장이 아닌)
• 반론이 선두를 약화시키면 순위 재조정
• 두 가설이 같은 메커니즘으로 수렴하면 병합

관련 스킬

• sciomc - 병렬 연구 오케스트레이션

레퍼런스