메뉴
가설 트리 관리 — 카테고리, 상태 전이, 분기 규칙, 종료 조건, 우선순위 결정, 전체 기각 시 재생성. 가설 생성, 우선순위 결정, 가설 검증, 가설 분기, 종료 판단 단계에서 가설을 어떻게 구조화하고 관리해야 하는지 판단할 때 반드시 이 스킬을 참조한다. 가설 생성, 검증, 분기, 종료 판단이 언급될 때 사용한다.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | hypothesis-tree |
| description | 가설 트리 관리 — 카테고리, 상태 전이, 분기 규칙, 종료 조건, 우선순위 결정, 전체 기각 시 재생성. 가설 생성, 우선순위 결정, 가설 검증, 가설 분기, 종료 판단 단계에서 가설을 어떻게 구조화하고 관리해야 하는지 판단할 때 반드시 이 스킬을 참조한다. 가설 생성, 검증, 분기, 종료 판단이 언급될 때 사용한다. |
status 값은 하위 호환을 위해 CONFIRMED / REJECTED / NEEDS_INVESTIGATION / CLOSED를 그대로 사용한다. "채택"은 CONFIRMED 상태의 의미론적 표기일 뿐이다.| 카테고리 | 설명 | 대표적 근본원인 |
|---|---|---|
DEPLOYMENT | 최근 코드/설정 배포 관련 | 비효율 코드 경로, 리소스 누수, 설정 오류 |
INFRASTRUCTURE | AWS 인프라 수준 이슈 | 호스트 열화, AZ 장애, 네트워크 파티션 |
TRAFFIC | 트래픽 패턴 변화 | DDoS, 트래픽 급증, 봇 크롤링 |
DEPENDENCY | 외부/내부 의존 서비스 장애 | DB 지연, 외부 API 타임아웃, DNS 실패 |
CONFIGURATION | 런타임 설정 문제 | 잘못된 환경변수, 리소스 한도, IAM 정책 |
PENDING ──(증거 수집)──> NEEDS_INVESTIGATION ──(추가 증거)──> CONFIRMED (채택)
│ ↑
│ (신뢰도 ≥ 0.8)
│
└──(하위 가설 생성)──> [하위 가설들]
PENDING ──(증거 수집)──> REJECTED (기각, 신뢰도 ≤ 0.3)
PENDING/NEEDS_INVESTIGATION ──(Accepted Review Gate 자동)──> REJECTED (기각)
PENDING / NEEDS_INVESTIGATION ──(루프 종료, 예산 소진)──> CLOSED (종료)
종료 상태는 3가지: CONFIRMED(채택), REJECTED(기각), CLOSED(종료). 보고서 생성 전 모든 가설이 이 셋 중 하나여야 한다. CLOSED는 예산 소진 등으로 검증이 완료되지 못한 가설에 사용한다.
부모 가설이 NEEDS_INVESTIGATION (신뢰도 0.3-0.8)일 때:
분기는 본질적으로 부모 가설에 대한 "왜 그게 발생했는가?"의 답이다. 다음 가드레일을 적용한다:
required_evidence는 부모보다 좁고 구체적이어야 한다 (예: 부모 "DB 지연" → 자식 "특정 쿼리 ID의 plan 변경").[DEPLOYMENT] CPU 급등의 원인이 최근 배포 (신뢰도: 0.6, NEEDS_INVESTIGATION)
├── [DEPLOYMENT] 새 코드에 CPU 집약적 루프/알고리즘 도입 (신뢰도: 0.4)
├── [DEPLOYMENT] 새 의존성 라이브러리의 CPU 사용량 증가 (신뢰도: 0.3)
└── [CONFIGURATION] 배포 시 CPU 제한/메모리 설정 변경 (신뢰도: 0.3)
| 조건 | 설명 | 행동 |
|---|---|---|
| REVIEW_GATE_EARLY_EXIT | Accepted Review Gate: 채택 가설 최고 신뢰도 ≥ 0.9 | 매 루프 진입 직전 평가 → 즉시 종료 → 보고서 생성 |
| REVIEW_GATE_GRACE_EXHAUSTED | 비확장 모드 2회 연속에도 < 0.9 | 즉시 종료 → 현재 채택 가설로 보고서 |
| CONFIRMED | 검증 후 가설 신뢰도 ≥ 0.9 | 루프 종료 → 보고서 생성 |
| ALL_REJECTED | 모든 가설 기각, 새 단서 없음 | 재생성 시도 (최대 2회). 비확장 모드에서는 재생성 스킵하고 채택 가설 기반 보고서 |
| TIMEOUT | 분석 8분 초과 | 루프 종료 → 현재 최선 결과로 보고서 |
| MAX_LOOPS | 검증 루프 3회 완료 | 루프 종료 → 현재 최선 결과로 보고서 |
| MAX_DEPTH | 가설 트리 깊이 3 도달 | 더 이상 분기하지 않음, 현재 가설로 판단 |
매 루프 진입 직전에 메인 에이전트가 순수 로직으로 평가하는 게이트. 기존 채택 가설이 있을 때 추가 탐색 필요성을 판단한다.
| 채택 가설 최고 신뢰도 | 결과 |
|---|---|
| ≥ 0.9 | early_exit — 즉시 보고서 생성 |
| 0.8 ~ 0.9 | expansion_blocked — 증거 보강만 허용, 새 분기·재생성 금지 |
| < 0.8 or 없음 | 통상 진행 |
Accepted-유사 자동 기각: 채택 가설이 존재하면 PENDING/NEEDS_INVESTIGATION 중 (같은 category + description Jaccard ≥ 0.6)인 항목은 자동 REJECTED 처리. 동일 원인 영역의 중복 분기를 억제한다.
가설 생성 서브에이전트 가이드 — 스코핑 결과로부터 3-5개 근본원인 가설을 생성하고, rca-progress MCP로 DDB에 저장하고 /tmp에 산출물을 남긴다. Agent tool로 가설 생성 서브에이전트를 스폰할 때 이 스킬을 따른다.
가설 검증 서브에이전트 가이드 — 증거 수집, 신뢰도 평가, 가설 분기, 종료 판단을 수행하고 JSON 산출물로 결과를 기록한다. Agent tool로 가설 검증 서브에이전트를 스폰할 때 이 스킬을 따른다.
rca-progress MCP의 산출물 저장 계약. 파이프라인 단계 결과를 canonical JSON 또는 Markdown 파일로 저장할 때 참조한다.
복구 권고 및 검증 계획 — Healthcare Service 장애 리셋 API와 ECS 강제 배포를 실행하지 않고 후보로 제안하며, 사전조건·승인·롤백·검증 판정 기준을 작성한다. 복구, 리셋, 롤백, 재시작, 검증이 언급될 때 사용한다.
Healthcare 서비스에 장애를 주입하거나 리셋한다. "장애 인젝션", "fault inject", "인젝션", "inject", "db leak", "high cpu", "high memory", "slow query", "커넥션 누수", "CPU 장애", "메모리 장애", "쿼리 장애", "장애 리셋", "fault reset", "장애 테스트", "RCA 테스트" 등의 키워드에 트리거. 장애를 주입하고 CloudWatch 알람이 트리거되어 RCA 에이전트가 자동 분석을 시작하는 E2E 테스트에 사용한다.
AWS 서비스별 증거 수집 패턴 — CloudWatch 메트릭 조회 전략, Logs Insights 쿼리 템플릿, CloudTrail 이벤트 필터. 초기 스코핑 단계와 증거 수집 단계에서 어떤 메트릭을 어떤 순서로 수집해야 하는지 판단할 때 반드시 이 스킬을 참조한다. ECS, RDS, Lambda, ALB 등 서비스 이름이 언급되거나, 메트릭 조회·로그 검색·변경 이력 조회를 수행하려 할 때 사용한다.