@crewx/memory 0.1.5 → 0.1.7

package/SKILL.md

@@ -1,37 +1,39 @@
 ---
-name: memory-v2
-description: 마크다운 + 프론트매터 기반 장기 기억 스킬. 드릴다운 구조로 확장성 있는 기억 관리.
-version: 0.10.0
+name: crewx/memory
+description: Markdown + frontmatter-based long-term memory skill. Scalable memory management with drill-down structure.
+metadata:
+  version: 0.10.0
+  built-in: true
 ---
 
 # Memory V2 Skill
 
-마크다운 + 프론트매터 기반의 장기 기억 관리 스킬입니다.
+A long-term memory management skill based on markdown + frontmatter.
 
-## 설치
+## Installation
 
-`packages/built-in/memory`에 포함되어 있으며, `npx memory` 명령으로 사용합니다.
+Included in `packages/built-in/memory`, used via the `npx memory` command.
 
-## 특징
+## Features
 
-- **프론트매터**: 메타데이터 분리 (날짜, 카테고리, 태그, 토픽)
-- **드릴다운**: index.md → entries/ 구조
-- **가독성**: 사람이 직접 읽고 편집 가능
-- **Git 친화적**: 개별 파일로 버전 관리
+- **Frontmatter**: Separated metadata (date, category, tags, topic)
+- **Drill-down**: index.md -> entries/ structure
+- **Readability**: Human-readable and editable
+- **Git-friendly**: Version control with individual files
 
-## 커맨드 Alias
+## Command Aliases
 
-자주 쓰는 커맨드의 단축 별칭입니다. 기존 커맨드와 동일하게 동작합니다.
+Shorthand aliases for frequently used commands. They work identically to the original commands.
 
-| Alias | 실제 커맨드 | 설명 |
-|-------|-----------|------|
-| `read` | `get` | 기억 상세 조회 |
-| `list` | `index` | 전체 인덱스 보기 |
-| `rm` | `delete` | 기억 삭제 |
-| `ls` | `recent` | 최근 기억 보기 |
+| Alias | Actual Command | Description |
+|-------|---------------|-------------|
+| `read` | `get` | View memory details |
+| `list` | `index` | View full index |
+| `rm` | `delete` | Delete memory |
+| `ls` | `recent` | View recent memories |
 
 ```bash
-# 아래 두 명령은 동일
+# The following two commands are identical
 npx memory get agent_id ABC123
 npx memory read agent_id ABC123
 
@@ -39,215 +41,215 @@ npx memory index agent_id
 npx memory list agent_id
 ```
 
-## 디렉토리 구조
+## Directory Structure
 
 ```
 memory/
-└── {agent_id}/
-    ├── summary.md    # 전체 요약 (토픽별 섹션 + entries/ 링크)
-    ├── graph.json    # 그래프 데이터
-    └── entries/      # 개별 기억들
-        └── {id}.md   # 파일명 = nanoid (예: QOSIOs.md)
++-- {agent_id}/
+    +-- summary.md    # Overall summary (topic-based sections + entries/ links)
+    +-- graph.json    # Graph data
+    +-- entries/      # Individual memories
+        +-- {id}.md   # Filename = nanoid (e.g., QOSIOs.md)
 ```
 
-> **파일명 규칙**: `{id}.md` (예: `QOSIOs.md`). 날짜·제목 등 메타데이터는 프론트매터에 있으므로 파일명에 중복하지 않습니다. 토큰 절약 + 파일명 충돌 방지.
+> **Filename rule**: `{id}.md` (e.g., `QOSIOs.md`). Since metadata like date and title is in the frontmatter, it is not duplicated in the filename. This saves tokens and prevents filename collisions.
 
-## 명령어
+## Commands
 
-### 저장
+### Save
 
 ```bash
-npx memory save <agent_id> "<summary>" [category] [--topic=xxx] [--tags=a,b,c] [--body="상세 내용"]
+npx memory save <agent_id> "<summary>" [category] [--topic=xxx] [--tags=a,b,c] [--body="detailed content"]
 ```
 
-**옵션:**
-| 옵션 | 설명 | 예시 |
-|------|------|------|
-| `category` | 기억 분류 | decision, task, project, schedule, context, preference, general |
-| `--topic` | 토픽 그룹 | `--topic=crewx-strategy` |
-| `--tags` | 태그 (쉼표 구분) | `--tags=gemini,pricing` |
-| `--body` | **상세 내용 (권장!)** | `--body="배경, 근거, 결정사항 등"` |
+**Options:**
+| Option | Description | Example |
+|--------|-------------|---------|
+| `category` | Memory classification | decision, task, project, schedule, context, preference, general |
+| `--topic` | Topic group | `--topic=crewx-strategy` |
+| `--tags` | Tags (comma-separated) | `--tags=gemini,pricing` |
+| `--body` | **Detailed content (recommended!)** | `--body="background, rationale, decisions, etc."` |
 
-**⚠️ 중요: `--body` 옵션을 반드시 사용하세요!**
-- `--body` 없으면 플레이스홀더만 저장됨
-- 나중에 맥락 파악이 어려워짐
-- 최소 1-2문장 이상 상세 내용 권장
+**WARNING: Important: Always use the `--body` option!**
+- Without `--body`, only a placeholder is saved
+- Makes it difficult to understand context later
+- At least 1-2 sentences of detailed content is recommended
 
-**예시:**
+**Examples:**
 ```bash
-# ❌ 나쁜 예 - 상세 없음
-npx memory save cto "Gemini 3.0 Flash 모먼트" decision --topic=crewx-strategy
+# [BAD] Bad example - no details
+npx memory save cto "Gemini 3.0 Flash moment" decision --topic=crewx-strategy
 
-# ✅ 좋은 예 - 상세 포함
-npx memory save cto "Gemini 3.0 Flash 모먼트 - 전략적 분기점" decision --topic=crewx-strategy --tags=gemini,pricing --body="SWE-bench 78%로 Claude 3.5 Sonnet(49%) 압도. 가격은 1/6. CrewX 전략 검증됨 - 오케스트레이션이 핵심 해자."
+# [GOOD] Good example - details included
+npx memory save cto "Gemini 3.0 Flash moment - strategic turning point" decision --topic=crewx-strategy --tags=gemini,pricing --body="SWE-bench 78% dominates Claude 3.5 Sonnet (49%). Price is 1/6. CrewX strategy validated -- orchestration is the key moat."
 ```
 
-### 인덱스 조회
+### Index Query
 
 ```bash
-npx memory index <agent_id>              # 중기기억 (토픽 요약만)
-npx memory index <agent_id> --recent      # 최근 엔트리 목록
-npx memory index <agent_id> --full        # 전체 보기
+npx memory index <agent_id>              # Medium-term memory (topic summaries only)
+npx memory index <agent_id> --recent      # Recent entry list
+npx memory index <agent_id> --full        # Full view
 ```
 
-**드릴다운 패턴:** `index` → 필요한 토픽만 `topic` → 필요한 엔트리만 `get`
+**Drill-down pattern:** `index` -> drill into needed topic with `topic` -> drill into needed entry with `get`
 
-### 토픽 드릴다운
+### Topic Drill-down
 
 ```bash
 npx memory topic <agent_id> <topic_name>
 ```
 
-### 최근 기억
+### Recent Memories
 
 ```bash
 npx memory recent <agent_id> [days=30]
 ```
 
-### 키워드 검색 (빠름)
+### Keyword Search (Fast)
 
 ```bash
 npx memory find <agent_id> "<keyword>"
 ```
 
-grep 기반 문자열 매칭. 빠르고 무료.
+Grep-based string matching. Fast and free.
 
-### 시맨틱 검색 (AI)
+### Semantic Search (AI)
 
 ```bash
-npx memory search <agent_id> "<질문>"
+npx memory search <agent_id> "<query>"
 ```
 
-**Gemini 2.0 Flash** 기반 시맨틱 검색. 유사어/맥락 이해.
+Semantic search powered by **Gemini 2.0 Flash**. Understands synonyms and context.
 
-- 스킬 내부 `@memory_searcher` 에이전트 사용 (crewx.yaml)
-- 비용: ~$0.015/1M tokens (거의 무료)
+- Uses internal `@memory_searcher` agent (crewx.yaml)
+- Cost: ~$0.015/1M tokens (virtually free)
 
-**예시:**
+**Examples:**
 ```bash
-# 키워드 검색 (빠름)
-npx memory find crewx_dev_lead "에이전트"
+# Keyword search (fast)
+npx memory find crewx_dev_lead "agent"
 
-# 시맨틱 검색 (AI)
-npx memory search crewx_dev_lead "작업 배정할 때 주의할 점"
+# Semantic search (AI)
+npx memory search crewx_dev_lead "things to watch out for when assigning tasks"
 ```
 
-### 상세 조회 (드릴다운)
+### Detail View (Drill-down)
 
 ```bash
 npx memory get <agent_id> <memory_id>
 ```
 
-### 기억 수정 (update)
+### Update Memory
 
 ```bash
-npx memory update <agent_id> <memory_id> [옵션]
+npx memory update <agent_id> <memory_id> [options]
 ```
 
-**옵션:**
-| 옵션 | 설명 |
-|------|------|
-| `--summary` | 요약 수정 |
-| `--body` | 상세 내용 수정 |
-| `--topic` | 토픽 변경 |
-| `--category` | 카테고리 변경 |
-| `--tags` | 태그 변경 (쉼표 구분) |
+**Options:**
+| Option | Description |
+|--------|-------------|
+| `--summary` | Update summary |
+| `--body` | Update detailed content |
+| `--topic` | Change topic |
+| `--category` | Change category |
+| `--tags` | Change tags (comma-separated) |
 
-**예시:**
+**Examples:**
 ```bash
-# 요약과 상세 내용 수정
-npx memory update cto VkY9X6 --summary="수정된 요약" --body="수정된 상세 내용"
+# Update summary and detailed content
+npx memory update cto VkY9X6 --summary="Updated summary" --body="Updated detailed content"
 
-# 토픽만 변경
+# Change topic only
 npx memory update cto VkY9X6 --topic=new-topic
 ```
 
-### 기억 삭제 (delete)
+### Delete Memory
 
 ```bash
 npx memory delete <agent_id> <memory_id> [--force]
 ```
 
-- `--force` 없으면 확인 메시지만 출력
-- `--force` 있으면 실제 삭제
+- Without `--force`, only a confirmation message is displayed
+- With `--force`, actually deletes the memory
 
-**예시:**
+**Examples:**
 ```bash
-# 삭제 확인
+# Deletion confirmation
 npx memory delete cto VkY9X6
 
-# 실제 삭제
+# Actual deletion
 npx memory delete cto VkY9X6 --force
 ```
 
-### 기억 병합 (merge)
+### Merge Memories
 
 ```bash
-npx memory merge <agent_id> <memory_id1> <memory_id2> [--summary="병합 요약"]
+npx memory merge <agent_id> <memory_id1> <memory_id2> [--summary="merge summary"]
 ```
 
-- 두 기억을 하나로 병합
-- 원본 두 기억은 삭제됨
-- 태그는 합쳐짐 (중복 제거)
-- 병합된 파일에 `merged_from` 메타데이터 추가
+- Merges two memories into one
+- Both original memories are deleted
+- Tags are combined (duplicates removed)
+- `merged_from` metadata is added to the merged file
 
-**예시:**
+**Examples:**
 ```bash
-# 두 기억 병합
+# Merge two memories
 npx memory merge cto abc123 def456
 
-# 커스텀 요약으로 병합
-npx memory merge cto abc123 def456 --summary="VLM 파인튜닝 종합 정리"
+# Merge with custom summary
+npx memory merge cto abc123 def456 --summary="VLM fine-tuning comprehensive summary"
 ```
 
-### 요약 생성 (summarize)
+### Generate Summary (summarize)
 
 ```bash
 npx memory summarize <agent_id> [--force]
 ```
 
-MemGAS 증분 요약 방식을 적용한 기억 요약 기능입니다.
+Memory summarization using the MemGAS incremental summarization approach.
 
-**구조:**
-- `summary.md` 1개에 토픽별 요약 + entries/ 상대경로 링크
-- `save`/`delete` 실행 시 자동으로 summary.md 갱신
-- `summarize`는 수동 트리거용 (자동 갱신 실패 시 또는 `--force`로 전체 재생성)
+**Structure:**
+- A single `summary.md` containing topic-based summaries + relative path links to entries/
+- Automatically updates summary.md on `save`/`delete` execution
+- `summarize` is for manual triggering (when auto-update fails or with `--force` for full regeneration)
 
-**증분 추적:**
-- 프론트매터에 `last_entry_id` 저장
-- 다음 실행 시 해당 ID 이후 엔트리만 추출하여 요약에 반영
-- `@memory_summarizer` (Haiku) 에이전트가 요약 생성
-- AI 호출 실패 시 bullet-point 폴백
+**Incremental tracking:**
+- Stores `last_entry_id` in frontmatter
+- On next run, extracts only entries after that ID and reflects them in the summary
+- `@memory_summarizer` (Haiku) agent generates the summary
+- Falls back to bullet-point format if AI call fails
 
-**옵션:**
-| 옵션 | 설명 |
-|------|------|
-| `--force` | 전체 재생성 (증분 무시) |
+**Options:**
+| Option | Description |
+|--------|-------------|
+| `--force` | Full regeneration (ignore incremental) |
 
-**예시:**
+**Examples:**
 ```bash
-# 증분 요약 (새 엔트리만 반영)
+# Incremental summary (reflects new entries only)
 npx memory summarize ui_devlead
 
-# 강제 전체 재생성
+# Force full regeneration
 npx memory summarize ui_devlead --force
 ```
 
-### 요약 생성 (summarize-dirty)
+### Generate Summary (summarize-dirty)
 
-`save`/`delete`는 동기 summarize 대신 **dirty flag**만 생성하며, cron과 연동해 dirty가 있는 에이전트만 비동기로 summary를 갱신합니다.  
-cron이 매 1분마다 체크하여 실행합니다.
+`save`/`delete` creates only a **dirty flag** instead of synchronous summarize, and works with cron to asynchronously update summaries only for agents with dirty flags.
+Cron checks and executes every 1 minute.
 
 ```bash
 npx memory summarize-dirty
 ```
 
-**cron 등록 예시:**
+**Cron registration example:**
 ```bash
 npx cron add "*/1 * * * *" "npx memory summarize-dirty" --mode command --name "memory-debounce"
 ```
 
-**summary.md 포맷:**
+**summary.md format:**
 ```markdown
 ---
 last_entry_id: QOSIOs
@@ -256,300 +258,362 @@ entry_count: 48
 summarizer: haiku
 ---
 
-## mcp-http (4건)
-MCP HTTP 엔드포인트 구현 완료...
-→ [entries/HYpwPP.md](entries/HYpwPP.md)
-→ [entries/ImH-56.md](entries/ImH-56.md)
+## mcp-http (4 entries)
+MCP HTTP endpoint implementation completed...
+-> [entries/HYpwPP.md](entries/HYpwPP.md)
+-> [entries/ImH-56.md](entries/ImH-56.md)
 
-## cli-service (3건)
-CLI 쉘환경 감지 성능 개선...
-→ [entries/a3cOL8.md](entries/a3cOL8.md)
+## cli-service (3 entries)
+CLI shell environment detection performance improvement...
+-> [entries/a3cOL8.md](entries/a3cOL8.md)
 ```
 
-### 파일명 마이그레이션 (migrate)
+### Filename Migration (migrate)
 
 ```bash
 npx memory migrate <agent_id>
 ```
 
-기존 한글 slug 파일명(`2026-02-16-한글slug.md`)을 ID 기반(`QOSIOs.md`)으로 일괄 변환합니다.
+Batch converts existing slug filenames (`2026-02-16-slug-name.md`) to ID-based filenames (`QOSIOs.md`).
 
-- 각 .md 파일의 프론트매터에서 `id` 읽고 → `{id}.md`로 리네이밍
-- 완료 후 summary.md 자동 재생성 + 그래프 갱신
-- 이미 ID 파일명인 파일은 스킵
+- Reads `id` from each .md file's frontmatter -> renames to `{id}.md`
+- Automatically regenerates summary.md + updates graph after completion
+- Skips files that already have ID-based filenames
 
-**예시:**
+**Example:**
 ```bash
 npx memory migrate ui_devlead
 ```
 
-## 프론트매터 스키마
+## Frontmatter Schema
 
 ```yaml
 ---
-id: yLC8Iv  # nanoid 6자리
+id: yLC8Iv  # 6-character nanoid
 date: 2025-12-23
 category: decision
 tags: ["strategy", "gemini"]
 topic: crewx-strategy
-summary: "한 줄 요약"
+summary: "One-line summary"
 ---
 ```
 
-## 에이전트 프롬프트 가이드
+## Agent Prompt Guide
 
 ```markdown
 <memory-v2-guide agent_id="{{agent_id}}">
-# Memory V2 사용 가이드
+# Memory V2 Usage Guide
 
-## 대화 시작 시 (필수!)
+## At Conversation Start (Required!)
 ```bash
-# 중기기억 로드 (토픽 요약 + 드릴다운 안내)
+# Load medium-term memory (topic summaries + drill-down guide)
 npx memory index {{agent_id}}
 
-# 필요시 드릴다운
-npx memory index {{agent_id}} --recent   # 최근 목록
-npx memory topic {{agent_id}} <topic>    # 토픽 상세
-npx memory get {{agent_id}} <id>         # 개별 기억
+# Drill down as needed
+npx memory index {{agent_id}} --recent   # Recent list
+npx memory topic {{agent_id}} <topic>    # Topic details
+npx memory get {{agent_id}} <id>         # Individual memory
 ```
 
-## 기억 저장 트리거
-- "기억해둬", "저장해", "메모해" 요청 시
-- 중요한 결정사항 발생 시
-- CEO 지침 수령 시
+## Memory Save Triggers
+- When asked to "remember this", "save this", "note this"
+- When important decisions are made
+- When receiving executive directives
 
-## 토픽 선택 가이드 ⭐
+## Topic Selection Guide (Important)
 
-**저장 시 반드시 적절한 토픽을 지정하세요!**
+**Always specify an appropriate topic when saving!**
 
-1. **기존 토픽 확인**: `index` 명령으로 기존 토픽 목록 확인
-2. **기존 토픽 선택**: 관련 토픽이 있으면 그 토픽 사용
-3. **새 토픽 생성**: 없으면 새 토픽명 생성 (kebab-case, 예: `new-feature`)
+1. **Check existing topics**: Use `index` command to see existing topic list
+2. **Select existing topic**: Use that topic if a related one exists
+3. **Create new topic**: Create a new topic name if none exists (kebab-case, e.g., `new-feature`)
 
-**토픽 네이밍 규칙:**
-- kebab-case 사용 (예: `vlm-finetuning`, `crewx-strategy`)
-- 프로젝트/기능/주제 단위로 묶기
-- 너무 세분화하지 말 것 (5개 미만이면 병합 고려)
+**Topic naming rules:**
+- Use kebab-case (e.g., `vlm-finetuning`, `crewx-strategy`)
+- Group by project/feature/subject
+- Don't over-segment (consider merging if fewer than 5 entries)
 
-**예시:**
+**Examples:**
 ```bash
-# 기존 토픽에 추가
-npx memory save {{agent_id}} "VLM 학습률 조정" decision --topic=vlm-finetuning
+# Add to existing topic
+npx memory save {{agent_id}} "VLM learning rate adjustment" decision --topic=vlm-finetuning
 
-# 새 토픽 생성
-npx memory save {{agent_id}} "신규 기능 기획" decision --topic=new-feature-x
+# Create new topic
+npx memory save {{agent_id}} "New feature planning" decision --topic=new-feature-x
 ```
 
-## 저장 명령 (--body 필수!)
+## Save Command (--body required!)
 ```bash
-# ⚠️ 항상 --body 포함해서 저장!
-npx memory save {{agent_id}} "<요약>" <category> --topic=<topic> --body="<상세 내용>"
+# WARNING: Always save with --body included!
+npx memory save {{agent_id}} "<summary>" <category> --topic=<topic> --body="<detailed content>"
 ```
 
-**--body 작성 가이드:**
-- 왜 이 결정을 했는지 (배경/근거)
-- 핵심 수치나 데이터
-- 관련 파일/문서 경로
-- 후속 액션이 있으면 포함
+**--body writing guide:**
+- Why this decision was made (background/rationale)
+- Key metrics or data
+- Related file/document paths
+- Include follow-up actions if any
 
-## 카테고리 선택
-- **decision**: 의사결정, CEO 지침
-- **task**: 할 일, 작업 계획
-- **project**: 프로젝트 정보
-- **schedule**: 일정, 미팅
-- **context**: 배경 정보, 상황
-- **preference**: 선호도, 규칙
-- **general**: 기타
+## Category Selection
+- **decision**: Decisions, executive directives
+- **task**: To-dos, work plans
+- **project**: Project information
+- **schedule**: Schedules, meetings
+- **context**: Background information, context
+- **preference**: Preferences, rules
+- **general**: Other
 
 </memory-v2-guide>
 ```
 
-## 기존 memory 스킬과 차이점
+## Differences from Legacy Memory Skill
 
-| 항목 | memory (v1) | memory-v2 |
+| Item | memory (v1) | memory-v2 |
 |------|-------------|-----------|
-| 저장 형식 | JSON 배열 | 마크다운 파일 |
-| 메타데이터 | content 내 혼합 | 프론트매터 분리 |
-| 조회 | 전체 로드 | 인덱스 → 드릴다운 |
-| 토픽 지원 | 없음 | 있음 |
-| 가독성 | 낮음 | 높음 |
+| Storage format | JSON array | Markdown files |
+| Metadata | Mixed within content | Separated in frontmatter |
+| Query | Full load | Index -> drill-down |
+| Topic support | None | Supported |
+| Readability | Low | High |
 
-## 기억 연결 그래프
+## Memory Connection Graph
 
-기억 간 연관성을 그래프로 관리합니다.
+Manages associations between memories as a graph.
 
-### 그래프 빌드
+### Build Graph
 
 ```bash
 npx memory mindmap build <agent_id>
 ```
 
-규칙 기반으로 연결 생성:
-- **같은 topic**: weight 0.7 (⚠️ `general` 제외)
-- **공통 tags**: weight 0.4~0.8 (1개=0.4, 2개=0.6, 3개+=0.8)
-- **같은 날짜**: weight 0.3 (기본 OFF)
-- **같은 category**: weight 0.2 (⚠️ `general` 제외)
+Rule-based connection generation:
+- **Same topic**: weight 0.7 (WARNING: excludes `general`)
+- **Shared tags**: weight 0.4~0.8 (1 tag=0.4, 2 tags=0.6, 3+ tags=0.8)
+- **Same date**: weight 0.3 (default OFF)
+- **Same category**: weight 0.2 (WARNING: excludes `general`)
 
-> **edgeThreshold = 0.3** → 총 weight가 0.3 이상이어야 연결됨
+> **edgeThreshold = 0.3** -> Total weight must be 0.3 or above to create a connection
 
-### ⭐ 연결성 높이는 저장 팁
+### (Important) Tips for Increasing Connectivity
 
-**핵심: `general`을 피하고 구체적으로!**
+**Key: Avoid `general` and be specific!**
 
-| 방법 | Weight | 효과 |
-|------|--------|------|
-| topic 지정 | +0.7 | 같은 토픽 기억들 자동 연결 |
-| 태그 2개+ | +0.6 | 토픽 달라도 태그로 연결 |
-| 태그 3개+ | +0.8 | 최대 연결 강도 |
-| category | +0.2 | decision/task 등 구체적으로 |
+| Method | Weight | Effect |
+|--------|--------|--------|
+| Specify topic | +0.7 | Memories with same topic auto-connect |
+| 2+ tags | +0.6 | Connect via tags even across different topics |
+| 3+ tags | +0.8 | Maximum connection strength |
+| category | +0.2 | Use specific ones like decision/task |
 
-**❌ 나쁜 예 (연결 안 됨)**
+**[BAD] Bad example (no connections)**
 ```bash
-# topic=general, category=general → 연결 0
-npx memory save agent "Discord 설정 제거" general
+# topic=general, category=general -> 0 connections
+npx memory save agent "Discord settings removal" general
 ```
 
-**✅ 좋은 예 (강한 연결)**
+**[GOOD] Good example (strong connections)**
 ```bash
-# topic + category + tags → 최대 연결
-npx memory save agent "Discord 설정 제거 결정" decision \
+# topic + category + tags -> maximum connections
+npx memory save agent "Discord settings removal decision" decision \
   --topic=discord \
   --tags=settings,cpo-decision,oauth \
-  --body="CPO 회의 결과..."
+  --body="CPO meeting result..."
 ```
 
-**태그 활용 전략:**
-- 관련 기능/모듈명: `discord`, `oauth`, `settings`
-- 회의/결정자: `cpo-decision`, `dev-meeting`
-- 상태: `completed`, `blocked`, `wip`
+**Tag usage strategy:**
+- Related feature/module names: `discord`, `oauth`, `settings`
+- Meeting/decision-maker: `cpo-decision`, `dev-meeting`
+- Status: `completed`, `blocked`, `wip`
 
-### 그래프 요약 보기
+### View Graph Summary
 
 ```bash
 npx memory mindmap show <agent_id>
 ```
 
-토픽별 클러스터, 허브 노드(연결 많은 기억) 등 표시.  
-기본 출력은 **Mermaid 포맷**이며, VS Code 마크다운 프리뷰에서 그래프로 시각화됩니다.  
-`--format=mermaid`가 기본값이고, `--format=text`로 텍스트 출력도 가능합니다.
+Displays topic-based clusters, hub nodes (memories with many connections), etc.
+Default output is in **Mermaid format**, which can be visualized as a graph in VS Code markdown preview.
+`--format=mermaid` is the default, and `--format=text` is also available for text output.
 
-**기간 필터 옵션:**
+**Period filter options:**
 ```bash
 npx memory mindmap show <agent_id> --period=stm  # 24h
 npx memory mindmap show <agent_id> --period=mtm  # 7d
 npx memory mindmap show <agent_id> --period=ltm  # 30d
 ```
 
-### PNG 이미지 내보내기
+### Export as PNG Image
 
-Mermaid 출력을 PNG 이미지로 변환하여 시각적으로 확인할 수 있습니다.
+Convert Mermaid output to PNG images for visual inspection.
 
 ```bash
-# 1. mermaid 코드를 파일로 저장
+# 1. Save mermaid code to file
 npx memory mindmap show <agent_id> | sed 's/^```mermaid$//' | sed 's/^```$//' > /tmp/graph.mmd
 
-# 2. PNG 변환 (npx로 설치 없이 실행)
+# 2. Convert to PNG (runs without installation via npx)
 npx @mermaid-js/mermaid-cli -i /tmp/graph.mmd -o graph.png -w 2400 -H 1600 -b white
 
-# 기간 필터 + PNG (예: 최근 24시간만)
+# Period filter + PNG (e.g., last 24 hours only)
 npx memory mindmap show <agent_id> --period=stm | sed 's/^```mermaid$//' | sed 's/^```$//' | grep -v '^(' > /tmp/graph-stm.mmd
 npx @mermaid-js/mermaid-cli -i /tmp/graph-stm.mmd -o graph-stm.png -w 1600 -H 900 -b white
 ```
 
-> **팁**: 전체 그래프(58+ 노드)는 복잡하므로 `--period=stm`(24h)이나 `--period=mtm`(7d)으로 축소해서 보는 걸 권장합니다.
+> **Tip**: Full graphs (58+ nodes) can be complex, so it's recommended to narrow the view using `--period=stm` (24h) or `--period=mtm` (7d).
 
-### 연결된 기억 조회
+### Query Related Memories
 
 ```bash
 npx memory mindmap related <agent_id> <memory_id>
 ```
 
-특정 기억과 연결된 기억들을 weight 순으로 표시.
+Displays memories connected to a specific memory, sorted by weight.
 
-### 수동 연결 관리
+### Manual Connection Management
 
 ```bash
-# 연결 추가
+# Add connection
 npx memory mindmap add <agent_id> <from_id> <to_id> [type]
 
-# 연결 제거
+# Remove connection
 npx memory mindmap remove <agent_id> <from_id> <to_id>
 ```
 
-### 시각화 (HTML) - 공용 그래프
+### Visualization (HTML) - Shared Graph
 
 ```bash
 npx memory mindmap html
 ```
 
-**모든 에이전트의 연결 그래프를 한 곳에 통합한 공용 시각화**를 생성합니다.
+Generates a **shared visualization combining connection graphs of all agents** in one place.
 
-**특징:**
-- 모든 에이전트의 graph.json 데이터를 하나의 HTML에 임베드
-- 드롭다운으로 에이전트 선택 → 해당 그래프로 실시간 전환
-- D3.js force-directed 그래프
-- 토픽별 색상 구분
-- 줌 & 드래그 지원
-- 호버 시 상세 정보 툴팁
-- 노드 크기 = 연결 수
-- 서버 없이 file:// 프로토콜로 바로 열기 가능
+**Features:**
+- Embeds graph.json data from all agents into a single HTML
+- Dropdown to select agent -> real-time graph switching
+- D3.js force-directed graph
+- Color-coded by topic
+- Zoom & drag support
+- Tooltip with details on hover
+- Node size = number of connections
+- Can be opened directly via file:// protocol without a server
 
-**사용법:**
+**Usage:**
 ```bash
-# 1. 공용 HTML 생성 (agent_id 필요 없음)
+# 1. Generate shared HTML (no agent_id needed)
 npx memory mindmap html
 
-# 2. 브라우저에서 열기
+# 2. Open in browser
 npx memory mindmap open
 ```
 
-**예시:**
+**Example:**
 ```bash
-# 전체 에이전트 그래프 통합 시각화
+# Generate integrated visualization of all agent graphs
 npx memory mindmap html
 ```
 
-### 브라우저에서 열기
+### Open in Browser
 
 ```bash
 npx memory mindmap open [agent_id]
 ```
 
-특정 에이전트의 그래프를 브라우저에서 바로 엽니다.
+Opens a specific agent's graph directly in the browser.
 
-**예시:**
+**Examples:**
 ```bash
-# CTO 그래프 열기
+# Open CTO graph
 npx memory mindmap open cto
 
-# 전체 (기본 에이전트) 열기
+# Open default (all agents)
 npx memory mindmap open
 ```
 
-### 저장 위치
+### Storage Location
 
 ```
-memory/{agent_id}/graph.json         # 그래프 데이터
-memory/mindmap.html                  # 공용 시각화 HTML (npx memory mindmap html로 생성)
+memory/{agent_id}/graph.json         # Graph data
+memory/mindmap.html                  # Shared visualization HTML (generated by npx memory mindmap html)
 ```
 
 ---
 
-## 기억 계층 구조
+## Memory Hierarchy Structure
 
-`index` 명령은 인지심리학(Ebbinghaus, Atkinson-Shiffrin)과 AI 에이전트 메모리 연구(MemoryOS, A-Mem)에 기반한 3계층 출력을 제공합니다.
+The `index` command provides 3-tier output based on cognitive psychology (Ebbinghaus, Atkinson-Shiffrin) and AI agent memory research (MemoryOS, A-Mem).
 
-| 계층 | 시간 | 출력 |
-|------|------|------|
-| 단기 (STM) | 24h | `## 🔥 최근 작업` |
-| 중기 (MTM) | 7일 | 토픽별 요약 (summary.md) |
-| 장기 (LTM) | 30일 | `--recent` 또는 `--full` |
+| Tier | Timeframe | Output |
+|------|-----------|--------|
+| Short-term (STM) | 24h | `## ** Recent Work` |
+| Medium-term (MTM) | 7 days | Topic summaries (summary.md) |
+| Long-term (LTM) | 30 days | `--recent` or `--full` |
 
-상세 설계 근거: [README.md](./README.md#설계-근거-계층적-기억-아키텍처)
+Design rationale details: [README.md](./README.md#design-rationale-hierarchical-memory-architecture)
 
 ---
 
-## v1 → v2 마이그레이션
+## Configuration (crewx.yaml)
+
+Memory engine settings can be customized via the `settings.memory` block in `crewx.yaml`. All fields are optional — defaults are used when not specified.
+
+> **Settings are applied immediately** — no restart required. The config file is read on every command invocation.
+
+### Fields
+
+```yaml
+settings:
+  memory:
+    summarizer_agent: "@memory_summarizer"   # crewx.yaml에 정의된 에이전트 ID. summary.md 생성에 사용
+    searcher_agent: "@memory_searcher"       # crewx.yaml에 정의된 에이전트 ID. semantic search에 사용
+    summarizer_timeout: 60000                # summarizer 에이전트 호출 타임아웃 (ms). 초과 시 bullet-point fallback
+    searcher_timeout: 300000                 # searcher 에이전트 호출 타임아웃 (ms). 초과 시 에러 반환
+    summary_days: 7                          # index 명령의 중기기억(MTM) 요약 범위 (일 단위)
+    recent_days: 30                          # index --recent / recent 명령의 조회 범위 (일 단위)
+    short_term_hours: 24                     # index 명령의 단기기억(STM, "🔥 Recent Work") 범위 (시간 단위)
+```
+
+### Resolve priority
+
+| Field | Priority |
+|-------|----------|
+| `summary_days`, `recent_days` | `config parameter` > `crewx.yaml` > `environment variable` (`MEMORY_SUMMARY_DAYS`, `MEMORY_RECENT_DAYS`) > `built-in default` |
+| `summarizer_agent`, `searcher_agent`, `summarizer_timeout`, `searcher_timeout`, `short_term_hours` | `config parameter` > `crewx.yaml` > `built-in default` |
+
+> **Note:** Environment variables are only supported for `summary_days` (`MEMORY_SUMMARY_DAYS`) and `recent_days` (`MEMORY_RECENT_DAYS`). Other fields do not have corresponding env vars.
+
+### Config file location
+
+By default, `crewx.yaml` is read from the project root. To use a different path, set the `CREWX_CONFIG` environment variable:
+
+```bash
+CREWX_CONFIG=/path/to/custom-crewx.yaml npx memory index my_agent
+```
+
+### Error handling
+
+- **YAML parse failure** (file missing, syntax error): All fields silently fall back to built-in defaults. No error is raised — check your YAML syntax if settings seem ignored.
+- **Invalid numeric value** (e.g., `summary_days: "abc"`): 잘못된 숫자 값(예: "abc")은 NaN으로 설정되어 예기치 않은 동작을 유발할 수 있습니다. 숫자 필드에는 반드시 유효한 정수만 입력하세요.
+
+### Customization example
+
+Expand the summary window to 2 weeks and use a custom summarizer agent:
+
+```yaml
+settings:
+  memory:
+    summary_days: 14                         # 기본 7일 → 2주로 확장
+    summarizer_agent: "@my_custom_summarizer" # 커스텀 요약 에이전트 (crewx.yaml agents 섹션에 정의 필요)
+    summarizer_timeout: 120000               # 커스텀 에이전트에 맞춰 타임아웃 2분으로 증가
+```
+
+Or override via environment variable (e.g., in CI/CD):
+
+```bash
+MEMORY_SUMMARY_DAYS=14 npx memory summarize my_agent
+```
+
+---
+
+## v1 -> v2 Migration
 
 ```bash
 npx memory migrate <agent_id>