oh-my-customcode 0.139.0 → 0.140.0

package/README.md

@@ -222,7 +222,7 @@ Key rules: R010 (orchestrator never writes files), R009 (parallel execution mand
 
 ---
 
-### Guides (53)
+### Guides (54)
 
 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.
 
@@ -279,7 +279,7 @@ your-project/
 │   ├── specs/                  # Extracted canonical specs
 │   ├── contexts/               # 4 shared context files
 │   └── ontology/               # Knowledge graph for RAG
-└── guides/                     # 50 reference documents
+└── guides/                     # 54 reference documents
 ```
 
 ---

package/dist/cli/index.js

@@ -2334,7 +2334,7 @@ var init_package = __esm(() => {
     workspaces: [
       "packages/*"
     ],
-    version: "0.139.0",
+    version: "0.140.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.139.0",
+  version: "0.140.0",
   description: "Batteries-included agent harness for Claude Code",
   type: "module",
   bin: {

package/package.json

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

package/templates/.claude/skills/adversarial-review/SKILL.md

@@ -79,6 +79,27 @@ Fix: Recommended remediation
 - [ ] Are domain boundaries respected (backend agent not editing frontend files)?
 - [ ] Could an agent's task contract be tightened without losing functionality?
 
+## CRG Integration (Optional Token-Efficiency)
+
+공격 표면 분석에 `crg-integration` 스킬을 우선 호출하여 트러스트 boundary를 빠르게 매핑한다:
+
+| Phase | CRG Tool | Purpose |
+|-------|----------|---------|
+| Attack surface | `get_impact_radius` | 보안 변경의 영향 추적 (recall-우선) |
+| Caller analysis | `query_graph` | 신뢰 boundary 함수의 모든 caller 추적 |
+| Diff focus | `get_minimal_context` | 보안 변경의 최소 review unit |
+| Regression detect | `detect_changes` | 보안 의미 변경 감지 |
+
+### Fallback (CRG 미설치 시)
+
+CRG MCP 미연결 시 sec-codeql-expert + grep 조합으로 fallback. CRG의 recall-우선 특성 보완 위해 sec-codeql-expert (precision-우선)와 병행 권장.
+
+### R013 Ecomode 정합
+
+대규모 변경 PR (>50 lines) 또는 context >= 60% 시 CRG 호출 권장.
+
+Refs: #1171 (CRG 통합), #1180 (본 cross-ref 추가)
+
 ## Permission Mode
 
 When spawning agents via the Agent tool during this skill's execution, always pass `mode: "bypassPermissions"`. The Agent tool default (`acceptEdits`) overrides agent frontmatter `permissionMode`, causing permission prompts during unattended execution.

package/templates/.claude/skills/dev-review/SKILL.md

@@ -137,6 +137,30 @@ Reference: `feedback_sensitive_path_tmp_bypass.md`, R006 sensitive-path handling
    ```
    The review agent creates the directory and writes the artifact before returning results (R010 compliance).
 
+## CRG Integration (Optional Token-Efficiency)
+
+`crg-integration` 스킬이 사용 가능한 경우 (MCP `code-review-graph` 연결 시), 리뷰 시작 전 먼저 호출하여 토큰 비용을 절감한다:
+
+| Phase | CRG Tool | Purpose |
+|-------|----------|---------|
+| Pre-review | `get_impact_radius` | 변경 영향 범위 사전 파악 (recall-우선) |
+| Search | `query_graph` | AST 기반 호출자/피호출자 추적 |
+| Diff analysis | `get_minimal_context` | 변경 코드의 최소 컨텍스트 |
+| Semantic check | `detect_changes` | 두 시점 의미적 차이 |
+
+### Fallback (CRG 미설치 시)
+
+CRG MCP 미연결 시 자동 fallback:
+1. grep/Grep 도구로 영향 범위 추적
+2. `claude-mem:smart-explore` (Phase β 이후 deprecated)
+3. 전체 디렉토리 읽기 (R013 ecomode 트리거 가능성)
+
+### R013 Ecomode 정합
+
+context >= 60% 시 CRG 호출 적극 권장. 8.2× 토큰 절감 (`guides/token-efficiency/crg.md` 벤치마크).
+
+Refs: #1171 (CRG 통합), #1180 (본 cross-ref 추가)
+
 ## Agent Selection
 
 | File Extension | Agent | Skill |

package/templates/CLAUDE.md

@@ -117,11 +117,11 @@ project/
 +-- CLAUDE.md                    # 진입점
 +-- .claude/
 |   +-- agents/                  # 서브에이전트 정의 (49 파일)
-|   +-- skills/                  # 스킬 (117 디렉토리)
-|   +-- rules/                   # 전역 규칙 (R000-R022)
+|   +-- skills/                  # 스킬 (118 디렉토리)
+|   +-- rules/                   # 전역 규칙 (R000-R023)
 |   +-- hooks/                   # 훅 스크립트 (보안, 검증, HUD)
 |   +-- contexts/                # 컨텍스트 파일 (ecomode)
-+-- guides/                      # 레퍼런스 문서 (49 토픽)
++-- guides/                      # 레퍼런스 문서 (54 토픽)
 ```
 
 ## 오케스트레이션

package/templates/README.md

@@ -55,7 +55,7 @@ templates/
 │   │   └── scripts/                 # 훅 셸 스크립트 (34개)
 │   ├── contexts/                    # 컨텍스트 설정 파일 (ecomode 등)
 │   └── ontology/                    # Ontology-RAG 지식 그래프
-└── guides/                          # 레퍼런스 문서 디렉토리 (50개)
+└── guides/                          # 레퍼런스 문서 디렉토리 (54개)
 ```
 
 ---
@@ -109,7 +109,7 @@ CI의 `verify-template-sync.sh`가 소스와 templates/ 간 일치를 검증합
 | `SHOULD` | 강력 권장 | R003 상호작용, R013 Ecomode |
 | `MAY` | 선택 | R005 최적화 |
 
-### Guides (51)
+### Guides (54)
 
 `guides/*/` — 레퍼런스 문서 디렉토리.
 

package/templates/guides/agentmemory-migration/measure-step-zero.md

@@ -0,0 +1,120 @@
+# AgentMemory 마이그레이션 — 단계 0: MEASURE (사용 빈도 측정)
+
+> **목적**: Phase 1 (COEXIST) 진입 전, claude-mem skill 실제 호출 빈도 데이터를 수집하여 가설 기반 자산 처리표를 검증한다.
+> **관련 이슈**: #1169 본문 조치 5
+> **참고 메모리**: `feedback_claude_mem_maintenance`, `project_sequencing_alpha_beta_gamma`
+
+---
+
+## 1. 목적
+
+AgentMemory 마이그레이션 계획(`feedback_claude_mem_maintenance.md`)에는 12개 claude-mem skill의 처리 방향이 가설로 기재되어 있다. 특히 폐기 후보 5종(`make-plan`, `do`, `babysit`, `wowerpoint`, `knowledge-agent`, `pathfinder`)은 "미사용 또는 저빈도"라는 가정 위에 놓여 있다.
+
+이 단계에서는 실측 데이터로 가설을 검증한다. 데이터 없이 Phase 1에 진입하면:
+- 실제로 자주 쓰이던 skill을 폐기하여 사용자 워크플로우가 깨질 수 있다.
+- 자산 처리표 재설계 비용이 Phase 2~3로 이월된다.
+
+---
+
+## 2. 실행 방법
+
+```bash
+# 기본 실행 (최근 7일, 리포트를 ~/.claude/measure-claude-mem-usage-YYYY-MM-DD.md 에 저장)
+bash scripts/measure-claude-mem-usage.sh
+
+# 최근 14일 스캔
+bash scripts/measure-claude-mem-usage.sh --days 14
+
+# 출력 경로 지정
+bash scripts/measure-claude-mem-usage.sh --output ~/Documents/claude-mem-usage.md
+
+# 헤더 없이 실행 (CI/파이프라인 삽입용)
+bash scripts/measure-claude-mem-usage.sh --quiet
+```
+
+### 스캔 대상 경로
+
+| 경로 | 설명 |
+|------|------|
+| `~/.claude-mem/archives/` | claude-mem MCP 아카이브 (`.jsonl`, `.json`) |
+| `~/.claude/projects/*/session-*.jsonl` | Claude Code 세션 로그 |
+
+둘 중 하나가 없어도 스크립트는 조용히 skip하고 나머지를 스캔한다.
+
+---
+
+## 3. 1주 수집 계획
+
+| 시점 | 작업 |
+|------|------|
+| **Day 1** | 첫 측정 — 베이스라인 (`--days 7` 기준 기존 archives 기반) |
+| **Day 4** | 중간 측정 — 추이 확인 (`--days 4`) |
+| **Day 7** | 최종 측정 — 자산 처리표 재검토 및 Phase 1 GO/NO-GO 결정 |
+
+세 시점 모두 `--output` 경로를 달리 지정하여 비교 가능한 파일로 보관한다:
+
+```bash
+bash scripts/measure-claude-mem-usage.sh --output ~/.claude/claude-mem-day1.md
+bash scripts/measure-claude-mem-usage.sh --days 4 --output ~/.claude/claude-mem-day4.md
+bash scripts/measure-claude-mem-usage.sh --days 7 --output ~/.claude/claude-mem-day7.md
+```
+
+---
+
+## 4. 해석 기준
+
+| 호출 수 | 신호 | 권장 조치 |
+|---------|------|----------|
+| **0** | 미사용 | 폐기 안전 — 1주 후 처리 결정 |
+| **1-3** | 가끔 사용 | wrapper 또는 대체 도구 매핑 필요 |
+| **4+** | 정기 사용 | 폐기 시 대체 도구 명확화 필수 |
+
+폐기 후보 5종 기준 예상:
+- `make-plan`, `do`, `babysit` → 0 예상 (native AgentMemory로 대체 완료)
+- `wowerpoint`, `knowledge-agent`, `pathfinder` → 0~1 예상 (특수 목적 skill)
+
+실측값이 예상과 다를 경우 자산 처리표를 수정한 후 Phase 1에 진입한다.
+
+---
+
+## 5. 결과 활용
+
+### 5-1. #1169에 리포트 첨부
+
+```bash
+gh issue comment 1169 --body-file ~/.claude/claude-mem-day7.md
+```
+
+### 5-2. 자산 처리표 갱신
+
+`.claude/agent-memory/sys-memory-keeper/feedback_claude_mem_maintenance.md` 내 "처리 방향" 열을 실측값 기반으로 업데이트한다.
+
+### 5-3. Phase 1 GO/NO-GO 결정
+
+| 조건 | 결정 |
+|------|------|
+| 폐기 후보 모두 호출 수 0 | GO — Phase 1 진입 |
+| 폐기 후보 중 1개 이상 호출 수 1-3 | CONDITIONAL GO — 대체 도구 매핑 완료 후 진입 |
+| 폐기 후보 중 1개 이상 호출 수 4+ | NO-GO — 처리표 재설계 후 재측정 |
+
+---
+
+## 6. 한계 및 주의사항
+
+| 항목 | 설명 |
+|------|------|
+| archives 미존재 | `~/.claude-mem/archives/` 없으면 카운트 0 (정상 — silent skip) |
+| 세션 로그 형식 변경 | Claude Code 업데이트로 `session-*.jsonl` 구조가 변경되면 grep 패턴 수정 필요 |
+| claude-mem MCP telemetry 미사용 | 외부 도구 의존 최소화 원칙에 따라 MCP 자체 지표는 사용하지 않음 |
+| grep 기반 측정 | 같은 파일에 skill 이름이 여러 줄 등장하면 복수 카운트됨 (과대 계산 가능성) |
+| macOS/Linux 호환 | `stat` 옵션 차이를 스크립트 내에서 자동 처리 (`-f %m` vs `-c %Y`) |
+
+---
+
+## 7. 참고
+
+- **이슈**: [#1169](../../.github/ — `gh issue view 1169`)
+- **자산 처리표**: `.claude/agent-memory/sys-memory-keeper/feedback_claude_mem_maintenance.md`
+- **시퀀싱 메모리**: `.claude/agent-memory/mgr-creator/project_sequencing_alpha_beta_gamma.md` (또는 해당 메모리 파일)
+- **스크립트**: `scripts/measure-claude-mem-usage.sh`
+- **Phase 1 가이드**: `guides/agentmemory-migration/` (이 디렉토리에 추가 예정)

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

@@ -159,7 +159,7 @@ AST 노드 그래프에 자연어 쿼리를 실행한다.
 2. /adversarial-review {minimal_context} → 보안/논리 취약점 검토
 ```
 
-<!-- TODO: 향후 cross-ref 추가 — adversarial-review 스킬 업데이트 시 -->
+> **Cross-ref**: `dev-review` 및 `adversarial-review` 스킬에 CRG 호출 패턴 통합됨 (v0.140.0, #1180).
 
 ### R013 Ecomode 활성 시
 

package/templates/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.139.0",
+  "version": "0.140.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)",
@@ -26,7 +26,7 @@
       "name": "guides",
       "path": "guides",
       "description": "Reference documentation",
-      "files": 53
+      "files": 54
     },
     {
       "name": "hooks",