oh-my-customcode 0.138.0 → 0.139.0

package/README.md

@@ -13,7 +13,7 @@
 
 **[한국어 문서 (Korean)](./README_ko.md)**
 
-49 agents. 117 skills. 22 rules. One command.
+49 agents. 118 skills. 23 rules. One command.
 
 ```bash
 npm install -g oh-my-customcode && cd your-project && omcustom init
@@ -132,7 +132,7 @@ Each agent declares its tools, model, memory scope, and limitations in YAML fron
 
 ---
 
-### Skills (117)
+### Skills (118)
 
 | Category | Count | Includes |
 |----------|-------|----------|
@@ -210,7 +210,7 @@ All commands are invoked inside the Claude Code conversation.
 
 ---
 
-### Rules (22)
+### Rules (23)
 
 | Priority | Count | Purpose |
 |----------|-------|---------|
@@ -222,7 +222,7 @@ Key rules: R010 (orchestrator never writes files), R009 (parallel execution mand
 
 ---
 
-### Guides (50)
+### Guides (53)
 
 Reference documentation covering best practices, architecture decisions, and integration patterns. Located in `guides/` at project root, covering topics from agent design to CI/CD to observability.
 
@@ -272,7 +272,7 @@ your-project/
 ├── CLAUDE.md                   # Entry point
 ├── .claude/
 │   ├── agents/                 # 49 agent definitions
-│   ├── skills/                 # 117 skill modules
+│   ├── skills/                 # 118 skill modules
 │   ├── rules/                  # 22 governance rules (R000-R021)
 │   ├── hooks/                  # 15 lifecycle hook scripts
 │   ├── schemas/                # Tool input validation schemas

package/dist/cli/index.js

@@ -2334,7 +2334,7 @@ var init_package = __esm(() => {
     workspaces: [
       "packages/*"
     ],
-    version: "0.138.0",
+    version: "0.139.0",
     description: "Batteries-included agent harness for Claude Code",
     type: "module",
     bin: {

package/dist/index.js

@@ -2014,7 +2014,7 @@ var package_default = {
   workspaces: [
     "packages/*"
   ],
-  version: "0.138.0",
+  version: "0.139.0",
   description: "Batteries-included agent harness for Claude Code",
   type: "module",
   bin: {

package/package.json

@@ -3,7 +3,7 @@
   "workspaces": [
     "packages/*"
   ],
-  "version": "0.138.0",
+  "version": "0.139.0",
   "description": "Batteries-included agent harness for Claude Code",
   "type": "module",
   "bin": {

package/templates/.claude/agents/qa-engineer.md

@@ -31,6 +31,13 @@ You are a QA execution specialist that runs tests, identifies defects, and valid
 
 Jest, Vitest, pytest, go test, JUnit, Playwright, Cypress
 
+## Verification Discipline
+
+- Before writing a QA report, grep/read the target code and quote selectors, identifiers, filenames, and commands verbatim from the implementation.
+- Do not invent `data-testid`, DOM selectors, function names, mapping names, or CLI flags from memory.
+- If a browser/MCP/tool call is denied, do not retry the exact same call; switch to an allowed fallback and record the denial.
+- When the same critical launch/runtime error appears twice, stop repeating launches and re-check flag semantics, existing processes, and environment assumptions.
+
 ## Collaboration
 
 Receives from: qa-writer (test cases), qa-planner (priorities). Outputs to: dev-lead (defects), qa-writer (results).

package/templates/.claude/hooks/hooks.json

@@ -90,7 +90,17 @@
             "command": "bash .claude/hooks/scripts/rtk-intercept.sh"
           }
         ],
-        "description": "RTK auto-intercept \u2014 transparently rewrites CLI commands through RTK proxy when available (R015 advisory)"
+        "description": "RTK auto-intercept — transparently rewrites CLI commands through RTK proxy when available (R015 advisory)"
+      },
+      {
+        "matcher": "tool == \"Bash\" && tool_input.command matches \"git (reset|clean|checkout|restore|switch|rebase|merge)\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash .claude/hooks/scripts/destructive-git-guard.sh"
+          }
+        ],
+        "description": "Warn before destructive git commands — advisory recovery guidance (R001/R021)"
       },
       {
         "matcher": "tool == \"Bash\" && tool_input.command matches \"(rm|git rm|mv|unlink|claude/rules)\"",

package/templates/.claude/hooks/scripts/destructive-git-guard.sh

@@ -0,0 +1,60 @@
+#!/bin/bash
+# R001/R021 destructive git guard hook
+# Warns before commands that can discard working tree, untracked files, or branches.
+# Advisory tier only: emits stderr guidance, records PPID-scoped warnings, exits 0.
+#
+# PPID Scoping Convention:
+#   Session-scoped temp files MUST use $PPID (Claude Code parent PID), not $$.
+#   Pattern: /tmp/.claude-{purpose}-${PPID}
+
+input=$(cat)
+if command -v jq >/dev/null 2>&1; then
+  command_text=$(echo "$input" | jq -r '.tool_input.command // ""' 2>/dev/null)
+elif command -v python3 >/dev/null 2>&1; then
+  command_text=$(INPUT_JSON="$input" python3 - <<'PY' 2>/dev/null
+import json, os
+try:
+    data = json.loads(os.environ.get('INPUT_JSON', ''))
+    print(data.get('tool_input', {}).get('command', ''))
+except Exception:
+    print('')
+PY
+)
+else
+  command_text=""
+fi
+
+VIOLATION_FILE="/tmp/.claude-destructive-git-guard-${PPID}"
+matched=""
+
+if printf '%s\n' "$command_text" | grep -Eq '(^|[;&|[:space:]])git[[:space:]]+reset[[:space:]]+--hard([[:space:]]|$)'; then
+  matched="git reset --hard"
+elif printf '%s\n' "$command_text" | grep -Eq '(^|[;&|[:space:]])git[[:space:]]+clean[[:space:]]+([^;&|]*[[:space:]])?-f(dx|xd|d|x)?([[:space:]]|$)'; then
+  matched="git clean"
+elif printf '%s\n' "$command_text" | grep -Eq '(^|[;&|[:space:]])git[[:space:]]+restore([[:space:]]+--[^;&|[:space:]]+)*([[:space:]]+(\.|\*|/|--worktree|--staged))*([[:space:]]|$)'; then
+  matched="git restore"
+elif printf '%s\n' "$command_text" | grep -Eq '(^|[;&|[:space:]])git[[:space:]]+checkout[[:space:]]+--[[:space:]]+(\.|\*|/)([[:space:]]|$)'; then
+  matched="git checkout -- ."
+elif printf '%s\n' "$command_text" | grep -Eq '(^|[;&|[:space:]])git[[:space:]]+branch[[:space:]]+-D([[:space:]]|$)'; then
+  matched="git branch -D"
+fi
+
+if [ -n "$matched" ]; then
+  echo "[Hook] DESTRUCTIVE GIT WARNING: detected '$matched' in Bash command" >&2
+  echo "[Hook] Advisory only (R021): command is not blocked, but it may discard local work." >&2
+  echo "[Hook] Before proceeding, verify git status and preserve work with git stash or a WIP commit." >&2
+  echo "[Hook] Recovery: use 'git reflog' to find prior HEADs; for deleted branches, check 'git reflog --all'." >&2
+
+  if printf '%s\n' "$command_text" | grep -Eq '(^|[;&|[:space:]])git[[:space:]]+branch[[:space:]]+-D([[:space:]]|$)'; then
+    echo "[Hook] Branch deletion note: prefer 'git branch -d' first so Git checks for unmerged commits." >&2
+  fi
+
+  printf '%s %s\n' "$(date -u +%Y-%m-%dT%H:%M:%SZ)" "$matched" >> "$VIOLATION_FILE"
+  violation_count=$(wc -l < "$VIOLATION_FILE" 2>/dev/null | tr -d ' ')
+  if [ "${violation_count:-0}" -ge 3 ]; then
+    echo "[Hook] Destructive git warnings: ${violation_count} this session — R021 promotion threshold reached" >&2
+  fi
+fi
+
+# Always pass through - this hook is advisory only.
+echo "$input"

package/templates/.claude/rules/SHOULD-verification-ladder.md

@@ -0,0 +1,77 @@
+# [SHOULD] Verification Ladder Rules
+
+> **Priority**: SHOULD | **ID**: R023
+
+## Core Rule
+
+검증은 비용/속도 ladder로 구성한다: **결정론적 검사 → cheap LLM → expensive LLM → human**. 가장 저렴한 tier가 먼저 통과해야 다음 tier로 진행한다. 더 낮은 tier에서 잡을 수 있는 문제를 더 비싼 tier에 보내지 않는다.
+
+## Ladder Tiers
+
+| Tier | 도구 | 비용 | 속도 | 적용 시점 |
+|------|------|------|------|-----------|
+| **1: Deterministic** | hooks, linters, type-check, JSON schema | $0 | <1s | Pre-write, write-time |
+| **2: Cheap LLM** | haiku-based skills (`dev-review`, `action-validator`) | $ | <30s | Per-file review |
+| **3: Expensive LLM** | sonnet/opus skills (`deep-verify`, `adversarial-review`, `multi-model-verification`, `evaluator-optimizer`) | $$$ | 1-5분 | Pre-commit, PR review |
+| **4: Human** | maintainer review | time | hours-days | Final gate, contested decisions |
+
+## Shift-left 원칙
+
+결정론적 단계가 잡을 수 있는 문제는 LLM에 보내지 않는다. LLM 검증은 ambiguous/semantic 문제에 집중한다.
+
+- **좋은 예**: JSON schema 오류 → Tier 1 hook이 차단 → LLM에 미전달
+- **나쁜 예**: 탭/스페이스 혼용 오류 → sonnet으로 전달 → 불필요한 비용 발생
+
+R013 (SHOULD-ecomode)의 "저렴한 검증 우선" 원칙과 정합: ecomode는 출력 토큰을 절약하고, R023은 검증 비용을 절약한다.
+
+## 기존 자산 매핑
+
+| Tier | 자산 | 역할 |
+|------|------|------|
+| **Tier 1** | `.claude/hooks/` (PreToolUse hooks) | 도구 호출 전 결정론적 차단 |
+| **Tier 1** | `mgr-sauron` (R017 구조 검증) | 에이전트/스킬/가이드 frontmatter 검증 |
+| **Tier 1** | pre-commit configs, linters | 코드 품질 정적 검사 |
+| **Tier 2** | `dev-review` | 파일 단위 haiku 코드 리뷰 |
+| **Tier 2** | `action-validator` | CI/CD 액션 구문 검증 |
+| **Tier 2** | `pre-generation-arch-check` | 생성 전 아키텍처 lite 점검 |
+| **Tier 3** | `deep-verify` | 다단계 품질 검증 (sonnet) |
+| **Tier 3** | `adversarial-review` | 공격자 시각 보안 리뷰 (opus) |
+| **Tier 3** | `multi-model-verification` | 복수 모델 교차 검증 |
+| **Tier 3** | `evaluator-optimizer` | 평가-개선 반복 루프 |
+| **Tier 3** | `worker-reviewer-pipeline` | 구현-리뷰 파이프라인 |
+| **Tier 4** | maintainer manual review | PR approval, final gate |
+
+## R021과의 관계
+
+R021 (MUST-enforcement-policy)과 R023은 **직교**한다. 두 규칙은 서로 다른 차원을 다룬다:
+
+| 규칙 | 질문 | 차원 |
+|------|------|------|
+| **R021** | "어떻게 강제할 것인가?" | Hard block / Soft block / Advisory |
+| **R023** | "어떤 비용으로 검증할 것인가?" | Deterministic / Cheap LLM / Expensive LLM |
+
+같은 도구가 두 규칙에 동시에 속할 수 있다:
+
+- `mgr-sauron`: R021 관점에서 Advisory (PostToolUse hook), R023 관점에서 Tier 1 (구조 검증)
+- `deep-verify`: R021 관점에서 Prompt-based (blocking 없음), R023 관점에서 Tier 3 (expensive LLM)
+- `.claude/hooks/` stage-blocker: R021 관점에서 Hard Block, R023 관점에서 Tier 1
+
+R021은 위반 시 어떻게 멈출지를, R023은 어떤 순서로 검증할지를 정의한다.
+
+## Self-Check
+
+새 검증 도구 추가 시:
+
+- [ ] 어느 tier에 속하는지 명확한가?
+- [ ] 같은 tier 내 중복 도구는 없는가?
+- [ ] Tier 1에서 잡을 수 있는 문제를 다루는가? (상위 tier 대신 시프트 권고)
+- [ ] Ladder 순서를 문서화했는가? (어떤 검사를 먼저 실행하는지)
+
+## Integration
+
+| 규칙 | 상호작용 |
+|------|---------|
+| R009 (Parallel Execution) | Tier 1-2 검사는 독립 파일에 대해 병렬 실행 가능 |
+| R013 (Ecomode) | 컨텍스트 압박 시 Tier 3를 Tier 2로 다운그레이드 고려 |
+| R017 (Sync Verification) | Phase 1-3 검증 단계는 R023 Tier 1-3에 대응 |
+| R021 (Enforcement Policy) | 직교: R021은 blocking 방식, R023은 검증 비용 순서 |

package/templates/.claude/skills/crg-integration/SKILL.md

@@ -0,0 +1,163 @@
+---
+name: crg-integration
+description: code-review-graph (CRG) MCP wrapper — token-efficient context retrieval via AST knowledge graph. Exposes 4 core tools from CRG.
+scope: core
+version: 0.1.0
+user-invocable: true
+effort: low
+---
+
+# CRG Integration Skill
+
+code-review-graph (CRG) MCP 서버의 핵심 4개 도구를 노출하는 wrapper 스킬.
+전체 28개 도구 중 oh-my-customcode 워크플로우에서 가장 빈번하게 사용되는 도구만 선별해 사용자 학습 곡선을 축소한다.
+
+## 목적
+
+- **8.2× 토큰 절감** (CRG 공식 벤치마크): AST 기반 지식 그래프로 전체 파일 대신 관련 노드만 추출
+- **Recall-우선 설계**: precision 0.38 / MRR 0.35 — 누락 없음이 우선, 잡음은 감수
+- **R013 ecomode 보완**: context 사용량 ≥ 60% 시점에 CRG 호출로 추가 컨텍스트 주입 비용 절감
+
+> **⚠️ Recall이 정답이 아니다** — 아래 주의 섹션을 먼저 읽어라.
+
+## 노출 도구 4종
+
+CRG 전체 28개 도구 중 핵심 4개만 노출한다.
+
+| Tool | 용도 | 출력 형식 |
+|------|------|----------|
+| `get_minimal_context` | 변경 코드의 최소 컨텍스트 (인접 함수, import 그래프) | code excerpt + AST node list |
+| `get_impact_radius` | 변경 시 영향 받는 함수/모듈 (recall-우선) | dependency tree |
+| `query_graph` | AST 노드 그래프 쿼리 (예: "find all callers of X") | node graph |
+| `detect_changes` | 두 시점 간 의미적 차이 감지 | semantic diff |
+
+## 설치 가이드
+
+> R001 정책: auto-install 스크립트 금지. 아래 명령어는 **사용자가 직접** 실행한다.
+
+### 1단계: 패키지 설치
+
+```bash
+# 방법 A: pip
+pip install code-review-graph
+
+# 방법 B: pipx (격리 환경 권장)
+pipx install code-review-graph
+
+# 방법 C: uvx (uv 사용 시)
+uvx code-review-graph
+```
+
+### 2단계: .mcp.json 수동 설정
+
+프로젝트 루트 또는 `~/.claude/` 아래 `.mcp.json`을 **직접 편집**한다:
+
+```json
+{
+  "mcpServers": {
+    "code-review-graph": {
+      "command": "code-review-graph",
+      "args": []
+    }
+  }
+}
+```
+
+auto-install hook 또는 스크립트로 `.mcp.json`을 자동 수정하는 방식은 R001 위반이다.
+
+### 3단계: 초기 인덱싱
+
+```bash
+# 명시적 인덱싱 (선택 — 첫 MCP 호출 시 lazy 인덱싱도 가능)
+code-review-graph index
+```
+
+자세한 설치/설정 절차는 `guides/token-efficiency/crg.md` 참조.
+
+## 사용 패턴
+
+### PR 리뷰 전: 변경 폭 파악
+
+```
+get_impact_radius(changed_files=[...])
+→ dependency tree 확인 → 리뷰 범위 결정
+```
+
+### 코드 검색: token-efficient lookup
+
+```
+query_graph(query="find all callers of process_event")
+→ AST node graph → 전체 파일 읽지 않고 호출 지점만 추출
+```
+
+### 디버깅: 관련 함수만 추출
+
+```
+get_minimal_context(file="src/handler.py", line=142)
+→ code excerpt + AST nodes → 필요한 컨텍스트만 주입
+```
+
+### 리팩토링: 의미적 변경 확인
+
+```
+detect_changes(before_ref="HEAD~1", after_ref="HEAD")
+→ semantic diff → 이름 변경/이동 등 구조 변경 감지
+```
+
+## ⚠️ 주의 — Recall이 정답이 아니다
+
+CRG는 recall 최적화 도구다. 다음 사항을 반드시 숙지한다:
+
+| 오해 | 실제 |
+|------|------|
+| "결과에 없으면 없는 것" | recall-tuned — 일부 관련 코드가 누락될 수 있다 |
+| "precision 0.38 = 결과 62% 오답" | recall-우선 튜닝의 precision trade-off. 잡음은 정상 |
+| "CRG 하나로 충분" | 누락 발생 시 grep, semantic search 병행 필수 |
+| "모든 작업에 8.2× 절감" | AST 검색이 적합한 작업에 한정. UI 리뷰, 자연어 검색은 효과 미미 |
+
+**결론**: CRG는 보조 도구다. 결과를 맹신하지 말고 누락 가능성을 항상 고려한다.
+
+## 다른 자산과의 관계
+
+### 보완 관계 (함께 사용)
+
+| 자산 | 조합 방식 |
+|------|----------|
+| `dev-review` | CRG로 영향 범위 파악 → dev-review로 상세 리뷰 |
+| `adversarial-review` | CRG `get_minimal_context` → adversarial-review 입력 최적화 |
+| `claude-mem:smart-explore` | CRG `query_graph`로 대체 가능 (Phase β 시퀀싱 — #1169 참조) |
+| `claude-mem:pathfinder` | CRG `get_impact_radius`로 대체 가능 (Phase β 시퀀싱 — #1169 참조) |
+
+### 마이그레이션 예정 (Phase β)
+
+- `claude-mem:smart-explore` → CRG `query_graph` (#1169)
+- `claude-mem:pathfinder` → CRG `get_impact_radius` (#1169)
+
+Phase β 완료 전까지는 두 자산을 병행 사용한다.
+
+## R013 Ecomode와의 관계
+
+R013 ecomode가 자동 활성화되는 시점 (context 사용량 ≥ 60%)에서 CRG를 적극 활용한다:
+
+| Ecomode 상황 | CRG 활용법 |
+|-------------|-----------|
+| 파일 전체 읽기 대신 | `get_minimal_context` → 필요한 노드만 추출 |
+| 광범위 grep 대신 | `query_graph` → AST 수준 정밀 검색 |
+| 변경 범위 파악 대신 | `get_impact_radius` → dependency tree만 수신 |
+
+## 트러블슈팅
+
+| 증상 | 원인 | 해결 |
+|------|------|------|
+| MCP 도구가 보이지 않음 | `.mcp.json` 미설정 또는 경로 오류 | `.mcp.json` 확인, Claude Code 재시작 |
+| `command not found: code-review-graph` | 패키지 미설치 또는 PATH 누락 | `pip install code-review-graph` 재실행, `which code-review-graph` 확인 |
+| 인덱싱 오류 | 초기 인덱싱 미완료 | `code-review-graph index` 실행 후 재시도 |
+| 결과 누락 (예상 함수 없음) | recall-tuned 동작 — 정상 | grep 또는 semantic search 병행 |
+| 서버 연결 실패 | CRG 서버 미실행 | MCP 서버 로그 확인, Claude Code 재시작 |
+
+## 참고
+
+- 상세 설치/설정: `guides/token-efficiency/crg.md`
+- 관련 이슈: #1171 (scout:integrate CRG)
+- Phase β 시퀀싱: #1169 (AgentMemory 전환 계획)
+- 기술 출처: [tirth8205/code-review-graph](https://github.com/tirth8205/code-review-graph)

package/templates/CLAUDE.md

@@ -86,6 +86,7 @@ oh-my-customcode로 구동됩니다.
 | R013 | Ecomode | 배치 작업 토큰 효율성 |
 | R019 | Ontology-RAG 라우팅 | 라우팅 스킬의 ontology-RAG enrichment |
 | R022 | Wiki 동기화 | 에이전트/스킬/룰/가이드 변경 시 위키 자동 동기화 |
+| R023 | Verification Ladder | 검증 비용 ladder: Tier 1(결정론적) → Tier 4(human) shift-left |
 
 ### MAY (선택)
 | ID | 규칙 | 설명 |

package/templates/README.md

@@ -48,8 +48,8 @@ templates/
 ├── manifest.json                    # 배포 컴포넌트 카운트 및 메타데이터
 ├── .claude/
 │   ├── agents/                      # 에이전트 정의 파일 (*.md, 49개)
-│   ├── skills/                      # 스킬 모듈 (각 디렉토리에 SKILL.md, 117개)
-│   ├── rules/                       # 전역 규칙 (R000–R022, 22개)
+│   ├── skills/                      # 스킬 모듈 (각 디렉토리에 SKILL.md, 118개)
+│   ├── rules/                       # 전역 규칙 (R000–R023, 23개)
 │   ├── hooks/
 │   │   ├── hooks.json               # 훅 이벤트 설정 (PreToolUse/PostToolUse 등)
 │   │   └── scripts/                 # 훅 셸 스크립트 (34개)
@@ -86,7 +86,7 @@ CI의 `verify-template-sync.sh`가 소스와 templates/ 간 일치를 검증합
 | Manager | 6 |
 | System | 4 |
 
-### Skills (117)
+### Skills (118)
 
 `.claude/skills/*/SKILL.md` — 재사용 가능한 스킬 모듈.
 
@@ -97,9 +97,9 @@ CI의 `verify-template-sync.sh`가 소스와 templates/ 간 일치를 검증합
 - `harness` — 에이전트/스킬/룰 유지보수 도구 (init 시 배포됨)
 - `package` — 패키지 특화 도구 (선택 배포)
 
-### Rules (22)
+### Rules (23)
 
-`.claude/rules/*.md` — 에이전트 행동 규칙 (R000–R022, R014 없음).
+`.claude/rules/*.md` — 에이전트 행동 규칙 (R000–R023, R014 없음).
 
 파일명 형식: `{PRIORITY}-{name}.md` (예: `MUST-agent-identification.md`)
 
@@ -109,13 +109,13 @@ CI의 `verify-template-sync.sh`가 소스와 templates/ 간 일치를 검증합
 | `SHOULD` | 강력 권장 | R003 상호작용, R013 Ecomode |
 | `MAY` | 선택 | R005 최적화 |
 
-### Guides (50)
+### Guides (51)
 
 `guides/*/` — 레퍼런스 문서 디렉토리.
 
 각 디렉토리는 단일 토픽에 대한 best practices, 튜토리얼, 또는 설계 가이드를 담습니다. 에이전트가 작업 중 참조합니다 (R006 관심사 분리).
 
-### Hooks (34)
+### Hooks (35)
 
 `.claude/hooks/scripts/*.sh` — 라이프사이클 훅 스크립트.
 

package/templates/guides/agent-workflow/05-autonomous-challenge-lessons.md

@@ -0,0 +1,35 @@
+# Autonomous Challenge Lessons
+
+Lessons from the 2026-05 Minecraft Cobblemon autonomous run post-mortem (#1149). Use these as guardrails for long-running challenge, QA, and tool-heavy sessions.
+
+## First-five-minutes ground-truth check
+
+Before producing solution artifacts, ask whether the environment already contains a reference, answer jar, fixture, golden output, or expected patch.
+
+- Inspect supplied artifacts before inventing a mechanism.
+- If a jar/binary/package is provided as the expected fix, disassemble or inspect it early.
+- Verify framework version and mapping namespace before writing code. For Minecraft/Fabric-style work, decide Mojang official vs Yarn mappings from the actual target environment, not from memory.
+
+## Tool denial and repeated failure policy
+
+- If a tool call is denied by permissions, do not retry the exact same call. Switch to a permitted route and record the denial.
+- If the same critical error appears twice, stop relaunching and re-check flag semantics, existing singleton processes, and environment state.
+- For launcher-style tools, clear known singleton processes before a fresh launch when safe and appropriate.
+- Treat ambiguous CLI flags as suspect until confirmed by docs or help output. Example: an `--offline` flag may force missing-library failures rather than simply avoid network calls.
+
+## QA evidence discipline
+
+QA reports must quote implementation identifiers verbatim:
+
+- grep/read the target code before naming `data-testid`, selectors, function names, or config keys;
+- include the exact file path and line when possible;
+- do not infer selectors or identifiers from screenshots, memory, or prior drafts.
+
+## Long autonomous run checkpoint
+
+At each major phase boundary:
+
+1. Re-check the ground-truth artifact or expected output.
+2. Re-check version/mapping assumptions.
+3. Review repeated-denial or repeated-error patterns.
+4. Confirm QA evidence came from code or executed commands, not assumptions.

package/templates/guides/claude-code/15-version-compatibility.md

@@ -266,6 +266,77 @@ retire/wake 사이클 후에도 `--dangerously-skip-permissions` 플래그가
 
 **Action items**: Fast Mode를 사용하는 경우 Opus 4.7 전환 영향을 확인하고, 필요 시 `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1`로 고정. `MCP_TOOL_TIMEOUT` 설정이 필요한 환경에서는 선택적으로 적용.
 
+## v2.1.143 (2026-05-15) — 호환성 점검
+
+> Issue: #1166 — CC v2.1.143 compatibility documentation
+
+### Plugin dependency enforcement
+
+`claude plugin disable` now refuses to disable a plugin when another enabled plugin depends on it, and prints a copy-pasteable disable-chain hint. `claude plugin enable` force-enables transitive dependencies.
+
+**oh-my-customcode 연관**: 필수/권장 플러그인(superpowers, context7, elements-of-style 등)을 함께 운영할 때 의존성 순서 실수가 줄어듭니다. 플러그인 비활성화 자동화는 실패 메시지의 disable-chain 힌트를 그대로 따르도록 해야 합니다. 직접 harness 변경 불필요.
+
+### `/plugin` marketplace projected context cost
+
+Marketplace browse pane now shows projected context cost estimates per turn and per invocation.
+
+**oh-my-customcode 연관**: R013 ecomode 및 토큰 효율 감사에서 플러그인 선택 근거가 개선됩니다. `/plugin details`와 함께 플러그인 도입 전 비용 점검에 활용합니다.
+
+### `worktree.bgIsolation: "none"`
+
+New setting lets background sessions edit the working copy directly without `EnterWorktree` for repositories where worktrees are impractical.
+
+```json
+{
+  "worktree": {
+    "bgIsolation": "none"
+  }
+}
+```
+
+**oh-my-customcode 연관**: R009/R018 병렬 작업에서 worktree가 불가능한 저장소의 fallback 옵션입니다. 같은 working copy를 공유하므로 충돌 위험이 있습니다. 사용 전 `git status --short --branch`를 확인하고, 병렬 파일 소유권을 명확히 나누는 경우에만 opt-in 하세요.
+
+### PowerShell execution policy bypass
+
+PowerShell tool now passes `-ExecutionPolicy Bypass`. Opt out with:
+
+```bash
+export CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY=1
+```
+
+**oh-my-customcode 연관**: Windows 환경에서 hook/script 실행 호환성이 좋아집니다. 보수적 enterprise policy 환경에서는 위 opt-out을 문서화하세요.
+
+### Background sessions preserve model and effort
+
+Background sessions now preserve the model and effort level set after waking from idle. Shift+Tab in attached agent sessions now includes auto mode in the cycle.
+
+**oh-my-customcode 연관**: R006 agent frontmatter의 `model`/`effort`와 장시간 R018 세션 운영이 더 안정적입니다. 별도 변경 없음.
+
+### Fixes relevant to agent harnesses
+
+- Corrupt `.credentials.json` with non-array `scopes` no longer hangs startup or silently aborts OAuth token refresh.
+- Stop hooks that block repeatedly now end the turn with a warning after 8 consecutive blocks. Override with `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP`.
+- Esc/Ctrl+C cancels pending `/loop` wakeup while idle.
+- `/goal` evaluator no longer fires while background shells or delegated subagents are still running.
+- `NO_COLOR`/`FORCE_COLOR` in settings env now apply to subprocesses only, preserving Claude Code UI colors.
+- Agent view avoids repeated PowerShell processes on Windows.
+- `/bg` without a prompt now waits for input instead of sending `continue`.
+- `--agent <name>` can find plugin-contributed agents without the `plugin:` prefix.
+
+### oh-my-customcode 연관 평가
+
+| 변경 | 영향 | Action |
+|------|------|--------|
+| Plugin dependency enforcement | 플러그인 disable/enable 순서 안전 | None |
+| Marketplace context cost | R013 비용 점검 개선 | Use in token audits |
+| `worktree.bgIsolation: "none"` | worktree 불가 repo fallback | Opt-in only with file ownership discipline |
+| PowerShell policy bypass | Windows script 호환성 | Enterprise opt-out 문서화 |
+| BG model/effort persistence | 장시간 에이전트 안정성 | None |
+| Stop hook block cap | hook 무한루프 안전 | Hook 테스트 시 8회 cap 인지 |
+| `/goal`, `/loop`, `/bg`, plugin agent fixes | autonomous workflow 안정성 | None |
+
+**Action items**: 직접 변경 불필요. `worktree.bgIsolation: "none"`은 충돌 위험이 있으므로 기본값으로 권장하지 않고, R009 병렬 작업에서는 기존 worktree 격리를 우선합니다.
+
 ## v2.1.141 (2026-05-13) — 호환성 점검
 
 > Issue: #1137 — CC v2.1.141 compatibility documentation

package/templates/guides/compound-ai-workflow/README.md

@@ -0,0 +1,197 @@
+# Compound AI Workflow
+
+> 모든 완료된 artifact가 다음 세션의 context로 누적된다.
+
+Eugene Yan의 ["How to Work and Compound with AI"](https://eugeneyan.com/writing/working-with-ai/)에서 추출한 5원칙을 oh-my-customcode 인벤토리에 내재화한 레퍼런스 가이드. 이 가이드는 시스템을 처음 접하는 기여자와 기존 사용자 모두를 위한 entry point 역할을 한다.
+
+---
+
+## 1. 개요
+
+**compound effect**란 AI와의 모든 상호작용이 단순히 소비되지 않고, 다음 작업의 질과 속도를 높이는 재료로 누적되는 현상이다. 각 세션에서 생성된 skill, memory, guide, rule이 쌓일수록 시스템은 점점 더 빠르고 정확하게 작동한다.
+
+oh-my-customcode는 이 원리를 아키텍처 전반에 내재화한다:
+
+- **Skills**: 재사용 가능한 워크플로우 지식
+- **Agents**: 스킬을 조합한 실행 가능한 전문가
+- **Rules**: 시스템 전체에 걸친 행동 제약
+- **Memory**: 세션 간 누적되는 패턴과 피드백
+
+---
+
+## 2. Eugene Yan 5원칙
+
+### 원칙 1: Context Infrastructure
+
+구조화된 디렉토리와 annotated indices가 AI에게 풍부한 컨텍스트를 제공한다. 파일이 어디에 있는지, 무슨 역할인지를 AI가 스스로 파악할 수 있도록 레이아웃과 색인이 설계되어야 한다. 임시 파일과 unstructured dump는 AI의 추론 품질을 떨어뜨린다. 잘 정비된 디렉토리 구조는 AI가 "기억 없이도" 프로젝트를 이해하게 만드는 구조적 기억이다.
+
+### 원칙 2: Taste as Configuration
+
+AI의 출력 품질은 사용자의 취향(taste)을 얼마나 잘 설정했느냐에 달려 있다. CLAUDE.md와 규칙 파일은 이 취향을 코드화한 것이다. 스타일, 언어 정책, 금지된 패턴, 선호하는 위임 방식을 선언적으로 정의하면 AI는 매 세션마다 동일한 기준으로 작동한다. 취향은 대화로 가르치는 것이 아니라 설정으로 배포하는 것이다.
+
+### 원칙 3: Verification Ladders
+
+검증은 비용 순서대로 쌓인 사다리여야 한다. 가장 저렴한 결정론적 검사가 먼저 통과되어야 비싼 LLM 검토로 이어진다. hooks, linters, type-checker가 잡을 수 있는 오류를 sonnet/opus에 보내는 것은 낭비다. shift-left 원칙: 문제를 발견하는 시점을 최대한 앞으로 당긴다. 자세한 내용은 R023 (SHOULD-verification-ladder)를 참조.
+
+### 원칙 4: Scaled Delegation
+
+위임의 깊이는 작업의 크기와 위험도에 비례해야 한다. 간단한 파일 편집은 pair-programming 스타일로 직접 호출하고, 복잡한 다단계 작업은 `/pipeline auto-dev`로 완전 위임한다. 위임 스펙트럼을 이해하고 올바른 깊이를 선택하는 것이 AI 협업 효율의 핵심이다.
+
+### 원칙 5: Loop Closure
+
+AI와의 대화 기록(transcript)은 단순 로그가 아니라 패턴 마이닝의 원천이다. 반복적으로 수정하게 되는 패턴, AI가 자주 오해하는 패턴, 성공적인 위임 패턴을 추출해 skill로 승격시키는 것이 loop closure다. 이 루프가 닫혀야 compound effect가 발생한다.
+
+---
+
+## 3. oh-my-customcode 매핑표
+
+| Yan 원칙 | 대응 자산 | 비고 |
+|---------|----------|------|
+| **Context Infrastructure** | `.claude/agent-memory/`, MEMORY.md, R011 (`SHOULD-memory-integration`), `wiki/` | 에이전트별 project-scoped 메모리 + wiki 색인 |
+| **Taste as Configuration** | `CLAUDE.md`, `.claude/rules/` (R000-R023), `.claude/output-styles/` | 규칙 cascade: global → project → agent frontmatter |
+| **Verification Ladders** | R023 `SHOULD-verification-ladder`, `deep-verify`, `multi-model-verification`, `adversarial-review`, `mgr-sauron` | Tier 1-4 shift-left ladder |
+| **Scaled Delegation** | `structured-dev-cycle`, `dev-lead-routing`, `/pipeline auto-dev` | pair → stage-gated → full delegation 스펙트럼 |
+| **Loop Closure** | `skill-extractor` (`--mode failure`), R016 (`MUST-continuous-improvement`), `omcustom-loop` | 패턴 채굴 → skill 승격 자동화 |
+
+---
+
+## 4. Compound Effect: 시스템 사고 프레이밍
+
+oh-my-customcode는 소프트웨어 컴파일과 동일한 구조를 따른다:
+
+| 컴파일 개념 | oh-my-customcode 매핑 | compound 효과 |
+|-----------|---------------------|--------------|
+| Source code | `.claude/skills/` | 재사용 가능한 지식 누적 |
+| Build artifacts | `.claude/agents/` | 스킬 조합으로 전문가 생성 |
+| Compiler | `mgr-sauron` (R017) | 구조 정합성 보장 |
+| Spec | `.claude/rules/` | 빌드 규칙의 지속적 진화 |
+| Linker | Routing skills | 에이전트-작업 연결 최적화 |
+| Standard library | `guides/` | 공유 레퍼런스 지식 누적 |
+
+이 메타포에서 compound effect가 발생하는 지점:
+
+1. **세션 1**: 새 패턴 발견 → skill 초안 작성
+2. **세션 2**: skill 재사용 → 작업 시간 단축
+3. **세션 3**: skill 실패 패턴 채굴 → skill 개선 (R016 + skill-extractor)
+4. **세션 N**: 누적된 skill/rule/memory가 신규 작업의 context로 자동 주입
+
+각 artifact(skill, agent, guide, memory)는 독립적 가치가 아니라 **시스템 전체의 지식 밀도**를 높이는 방식으로 기여한다. 하나의 잘 작성된 skill이 10개 세션에서 반복 재사용될 때 compound effect가 실현된다.
+
+---
+
+## 5. Scaled Delegation 스펙트럼
+
+위임 깊이는 작업의 복잡도, 위험도, 반복성에 따라 결정된다.
+
+### 스펙트럼 개요
+
+| 위임 깊이 | 패턴 | 대표 자산 | 적합한 작업 |
+|---------|------|----------|-----------|
+| **Pair-programming** | 직접 에이전트 호출 | 특정 에이전트 직접 지시 | 단일 파일 수정, ad-hoc 질문, 빠른 확인 |
+| **Stage-gated** | structured-dev-cycle | `structured-dev-cycle` (6-stage) | 기능 구현, 리팩토링, 복잡한 버그 수정 |
+| **Full delegation** | 파이프라인 자동화 | `/pipeline auto-dev` | 이슈 기반 완전 자동 개발 사이클 |
+
+### 위임 깊이 선택 가이드
+
+```
+작업 크기 / 위험도에 따른 선택:
+
+Low risk + 단일 파일 + 명확한 요구사항
+  → Pair-programming: "이 함수의 에러 핸들링을 개선해줘"
+
+Medium risk + 다중 파일 + 테스트 필요
+  → Stage-gated: structured-dev-cycle
+    [Stage 1] 분석 (Read only)
+    [Stage 2] 설계 검토
+    [Stage 3] 구현 (Write 허용)
+    [Stage 4] 검증 (Test 실행)
+    [Stage 5] 문서화
+    [Stage 6] 완료 검증 (R020)
+
+High volume + 이슈 목록 + CI 검증 가능
+  → Full delegation: /pipeline auto-dev
+    이슈 선택 → 자동 분석 → 구현 → PR 생성
+```
+
+### Stage-gated 상세: structured-dev-cycle
+
+6-stage 워크플로우로 각 단계에서 도구 제한을 적용:
+
+| 단계 | 허용 도구 | 목표 |
+|------|---------|------|
+| 1. Analysis | Read, Glob, Grep | 현재 상태 파악, 요구사항 명확화 |
+| 2. Design | Read, EnterPlanMode | 변경 범위 결정, 아키텍처 검토 |
+| 3. Implementation | Read, Write, Edit | 코드 작성, 파일 수정 |
+| 4. Verification | Bash (test), Read | 테스트 실행, 정적 분석 |
+| 5. Documentation | Write, Edit | 문서 업데이트, changelog |
+| 6. Completion | Read | R020 완료 검증, 최종 확인 |
+
+### Full Delegation: /pipeline auto-dev
+
+완전 자동화 사이클. 인간 개입 없이 이슈에서 PR까지:
+
+```
+이슈 선택
+  ↓
+mgr-sauron: 구조 검증
+  ↓
+dev-lead-routing: 전문 에이전트 배정
+  ↓
+구현 (전문 에이전트)
+  ↓
+qa-planner: 검증 계획
+  ↓
+mgr-gitnerd: PR 생성
+  ↓
+wiki-curator: 문서 동기화 (R022)
+```
+
+**적합한 조건**: 명확한 이슈 스펙, 기존 테스트 커버리지, CI가 통과/실패를 판단 가능한 경우.
+
+---
+
+## 6. 신규 기여자 Entry Point
+
+### 학습 경로
+
+```
+1. CLAUDE.md          → 시스템 전체 철학, 강제 규칙 요약
+2. 본 가이드           → compound effect 이해, 5원칙 매핑
+3. .claude/rules/      → 개별 규칙 상세 (R000-R023)
+4. .claude/skills/     → 재사용 가능한 워크플로우 목록
+5. .claude/agents/     → 전문 에이전트 역할과 도구 목록
+6. guides/             → 도메인별 레퍼런스 문서
+```
+
+### 자주 묻는 질문
+
+**"어떤 에이전트를 사용해야 하나?"**
+`/omcustom:lists`로 전체 목록 확인. 없으면 `mgr-creator`가 자동 생성.
+
+**"새 skill을 추가하고 싶다"**
+`mgr-creator`에게 위임. R006 (MUST-agent-design) 준수 필수.
+
+**"AI가 같은 실수를 반복한다"**
+R016 (MUST-continuous-improvement): 룰 업데이트 → commit. `skill-extractor --mode failure`로 패턴 채굴.
+
+**"작업이 너무 오래 걸린다"**
+R009 (MUST-parallel-execution): 독립 작업 2개 이상은 병렬 실행 필수.
+
+**"컨텍스트가 너무 길어졌다"**
+R013 (SHOULD-ecomode): 80% 이상에서 자동 활성화. `/compact` 또는 ecomode on.
+
+---
+
+## 7. 참고
+
+| 항목 | 링크 |
+|------|------|
+| Eugene Yan 원글 | https://eugeneyan.com/writing/working-with-ai/ |
+| 관련 이슈 | #1172 (scout:internalize compound-ai-workflow) |
+| R023 Verification Ladder | `.claude/rules/SHOULD-verification-ladder.md` |
+| R016 Continuous Improvement | `.claude/rules/MUST-continuous-improvement.md` |
+| R011 Memory Integration | `.claude/rules/SHOULD-memory-integration.md` |
+| R013 Ecomode | `.claude/rules/SHOULD-ecomode.md` |
+| skill-extractor | `.claude/skills/skill-extractor/SKILL.md` |
+| structured-dev-cycle | `.claude/skills/structured-dev-cycle/SKILL.md` |
+| 관련 메모리 | [[project-sequencing-alpha-beta-gamma]] |

package/templates/guides/token-efficiency/crg.md

@@ -0,0 +1,218 @@
+# CRG (code-review-graph) 통합 가이드
+
+> **출처**: [tirth8205/code-review-graph](https://github.com/tirth8205/code-review-graph)
+> **관련 이슈**: #1171 (scout:integrate), #1169 (Phase β AgentMemory 전환)
+> **wrapper 스킬**: `.claude/skills/crg-integration/SKILL.md`
+
+## CRG 개요
+
+code-review-graph(CRG)는 Python 기반 MCP(Model Context Protocol) 서버로, 코드베이스를 AST(Abstract Syntax Tree) 기반 지식 그래프로 변환하여 token-efficient한 컨텍스트 검색을 제공한다.
+
+### 핵심 특성
+
+| 항목 | 값 |
+|------|-----|
+| 구현 | Python MCP server |
+| 전체 도구 수 | ~28개 |
+| oh-my-customcode 노출 | 4개 (crg-integration 스킬) |
+| 토큰 절감 벤치마크 | **8.2×** (AST 검색이 적합한 작업 기준) |
+| Precision | 0.38 (recall-우선 튜닝 결과) |
+| MRR | 0.35 |
+
+### R013 Ecomode 정합성
+
+CRG의 8.2× 토큰 절감은 R013 ecomode의 목표와 직접 정합한다. ecomode가 context 사용량 ≥ 60%에서 자동 활성화될 때, CRG 호출로 추가 파일 읽기 비용을 대폭 줄일 수 있다.
+
+## ⚠️ Recall vs Precision — 핵심 경고
+
+> **CRG는 recall이 정답이다. 일부 결과가 누락되면 보조 도구(grep, semantic search)를 병행하라.**
+
+CRG는 누락(false negative)보다 잡음(false positive)을 선호하도록 튜닝되어 있다:
+
+- precision 0.38은 "결과의 38%만 정확"이라는 의미가 **아니다**
+- recall-우선 튜닝의 trade-off — 관련 없는 노드가 포함될 수 있다
+- 결과에 없다고 해서 코드베이스에 없다는 뜻이 아니다
+- **항상** grep 또는 semantic search로 교차 검증을 권장한다
+
+## 설치
+
+> **R001 정책**: auto-install 스크립트 또는 hook 작성 금지. 아래 명령어는 개발자가 직접 실행한다.
+
+### 패키지 설치
+
+```bash
+# 방법 A: pip (기본)
+pip install code-review-graph
+
+# 방법 B: pipx (격리 환경 권장)
+pipx install code-review-graph
+
+# 방법 C: uvx (uv 기반 프로젝트)
+uvx code-review-graph
+```
+
+### .mcp.json 수동 설정
+
+프로젝트 루트 `.mcp.json` 또는 `~/.claude/.mcp.json`을 직접 편집한다:
+
+```json
+{
+  "mcpServers": {
+    "code-review-graph": {
+      "command": "code-review-graph",
+      "args": []
+    }
+  }
+}
+```
+
+**주의**: `.mcp.json`을 자동으로 수정하는 스크립트나 hook은 R001 위반이다. 반드시 수동 편집한다.
+
+설정 후 Claude Code를 재시작하면 MCP 도구가 활성화된다.
+
+### 설치 확인
+
+```bash
+# 바이너리 확인
+which code-review-graph
+
+# 버전 확인
+code-review-graph --version
+```
+
+## 초기 인덱싱
+
+CRG는 첫 MCP 호출 시 lazy 인덱싱을 수행하지만, 대용량 코드베이스의 경우 명시적 인덱싱을 권장한다:
+
+```bash
+# 프로젝트 루트에서 실행
+code-review-graph index
+
+# 특정 경로만 인덱싱
+code-review-graph index --path src/
+```
+
+인덱싱은 `.code-review-graph/` 캐시 디렉토리에 저장된다. `.gitignore`에 추가를 권장한다:
+
+```
+.code-review-graph/
+```
+
+## 노출 도구 4종 상세
+
+### `get_minimal_context`
+
+변경 코드의 최소 컨텍스트를 반환한다. 인접 함수, import 그래프만 추출하여 전체 파일 읽기를 대체한다.
+
+```
+입력: file path + line number (또는 function name)
+출력: code excerpt + AST node list
+용도: 디버깅, 특정 함수 컨텍스트 파악
+```
+
+### `get_impact_radius`
+
+변경 시 영향 받는 함수/모듈을 recall-우선으로 반환한다.
+
+```
+입력: changed_files list (또는 diff)
+출력: dependency tree
+용도: PR 리뷰 전 변경 폭 파악, 리팩토링 위험도 평가
+```
+
+### `query_graph`
+
+AST 노드 그래프에 자연어 쿼리를 실행한다.
+
+```
+입력: 자연어 쿼리 (예: "find all callers of process_event")
+출력: node graph (함수/모듈 관계)
+용도: 코드 검색, 의존성 파악
+```
+
+### `detect_changes`
+
+두 Git 시점 간 의미적 차이를 감지한다. 단순 텍스트 diff가 아닌 AST 수준 변경을 추적한다.
+
+```
+입력: before_ref, after_ref (Git refs 또는 파일 경로)
+출력: semantic diff (이름 변경, 이동, 시그니처 변경 등)
+용도: 리팩토링 검증, 의도치 않은 변경 감지
+```
+
+## 워크플로우 통합
+
+### /dev-review와 조합
+
+```
+1. get_impact_radius(changed_files) → 영향 범위 확인
+2. get_minimal_context(hot_spots) → 핵심 컨텍스트 추출
+3. /dev-review {focused_files} → 범위를 좁힌 상세 리뷰
+```
+
+전체 디렉토리 리뷰 대신 CRG로 영향 범위를 먼저 파악하면 dev-review의 토큰 비용을 줄일 수 있다.
+
+### /adversarial-review와 조합
+
+```
+1. get_minimal_context(target_function) → 최소 컨텍스트
+2. /adversarial-review {minimal_context} → 보안/논리 취약점 검토
+```
+
+<!-- TODO: 향후 cross-ref 추가 — adversarial-review 스킬 업데이트 시 -->
+
+### R013 Ecomode 활성 시
+
+context ≥ 60%에서 파일 직접 읽기 대신 CRG를 우선 사용한다:
+
+| 기존 방식 | CRG 대체 |
+|----------|---------|
+| `Read(entire_file)` | `get_minimal_context(file, line)` |
+| `Grep(pattern, recursive)` | `query_graph("find all X")` |
+| `Read(affected_files[])` | `get_impact_radius(changed)` |
+
+## 벤치마크 사용 시 주의
+
+**8.2× 토큰 절감은 조건부다.**
+
+| 작업 유형 | 절감 효과 |
+|----------|----------|
+| 함수 호출 그래프 탐색 | **높음** (AST 최적화 대상) |
+| 의존성 영향 분석 | **높음** |
+| 특정 패턴 코드 검색 | **중간** |
+| UI 컴포넌트 리뷰 | **낮음** (자연어 설명 기반) |
+| 자연어 검색 ("이 기능 어디에 있나") | **낮음** (semantic search 선호) |
+| 설정 파일, YAML, JSON 분석 | **낮음** (AST 비적합) |
+
+## 기존 자산 마이그레이션 매핑
+
+Phase β에서 claude-mem 일부 기능을 CRG로 전환할 예정이다 (#1169).
+
+| 기존 자산 | CRG 대체 도구 | 전환 시점 |
+|----------|--------------|---------|
+| `claude-mem:smart-explore` | `query_graph` | Phase β |
+| `claude-mem:pathfinder` | `get_impact_radius` | Phase β |
+
+**Phase β 완료 전까지**: 두 자산을 병행 사용. CRG를 우선 시도하고, 결과가 불충분하면 기존 자산 사용.
+
+## 트러블슈팅
+
+| 증상 | 원인 | 해결 방법 |
+|------|------|---------|
+| MCP 도구가 Claude Code에 보이지 않음 | `.mcp.json` 미설정 또는 경로 오류 | `.mcp.json` 위치 및 JSON 문법 확인 후 Claude Code 재시작 |
+| `command not found: code-review-graph` | 패키지 미설치 또는 PATH 누락 | `pip install code-review-graph`, `which code-review-graph` 확인 |
+| 첫 호출이 느림 | lazy 인덱싱 진행 중 | 정상 동작. `code-review-graph index`로 사전 인덱싱 권장 |
+| 결과에 예상 함수가 없음 | recall-tuned — false negative 가능 | grep 또는 semantic search로 교차 검증 |
+| 인덱싱 오류 (`index not found`) | 인덱싱 미완료 또는 캐시 손상 | `code-review-graph index --force` 실행 |
+| MCP 연결 실패 | CRG 서버 미실행 | MCP 서버 로그 확인, `code-review-graph --version` 으로 바이너리 확인 |
+
+## 참고 자료
+
+- **GitHub**: [tirth8205/code-review-graph](https://github.com/tirth8205/code-review-graph)
+- **wrapper 스킬**: `.claude/skills/crg-integration/SKILL.md`
+- **관련 이슈**:
+  - #1171: scout:integrate CRG (이 가이드의 origin)
+  - #1169: Phase β AgentMemory 전환 시퀀싱
+- **관련 규칙**:
+  - R001 (MUST-safety.md): auto-install 금지 정책
+  - R013 (SHOULD-ecomode.md): context budget 관리, ecomode 통합

package/templates/manifest.json

@@ -1,6 +1,6 @@
 {
-  "version": "0.138.0",
-  "lastUpdated": "2026-05-14T00:00:00.000Z",
+  "version": "0.139.0",
+  "lastUpdated": "2026-05-18T00:00:00.000Z",
   "omcustomMinClaudeCode": "2.1.121",
   "omcustomMinClaudeCodeReason": "Sensitive-path direct Write/Edit on .claude/** under bypassPermissions (R010 deprecation, #1101)",
   "components": [
@@ -8,7 +8,7 @@
       "name": "rules",
       "path": ".claude/rules",
       "description": "Agent behavior rules and guidelines",
-      "files": 22
+      "files": 23
     },
     {
       "name": "agents",
@@ -20,13 +20,13 @@
       "name": "skills",
       "path": ".claude/skills",
       "description": "Reusable skill modules (includes slash commands)",
-      "files": 117
+      "files": 118
     },
     {
       "name": "guides",
       "path": "guides",
       "description": "Reference documentation",
-      "files": 50
+      "files": 53
     },
     {
       "name": "hooks",