triflux 0.0.1 → 2.0.1

package/scripts/mcp-check.mjs

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+// MCP 인벤토리 — 백그라운드 비동기 실행
+// Codex/Gemini의 MCP 서버 상태를 캐싱하여 cli-route.sh가 동적 힌트 생성에 사용
+//
+// 출력: ~/.claude/cache/mcp-inventory.json
+// 사용: cli-route.sh의 get_mcp_hint()에서 읽음
+
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+import { execSync } from "child_process";
+
+const CACHE_DIR = join(homedir(), ".claude", "cache");
+const CACHE_FILE = join(CACHE_DIR, "mcp-inventory.json");
+
+function getCodexMcp() {
+  try {
+    const output = execSync("codex mcp list", {
+      encoding: "utf8",
+      timeout: 15000,
+      stdio: ["pipe", "pipe", "ignore"], // stderr 무시 (Windows 호환)
+    });
+    // 테이블 파싱: 첫 줄 헤더, 이후 줄에서 Name과 Status 추출
+    const lines = output.trim().split(/\r?\n/).filter(l => l.trim());
+    if (lines.length < 2) return [];
+
+    const servers = [];
+    for (let i = 1; i < lines.length; i++) {
+      const cols = lines[i].split(/\s{2,}/);
+      if (cols.length >= 2) {
+        const name = cols[0].trim();
+        // Status는 마지막에서 2번째 컬럼 근처
+        const statusMatch = lines[i].match(/\b(enabled|disabled)\b/i);
+        const status = statusMatch ? statusMatch[1].toLowerCase() : "unknown";
+        if (name && !name.startsWith("-")) {
+          servers.push({ name, status });
+        }
+      }
+    }
+    return servers;
+  } catch {
+    return null; // codex 미설치 또는 타임아웃
+  }
+}
+
+function getGeminiMcp() {
+  try {
+    const settingsPath = join(homedir(), ".gemini", "settings.json");
+    if (!existsSync(settingsPath)) return null;
+
+    const settings = JSON.parse(readFileSync(settingsPath, "utf8"));
+    const mcpServers = settings.mcpServers || {};
+    return Object.keys(mcpServers).map(name => ({
+      name,
+      status: "configured",
+    }));
+  } catch {
+    return null;
+  }
+}
+
+function main() {
+  if (!existsSync(CACHE_DIR)) mkdirSync(CACHE_DIR, { recursive: true });
+
+  const inventory = {
+    timestamp: new Date().toISOString(),
+    codex: { available: false, servers: [] },
+    gemini: { available: false, servers: [] },
+  };
+
+  // Codex MCP
+  const codexServers = getCodexMcp();
+  if (codexServers !== null) {
+    inventory.codex.available = true;
+    inventory.codex.servers = codexServers;
+  }
+
+  // Gemini MCP
+  const geminiServers = getGeminiMcp();
+  if (geminiServers !== null) {
+    inventory.gemini.available = true;
+    inventory.gemini.servers = geminiServers;
+  }
+
+  writeFileSync(CACHE_FILE, JSON.stringify(inventory, null, 2));
+}
+
+main();

package/scripts/setup.mjs

@@ -0,0 +1,215 @@
+#!/usr/bin/env node
+// triflux 세션 시작 시 자동 설정 스크립트
+// - cli-route.sh를 ~/.claude/scripts/에 동기화
+// - hud-qos-status.mjs를 ~/.claude/hud/에 동기화
+// - skills/를 ~/.claude/skills/에 동기화
+
+import { copyFileSync, mkdirSync, readFileSync, writeFileSync, readdirSync, existsSync, chmodSync, unlinkSync } from "fs";
+import { join, dirname } from "path";
+import { homedir } from "os";
+
+const PLUGIN_ROOT = dirname(dirname(new URL(import.meta.url).pathname)).replace(/^\/([A-Z]:)/, "$1");
+const CLAUDE_DIR = join(homedir(), ".claude");
+
+// ── 파일 동기화 ──
+
+const SYNC_MAP = [
+  {
+    src: join(PLUGIN_ROOT, "scripts", "cli-route.sh"),
+    dst: join(CLAUDE_DIR, "scripts", "cli-route.sh"),
+    label: "cli-route.sh",
+  },
+  {
+    src: join(PLUGIN_ROOT, "hud", "hud-qos-status.mjs"),
+    dst: join(CLAUDE_DIR, "hud", "hud-qos-status.mjs"),
+    label: "hud-qos-status.mjs",
+  },
+];
+
+function getVersion(filePath) {
+  try {
+    const content = readFileSync(filePath, "utf8");
+    const match = content.match(/VERSION\s*=\s*"([^"]+)"/);
+    return match ? match[1] : null;
+  } catch {
+    return null;
+  }
+}
+
+let synced = 0;
+
+for (const { src, dst, label } of SYNC_MAP) {
+  if (!existsSync(src)) continue;
+
+  const dstDir = dirname(dst);
+  if (!existsSync(dstDir)) {
+    mkdirSync(dstDir, { recursive: true });
+  }
+
+  if (!existsSync(dst)) {
+    copyFileSync(src, dst);
+    try { chmodSync(dst, 0o755); } catch {}
+    synced++;
+  } else {
+    const srcVersion = getVersion(src);
+    const dstVersion = getVersion(dst);
+    if (srcVersion && dstVersion && srcVersion !== dstVersion) {
+      copyFileSync(src, dst);
+      try { chmodSync(dst, 0o755); } catch {}
+      synced++;
+    }
+  }
+}
+
+// ── 스킬 동기화 ──
+
+const skillsSrc = join(PLUGIN_ROOT, "skills");
+const skillsDst = join(CLAUDE_DIR, "skills");
+
+if (existsSync(skillsSrc)) {
+  for (const name of readdirSync(skillsSrc)) {
+    const src = join(skillsSrc, name, "SKILL.md");
+    if (!existsSync(src)) continue;
+
+    const dstDir = join(skillsDst, name);
+    const dst = join(dstDir, "SKILL.md");
+
+    if (!existsSync(dstDir)) mkdirSync(dstDir, { recursive: true });
+
+    if (!existsSync(dst)) {
+      copyFileSync(src, dst);
+      synced++;
+    } else {
+      const srcContent = readFileSync(src, "utf8");
+      const dstContent = readFileSync(dst, "utf8");
+      if (srcContent !== dstContent) {
+        copyFileSync(src, dst);
+        synced++;
+      }
+    }
+  }
+}
+
+// ── settings.json statusLine 자동 설정 ──
+
+const settingsPath = join(CLAUDE_DIR, "settings.json");
+const hudPath = join(CLAUDE_DIR, "hud", "hud-qos-status.mjs");
+
+if (existsSync(hudPath)) {
+  try {
+    let settings = {};
+    if (existsSync(settingsPath)) {
+      settings = JSON.parse(readFileSync(settingsPath, "utf8"));
+    }
+
+    // statusLine이 없거나 hud-qos-status.mjs를 가리키지 않는 경우에만 설정
+    const currentCmd = settings.statusLine?.command || "";
+    if (!currentCmd.includes("hud-qos-status.mjs")) {
+      const nodePath = process.execPath.replace(/\\/g, "/");
+      const hudForward = hudPath.replace(/\\/g, "/");
+
+      // Windows: 경로에 공백이 있으면 큰따옴표 감싸기
+      const nodeRef = nodePath.includes(" ") ? `"${nodePath}"` : nodePath;
+      const hudRef = hudForward.includes(" ") ? `"${hudForward}"` : hudForward;
+
+      settings.statusLine = {
+        type: "command",
+        command: `${nodeRef} ${hudRef}`,
+      };
+
+      writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n", "utf8");
+      synced++;
+    }
+  } catch {
+    // settings.json 파싱 실패 시 무시 — 기존 설정 보존
+  }
+}
+
+// ── HUD 에러 캐시 자동 클리어 (업데이트/재설치 시) ──
+
+const cacheDir = join(CLAUDE_DIR, "cache");
+const staleFiles = [
+  "claude-usage-cache.json",
+  ".claude-refresh-lock",
+  "codex-rate-limits-cache.json",
+];
+
+for (const name of staleFiles) {
+  const fp = join(cacheDir, name);
+  if (!existsSync(fp)) continue;
+  try {
+    const content = readFileSync(fp, "utf8");
+    const parsed = JSON.parse(content);
+    // 에러 상태이거나 락 파일이면 삭제 → 새 세션에서 fresh start
+    if (parsed.error || name.startsWith(".")) {
+      unlinkSync(fp);
+      synced++;
+    }
+  } catch {
+    // 파싱 실패 파일도 삭제
+    try { unlinkSync(fp); } catch {}
+  }
+}
+
+// ── MCP 인벤토리 백그라운드 갱신 ──
+
+import { spawn } from "child_process";
+
+const mcpCheck = join(PLUGIN_ROOT, "scripts", "mcp-check.mjs");
+if (existsSync(mcpCheck)) {
+  const child = spawn(process.execPath, [mcpCheck], {
+    detached: true,
+    stdio: "ignore",
+  });
+  child.unref(); // 부모 프로세스와 분리 — 비동기 실행
+}
+
+// ── postinstall 배너 (npm install 시에만 출력) ──
+
+if (process.env.npm_lifecycle_event === "postinstall") {
+  const G = "\x1b[32m";
+  const C = "\x1b[36m";
+  const Y = "\x1b[33m";
+  const D = "\x1b[2m";
+  const B = "\x1b[1m";
+  const R = "\x1b[0m";
+
+  const ver = (() => {
+    try {
+      return JSON.parse(readFileSync(join(PLUGIN_ROOT, "package.json"), "utf8")).version;
+    } catch { return "?"; }
+  })();
+
+  console.log(`
+${B}╔═══════════════════════════════════════════════╗${R}
+${B}║${R}  ${C}triflux${R} ${D}v${ver}${R} ${B}— Setup Complete${R}             ${B}║${R}
+${B}╚═══════════════════════════════════════════════╝${R}
+
+  ${G}✓${R} cli-route.sh     → ~/.claude/scripts/
+  ${G}✓${R} hud-qos-status   → ~/.claude/hud/
+  ${G}✓${R} ${synced > 0 ? synced + " files synced" : "all files up to date"}
+  ${G}✓${R} HUD statusLine   → settings.json
+
+${B}Commands:${R}
+  ${C}triflux${R} setup     파일 동기화 + HUD 설정
+  ${C}triflux${R} doctor    CLI 진단 (Codex/Gemini 확인)
+  ${C}triflux${R} list      설치된 스킬 목록
+  ${C}triflux${R} update    최신 버전으로 업데이트
+
+${B}Shortcuts:${R}
+  ${C}tfx${R}                 triflux 축약
+  ${C}tfx-setup${R}            triflux setup
+  ${C}tfx-doctor${R}           triflux doctor
+
+${B}Skills (Claude Code):${R}
+  ${C}/tfx-auto${R}   "작업"   자동 분류 + 병렬 실행
+  ${C}/tfx-codex${R}  "작업"   Codex 전용 모드
+  ${C}/tfx-gemini${R} "작업"   Gemini 전용 모드
+  ${C}/tfx-setup${R}           HUD 설정 + 진단
+
+${Y}!${R} 세션 재시작 후 스킬이 활성화됩니다
+${D}https://github.com/tellang/triflux${R}
+`);
+}
+
+process.exit(0);

package/skills/auto-verify/SKILL.md

@@ -0,0 +1,145 @@
+---
+name: auto-verify
+description: OMC 실행 모드 완료 후 자동으로 verify 스킬을 생성/업데이트하고, 통합 검증을 실행합니다. autopilot/team/ralph 완료 시점 또는 커밋 전에 사용.
+argument-hint: "[선택사항: skip-manage | skip-verify | full]"
+---
+
+# auto-verify — OMC 연동 자동 검증
+
+## 목적
+
+OMC 워크플로우(autopilot, team, ralph, executor 등) 완료 후 **한 번의 호출로** 스킬 관리 + 검증을 자동 수행합니다:
+
+1. `/manage-skills` 실행 → 세션 변경사항 기반 verify 스킬 자동 생성/업데이트
+2. `/verify-implementation` 실행 → 생성된 스킬 포함 전체 검증
+3. 이슈 발견 시 수정 제안 → 사용자 승인 → 재검증
+
+## OMC 호환
+
+```
+[OMC 실행 모드]
+  │
+  ├─ /autopilot 완료 후 → /auto-verify
+  ├─ /team team-verify 단계 → /auto-verify
+  ├─ /ralph 각 이터레이션 후 → /auto-verify
+  ├─ executor/deep-executor 완료 후 → /auto-verify
+  └─ 커밋 전 (수동) → /auto-verify
+```
+
+**OMC team-verify 단계에서의 실행 순서:**
+
+```
+team-verify:
+  1. /auto-verify              ← 프로젝트 고유 규칙 검증 (이 스킬)
+  2. OMC verifier (sonnet)     ← 범용 완료성 검증
+  3. OMC code-reviewer (opus)  ← 심층 코드 리뷰 (20+ 파일 시)
+  4. ask_codex (security)      ← 보안 분석 (MCP, 필요 시)
+```
+
+## 워크플로우
+
+### Step 1: 모드 감지 및 옵션 파싱
+
+인수 확인:
+- `skip-manage`: manage-skills 단계 건너뛰기 (이미 실행한 경우)
+- `skip-verify`: verify-implementation 건너뛰기 (스킬 업데이트만)
+- `full` 또는 인수 없음: 전체 실행 (기본값)
+
+현재 OMC 상태 확인 (선택적):
+
+```bash
+# OMC 실행 모드 상태 확인 (있으면 컨텍스트로 활용)
+cat .omc/state/team-state.json 2>/dev/null
+cat .omc/state/autopilot-state.json 2>/dev/null
+cat .omc/state/ralph-state.json 2>/dev/null
+```
+
+### Step 2: 변경사항 규모 평가
+
+```bash
+# 변경된 파일 수 확인
+git diff HEAD --name-only | wc -l
+git diff main...HEAD --name-only 2>/dev/null | wc -l
+```
+
+규모에 따른 동작 조정:
+- **소규모 (1-5 파일)**: manage-skills + verify-implementation 순차 실행
+- **중규모 (6-20 파일)**: manage-skills 실행 → verify-implementation 실행
+- **대규모 (20+ 파일)**: manage-skills 실행 → verify-implementation 실행 후 OMC code-reviewer 권장
+
+### Step 3: manage-skills 실행
+
+`skip-manage`가 아닌 경우:
+
+1. `/manage-skills` 스킬의 워크플로우를 실행
+2. 새로 생성/업데이트된 스킬 목록 기록
+3. CLAUDE.md Skills 테이블 동기화 확인
+
+**표시:**
+
+```markdown
+## 스킬 관리 완료
+
+- 분석된 파일: N개
+- 새 스킬 생성: X개 (verify-<name1>, verify-<name2>)
+- 기존 스킬 업데이트: Y개
+- 면제: Z개
+
+다음 단계: 통합 검증 실행...
+```
+
+### Step 4: verify-implementation 실행
+
+`skip-verify`가 아닌 경우:
+
+1. `/verify-implementation` 스킬의 워크플로우를 실행
+2. Step 3에서 새로 생성된 스킬도 포함하여 전체 검증
+3. 통합 리포트 생성
+
+### Step 5: OMC 에이전트 연계 권장
+
+검증 결과에 따라 OMC 에이전트 후속 작업을 권장:
+
+```markdown
+## 추가 권장 사항
+
+| 조건 | 권장 액션 |
+|------|----------|
+| 보안 관련 이슈 발견 | `ask_codex`(security-reviewer, xhigh)로 심층 분석 |
+| 아키텍처 위반 발견 | `ask_codex`(architect, high)로 구조 리뷰 |
+| UI/프론트 이슈 발견 | `ask_gemini`(designer)로 UI 리뷰 |
+| 20+ 파일 변경 | OMC `/code-review`로 전체 리뷰 |
+| 이슈 없음 | 커밋 준비 완료 ✓ |
+```
+
+### Step 6: 최종 보고서
+
+```markdown
+## Auto-Verify 완료
+
+### 스킬 관리
+- 새 스킬: X개 | 업데이트: Y개
+
+### 검증 결과
+| 스킬 | 상태 | 이슈 |
+|------|------|------|
+| verify-<name> | PASS/FAIL | N개 |
+
+### 전체: PASS ✓ / X개 이슈 발견
+### 다음 단계: [커밋 준비 완료 | 이슈 수정 필요 | OMC 심층 리뷰 권장]
+```
+
+## 예외사항
+
+1. **OMC 실행 모드 상태 파일 없음** — 정상 (독립 실행 지원)
+2. **verify 스킬 0개** — manage-skills만 실행하여 최초 스킬 생성
+3. **git 이력 없음** — 현재 파일 전체 스캔으로 fallback
+4. **MCP 미사용 환경** — OMC 에이전트 권장만 표시, MCP 권장 생략
+
+## 관련 파일
+
+| File | Purpose |
+|------|---------|
+| `.claude/skills/manage-skills/SKILL.md` | 스킬 생성/관리 |
+| `.claude/skills/verify-implementation/SKILL.md` | 통합 검증 실행 |
+| `CLAUDE.md` | Skills 섹션 (자동 동기화 대상) |

package/skills/manage-skills/SKILL.md

@@ -0,0 +1,192 @@
+---
+name: manage-skills
+description: 세션 변경사항을 분석하여 검증 스킬 누락을 탐지합니다. 기존 스킬을 동적으로 탐색하고, 새 스킬을 생성하거나 기존 스킬을 업데이트한 뒤 CLAUDE.md를 관리합니다.
+disable-model-invocation: true
+argument-hint: "[선택사항: 특정 스킬 이름 또는 집중할 영역]"
+---
+
+# manage-skills — 세션 기반 스킬 유지보수
+
+## 목적
+
+현재 세션에서 변경된 내용을 분석하여 검증 스킬의 드리프트를 탐지하고 수정합니다:
+
+1. **커버리지 누락** — 어떤 verify 스킬에서도 참조하지 않는 변경된 파일
+2. **유효하지 않은 참조** — 삭제되거나 이동된 파일을 참조하는 스킬
+3. **누락된 검사** — 기존 검사에서 다루지 않는 새로운 패턴/규칙
+4. **오래된 값** — 더 이상 일치하지 않는 설정값 또는 탐지 명령어
+
+## OMC 호환
+
+이 스킬은 OMC(oh-my-claudecode) 에이전트 시스템과 **보완적**으로 작동합니다:
+
+- **OMC verifier**: 세션 단위 일회성 검증 (매번 코드 분석)
+- **verify 스킬**: 프로젝트별 영구 규칙 기반 검증 (누적 지식)
+- OMC `code-reviewer`, `quality-reviewer` 등은 범용 리뷰 → verify 스킬은 **프로젝트 고유 규칙** 검증
+- 두 시스템을 함께 사용 시: verify 스킬로 프로젝트 규칙 검증 → OMC verifier로 일반 품질 검증
+
+**MCP-First 환경 적용**: verify 스킬의 리포트를 Codex/Gemini CLI에 전달하여 심층 분석 위임 가능.
+
+## 실행 시점
+
+- 새로운 패턴이나 규칙을 도입하는 기능을 구현한 후
+- 기존 verify 스킬을 수정하고 일관성을 점검하고 싶을 때
+- PR 전에 verify 스킬이 변경된 영역을 커버하는지 확인할 때
+- 검증 실행 시 예상했던 이슈를 놓쳤을 때
+- 주기적으로 스킬을 코드베이스 변화에 맞춰 정렬할 때
+
+## 등록된 검증 스킬
+
+현재 프로젝트에 등록된 검증 스킬 목록입니다. 새 스킬 생성/삭제 시 이 목록을 업데이트합니다.
+
+(아직 등록된 검증 스킬이 없습니다)
+
+<!-- 스킬이 추가되면 아래 형식으로 등록:
+| 스킬 | 설명 | 커버 파일 패턴 |
+|------|------|---------------|
+| `verify-example` | 예시 검증 | `src/example/**/*.ts` |
+-->
+
+## 워크플로우
+
+### Step 1: 세션 변경사항 분석
+
+현재 세션에서 변경된 모든 파일을 수집합니다:
+
+```bash
+# 커밋되지 않은 변경사항
+git diff HEAD --name-only
+
+# 현재 브랜치의 커밋 (main에서 분기된 경우)
+git log --oneline main..HEAD 2>/dev/null
+
+# main에서 분기된 이후의 모든 변경사항
+git diff main...HEAD --name-only 2>/dev/null
+```
+
+중복을 제거한 목록으로 합칩니다. 선택적 인수로 스킬 이름이나 영역이 지정된 경우 관련 파일만 필터링합니다.
+
+**표시:** 최상위 디렉토리(첫 1-2 경로 세그먼트) 기준으로 파일을 그룹화합니다:
+
+```markdown
+## 세션 변경사항 감지
+
+**이 세션에서 N개 파일 변경됨:**
+
+| 디렉토리 | 파일 |
+|----------|------|
+| src/components | `Button.tsx`, `Modal.tsx` |
+| src/server | `router.ts`, `handler.ts` |
+```
+
+### Step 2: 등록된 스킬과 변경 파일 매핑
+
+**등록된 검증 스킬** 섹션에 나열된 스킬을 참조하여 파일-스킬 매핑을 구축합니다.
+
+등록된 스킬이 0개인 경우, Step 4로 바로 이동합니다. 모든 변경 파일이 "UNCOVERED"로 처리됩니다.
+
+등록된 스킬이 1개 이상인 경우, 각 스킬의 SKILL.md를 읽고 Related Files, Workflow 섹션에서 파일 경로 패턴을 추출합니다.
+
+```markdown
+### 파일 → 스킬 매핑
+
+| 스킬 | 트리거 파일 | 액션 |
+|------|-----------|------|
+| verify-api | `router.ts`, `handler.ts` | CHECK |
+| (스킬 없음) | `package.json` | UNCOVERED |
+```
+
+### Step 3: 커버리지 갭 분석
+
+영향받은 각 스킬에 대해 SKILL.md를 읽고 점검합니다:
+
+1. **누락된 파일 참조** — 관련 변경 파일이 Related Files에 없는 경우
+2. **오래된 탐지 명령어** — grep/glob 패턴이 현재 파일 구조와 일치하는지
+3. **커버되지 않은 새 패턴** — 스킬이 검사하지 않는 새로운 규칙
+4. **삭제된 파일의 잔여 참조** — 존재하지 않는 파일 참조
+5. **변경된 값** — 특정 값(식별자, 설정 키)이 수정되었는지
+
+### Step 4: CREATE vs UPDATE 결정
+
+```
+커버되지 않은 각 파일 그룹에 대해:
+    IF 기존 스킬의 도메인과 관련:
+        → UPDATE (커버리지 확장)
+    ELIF 3개+ 관련 파일이 공통 패턴 공유:
+        → CREATE (새 verify 스킬)
+    ELSE:
+        → 면제 (스킬 불필요)
+```
+
+`AskUserQuestion`으로 사용자에게 확인합니다.
+
+### Step 5: 기존 스킬 업데이트
+
+**규칙:**
+- 추가/수정만 — 작동하는 기존 검사는 절대 제거하지 않음
+- Related Files 테이블에 새 파일 경로 추가
+- 새 탐지 명령어 추가
+- 삭제 확인된 파일의 참조 제거
+- 변경된 값 업데이트
+
+### Step 6: 새 스킬 생성
+
+**반드시 사용자에게 스킬 이름 확인 후 생성.**
+
+**이름 규칙:**
+- `verify-`로 시작 (예: `verify-auth`, `verify-api`)
+- kebab-case 사용
+
+**필수 섹션:**
+- Frontmatter: name, description
+- **Purpose** — 2-5개 검증 카테고리
+- **When to Run** — 3-5개 트리거 조건
+- **Related Files** — 실제 파일 경로 테이블 (`ls`로 검증)
+- **Workflow** — 검사 단계 (도구, 패턴, PASS/FAIL 기준, 수정 방법)
+- **Output Format** — 마크다운 테이블
+- **Exceptions** — 2-3개 면제 케이스
+
+**연관 파일 자동 업데이트:**
+1. `manage-skills/SKILL.md` — 등록된 검증 스킬 테이블
+2. `verify-implementation/SKILL.md` — 실행 대상 스킬 테이블
+3. `CLAUDE.md` — Skills 섹션 테이블
+
+### Step 7: 검증
+
+1. 수정된 SKILL.md 다시 읽어 마크다운 형식 확인
+2. Related Files 경로 존재 확인: `ls <path> 2>/dev/null || echo "MISSING"`
+3. 탐지 명령어 드라이런으로 문법 검증
+4. 등록 테이블 동기화 확인
+
+### Step 8: 요약 보고서
+
+```markdown
+## 세션 스킬 유지보수 보고서
+
+### 분석된 변경 파일: N개
+### 업데이트된 스킬: X개
+### 생성된 스킬: Y개
+### 업데이트된 연관 파일: [목록]
+### 미커버 변경사항: [면제 사유]
+```
+
+## 관련 파일
+
+| File | Purpose |
+|------|---------|
+| `.claude/skills/verify-implementation/SKILL.md` | 통합 검증 스킬 |
+| `.claude/skills/manage-skills/SKILL.md` | 이 파일 |
+| `CLAUDE.md` | 프로젝트 지침 (Skills 섹션) |
+
+## 예외사항
+
+다음은 **문제가 아닙니다**:
+
+1. **Lock 파일 및 생성된 파일** — `package-lock.json`, `yarn.lock`, 빌드 출력물
+2. **일회성 설정 변경** — 버전 범프, 린터 설정 사소한 변경
+3. **문서 파일** — `README.md`, `CHANGELOG.md`, `LICENSE`
+4. **테스트 픽스처** — `fixtures/`, `test-data/` 디렉토리
+5. **CLAUDE.md 자체** — 문서 업데이트이며 코드 패턴이 아님
+6. **벤더/서드파티 코드** — `vendor/`, `node_modules/`
+7. **CI/CD 설정** — `.github/`, `Dockerfile`
+8. **AI 설정 파일** — `.claude/`, `.omc/`, `.codex/`, `.gemini/` (OMC 호환)