oh-my-customcode 0.136.2 → 0.138.0

package/dist/cli/index.js

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

package/package.json

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

package/templates/.claude/skills/pipeline/labels.md

@@ -0,0 +1,52 @@
+# Pipeline Label Standards
+
+Canonical reference for GitHub issue label semantics in the auto-dev pipeline.
+Used by `scope-selection` to include/exclude issues and by `implement` for lifecycle management.
+
+## Label Definitions
+
+| Label | Meaning | scope-selection 처리 |
+|-------|---------|----------------------|
+| `verify-ready` | Triage 완료, 즉시 verify 가능 (자동화 후보) | INCLUDE (preferred) |
+| `verify-done` | Triage 완료했으나 deferred 또는 이미 처리됨 (이번 사이클 미포함) | EXCLUDE |
+| `in-progress` | 작업 진행 중 (다른 세션에서 claim됨) | EXCLUDE |
+| `needs-review` | 사람 검토 필요 (자동 파이프라인 진입 불가) | EXCLUDE |
+| `decision-needed` | 결정 필요 (보안, 정책 critical) | EXCLUDE |
+| `automated` | Auto-generated issue (claude-native skill 등) | INCLUDE if other criteria met |
+| `claude-code-release` | CC version compat docs trigger | INCLUDE (preferred) |
+| `documentation` | Docs scope | INCLUDE (preferred for docs-only release) |
+| `enhancement-yaml-only` | YAML/config-only scope change | INCLUDE (eligible for docs-only compression) |
+
+## Selection Rule
+
+```
+EXCLUDE if:
+  - blocked_by_decision == true
+  - labels ∩ {decision-needed, needs-review, verify-done, manual-action, in-progress} ≠ ∅
+
+INCLUDE (preferred tier):
+  - labels ∩ {verify-ready, claude-code-release, documentation} ≠ ∅
+
+INCLUDE (standard tier):
+  - P1/P2/P3 issues not in excluded set
+
+Tie-break priority: P1 > P2 > P3 > unclassified
+```
+
+## Compression Eligibility (G6)
+
+An issue is eligible for `docs-only` compression mode if its labels include at least one of:
+`documentation`, `automated`, `claude-code-release`, `enhancement-yaml-only`
+
+If ALL scoped issues are compression-eligible AND scope size ≤ 3, the pipeline MAY use
+`compression_mode=docs-only` (skip professor-triage / release-plan / deep-plan / deep-verify skill spawns).
+
+## Lifecycle Labels (set by `implement` step)
+
+| Transition | Action |
+|-----------|--------|
+| Work started | Add `in-progress`, assign @me |
+| Work succeeded | Remove `in-progress`, add `verify-ready` |
+| Work failed | Remove `in-progress`, add `needs-review` |
+| Released | Remove `verify-ready`, close with "Fixed in v{version}" |
+| Deferred | Add `verify-done`, label "Deferred from v{version}" |

package/templates/.claude/skills/pipeline/workflows/auto-dev.yaml

@@ -1,6 +1,6 @@
 name: auto-dev
 description: "Automated development pipeline — from issue triage to release"
-version: "2.0.0"
+version: "2.1.0"
 
 # Design rule: each pipeline run produces ONE bounded release unit (3-7 issues), not all open issues.
 # This pipeline is a project-agnostic template. Project-specific overrides belong in
@@ -9,6 +9,43 @@ version: "2.0.0"
 steps:
   - name: pre-triage
     prompt: |
+      Phase 0 — Sync local with remote.
+
+      1. Fetch all remote state:
+         git fetch --all --tags --prune
+
+      2. Detect behind count vs origin/HEAD branch:
+         current_branch=$(git rev-parse --abbrev-ref HEAD)
+         behind=$(git rev-list --count HEAD..origin/$current_branch)
+
+      3. If behind > 0:
+         - Working tree clean (git status --short empty):
+           git pull --ff-only
+           report: "[pre-triage] synced $behind commits"
+         - Working tree dirty:
+           HALT with "[pre-triage] $behind commits behind, working tree dirty — manual reconcile required"
+           exit 1
+
+      4. Report current state:
+         - Latest tag: git tag --sort=-v:refname | head -1
+         - Local HEAD: git rev-parse --short HEAD
+         - Behind state: synced or 0
+
+      5. Cross-reference checks (advisory, do NOT halt):
+         a. Memory vs git consistency (G7):
+            - latest_tag=$(git tag --sort=-v:refname | head -1)
+            - Compare with "Last release" or equivalent line in pipeline memory/context
+            - If mismatch: stderr warning "[pre-triage] WARNING: memory says vX.Y.Z but git latest tag is vA.B.C — update memory after pipeline completion"
+            - Do NOT halt (advisory only — memory updates are session-end responsibility)
+
+         b. Issue body stale version references (G5):
+            - Retrieve open issues: gh issue list --state open --limit 100 --json number,body
+            - For each issue body, extract all vX.Y.Z patterns (regex: v\d+\.\d+\.\d+)
+            - Retrieve git tag list: git tag --list
+            - Flag any issue referencing a version not present in git tags:
+              "[pre-triage] WARNING: Issue #N references vX.Y.Z (not in git tags) — body may be stale"
+            - Output all warnings as advisory log; do NOT halt
+
       Phase 1 — Ensure required labels exist, then scan issues.
 
       1. Create labels if missing (idempotent):
@@ -26,44 +63,95 @@ steps:
          - order: topological sort over dependencies
 
       4. Output: dependency-sorted issue table with blocked_by_decision flag.
-    description: "Ensure labels exist, scan issues, dependency-analyze"
+    description: "Sync remote, stale-version check, memory consistency check, scan issues"
 
   - name: scope-selection
     prompt: |
       Select a single bounded release scope (3-7 issues) for THIS pipeline run.
 
-      Selection rules:
+      ## Step 0 — Milestone state pre-check (G3)
+
+      Before creating a milestone for version vX.Y.Z:
+      1. Query all milestones (open and closed):
+         existing=$(gh api 'repos/{owner}/{repo}/milestones?state=all&per_page=100' --jq '.[] | select(.title == "vX.Y.Z") | "\(.number)|\(.state)"')
+      2. Evaluate:
+         - If existing && state=closed:
+           HALT with "[scope-selection] BLOCKED: milestone vX.Y.Z already exists and is closed. Bump version or reopen milestone manually."
+         - If existing && state=open:
+           Use existing milestone as-is (do not create new)
+         - If not existing:
+           Create new milestone: gh api repos/{owner}/{repo}/milestones --method POST --field title="vX.Y.Z"
+
+      ## Step 1 — Label-based filtering (G4)
+
+      Reference label semantics: .claude/skills/pipeline/labels.md
+
+      Apply filter rules:
+      - EXCLUDE: blocked_by_decision == true OR labels ∩ {decision-needed, needs-review, verify-done, manual-action, in-progress} ≠ ∅
+      - INCLUDE (preferred): labels ∩ {verify-ready, claude-code-release, documentation} ≠ ∅
+      - INCLUDE (standard): P1/P2/P3 issues not in excluded set
+      - Tie-break: P1 > P2 > P3 > unclassified
+
+      ## Step 2 — Selection rules
+
       1. Determine release tier:
          - No tags yet → v0.1.0
          - Otherwise: highest-priority open tier (bug → chore → feature)
-      2. Exclude:
-         - blocked_by_decision == true
-         - Issues requiring manual/human action
+      2. Apply Step 1 filter (label-based exclusion and preference)
       3. Sort by dependency: prerequisites before dependents
       4. Cap at 7 issues; if priority issues < 7, stop at that priority (don't mix tiers)
       5. Minimum 1 issue; if 0 eligible, halt with "no eligible issues for auto-dev run"
 
-      Create release milestone and assign scoped issues.
+      Assign scoped issues to milestone.
       Output markdown release manifest:
-        | order | # | title | prerequisite | effort |
+        | order | # | title | prerequisite | effort | labels |
 
       Persist manifest as pipeline state for subsequent steps.
-    description: "Pick 3-7 issues as v{X.Y.Z} scope, create milestone"
+    description: "Milestone state pre-check, label filter, pick 3-7 issues as v{X.Y.Z} scope"
     depends_on: pre-triage
 
+  - name: compression-mode-eval
+    prompt: |
+      Evaluate whether this pipeline run qualifies for docs-only compression mode (G6).
+
+      ## Compression Eligibility Check
+
+      Reference: .claude/skills/pipeline/labels.md — "Compression Eligibility" section
+
+      Conditions for compression_mode=docs-only:
+      1. scope size ≤ 3 (number of issues in release manifest)
+      2. ALL scoped issues have labels ∩ {documentation, automated, claude-code-release, enhancement-yaml-only} ≠ ∅
+
+      ## Decision
+
+      If BOTH conditions met → set compression_mode=docs-only
+        - triage step: skip professor-triage skill; perform direct manifest summary instead
+        - plan step: skip release-plan skill; single-response plan instead
+        - deep-plan step: skip deep-plan skill; single-response implementation notes instead
+        - deep-verify step: skip deep-verify skill; perform self-review checklist instead
+        - Log: "[compression-mode] docs-only compression activated (scope={n}, all docs/yaml labels)"
+
+      Otherwise → set compression_mode=standard
+        - All pipeline steps execute normally with full skill spawns
+        - Log: "[compression-mode] standard mode (scope={n}, mixed labels or large scope)"
+
+      Output: compression_mode value as pipeline state for downstream steps.
+    description: "Evaluate docs-only compression eligibility; set compression_mode state"
+    depends_on: scope-selection
+
   - name: triage
     skill: professor-triage
-    description: "Cross-analysis triage with priority assessment (scoped to release manifest)"
-    depends_on: scope-selection
+    description: "Cross-analysis triage with priority assessment (scoped to release manifest) — skipped if compression_mode=docs-only"
+    depends_on: compression-mode-eval
 
   - name: plan
     skill: release-plan
-    description: "Release unit plan from triaged issues"
+    description: "Release unit plan from triaged issues — skipped if compression_mode=docs-only"
     depends_on: triage
 
   - name: deep-plan
     skill: deep-plan
-    description: "Research-validated implementation plan (research → plan → verify)"
+    description: "Research-validated implementation plan (research → plan → verify) — skipped if compression_mode=docs-only"
     depends_on: plan
 
   - name: implement
@@ -112,23 +200,36 @@ steps:
 
   - name: verify-build
     prompt: |
-      Project-specific build and test verification.
-
-      Auto-detect project type and run appropriate checks:
-      - Node/Bun: package.json → install + lint + type-check + test
-      - Python: py_compile + pytest
-      - Go: go build + go vet + go test
-      - Docker: docker build (if Dockerfile exists)
-      - Static site: file existence + format validation
-
-      Halt on first failure. Report exact command + stderr.
-      Do NOT proceed to release if any check fails.
-    description: "Auto-detected build + test verification"
+      Project-specific build + test verification.
+
+      For Node/Bun projects (this repo):
+      1. bun install — verify lockfile sync (halt on lockfile drift)
+      2. bun run lint (if package.json has lint script)
+      3. bun run typecheck (if available)
+      4. bun test — MANDATORY, no silent skip
+         - Baseline reference: #1156 historically documented 86 failures; v0.136.2 fixes resolved them → current baseline = 0
+         - Each release: adopt prior version's test result as baseline (dynamic, not hardcoded)
+         - Compute current pass/fail counts
+         - If current FAIL count > baseline → NEW regression detected → halt + report failure list
+         - If current FAIL count <= baseline → continue with advisory log "X failures (baseline {n}, delta {d})"
+      5. Build verification (if package has build script)
+
+      For Python/Go/Docker/static-site projects: auto-detect and run equivalent (py_compile + pytest / go build + go vet + go test / docker build / file validation).
+
+      Halt conditions:
+      - Lint errors (exit != 0)
+      - Typecheck errors
+      - NEW test failures (regression from baseline)
+      - Build failure
+      - Lockfile drift
+
+      Halt → report exact command + stderr + delta details. Do NOT proceed to release on any halt.
+    description: "Auto-detected build + test verification (bun test with baseline delta guard)"
     depends_on: implement
 
   - name: deep-verify
     skill: deep-verify
-    description: "Multi-angle release quality verification"
+    description: "Multi-angle release quality verification — self-review checklist only if compression_mode=docs-only"
     depends_on: verify-build
 
   - name: release

package/templates/README.md

@@ -0,0 +1,195 @@
+# templates/
+
+> **oh-my-customcode 배포 디렉토리**
+>
+> `omcustom init` 실행 시 새 프로젝트에 복사되는 파일들의 소스입니다.
+
+---
+
+## 목적 (Purpose)
+
+`templates/`는 oh-my-customcode의 **배포 구조(distribution structure)**입니다.
+
+사용자가 새 프로젝트에서 `omcustom init`을 실행하면, 이 디렉토리의 내용이 대상 프로젝트 루트로 복사됩니다. 즉, 이 디렉토리는 oh-my-customcode가 제공하는 에이전트 시스템의 **완성된 스냅샷**입니다.
+
+```
+oh-my-customcode 소스 레포
+  └── templates/                   ← 배포 소스 (이 디렉토리)
+        ├── .claude/
+        ├── guides/
+        └── CLAUDE.md
+
+사용자 프로젝트 (omcustom init 후)
+  └── your-project/
+        ├── .claude/               ← templates/.claude/ 에서 복사
+        ├── guides/                ← templates/guides/ 에서 복사
+        └── CLAUDE.md              ← templates/CLAUDE.md 에서 복사
+```
+
+---
+
+## 메인 README와의 관계
+
+| 문서 | 대상 | 설명 |
+|------|------|------|
+| [`/README.md`](../README.md) | oh-my-customcode **자체** | 프로젝트 소개, 철학, 설치 가이드 |
+| `templates/README.md` (이 파일) | **배포 콘텐츠** | 배포되는 파일 구조와 카운트 |
+
+메인 README는 oh-my-customcode라는 도구를 설명합니다. 이 파일은 그 도구가 배포하는 내용물을 설명합니다.
+
+---
+
+## 디렉토리 구조
+
+```
+templates/
+├── README.md                        # 이 파일 (배포 콘텐츠 문서)
+├── CLAUDE.md                        # 에이전트 시스템 진입점
+├── manifest.json                    # 배포 컴포넌트 카운트 및 메타데이터
+├── .claude/
+│   ├── agents/                      # 에이전트 정의 파일 (*.md, 49개)
+│   ├── skills/                      # 스킬 모듈 (각 디렉토리에 SKILL.md, 117개)
+│   ├── rules/                       # 전역 규칙 (R000–R022, 22개)
+│   ├── hooks/
+│   │   ├── hooks.json               # 훅 이벤트 설정 (PreToolUse/PostToolUse 등)
+│   │   └── scripts/                 # 훅 셸 스크립트 (34개)
+│   ├── contexts/                    # 컨텍스트 설정 파일 (ecomode 등)
+│   └── ontology/                    # Ontology-RAG 지식 그래프
+└── guides/                          # 레퍼런스 문서 디렉토리 (50개)
+```
+
+---
+
+## 컴포넌트 (Components)
+
+아래 카운트는 `templates/manifest.json`과 동기화됩니다.
+CI의 `verify-template-sync.sh`가 소스와 templates/ 간 일치를 검증합니다.
+
+### Agents (49)
+
+`.claude/agents/*.md` — 에이전트 정의 파일.
+
+각 파일은 단일 전문가 에이전트를 정의합니다. frontmatter에 `name`, `description`, `model`, `tools`가 필수 포함됩니다.
+
+| 카테고리 | 수량 |
+|----------|------|
+| SW Engineer / Language | 6 |
+| SW Engineer / Backend | 6 |
+| SW Engineer / Frontend | 5 |
+| SW Engineer / Tooling | 4 |
+| DE Engineer | 6 |
+| SW Engineer / Database | 4 |
+| Security | 1 |
+| SW Architect | 2 |
+| Infra Engineer | 2 |
+| QA Team | 3 |
+| Manager | 6 |
+| System | 4 |
+
+### Skills (117)
+
+`.claude/skills/*/SKILL.md` — 재사용 가능한 스킬 모듈.
+
+각 스킬 디렉토리에 `SKILL.md`가 있으며, 필요에 따라 `scripts/` 서브디렉토리를 포함합니다.
+
+스킬 범위(`scope`):
+- `core` — 범용 개발 도구 (init 시 배포됨)
+- `harness` — 에이전트/스킬/룰 유지보수 도구 (init 시 배포됨)
+- `package` — 패키지 특화 도구 (선택 배포)
+
+### Rules (22)
+
+`.claude/rules/*.md` — 에이전트 행동 규칙 (R000–R022, R014 없음).
+
+파일명 형식: `{PRIORITY}-{name}.md` (예: `MUST-agent-identification.md`)
+
+| 우선순위 | 의미 | 예 |
+|----------|------|-----|
+| `MUST` | 절대 준수 | R007 에이전트 식별, R009 병렬 실행 |
+| `SHOULD` | 강력 권장 | R003 상호작용, R013 Ecomode |
+| `MAY` | 선택 | R005 최적화 |
+
+### Guides (50)
+
+`guides/*/` — 레퍼런스 문서 디렉토리.
+
+각 디렉토리는 단일 토픽에 대한 best practices, 튜토리얼, 또는 설계 가이드를 담습니다. 에이전트가 작업 중 참조합니다 (R006 관심사 분리).
+
+### Hooks (34)
+
+`.claude/hooks/scripts/*.sh` — 라이프사이클 훅 스크립트.
+
+`hooks.json`에 정의된 이벤트(PreToolUse, PostToolUse, Stop 등)에 반응합니다.
+
+주요 훅 스크립트:
+
+| 스크립트 | 역할 |
+|----------|------|
+| `secret-filter.sh` | API 키/시크릿 노출 방지 |
+| `stage-blocker.sh` | 스테이지 게이트 강제 |
+| `rule-deletion-guard.sh` | 규칙 파일 삭제 차단 |
+| `stuck-detector.sh` | 에이전트 무한루프 감지 |
+| `context-budget-advisor.sh` | 컨텍스트 예산 경고 |
+| `cost-cap-advisor.sh` | 비용 한도 초과 경고 |
+
+---
+
+## 사용 방법 (Usage)
+
+### omcustom init
+
+```bash
+# 전역 설치
+npm install -g oh-my-customcode
+
+# 프로젝트에 oh-my-customcode 초기화
+cd your-project
+omcustom init
+```
+
+`omcustom init`은 이 `templates/` 디렉토리의 내용을 대상 프로젝트에 복사합니다:
+1. `.claude/` 전체 (agents, skills, rules, hooks, contexts, ontology)
+2. `guides/` 전체
+3. `CLAUDE.md` (프로젝트 진입점)
+
+### 선택적 업데이트
+
+이미 초기화된 프로젝트를 최신 버전으로 업데이트할 때:
+
+```bash
+omcustom update
+```
+
+---
+
+## 동기화 검증
+
+소스(`.claude/`, `guides/`)와 `templates/` 간 동기화는 CI에서 자동 검증됩니다.
+
+```bash
+# 로컬 검증
+bash .github/scripts/verify-template-sync.sh
+```
+
+검증 항목:
+- 스킬 수 일치 (`.claude/skills/` ↔ `templates/.claude/skills/`)
+- 에이전트 수 일치
+- 룰 수 일치
+- 가이드 수 일치
+- 훅 스크립트 수 일치
+- `manifest.json` 카운트 일치
+
+소스에 새 파일을 추가할 때는 반드시 `templates/`에도 동기화해야 합니다.
+`manifest.json`의 카운트도 함께 업데이트하세요.
+
+---
+
+## 기여 가이드 참조
+
+에이전트, 스킬, 룰 추가/수정 시 3중 동기화가 필요합니다:
+
+1. **원본**: `.claude/agents/`, `.claude/skills/`, `.claude/rules/`, `guides/`
+2. **templates 복사**: `templates/.claude/agents/`, `templates/.claude/skills/` 등
+3. **카운트 업데이트**: `templates/manifest.json`, `README.md`, `CLAUDE.md` 등
+
+자세한 내용은 프로젝트 루트의 기여 가이드 및 `guides/` 참조 문서를 확인하세요.

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

@@ -1,7 +1,7 @@
 # Claude Code Version Compatibility
 
-> Updated: 2026-05-14
-> Source: Claude Code release notes (#967, #968, #969, #1126 auto-detected by claude-native skill, #1137)
+> Updated: 2026-05-15
+> Source: Claude Code release notes (#967, #968, #969, #1126 auto-detected by claude-native skill, #1137, #1158)
 
 ## Compatibility Baseline
 
@@ -139,6 +139,133 @@ transcript view에서 다음 단축키를 사용할 수 있습니다:
 
 **Action items**: P3 audit 2건 (관리형 marketplace 정책 + plugin.json default folder 검증). 모두 후속 release 별도 처리.
 
+## v2.1.142 (2026-05-14) — 호환성 점검
+
+> Issue: #1158 — CC v2.1.142 compatibility documentation
+
+### `claude agents` 신규 플래그 — 백그라운드 세션 설정
+
+`claude agents` 명령에 백그라운드 세션을 직접 구성하는 플래그가 추가되었습니다.
+
+```bash
+claude agents --add-dir <path>          # 추가 디렉토리 접근 권한
+claude agents --settings <path>         # 커스텀 settings 파일 경로
+claude agents --mcp-config <path>       # MCP 설정 파일 경로
+claude agents --plugin-dir <path>       # 플러그인 디렉토리 경로
+claude agents --permission-mode <mode>  # 권한 모드 지정
+claude agents --model <model>           # 사용할 모델 지정
+claude agents --effort <level>          # effort 레벨 지정
+claude agents --dangerously-skip-permissions  # 권한 프롬프트 생략
+```
+
+**oh-my-customcode 연관**: R009 병렬 에이전트, R018 Agent Teams 고급 운영 시 활용 가능. 특히 `--permission-mode`, `--model`, `--effort` 플래그는 R006 에이전트 프론트매터의 값을 CLI 레벨에서 오버라이드하는 경로를 제공합니다. `--dangerously-skip-permissions`는 CI/unattended 환경에서 `bypassPermissions`(R010)와 동등한 효과. **Action required: None** — 기존 harness 운영에 영향 없음.
+
+### Fast Mode 기본 모델 변경: Opus 4.7
+
+Fast Mode 활성화 시 기본 모델이 Opus 4.6에서 **Opus 4.7**로 변경되었습니다.
+
+```bash
+# Opus 4.6으로 고정하려면 (이전 동작 유지)
+export CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1
+```
+
+**oh-my-customcode 연관**: R006 에이전트 프론트매터에서 `model: opus`를 사용하는 에이전트(arch-documenter, arch-speckit-agent 등)와 Fast Mode 상호작용에 주의. Fast Mode 토글(`/fast`)이 활성화된 세션에서는 Opus 4.7이 자동으로 선택됩니다. R012 statusline의 모델 표기도 4.7로 반영됩니다. 모델 변경에 따른 동작 차이가 있을 경우 위 환경 변수로 고정 가능.
+
+### Plugin root-level SKILL.md 지원
+
+플러그인 루트에 `SKILL.md`가 존재하면 `skills/` 서브디렉토리 없이도 스킬로 노출됩니다.
+
+**oh-my-customcode 연관**: oh-my-customcode는 `.claude/skills/<name>/SKILL.md` 패턴을 사용하므로 직접 영향 없음. 외부 플러그인이 루트 `SKILL.md`를 통해 스킬을 노출할 경우, 라우팅 스킬(R019 enrichment)이 이를 자동 감지합니다.
+
+### `/plugin details` — LSP 서버 표시
+
+`claude plugin details <name>` 명령의 상세 정보 패널에 플러그인이 제공하는 **LSP 서버** 목록이 추가됩니다.
+
+**oh-my-customcode 연관**: 플러그인 인벤토리 가시성 향상. LSP 통합 플러그인(ex: context7) 사용 시 서버 상태 확인에 활용 가능. 직접적인 harness 변경 불필요.
+
+### `/web-setup` — 기존 GitHub App 연결 교체 경고
+
+`/web-setup` 실행 시 기존 GitHub App 연결을 대체하기 전에 경고를 표시합니다.
+
+**oh-my-customcode 연관**: 영향 없음 (UX 안전장치, mgr-gitnerd GitHub 연동과 무관).
+
+### `MCP_TOOL_TIMEOUT` 수정 — 원격 MCP 서버 타임아웃
+
+`MCP_TOOL_TIMEOUT` 환경 변수가 원격 HTTP/SSE MCP 서버의 요청별 fetch 타임아웃을 실제로 높이도록 수정되었습니다 (기존 60초 상한선 해제).
+
+```bash
+export MCP_TOOL_TIMEOUT=120000  # 120초 (밀리초 단위)
+```
+
+**oh-my-customcode 연관**: `claude-mem`, `ontology-rag` 등 원격 MCP 서버를 사용하는 R011/R019 연동에서 타임아웃 문제가 있었다면 이 변수로 해결 가능. 네트워크 지연이 큰 환경에서 MCP 도구 호출 실패율 감소 기대.
+
+### BG 세션 / Git Worktree Edit 차단 수정
+
+백그라운드 세션에서 기존 git worktree 내 파일 편집이 차단되던 문제가 수정되었습니다.
+
+**oh-my-customcode 연관**: `mgr-gitnerd`가 worktree를 사용하는 브랜치 병렬 작업 시나리오에서 R009 병렬 에이전트 운영이 안정화됩니다.
+
+### BG 세션 macOS sleep/wake 소멸 수정
+
+macOS 절전/복귀 후 백그라운드 세션이 사라지던 문제가 수정되었습니다. 데몬이 클럭 점프를 감지하여 세션을 유지합니다.
+
+**oh-my-customcode 연관**: R018 Agent Teams 장시간 실행 세션의 안정성 개선. 긴 병렬 작업 중 macOS 절전 시 세션 유실 방지.
+
+### 데몬 바이너리 업그레이드 후 충돌 루프 수정
+
+`brew upgrade` 등 바이너리 업그레이드 후 데몬이 crash-loop에 빠지던 문제가 수정되었습니다.
+
+**oh-my-customcode 연관**: 영향 없음 (플랫폼 안정성 개선).
+
+### Claude-in-Chrome 확장 공유 탭 없을 때 BG 에이전트 충돌 수정
+
+**oh-my-customcode 연관**: 영향 없음 (브라우저 자동화 사용 시 환경 안정성 개선).
+
+### `claude agents` 연결 시 링크 클릭 수정
+
+연결된 `claude agents` 세션에서 링크 클릭 시 headless browser shim이 적용되지 않도록 수정되었습니다.
+
+**oh-my-customcode 연관**: 영향 없음 (UX 수정).
+
+### `claude agents` "v to open in editor" 수정
+
+`$EDITOR`/`$VISUAL` 환경 변수를 존중하도록 수정되었습니다 (기존: 데몬 기본값 사용).
+
+**oh-my-customcode 연관**: 영향 없음 (UX 수정).
+
+### `claude agents` Windows 네트워크 드라이브 데드락 수정
+
+**oh-my-customcode 연관**: macOS 개발 환경에는 영향 없음.
+
+### Apple Terminal 256색 배경색 번짐 수정
+
+`claude agents` 세션 연결 시 256색 터미널에서 배경색이 번지던 문제가 수정되었습니다.
+
+**oh-my-customcode 연관**: 영향 없음 (터미널 렌더링 수정).
+
+### `claude --bg --dangerously-skip-permissions` 유지 수정
+
+retire/wake 사이클 후에도 `--dangerously-skip-permissions` 플래그가 유지되도록 수정되었습니다.
+
+**oh-my-customcode 연관**: R010 unattended 실행 안정성 개선. 장시간 백그라운드 에이전트 실행 시 권한 모드 드롭 방지.
+
+### oh-my-customcode 연관 평가
+
+| 변경 | 영향 | Action |
+|------|------|--------|
+| `claude agents` 신규 플래그 | 고급 세션 구성 가능 | None (opt-in) |
+| Fast Mode 기본 모델 → Opus 4.7 | `model: opus` 에이전트 + Fast Mode 상호작용 | 필요 시 `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1` |
+| Plugin root SKILL.md | omcustom 패턴 미해당 | None |
+| `/plugin details` LSP 표시 | 인벤토리 가시성 향상 | None |
+| `/web-setup` 교체 경고 | UX 안전장치 | None |
+| `MCP_TOOL_TIMEOUT` 수정 | R011/R019 MCP 타임아웃 해결 | 필요 시 환경 변수 설정 |
+| BG + git worktree Edit 차단 수정 | R009 worktree 병렬 작업 안정화 | None |
+| BG macOS sleep/wake 소멸 수정 | R018 장시간 세션 안정성 | None |
+| 데몬 crash-loop 수정 | 플랫폼 안정성 | None |
+| 기타 버그 수정 (Chrome ext, links, editor, Windows, 256색, BG permissions) | 환경별 안정성 개선 | None |
+
+**Action items**: Fast Mode를 사용하는 경우 Opus 4.7 전환 영향을 확인하고, 필요 시 `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1`로 고정. `MCP_TOOL_TIMEOUT` 설정이 필요한 환경에서는 선택적으로 적용.
+
 ## v2.1.141 (2026-05-13) — 호환성 점검
 
 > Issue: #1137 — CC v2.1.141 compatibility documentation
@@ -153,7 +280,7 @@ transcript view에서 다음 단축키를 사용할 수 있습니다:
 }
 ```
 
-**oh-my-customcode 연관**: R012 HUD 이벤트 채널(stderr hooks)의 보완 수단. `terminalSequence`를 통해 창 제목(window title)을 태스크 상태로 업데이트하거나 긴 병렬 작업 완료 시 벨 신호를 보내는 활용이 가능합니다. **훅 수정은 별도 보안 승인이 필요** — `.claude/hooks/` 변경 시 사용자 명시 승인 필요 (R001).
+**oh-my-customcode 연관**: R012 HUD 이벤트 채널(stderr hooks)의 보완 수단. 현재 HUD는 stderr를 통해 에이전트 스폰 이벤트를 알리는데, `terminalSequence`를 통해 창 제목(window title)을 태스크 상태로 업데이트하거나 긴 병렬 작업 완료 시 벨 신호를 보내는 활용이 가능합니다. **훅 수정은 별도 보안 승인이 필요** — `.claude/hooks/` 변경 시 사용자 명시 승인 필요 (R001).
 
 ### 플러그인 설치: `CLAUDE_CODE_PLUGIN_PREFER_HTTPS`
 
@@ -164,36 +291,70 @@ export CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1
 claude plugin install superpowers
 ```
 
-**oh-my-customcode 연관**: GitHub SSH 키가 없는 CI 환경이나 기업 방화벽 환경에서 플러그인 설치 시 활용. 기존 설치 명령어에는 변경 불필요 (HTTPS는 opt-in).
+**oh-my-customcode 연관**: GitHub SSH 키가 없는 CI 환경이나 기업 방화벽 환경에서 oh-my-customcode 플러그인 설치 시 활용. CLAUDE.md 외부 의존성 섹션의 설치 명령어에는 변경 불필요 (HTTPS는 opt-in).
 
 ### 워크로드 아이덴티티: `ANTHROPIC_WORKSPACE_ID`
 
 Federation 규칙이 둘 이상의 workspace를 커버하는 경우, 발급 토큰을 특정 workspace로 스코핑하는 환경 변수입니다.
 
-**oh-my-customcode 연관**: 멀티 workspace 엔터프라이즈 환경에서 workspace 격리 강화. 현재 단일 workspace 사용자에게는 영향 없음.
+```bash
+export ANTHROPIC_WORKSPACE_ID=ws_xxxxxxxxxxxx
+```
+
+**oh-my-customcode 연관**: 멀티 workspace 엔터프라이즈 환경에서 R001(안전 규칙) 준수 측면의 워크스페이스 격리 강화. 현재 단일 workspace 사용자에게는 영향 없음.
 
 ### `claude agents --cwd <path>` — 디렉토리 스코프 세션 목록
 
+`claude agents` 명령이 `--cwd` 플래그를 지원합니다. 특정 디렉토리로 세션 목록을 필터링합니다.
+
 ```bash
 claude agents --cwd /workspace/repos/oh-my-customcode
+claude agents --cwd ~/projects/my-service
 ```
 
-**oh-my-customcode 연관**: R009 병렬 에이전트 모니터링 시 노이즈 감소. 모노레포/멀티 프로젝트 환경에서 현재 프로젝트 에이전트만 추적 가능.
+**oh-my-customcode 연관**: R009 병렬 에이전트 모니터링 시 노이즈 감소. 모노레포 또는 멀티 프로젝트 환경에서 현재 프로젝트 에이전트만 추적 가능. `guides/claude-code/13-cli-flags.md`에 `--cwd` 플래그 추가 권장 (별도 P3).
+
+### `/feedback` 최근 세션 포함 지원
+
+`/feedback` 명령이 최근 24시간 또는 7일 세션을 포함할 수 있게 되었습니다. 현재 세션을 넘나드는 이슈 제보 시 유용합니다.
+
+**oh-my-customcode 연관**: 멀티 세션에 걸친 에이전트 동작 이슈(R016 위반 패턴 등)를 Anthropic에 제보할 때 재현 컨텍스트를 자동 포함. 직접적인 harness 변경 불필요.
+
+### Rewind 메뉴: "Summarize up to here"
+
+Rewind 메뉴에 이전 턴까지의 컨텍스트를 압축하되 최근 대화를 보존하는 옵션이 추가되었습니다.
+
+**oh-my-customcode 연관**: R013 ecomode context budget 관리와 상호 보완. 수동 context 압축 도구로 활용 가능 (PreCompact/PostCompact 훅 — R006 Hook Event Types). `sys-memory-keeper`가 세션 종료 시 메모리를 저장하는 R011 패턴과 함께 사용하면 중요 컨텍스트 유실 없이 압축 가능.
+
+### Auto mode 권한 다이얼로그 개선
+
+`permissions.ask` 규칙이 권한 프롬프트를 트리거한 경우, 다이얼로그가 그 이유를 명시적으로 표시합니다.
+
+**oh-my-customcode 연관**: R002 권한 규칙 디버깅 개선. `bypassPermissions` 모드에서 예상치 못한 권한 프롬프트 발생 시 원인 파악이 쉬워짐. 개발자가 `.claude/hooks/hooks.json` 또는 settings의 `permissions` 설정을 진단하는 데 직접 도움.
+
+### IDE 연결 시 "view diff in your IDE" 복원
+
+파일 편집 권한 프롬프트에서 IDE 연결 상태일 때 "view diff in your IDE" 옵션이 복원되었습니다.
+
+**oh-my-customcode 연관**: 영향 없음 (UX 복원, harness 연동 없음).
 
 ### `/bg` 백그라운드 에이전트 권한 모드 유지
 
 `/bg` 또는 `←←`로 실행된 백그라운드 에이전트가 기본값으로 되돌아가지 않고 현재 세션의 권한 모드를 유지합니다.
 
-**oh-my-customcode 연관**: R010 `bypassPermissions` 맥락의 중요 개선. **v2.1.141+에서는 `/bg` 플로우에서 권한 모드 드롭이 발생하지 않음** — Agent tool 호출 시 `mode: "bypassPermissions"` 명시는 여전히 필요.
+**oh-my-customcode 연관**: R010 `bypassPermissions` 맥락에서 중요한 개선. 이전에는 `/bg`로 에이전트를 분리하면 `bypassPermissions` 설정이 유실되어 unattended 실행 중 권한 프롬프트가 발생할 수 있었습니다. **v2.1.141+에서는 `/bg` 플로우에서 권한 모드 드롭이 더 이상 발생하지 않음** — R010 Universal bypassPermissions 규칙은 Agent tool 호출에 여전히 필요하지만, `/bg` 전환 시 추가 workaround 불필요.
 
-### 기타 변경
+### `claude agents`: 백그라운드 셸 잔류 에이전트 상태 수정
 
-- `/feedback` — 최근 24h/7d 세션 포함 지원 (멀티 세션 이슈 제보 개선)
-- Rewind "Summarize up to here" — 최근 턴 보존하며 이전 컨텍스트 압축 (R013 ecomode 보완)
-- Auto mode 권한 다이얼로그 — `permissions.ask` 규칙 트리거 시 이유 표시 (R002 디버깅 개선)
-- "view diff in your IDE" — IDE 연결 시 파일 편집 권한 프롬프트에서 복원
-- `claude agents` Completed 상태 수정 — 백그라운드 셸 잔류 에이전트 올바른 상태 표시 (R009 가시성 개선)
-- thinking 스피너 개선 — opus/opusplan 사용 에이전트에서 체감
+작업을 완료했으나 백그라운드 셸이 계속 실행 중인 에이전트가 Working 대신 Completed 상태로 올바르게 표시됩니다.
+
+**oh-my-customcode 연관**: R009 병렬 에이전트 상태 가시성 개선. `claude agents`로 병렬 작업 모니터링 시 허위 Working 상태로 인한 혼란 감소.
+
+### 장시간 thinking 중 스피너 피드백 개선
+
+긴 reasoning 구간에서 스피너 표시가 개선되었습니다.
+
+**oh-my-customcode 연관**: 영향 없음 (UX 개선, opus/opusplan 모델 사용 에이전트에서 체감 가능).
 
 ### oh-my-customcode 연관 평가
 
@@ -203,10 +364,40 @@ claude agents --cwd /workspace/repos/oh-my-customcode
 | `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | CI/기업 환경 플러그인 설치 | None (opt-in) |
 | `ANTHROPIC_WORKSPACE_ID` | 멀티 workspace 환경 | None (단일 workspace) |
 | `claude agents --cwd` | 프로젝트별 세션 필터링 | P3: cli-flags 가이드 업데이트 |
-| `/bg` 권한 모드 유지 | R010 `/bg` 플로우 안전성 향상 | R010 규칙 노트 추가 (완료) |
-| 기타 additive 변경 | 사용자 환경 안정성 향상 | None |
+| `/feedback` 세션 범위 확장 | 이슈 제보 개선 | None |
+| Rewind "Summarize up to here" | R013 수동 context 압축 | None |
+| Auto mode 권한 다이얼로그 | R002 디버깅 개선 | None (수동적 효익) |
+| IDE diff 옵션 복원 | UX 복원 | None |
+| `/bg` 권한 모드 유지 | R010 `/bg` 플로우 안전성 향상 | **R010 규칙 노트 업데이트** |
+| `claude agents` Completed 상태 수정 | R009 상태 가시성 개선 | None |
+| thinking 스피너 개선 | UX | None |
+
+**Action items**: P3 2건 (`terminalSequence` hook 검토, cli-flags 가이드 `--cwd` 추가). R010 규칙 문서에 `/bg` 권한 모드 유지 노트 추가 (이번 release에서 처리).
+
+---
+
+## Known Limitations
+
+### `.gitignore` 중첩 `.md` 파일 패턴 제한
+
+현재 `.gitignore`에는 다음 패턴이 설정되어 있습니다:
+
+```gitignore
+docs/superpowers/plans/*
+!docs/superpowers/plans/*.md
+```
+
+이 패턴은 `docs/superpowers/plans/` **직접 자식** `.md` 파일만 추적합니다. git 시맨틱상 부모 디렉토리가 이미 제외(`*`)되면, 자식 디렉토리 내 파일의 `!` 부정 패턴이 효력을 발휘하지 않습니다. 예를 들어 `docs/superpowers/plans/subdir/plan.md`는 추적되지 않습니다.
+
+**현재 영향**: 없음. `release-plan` 스킬은 `docs/superpowers/plans/YYYY-MM-DD-<name>.md` 플랫 경로만 생성합니다. 중첩 `.md` 파일 추적이 필요해질 경우의 수정 방안:
+
+```gitignore
+docs/superpowers/plans/**
+!docs/superpowers/plans/*.md
+!docs/superpowers/plans/<subdir>/*.md  # 추적이 필요한 서브디렉토리 명시
+```
 
-**Action items**: P3 2건 (`terminalSequence` hook 검토, cli-flags `--cwd` 추가). R010 규칙 `/bg` 노트 추가 (이번 release 처리).
+> Issue: #1147 — 문서화 전용, 코드 변경 없음.
 
 ---
 
@@ -220,6 +411,7 @@ claude agents --cwd /workspace/repos/oh-my-customcode
 | v2.1.139 | None (additive). `/context all` fork skill 비용 모니터링 권장 | P3 follow-up |
 | v2.1.140 | P3 audit: managed `extraKnownMarketplaces` 영속화 + plugin.json default folder 무시 경고 | P3 follow-up |
 | v2.1.141 | P3: `terminalSequence` hook 검토 + cli-flags `--cwd` 추가. R010 `/bg` 권한 모드 유지 노트 추가 (완료) | P3 follow-up |
+| v2.1.142 | Fast Mode Opus 4.7 전환 확인 (필요 시 `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1`). `MCP_TOOL_TIMEOUT` 선택적 설정. | P3 follow-up |
 
 ## References
 
@@ -229,6 +421,8 @@ claude agents --cwd /workspace/repos/oh-my-customcode
 - #1126 — Claude Code v2.1.139 신규 명령 문서화
 - #1134 — Claude Code v2.1.140 release note
 - #1137 — Claude Code v2.1.141 compatibility documentation
+- #1158 — Claude Code v2.1.142 compatibility documentation
+- #1147 — .gitignore nested .md pattern limitation note
 - `.claude/skills/claude-native/` — auto-generation source
 - `.claude/rules/SHOULD-hud-statusline.md` — R012 statusline integration
 - `.claude/rules/MUST-agent-design.md` — R006 agent frontmatter spec

package/templates/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.136.2",
+  "version": "0.138.0",
   "lastUpdated": "2026-05-14T00:00:00.000Z",
   "omcustomMinClaudeCode": "2.1.121",
   "omcustomMinClaudeCodeReason": "Sensitive-path direct Write/Edit on .claude/** under bypassPermissions (R010 deprecation, #1101)",