@hir4ta/memoria 0.12.11 → 0.12.13

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "memoria",
   "description": "A plugin that provides long-term memory for Claude Code. It automatically saves context lost during auto-compact, offering features for session restoration, recording technical decisions, and learning developer patterns.",
-  "version": "0.12.11",
+  "version": "0.12.13",
   "author": {
     "name": "hir4ta"
   },

package/README.ja.md

@@ -2,27 +2,21 @@
 
 Claude Codeの長期記憶を実現するプラグイン
 
-セッションの自動保存、技術的な判断の記録、Webダッシュボードでの管理を提供します。
+セッションの自動保存、インテリジェントな記憶検索、Webダッシュボードでの管理を提供します。
 
 ## 機能
 
 ### コア機能
 - **会話の自動保存**: セッション終了時にjqで自動保存（確実・高速）
+- **自動記憶検索**: プロンプトごとに関連する過去のセッション・判断を自動で注入
 - **PreCompactバックアップ**: Auto-Compact前にinteractionsをバックアップ（コンテキスト95%で発動）
-- **手動保存**: `/memoria:save` で要約作成 + 構造化データ保存
+- **フルデータ抽出**: `/memoria:save` で要約・判断・パターン・ルールを一括保存
+- **記憶参照プランニング**: `/memoria:plan` で過去の知見を活用した設計・計画
 - **セッション再開**: `/memoria:resume` で過去のセッションを再開（チェーン追跡付き）
 - **セッション提案**: セッション開始時に最新3件を提案
-- **技術的な判断の記録**: `/memoria:decision` で判断を記録
 - **ルールベースレビュー**: `dev-rules.json` / `review-guidelines.json` に基づくレビュー
 - **週次レポート**: レビュー結果を集計したMarkdownレポートを自動生成
-- **Webダッシュボード**: セッション・判断記録の閲覧・編集
-
-### 開発ワークフロー
-- **ブレインストーミング**: ソクラティック質問 + 記憶参照で設計 (`/memoria:brainstorm`)
-- **計画作成**: 2-5分単位のTDDタスク分割 (`/memoria:plan`)
-- **TDD**: RED-GREEN-REFACTORサイクルの厳格強制 (`/memoria:tdd`)
-- **デバッグ**: 根本原因分析 + エラーパターン参照 (`/memoria:debug`)
-- **二段階レビュー**: 仕様準拠 + コード品質 (`/memoria:review --full`)
+- **Webダッシュボード**: セッション・判断・パターン・ルールの閲覧
 
 ## 課題と解決（導入メリット）
 
@@ -30,15 +24,16 @@ Claude Codeの長期記憶を実現するプラグイン
 
 - **コンテキストの消失**: セッション終了やAuto-Compactで会話の文脈が失われる
 - **判断の不透明化**: 「なぜこの設計にしたのか」が後から追えない
+- **同じミスの繰り返し**: 同じエラーを何度も解決（学習されない）
 - **知見の再利用が難しい**: 過去のやり取りや決定を検索・参照しづらい
 
-### memoria でできること／解消できること
+### memoria でできること
 
 - **自動保存 + 再開**で、セッションを跨いだ文脈の継続が可能
-- **判断記録**で、理由・代替案を後から追跡
+- **自動記憶検索**で、関連する過去の知見が常に会話に反映される
+- **判断・パターン記録**で、理由やエラー解決策を後から追跡
 - **検索とダッシュボード**で、過去の記録を素早く参照
 - **レビュー機能**で、リポジトリ固有の観点に基づいて指摘
-- **週次レポート**で、レビュー観点の改善と共有が容易
 
 ### チーム利用のメリット
 
@@ -106,8 +101,14 @@ Claude Codeを再起動
 
 **PreCompact**ではinteractionsを`preCompactBackups`にバックアップします（コンテキスト95%で発動）。要約は自動作成されません。
 
-**要約と構造化データ**は `/memoria:save` で手動作成：
-- JSON: `title`, `tags`, `summary`, `plan`, `discussions`, `errors`, `handoff`, `references` を更新
+### 自動記憶検索
+
+**プロンプトごとに**、memoriaは自動で：
+1. メッセージからキーワードを抽出
+2. sessions/decisions/patternsを検索
+3. 関連情報をClaudeに注入
+
+手動で検索しなくても、過去の知見が常に活用されます。
 
 ### セッション提案
 
@@ -122,43 +123,27 @@ Claude Codeを再起動
 Continue from a previous session? Use `/memoria:resume <id>`
 ```
 
-### セッションチェーン追跡
-
-セッションを再開すると、チェーンが追跡されます：
-
-```
-/memoria:resume abc123
-  ↓
-現在のセッションJSONを更新: "resumedFrom": "abc123"
-  ↓
-チェーン: current ← abc123
-```
-
 ### コマンド
 
 | コマンド | 説明 |
 | --------- | ------ |
+| `/memoria:save` | 全データ抽出: 要約・判断・パターン・ルール |
+| `/memoria:plan [トピック]` | 記憶参照 + ソクラティック質問 + タスク分割 |
 | `/memoria:resume [id]` | セッションを再開（ID省略で一覧表示） |
-| `/memoria:save` | 要約作成 + 構造化データ保存 + ルール抽出 |
-| `/memoria:decision "タイトル"` | 技術的な判断を記録 |
-| `/memoria:search "クエリ"` | セッション・判断記録を検索 |
-| `/memoria:review [--staged\|--all\|--diff=branch\|--full]` | ルールに基づくレビュー（--fullで二段階） |
+| `/memoria:search "クエリ"` | セッション・判断・パターンを検索 |
+| `/memoria:review [--staged\|--all\|--diff=branch\|--full]` | ルールに基づくレビュー |
 | `/memoria:report [--from YYYY-MM-DD --to YYYY-MM-DD]` | 週次レビューレポート |
-| `/memoria:brainstorm [トピック]` | ソクラティック質問 + 記憶参照で設計 |
-| `/memoria:plan [トピック]` | 2-5分TDDタスクに分割した計画作成 |
-| `/memoria:tdd` | RED-GREEN-REFACTOR厳格サイクル |
-| `/memoria:debug` | 根本原因分析 + エラーパターン参照 |
 
 ### 推奨ワークフロー
 
 ```
-brainstorm → plan → tdd → review
+plan → implement → save → review
 ```
 
-1. **brainstorm**: ソクラティック質問 + 記憶参照で設計
-2. **plan**: 2-5分TDDタスクに分割
-3. **tdd**: RED → GREEN → REFACTOR で実装
-4. **review**: 仕様準拠（--full）+ コード品質をレビュー
+1. **plan**: 記憶参照 + ソクラティック質問 + タスク分割
+2. **implement**: 計画に沿って実装
+3. **save**: 判断・パターン・ルールを抽出
+4. **review**: 計画準拠とコード品質をレビュー
 
 ### ダッシュボード
 
@@ -178,9 +163,9 @@ npx @hir4ta/memoria --dashboard --port 8080
 
 #### 画面一覧
 
-- **Sessions**: セッション一覧・詳細・編集・削除
-- **Decisions**: 技術的な判断の一覧・作成・編集・削除
-- **Rules**: 開発ルール・レビュー観点の閲覧・編集
+- **Sessions**: セッション一覧・詳細
+- **Decisions**: 技術的な判断の一覧・詳細
+- **Rules**: 開発ルール・レビュー観点の閲覧
 - **Patterns**: 学習済みパターンの閲覧（グッドパターン、アンチパターン、エラー解決策）
 - **Statistics**: アクティビティチャート・セッション統計の表示
 - **Graph**: タグ共有によるセッション関連性の可視化
@@ -199,47 +184,41 @@ flowchart TB
         C --> D[interactions + files + metrics]
     end
 
+    subgraph autosearch [自動記憶検索]
+        E[ユーザープロンプト] --> F[UserPromptSubmitフック]
+        F --> G[sessions/decisions/patternsを検索]
+        G --> H[関連コンテキストを注入]
+    end
+
     subgraph backup [PreCompactバックアップ]
-        E[コンテキスト95%] --> F[PreCompactフック]
-        F --> G[interactionsをpreCompactBackupsに保存]
+        I[コンテキスト95%] --> J[PreCompactフック]
+        J --> K[interactionsをpreCompactBackupsに保存]
     end
 
     subgraph manual [手動操作]
-        H["memoria:save"] --> I[JSON更新（構造化データ）]
-        J["memoria:decision"] --> K[判断を明示的に記録]
+        L["memoria:save"] --> M[判断 + パターン + ルールを抽出]
+        N["memoria:plan"] --> O[記憶参照 + 設計 + タスク分割]
     end
 
     subgraph resume [セッション再開]
-        L["memoria:resume"] --> M[一覧から選択]
-        M --> N[過去の文脈を復元 + resumedFrom設定]
-    end
-
-    subgraph search [検索]
-        O["memoria:search"] --> P[セッションと判断を検索]
+        P["memoria:resume"] --> Q[一覧から選択]
+        Q --> R[過去の文脈を復元 + resumedFrom設定]
     end
 
     subgraph review [レビュー]
-        Q["memoria:review"] --> R[ルールに基づく指摘]
-        R --> S[レビュー結果を保存]
-    end
-
-    subgraph report [週次レポート]
-        T["memoria:report"] --> U[レビュー集計レポート]
+        S["memoria:review"] --> T[ルールに基づく指摘]
+        T --> U[レビュー結果を保存]
     end
 
     subgraph dashboard [ダッシュボード]
         V["npx @hir4ta/memoria -d"] --> W[ブラウザで表示]
-        W --> X[閲覧・編集・削除]
+        W --> X[全データを閲覧]
     end
 
-    D --> L
-    G --> L
-    I --> L
-    K --> O
-    D --> S
-    S --> U
-    D --> V
-    K --> V
+    D --> P
+    H --> L
+    M --> V
+    U --> V
 ```
 
 ## データ保存
@@ -249,10 +228,14 @@ flowchart TB
 ```text
 .memoria/
 ├── tags.json         # タグマスターファイル（93タグ、表記揺れ防止）
-├── sessions/         # セッション履歴 (YYYY/MM)
+├── sessions/         # セッション履歴（自動 + 手動保存）
+│   └── YYYY/MM/
+│       └── {id}.json
+├── decisions/        # 技術的な判断（/saveから）
 │   └── YYYY/MM/
-│       └── {id}.json # 全セッションデータ（自動 + 手動保存）
-├── decisions/        # 技術的な判断 (YYYY/MM)
+│       └── {id}.json
+├── patterns/         # エラーパターン（/saveから）
+│   └── {user}.json
 ├── rules/            # 開発ルール / レビュー観点
 ├── reviews/          # レビュー結果 (YYYY/MM)
 └── reports/          # 週次レポート (YYYY-MM)

package/README.md

@@ -2,27 +2,21 @@
 
 Long-term memory plugin for Claude Code
 
-Provides automatic session saving, technical decision recording, and web dashboard management.
+Provides automatic session saving, intelligent memory search, and web dashboard management.
 
 ## Features
 
 ### Core Features
 - **Auto-save interactions**: Conversations auto-saved at session end (jq-based, reliable)
+- **Auto memory search**: Related past sessions/decisions automatically injected on each prompt
 - **Backup on PreCompact**: Interactions backed up before Auto-Compact (context 95% full)
-- **Manual save**: Create summary and structured data with `/memoria:save`
+- **Full data extraction**: Save summary, decisions, patterns, and rules with `/memoria:save`
+- **Memory-informed planning**: Design and plan with past knowledge via `/memoria:plan`
 - **Session Resume**: Resume past sessions with `/memoria:resume` (with chain tracking)
 - **Session Suggestion**: Recent 3 sessions shown at session start
-- **Technical Decision Recording**: Record decisions with `/memoria:decision`
 - **Rule-based Review**: Code review based on `dev-rules.json` / `review-guidelines.json`
 - **Weekly Reports**: Auto-generate Markdown reports aggregating review results
-- **Web Dashboard**: View and edit sessions, decisions, and rules
-
-### Development Workflow (superpowers-style)
-- **Brainstorming**: Socratic questioning + past memory lookup (`/memoria:brainstorm`)
-- **Planning**: 2-5 minute task breakdown with TDD enforcement (`/memoria:plan`)
-- **TDD**: Strict RED-GREEN-REFACTOR cycle (`/memoria:tdd`)
-- **Debugging**: Systematic root cause analysis + error pattern lookup (`/memoria:debug`)
-- **Two-stage Review**: Spec compliance + code quality (`/memoria:review --full`)
+- **Web Dashboard**: View sessions, decisions, patterns, and rules
 
 ## Problems Solved
 
@@ -30,15 +24,16 @@ Provides automatic session saving, technical decision recording, and web dashboa
 
 - **Context Loss**: Conversation context is lost on session end or Auto-Compact
 - **Opaque Decisions**: "Why did we choose this design?" becomes untraceable
-- **Hard to Reuse Knowledge**: Past interactions and decisions are hard to search and reference
+- **Repeated Mistakes**: Same errors solved multiple times without learning
+- **Hard to Reuse Knowledge**: Past interactions and decisions are hard to search
 
 ### What memoria Enables
 
 - **Auto-save + Resume** enables context continuity across sessions
-- **Decision Recording** tracks reasoning and alternatives for later review
+- **Auto memory search** brings relevant past knowledge to every conversation
+- **Decision & Pattern Recording** tracks reasoning and error solutions
 - **Search and Dashboard** for quick access to past records
 - **Review Feature** for repository-specific code review
-- **Weekly Reports** for improving and sharing review practices
 
 ### Team Benefits
 
@@ -106,8 +101,14 @@ This will auto-update on Claude Code startup.
 
 **PreCompact** backs up interactions to `preCompactBackups` before Auto-Compact (context 95% full). Summary is NOT auto-created.
 
-**Summary and structured data** are created manually via `/memoria:save`:
-- Updates `title`, `tags`, `summary`, `plan`, `discussions`, `errors`, `handoff`, `references` in JSON
+### Auto Memory Search
+
+**On every prompt**, memoria automatically:
+1. Extracts keywords from your message
+2. Searches sessions/decisions/patterns
+3. Injects relevant context to Claude
+
+This means past knowledge is always available without manual lookup.
 
 ### Session Suggestion
 
@@ -122,43 +123,27 @@ At session start, recent 3 sessions are shown:
 Continue from a previous session? Use `/memoria:resume <id>`
 ```
 
-### Session Chain Tracking
-
-When resuming a session, the chain is tracked:
-
-```
-/memoria:resume abc123
-  ↓
-Current session JSON updated: "resumedFrom": "abc123"
-  ↓
-Chain: current ← abc123
-```
-
 ### Commands
 
 | Command | Description |
 |---------|-------------|
+| `/memoria:save` | Extract all data: summary, decisions, patterns, rules |
+| `/memoria:plan [topic]` | Memory-informed design + Socratic questions + task breakdown |
 | `/memoria:resume [id]` | Resume session (show list if ID omitted) |
-| `/memoria:save` | Create summary + structured data + extract rules |
-| `/memoria:decision "title"` | Record a technical decision |
-| `/memoria:search "query"` | Search sessions and decisions |
-| `/memoria:review [--staged\|--all\|--diff=branch\|--full]` | Rule-based code review (--full for two-stage) |
+| `/memoria:search "query"` | Search sessions, decisions, and patterns |
+| `/memoria:review [--staged\|--all\|--diff=branch\|--full]` | Rule-based code review |
 | `/memoria:report [--from YYYY-MM-DD --to YYYY-MM-DD]` | Weekly review report |
-| `/memoria:brainstorm [topic]` | Design-first Socratic questioning + memory lookup |
-| `/memoria:plan [topic]` | Create implementation plan with 2-5 min TDD tasks |
-| `/memoria:tdd` | Strict RED-GREEN-REFACTOR development cycle |
-| `/memoria:debug` | Systematic debugging with error pattern lookup |
 
 ### Recommended Workflow
 
 ```
-brainstorm → plan → tdd → review
+plan → implement → save → review
 ```
 
-1. **brainstorm**: Design with Socratic questions + past memory lookup
-2. **plan**: Break into 2-5 minute TDD tasks
-3. **tdd**: Implement with RED → GREEN → REFACTOR
-4. **review**: Verify against plan (--full) and code quality
+1. **plan**: Design with memory lookup + Socratic questions + task breakdown
+2. **implement**: Follow the plan
+3. **save**: Extract decisions, patterns, rules
+4. **review**: Verify against plan and code quality
 
 ### Dashboard
 
@@ -178,9 +163,9 @@ npx @hir4ta/memoria --dashboard --port 8080
 
 #### Screens
 
-- **Sessions**: List, view, edit, delete sessions
-- **Decisions**: List, create, edit, delete technical decisions
-- **Rules**: View and edit dev rules and review guidelines
+- **Sessions**: List and view sessions
+- **Decisions**: List and view technical decisions
+- **Rules**: View dev rules and review guidelines
 - **Patterns**: View learned patterns (good patterns, anti-patterns, error solutions)
 - **Statistics**: View activity charts and session statistics
 - **Graph**: Visualize session connections by shared tags
@@ -199,47 +184,41 @@ flowchart TB
         C --> D[interactions + files + metrics]
     end
 
+    subgraph autosearch [Auto Memory Search]
+        E[User Prompt] --> F[UserPromptSubmit Hook]
+        F --> G[Search sessions/decisions/patterns]
+        G --> H[Inject relevant context]
+    end
+
     subgraph backup [PreCompact Backup]
-        E[Context 95% Full] --> F[PreCompact Hook]
-        F --> G[Backup interactions to preCompactBackups]
+        I[Context 95% Full] --> J[PreCompact Hook]
+        J --> K[Backup interactions to preCompactBackups]
     end
 
     subgraph manual [Manual Actions]
-        H["memoria:save"] --> I[Update JSON with structured data]
-        J["memoria:decision"] --> K[Record decision explicitly]
+        L["memoria:save"] --> M[Extract decisions + patterns + rules]
+        N["memoria:plan"] --> O[Memory-informed design + tasks]
     end
 
     subgraph resume [Session Resume]
-        L["memoria:resume"] --> M[Select from list]
-        M --> N[Restore past context + set resumedFrom]
-    end
-
-    subgraph search [Search]
-        O["memoria:search"] --> P[Search sessions and decisions]
+        P["memoria:resume"] --> Q[Select from list]
+        Q --> R[Restore past context + set resumedFrom]
     end
 
     subgraph review [Review]
-        Q["memoria:review"] --> R[Rule-based findings]
-        R --> S[Save review results]
-    end
-
-    subgraph report [Weekly Report]
-        T["memoria:report"] --> U[Review summary report]
+        S["memoria:review"] --> T[Rule-based findings]
+        T --> U[Save review results]
     end
 
     subgraph dashboard [Dashboard]
         V["npx @hir4ta/memoria -d"] --> W[Open in browser]
-        W --> X[View, edit, delete]
+        W --> X[View all data]
     end
 
-    D --> L
-    G --> L
-    I --> L
-    K --> O
-    D --> S
-    S --> U
-    D --> V
-    K --> V
+    D --> P
+    H --> L
+    M --> V
+    U --> V
 ```
 
 ## Data Storage
@@ -252,7 +231,11 @@ All data is stored in `.memoria/` directory:
 ├── sessions/         # Session history (YYYY/MM)
 │   └── YYYY/MM/
 │       └── {id}.json # All session data (auto + manual save)
-├── decisions/        # Technical decisions (YYYY/MM)
+├── decisions/        # Technical decisions (from /save)
+│   └── YYYY/MM/
+│       └── {id}.json
+├── patterns/         # Error patterns (from /save)
+│   └── {user}.json
 ├── rules/            # Dev rules / review guidelines
 ├── reviews/          # Review results (YYYY/MM)
 └── reports/          # Weekly reports (YYYY-MM)