Research

/solve

v2

Systematic problem resolution — 오답노트 체계적 해결 사이클.

사용법

/solve

Claude Code CLI 또는 연결된 에이전트에서 호출합니다.

상세 설명

/solve — 오답노트 체계적 해결 사이클

문제를 발견하면 KG에 기록하고, 병렬 리서치로 해결책을 찾아 KG에 구축한 뒤, 계획을 세워 실행하고 검증하는 7단계 사이클.

**KG 방법론 노드**: `lesson-resolution-methodology`
**KG 온톨로지**: `lesson-resolution-ontology`

입력 형식

```
/solve <문제 설명>           # 새 문제 등록 + 해결
/solve lesson-XXX            # 기존 Lesson 해결
/solve --status              # 미해결 오답노트 현황
/solve --stress              # 스트레스 테스트 실행
```

7단계 사이클

### Step 1: 발견 → KG에 Lesson 즉시 기록

새 문제인 경우:
```cypher
-- 다음 lesson 번호 확인
MATCH (l:Lesson) WHERE l.name STARTS WITH 'lesson-'
RETURN l.name ORDER BY l.name DESC LIMIT 1

-- Lesson 생성
MERGE (l:AbstractNode:Lesson {name: 'lesson-XXX'})
SET l.category = '카테고리',
    l.problem = '문제 설명',
    l.wrongAssumption = '잘못된 가정',
    l.truth = '실제 진실 (아직 모르면 null)',
    l.solution = '해결법 (아직 모르면 null)',
    l.severity = 'CRITICAL/HIGH/MEDIUM/LOW',
    l.resolved = false,
    l.createdAt = datetime()
```

기존 Lesson인 경우:
```cypher
MATCH (l:Lesson {name: $lessonName})
RETURN l.problem, l.severity, l.resolved,
       [(l)-[:HAS_RESEARCH]->(r) | r.recommendation][0] as research,
       [(l)-[:HAS_PLAN]->(p) | p.action][0] as plan
```

### Step 2: 환경 조사 (해결 전 이해)

```bash
# 현재 클러스터 상태
kubectl get pods -A --no

/solve --status 실행시

```cypher
-- 미해결 오답노트
MATCH (l:Lesson) WHERE l.resolved IS NULL OR l.resolved = false
OPTIONAL MATCH (l)-[:HAS_PLAN]->(p:ActionPlan)
RETURN l.name, l.severity, l.problem, p.phase, p.priority
ORDER BY l.severity

-- Phase별 진행 현황
MATCH (p:MigrationPhase)
OPTIONAL MATCH (p)-[:RESOLVES]->(l:Lesson)
WITH p.displayName as phase, p.status as status,
     count(l) as total, sum(CASE WHEN l.resolved = true THEN 1 ELSE 0 END) as done
RETURN phase, status, done + '/' + total as progress
ORDER BY phase
```

/solve --stress 실행시

4단계 검증 전체 실행:
1. Pod 상태 확인 (kubectl get pods -A)
2. DB 4개 연결 테스트
3. hey 부하 테스트 (Traefik, 주요 서비스)
4. check-host.net 글로벌 테스트
5. Pod 삭제 복원력 테스트
6. 결과 KG StressTestResult에 기록

핵심 원칙

1. **해결 전 이해** — 환경 조사 없이 해결 시도 금지
2. **계획 먼저** — ActionPlan 없이 실행 금지
3. **KG가 진실의 원천** — 모든 발견, 리서치, 계획, 실행 결과는 KG에
4. **병렬 리서치** — haiku 에이전트로 비용 효율적 대량 검색
5. **검증 필수** — 내부/외부/스트레스/KG정합성 4단계

KG 온톨로지 구조

```
LessonResolutionOntology
├── HAS_DOMAIN → ResolutionDomain (4개)
│   └── BELONGS_TO_DOMAIN ← Lesson, DocumentRef
├── HAS_PHASE → MigrationPhase (Phase 0→1→2→3)
│   └── RESOLVES → Lesson
├── HAS_DECISION → TechnologyDecision (9개)
│   ├── SOLVES → Lesson
│   ├── HAS_BENCHMARK → Benchmark
│   ├── HAS_COMPARISON → TechComparison
│   └── APPLIED_IN → MigrationPhase
└── FOLLOWS_METHODOLOGY → Methodology

Lesson
├── HAS_RESEARCH → ResearchFinding
├── HAS_PLAN → ActionPlan
└── BELONGS_TO_DOMAIN → ResolutionDomain

StressTestResult ← PRODUCED ─ Methodology
                 ─ DISCOVERED → Lesson (새 발견)
```

메타데이터

name solve
version 2
description >
# KG ATOM_Skill_solve

같은 카테고리