oh-my-customcode 0.143.0 → 0.145.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,114 @@
1
+ # Timeline Correlation
2
+
3
+ 장애 시점과 코드 변경/배포/설정 변경의 상관관계를 추적하는 절차다.
4
+
5
+ ## 목적
6
+
7
+ "언제부터 깨졌는가"를 정확히 특정하면 원인 후보 범위가 90% 이상 줄어든다.
8
+ 타임라인 없이 수정에 들어가는 것은 Phase 4(원인 격리) 없이 Phase 6(수정)으로 뛰는 것과 같다.
9
+
10
+ ## 절차
11
+
12
+ ### Step 1. 장애 발생 시각 고정
13
+
14
+ ```bash
15
+ # 모니터링/로그에서 최초 에러 타임스탬프 확인
16
+ grep -E "ERROR|FATAL|Exception" application.log | head -5
17
+
18
+ # 알림 기록, on-call 채널, Sentry/Datadog alert 시각 메모
19
+ ```
20
+
21
+ 출력 형식:
22
+ ```
23
+ Incident start: YYYY-MM-DD HH:MM:SS UTC
24
+ First observed: <source> (log | alert | user report)
25
+ ```
26
+
27
+ ### Step 2. 코드 변경 이력 수집
28
+
29
+ ```bash
30
+ # 장애 시점 전 72시간 커밋 목록
31
+ git log --since="72 hours ago" --until="<incident_time>" \
32
+ --format="%h %ad %an %s" --date=short
33
+
34
+ # 특정 서비스 경로만
35
+ git log --since="72 hours ago" --format="%h %ad %s" --date=iso \
36
+ -- src/service/ config/
37
+ ```
38
+
39
+ ### Step 3. 배포 이력 수집
40
+
41
+ ```bash
42
+ # GitHub Actions / CI 배포 로그에서 타임스탬프 확인
43
+ gh run list --limit 20 --json createdAt,status,name \
44
+ | jq '.[] | select(.status=="completed") | {name,createdAt}'
45
+
46
+ # 쿠버네티스 배포 이력
47
+ kubectl rollout history deployment/<name>
48
+ kubectl describe deployment/<name> | grep "Updated:"
49
+
50
+ # Docker 이미지 태그 변경 시각
51
+ docker image inspect <image>:<tag> | jq '.[0].Created'
52
+ ```
53
+
54
+ ### Step 4. 설정 변경 이력 수집
55
+
56
+ ```bash
57
+ # 환경 변수/시크릿 변경 (Vault, AWS SSM, k8s secret)
58
+ # 변경 이력이 있다면 해당 시스템의 audit log 확인
59
+
60
+ # 데이터베이스 스키마 마이그레이션 시각
61
+ # (Alembic, Flyway, Liquibase 등 migration 실행 로그)
62
+
63
+ # 인프라 변경 (Terraform state history, AWS CloudTrail)
64
+ ```
65
+
66
+ ### Step 5. 타임라인 정렬
67
+
68
+ 수집한 이벤트를 시간 순으로 정렬한다.
69
+
70
+ ```
71
+ Timeline:
72
+ T-48h 2026-05-17 10:22 commit abc123 — "Update retry config"
73
+ T-24h 2026-05-18 14:05 deploy v2.3.1 — production
74
+ T-6h 2026-05-19 08:30 config change — DB_POOL_SIZE 10→5
75
+ T-0 2026-05-19 14:47 INCIDENT — 500 error spike
76
+ ```
77
+
78
+ ### Step 6. 의심 후보 식별
79
+
80
+ 타임라인에서 장애 직전 변경을 의심 후보로 분류한다.
81
+
82
+ | 우선도 | 기준 |
83
+ |--------|------|
84
+ | High | 장애 시작 0~2시간 전 변경 |
85
+ | Medium | 장애 시작 2~24시간 전 변경 |
86
+ | Low | 그 이전 변경 (간헐 버그 제외) |
87
+
88
+ 간헐 버그는 시작 시각 특정이 어렵다 — 첫 관측 시각을 기준으로 삼되 Low 우선도 후보도 배제하지 않는다.
89
+
90
+ ## 출력 형식
91
+
92
+ ```
93
+ [Timeline Correlation]
94
+ ├── Incident start: <timestamp>
95
+ ├── Window: <N> hours searched
96
+ ├── Events found: <count>
97
+ │ ├── Code changes: <N>
98
+ │ ├── Deploys: <N>
99
+ │ └── Config changes: <N>
100
+ ├── Suspects (High): <commit/deploy/config>
101
+ └── Next: Phase 4 (Isolate Root Cause) with suspect list
102
+ ```
103
+
104
+ ## 주의
105
+
106
+ - 타임라인 자체가 가설이다. 상관관계가 인과관계를 보장하지 않는다.
107
+ - 변경이 없는 기간에 발생한 장애는 외부 의존성(DB, 서드파티 API, 인프라) 변화를 확인한다.
108
+ - 의심 후보가 없으면 관측 범위를 넓히거나 Phase 3(증거 수집)으로 돌아간다.
109
+
110
+ ## 연관
111
+
112
+ - Phase 3 (Gather Evidence) — 타임라인은 증거 수집의 입력으로 사용
113
+ - Phase 4 (Isolate Root Cause) — 의심 후보가 가설 수립의 출발점
114
+ - `amplification-detection.md` — 배포 후 retry storm이 감지되면 타임라인과 교차 검증
@@ -245,7 +245,8 @@ Claude Code의 Agent Teams 기능이 활성화되어 있으면 (`CLAUDE_CODE_EXP
245
245
 
246
246
  | 서버 | 용도 |
247
247
  |------|------|
248
- | claude-mem | 세션 메모리 영속성 (Chroma 기반) |
248
+ | claude-mem | 세션 메모리 영속성 (Chroma 기반) — Phase β (#1169) COEXIST 진행 중 |
249
+ | **agentmemory** | claude-mem 대체 후보 (SQLite 기반, 4-tier consolidation) — Phase 1 COEXIST (#1169) |
249
250
  | code-review-graph | Token-efficient AST 기반 context retrieval (8.2× 토큰 절감) — wrapper: `crg-integration` 스킬 (#1171) |
250
251
  | semble | Semantic code search via embeddings (98% 토큰 절감, NDCG@10=0.854) — wrapper: `semble-integration` 스킬 (#1173) |
251
252
 
@@ -264,6 +265,12 @@ Claude Code의 Agent Teams 기능이 활성화되어 있으면 (`CLAUDE_CODE_EXP
264
265
  npm install -g claude-mem
265
266
  claude-mem setup
266
267
 
268
+ # AgentMemory MCP 설치 (claude-mem 대체 후보, COEXIST)
269
+ pip install agentmemory
270
+ claude mcp add agentmemory -- agentmemory mcp
271
+ # 또는 .mcp.json 수동 편집 (R001 auto-install 금지)
272
+ # Phase 1 COEXIST 가이드: guides/agentmemory-migration/phase-1-coexist.md
273
+
267
274
  # CRG MCP 설치 (token efficiency)
268
275
  pipx install code-review-graph
269
276
  # .mcp.json 에 code-review-graph 서버 수동 추가 (R001 auto-install 금지)
@@ -0,0 +1,261 @@
1
+ # AgentMemory Migration — Phase 1: COEXIST (Week 1-2)
2
+
3
+ > **상태**: 활성 — 2026-05-18 시작 (#1169)
4
+ > **다음 단계**: Phase 2 SWITCH (measure 결과 후 GO/NO-GO 결정)
5
+ > **이전 단계**: [measure-step-zero.md](./measure-step-zero.md)
6
+
7
+ ---
8
+
9
+ ## 1. 개요
10
+
11
+ Phase 1 (COEXIST)는 claude-mem과 AgentMemory를 **동시에 운영**하는 단계입니다.
12
+ 이 단계에서는 어떤 destructive 변경도 발생하지 않습니다:
13
+
14
+ - claude-mem 기존 Chroma 데이터 유지
15
+ - 12 plugin skill 폐기 없음
16
+ - 어댑터 코드 활성화 없음 (STUB 상태 유지)
17
+ - 자산 처리표 적용 없음
18
+
19
+ 목표는 1주간 실제 사용 데이터를 수집하고, AgentMemory 설치와 공존 운영에 익숙해지는 것입니다.
20
+
21
+ | 항목 | Phase 1 (COEXIST) | Phase 2 (SWITCH) |
22
+ |------|-------------------|------------------|
23
+ | claude-mem | 활성 (기존 운영) | 비활성화 예정 |
24
+ | AgentMemory | 설치 후 병렬 활성 | 단독 운영 |
25
+ | 데이터 마이그레이션 | 없음 | 선택적 (측정 후 결정) |
26
+ | 어댑터 코드 | STUB 유지 | 활성화 |
27
+ | 자산 처리표 | 적용 보류 | 사용자 검토 후 적용 |
28
+
29
+ ---
30
+
31
+ ## 2. AgentMemory 설치
32
+
33
+ > **R001 주의**: auto-install 금지. 아래 명령어를 사용자 로컬에서 수동으로 실행합니다.
34
+
35
+ ### 2-1. 패키지 설치
36
+
37
+ ```bash
38
+ # 옵션 A: pip
39
+ pip install agentmemory
40
+
41
+ # 옵션 B: pipx (격리 환경 권장)
42
+ pipx install agentmemory
43
+
44
+ # 옵션 C: uvx (uv 사용 시)
45
+ uvx agentmemory
46
+ ```
47
+
48
+ ### 2-2. MCP 서버 등록
49
+
50
+ ```bash
51
+ # Claude Code CLI로 등록
52
+ claude mcp add agentmemory -- agentmemory mcp
53
+
54
+ # 또는 .mcp.json 수동 편집 (R001 auto-install 금지)
55
+ # {
56
+ # "mcpServers": {
57
+ # "agentmemory": {
58
+ # "command": "agentmemory",
59
+ # "args": ["mcp"]
60
+ # }
61
+ # }
62
+ # }
63
+ ```
64
+
65
+ ### 2-3. 등록 확인
66
+
67
+ ```bash
68
+ claude mcp list
69
+ # 출력에 agentmemory 서버가 표시되어야 합니다
70
+ ```
71
+
72
+ ---
73
+
74
+ ## 3. COEXIST 정책
75
+
76
+ Phase 1 기간 동안 두 backend는 다음 정책에 따라 공존합니다.
77
+
78
+ ### 3-1. 기본 운영 방식
79
+
80
+ | 작업 | 우선 backend | 비고 |
81
+ |------|-------------|------|
82
+ | 기존 메모리 조회 | claude-mem | 기존 Chroma 데이터 유지 |
83
+ | 신규 메모리 저장 | 둘 다 | COEXIST 기간 중 병렬 저장 권장 |
84
+ | 세션 종료 시 저장 | 둘 다 | R011 Session-End Self-Check 참조 |
85
+
86
+ ### 3-2. 쿼리 병합 (memory-aggregator)
87
+
88
+ 두 backend에서 결과가 반환될 경우 `memory-aggregator` 스킬이 결과를 병합합니다:
89
+
90
+ ```
91
+ claude-mem.search(query) → 결과 A
92
+ AgentMemory.search(query) → 결과 B
93
+ memory-aggregator → A + B 중복 제거 후 반환
94
+ ```
95
+
96
+ `memory-aggregator` 스킬이 없는 경우, 두 결과를 순서대로 제시하고 사용자가 선택합니다.
97
+
98
+ ### 3-3. 충돌 방지 원칙
99
+
100
+ - claude-mem 기존 데이터를 AgentMemory로 자동 복사하지 않음
101
+ - 두 backend에 동일 키로 저장 시 별개 항목으로 취급
102
+ - 강제 동기화 없음 — Phase 2에서 마이그레이션 여부 결정
103
+
104
+ ---
105
+
106
+ ## 4. Dual-Backend 충돌 Advisory
107
+
108
+ `.mcp.json`에 두 서버가 동시 등록된 상태를 감지하면 다음 advisory를 출력합니다.
109
+
110
+ ### 4-1. 감지 조건
111
+
112
+ ```
113
+ .mcp.json 내 서버 목록:
114
+ - "claude-mem" (또는 관련 tool prefix)
115
+ - "agentmemory"
116
+ → 두 개 동시 존재 시 Phase 1 COEXIST 상태로 간주
117
+ ```
118
+
119
+ ### 4-2. Advisory 메시지
120
+
121
+ ```
122
+ [Advisory] Dual memory backend detected (Phase 1 COEXIST)
123
+ - claude-mem: active (Chroma)
124
+ - agentmemory: active (SQLite)
125
+ 현재 Phase 1 COEXIST 정책 적용 중 — 두 backend 병렬 운영
126
+ Phase 2 SWITCH 진입 전까지 두 backend 유지
127
+ 가이드: guides/agentmemory-migration/phase-1-coexist.md
128
+ ```
129
+
130
+ 이 advisory는 경고가 아닙니다. Phase 1에서는 정상 상태입니다.
131
+
132
+ ### 4-3. 강제 선택 (사용자 명시 시)
133
+
134
+ 사용자가 명시적으로 "agentmemory만 사용" 또는 "claude-mem만 사용"을 요청하는 경우,
135
+ 해당 요청을 따르되 자산 처리표 적용 및 어댑터 활성화는 Phase 2 GO 결정 후 진행합니다.
136
+
137
+ ---
138
+
139
+ ## 5. 사용자 행동 계획
140
+
141
+ ### 5-1. 1주 measure 루틴 (자동 트리거: 2026-05-25)
142
+
143
+ `scripts/measure-claude-mem-usage.sh` 스크립트를 1주간 실행합니다:
144
+
145
+ ```bash
146
+ # 수동 실행 (필요 시)
147
+ bash scripts/measure-claude-mem-usage.sh
148
+
149
+ # 결과는 .claude/outputs/sessions/ 에 저장됩니다
150
+ ```
151
+
152
+ 측정 항목:
153
+ - 일별 호출 횟수 (claude-mem vs AgentMemory)
154
+ - 응답 지연 (p50, p95)
155
+ - 저장 성공/실패율
156
+ - 메모리 용량 (Chroma vs SQLite)
157
+
158
+ ### 5-2. GO/NO-GO 결정 기준 (2026-05-25 예정)
159
+
160
+ | 지표 | GO 조건 | NO-GO 조건 |
161
+ |------|---------|------------|
162
+ | 응답 지연 | AgentMemory ≤ claude-mem × 1.2 | AgentMemory > claude-mem × 2.0 |
163
+ | 저장 성공률 | ≥ 99% | < 95% |
164
+ | 운영 안정성 | 1주 무장애 | 크래시 또는 데이터 손실 |
165
+ | 호환성 | 기존 메모리 포맷 읽기 가능 | 포맷 비호환으로 검색 실패 |
166
+
167
+ ### 5-3. 지금 할 수 있는 것
168
+
169
+ - AgentMemory 설치 및 MCP 등록 (위 섹션 2 참조)
170
+ - 신규 세션에서 AgentMemory로도 저장해보기 (실험적)
171
+ - measure 스크립트 결과 관찰
172
+ - 자산 처리표 (`guides/agentmemory-migration/asset-disposition.md`) 검토 준비
173
+
174
+ ---
175
+
176
+ ## 6. Phase 2 진입 조건
177
+
178
+ 다음 조건이 모두 충족된 경우에만 Phase 2 (SWITCH)로 진행합니다.
179
+
180
+ ### 필수 조건
181
+
182
+ - [ ] 1주 measure 결과 GO 판정 (5-2 기준 충족)
183
+ - [ ] 자산 처리표 사용자 검토 완료 (12 plugin skill 처리 방향 결정)
184
+ - [ ] 30분 롤백 절차 검증 완료
185
+
186
+ ### 롤백 절차 검증 (Phase 2 진입 전 필수)
187
+
188
+ ```bash
189
+ # 1. Chroma 백업 생성
190
+ cp -r ~/.local/share/claude-mem/chroma ~/.local/share/claude-mem/chroma.bak.$(date +%Y%m%d)
191
+
192
+ # 2. 백업에서 복원 가능 여부 확인
193
+ # (실제 복원 수행하지 않고 절차만 검증)
194
+ ls -la ~/.local/share/claude-mem/chroma.bak.*
195
+
196
+ # 3. AgentMemory SQLite 백업
197
+ cp ~/.local/share/agentmemory/memories.db ~/.local/share/agentmemory/memories.db.bak.$(date +%Y%m%d)
198
+ ```
199
+
200
+ 롤백 소요 시간이 30분 이내임을 확인한 후 Phase 2 진행.
201
+
202
+ ---
203
+
204
+ ## 7. 현 단계 한계 및 금지 사항
205
+
206
+ ### 7-1. STUB 상태 유지 (변경 금지)
207
+
208
+ ```
209
+ packages/eval-core/src/adapters/agentmemory.ts ← STUB, 활성화 금지
210
+ packages/eval-core/src/db/schema.ts ← 변경 금지
211
+ ```
212
+
213
+ 이 파일들은 Phase 2 GO 결정 후 별도 사이클에서 수정합니다.
214
+
215
+ ### 7-2. 자산 처리표 적용 보류
216
+
217
+ 12 plugin skill의 폐기/유지 결정은 measure 결과를 확인한 후 진행합니다:
218
+
219
+ ```
220
+ .claude/skills/memory-*/ ← 폐기 여부 보류
221
+ .claude/skills/claude-mem-*/ ← 폐기 여부 보류
222
+ ```
223
+
224
+ ### 7-3. 데이터 마이그레이션 금지
225
+
226
+ Phase 1에서는 claude-mem Chroma 데이터를 AgentMemory SQLite로 이전하지 않습니다.
227
+ 이전은 Phase 2에서 사용자가 명시적으로 승인한 경우에만 진행합니다.
228
+
229
+ ---
230
+
231
+ ## 8. R011과의 관계
232
+
233
+ Phase 1 COEXIST 기간 중 R011 (SHOULD-memory-integration) 적용:
234
+
235
+ | R011 항목 | COEXIST 수정 사항 |
236
+ |-----------|-----------------|
237
+ | Primary: Native auto memory | 변경 없음 |
238
+ | Supplementary: claude-mem | 변경 없음 (계속 사용) |
239
+ | Session-End Self-Check | claude-mem + AgentMemory 둘 다 저장 시도 |
240
+ | Failure Policy | 둘 중 하나 실패해도 비차단 |
241
+
242
+ 세션 종료 시 자가 점검 (COEXIST 확장):
243
+
244
+ ```
245
+ 1. sys-memory-keeper가 MEMORY.md 갱신? → YES
246
+ 2. claude-mem 저장 시도? → YES (기존)
247
+ 3. AgentMemory 저장 시도? → YES (COEXIST 추가)
248
+ 모두 완료 후 사용자에게 확인
249
+ ```
250
+
251
+ ---
252
+
253
+ ## 9. 참고
254
+
255
+ - **이슈**: #1169 (AgentMemory 마이그레이션 계획)
256
+ - **이전 단계**: [measure-step-zero.md](./measure-step-zero.md)
257
+ - **R011**: `.claude/rules/SHOULD-memory-integration.md` (Dual-Backend Advisory 섹션)
258
+ - **관련 기억**: [[project-sequencing-alpha-beta-gamma]]
259
+ - **자산 처리표**: `guides/agentmemory-migration/asset-disposition.md` (Phase 2 전 검토 필요)
260
+ - **measure 스크립트**: `scripts/measure-claude-mem-usage.sh`
261
+ - **롤백 가이드**: #1169 본문 조치 4 (30분 롤백 절차)
@@ -483,6 +483,162 @@ docs/superpowers/plans/**
483
483
  | v2.1.140 | P3 audit: managed `extraKnownMarketplaces` 영속화 + plugin.json default folder 무시 경고 | P3 follow-up |
484
484
  | v2.1.141 | P3: `terminalSequence` hook 검토 + cli-flags `--cwd` 추가. R010 `/bg` 권한 모드 유지 노트 추가 (완료) | P3 follow-up |
485
485
  | v2.1.142 | Fast Mode Opus 4.7 전환 확인 (필요 시 `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1`). `MCP_TOOL_TIMEOUT` 선택적 설정. | P3 follow-up |
486
+ | v2.1.143 | 직접 변경 불필요. `worktree.bgIsolation: "none"` opt-in 시 파일 소유권 규율 필수. Stop hook 8회 block cap 인지. | P3 follow-up |
487
+ | v2.1.144 | 호환 가능. CLAUDE.md `omcustomMinClaudeCode` v2.1.121 유지. macOS bg session FDA crash fix 확인. | None |
488
+ | 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 |
489
+
490
+ ## v2.1.144 (2026-05-19) — 호환성 점검
491
+
492
+ > Issue: #1187 — CC v2.1.144 compatibility documentation
493
+
494
+ ### `/resume` 백그라운드 세션 지원
495
+
496
+ `claude --bg` 또는 agent view로 시작된 세션이 `/resume` 목록에 표시됩니다 (`bg` 배지로 구분).
497
+
498
+ **oh-my-customcode 연관**: R018 Agent Teams 장시간 세션 및 `/bg` 플로우 복귀가 편리해집니다. 직접 변경 불필요.
499
+
500
+ ### 백그라운드 subagent 완료 알림에 경과 시간 추가
501
+
502
+ 백그라운드 subagent 완료 알림에 "Agent completed · 3h 2m 5s" 형태로 경과 시간이 표시됩니다.
503
+
504
+ **oh-my-customcode 연관**: R009 병렬 에이전트 성능 추적에 유용. `claude agents` 뷰에서 장시간 실행 감지(2x+ 지속 시 split 권장 — R009 Adaptive Parallel Splitting)에 활용 가능.
505
+
506
+ ### `/plugin` Browse/Discover pane 마지막 업데이트 시각 표시
507
+
508
+ 플러그인 마지막 업데이트 시각이 표시됩니다.
509
+
510
+ **oh-my-customcode 연관**: 필수/권장 플러그인(superpowers, context7 등) 버전 신선도 모니터링에 유용. 직접 변경 불필요.
511
+
512
+ ### `/model` 현재 세션만 변경 (`d` 키로 새 세션 기본값 설정)
513
+
514
+ `/model`이 현재 세션만 변경하며, `d` 키로 새 세션 기본값을 별도 설정합니다.
515
+
516
+ **oh-my-customcode 연관**: R006 agent frontmatter `model:` 설정이 세션 기본값과 독립적으로 동작하는 동작과 정합. 직접 변경 불필요.
517
+
518
+ ### "extra usage" → "usage credits" 명명 변경
519
+
520
+ `/extra-usage` → `/usage-credits` (구 명령 호환 유지).
521
+
522
+ **oh-my-customcode 연관**: CLAUDE.md 슬래시 커맨드 표 및 가이드 문서에서 `/extra-usage` 언급이 있다면 `/usage-credits`로 업데이트 권장. 현재 oh-my-customcode 문서에는 해당 커맨드 직접 노출 없음 — 영향 없음.
523
+
524
+ ### 시작 시 `api.anthropic.com` 도달 불가 시 타임아웃 개선
525
+
526
+ 75초 멈춤 → 15초 timeout으로 수정. captive portal/firewall/VPN 환경에서 시작 지연 대폭 감소.
527
+
528
+ **oh-my-customcode 연관**: R001 안전 규칙 및 네트워크 제한 환경에서의 CI 실행 안정성 개선. 직접 변경 불필요.
529
+
530
+ ### 터미널 렌더링 수정
531
+
532
+ - 윈도 리사이즈 누락 후 터미널 출력 깨짐 → 다음 프레임에 self-heal (Ctrl+L 불필요)
533
+ - 긴 세션의 점진적 터미널 디스플레이 손상 수정
534
+ - VS Code 스피너 애니메이션 색상 수 감소로 렌더링 글리치 완화
535
+
536
+ **oh-my-customcode 연관**: R012 HUD statusline 및 장시간 병렬 에이전트 세션 가독성 개선. 직접 변경 불필요.
537
+
538
+ ### macOS 배경 세션 "exit 1 before init" crash 수정 (Full Disk Access 영역)
539
+
540
+ macOS Full Disk Access 권한 영역에서 배경 세션이 초기화 전에 exit 1로 종료되던 v2.1.143 regression이 수정되었습니다.
541
+
542
+ **oh-my-customcode 연관**: R011 메모리 동작 영향 없음. macOS 환경에서 `/bg` 기반 자동화 실행 안정성 복원.
543
+
544
+ ### oh-my-customcode 연관 평가
545
+
546
+ | 변경 | 영향 영역 | Action |
547
+ |------|----------|--------|
548
+ | `/resume` bg 세션 표시 | R018 세션 복귀 편의성 | None |
549
+ | 백그라운드 subagent 경과 시간 | R009 성능 추적 | None (수동 활용 가능) |
550
+ | `/plugin` 업데이트 시각 | 플러그인 신선도 확인 | None |
551
+ | `/model` 세션 vs 기본값 분리 | R006 model 설정과 정합 | None |
552
+ | `/usage-credits` 명명 변경 | 문서 참조 | None (현재 노출 없음) |
553
+ | 15초 startup timeout | CI/네트워크 환경 안정성 | None |
554
+ | 터미널 렌더링 수정 | R012 HUD 가독성 | None |
555
+ | macOS bg session crash fix | R011 메모리, `/bg` 플로우 | None |
556
+
557
+ **Action items**: 호환 가능. CLAUDE.md `omcustomMinClaudeCode` 헤더는 v2.1.121 유지 (신규 기능 의존 없음).
558
+
559
+ ---
560
+
561
+ ## v2.1.145 (2026-05-19) — 호환성 점검
562
+
563
+ > Issue: #1191 — CC v2.1.145 compatibility documentation
564
+
565
+ ### `claude agents --json` — 라이브 세션 JSON 출력
566
+
567
+ `claude agents --json` 플래그로 라이브 Claude 세션 목록을 JSON으로 출력합니다. tmux-resurrect, status bar, session picker 등 외부 스크립팅 통합에 활용할 수 있습니다.
568
+
569
+ **oh-my-customcode 연관**: R012 HUD/statusline 강화 후보. `.claude/statusline.sh`가 `claude agents --json`을 파싱하여 활성 에이전트 수를 status bar에 표시하는 통합이 가능합니다. 별도 follow-up 권장 (P3).
570
+
571
+ ### OTEL `agent_id` / `parent_agent_id` 속성 + 배경 subagent span nesting 수정
572
+
573
+ `claude_code.tool` OTEL span에 `agent_id`와 `parent_agent_id` 속성이 추가되었습니다. 배경 subagent span nesting도 수정되었습니다.
574
+
575
+ **oh-my-customcode 연관**: `monitoring-setup` 스킬 및 R018 Agent Teams 트레이싱에서 에이전트 계층 구조 추적이 개선됩니다. 호환 가능 — 기존 OTEL 설정 변경 불필요.
576
+
577
+ ### Status line JSON에 GitHub repo/PR 정보 자동 포함
578
+
579
+ `.claude/statusline.sh`가 JSON 입력을 받는 경우 GitHub repo 및 PR 정보가 자동 포함됩니다.
580
+
581
+ **oh-my-customcode 연관**: R012 statusline 강화 가능. 현재 `.claude/statusline.sh`가 branch 정보를 표시하는데, GitHub PR 번호/상태를 추가로 표시하는 통합이 가능합니다. 별도 follow-up 권장 (P3).
582
+
583
+ ### `/plugin` Discover/Browse 화면에 설치 전 상세 정보 표시
584
+
585
+ 설치 전 commands/agents/skills/hooks/MCP/LSP 서버 목록을 확인할 수 있습니다.
586
+
587
+ **oh-my-customcode 연관**: R013 ecomode 및 토큰 효율 측면에서 플러그인 도입 전 비용/기능 점검 개선. 직접 변경 불필요.
588
+
589
+ ### `claude agents` 탭 제목에 awaiting-input 카운트 표시
590
+
591
+ **oh-my-customcode 연관**: R009 병렬 에이전트 모니터링 개선. 사용자 입력 대기 에이전트를 탭 제목에서 즉시 확인 가능.
592
+
593
+ ### Stop / SubagentStop hook 입력에 `background_tasks`, `session_crons` 필드 추가
594
+
595
+ Stop 및 SubagentStop hook의 입력 JSON에 `background_tasks`와 `session_crons` 필드가 추가되었습니다.
596
+
597
+ **oh-my-customcode 연관**: `.claude/hooks/` 내 `feedback-collector.sh` 및 Stop hook 스크립트와 호환됩니다 (옵션 필드이므로 기존 스크립트 영향 없음). hook input schema를 활용하는 고급 패턴(background task 완료 확인 등)에서 활용 가능 — 별도 follow-up 권장.
598
+
599
+ ### Bash 명령 bare variable assignment 자동 승인 우회 취약점 수정
600
+
601
+ non-allowlisted env var의 bare variable assignment가 자동 승인을 우회하던 취약점이 수정되었습니다.
602
+
603
+ **oh-my-customcode 연관**: R002 권한 규칙 강화. `bypassPermissions` 모드 하 Bash 도구 사용 시 의도치 않은 환경 변수 주입 경로가 차단됩니다. 직접 harness 변경 불필요.
604
+
605
+ ### Agent Teams non-ASCII teammate name 수정
606
+
607
+ Agent Teams 멤버 이름에 non-ASCII 문자(한국어 포함)가 포함된 경우의 버그가 수정되었습니다.
608
+
609
+ **oh-my-customcode 연관**: R018 Agent Teams에서 한국어 멤버 이름을 사용하는 경우 영향. v2.1.145로 업그레이드 후 검증 권장.
610
+
611
+ ### 기타 수정
612
+
613
+ - 슬래시 커맨드/`@`-mention 제안 목록에 마우스 hover/click 지원 (fullscreen)
614
+ - 터미널 리사이즈/리포커스 후 스피너/경과시간 freeze 수정
615
+ - Task list random order 수정
616
+ - MCP prompt slash command missing argument 에러 메시지 개선
617
+
618
+ **oh-my-customcode 연관**: 영향 없음 (UX/안정성 개선).
619
+
620
+ ### oh-my-customcode 연관 평가
621
+
622
+ | 변경 | 영향 영역 | 상태 |
623
+ |------|----------|------|
624
+ | `claude agents --json` | R012 HUD/statusline 통합 가능 | P3 follow-up 권장 |
625
+ | OTEL `agent_id`/`parent_agent_id` + bg subagent nesting | `monitoring-setup` 스킬 / R018 Agent Teams 트레이싱 | 호환, 후속 검토 |
626
+ | Stop/SubagentStop hook의 `background_tasks`, `session_crons` 필드 | `feedback-collector.sh` 호환 OK (옵션 필드) | hook input schema 갱신 후보 |
627
+ | Status line JSON에 GitHub repo + PR 정보 | `.claude/statusline.sh` 강화 가능 (R012) | P3 follow-up 권장 |
628
+ | Bare variable assignment auto-approve bypass fix | R002 permissions 강화 | 호환 |
629
+ | Agent Teams non-ASCII teammate name fix | R018 한국어 멤버 사용 시 영향 | v2.1.145 업그레이드 후 검증 권장 |
630
+ | `/plugin` 상세 정보 사전 표시 | R013 플러그인 비용 점검 | None |
631
+ | `claude agents` awaiting-input 카운트 | R009 병렬 모니터링 개선 | None |
632
+ | 기타 UX/안정성 수정 | 일반 개선 | None |
633
+
634
+ **Action items**:
635
+ - 본 릴리스에서 코드 변경 없음 (docs-only)
636
+ - 후속 follow-up 후보 (별도 이슈로 등록 권장):
637
+ 1. `claude agents --json`을 활용한 HUD 강화 (R012)
638
+ 2. Hook input schema에 `background_tasks` / `session_crons` 활용
639
+ 3. Status line JSON GitHub PR 정보 통합 (R012)
640
+
641
+ ---
486
642
 
487
643
  ## References
488
644
 
@@ -494,6 +650,8 @@ docs/superpowers/plans/**
494
650
  - #1137 — Claude Code v2.1.141 compatibility documentation
495
651
  - #1158 — Claude Code v2.1.142 compatibility documentation
496
652
  - #1147 — .gitignore nested .md pattern limitation note
653
+ - #1187 — Claude Code v2.1.144 compatibility documentation
654
+ - #1191 — Claude Code v2.1.145 compatibility documentation
497
655
  - `.claude/skills/claude-native/` — auto-generation source
498
656
  - `.claude/rules/SHOULD-hud-statusline.md` — R012 statusline integration
499
657
  - `.claude/rules/MUST-agent-design.md` — R006 agent frontmatter spec