oh-my-customcode 0.144.0 → 0.146.0

package/dist/cli/index.js

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

package/package.json

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

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

@@ -546,6 +546,16 @@
         ],
         "description": "Auto-extract failure patterns from session outcomes (advisory, exit 0)"
       },
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash .claude/hooks/scripts/session-reflection.sh"
+          }
+        ],
+        "description": "Transcript-based self-reflection: detect R007/R008 violations and log to .claude/outputs/reflections/ (Phase 1 MVP, advisory, exit 0)"
+      },
       {
         "matcher": "*",
         "hooks": [

package/templates/.claude/hooks/scripts/session-reflection.sh

@@ -0,0 +1,182 @@
+#!/usr/bin/env bash
+# session-reflection.sh — Stop hook: transcript-based self-reflection for R007/R008 violations
+# Phase 1 MVP: detects header absence (R007) and tool prefix absence (R008)
+# Advisory-only: always exits 0, never blocks session end
+#
+# 환경변수 override (테스트/디버깅용):
+#   OMCUSTOM_SESSION_REFLECTION=off  — 분석 완전 비활성화
+#   OMCUSTOM_TRANSCRIPT_BASE        — transcript 디렉토리 경로 override
+#   OMCUSTOM_PROJECT_ROOT           — 프로젝트 루트 override (.claude/outputs/reflections 기준)
+
+set -euo pipefail
+
+# ── Stop hook 프로토콜: stdin을 먼저 읽음 ──
+input=$(cat)
+
+# ── Opt-out 체크 ──
+if [ "${OMCUSTOM_SESSION_REFLECTION:-}" = "off" ]; then
+  echo "$input"
+  exit 0
+fi
+
+# ── jq 의존성 체크 ──
+if ! command -v jq >/dev/null 2>&1; then
+  echo "$input"
+  exit 0
+fi
+
+# ── session_id 추출 ──
+session_id=$(echo "$input" | jq -r '.session_id // empty' 2>/dev/null)
+if [ -z "$session_id" ]; then
+  echo "$input"
+  exit 0
+fi
+
+# ── 경로 결정 (환경변수 override 지원) ──
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# transcript 기본 경로 (OMCUSTOM_TRANSCRIPT_BASE 로 override 가능)
+TRANSCRIPT_BASE="${OMCUSTOM_TRANSCRIPT_BASE:-${HOME}/.claude/projects/-Users-sangyi-workspace-projects-oh-my-customcode}"
+TRANSCRIPT_PATH="${TRANSCRIPT_BASE}/${session_id}.jsonl"
+
+if [ ! -f "$TRANSCRIPT_PATH" ]; then
+  echo "$input"
+  exit 0
+fi
+
+# 프로젝트 루트 (OMCUSTOM_PROJECT_ROOT 로 override 가능)
+PROJECT_ROOT="${OMCUSTOM_PROJECT_ROOT:-$(cd "${SCRIPT_DIR}/../../.." && pwd)}"
+
+# ── 백그라운드 분석 스크립트를 임시 파일로 생성 ──
+# nohup bash -c "..." 또는 heredoc 방식은 글로브 확장/shell escape/stdin 충돌 문제 발생.
+# 임시 파일 방식은 이 문제를 완전히 회피한다.
+WORKER_SCRIPT="/tmp/.claude-reflection-worker-${PPID}-$$.sh"
+
+cat > "$WORKER_SCRIPT" <<'WORKER_EOF'
+#!/usr/bin/env bash
+# Background worker: transcript analysis for R007/R008 violations
+
+set -euo pipefail
+
+TRANSCRIPT_PATH="$1"
+PROJECT_ROOT="$2"
+SESSION_ID="$3"
+SCRIPT_DIR="$4"
+
+# 출력 디렉토리 준비
+OUTPUT_DIR="${PROJECT_ROOT}/.claude/outputs/reflections"
+mkdir -p "${OUTPUT_DIR}"
+
+LOG_FILE="${OUTPUT_DIR}/$(date +%Y-%m-%d).md"
+ISO8601="$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
+
+# ── transcript 파싱 ──
+r007_violations=0
+r008_violations=0
+total_turns=0
+sample_count=0
+sample_lines=""
+
+while IFS= read -r line; do
+  role=$(echo "$line" | jq -r '.role // empty' 2>/dev/null) || continue
+  [ "$role" = "assistant" ] || continue
+
+  total_turns=$((total_turns + 1))
+  turn_idx=$total_turns
+
+  # content 배열 파싱
+  content_raw=$(echo "$line" | jq -c '.content // []' 2>/dev/null) || continue
+
+  # ── R007: 첫 번째 text 블록의 첫 줄 체크 ──
+  first_text=$(echo "$content_raw" | jq -r '[.[] | select(.type == "text")][0].text // empty' 2>/dev/null) || true
+  if [ -n "$first_text" ]; then
+    first_line=$(printf '%s' "$first_text" | head -1)
+    # R007 패턴: '┌─ Agent:' 또는 '[anything]' 단축 형태
+    if ! printf '%s' "$first_line" | grep -qE '(^┌─ Agent:|^\[.+\])'; then
+      r007_violations=$((r007_violations + 1))
+      if [ $sample_count -lt 3 ]; then
+        # 120자 truncate (secret-filter.sh는 PostToolUse용이라 여기서는 단순 truncate)
+        safe_text=$(printf '%s' "$first_line" | head -c 120)
+        sample_lines="${sample_lines}
+- [R007 turn ${turn_idx}]: ${safe_text}"
+        sample_count=$((sample_count + 1))
+      fi
+    fi
+  fi
+
+  # ── R008: tool_use 블록 직전 text에 prefix 체크 ──
+  content_length=$(echo "$content_raw" | jq 'length' 2>/dev/null) || continue
+
+  i=0
+  while [ $i -lt "$content_length" ]; do
+    block_type=$(echo "$content_raw" | jq -r ".[$i].type // empty" 2>/dev/null) || { i=$((i+1)); continue; }
+
+    if [ "$block_type" = "tool_use" ]; then
+      tool_name=$(echo "$content_raw" | jq -r ".[$i].name // empty" 2>/dev/null) || true
+
+      # 직전 블록이 text이고 R008 prefix를 포함하는지 체크
+      has_prefix=false
+      if [ $i -gt 0 ]; then
+        prev_type=$(echo "$content_raw" | jq -r ".[$(( i - 1 ))].type // empty" 2>/dev/null) || true
+        if [ "$prev_type" = "text" ]; then
+          prev_text=$(echo "$content_raw" | jq -r ".[$(( i - 1 ))].text // empty" 2>/dev/null) || true
+          # R008 패턴: '[agent-name][model] → Tool:' 또는 '→ Target:'
+          if printf '%s' "$prev_text" | grep -qE '\[.+\]\[.+\] ?(→|->|—>) ?(Tool|Target):'; then
+            has_prefix=true
+          fi
+        fi
+      fi
+
+      if [ "$has_prefix" = "false" ]; then
+        r008_violations=$((r008_violations + 1))
+        if [ $sample_count -lt 3 ]; then
+          sample_lines="${sample_lines}
+- [R008 turn ${turn_idx}]: ${tool_name}, missing prefix"
+          sample_count=$((sample_count + 1))
+        fi
+      fi
+    fi
+
+    i=$((i+1))
+  done
+
+done < "$TRANSCRIPT_PATH"
+
+# ── 로그 작성 ──
+{
+  echo ""
+  echo "## Session ${SESSION_ID} — ${ISO8601}"
+  echo ""
+  echo "- **R007 violations**: ${r007_violations}"
+  echo "- **R008 violations**: ${r008_violations}"
+  echo "- Total assistant turns analyzed: ${total_turns}"
+  if [ $sample_count -gt 0 ]; then
+    echo ""
+    echo "### Sample violations (최대 3개)"
+    printf '%s\n' "${sample_lines}"
+  fi
+} >> "${LOG_FILE}"
+
+echo "[session-reflection] Analysis complete: R007=${r007_violations} R008=${r008_violations} turns=${total_turns}" >&2
+WORKER_EOF
+
+chmod +x "$WORKER_SCRIPT"
+
+# ── 백그라운드로 실행 (Stop hook 시간 예산 <3s 준수) ──
+# setsid로 부모 종료 후에도 실행 지속; 완료 후 임시 파일 자정리
+WORKER_ERR_LOG="/tmp/.claude-reflection-err-${PPID}.log"
+
+(
+  bash "$WORKER_SCRIPT" \
+    "$TRANSCRIPT_PATH" \
+    "$PROJECT_ROOT" \
+    "$session_id" \
+    "$SCRIPT_DIR" \
+    2>>"$WORKER_ERR_LOG"
+  rm -f "$WORKER_SCRIPT"
+) &
+disown $! 2>/dev/null || true
+
+# ── 즉시 stdin pass-through 후 exit 0 (Stop hook 체인 유지) ──
+echo "$input"
+exit 0

package/templates/.claude/rules/MUST-completion-verification.md

@@ -16,6 +16,7 @@ Before declaring any task `[Done]`, verify completion against task-type-specific
 | Git Operations | Operation succeeded (check exit code), working tree clean |
 | Code Review | All findings addressed or explicitly deferred with justification |
 | Agent/Skill Creation | Frontmatter valid, referenced skills exist, routing updated |
+| UI/Frontend | Browser render verified (dev server running + page loaded), no console errors, visual output matches intent; **CSS/style changes**: capture before/after visual diff or screenshot; type-check passing alone is NOT sufficient |
 
 ## Optional: Quantitative Evidence (advisory, added v0.114.0, #1034)
 
@@ -70,7 +71,7 @@ Subagents often report failures as "pre-existing", "baseline", or "unchanged". T
 Never accept "pre-existing" without direct base-branch evidence. A false "pre-existing" claim can mask a regression introduced by the current change.
 -->
 
-## Common False Completion Patterns — 7 anti-patterns including "Command executed" without exit code check, "Waiting for manual publish" when CI auto-publishes. See full table via Read tool.
+## Common False Completion Patterns — 8 anti-patterns including "Command executed" without exit code check, "Waiting for manual publish" when CI auto-publishes, "UI changes done" without browser render. See full table via Read tool.
 
 <!-- DETAIL: Common False Completion Patterns
 
@@ -83,6 +84,7 @@ Never accept "pre-existing" without direct base-branch evidence. A false "pre-ex
 | "Tests pass" | Only ran subset | Run full test suite |
 | "Waiting for manual publish" | External CI/CD auto-publishes on merge | Check `.github/workflows/` BEFORE assuming manual step |
 | "Subagent said pre-existing" | Claim not verified against base branch | Run test on base branch, compare directly |
+| "UI changes done" / "CSS updated" | type-check passes but browser render not verified; visual output unknown | Start dev server, open browser, confirm visual output; capture screenshot or describe what was seen |
 -->
 
 ## Completion Contract Format — [Contract] + [Done] with criterion/evidence pairs. See template via Read tool.

package/templates/.claude/rules/MUST-intent-transparency.md

@@ -39,7 +39,7 @@ Display reasoning when routing to agents. Users must always know which agent was
 
 Users can specify agent directly with `@{agent-name} {command}`. Override bypasses detection.
 
-## User Directive Persistence — Named tool/skill/workflow preferences persist entire session. Anti-pattern: treating autonomous mode as clean slate. See full spec via Read tool.
+## User Directive Persistence — Named tool/skill/workflow preferences persist entire session. Anti-pattern: treating autonomous mode as clean slate or re-asking already-rejected questions. See full spec via Read tool.
 
 <!-- DETAIL: User Directive Persistence
 When a user explicitly names a tool, skill, or workflow (e.g., "use /pipeline auto-dev", "always run tests with bun test"), this preference persists for the entire session — including after autonomous mode transitions.
@@ -53,20 +53,30 @@ When a user explicitly names a tool, skill, or workflow (e.g., "use /pipeline au
 | "from now on" | Entire session + memory save candidate |
 | "for this task" | Current task only |
 | Named slash command | Subsequent similar invocations |
+| AskUserQuestion rejected / directive overridden | That question/approach must NOT recur this session |
 
-### Cycle Start Self-Check
+### Cycle Start Self-Check (MANDATORY)
 
-At the start of every work cycle (issue, task, release, or autonomous sub-loop):
-1. Review recent user messages in the conversation
-2. Identify any named tool/skill/workflow directives
-3. Apply those directives unless explicitly rescinded
-4. If unsure whether a directive applies, default to the stated preference
+At the start of every new task, issue, or autonomous sub-loop, answer these three questions before proceeding:
 
-**Anti-pattern**: Treating autonomous mode as a clean slate that discards earlier user preferences. Autonomous mode means "continue without per-step confirmation" — NOT "reset user directives".
+1. **Preferred tool/skill/workflow?** — Did the user explicitly name a tool or workflow earlier in this session? If YES, use it. Do NOT fall back to the default without re-confirmation.
+2. **Rejected interaction patterns?** — Did the user reject a question format (e.g., AskUserQuestion) or specific approach? If YES, that pattern must NOT recur in this session.
+3. **Override rescinded?** — Has the user explicitly cancelled a prior directive since stating it? If NO, the directive is still active.
+
+| Check | Fail Condition | Required Action |
+|-------|---------------|----------------|
+| Preferred tool/skill | About to use a different tool/skill | Switch to user-specified one |
+| Rejected AskUserQuestion | About to AskUserQuestion again on same topic | Answer with best judgment or inline question (free text) |
+| Rejected approach | About to repeat the same approach | Choose alternative approach |
+
+**Anti-pattern 1**: Treating autonomous mode as a clean slate that discards earlier user preferences. Autonomous mode means "continue without per-step confirmation" — NOT "reset user directives".
+
+**Anti-pattern 2**: User rejects an AskUserQuestion (or the interaction style) → agent falls back to free-text phrasing of the same question in the next turn. If the user has indicated they do not want a specific interaction pattern, do NOT re-ask via different formatting — make a judgment call and proceed.
 
 ### Cross-reference
 
 - Related memory: session v0.87.2~v0.88.0 (issue #869) — `/pipeline auto-dev` preference was lost after autonomous mode transition
+- Related issue: #1188 item #4 — AskUserQuestion rejected, agent re-asked via free text in next turn (2026-05-19)
 -->
 
 ## Agent Triggers

package/templates/.claude/skills/systematic-debugging/SKILL.md

@@ -27,6 +27,7 @@ user-invocable: false
 4. **한 번에 하나의 가설만 검증한다.**
 5. **수정 시 "while I'm here" 리팩터링을 금지한다.**
 6. **수정 시도가 3번 실패하면 추가 패치 전에 구조적 문제를 의심한다.**
+7. **retry/cache/timeout을 변경하기 전에 false-fix 가능성을 점검한다.** 에러율 감소가 원인 해소인지 증상 억제인지 구분하지 않은 수정은 유효하지 않다.
 
 이 과정을 어기는 것은 디버깅 실패로 본다.
 
@@ -64,6 +65,38 @@ user-invocable: false
 
 반드시 아래 순서로 진행한다.
 
+### Phase 0. Blocker Triage (Pre-Debug Gate)
+
+**Trigger**: When any external dependency, tool, or resource appears unavailable.
+
+Before declaring a task blocked or unsolvable, exhaust this checklist:
+
+| # | Workaround Path | Check |
+|---|----------------|-------|
+| 1 | Environment bypass | Can the dependency be bypassed in the current environment? |
+| 2 | Alternative tool | Is there an alternative tool, library, or approach? |
+| 3 | Partial solution | Can the task be partially completed without the dependency? |
+| 4 | Install/configure | Can the dependency be installed or configured now? |
+| 5 | Existing credentials | Are related tokens, auth files, or configs already present? |
+
+**Rules**:
+- Minimum 3 workaround paths MUST be explored before declaring "blocked"
+- Each explored path must be documented with outcome
+- "Session unsolvable" declarations MUST include the list of attempted workaround paths
+- If a workaround is found, proceed with debugging using that workaround
+
+**Output format**:
+```
+[Blocker Triage]
+├── Dependency: {what is unavailable}
+├── Path 1: {attempted} → {outcome}
+├── Path 2: {attempted} → {outcome}
+├── Path 3: {attempted} → {outcome}
+└── Verdict: {proceed with workaround N | genuinely blocked — reason}
+```
+
+If verdict is "genuinely blocked", escalate to user with full triage report. Do NOT silently abandon the task.
+
 ### Phase 1. Define The Problem
 
 먼저 문제를 축약한다.
@@ -286,3 +319,21 @@ This skill includes reference documents for specific debugging techniques:
 - `condition-based-waiting.md` — Replacing arbitrary delays with condition-based polling
 - `find-polluter.sh` — Bisection script for finding test pollution sources
 - `condition-based-waiting-example.ts` — Complete implementation of condition-based waiting utilities
+
+## Extended Phases
+
+장애 분석 및 운영 디버깅을 위한 확장 절차. 기본 Phase 1-7과 함께 사용한다.
+
+- `phases/timeline-correlation.md` — 배포/설정 변경 타임라인과 장애 시점 상관관계 추적
+- `phases/retry-cache-timeout-audit.md` — retry/cache/timeout false-fix 안티패턴 체크리스트 (Hard Gate #7 구현)
+- `phases/amplification-detection.md` — retry storm 및 error cascading 시그널 탐지
+- `phases/fault-injection.md` — 가설 검증을 위한 의도적 장애 주입 절차
+
+### 사용 가이드
+
+| 상황 | 참조 |
+|------|------|
+| "언제부터 깨졌는가?" | `phases/timeline-correlation.md` |
+| "retry/timeout 늘리면 되지 않나?" | `phases/retry-cache-timeout-audit.md` |
+| 에러가 여러 서비스로 퍼졌다 | `phases/amplification-detection.md` |
+| 가설은 있지만 재현이 안 된다 | `phases/fault-injection.md` |

package/templates/.claude/skills/systematic-debugging/phases/amplification-detection.md

@@ -0,0 +1,143 @@
+# Amplification Detection
+
+retry storm 및 에러 cascading 시그널을 탐지하는 절차다.
+
+## 목적
+
+단일 장애가 retry/timeout 연쇄로 증폭되면 원인과 증상이 분리된다.
+원인은 한 곳이지만 에러는 시스템 전체에서 나타난다.
+증폭을 먼저 탐지하지 않으면 증상을 원인으로 착각하고 엉뚱한 곳을 고친다.
+
+## 증폭의 3가지 유형
+
+### 1. Retry Storm
+
+단일 실패가 재시도로 인해 N배 트래픽으로 증폭되는 패턴.
+
+시그널:
+- 업스트림 에러율이 급상승하는 동시에 요청 수도 급상승
+- 동일 에러가 짧은 시간(1~5초) 안에 burst 발생
+- 업스트림 서비스 로그에 동일 request_id가 N회 기록됨
+
+```bash
+# 동일 에러의 burst 패턴 확인
+grep "ERROR" application.log \
+  | awk '{print $1, $2}' \
+  | uniq -c \
+  | sort -rn \
+  | head -20
+
+# 초당 에러 수 추이
+grep "ERROR" application.log \
+  | awk '{print $1"T"substr($2,1,5)}' \
+  | sort | uniq -c
+```
+
+### 2. Error Cascading
+
+한 서비스의 실패가 의존 서비스로 전파되는 패턴.
+
+시그널:
+- 여러 서비스에서 에러가 동시에 또는 순차적으로 발생
+- 에러 발생 순서가 dependency graph 방향과 일치
+- 하나의 서비스가 회복되자 연쇄적으로 다른 서비스도 회복
+
+```
+Dependency graph 예:
+  Service A → Service B → Service C
+  
+  Cascading 시그널:
+  14:47:00  Service C ERROR (DB timeout)
+  14:47:03  Service B ERROR (C call failed)
+  14:47:05  Service A ERROR (B call failed)
+```
+
+### 3. Connection Pool Exhaustion
+
+retry/cascading으로 커넥션이 소진되어 새 요청이 큐에 쌓이는 패턴.
+
+시그널:
+- 응답 시간이 급격히 증가 (정상 50ms → 10s)
+- `connection pool exhausted` 또는 `too many connections` 에러
+- 이전에는 없던 timeout이 급증
+
+```bash
+# PostgreSQL 커넥션 수 확인
+psql -c "SELECT count(*), state FROM pg_stat_activity GROUP BY state;"
+
+# MySQL 커넥션 상태
+mysql -e "SHOW STATUS LIKE 'Threads_connected';"
+
+# Redis 커넥션
+redis-cli INFO clients | grep connected_clients
+```
+
+## 탐지 절차
+
+### Step 1. Rate 변화 추적
+
+```bash
+# 에러 발생 전후 1분 단위 에러 수 추이
+grep "ERROR" app.log \
+  | awk '{print substr($2,1,5)}' \
+  | sort | uniq -c
+
+# 정상: 에러 수가 점진적으로 증가
+# 증폭: 에러 수가 특정 시점에서 급격히 증가(3배 이상)
+```
+
+### Step 2. Dependency Graph 분석
+
+```bash
+# 서비스 A의 에러 시작 시각
+grep "ERROR" service-a.log | head -1
+
+# 서비스 B의 에러 시작 시각
+grep "ERROR" service-b.log | head -1
+
+# 시각 차이가 dependency latency와 일치하면 cascading
+```
+
+### Step 3. 증폭 여부 판정
+
+| 관측 | 판정 |
+|------|------|
+| 요청 수 증가 없이 에러율만 증가 | 단순 장애 (증폭 아님) |
+| 요청 수와 에러율이 동시 급증 | Retry storm 의심 |
+| 에러가 여러 서비스로 순차 전파 | Cascading 의심 |
+| 응답 시간이 커넥션 한계 시점에서 급증 | Pool exhaustion 의심 |
+
+## 증폭 확인 후 대응
+
+증폭이 확인되면 원인과 증폭을 분리해서 처리한다.
+
+1. **증폭 차단 먼저** (circuit breaker, retry 일시 비활성화, rate limit)
+2. **원인 격리** (증폭이 차단된 상태에서 Phase 4 진행)
+3. **원인 수정 후 증폭 방어 보강** (backoff 설정, circuit breaker 임계값)
+
+```python
+# Circuit breaker 예시 (빠른 장애 격리)
+from circuitbreaker import circuit
+
+@circuit(failure_threshold=5, recovery_timeout=30)
+def call_external_service():
+    ...
+```
+
+## 출력 형식
+
+```
+[Amplification Detection]
+├── Pattern: retry storm | cascading | pool exhaustion | none
+├── Evidence:
+│   ├── Rate change: <normal_rate> → <burst_rate> at <timestamp>
+│   └── Dependency: <service_a> → <service_b> at +<Ns>
+├── Root cause candidate: <upstream service or resource>
+└── Immediate action: <circuit break | retry off | pool increase>
+```
+
+## 연관
+
+- `retry-cache-timeout-audit.md` — retry storm의 구조적 원인 감사
+- `timeline-correlation.md` — 증폭 시작 시각과 배포/변경 상관관계 확인
+- Phase 4 (Isolate Root Cause) — 증폭 차단 후 원인 격리

package/templates/.claude/skills/systematic-debugging/phases/fault-injection.md

@@ -0,0 +1,163 @@
+# Fault Injection
+
+가설 검증을 위해 의도적으로 장애를 주입하는 절차다.
+
+## 목적
+
+가설이 맞는지 확인하는 가장 확실한 방법은 직접 그 조건을 만드는 것이다.
+재현이 어려운 간헐 버그, 네트워크 장애, 의존 서비스 실패를 시뮬레이션해 가설을 검증한다.
+
+## 전제 조건
+
+다음 조건을 모두 만족해야 fault injection을 시작한다.
+
+```
+[ ] 1. Phase 4에서 단일 원인 가설이 수립되어 있다
+[ ] 2. Rollback 수단이 준비되어 있다 (코드, 설정, 인프라)
+[ ] 3. 주입 대상이 격리 가능한 환경이다 (dev/staging 우선)
+[ ] 4. 주입 범위와 기간이 명시되어 있다
+[ ] 5. 관측 수단이 준비되어 있다 (로그, 메트릭, 알림)
+```
+
+**prod 직접 주입은 금지한다.** 예외: prod에서만 재현되고 안전하게 격리할 수 있는 경우에만, 명시적 승인 후 진행한다.
+
+## 절차
+
+### Step 1. 가설 명시
+
+```
+Hypothesis: <root cause> because <evidence>
+Prediction: If I inject <fault>, then I expect to see <symptom>
+```
+
+예시:
+```
+Hypothesis: DB connection pool exhaustion causes 503 because pool_size=5 under load
+Prediction: If I set pool_size=1 and send 10 concurrent requests,
+            I expect to see connection timeout errors matching production pattern
+```
+
+### Step 2. 최소 주입 설계
+
+가설을 검증하는 데 필요한 최소한의 주입만 설계한다.
+
+| 유형 | 도구/방법 |
+|------|---------|
+| 네트워크 지연/단절 | `tc netem`, Toxiproxy, Chaos Monkey |
+| 서비스 응답 오류 | Mock 서버, WireMock, 환경변수 override |
+| 리소스 고갈 | `ulimit`, 설정 변경 (pool_size, max_connections) |
+| 디스크 오류 | `dd if=/dev/full`, 디스크 용량 제한 |
+| CPU/Memory 부하 | `stress-ng`, `yes > /dev/null` |
+| 의존 서비스 다운 | 프로세스 종료, 포트 차단 |
+
+```bash
+# 네트워크 지연 주입 예시 (Linux tc)
+sudo tc qdisc add dev eth0 root netem delay 500ms 100ms
+
+# 제거
+sudo tc qdisc del dev eth0 root
+
+# Toxiproxy (더 안전한 방법)
+toxiproxy-cli toxic add -t latency -a latency=500 proxy_name
+toxiproxy-cli toxic remove proxy_name
+```
+
+### Step 3. 주입 실행 및 관측
+
+```bash
+# 1. 기준 메트릭 기록 (주입 전)
+# 2. 주입
+# 3. 동일 조건으로 트래픽/요청 실행
+# 4. 관측 (로그, 메트릭, 에러 패턴)
+# 5. 즉시 rollback
+```
+
+관측 체크리스트:
+```
+[ ] 예측한 증상이 나타났는가?
+[ ] 증상의 형태가 실제 장애와 동일한가?
+[ ] 예측하지 못한 부작용이 있는가?
+```
+
+### Step 4. 검증 및 결론
+
+| 관측 결과 | 결론 |
+|---------|------|
+| 예측한 증상이 정확히 재현됨 | 가설 확인 → Phase 6으로 진행 |
+| 증상은 나타나지만 형태가 다름 | 가설 부분 확인 → 가설 수정 후 재시도 |
+| 증상이 전혀 나타나지 않음 | 가설 기각 → Phase 4로 돌아가 새 가설 수립 |
+| 예측 외 부작용 발생 | 즉시 rollback → 영향 평가 후 재설계 |
+
+### Step 5. Rollback 확인
+
+```bash
+# 주입 해제 확인
+# 설정 원복 확인
+# 메트릭 정상 복귀 확인 (주입 전과 동일한 기준값)
+```
+
+rollback 후 5분 이상 메트릭을 관찰한다. 즉시 정상화되지 않는 경우 지속 모니터링.
+
+## 빠른 참조 — 주입 유형별
+
+### DB 커넥션 풀 고갈 검증
+
+```python
+# 설정 임시 변경
+DATABASE_POOL_SIZE = 1  # 실제 설정값보다 극단적으로 낮게
+
+# 동시 요청 실행
+import concurrent.futures
+with concurrent.futures.ThreadPoolExecutor(max_workers=20) as ex:
+    futures = [ex.submit(make_request) for _ in range(20)]
+```
+
+### 외부 API 응답 지연 검증
+
+```python
+# WireMock 또는 httpretty로 mock
+import responses
+
+@responses.activate
+def test_timeout_handling():
+    responses.add(responses.GET, 'http://api.example.com',
+                  body=Exception('Connection timeout'))
+    result = call_external_api()
+    assert result == expected_fallback
+```
+
+### 디스크 고갈 검증
+
+```bash
+# 임시 파일로 공간 채우기 (주의: 복구 가능)
+fallocate -l 10G /tmp/test_fill.img
+# 검증 후
+rm /tmp/test_fill.img
+```
+
+## 출력 형식
+
+```
+[Fault Injection]
+├── Hypothesis: <원인 가설>
+├── Prediction: <예상 증상>
+├── Injection: <주입 유형 및 방법>
+├── Environment: dev | staging | prod (승인 필요)
+├── Observation: <실제 관측 결과>
+├── Match: yes | partial | no
+├── Rollback: completed at <timestamp>
+└── Conclusion: confirmed | revised | rejected
+```
+
+## 주의
+
+- 주입은 항상 가설 확인 후 즉시 rollback한다. "조금 더 두어보자"는 금지다.
+- 의존 서비스가 있는 환경에서 주입 시 파급 범위를 미리 파악한다.
+- prod 주입은 incident 대응 중 재현이 불가피할 때만, 팀 승인 후 진행한다.
+- 주입 기록(시각, 방법, rollback 시각)을 incident 타임라인에 남긴다.
+
+## 연관
+
+- Phase 4 (Isolate Root Cause) — 가설이 수립된 이후에만 fault injection 시작
+- `amplification-detection.md` — retry storm 가설 검증 시 주입 방법
+- `timeline-correlation.md` — 주입 이벤트를 타임라인에 기록

package/templates/.claude/skills/systematic-debugging/phases/retry-cache-timeout-audit.md

@@ -0,0 +1,131 @@
+# Retry / Cache / Timeout Audit
+
+retry, cache, timeout 변경이 실제 원인을 숨기는 false-fix 안티패턴을 식별하는 체크리스트다.
+
+## 배경
+
+retry/cache/timeout은 빠른 증상 억제 수단처럼 보이지만, 대부분의 경우 근본 원인을 가리는 밴드에이드다.
+
+- **retry** → 실패율을 낮추는 것처럼 보이지만 실패 원인은 그대로다
+- **cache** → 잘못된 응답을 잠시 숨기지만 TTL 이후 다시 드러난다
+- **timeout** → 늘리면 에러가 줄지만 지연의 원인은 해소되지 않는다
+
+이 세 가지를 바꾸기 전에 아래 체크리스트를 통과해야 한다.
+
+## 안티패턴 목록
+
+### 1. try-catch swallow (예외 삼키기)
+
+```python
+# 안티패턴
+try:
+    result = call_external_api()
+except Exception:
+    return default_value  # 원인 불명, 로그도 없음
+
+# 올바른 방향
+try:
+    result = call_external_api()
+except SpecificError as e:
+    logger.error("API call failed: %s", e, exc_info=True)
+    raise  # 또는 명시적 fallback with 로깅
+```
+
+체크: 예외를 삼키는 지점에서 실제 에러율이 측정되고 있는가?
+
+### 2. Retry storm (재시도 폭풍)
+
+```yaml
+# 안티패턴 — 모든 요청이 3배로 증폭
+retries: 3
+retry_on: [500, 503]
+backoff: 0  # 지수 백오프 없음
+
+# 올바른 방향
+retries: 3
+retry_on: [429, 503]  # 재시도 가능한 코드만
+backoff_multiplier: 2
+max_backoff: 30s
+jitter: true
+```
+
+체크: 업스트림 서비스가 이미 과부하 상태에서 retry가 부하를 더 키우고 있지 않은가?
+
+### 3. Cache mask (캐시로 가리기)
+
+```python
+# 안티패턴 — 버그가 있는 응답이 캐시에 고정됨
+@cache(ttl=3600)
+def get_user_permissions(user_id):
+    return fetch_permissions(user_id)  # 버그 있음
+
+# 체크 포인트
+# - 잘못된 데이터가 캐시에 들어갔을 때 무효화 수단이 있는가?
+# - 캐시 히트율이 올라가면서 버그 재현율이 낮아진 것처럼 보이지 않는가?
+```
+
+체크: 에러율 감소가 캐시 히트율 증가와 시간적으로 일치하는가?
+
+### 4. Timeout shift (타임아웃 연장)
+
+```yaml
+# 안티패턴 — 근본 원인 없이 타임아웃만 늘림
+timeout: 30s  # 기존 10s → 30s로 변경
+
+# 올바른 방향: 먼저 확인할 것
+# - 왜 10s 안에 응답하지 못하는가?
+# - DB 쿼리 slow query log 확인
+# - 외부 API 응답 시간 추이
+# - N+1 쿼리 여부
+```
+
+체크: 타임아웃 연장 후 p99 응답 시간이 어떻게 변했는가?
+
+## 호출 경로 감사 체크리스트
+
+수정 전에 실제 호출 경로에서 아래 항목을 모두 확인한다.
+
+```
+[ ] 1. 현재 retry 설정 위치를 모두 찾았다
+        - HTTP client config
+        - Message queue consumer
+        - Background job 설정
+        - SDK 내부 기본값 (라이브러리 문서 확인)
+
+[ ] 2. 각 retry 지점의 부작용을 평가했다
+        - 멱등성(idempotency)이 보장되는가?
+        - 부분 성공 후 재시도 시 중복 처리가 발생하지 않는가?
+
+[ ] 3. 현재 cache 레이어를 모두 식별했다
+        - In-process cache (dict, lru_cache)
+        - Distributed cache (Redis, Memcached)
+        - CDN / Reverse proxy cache
+        - DB query cache
+
+[ ] 4. 각 cache의 일관성 위험을 평가했다
+        - TTL 내 stale data가 얼마나 오래 노출되는가?
+        - Cache invalidation 수단이 있는가?
+
+[ ] 5. timeout 설정 전/후 레이턴시 분포를 확인했다
+        - p50, p95, p99 변화
+        - 타임아웃 에러 vs 실제 slow 응답 구분
+
+[ ] 6. 변경 이후 실제 원인이 해소되었는지 확인했다
+        - 에러율이 줄었는가, 아니면 에러가 숨겨졌는가?
+        - 메트릭(retry count, cache hit rate, timeout rate)이 정상 범위로 돌아왔는가?
+```
+
+## 판정 기준
+
+| 상황 | 판정 |
+|------|------|
+| retry 줄이면 에러율이 올라간다 | 원인 미해소 — false-fix |
+| cache 끄면 에러가 다시 나타난다 | 원인 미해소 — false-fix |
+| timeout 줄이면 에러가 돌아온다 | 원인 미해소 — false-fix |
+| 위 변경 후에도 에러율 정상 | 원인 해소 — valid fix |
+
+## 연관
+
+- `amplification-detection.md` — retry storm 시그널 탐지
+- Phase 4 (Isolate Root Cause) — false-fix 판정 후 실제 원인 가설 수립
+- Hard Gate #6 (SKILL.md) — retry/cache/timeout 변경 전 false-fix 가능성 점검

package/templates/.claude/skills/systematic-debugging/phases/timeline-correlation.md

@@ -0,0 +1,114 @@
+# Timeline Correlation
+
+장애 시점과 코드 변경/배포/설정 변경의 상관관계를 추적하는 절차다.
+
+## 목적
+
+"언제부터 깨졌는가"를 정확히 특정하면 원인 후보 범위가 90% 이상 줄어든다.
+타임라인 없이 수정에 들어가는 것은 Phase 4(원인 격리) 없이 Phase 6(수정)으로 뛰는 것과 같다.
+
+## 절차
+
+### Step 1. 장애 발생 시각 고정
+
+```bash
+# 모니터링/로그에서 최초 에러 타임스탬프 확인
+grep -E "ERROR|FATAL|Exception" application.log | head -5
+
+# 알림 기록, on-call 채널, Sentry/Datadog alert 시각 메모
+```
+
+출력 형식:
+```
+Incident start: YYYY-MM-DD HH:MM:SS UTC
+First observed: <source> (log | alert | user report)
+```
+
+### Step 2. 코드 변경 이력 수집
+
+```bash
+# 장애 시점 전 72시간 커밋 목록
+git log --since="72 hours ago" --until="<incident_time>" \
+  --format="%h %ad %an %s" --date=short
+
+# 특정 서비스 경로만
+git log --since="72 hours ago" --format="%h %ad %s" --date=iso \
+  -- src/service/ config/
+```
+
+### Step 3. 배포 이력 수집
+
+```bash
+# GitHub Actions / CI 배포 로그에서 타임스탬프 확인
+gh run list --limit 20 --json createdAt,status,name \
+  | jq '.[] | select(.status=="completed") | {name,createdAt}'
+
+# 쿠버네티스 배포 이력
+kubectl rollout history deployment/<name>
+kubectl describe deployment/<name> | grep "Updated:"
+
+# Docker 이미지 태그 변경 시각
+docker image inspect <image>:<tag> | jq '.[0].Created'
+```
+
+### Step 4. 설정 변경 이력 수집
+
+```bash
+# 환경 변수/시크릿 변경 (Vault, AWS SSM, k8s secret)
+# 변경 이력이 있다면 해당 시스템의 audit log 확인
+
+# 데이터베이스 스키마 마이그레이션 시각
+# (Alembic, Flyway, Liquibase 등 migration 실행 로그)
+
+# 인프라 변경 (Terraform state history, AWS CloudTrail)
+```
+
+### Step 5. 타임라인 정렬
+
+수집한 이벤트를 시간 순으로 정렬한다.
+
+```
+Timeline:
+  T-48h  2026-05-17 10:22  commit abc123 — "Update retry config"
+  T-24h  2026-05-18 14:05  deploy v2.3.1 — production
+  T-6h   2026-05-19 08:30  config change — DB_POOL_SIZE 10→5
+  T-0    2026-05-19 14:47  INCIDENT — 500 error spike
+```
+
+### Step 6. 의심 후보 식별
+
+타임라인에서 장애 직전 변경을 의심 후보로 분류한다.
+
+| 우선도 | 기준 |
+|--------|------|
+| High   | 장애 시작 0~2시간 전 변경 |
+| Medium | 장애 시작 2~24시간 전 변경 |
+| Low    | 그 이전 변경 (간헐 버그 제외) |
+
+간헐 버그는 시작 시각 특정이 어렵다 — 첫 관측 시각을 기준으로 삼되 Low 우선도 후보도 배제하지 않는다.
+
+## 출력 형식
+
+```
+[Timeline Correlation]
+├── Incident start: <timestamp>
+├── Window: <N> hours searched
+├── Events found: <count>
+│   ├── Code changes: <N>
+│   ├── Deploys: <N>
+│   └── Config changes: <N>
+├── Suspects (High): <commit/deploy/config>
+└── Next: Phase 4 (Isolate Root Cause) with suspect list
+```
+
+## 주의
+
+- 타임라인 자체가 가설이다. 상관관계가 인과관계를 보장하지 않는다.
+- 변경이 없는 기간에 발생한 장애는 외부 의존성(DB, 서드파티 API, 인프라) 변화를 확인한다.
+- 의심 후보가 없으면 관측 범위를 넓히거나 Phase 3(증거 수집)으로 돌아간다.
+
+## 연관
+
+- Phase 3 (Gather Evidence) — 타임라인은 증거 수집의 입력으로 사용
+- Phase 4 (Isolate Root Cause) — 의심 후보가 가설 수립의 출발점
+- `amplification-detection.md` — 배포 후 retry storm이 감지되면 타임라인과 교차 검증

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

@@ -483,6 +483,162 @@ docs/superpowers/plans/**
 | 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 |
+| v2.1.143 | 직접 변경 불필요. `worktree.bgIsolation: "none"` opt-in 시 파일 소유권 규율 필수. Stop hook 8회 block cap 인지. | P3 follow-up |
+| v2.1.144 | 호환 가능. CLAUDE.md `omcustomMinClaudeCode` v2.1.121 유지. macOS bg session FDA crash fix 확인. | None |
+| v2.1.145 | docs-only. `claude agents --json` HUD 강화, Stop/SubagentStop hook `background_tasks`/`session_crons` 활용, status line GitHub PR 통합 — 별도 follow-up 권장. | P3 follow-up |
+
+## v2.1.144 (2026-05-19) — 호환성 점검
+
+> Issue: #1187 — CC v2.1.144 compatibility documentation
+
+### `/resume` 백그라운드 세션 지원
+
+`claude --bg` 또는 agent view로 시작된 세션이 `/resume` 목록에 표시됩니다 (`bg` 배지로 구분).
+
+**oh-my-customcode 연관**: R018 Agent Teams 장시간 세션 및 `/bg` 플로우 복귀가 편리해집니다. 직접 변경 불필요.
+
+### 백그라운드 subagent 완료 알림에 경과 시간 추가
+
+백그라운드 subagent 완료 알림에 "Agent completed · 3h 2m 5s" 형태로 경과 시간이 표시됩니다.
+
+**oh-my-customcode 연관**: R009 병렬 에이전트 성능 추적에 유용. `claude agents` 뷰에서 장시간 실행 감지(2x+ 지속 시 split 권장 — R009 Adaptive Parallel Splitting)에 활용 가능.
+
+### `/plugin` Browse/Discover pane 마지막 업데이트 시각 표시
+
+플러그인 마지막 업데이트 시각이 표시됩니다.
+
+**oh-my-customcode 연관**: 필수/권장 플러그인(superpowers, context7 등) 버전 신선도 모니터링에 유용. 직접 변경 불필요.
+
+### `/model` 현재 세션만 변경 (`d` 키로 새 세션 기본값 설정)
+
+`/model`이 현재 세션만 변경하며, `d` 키로 새 세션 기본값을 별도 설정합니다.
+
+**oh-my-customcode 연관**: R006 agent frontmatter `model:` 설정이 세션 기본값과 독립적으로 동작하는 동작과 정합. 직접 변경 불필요.
+
+### "extra usage" → "usage credits" 명명 변경
+
+`/extra-usage` → `/usage-credits` (구 명령 호환 유지).
+
+**oh-my-customcode 연관**: CLAUDE.md 슬래시 커맨드 표 및 가이드 문서에서 `/extra-usage` 언급이 있다면 `/usage-credits`로 업데이트 권장. 현재 oh-my-customcode 문서에는 해당 커맨드 직접 노출 없음 — 영향 없음.
+
+### 시작 시 `api.anthropic.com` 도달 불가 시 타임아웃 개선
+
+75초 멈춤 → 15초 timeout으로 수정. captive portal/firewall/VPN 환경에서 시작 지연 대폭 감소.
+
+**oh-my-customcode 연관**: R001 안전 규칙 및 네트워크 제한 환경에서의 CI 실행 안정성 개선. 직접 변경 불필요.
+
+### 터미널 렌더링 수정
+
+- 윈도 리사이즈 누락 후 터미널 출력 깨짐 → 다음 프레임에 self-heal (Ctrl+L 불필요)
+- 긴 세션의 점진적 터미널 디스플레이 손상 수정
+- VS Code 스피너 애니메이션 색상 수 감소로 렌더링 글리치 완화
+
+**oh-my-customcode 연관**: R012 HUD statusline 및 장시간 병렬 에이전트 세션 가독성 개선. 직접 변경 불필요.
+
+### macOS 배경 세션 "exit 1 before init" crash 수정 (Full Disk Access 영역)
+
+macOS Full Disk Access 권한 영역에서 배경 세션이 초기화 전에 exit 1로 종료되던 v2.1.143 regression이 수정되었습니다.
+
+**oh-my-customcode 연관**: R011 메모리 동작 영향 없음. macOS 환경에서 `/bg` 기반 자동화 실행 안정성 복원.
+
+### oh-my-customcode 연관 평가
+
+| 변경 | 영향 영역 | Action |
+|------|----------|--------|
+| `/resume` bg 세션 표시 | R018 세션 복귀 편의성 | None |
+| 백그라운드 subagent 경과 시간 | R009 성능 추적 | None (수동 활용 가능) |
+| `/plugin` 업데이트 시각 | 플러그인 신선도 확인 | None |
+| `/model` 세션 vs 기본값 분리 | R006 model 설정과 정합 | None |
+| `/usage-credits` 명명 변경 | 문서 참조 | None (현재 노출 없음) |
+| 15초 startup timeout | CI/네트워크 환경 안정성 | None |
+| 터미널 렌더링 수정 | R012 HUD 가독성 | None |
+| macOS bg session crash fix | R011 메모리, `/bg` 플로우 | None |
+
+**Action items**: 호환 가능. CLAUDE.md `omcustomMinClaudeCode` 헤더는 v2.1.121 유지 (신규 기능 의존 없음).
+
+---
+
+## v2.1.145 (2026-05-19) — 호환성 점검
+
+> Issue: #1191 — CC v2.1.145 compatibility documentation
+
+### `claude agents --json` — 라이브 세션 JSON 출력
+
+`claude agents --json` 플래그로 라이브 Claude 세션 목록을 JSON으로 출력합니다. tmux-resurrect, status bar, session picker 등 외부 스크립팅 통합에 활용할 수 있습니다.
+
+**oh-my-customcode 연관**: R012 HUD/statusline 강화 후보. `.claude/statusline.sh`가 `claude agents --json`을 파싱하여 활성 에이전트 수를 status bar에 표시하는 통합이 가능합니다. 별도 follow-up 권장 (P3).
+
+### OTEL `agent_id` / `parent_agent_id` 속성 + 배경 subagent span nesting 수정
+
+`claude_code.tool` OTEL span에 `agent_id`와 `parent_agent_id` 속성이 추가되었습니다. 배경 subagent span nesting도 수정되었습니다.
+
+**oh-my-customcode 연관**: `monitoring-setup` 스킬 및 R018 Agent Teams 트레이싱에서 에이전트 계층 구조 추적이 개선됩니다. 호환 가능 — 기존 OTEL 설정 변경 불필요.
+
+### Status line JSON에 GitHub repo/PR 정보 자동 포함
+
+`.claude/statusline.sh`가 JSON 입력을 받는 경우 GitHub repo 및 PR 정보가 자동 포함됩니다.
+
+**oh-my-customcode 연관**: R012 statusline 강화 가능. 현재 `.claude/statusline.sh`가 branch 정보를 표시하는데, GitHub PR 번호/상태를 추가로 표시하는 통합이 가능합니다. 별도 follow-up 권장 (P3).
+
+### `/plugin` Discover/Browse 화면에 설치 전 상세 정보 표시
+
+설치 전 commands/agents/skills/hooks/MCP/LSP 서버 목록을 확인할 수 있습니다.
+
+**oh-my-customcode 연관**: R013 ecomode 및 토큰 효율 측면에서 플러그인 도입 전 비용/기능 점검 개선. 직접 변경 불필요.
+
+### `claude agents` 탭 제목에 awaiting-input 카운트 표시
+
+**oh-my-customcode 연관**: R009 병렬 에이전트 모니터링 개선. 사용자 입력 대기 에이전트를 탭 제목에서 즉시 확인 가능.
+
+### Stop / SubagentStop hook 입력에 `background_tasks`, `session_crons` 필드 추가
+
+Stop 및 SubagentStop hook의 입력 JSON에 `background_tasks`와 `session_crons` 필드가 추가되었습니다.
+
+**oh-my-customcode 연관**: `.claude/hooks/` 내 `feedback-collector.sh` 및 Stop hook 스크립트와 호환됩니다 (옵션 필드이므로 기존 스크립트 영향 없음). hook input schema를 활용하는 고급 패턴(background task 완료 확인 등)에서 활용 가능 — 별도 follow-up 권장.
+
+### Bash 명령 bare variable assignment 자동 승인 우회 취약점 수정
+
+non-allowlisted env var의 bare variable assignment가 자동 승인을 우회하던 취약점이 수정되었습니다.
+
+**oh-my-customcode 연관**: R002 권한 규칙 강화. `bypassPermissions` 모드 하 Bash 도구 사용 시 의도치 않은 환경 변수 주입 경로가 차단됩니다. 직접 harness 변경 불필요.
+
+### Agent Teams non-ASCII teammate name 수정
+
+Agent Teams 멤버 이름에 non-ASCII 문자(한국어 포함)가 포함된 경우의 버그가 수정되었습니다.
+
+**oh-my-customcode 연관**: R018 Agent Teams에서 한국어 멤버 이름을 사용하는 경우 영향. v2.1.145로 업그레이드 후 검증 권장.
+
+### 기타 수정
+
+- 슬래시 커맨드/`@`-mention 제안 목록에 마우스 hover/click 지원 (fullscreen)
+- 터미널 리사이즈/리포커스 후 스피너/경과시간 freeze 수정
+- Task list random order 수정
+- MCP prompt slash command missing argument 에러 메시지 개선
+
+**oh-my-customcode 연관**: 영향 없음 (UX/안정성 개선).
+
+### oh-my-customcode 연관 평가
+
+| 변경 | 영향 영역 | 상태 |
+|------|----------|------|
+| `claude agents --json` | R012 HUD/statusline 통합 가능 | P3 follow-up 권장 |
+| OTEL `agent_id`/`parent_agent_id` + bg subagent nesting | `monitoring-setup` 스킬 / R018 Agent Teams 트레이싱 | 호환, 후속 검토 |
+| Stop/SubagentStop hook의 `background_tasks`, `session_crons` 필드 | `feedback-collector.sh` 호환 OK (옵션 필드) | hook input schema 갱신 후보 |
+| Status line JSON에 GitHub repo + PR 정보 | `.claude/statusline.sh` 강화 가능 (R012) | P3 follow-up 권장 |
+| Bare variable assignment auto-approve bypass fix | R002 permissions 강화 | 호환 |
+| Agent Teams non-ASCII teammate name fix | R018 한국어 멤버 사용 시 영향 | v2.1.145 업그레이드 후 검증 권장 |
+| `/plugin` 상세 정보 사전 표시 | R013 플러그인 비용 점검 | None |
+| `claude agents` awaiting-input 카운트 | R009 병렬 모니터링 개선 | None |
+| 기타 UX/안정성 수정 | 일반 개선 | None |
+
+**Action items**:
+- 본 릴리스에서 코드 변경 없음 (docs-only)
+- 후속 follow-up 후보 (별도 이슈로 등록 권장):
+  1. `claude agents --json`을 활용한 HUD 강화 (R012)
+  2. Hook input schema에 `background_tasks` / `session_crons` 활용
+  3. Status line JSON GitHub PR 정보 통합 (R012)
+
+---
 
 ## References
 
@@ -494,6 +650,8 @@ docs/superpowers/plans/**
 - #1137 — Claude Code v2.1.141 compatibility documentation
 - #1158 — Claude Code v2.1.142 compatibility documentation
 - #1147 — .gitignore nested .md pattern limitation note
+- #1187 — Claude Code v2.1.144 compatibility documentation
+- #1191 — Claude Code v2.1.145 compatibility documentation
 - `.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.144.0",
+  "version": "0.146.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)",