oh-my-customcode 0.156.3 → 0.157.1

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

@@ -1,172 +0,0 @@
----
-name: memory-recall
-description: Search and recall memories from claude-mem
-scope: core
-argument-hint: "<query> [--recent] [--limit <n>]"
-user-invocable: true
----
-
-# Memory Recall Skill
-
-Search and recall relevant memories from claude-mem using semantic search.
-
-## Parameters
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| query | string | yes* | Search query (*not required with --recent) |
-
-## Options
-
-```
---recent, -r     Recall most recent memories
---limit, -l      Maximum results to return (default: 5)
---verbose, -v    Show full memory content
---date, -d       Filter by date (YYYY-MM-DD)
-```
-
-## Workflow
-
-```
-1. Build semantic query
-   ├── Prefix with "my-project"
-   ├── Add user query terms
-   └── Include date if specified
-
-2. Search claude-mem
-   └── chroma_query_documents
-
-3. Format results
-   ├── Sort by relevance score
-   ├── Show summary for each
-   └── Provide memory IDs for detailed access
-
-4. Present to user
-```
-
-## Query Tips
-
-```yaml
-effective_queries:
-  - "authentication flow" (topic-based)
-  - "2025-01-20 oauth" (temporal + topic)
-  - "decision jwt" (type + topic)
-  - "agent creation workflow" (semantic intent)
-
-avoid:
-  - Single generic words like "code" or "task"
-  - Very long queries (keep it focused)
-  - Special characters or complex syntax
-```
-
-## Retrieval Strategy
-
-### Recall-Precision Tradeoff
-
-Default bias: **recall > precision** — it is easier to filter out irrelevant results (false positives) than to recover missed information (false negatives).
-
-| Task Type | Bias | Recommended --limit | Rationale |
-|-----------|------|--------------------:|-----------|
-| Debugging / Investigation | High recall (16:1) | 10-15 | Cast wide net, prune later |
-| Decision reference | Balanced | 5 (default) | Moderate breadth with manageable noise |
-| Specific fact lookup | High precision | 3 | Narrow, targeted retrieval |
-
-### Guidelines
-
-- **Over-retrieve, then filter**: When uncertain, request more results and discard irrelevant ones in post-processing
-- **Narrow progressively**: Start broad, refine query only if results are noisy — avoid starting too narrow
-- **Combine temporal + semantic**: Add date filters (`--date`) to semantic queries for better precision without sacrificing recall
-
-## Output Format
-
-### Basic Search
-```
-[sys-memory-keeper:recall authentication]
-
-Searching memories for: "my-project authentication"
-
-Found 3 relevant memories:
-
-[1] mem_abc123 (Score: 0.95)
-    Date: 2025-01-20
-    Summary: Implemented OAuth flow with Google provider
-    Tags: [authentication, oauth, google]
-
-[2] mem_def456 (Score: 0.87)
-    Date: 2025-01-18
-    Summary: JWT token decision - RS256 algorithm
-    Tags: [authentication, decision, jwt]
-
-[3] mem_ghi789 (Score: 0.82)
-    Date: 2025-01-15
-    Summary: Authentication architecture discussion
-    Tags: [authentication, architecture, planning]
-
-Use "sys-memory-keeper:recall --verbose" for full content.
-```
-
-### Verbose Output
-```
-[sys-memory-keeper:recall authentication --verbose]
-
-Searching memories for: "my-project authentication"
-
-[1] mem_abc123 (Score: 0.95)
-    Date: 2025-01-20
-    Tags: [authentication, oauth, google]
-
-    Content:
-    ## Session Summary
-    Date: 2025-01-20
-
-    ### Tasks Completed
-    - Implemented OAuth flow with Google provider
-    - Added callback handler for OAuth response
-    - Created user session management
-
-    ### Decisions Made
-    - Use passport.js for OAuth handling
-      Rationale: Well-maintained, good documentation
-
-    ---
-
-[2] mem_def456 (Score: 0.87)
-    ...
-```
-
-### Recent Memories
-```
-[sys-memory-keeper:recall --recent]
-
-Fetching recent memories for: my-project
-
-[1] mem_xyz999 (Score: 1.00)
-    Date: 2025-01-24
-    Summary: Memory system Phase 1 implementation
-    Tags: [session, memory, phase1]
-
-[2] mem_xyz888 (Score: 0.98)
-    Date: 2025-01-23
-    Summary: Agent identification rules update
-    Tags: [session, rules, enforcement]
-
-...
-```
-
-### No Results
-```
-[sys-memory-keeper:recall "nonexistent topic"]
-
-Searching memories for: "my-project nonexistent topic"
-
-No memories found matching your query.
-
-Suggestions:
-- Try different keywords
-- Use broader search terms
-- Check available memories with "sys-memory-keeper:recall --recent"
-```
-
-## Related
-
-- memory-save - Save current context

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

@@ -1,128 +0,0 @@
----
-name: memory-save
-description: Save current session context to claude-mem
-scope: core
-argument-hint: "[--tags <tags>] [--include-code]"
-disable-model-invocation: true
-user-invocable: true
----
-
-# Memory Save Skill
-
-Save current session context to claude-mem for persistence across context compaction.
-
-## Options
-
-```
---tags, -t       Additional tags for the memory
---include-code   Include code changes in the save
---summary, -s    Custom summary (otherwise auto-generated)
---verbose, -v    Show detailed save information
-```
-
-## Workflow
-
-```
-1. Collect session context
-   ├── Tasks completed
-   ├── Decisions made
-   ├── Open items
-   └── Code changes (if --include-code)
-
-2. Format with metadata
-   ├── project: my-project
-   ├── session: {date}-{uuid}
-   ├── tags: [session, ...user_tags]
-   └── created_at: {timestamp}
-
-3. Store in claude-mem
-   └── chroma_add_documents
-
-4. Report result
-```
-
-## Storage Format
-
-```yaml
-project: my-project
-session: {date}-{uuid}
-tags: [session, task, decision]
-content:
-  summary: Brief description of session context
-  tasks_completed: List of completed tasks
-  decisions: Key decisions made
-  open_items: Unfinished work
-```
-
-## Output Format
-
-### Success
-```
-[sys-memory-keeper:save]
-
-Saving session context...
-
-Context collected:
-  Tasks: 3 completed
-  Decisions: 2 recorded
-  Open items: 1 pending
-
-Metadata:
-  Project: my-project
-  Session: 2025-01-24-a1b2c3d4
-  Tags: [session, task, decision]
-
-[Done] Session context saved successfully.
-Memory ID: mem_abc123
-```
-
-### With Tags
-```
-[sys-memory-keeper:save --tags "authentication,oauth"]
-
-Saving session context...
-
-Metadata:
-  Project: my-project
-  Session: 2025-01-24-a1b2c3d4
-  Tags: [session, task, decision, authentication, oauth]
-
-[Done] Session context saved successfully.
-Memory ID: mem_abc123
-```
-
-### Verbose
-```
-[sys-memory-keeper:save --verbose]
-
-Collecting session context...
-
-Tasks Completed:
-  1. Implemented OAuth flow
-  2. Added JWT token validation
-  3. Created authentication middleware
-
-Decisions Made:
-  1. Use RS256 for JWT signing
-     Rationale: Better security for distributed systems
-  2. Token expiry: 1 hour
-     Rationale: Balance security and user experience
-
-Open Items:
-  1. Refresh token implementation
-     Status: In progress
-
-Saving to claude-mem...
-
-Document content:
-  ## Session Summary
-  Date: 2025-01-24
-  ...
-
-[Done] Session context saved.
-Memory ID: mem_abc123
-```
-
-## Related
-
-- memory-recall - Search and recall memories

package/templates/guides/agentmemory-migration/measure-step-zero.md

@@ -1,120 +0,0 @@
-# AgentMemory 마이그레이션 — 단계 0: MEASURE (사용 빈도 측정)
-
-> **목적**: Phase 1 (COEXIST) 진입 전, claude-mem skill 실제 호출 빈도 데이터를 수집하여 가설 기반 자산 처리표를 검증한다.
-> **관련 이슈**: #1169 본문 조치 5
-> **참고 메모리**: `feedback_claude_mem_maintenance`, `project_sequencing_alpha_beta_gamma`
-
----
-
-## 1. 목적
-
-AgentMemory 마이그레이션 계획(`feedback_claude_mem_maintenance.md`)에는 12개 claude-mem skill의 처리 방향이 가설로 기재되어 있다. 특히 폐기 후보 5종(`make-plan`, `do`, `babysit`, `wowerpoint`, `knowledge-agent`, `pathfinder`)은 "미사용 또는 저빈도"라는 가정 위에 놓여 있다.
-
-이 단계에서는 실측 데이터로 가설을 검증한다. 데이터 없이 Phase 1에 진입하면:
-- 실제로 자주 쓰이던 skill을 폐기하여 사용자 워크플로우가 깨질 수 있다.
-- 자산 처리표 재설계 비용이 Phase 2~3로 이월된다.
-
----
-
-## 2. 실행 방법
-
-```bash
-# 기본 실행 (최근 7일, 리포트를 ~/.claude/measure-claude-mem-usage-YYYY-MM-DD.md 에 저장)
-bash scripts/measure-claude-mem-usage.sh
-
-# 최근 14일 스캔
-bash scripts/measure-claude-mem-usage.sh --days 14
-
-# 출력 경로 지정
-bash scripts/measure-claude-mem-usage.sh --output ~/Documents/claude-mem-usage.md
-
-# 헤더 없이 실행 (CI/파이프라인 삽입용)
-bash scripts/measure-claude-mem-usage.sh --quiet
-```
-
-### 스캔 대상 경로
-
-| 경로 | 설명 |
-|------|------|
-| `~/.claude-mem/archives/` | claude-mem MCP 아카이브 (`.jsonl`, `.json`) |
-| `~/.claude/projects/*/session-*.jsonl` | Claude Code 세션 로그 |
-
-둘 중 하나가 없어도 스크립트는 조용히 skip하고 나머지를 스캔한다.
-
----
-
-## 3. 1주 수집 계획
-
-| 시점 | 작업 |
-|------|------|
-| **Day 1** | 첫 측정 — 베이스라인 (`--days 7` 기준 기존 archives 기반) |
-| **Day 4** | 중간 측정 — 추이 확인 (`--days 4`) |
-| **Day 7** | 최종 측정 — 자산 처리표 재검토 및 Phase 1 GO/NO-GO 결정 |
-
-세 시점 모두 `--output` 경로를 달리 지정하여 비교 가능한 파일로 보관한다:
-
-```bash
-bash scripts/measure-claude-mem-usage.sh --output ~/.claude/claude-mem-day1.md
-bash scripts/measure-claude-mem-usage.sh --days 4 --output ~/.claude/claude-mem-day4.md
-bash scripts/measure-claude-mem-usage.sh --days 7 --output ~/.claude/claude-mem-day7.md
-```
-
----
-
-## 4. 해석 기준
-
-| 호출 수 | 신호 | 권장 조치 |
-|---------|------|----------|
-| **0** | 미사용 | 폐기 안전 — 1주 후 처리 결정 |
-| **1-3** | 가끔 사용 | wrapper 또는 대체 도구 매핑 필요 |
-| **4+** | 정기 사용 | 폐기 시 대체 도구 명확화 필수 |
-
-폐기 후보 5종 기준 예상:
-- `make-plan`, `do`, `babysit` → 0 예상 (native AgentMemory로 대체 완료)
-- `wowerpoint`, `knowledge-agent`, `pathfinder` → 0~1 예상 (특수 목적 skill)
-
-실측값이 예상과 다를 경우 자산 처리표를 수정한 후 Phase 1에 진입한다.
-
----
-
-## 5. 결과 활용
-
-### 5-1. #1169에 리포트 첨부
-
-```bash
-gh issue comment 1169 --body-file ~/.claude/claude-mem-day7.md
-```
-
-### 5-2. 자산 처리표 갱신
-
-`.claude/agent-memory/sys-memory-keeper/feedback_claude_mem_maintenance.md` 내 "처리 방향" 열을 실측값 기반으로 업데이트한다.
-
-### 5-3. Phase 1 GO/NO-GO 결정
-
-| 조건 | 결정 |
-|------|------|
-| 폐기 후보 모두 호출 수 0 | GO — Phase 1 진입 |
-| 폐기 후보 중 1개 이상 호출 수 1-3 | CONDITIONAL GO — 대체 도구 매핑 완료 후 진입 |
-| 폐기 후보 중 1개 이상 호출 수 4+ | NO-GO — 처리표 재설계 후 재측정 |
-
----
-
-## 6. 한계 및 주의사항
-
-| 항목 | 설명 |
-|------|------|
-| archives 미존재 | `~/.claude-mem/archives/` 없으면 카운트 0 (정상 — silent skip) |
-| 세션 로그 형식 변경 | Claude Code 업데이트로 `session-*.jsonl` 구조가 변경되면 grep 패턴 수정 필요 |
-| claude-mem MCP telemetry 미사용 | 외부 도구 의존 최소화 원칙에 따라 MCP 자체 지표는 사용하지 않음 |
-| grep 기반 측정 | 같은 파일에 skill 이름이 여러 줄 등장하면 복수 카운트됨 (과대 계산 가능성) |
-| macOS/Linux 호환 | `stat` 옵션 차이를 스크립트 내에서 자동 처리 (`-f %m` vs `-c %Y`) |
-
----
-
-## 7. 참고
-
-- **이슈**: [#1169](../../.github/ — `gh issue view 1169`)
-- **자산 처리표**: `.claude/agent-memory/sys-memory-keeper/feedback_claude_mem_maintenance.md`
-- **시퀀싱 메모리**: `.claude/agent-memory/mgr-creator/project_sequencing_alpha_beta_gamma.md` (또는 해당 메모리 파일)
-- **스크립트**: `scripts/measure-claude-mem-usage.sh`
-- **Phase 1 가이드**: `guides/agentmemory-migration/` (이 디렉토리에 추가 예정)

package/templates/guides/agentmemory-migration/phase-1-coexist.md

@@ -1,261 +0,0 @@
-# AgentMemory Migration — Phase 1: COEXIST (Week 1-2)
-
-> **상태**: 활성 — 2026-05-18 시작 (#1169)
-> **다음 단계**: Phase 2 SWITCH (measure 결과 후 GO/NO-GO 결정)
-> **이전 단계**: [measure-step-zero.md](./measure-step-zero.md)
-
----
-
-## 1. 개요
-
-Phase 1 (COEXIST)는 claude-mem과 AgentMemory를 **동시에 운영**하는 단계입니다.
-이 단계에서는 어떤 destructive 변경도 발생하지 않습니다:
-
-- claude-mem 기존 Chroma 데이터 유지
-- 12 plugin skill 폐기 없음
-- 어댑터 코드 활성화 없음 (STUB 상태 유지)
-- 자산 처리표 적용 없음
-
-목표는 1주간 실제 사용 데이터를 수집하고, AgentMemory 설치와 공존 운영에 익숙해지는 것입니다.
-
-| 항목 | Phase 1 (COEXIST) | Phase 2 (SWITCH) |
-|------|-------------------|------------------|
-| claude-mem | 활성 (기존 운영) | 비활성화 예정 |
-| AgentMemory | 설치 후 병렬 활성 | 단독 운영 |
-| 데이터 마이그레이션 | 없음 | 선택적 (측정 후 결정) |
-| 어댑터 코드 | STUB 유지 | 활성화 |
-| 자산 처리표 | 적용 보류 | 사용자 검토 후 적용 |
-
----
-
-## 2. AgentMemory 설치
-
-> **R001 주의**: auto-install 금지. 아래 명령어를 사용자 로컬에서 수동으로 실행합니다.
-
-### 2-1. 패키지 설치
-
-```bash
-# 옵션 A: pip
-pip install agentmemory
-
-# 옵션 B: pipx (격리 환경 권장)
-pipx install agentmemory
-
-# 옵션 C: uvx (uv 사용 시)
-uvx agentmemory
-```
-
-### 2-2. MCP 서버 등록
-
-```bash
-# Claude Code CLI로 등록
-claude mcp add agentmemory -- agentmemory mcp
-
-# 또는 .mcp.json 수동 편집 (R001 auto-install 금지)
-# {
-#   "mcpServers": {
-#     "agentmemory": {
-#       "command": "agentmemory",
-#       "args": ["mcp"]
-#     }
-#   }
-# }
-```
-
-### 2-3. 등록 확인
-
-```bash
-claude mcp list
-# 출력에 agentmemory 서버가 표시되어야 합니다
-```
-
----
-
-## 3. COEXIST 정책
-
-Phase 1 기간 동안 두 backend는 다음 정책에 따라 공존합니다.
-
-### 3-1. 기본 운영 방식
-
-| 작업 | 우선 backend | 비고 |
-|------|-------------|------|
-| 기존 메모리 조회 | claude-mem | 기존 Chroma 데이터 유지 |
-| 신규 메모리 저장 | 둘 다 | COEXIST 기간 중 병렬 저장 권장 |
-| 세션 종료 시 저장 | 둘 다 | R011 Session-End Self-Check 참조 |
-
-### 3-2. 쿼리 병합 (memory-aggregator)
-
-두 backend에서 결과가 반환될 경우 `memory-aggregator` 스킬이 결과를 병합합니다:
-
-```
-claude-mem.search(query)    →  결과 A
-AgentMemory.search(query)   →  결과 B
-memory-aggregator           →  A + B 중복 제거 후 반환
-```
-
-`memory-aggregator` 스킬이 없는 경우, 두 결과를 순서대로 제시하고 사용자가 선택합니다.
-
-### 3-3. 충돌 방지 원칙
-
-- claude-mem 기존 데이터를 AgentMemory로 자동 복사하지 않음
-- 두 backend에 동일 키로 저장 시 별개 항목으로 취급
-- 강제 동기화 없음 — Phase 2에서 마이그레이션 여부 결정
-
----
-
-## 4. Dual-Backend 충돌 Advisory
-
-`.mcp.json`에 두 서버가 동시 등록된 상태를 감지하면 다음 advisory를 출력합니다.
-
-### 4-1. 감지 조건
-
-```
-.mcp.json 내 서버 목록:
-  - "claude-mem" (또는 관련 tool prefix)
-  - "agentmemory"
-  → 두 개 동시 존재 시 Phase 1 COEXIST 상태로 간주
-```
-
-### 4-2. Advisory 메시지
-
-```
-[Advisory] Dual memory backend detected (Phase 1 COEXIST)
-  - claude-mem: active (Chroma)
-  - agentmemory: active (SQLite)
-  현재 Phase 1 COEXIST 정책 적용 중 — 두 backend 병렬 운영
-  Phase 2 SWITCH 진입 전까지 두 backend 유지
-  가이드: guides/agentmemory-migration/phase-1-coexist.md
-```
-
-이 advisory는 경고가 아닙니다. Phase 1에서는 정상 상태입니다.
-
-### 4-3. 강제 선택 (사용자 명시 시)
-
-사용자가 명시적으로 "agentmemory만 사용" 또는 "claude-mem만 사용"을 요청하는 경우,
-해당 요청을 따르되 자산 처리표 적용 및 어댑터 활성화는 Phase 2 GO 결정 후 진행합니다.
-
----
-
-## 5. 사용자 행동 계획
-
-### 5-1. 1주 measure 루틴 (자동 트리거: 2026-05-25)
-
-`scripts/measure-claude-mem-usage.sh` 스크립트를 1주간 실행합니다:
-
-```bash
-# 수동 실행 (필요 시)
-bash scripts/measure-claude-mem-usage.sh
-
-# 결과는 .claude/outputs/sessions/ 에 저장됩니다
-```
-
-측정 항목:
-- 일별 호출 횟수 (claude-mem vs AgentMemory)
-- 응답 지연 (p50, p95)
-- 저장 성공/실패율
-- 메모리 용량 (Chroma vs SQLite)
-
-### 5-2. GO/NO-GO 결정 기준 (2026-05-25 예정)
-
-| 지표 | GO 조건 | NO-GO 조건 |
-|------|---------|------------|
-| 응답 지연 | AgentMemory ≤ claude-mem × 1.2 | AgentMemory > claude-mem × 2.0 |
-| 저장 성공률 | ≥ 99% | < 95% |
-| 운영 안정성 | 1주 무장애 | 크래시 또는 데이터 손실 |
-| 호환성 | 기존 메모리 포맷 읽기 가능 | 포맷 비호환으로 검색 실패 |
-
-### 5-3. 지금 할 수 있는 것
-
-- AgentMemory 설치 및 MCP 등록 (위 섹션 2 참조)
-- 신규 세션에서 AgentMemory로도 저장해보기 (실험적)
-- measure 스크립트 결과 관찰
-- 자산 처리표 (`guides/agentmemory-migration/asset-disposition.md`) 검토 준비
-
----
-
-## 6. Phase 2 진입 조건
-
-다음 조건이 모두 충족된 경우에만 Phase 2 (SWITCH)로 진행합니다.
-
-### 필수 조건
-
-- [ ] 1주 measure 결과 GO 판정 (5-2 기준 충족)
-- [ ] 자산 처리표 사용자 검토 완료 (12 plugin skill 처리 방향 결정)
-- [ ] 30분 롤백 절차 검증 완료
-
-### 롤백 절차 검증 (Phase 2 진입 전 필수)
-
-```bash
-# 1. Chroma 백업 생성
-cp -r ~/.local/share/claude-mem/chroma ~/.local/share/claude-mem/chroma.bak.$(date +%Y%m%d)
-
-# 2. 백업에서 복원 가능 여부 확인
-# (실제 복원 수행하지 않고 절차만 검증)
-ls -la ~/.local/share/claude-mem/chroma.bak.*
-
-# 3. AgentMemory SQLite 백업
-cp ~/.local/share/agentmemory/memories.db ~/.local/share/agentmemory/memories.db.bak.$(date +%Y%m%d)
-```
-
-롤백 소요 시간이 30분 이내임을 확인한 후 Phase 2 진행.
-
----
-
-## 7. 현 단계 한계 및 금지 사항
-
-### 7-1. STUB 상태 유지 (변경 금지)
-
-```
-packages/eval-core/src/adapters/agentmemory.ts  ← STUB, 활성화 금지
-packages/eval-core/src/db/schema.ts              ← 변경 금지
-```
-
-이 파일들은 Phase 2 GO 결정 후 별도 사이클에서 수정합니다.
-
-### 7-2. 자산 처리표 적용 보류
-
-12 plugin skill의 폐기/유지 결정은 measure 결과를 확인한 후 진행합니다:
-
-```
-.claude/skills/memory-*/  ← 폐기 여부 보류
-.claude/skills/claude-mem-*/  ← 폐기 여부 보류
-```
-
-### 7-3. 데이터 마이그레이션 금지
-
-Phase 1에서는 claude-mem Chroma 데이터를 AgentMemory SQLite로 이전하지 않습니다.
-이전은 Phase 2에서 사용자가 명시적으로 승인한 경우에만 진행합니다.
-
----
-
-## 8. R011과의 관계
-
-Phase 1 COEXIST 기간 중 R011 (SHOULD-memory-integration) 적용:
-
-| R011 항목 | COEXIST 수정 사항 |
-|-----------|-----------------|
-| Primary: Native auto memory | 변경 없음 |
-| Supplementary: claude-mem | 변경 없음 (계속 사용) |
-| Session-End Self-Check | claude-mem + AgentMemory 둘 다 저장 시도 |
-| Failure Policy | 둘 중 하나 실패해도 비차단 |
-
-세션 종료 시 자가 점검 (COEXIST 확장):
-
-```
-1. sys-memory-keeper가 MEMORY.md 갱신? → YES
-2. claude-mem 저장 시도? → YES (기존)
-3. AgentMemory 저장 시도? → YES (COEXIST 추가)
-모두 완료 후 사용자에게 확인
-```
-
----
-
-## 9. 참고
-
-- **이슈**: #1169 (AgentMemory 마이그레이션 계획)
-- **이전 단계**: [measure-step-zero.md](./measure-step-zero.md)
-- **R011**: `.claude/rules/SHOULD-memory-integration.md` (Dual-Backend Advisory 섹션)
-- **관련 기억**: [[project-sequencing-alpha-beta-gamma]]
-- **자산 처리표**: `guides/agentmemory-migration/asset-disposition.md` (Phase 2 전 검토 필요)
-- **measure 스크립트**: `scripts/measure-claude-mem-usage.sh`
-- **롤백 가이드**: #1169 본문 조치 4 (30분 롤백 절차)