Session 1                    Session 2
┌─────────────────┐          ┌─────────────────┐
│ 學到了解法 A     │   /clear  │ 這問題怎麼解？   │ ← 學習消失
│ 決定用架構 B     │  ───────>  │ 要用什麼架構？   │ ← 決策遺失
│ 專案進度 70%    │          │ 做到哪了？       │ ← 進度歸零
└─────────────────┘          └─────────────────┘

┌─────────────────────────────────────────────────────────────────┐
│                       Core Memory                                │
│                  (小而重要，~2000 tokens)                         │
│  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐                │
│  │   project   │ │  learnings  │ │  decisions  │                │
│  │  專案概述    │ │  學習紀錄    │ │  架構決策    │                │
│  └─────────────┘ └─────────────┘ └─────────────┘                │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                     Archival Memory                              │
│                  (大而完整，無限制)                               │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐               │
│  │  specs  │ │ commits │ │learnings│ │decisions│               │
│  │完整規格  │ │提交記錄  │ │詳細筆記  │ │完整文檔  │               │
│  └─────────┘ └─────────┘ └─────────┘ └─────────┘               │
└─────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────┐
│  claude-memory-hook                                              │
│  → Session 開始時自動執行                                        │
│  → 顯示 Git、規格進度、Letta 記憶摘要、提醒                       │
├─────────────────────────────────────────────────────────────────┤
│  claude-dev-memory（本專案）                                     │
│  → 提供 MCP 工具讓 Claude 主動讀寫記憶                           │
│  → memory_recall / memory_update / memory_archive / memory_search│
└─────────────────────────────────────────────────────────────────┘

npm install -g claude-dev-memory

npx claude-dev-memory

claude mcp add claude-dev-memory -s user -- npx claude-dev-memory

# 在 shell profile 或專案 .env 中
export LETTA_API_KEY=sk-let-xxxxx
export LETTA_AGENT_ID=agent-xxxxx

{
  "mcpServers": {
    "claude-dev-memory": {
      "command": "npx",
      "args": ["claude-dev-memory"],
      "env": {
        "LETTA_API_KEY": "your-api-key",
        "LETTA_AGENT_ID": "agent-xxxxx"
      }
    }
  }
}

回傳：連線狀態、Core Memory 使用量、Archival 記錄數

Claude 使用 memory_recall 讀取 project 區塊
→ 立即了解專案背景，無需重新解釋

Claude 使用 memory_update 更新 decisions 區塊
→ 下次 session 仍記得這個決策

Claude 使用 memory_archive，type 設為 spec
→ 完整內容存入 Archival，可語意搜尋

Claude 使用 memory_search 搜尋相關記錄
→ 找出過去的解法，避免重複踩坑

{
  "agent_id": "agent-xxx"
}

git clone https://github.com/miles990/claude-dev-memory.git
cd claude-dev-memory

npm install     # 安裝依賴
npm run build   # 編譯
npm test        # 測試
npm run dev     # 開發模式