oh-my-customcode 0.156.3 → 0.157.1

package/templates/guides/agent-design/ralph-loop-pattern.md

@@ -9,7 +9,7 @@ LLM 에이전트는 세션 종료 시 누적된 맥락(tacit knowledge, 실패
 
 ## Claude Code 통합
 
-- **claude-mem MCP**: feedback memories + session archives를 영속 저장소로
+- **native auto-memory**: feedback memories + session archives를 영속 저장소로 (R011)
 - **sys-memory-keeper 에이전트**: 세션 종료 시 Ralph Loop 요약 수행
 - **R011 Memory Integration**: native auto-memory를 Ralph Loop의 primary writer로
 
@@ -18,7 +18,7 @@ LLM 에이전트는 세션 종료 시 누적된 맥락(tacit knowledge, 실패
 1. **Bootstrap**: 세션 시작 시 MEMORY.md에서 이전 Ralph Loop 요약 로드
 2. **Evolve**: 세션 진행 중 발견한 새 패턴/실패를 feedback memory에 기록
 3. **Compact**: 세션 종료 시 sys-memory-keeper가 Ralph Loop 요약을 MEMORY.md 업데이트
-4. **Persist**: claude-mem MCP에 long-term save (cross-session search)
+4. **Persist**: native auto-memory에 long-term save (cross-session 지속성은 R011 참조)
 
 ## Anti-patterns
 

package/templates/guides/agent-eval/README.md

@@ -536,9 +536,7 @@ LangChain Deep Agents 방법론은 에이전트 작업을 6개 capability로 분
 | 도구/에이전트 | 역할 |
 |---------------|------|
 | 네이티브 auto-memory | agent frontmatter `memory:` 필드 — MEMORY.md |
-| `claude-mem` MCP | 크로스 세션 검색 (`save_memory`, `search_memory`) |
-| `episodic-memory` MCP | 대화 자동 인덱싱 |
-| `sys-memory-keeper` | 메모리 정리·업데이트 전담 에이전트 |
+| `sys-memory-keeper` | 메모리 정리·업데이트 전담 에이전트 (MEMORY.md 관리) |
 
 **conversation**
 
@@ -594,50 +592,32 @@ LangSmith 없이 oh-my-customcode 환경에서 에이전트 실행을 추적하
 
 | LangChain 컴포넌트 | 역할 | oh-my-customcode 대안 |
 |--------------------|----|----------------------|
-| LangSmith trace | step별 실행 기록 수집 | claude-mem `save_memory` per step |
-| Polly (record/replay) | 결정론적 재현을 위한 trace 녹화·재생 | episodic-memory 검색 (`search`) |
+| LangSmith trace | step별 실행 기록 수집 | MEMORY.md `## Metrics` 섹션 per step 기록 |
+| Polly (record/replay) | 결정론적 재현을 위한 trace 녹화·재생 | `.claude/outputs/evals/{task-id}/context.md` 환경 스냅샷 |
 | Insights dashboard | 집계 메트릭 시각화 | statusline.sh (R012) + omcustom-improve-report |
 | Annotation UI | ideal trajectory 편집 GUI | YAML 직접 편집 (.claude/outputs/evals/) |
 | Run comparison | 에이전트 버전 간 성능 비교 | git diff 기반 수동 비교 |
 
-### 5.2 claude-mem 기반 Step Trace
+### 5.2 MEMORY.md 기반 Step Trace
 
-각 tool call 완료 후 claude-mem에 step record를 저장한다:
+각 tool call 완료 후 MEMORY.md `## Metrics` 섹션에 step record를 기록한다:
 
 ```
-# 의사코드 — agent-eval-framework 스킬이 내부적으로 실행
-mcp__plugin_claude-mem_mcp-search__save_memory(
-  content="[eval-step] task=file_ops_001 step=1 tool=Read target=src/main.go elapsed_ms=142 status=ok",
-  metadata={
-    "type": "eval_step",
-    "task_id": "file_ops_001",
-    "step": 1,
-    "tool": "Read",
-    "elapsed_ms": 142
-  }
-)
+# MEMORY.md ## Metrics 섹션 예시
+## Metrics
+- [eval-step] task=file_ops_001 step=1 tool=Read target=src/main.go elapsed_ms=142 status=ok
+- [eval-step] task=file_ops_001 step=2 tool=Edit target=src/main.go elapsed_ms=198 status=ok
 ```
 
-세션 종료 후 `search_memory(query="eval-step task=file_ops_001")`으로 전체 trace 재구성.
-
-**한계**: claude-mem은 문자열 기반 저장이므로 구조화 쿼리가 제한적이다. 복잡한 집계는 저장된 record를 Read로 불러와 수동 파싱해야 한다.
+세션 내 `MEMORY.md`를 Read하여 전체 trace 재구성 가능.
 
 **우회법**: step record를 `.claude/outputs/evals/{task-id}/trace.jsonl`에 병행 기록하면 `Bash(jq)` 파이프라인으로 집계 가능하다.
 
-### 5.3 episodic-memory 기반 재현
-
-`episodic-memory` MCP는 대화를 자동 인덱싱한다. 이전 eval 실행을 재현하거나 참조할 때 활용:
-
-```
-# 이전 eval 실행 검색
-mcp__plugin_episodic-memory_episodic-memory__search(
-  query="agent-eval task file_ops_001"
-)
-```
+### 5.3 환경 스냅샷 기반 재현
 
-**한계**: episodic-memory는 대화 단위 인덱싱이므로 step 단위 세밀도가 낮다. Polly의 결정론적 재현과 달리, 동일 결과를 보장하지 않는다.
+eval 실행 전 `.claude/outputs/evals/{task-id}/context.md`에 환경 스냅샷을 저장한다. 이전 eval 실행을 재현하거나 참조할 때 해당 파일을 컨텍스트로 주입한다.
 
-**우회법**: eval 실행 전 `.claude/outputs/evals/{task-id}/context.md`에 환경 스냅샷을 저장하고, 재현 시 해당 파일을 컨텍스트로 주입한다.
+**한계**: 결정론적 재현을 보장하지 않는다. 동일 결과를 얻으려면 실행 환경(파일 상태, 모델 버전)이 동일해야 한다.
 
 ### 5.4 statusline.sh + omcustom-improve-report 기반 대시보드
 
@@ -689,8 +669,8 @@ events:
 
 | LangChain 컴포넌트 | 역할 | oh-my-customcode 대안 |
 |--------------------|------|----------------------|
-| LangSmith trace | step별 실행 기록 수집 | claude-mem `save_memory` per step (5.2) |
-| Polly (record/replay) | 결정론적 재현 | episodic-memory 검색 (5.3) |
+| LangSmith trace | step별 실행 기록 수집 | MEMORY.md `## Metrics` 섹션 (5.2) |
+| Polly (record/replay) | 결정론적 재현 | 환경 스냅샷 context.md (5.3) |
 | Insights dashboard | 집계 메트릭 시각화 | statusline.sh + omcustom-improve-report (5.4) |
 | **LangSmith OTEL export** | **표준 OTEL span 수집** | **trajectory-otel mode (5.5, #1035)** |
 

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

@@ -12,7 +12,7 @@ oh-my-customcode v0.107.0 targets Claude Code v2.1.116+. All v2.1.117-119 additi
 **Key changes relevant to oh-my-customcode:**
 
 - `CLAUDE_CODE_FORK_SUBAGENT=1` enables forked subagents on external builds — relevant for R018 Agent Teams expansion
-- Main-thread agent `mcpServers` frontmatter loading via `--agent` — broadens MCP integration scope (affects sys-memory-keeper, claude-mem users)
+- Main-thread agent `mcpServers` frontmatter loading via `--agent` — broadens MCP integration scope (affects sys-memory-keeper and native auto-memory users)
 - `/model` persistence across restarts — reduces repeated model selection in long sessions
 - `/resume` summarization of stale sessions — aligns with R013 ecomode context budget
 - Concurrent MCP server startup — shorter session bootstrap
@@ -80,7 +80,7 @@ claude plugin details superpowers
 
 `.mcp.json` 편집 후 CC 재시작 없이 `reconnect` 명령으로 변경사항을 반영합니다. 연결 실패 시 HTTP 상태 코드와 URL이 표시됩니다.
 
-**oh-my-customcode 연관**: `claude-mem`, `ontology-rag` 등 MCP 서버 설정 변경 시 재시작 없이 적용 — 긴 세션 중단 없이 R011 메모리 통합을 재설정할 수 있습니다.
+**oh-my-customcode 연관**: `ontology-rag` 등 MCP 서버 설정 변경 시 재시작 없이 적용 — 긴 세션 중단 없이 R011 메모리 통합을 재설정할 수 있습니다.
 
 ### Transcript View 네비게이션 단축키
 
@@ -197,7 +197,7 @@ export CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1
 export MCP_TOOL_TIMEOUT=120000  # 120초 (밀리초 단위)
 ```
 
-**oh-my-customcode 연관**: `claude-mem`, `ontology-rag` 등 원격 MCP 서버를 사용하는 R011/R019 연동에서 타임아웃 문제가 있었다면 이 변수로 해결 가능. 네트워크 지연이 큰 환경에서 MCP 도구 호출 실패율 감소 기대.
+**oh-my-customcode 연관**: `ontology-rag` 등 원격 MCP 서버를 사용하는 R019 연동에서 타임아웃 문제가 있었다면 이 변수로 해결 가능. 네트워크 지연이 큰 환경에서 MCP 도구 호출 실패율 감소 기대.
 
 ### BG 세션 / Git Worktree Edit 차단 수정
 
@@ -670,7 +670,7 @@ Auto mode에서 user 또는 skill이 명시적으로 요청한 경우 `AskUserQu
 
 1페이지 이후의 항목이 누락되던 버그가 수정되었습니다.
 
-**oh-my-customcode 연관**: `ListMcpResourcesTool` 페이지네이션 안정성이 개선됩니다. `claude-mem`, `ontology-rag` 등 R011/R019 MCP 서버에서 리소스 목록이 많은 경우 전체 항목이 정상 조회됩니다. 호환, 개선.
+**oh-my-customcode 연관**: `ListMcpResourcesTool` 페이지네이션 안정성이 개선됩니다. `ontology-rag` 등 R019 MCP 서버에서 리소스 목록이 많은 경우 전체 항목이 정상 조회됩니다. 호환, 개선.
 
 ### `CLAUDE_CODE_SUBAGENT_MODEL` 자식 프로세스 전파 수정
 
@@ -814,7 +814,7 @@ v2.1.147에서 도입된 regression으로, 일부 사용자에게서 Bash 도구
 
 `/usage`가 limits 사용량 분석을 카테고리별로 표시합니다: skills, subagents, plugins, per-MCP-server 비용 세분화.
 
-**oh-my-customcode 연관**: R013 ecomode 토큰 추적, R012 statusline, `token-efficiency-audit` 스킬과 연관됩니다. per-MCP 비용 가시성 덕분에 `claude-mem`, `ontology-rag` 등 R011/R019 MCP 서버의 비용을 모니터링할 수 있습니다. 호환, 개선.
+**oh-my-customcode 연관**: R013 ecomode 토큰 추적, R012 statusline, `token-efficiency-audit` 스킬과 연관됩니다. per-MCP 비용 가시성 덕분에 `ontology-rag` 등 R019 MCP 서버의 비용을 모니터링할 수 있습니다. 호환, 개선.
 
 ### `/diff` 키보드 스크롤 지원
 
@@ -985,7 +985,7 @@ dispatch 입력의 자동완성이 프로젝트 스킬뿐 아니라 네이티브
 - stateful MCP 서버 reconnect-loop regression 수정 (v2.1.147 도입)
 - 백그라운드 세션 다수 UX/안정성 수정
 
-**oh-my-customcode 연관**: MCP 정책 수정은 R011 claude-mem / R019 ontology-rag 서버 동작에 영향 가능합니다. `subagent_type: 'claude'` gitignored 경로 수정은 R010 subagent 델리게이션 시 `.claude/outputs/` 아티팩트 채널 사용 신뢰성을 높입니다.
+**oh-my-customcode 연관**: MCP 정책 수정은 R011 native auto-memory 및 R019 ontology-rag 서버 동작에 영향 가능합니다. `subagent_type: 'claude'` gitignored 경로 수정은 R010 subagent 델리게이션 시 `.claude/outputs/` 아티팩트 채널 사용 신뢰성을 높입니다.
 
 ### oh-my-customcode 연관 평가
 
@@ -1058,7 +1058,7 @@ Claude가 스스로 판단할 수 있는 상황에서는 multiple-choice prompt
 - `rm -rf $HOME` trailing slash 경우 위험 경로 차단 수정 (R001 보안 강화)
 - 배경 에이전트 worktree 격리 guard 수정 (공유 체크아웃 write 방지)
 
-**oh-my-customcode 연관**: `CLAUDE_CODE_SESSION_ID` 전달은 R011 메모리 MCP 서버(`claude-mem`, `agentmemory`)의 세션 스코핑에 활용 가능합니다. `rm -rf $HOME` trailing slash 수정은 R001 안전 규칙 강화입니다.
+**oh-my-customcode 연관**: `CLAUDE_CODE_SESSION_ID` 전달은 R011 native auto-memory의 세션 스코핑에 활용 가능합니다. `rm -rf $HOME` trailing slash 수정은 R001 안전 규칙 강화입니다.
 
 ### oh-my-customcode 연관 평가
 

package/templates/guides/external-tools/ecc-absorption-decisions.md

@@ -57,8 +57,8 @@ pre-flight 단계를 담당하는 이 패턴은 compilation pipeline을 완성
 `skill-extractor`가 현재 세션의 행동 패턴을 skill로 승격한다면,
 `instinct-extractor`는 누적 세션에서 반복 패턴을 자동 감지합니다.
 두 도구는 trigger가 다릅니다 (단일 세션 vs 누적 히스토리).
-R016 Continuous Improvement 루프를 강화하며, 내부 구조(agent-memory + claude-mem)로
-구현 가능하므로 외부 의존성이 없습니다.
+R016 Continuous Improvement 루프를 강화하며, 내부 구조(agent-memory + 네이티브 자동 메모리)로
+구현 가능하므로 외부 의존성이 없습니다. (원문에서 claude-mem 언급은 #1253에 의해 제거됨)
 
 ---
 

package/templates/guides/harness-engineering/README.md

@@ -230,7 +230,7 @@ oh-my-customcode에서의 현황:
 4. 메모리 저장: feedback_doom_loop_{날짜}.md → 세션 간 패턴 누적
 ```
 
-크로스-세션 패턴 감지에는 `adaptive-harness --learn` + claude-mem MCP를 연동해 동일 실패 패턴이 반복 보고되는 에이전트를 자동 플래그합니다.
+크로스-세션 패턴 감지에는 `adaptive-harness --learn` + native auto-memory(R011)를 연동해 동일 실패 패턴이 반복 보고되는 에이전트를 자동 플래그합니다.
 
 ### Pre-completion Checklist
 
@@ -330,7 +330,7 @@ oh-my-customcode 내에서 이 주기는 다음으로 구현됩니다:
 | 1 | **Filesystems** | 파일 읽기/쓰기/탐색 도구 | Read / Write / Edit / Glob / Grep | ✅ 완비 |
 | 2 | **Bash/Code Execution** | 코드 실행 + 에이전트 격리 | Bash 도구 + agent isolation (`isolation: worktree\|sandbox`) | ✅ 완비 |
 | 3 | **Sandboxes** | 실행 환경 격리 | R006 `isolation: worktree \| sandbox` + `sandboxFailIfUnavailable: true` | ✅ 완비 |
-| 4 | **Memory & Search** | 세션 간 지식 유지 + 검색 | claude-mem MCP + episodic-memory + `.claude/agent-memory/` (R011) | ✅ 완비 |
+| 4 | **Memory & Search** | 세션 간 지식 유지 + 검색 | native auto-memory + `.claude/agent-memory/` (R011) | ✅ 완비 |
 | 5 | **Context Management** | 컨텍스트 예산 관리 + 압축 | R013 ecomode + auto-injection + Deep Insight Context Handoff Pattern | ✅ 완비 |
 | 6 | **Long-Horizon Execution** | 장기 실행 + 복수 에이전트 조율 | Agent Teams + `worker-reviewer-pipeline` + `omcustom-loop` SubagentStop hook | ✅ 완비 |
 

package/templates/guides/middleware-patterns/README.md

@@ -22,7 +22,7 @@ LangChain이 정의한 6개의 lifecycle hook은 다음과 같습니다. 각 단
 
 | LangChain Hook | 설명 | oh-my-customcode 대응 | 스킬/훅 예시 |
 |---|---|---|---|
-| `before_agent` | 에이전트 전체 실행 시작 전 | `SessionStart`, `UserPromptSubmit` hook | claude-mem session-start, omcustom-loop 초기화 |
+| `before_agent` | 에이전트 전체 실행 시작 전 | `SessionStart`, `UserPromptSubmit` hook | MEMORY.md 자동 주입, omcustom-loop 초기화 |
 | `before_model` | 모델 호출 직전 (매 추론 루프마다) | `PreToolUse(Agent)`, pre-generation-arch-check | pre-generation-arch-check 스킬 |
 | `wrap_model_call` | 모델 호출 자체를 래핑 (실제 호출 제어) | Tier 4 permission approval (Bash/WebFetch) | permission hooks, bypassPermissions 게이트 |
 | `wrap_tool_call` | 도구 호출을 래핑 (전후 모두 제어) | `PreToolUse(*) + PostToolUse(*)` | action-validator, task-outcome-recorder |
@@ -33,7 +33,7 @@ LangChain이 정의한 6개의 lifecycle hook은 다음과 같습니다. 각 단
 
 **`before_agent` → SessionStart / UserPromptSubmit**
 
-에이전트가 실행을 시작하기 전에 필요한 컨텍스트를 주입하거나 상태를 초기화합니다. oh-my-customcode에서는 `SessionStart` 훅이 이 역할을 담당합니다. claude-mem의 세션 시작 시 메모리 로드, MEMORY.md의 자동 주입이 전형적인 `before_agent` 패턴입니다. R007의 에이전트 식별 헤더 출력도 이 단계의 산물입니다.
+에이전트가 실행을 시작하기 전에 필요한 컨텍스트를 주입하거나 상태를 초기화합니다. oh-my-customcode에서는 `SessionStart` 훅이 이 역할을 담당합니다. native auto-memory의 MEMORY.md 자동 주입이 전형적인 `before_agent` 패턴입니다. R007의 에이전트 식별 헤더 출력도 이 단계의 산물입니다.
 
 **`before_model` → PreToolUse(Agent) + pre-generation-arch-check**
 
@@ -69,7 +69,6 @@ oh-my-customcode에서는 이 패턴이 다음 방식으로 구현됩니다:
 
 - **입력 마스킹**: `UserPromptSubmit` 훅에서 정규식 기반 PII 패턴 제거 (현재는 rule-level 권고)
 - **메모리 위생**: `sys-memory-keeper`가 MEMORY.md에 민감 데이터를 저장하지 않도록 R011에서 명시
-- **episodic-memory 분리**: 대화 인덱싱 전 민감 세션은 제외 처리
 - **audit trail**: `PostToolUse` 훅이 도구 호출 기록을 남기되, 시크릿/토큰은 stdout/stderr에 노출하지 않음
 
 신규 PII 마스킹 미들웨어를 작성한다면 `before_agent`(세션 전체 PII 정책 초기화)와 `wrap_tool_call`(개별 도구 호출의 인자 검사) 두 단계의 조합으로 설계하는 것을 권장합니다.
@@ -131,7 +130,6 @@ oh-my-customcode에서 이 패턴은 R004의 재시도 정책으로 명문화되
 |---|---|---|
 | `SessionStart` hook | 훅 이벤트 | 세션 초기화, 메모리 로드 |
 | `UserPromptSubmit` hook | 훅 이벤트 | 사용자 입력 전처리, PII 검사 |
-| claude-mem session-start | MCP 패턴 | 이전 세션 컨텍스트 복원 |
 | R007 에이전트 식별 헤더 | 규칙 | 에이전트 신원 선언 |
 | MEMORY.md 자동 주입 | 네이티브 기능 | 200줄 메모리 컨텍스트 주입 |
 
@@ -194,7 +192,7 @@ oh-my-customcode에서 이 패턴은 R004의 재시도 정책으로 명문화되
 
 ```
 [before_agent]
-  SessionStart → MEMORY.md 로드 → claude-mem 컨텍스트 복원
+  SessionStart → MEMORY.md 로드 → 이전 세션 컨텍스트 복원
        ↓
 [before_model]
   pre-generation-arch-check → 아키텍처 경계 검증

package/templates/guides/skill-promotion/instinct-extraction.md

@@ -111,4 +111,4 @@ R016 Defect Response Matrix에서 **Skill Promotion** 조건:
 - `.claude/rules/MUST-agent-design.md` — context fork cap (12/12)
 - `guides/skill-bundle-design/README.md` — skill 설계 패턴
 - Issue #1175 — instinct-extractor 흡수 결정 맥락
-- Issue #1169 — AgentMemory 마이그레이션 (transcript format 안정화 전제)
+- (Issue #1169 AgentMemory 마이그레이션 항목은 #1253에 의해 제거됨)

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

@@ -1,7 +1,7 @@
 # CRG (code-review-graph) 통합 가이드
 
 > **출처**: [tirth8205/code-review-graph](https://github.com/tirth8205/code-review-graph)
-> **관련 이슈**: #1171 (scout:integrate), #1169 (Phase β AgentMemory 전환)
+> **관련 이슈**: #1171 (scout:integrate)
 > **wrapper 스킬**: `.claude/skills/crg-integration/SKILL.md`
 
 ## CRG 개요
@@ -186,14 +186,14 @@ context ≥ 60%에서 파일 직접 읽기 대신 CRG를 우선 사용한다:
 
 ## 기존 자산 마이그레이션 매핑
 
-Phase β에서 claude-mem 일부 기능을 CRG로 전환할 예정이다 (#1169).
+CRG는 코드베이스 탐색 패턴의 일부를 대체할 수 있다.
 
-| 기존 자산 | CRG 대체 도구 | 전환 시점 |
-|----------|--------------|---------|
-| `claude-mem:smart-explore` | `query_graph` | Phase β |
-| `claude-mem:pathfinder` | `get_impact_radius` | Phase β |
+| 기존 패턴 | CRG 대체 도구 |
+|----------|--------------|
+| 전체 파일 Read 후 함수 탐색 | `query_graph` |
+| 변경 영향 범위 수동 파악 | `get_impact_radius` |
 
-**Phase β 완료 전까지**: 두 자산을 병행 사용. CRG를 우선 시도하고, 결과가 불충분하면 기존 자산 사용.
+CRG를 우선 시도하고, 결과가 불충분하면 Grep/Glob 등 기존 도구를 사용한다.
 
 ## 트러블슈팅
 
@@ -212,7 +212,6 @@ Phase β에서 claude-mem 일부 기능을 CRG로 전환할 예정이다 (#1169)
 - **wrapper 스킬**: `.claude/skills/crg-integration/SKILL.md`
 - **관련 이슈**:
   - #1171: scout:integrate CRG (이 가이드의 origin)
-  - #1169: Phase β AgentMemory 전환 시퀀싱
 - **관련 규칙**:
   - R001 (MUST-safety.md): auto-install 금지 정책
   - R013 (SHOULD-ecomode.md): context budget 관리, ecomode 통합

package/templates/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.156.3",
+  "version": "0.157.1",
   "lastUpdated": "2026-05-20T00:00:00.000Z",
   "omcustomMinClaudeCode": "2.1.121",
   "omcustomMinClaudeCodeReason": "Sensitive-path direct Write/Edit on .claude/** under bypassPermissions (R010 deprecation, #1101)",
@@ -20,13 +20,13 @@
       "name": "skills",
       "path": ".claude/skills",
       "description": "Reusable skill modules (includes slash commands)",
-      "files": 121
+      "files": 118
     },
     {
       "name": "guides",
       "path": "guides",
       "description": "Reference documentation",
-      "files": 58
+      "files": 57
     },
     {
       "name": "hooks",

package/templates/.claude/skills/memory-management/SKILL.md

@@ -1,240 +0,0 @@
----
-name: memory-management
-description: Memory persistence operations using claude-mem
-scope: core
-user-invocable: false
----
-
-## Purpose
-
-Provide memory persistence operations using claude-mem for session context survival across compactions.
-
-## Operations
-
-### 1. Save Context
-
-```yaml
-operation: save
-description: Store session context in claude-mem
-steps:
-  1. Collect session data:
-     - Tasks completed
-     - Decisions made
-     - Open items
-     - Key code changes
-  2. Format document:
-     - Add project tag: "my-project"
-     - Add session ID: {date}-{uuid}
-     - Add relevant tags
-  3. Store in claude-mem:
-     - Use chroma_add_documents
-     - Include metadata
-```
-
-### 2. Recall Context
-
-```yaml
-operation: recall
-description: Search and retrieve relevant memories
-steps:
-  1. Build query:
-     - Always prefix with "my-project"
-     - Add user-provided search terms
-     - Include date for temporal searches
-  2. Search claude-mem:
-     - Use chroma_query_documents
-     - Request top N results
-  3. Format results:
-     - Sort by relevance
-     - Present summary
-     - Provide access to full content
-```
-
-### 3. Get Specific Memory
-
-```yaml
-operation: get
-description: Retrieve specific memory by ID
-steps:
-  1. Use chroma_get_documents with ID
-  2. Return full document content
-```
-
-## Query Patterns
-
-### Semantic Search (Primary)
-
-```python
-# Always include project name
-chroma_query_documents(["my-project {search_terms}"])
-
-# Examples:
-chroma_query_documents(["my-project authentication flow"])
-chroma_query_documents(["my-project 2025-01-24 memory system"])
-```
-
-### Get by ID
-
-```python
-# When you have a specific document ID
-chroma_get_documents(ids=["document_id"])
-```
-
-## Document Format
-
-### Save Format
-
-```yaml
-content: |
-  ## Session Summary
-  Date: {date}
-  Session: {session_id}
-
-  ### Tasks Completed
-  - Task 1: Description
-  - Task 2: Description
-
-  ### Decisions Made
-  - Decision 1: Rationale
-  - Decision 2: Rationale
-
-  ### Open Items
-  - Item 1: Status
-  - Item 2: Status
-
-  ### Notes
-  Additional context...
-
-metadata:
-  project: my-project
-  session: {date}-{uuid}
-  tags: [session, task, decision, ...]
-  created_at: {timestamp}
-```
-
-### Recall Response Format
-
-```yaml
-results:
-  - id: doc_1
-    score: 0.95
-    summary: "Authentication flow implementation"
-    date: 2025-01-20
-    tags: [authentication, oauth]
-  - id: doc_2
-    score: 0.87
-    summary: "JWT token decision"
-    date: 2025-01-18
-    tags: [authentication, decision]
-```
-
-## Best Practices
-
-### Query Tips
-
-```yaml
-do:
-  - Always include "my-project" prefix
-  - Use semantic, intent-based queries
-  - Include dates for temporal searches
-  - Use multiple queries for better coverage
-
-dont:
-  - Use complex where filters ($and, $or)
-  - Omit project name
-  - Use overly generic terms
-  - Expect exact string matching
-```
-
-### Save Tips
-
-```yaml
-do:
-  - Include meaningful tags
-  - Write clear summaries
-  - Capture decisions with rationale
-  - Note open items for future reference
-
-dont:
-  - Save trivial conversations
-  - Include sensitive data (API keys, etc.)
-  - Create duplicate entries
-```
-
-## Integration
-
-### With sys-memory-keeper Agent
-
-```
-sys-memory-keeper agent uses this skill for:
-- sys-memory-keeper:save command
-- sys-memory-keeper:recall command
-- PreCompact hook
-- SessionStart hook
-```
-
-### With Other Agents
-
-```
-Other agents can trigger memory operations via:
-- Direct sys-memory-keeper:save/recall commands
-- Delegating to sys-memory-keeper
-```
-
-## Error Handling
-
-```yaml
-save_errors:
-  - Connection failure: Retry 3 times, then log and continue
-  - Invalid format: Validate before save, report issues
-  - Storage full: Archive old memories, then retry
-
-recall_errors:
-  - No results: Suggest alternative queries
-  - Connection failure: Return empty with warning
-  - Invalid query: Help user reformulate
-```
-
-## MemKraft Bridge (Optional)
-
-> External integration: [MemKraft](https://github.com/seojoonkim/memkraft) — zero-dependency compound memory for AI agents.
-> Install: `pipx install memkraft`
-
-### When to Use
-
-| Capability | claude-mem | MemKraft |
-|-----------|-----------|----------|
-| Session persistence | ✅ (Chroma) | ✅ (Markdown) |
-| Entity tracking | ❌ | ✅ (person/org/concept) |
-| Source attribution | ❌ | ✅ (`[Source: who, when, how]`) |
-| Auto-maintenance | ❌ | ✅ (Dream Cycle) |
-| CJK entity extraction | ❌ | ✅ (Korean/Chinese/Japanese) |
-| Offline search | ❌ | ✅ (stdlib difflib) |
-
-Use MemKraft when entity tracking or source attribution is needed. Use claude-mem for simple session persistence.
-
-### Commands
-
-```bash
-# Extract entities from a document
-memkraft extract <file>
-
-# Get a brief on a topic
-memkraft brief <topic>
-
-# Run maintenance cycle (dedup, prune orphans)
-memkraft dream
-```
-
-### Integration with sys-memory-keeper
-
-At session end, sys-memory-keeper can optionally run MemKraft operations:
-
-1. `memkraft extract` on session summary → builds entity graph
-2. `memkraft dream` → prunes stale entries (run weekly, not every session)
-
-### Prerequisites
-
-- Python 3.9+
-- `pipx install memkraft`
-- No API keys required (offline-only)