oh-my-customcode 0.156.3 → 0.158.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.
- package/README.md +5 -7
- package/dist/cli/index.js +1 -1
- package/dist/index.js +1 -1
- package/package.json +1 -1
- package/templates/.claude/agents/arch-speckit-agent.md +1 -1
- package/templates/.claude/agents/sys-memory-keeper.md +3 -39
- package/templates/.claude/hooks/hooks.json +1 -1
- package/templates/.claude/hooks/scripts/plugin-cache-check.sh +1 -1
- package/templates/.claude/ontology/agents.yaml +4 -4
- package/templates/.claude/ontology/graphs/agent-skill.json +199 -68
- package/templates/.claude/ontology/graphs/full-graph.json +1240 -330
- package/templates/.claude/ontology/graphs/skill-rule.json +30 -13
- package/templates/.claude/ontology/rules.yaml +3 -3
- package/templates/.claude/ontology/skills.yaml +0 -31
- package/templates/.claude/profiles/data-eng.json +0 -1
- package/templates/.claude/profiles/harness-dev.json +0 -1
- package/templates/.claude/profiles/minimal.json +1 -2
- package/templates/.claude/profiles/web-app.json +1 -2
- package/templates/.claude/rules/SHOULD-memory-integration.md +9 -87
- package/templates/.claude/skills/agent-eval-framework/SKILL.md +2 -3
- package/templates/.claude/skills/crg-integration/SKILL.md +1 -10
- package/templates/.claude/skills/dev-review/SKILL.md +1 -2
- package/templates/.claude/skills/goal/SKILL.md +1 -1
- package/templates/.claude/skills/instinct-extractor/SKILL.md +0 -2
- package/templates/.claude/skills/intent-detection/patterns/agent-triggers.yaml +0 -19
- package/templates/.claude/skills/peer-messaging/SKILL.md +0 -2
- package/templates/.claude/skills/semble-integration/SKILL.md +0 -1
- package/templates/CLAUDE.md +3 -20
- package/templates/CLAUDE.md.en +2 -18
- package/templates/CLAUDE.md.ko +2 -18
- package/templates/guides/agent-design/ralph-loop-pattern.md +2 -2
- package/templates/guides/agent-eval/README.md +15 -35
- package/templates/guides/claude-code/15-version-compatibility.md +7 -7
- package/templates/guides/external-tools/ecc-absorption-decisions.md +2 -2
- package/templates/guides/harness-engineering/README.md +2 -2
- package/templates/guides/middleware-patterns/README.md +3 -5
- package/templates/guides/skill-promotion/instinct-extraction.md +1 -1
- package/templates/guides/token-efficiency/crg.md +7 -8
- package/templates/manifest.json +3 -3
- package/templates/.claude/skills/memory-management/SKILL.md +0 -240
- package/templates/.claude/skills/memory-recall/SKILL.md +0 -172
- package/templates/.claude/skills/memory-save/SKILL.md +0 -128
- package/templates/guides/agentmemory-migration/measure-step-zero.md +0 -120
- package/templates/guides/agentmemory-migration/phase-1-coexist.md +0 -261
|
@@ -8,7 +8,9 @@
|
|
|
8
8
|
"claude-code-bible": [],
|
|
9
9
|
"create-agent": [],
|
|
10
10
|
"dbt-best-practices": [],
|
|
11
|
-
"de-lead-routing": [
|
|
11
|
+
"de-lead-routing": [
|
|
12
|
+
"R009"
|
|
13
|
+
],
|
|
12
14
|
"dev-lead-routing": [],
|
|
13
15
|
"dev-refactor": [],
|
|
14
16
|
"dev-review": [],
|
|
@@ -19,13 +21,12 @@
|
|
|
19
21
|
"go-backend-best-practices": [],
|
|
20
22
|
"go-best-practices": [],
|
|
21
23
|
"help": [],
|
|
22
|
-
"intent-detection": [
|
|
24
|
+
"intent-detection": [
|
|
25
|
+
"R015"
|
|
26
|
+
],
|
|
23
27
|
"kafka-best-practices": [],
|
|
24
28
|
"kotlin-best-practices": [],
|
|
25
29
|
"lists": [],
|
|
26
|
-
"memory-management": ["R011"],
|
|
27
|
-
"memory-recall": ["R011"],
|
|
28
|
-
"memory-save": ["R011"],
|
|
29
30
|
"monitoring-setup": [],
|
|
30
31
|
"npm-audit": [],
|
|
31
32
|
"npm-publish": [],
|
|
@@ -39,9 +40,14 @@
|
|
|
39
40
|
"qa-lead-routing": [],
|
|
40
41
|
"react-best-practices": [],
|
|
41
42
|
"redis-best-practices": [],
|
|
42
|
-
"result-aggregation": [
|
|
43
|
+
"result-aggregation": [
|
|
44
|
+
"R009",
|
|
45
|
+
"R013"
|
|
46
|
+
],
|
|
43
47
|
"rust-best-practices": [],
|
|
44
|
-
"sauron-watch": [
|
|
48
|
+
"sauron-watch": [
|
|
49
|
+
"R017"
|
|
50
|
+
],
|
|
45
51
|
"secretary-routing": [],
|
|
46
52
|
"snowflake-best-practices": [],
|
|
47
53
|
"spark-best-practices": [],
|
|
@@ -56,11 +62,20 @@
|
|
|
56
62
|
"writing-clearly-and-concisely": []
|
|
57
63
|
},
|
|
58
64
|
"reverse": {
|
|
59
|
-
"R009": [
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
"
|
|
65
|
+
"R009": [
|
|
66
|
+
"de-lead-routing",
|
|
67
|
+
"result-aggregation"
|
|
68
|
+
],
|
|
69
|
+
"R011": [],
|
|
70
|
+
"R013": [
|
|
71
|
+
"result-aggregation"
|
|
72
|
+
],
|
|
73
|
+
"R015": [
|
|
74
|
+
"intent-detection"
|
|
75
|
+
],
|
|
76
|
+
"R017": [
|
|
77
|
+
"sauron-watch"
|
|
78
|
+
],
|
|
64
79
|
"R000": [],
|
|
65
80
|
"R001": [],
|
|
66
81
|
"R002": [],
|
|
@@ -74,5 +89,7 @@
|
|
|
74
89
|
"R012": [],
|
|
75
90
|
"R016": [],
|
|
76
91
|
"R018": []
|
|
77
|
-
}
|
|
92
|
+
},
|
|
93
|
+
"nodes": [],
|
|
94
|
+
"links": []
|
|
78
95
|
}
|
|
@@ -40,7 +40,7 @@ categories:
|
|
|
40
40
|
memory:
|
|
41
41
|
rules: [R011]
|
|
42
42
|
summary: "Memory integration and persistence"
|
|
43
|
-
keywords: [memory, persistence,
|
|
43
|
+
keywords: [memory, persistence, native-auto-memory, session]
|
|
44
44
|
display:
|
|
45
45
|
rules: [R012]
|
|
46
46
|
summary: "HUD and status display"
|
|
@@ -175,8 +175,8 @@ rules:
|
|
|
175
175
|
categories: [memory]
|
|
176
176
|
title: "Memory Integration Rules"
|
|
177
177
|
filename: "SHOULD-memory-integration.md"
|
|
178
|
-
summary: "Primary: Native auto memory (frontmatter).
|
|
179
|
-
keywords: [memory, native,
|
|
178
|
+
summary: "Primary: Native auto memory (frontmatter). Session persistence via agent memory directories."
|
|
179
|
+
keywords: [memory, native, persistence, session, temporal, cross-agent]
|
|
180
180
|
token_estimate: 248
|
|
181
181
|
applies_to: [agents-with-memory, memory-operations]
|
|
182
182
|
|
|
@@ -29,10 +29,6 @@ classes:
|
|
|
29
29
|
skills: [optimize-analyze, optimize-bundle, optimize-report]
|
|
30
30
|
description: "Performance optimization"
|
|
31
31
|
|
|
32
|
-
MemorySkill:
|
|
33
|
-
skills: [memory-save, memory-recall, memory-management]
|
|
34
|
-
description: "Memory persistence operations"
|
|
35
|
-
|
|
36
32
|
PackageSkill:
|
|
37
33
|
skills: [npm-publish, npm-version, npm-audit]
|
|
38
34
|
description: "Package management"
|
|
@@ -276,33 +272,6 @@ skills:
|
|
|
276
272
|
keywords: [lists, commands, categories, system]
|
|
277
273
|
rule_references: []
|
|
278
274
|
|
|
279
|
-
memory-management:
|
|
280
|
-
class: MemorySkill
|
|
281
|
-
description: "Memory persistence operations using claude-mem"
|
|
282
|
-
user_invocable: false
|
|
283
|
-
model_invocable: true
|
|
284
|
-
summary: "Provide memory persistence operations using claude-mem for session context"
|
|
285
|
-
keywords: [memory, claude-mem, persistence, session, context]
|
|
286
|
-
rule_references: [R011]
|
|
287
|
-
|
|
288
|
-
memory-recall:
|
|
289
|
-
class: MemorySkill
|
|
290
|
-
description: "Search and recall memories from claude-mem"
|
|
291
|
-
user_invocable: true
|
|
292
|
-
model_invocable: true
|
|
293
|
-
summary: "Search and recall relevant memories from claude-mem using semantic search"
|
|
294
|
-
keywords: [memory, recall, search, semantic, claude-mem]
|
|
295
|
-
rule_references: [R011]
|
|
296
|
-
|
|
297
|
-
memory-save:
|
|
298
|
-
class: MemorySkill
|
|
299
|
-
description: "Save current session context to claude-mem"
|
|
300
|
-
user_invocable: true
|
|
301
|
-
model_invocable: false
|
|
302
|
-
summary: "Save current session context to claude-mem for persistence across compaction"
|
|
303
|
-
keywords: [memory, save, session, context, claude-mem]
|
|
304
|
-
rule_references: [R011]
|
|
305
|
-
|
|
306
275
|
monitoring-setup:
|
|
307
276
|
class: MonitoringSkill
|
|
308
277
|
description: "Enable/disable OpenTelemetry console monitoring for Claude Code usage tracking"
|
|
@@ -9,8 +9,7 @@
|
|
|
9
9
|
"typescript-lsp@claude-plugins-official",
|
|
10
10
|
"context7@claude-plugins-official",
|
|
11
11
|
"superpowers-developing-for-claude-code@superpowers-marketplace",
|
|
12
|
-
"episodic-memory@superpowers-marketplace"
|
|
13
|
-
"claude-mem@thedotmack"
|
|
12
|
+
"episodic-memory@superpowers-marketplace"
|
|
14
13
|
],
|
|
15
14
|
"disabled": [
|
|
16
15
|
"codex@openai-codex",
|
|
@@ -2,12 +2,11 @@
|
|
|
2
2
|
|
|
3
3
|
> **Priority**: SHOULD | **ID**: R011
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
> **Note**: This project uses **native auto memory ONLY** (memory/MEMORY.md + agent frontmatter `memory:`). claude-mem and agentmemory MCP are NOT used in this project. Decision: issue #1253.
|
|
6
6
|
|
|
7
|
-
|
|
8
|
-
**Supplementary**: claude-mem MCP (optional, for cross-session search and temporal queries).
|
|
7
|
+
## Architecture
|
|
9
8
|
|
|
10
|
-
|
|
9
|
+
**Sole backend**: Native auto memory (`memory` field in agent frontmatter). No external MCP dependencies.
|
|
11
10
|
|
|
12
11
|
## Native Auto Memory
|
|
13
12
|
|
|
@@ -22,15 +21,6 @@ Agent frontmatter `memory: project|user|local` enables persistent memory:
|
|
|
22
21
|
| `project` | `.claude/agent-memory/<name>/` | Yes |
|
|
23
22
|
| `local` | `.claude/agent-memory-local/<name>/` | No |
|
|
24
23
|
|
|
25
|
-
## When to Use claude-mem
|
|
26
|
-
|
|
27
|
-
| Scenario | Native | claude-mem |
|
|
28
|
-
|----------|--------|------------|
|
|
29
|
-
| Agent learns project patterns | Yes | |
|
|
30
|
-
| Search across sessions | | Yes |
|
|
31
|
-
| Temporal queries | | Yes |
|
|
32
|
-
| Cross-agent sharing | | Yes |
|
|
33
|
-
|
|
34
24
|
## Best Practices
|
|
35
25
|
|
|
36
26
|
- Consult memory before starting work
|
|
@@ -311,9 +301,9 @@ Related records from session v0.87.2~v0.88.0 (issue #869):
|
|
|
311
301
|
|
|
312
302
|
Session-end detected when user says: "끝", "종료", "마무리", "done", "wrap up", "end session", or explicitly requests session save.
|
|
313
303
|
|
|
314
|
-
See flow diagram
|
|
304
|
+
See flow diagram and responsibility split via Read tool.
|
|
315
305
|
|
|
316
|
-
<!-- DETAIL: Session-End Flow, Responsibility Split
|
|
306
|
+
<!-- DETAIL: Session-End Flow, Responsibility Split
|
|
317
307
|
### Flow
|
|
318
308
|
|
|
319
309
|
```
|
|
@@ -323,35 +313,20 @@ User signals session end
|
|
|
323
313
|
1. Collect session summary (tasks, decisions, open items)
|
|
324
314
|
2. Update native auto-memory (MEMORY.md)
|
|
325
315
|
3. Return formatted summary to orchestrator
|
|
326
|
-
→ Orchestrator performs MCP saves directly:
|
|
327
|
-
1. claude-mem save (if available via ToolSearch)
|
|
328
|
-
(episodic-memory auto-indexes after session — no action needed)
|
|
329
316
|
→ Orchestrator confirms to user
|
|
330
317
|
```
|
|
331
318
|
|
|
332
319
|
### Responsibility Split
|
|
333
320
|
|
|
334
|
-
MCP tools (claude-mem, episodic-memory) are **orchestrator-scoped** and not inherited by subagents. Therefore:
|
|
335
|
-
|
|
336
321
|
| Responsibility | Owner | Reason |
|
|
337
322
|
|----------------|-------|--------|
|
|
338
323
|
| Session summary collection | sys-memory-keeper | Domain expertise in memory formatting |
|
|
339
324
|
| Native auto-memory (MEMORY.md) | sys-memory-keeper | Has Write access to memory directory |
|
|
340
|
-
| claude-mem MCP save | Orchestrator | MCP tools only available at orchestrator level |
|
|
341
|
-
| episodic-memory | Automatic | Conversations are auto-indexed after session ends — no manual action needed |
|
|
342
|
-
|
|
343
|
-
### Dual-System Save
|
|
344
|
-
|
|
345
|
-
| System | Owner | Tool | Action | Required |
|
|
346
|
-
|--------|-------|------|--------|----------|
|
|
347
|
-
| Native auto-memory | sys-memory-keeper | Write | Update MEMORY.md with session learnings | Yes |
|
|
348
|
-
| claude-mem | Orchestrator | `mcp__plugin_claude-mem_mcp-search__save_memory` | Save session summary with project, tasks, decisions | No (best-effort) |
|
|
349
|
-
| episodic-memory | Automatic | (auto-indexed) | No action needed — conversations are indexed automatically after session ends | N/A |
|
|
350
325
|
-->
|
|
351
326
|
|
|
352
327
|
### Session-End Self-Check (MANDATORY)
|
|
353
328
|
|
|
354
|
-
(1) sys-memory-keeper updated MEMORY.md? (2)
|
|
329
|
+
(1) sys-memory-keeper updated MEMORY.md? (2) If `omcustom-feedback` skill is active, model MAY draft a retrospective feedback issue for user approval — or prompt user to trigger it manually. Both required before confirming to user. See full self-check via Read tool.
|
|
355
330
|
|
|
356
331
|
<!-- DETAIL: Session-End Self-Check (MANDATORY)
|
|
357
332
|
```
|
|
@@ -362,23 +337,14 @@ MCP tools (claude-mem, episodic-memory) are **orchestrator-scoped** and not inhe
|
|
|
362
337
|
║ YES → Continue ║
|
|
363
338
|
║ NO → Delegate to sys-memory-keeper first ║
|
|
364
339
|
║ ║
|
|
365
|
-
║ 2.
|
|
366
|
-
║ YES → Continue (even if it failed) ║
|
|
367
|
-
║ NO → ToolSearch + save now ║
|
|
368
|
-
║ ║
|
|
369
|
-
║ 3. Is omcustom-feedback skill available in this project? ║
|
|
340
|
+
║ 2. Is omcustom-feedback skill available in this project? ║
|
|
370
341
|
║ YES → If notable friction/learning observed: MODEL DRAFTS ║
|
|
371
342
|
║ retrospective issue → presents via Phase 4A preview ║
|
|
372
343
|
║ gate for user approval. Otherwise: prompt user to ║
|
|
373
344
|
║ trigger manually. Accept skip either way. ║
|
|
374
345
|
║ NO → Skip ║
|
|
375
346
|
║ ║
|
|
376
|
-
║ Note: episodic-memory auto-indexes conversations after session ║
|
|
377
|
-
║ ends. No manual action needed — do NOT search as "verification" ║
|
|
378
|
-
║ ║
|
|
379
347
|
║ ALL steps must be completed before confirming to user. ║
|
|
380
|
-
║ "Attempted" means called the tool — failure is OK, skipping ║
|
|
381
|
-
║ is NOT. ║
|
|
382
348
|
╚══════════════════════════════════════════════════════════════════╝
|
|
383
349
|
```
|
|
384
350
|
-->
|
|
@@ -412,49 +378,5 @@ References: #1226 (item 3), #1227.
|
|
|
412
378
|
|
|
413
379
|
### Failure Policy
|
|
414
380
|
|
|
415
|
-
-
|
|
416
|
-
- If
|
|
417
|
-
- episodic-memory: no action needed (auto-indexed after session)
|
|
418
|
-
|
|
419
|
-
## Dual-Backend Advisory (AgentMemory + claude-mem)
|
|
420
|
-
|
|
421
|
-
#1169 Phase 1 (COEXIST) 단계에서 두 memory backend 동시 활성 가능:
|
|
422
|
-
|
|
423
|
-
| 상황 | 권장 |
|
|
424
|
-
|------|------|
|
|
425
|
-
| claude-mem 단독 | 기본값 — 현 운영 유지 |
|
|
426
|
-
| AgentMemory 단독 | Phase 2 (SWITCH) 이후 진행 |
|
|
427
|
-
| 둘 다 활성 (COEXIST) | Phase 1 한정 — `memory-aggregator`가 결과 병합 |
|
|
428
|
-
|
|
429
|
-
### 충돌 감지
|
|
430
|
-
|
|
431
|
-
`.mcp.json`에 두 서버(`claude-mem`, `agentmemory`) 동시 등록 시 첫 호출 시점에 advisory 출력 권장:
|
|
432
|
-
|
|
433
|
-
```
|
|
434
|
-
[Advisory] Dual memory backend detected (Phase 1 COEXIST)
|
|
435
|
-
- claude-mem: active (Chroma)
|
|
436
|
-
- agentmemory: active (SQLite)
|
|
437
|
-
Phase 2 SWITCH 진입 전까지 두 backend 유지
|
|
438
|
-
가이드: guides/agentmemory-migration/phase-1-coexist.md
|
|
439
|
-
```
|
|
440
|
-
|
|
441
|
-
이 advisory는 경고가 아닙니다. Phase 1 COEXIST에서는 정상 상태입니다.
|
|
442
|
-
|
|
443
|
-
### Session-End Self-Check (COEXIST 확장)
|
|
444
|
-
|
|
445
|
-
Phase 1 COEXIST 기간 중 세션 종료 시:
|
|
446
|
-
|
|
447
|
-
1. sys-memory-keeper가 MEMORY.md 갱신? → YES: 계속
|
|
448
|
-
2. claude-mem 저장 시도? → YES (기존 항목)
|
|
449
|
-
3. AgentMemory 저장 시도? → YES (COEXIST 추가)
|
|
450
|
-
4. omcustom-feedback 처리? → YES (활성 시, notable friction 있으면 model draft → Phase 4A gate; 없으면 사용자 권유) / 스킵 (비활성 시)
|
|
451
|
-
네 단계 모두 완료 후 사용자에게 확인. 둘 중 하나 실패해도 비차단.
|
|
452
|
-
|
|
453
|
-
### Phase 2 진입 전 필수 조건
|
|
454
|
-
|
|
455
|
-
- 1주 measure 결과 (`scripts/measure-claude-mem-usage.sh`) GO 판정
|
|
456
|
-
- 자산 처리표 사용자 검토 완료 (12 plugin skill 처리 방향 결정)
|
|
457
|
-
- 30분 롤백 절차 검증 (Chroma 백업 + 복원 테스트)
|
|
458
|
-
|
|
459
|
-
Refs: #1169 본문 조치 3 (택1 강제), 조치 4 (롤백 절차),
|
|
460
|
-
`guides/agentmemory-migration/phase-1-coexist.md`.
|
|
381
|
+
- Memory write failure is **non-blocking**: MUST NOT prevent session from ending
|
|
382
|
+
- If sys-memory-keeper fails to write MEMORY.md: log warning, confirm to user anyway
|
|
@@ -112,8 +112,7 @@ oh-my-customcode uses existing infrastructure for trajectory capture:
|
|
|
112
112
|
|
|
113
113
|
| Component | Role | How |
|
|
114
114
|
|-----------|------|-----|
|
|
115
|
-
|
|
|
116
|
-
| episodic-memory | Cross-session trajectory comparison | Auto-indexed after session; query for historical baselines |
|
|
115
|
+
| native MEMORY.md (R011) | Persist eval metrics across sessions | Write `## Metrics` section with task_id + observed metrics to agent-memory MEMORY.md |
|
|
117
116
|
| statusline.sh (R012) | Real-time step counter during eval runs | Extend statusline with `STEPS=n` segment |
|
|
118
117
|
| `.claude/outputs/evals/` | Artifact storage for eval results | Per-session eval reports in `sessions/{YYYY-MM-DD}/` |
|
|
119
118
|
|
|
@@ -121,7 +120,7 @@ oh-my-customcode uses existing infrastructure for trajectory capture:
|
|
|
121
120
|
```
|
|
122
121
|
task start → record tool_calls[] + timestamps → task end
|
|
123
122
|
→ compute ratios against ideal trajectory
|
|
124
|
-
→
|
|
123
|
+
→ write to native MEMORY.md ## Metrics: {task_id, capability, correctness, step_ratio, tool_call_ratio, latency_ratio}
|
|
125
124
|
```
|
|
126
125
|
|
|
127
126
|
### Persistent Storage (added v0.116.0, #1036)
|
|
@@ -125,15 +125,7 @@ CRG는 recall 최적화 도구다. 다음 사항을 반드시 숙지한다:
|
|
|
125
125
|
|------|----------|
|
|
126
126
|
| `dev-review` | CRG로 영향 범위 파악 → dev-review로 상세 리뷰 |
|
|
127
127
|
| `adversarial-review` | CRG `get_minimal_context` → adversarial-review 입력 최적화 |
|
|
128
|
-
| `
|
|
129
|
-
| `claude-mem:pathfinder` | CRG `get_impact_radius`로 대체 가능 (Phase β 시퀀싱 — #1169 참조) |
|
|
130
|
-
|
|
131
|
-
### 마이그레이션 예정 (Phase β)
|
|
132
|
-
|
|
133
|
-
- `claude-mem:smart-explore` → CRG `query_graph` (#1169)
|
|
134
|
-
- `claude-mem:pathfinder` → CRG `get_impact_radius` (#1169)
|
|
135
|
-
|
|
136
|
-
Phase β 완료 전까지는 두 자산을 병행 사용한다.
|
|
128
|
+
| `semble-integration` | Semble (의미) + CRG (구조) 결합으로 완전한 코드 이해 |
|
|
137
129
|
|
|
138
130
|
## R013 Ecomode와의 관계
|
|
139
131
|
|
|
@@ -159,5 +151,4 @@ R013 ecomode가 자동 활성화되는 시점 (context 사용량 ≥ 60%)에서
|
|
|
159
151
|
|
|
160
152
|
- 상세 설치/설정: `guides/token-efficiency/crg.md`
|
|
161
153
|
- 관련 이슈: #1171 (scout:integrate CRG)
|
|
162
|
-
- Phase β 시퀀싱: #1169 (AgentMemory 전환 계획)
|
|
163
154
|
- 기술 출처: [tirth8205/code-review-graph](https://github.com/tirth8205/code-review-graph)
|
|
@@ -152,8 +152,7 @@ Reference: `feedback_sensitive_path_tmp_bypass.md`, R006 sensitive-path handling
|
|
|
152
152
|
|
|
153
153
|
CRG MCP 미연결 시 자동 fallback:
|
|
154
154
|
1. grep/Grep 도구로 영향 범위 추적
|
|
155
|
-
2.
|
|
156
|
-
3. 전체 디렉토리 읽기 (R013 ecomode 트리거 가능성)
|
|
155
|
+
2. 전체 디렉토리 읽기 (R013 ecomode 트리거 가능성)
|
|
157
156
|
|
|
158
157
|
### R013 Ecomode 정합
|
|
159
158
|
|
|
@@ -49,7 +49,7 @@ Example: `/goal Add a /weekly-summary command that aggregates last 7 days of git
|
|
|
49
49
|
|
|
50
50
|
| Scenario | Use Instead |
|
|
51
51
|
|----------|-------------|
|
|
52
|
-
| Pure research/analysis | `research`, `idea
|
|
52
|
+
| Pure research/analysis | `research`, `idea` |
|
|
53
53
|
| Specialist domain task | Routing skills (`dev-lead-routing`, `de-lead-routing`, `qa-lead-routing`) |
|
|
54
54
|
| Trivial single-file edit | Delegate directly to specialist agent |
|
|
55
55
|
| Bug debugging | `superpowers:systematic-debugging` |
|
|
@@ -171,6 +171,4 @@ R016 트리거 감지 시 오케스트레이터는 두 스킬을 순차 실행
|
|
|
171
171
|
## 한계
|
|
172
172
|
|
|
173
173
|
- **transcript 형식 의존**: CC `session-*.jsonl` 스키마 변경 시 파싱 재구현 필요.
|
|
174
|
-
AgentMemory 마이그레이션(#1169, Phase 3 DECOUPLE) 완료 후 transcript 경로/형식 재검토 예정.
|
|
175
174
|
- **클러스터링 정확도**: 키워드 기반 클러스터링으로 의미적 동의어 처리 제한.
|
|
176
|
-
- **Phase γ 제약**: #1169 AgentMemory Phase 3 이전에는 transcript 형식 불안정 — `--dry-run` 권장.
|
|
@@ -601,25 +601,6 @@ agents:
|
|
|
601
601
|
base_confidence: 75
|
|
602
602
|
routing_rule: "Invoke dev-refactor skill"
|
|
603
603
|
|
|
604
|
-
# Memory skills
|
|
605
|
-
skill-memory-save:
|
|
606
|
-
keywords:
|
|
607
|
-
korean: [메모리 저장, 기억해, 저장해]
|
|
608
|
-
english: ["save memory", "remember this", "store this"]
|
|
609
|
-
file_patterns: []
|
|
610
|
-
supported_actions: [save, store, remember]
|
|
611
|
-
base_confidence: 85
|
|
612
|
-
routing_rule: "Invoke memory-management skill"
|
|
613
|
-
|
|
614
|
-
skill-memory-recall:
|
|
615
|
-
keywords:
|
|
616
|
-
korean: [메모리 검색, 기억 찾기, 회상]
|
|
617
|
-
english: ["recall memory", "search memory", "find memory", "what did we"]
|
|
618
|
-
file_patterns: []
|
|
619
|
-
supported_actions: [recall, search, find]
|
|
620
|
-
base_confidence: 85
|
|
621
|
-
routing_rule: "Invoke memory-recall skill"
|
|
622
|
-
|
|
623
604
|
# Harness management skills
|
|
624
605
|
skill-analysis:
|
|
625
606
|
keywords:
|
|
@@ -17,7 +17,6 @@ Enables cross-session coordination between multiple Claude Code instances throug
|
|
|
17
17
|
|-------|-----------|-------|----------|
|
|
18
18
|
| Intra-session agents | Agent Teams (R018) | TeamCreate, SendMessage | Single session multi-agent collaboration |
|
|
19
19
|
| Cross-session instances | claude-peers-mcp | list_peers, send_message | Multi-terminal/project real-time coordination |
|
|
20
|
-
| Cross-session memory | claude-mem | save_memory, search | Async memory persistence |
|
|
21
20
|
|
|
22
21
|
> **Important**: R018's `SendMessage` and claude-peers-mcp's `send_message` are different tools with different scopes. Do not confuse them.
|
|
23
22
|
|
|
@@ -54,6 +53,5 @@ claude mcp add claude-peers-mcp -- npx claude-peers-mcp
|
|
|
54
53
|
## Integration
|
|
55
54
|
|
|
56
55
|
- Works with R018 Agent Teams (different scope, complementary)
|
|
57
|
-
- Works with claude-mem (async vs sync messaging)
|
|
58
56
|
- Works with `omcustom:status` (peer discovery)
|
|
59
57
|
- Broker runs on localhost:7899 (SQLite-backed)
|
|
@@ -147,7 +147,6 @@ R013 ecomode가 자동 활성화되는 시점 (context 사용량 ≥ 60%)에서
|
|
|
147
147
|
|
|
148
148
|
| 기존 방식 | Semble 대체 가능 여부 |
|
|
149
149
|
|----------|---------------------|
|
|
150
|
-
| `claude-mem:smart-explore` 의 자연어 탐색 | 일부 대체 가능 — 구조 탐색은 CRG 유지 |
|
|
151
150
|
| grep + Read 조합의 패턴 검색 | 대체 권장 (98% 토큰 절감) |
|
|
152
151
|
|
|
153
152
|
## 트러블슈팅
|
package/templates/CLAUDE.md
CHANGED
|
@@ -81,7 +81,7 @@ oh-my-customcode로 구동됩니다.
|
|
|
81
81
|
|----|------|------|
|
|
82
82
|
| R003 | 상호작용 규칙 | 응답 원칙, 상태 형식 |
|
|
83
83
|
| R004 | 오류 처리 | 오류 수준, 복구 전략 |
|
|
84
|
-
| R011 | 메모리 통합 |
|
|
84
|
+
| R011 | 메모리 통합 | 세션 메모리 지속성 |
|
|
85
85
|
| R012 | HUD 상태줄 | 실시간 상태 표시 |
|
|
86
86
|
| R013 | Ecomode | 배치 작업 토큰 효율성 |
|
|
87
87
|
| R019 | Ontology-RAG 라우팅 | 라우팅 스킬의 ontology-RAG enrichment |
|
|
@@ -104,7 +104,6 @@ oh-my-customcode로 구동됩니다.
|
|
|
104
104
|
| 검증 | `/omcustom:sauron-watch`, `/deep-verify`, `/adversarial-review` | R017 검증, 릴리즈 품질, 보안 리뷰 |
|
|
105
105
|
| 릴리즈 | `/pipeline auto-dev`, `/omcustom-release-notes`, `/release-plan` | 자동 개발, 릴리즈 노트 |
|
|
106
106
|
| 리서치 | `/research`, `/scout`, `/deep-plan`, `/omcustom:agora` | 병렬 분석, URL 평가, 연구 계획 |
|
|
107
|
-
| 메모리 | `/memory-save`, `/memory-recall` | 세션 메모리 관리 |
|
|
108
107
|
| 최적화 | `/token-efficiency-audit` | 토큰 효율 감사 (5계층 방어 스택) |
|
|
109
108
|
| 시스템 | `/omcustom:lists`, `/omcustom:status`, `/omcustom:help` | 전체 목록, 상태, 도움말 |
|
|
110
109
|
|
|
@@ -117,11 +116,11 @@ project/
|
|
|
117
116
|
+-- CLAUDE.md # 진입점
|
|
118
117
|
+-- .claude/
|
|
119
118
|
| +-- agents/ # 서브에이전트 정의 (49 파일)
|
|
120
|
-
| +-- skills/ # 스킬 (
|
|
119
|
+
| +-- skills/ # 스킬 (118 디렉토리)
|
|
121
120
|
| +-- rules/ # 전역 규칙 (R000-R023)
|
|
122
121
|
| +-- hooks/ # 훅 스크립트 (보안, 검증, HUD)
|
|
123
122
|
| +-- contexts/ # 컨텍스트 파일 (ecomode)
|
|
124
|
-
+-- guides/ # 레퍼런스 문서 (
|
|
123
|
+
+-- guides/ # 레퍼런스 문서 (57 토픽)
|
|
125
124
|
```
|
|
126
125
|
|
|
127
126
|
## 오케스트레이션
|
|
@@ -211,10 +210,6 @@ Claude Code의 Agent Teams 기능이 활성화되어 있으면 (`CLAUDE_CODE_EXP
|
|
|
211
210
|
# 코드 리뷰
|
|
212
211
|
/dev-review src/main.go
|
|
213
212
|
|
|
214
|
-
# 메모리 관리
|
|
215
|
-
/memory-save
|
|
216
|
-
/memory-recall authentication
|
|
217
|
-
|
|
218
213
|
# 검증
|
|
219
214
|
/omcustom:sauron-watch
|
|
220
215
|
```
|
|
@@ -245,8 +240,6 @@ Claude Code의 Agent Teams 기능이 활성화되어 있으면 (`CLAUDE_CODE_EXP
|
|
|
245
240
|
|
|
246
241
|
| 서버 | 용도 |
|
|
247
242
|
|------|------|
|
|
248
|
-
| claude-mem | 세션 메모리 영속성 (Chroma 기반) — Phase β (#1169) COEXIST 진행 중 |
|
|
249
|
-
| **agentmemory** | claude-mem 대체 후보 (SQLite 기반, 4-tier consolidation) — Phase 1 COEXIST (#1169) |
|
|
250
243
|
| code-review-graph | Token-efficient AST 기반 context retrieval (8.2× 토큰 절감) — wrapper: `crg-integration` 스킬 (#1171) |
|
|
251
244
|
| semble | Semantic code search via embeddings (98% 토큰 절감, NDCG@10=0.854) — wrapper: `semble-integration` 스킬 (#1173) |
|
|
252
245
|
|
|
@@ -261,16 +254,6 @@ Claude Code의 Agent Teams 기능이 활성화되어 있으면 (`CLAUDE_CODE_EXP
|
|
|
261
254
|
/plugin install superpowers-developing-for-claude-code
|
|
262
255
|
/plugin install elements-of-style
|
|
263
256
|
|
|
264
|
-
# MCP 설정 (claude-mem)
|
|
265
|
-
npm install -g claude-mem
|
|
266
|
-
claude-mem setup
|
|
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
|
-
|
|
274
257
|
# CRG MCP 설치 (token efficiency)
|
|
275
258
|
pipx install code-review-graph
|
|
276
259
|
# .mcp.json 에 code-review-graph 서버 수동 추가 (R001 auto-install 금지)
|
package/templates/CLAUDE.md.en
CHANGED
|
@@ -78,7 +78,7 @@ NO EXCEPTIONS. NO EXCUSES.
|
|
|
78
78
|
|----|------|-------------|
|
|
79
79
|
| R003 | Interaction Rules | Response principles, status format |
|
|
80
80
|
| R004 | Error Handling | Error levels, recovery strategy |
|
|
81
|
-
| R011 | Memory Integration | Session persistence
|
|
81
|
+
| R011 | Memory Integration | Session memory persistence |
|
|
82
82
|
| R012 | HUD Statusline | Real-time status display |
|
|
83
83
|
| R013 | Ecomode | Token efficiency for batch ops |
|
|
84
84
|
| R019 | Ontology-RAG Routing | Ontology-RAG enrichment for routing skills |
|
|
@@ -103,8 +103,6 @@ NO EXCEPTIONS. NO EXCUSES.
|
|
|
103
103
|
| `/omcustom-takeover` | Extract canonical spec from existing agent/skill |
|
|
104
104
|
| `/dev-review` | Review code for best practices |
|
|
105
105
|
| `/dev-refactor` | Refactor code |
|
|
106
|
-
| `/memory-save` | Save session context to claude-mem |
|
|
107
|
-
| `/memory-recall` | Search and recall memories |
|
|
108
106
|
| `/omcustom:monitoring-setup` | Enable/disable OTel console monitoring |
|
|
109
107
|
| `/omcustom:npm-publish` | Publish package to npm registry |
|
|
110
108
|
| `/omcustom:npm-version` | Manage semantic versions |
|
|
@@ -129,7 +127,7 @@ project/
|
|
|
129
127
|
+-- CLAUDE.md # Entry point
|
|
130
128
|
+-- .claude/
|
|
131
129
|
| +-- agents/ # Subagent definitions (44 files)
|
|
132
|
-
| +-- skills/ # Skills (
|
|
130
|
+
| +-- skills/ # Skills (118 directories)
|
|
133
131
|
| +-- rules/ # Global rules (R000-R020)
|
|
134
132
|
| +-- hooks/ # Hook scripts (security, validation, HUD)
|
|
135
133
|
| +-- contexts/ # Context files (ecomode)
|
|
@@ -208,10 +206,6 @@ Task tool + routing skills remain the fallback for simple/cost-sensitive tasks.
|
|
|
208
206
|
# Code review
|
|
209
207
|
/dev-review src/main.go
|
|
210
208
|
|
|
211
|
-
# Memory management
|
|
212
|
-
/memory-save
|
|
213
|
-
/memory-recall authentication
|
|
214
|
-
|
|
215
209
|
# Verification
|
|
216
210
|
/omcustom:sauron-watch
|
|
217
211
|
```
|
|
@@ -230,12 +224,6 @@ Install via `/plugin install <name>`:
|
|
|
230
224
|
| obsidian-skills | - | Obsidian markdown support |
|
|
231
225
|
| context7 | claude-plugins-official | Library documentation lookup |
|
|
232
226
|
|
|
233
|
-
### Recommended MCP Servers
|
|
234
|
-
|
|
235
|
-
| Server | Purpose |
|
|
236
|
-
|--------|---------|
|
|
237
|
-
| claude-mem | Session memory persistence (Chroma-based) |
|
|
238
|
-
|
|
239
227
|
### Setup Commands
|
|
240
228
|
|
|
241
229
|
```bash
|
|
@@ -246,10 +234,6 @@ Install via `/plugin install <name>`:
|
|
|
246
234
|
/plugin install superpowers
|
|
247
235
|
/plugin install superpowers-developing-for-claude-code
|
|
248
236
|
/plugin install elements-of-style
|
|
249
|
-
|
|
250
|
-
# MCP setup (claude-mem)
|
|
251
|
-
npm install -g claude-mem
|
|
252
|
-
claude-mem setup
|
|
253
237
|
```
|
|
254
238
|
|
|
255
239
|
<!-- omcustom:git-workflow -->
|
package/templates/CLAUDE.md.ko
CHANGED
|
@@ -78,7 +78,7 @@ oh-my-customcode로 구동됩니다.
|
|
|
78
78
|
|----|------|------|
|
|
79
79
|
| R003 | 상호작용 규칙 | 응답 원칙, 상태 형식 |
|
|
80
80
|
| R004 | 오류 처리 | 오류 수준, 복구 전략 |
|
|
81
|
-
| R011 | 메모리 통합 |
|
|
81
|
+
| R011 | 메모리 통합 | 세션 메모리 지속성 |
|
|
82
82
|
| R012 | HUD 상태줄 | 실시간 상태 표시 |
|
|
83
83
|
| R013 | Ecomode | 배치 작업 토큰 효율성 |
|
|
84
84
|
| R019 | Ontology-RAG 라우팅 | 라우팅 스킬의 ontology-RAG enrichment |
|
|
@@ -103,8 +103,6 @@ oh-my-customcode로 구동됩니다.
|
|
|
103
103
|
| `/omcustom-takeover` | 기존 에이전트/스킬에서 canonical spec 추출 |
|
|
104
104
|
| `/dev-review` | 코드 베스트 프랙티스 리뷰 |
|
|
105
105
|
| `/dev-refactor` | 코드 리팩토링 |
|
|
106
|
-
| `/memory-save` | 세션 컨텍스트를 claude-mem에 저장 |
|
|
107
|
-
| `/memory-recall` | 메모리 검색 및 리콜 |
|
|
108
106
|
| `/omcustom:monitoring-setup` | OTel 콘솔 모니터링 활성화/비활성화 |
|
|
109
107
|
| `/omcustom:npm-publish` | npm 레지스트리에 패키지 배포 |
|
|
110
108
|
| `/omcustom:npm-version` | 시맨틱 버전 관리 |
|
|
@@ -129,7 +127,7 @@ project/
|
|
|
129
127
|
+-- CLAUDE.md # 진입점
|
|
130
128
|
+-- .claude/
|
|
131
129
|
| +-- agents/ # 서브에이전트 정의 (44 파일)
|
|
132
|
-
| +-- skills/ # 스킬 (
|
|
130
|
+
| +-- skills/ # 스킬 (118 디렉토리)
|
|
133
131
|
| +-- rules/ # 전역 규칙 (R000-R020)
|
|
134
132
|
| +-- hooks/ # 훅 스크립트 (보안, 검증, HUD)
|
|
135
133
|
| +-- contexts/ # 컨텍스트 파일 (ecomode)
|
|
@@ -208,10 +206,6 @@ Claude Code의 Agent Teams 기능이 활성화되어 있으면 (`CLAUDE_CODE_EXP
|
|
|
208
206
|
# 코드 리뷰
|
|
209
207
|
/dev-review src/main.go
|
|
210
208
|
|
|
211
|
-
# 메모리 관리
|
|
212
|
-
/memory-save
|
|
213
|
-
/memory-recall authentication
|
|
214
|
-
|
|
215
209
|
# 검증
|
|
216
210
|
/omcustom:sauron-watch
|
|
217
211
|
```
|
|
@@ -230,12 +224,6 @@ Claude Code의 Agent Teams 기능이 활성화되어 있으면 (`CLAUDE_CODE_EXP
|
|
|
230
224
|
| obsidian-skills | - | 옵시디언 마크다운 지원 |
|
|
231
225
|
| context7 | claude-plugins-official | 라이브러리 문서 조회 |
|
|
232
226
|
|
|
233
|
-
### 권장 MCP 서버
|
|
234
|
-
|
|
235
|
-
| 서버 | 용도 |
|
|
236
|
-
|------|------|
|
|
237
|
-
| claude-mem | 세션 메모리 영속성 (Chroma 기반) |
|
|
238
|
-
|
|
239
227
|
### 설치 명령어
|
|
240
228
|
|
|
241
229
|
```bash
|
|
@@ -246,10 +234,6 @@ Claude Code의 Agent Teams 기능이 활성화되어 있으면 (`CLAUDE_CODE_EXP
|
|
|
246
234
|
/plugin install superpowers
|
|
247
235
|
/plugin install superpowers-developing-for-claude-code
|
|
248
236
|
/plugin install elements-of-style
|
|
249
|
-
|
|
250
|
-
# MCP 설정 (claude-mem)
|
|
251
|
-
npm install -g claude-mem
|
|
252
|
-
claude-mem setup
|
|
253
237
|
```
|
|
254
238
|
|
|
255
239
|
<!-- omcustom:git-workflow -->
|