Plugin: kochetkov-ma/claude-brewcode

Memory Optimizer

Claude Code の auto-memory ファイルを 4 つのインタラクティブステップ で最適化します。重複を削除し、ルールを適切なコンフィグファイルに移行し、残りのエントリを圧縮し、結果を検証します。 典型的な削減量: メモリファイルのトークンカウントで 30–50%。

Auto-memory は ~/.claude/projects/**/memory/MEMORY.md にセッション間でコンテキストを保存します。 有効化: CLAUDE_CODE_DISABLE_AUTO_MEMORY=0 · 無効化: CLAUDE_CODE_DISABLE_AUTO_MEMORY=1

メリット: コンテキスト読み込みの高速化 · 重複ルールなし · よりクリーンな指示 · API コスト削減

使用方法:

/memory-optimize          # 引数なし — 4 ステップのインタラクティブワークフローを開始

スキルテキストは LLM 向けに書かれており、トークン効率を最適化しています。

---

Memory Optimizer

Claude Code メモリファイルを 4 つのインタラクティブステップを通じて最適化します。

context: fork なし — エージェントをスポーンするにはメインの会話で実行する必要があります。

Phase 0: コンテキスト読み込み

1. すべてのメモリファイルを Glob: ~/.claude/projects/**/memory/*.md
2. ~/.claude/CLAUDE.md とプロジェクト CLAUDE.md を読み込み (存在する場合)
3. .claude/rules/*.md を Glob — すべてのプロジェクトルールを読み込み
4. ~/.claude/rules/*.md を読み込み — すべてのグローバルルールを読み込み

コンテキストマップを構築:

memory_files: [paths]
claude_md_sections: [sections]
rules_files: [paths with content]

Step 1: 分析 — 重複を削除 (インタラクティブ)

目的: CLAUDE.md またはルールにすでに存在するコンテンツを複製しているメモリエントリを見つけます。

1. Explore エージェントをスポーンして、読み込まれたすべてのファイルを相互参照
2. 次のようなエントリを特定:
   • 同じルールが CLAUDE.md にすでに存在
   • 同じパターンがルールファイルにすでに存在
   • CLAUDE.md に矛盾 (CLAUDE.md が優先)
3. 分析を表示:

   Found X duplicate/redundant entries (Y% of memory):
   | Entry | Memory File | Already In | Action |
   |-------|-------------|------------|--------|
   | "Use grepai first" | MEMORY.md:5 | rules/grepai-first.md | DELETE |
   ...
   

4. AskUserQuestion: 「X 個の重複エントリを削除しますか? (Y% のメモリ) これは安全です — コンテンツは他の場所に存在します。」
   • オプション: 「すべて削除」 / 「各個を確認」 / 「このステップをスキップ」
5. 承認された場合、Edit ツールを使用して削除を適用

Step 2: 移行 — ルール/CLAUDE.md に移動 (インタラクティブ)

目的: 永続的なコンフィグファイルに適したエントリを特定します。

決定木 (エントリごと):

• すべてのプロジェクトに適用 + ルール/制約である → ~/.claude/rules/
• このプロジェクトのみに適用 + ルールである → .claude/rules/
• アーキテクチャの判断である → プロジェクト CLAUDE.md
• セッション間で再利用可能な事実/パターンである → メモリに保持

1. カテゴリ化を表示:

   X entries suitable for migration:
   | Entry | Current Location | Target | Reduction |
   |-------|-----------------|--------|-----------|
   | "Always use BD_PLUGIN_ROOT" | MEMORY.md:12 | .claude/rules/brewdoc.md | 15 tokens |
   ...
   Total: X entries → ~Y tokens saved
   

2. AskUserQuestion: 「X 個のエントリをルール/CLAUDE.md に移行しますか?」
   • オプション: 「すべて移行」 / 「各個を確認」 / 「このステップをスキップ」
3. 承認された場合:
   • Edit でターゲットルールファイルを作成/追記
   • Edit でメモリから移行されたエントリを削除
   • ターゲットファイルが存在しない場合は作成

Step 3: 圧縮 (インタラクティブ)

目的: LLM 効率的なフォーマットを使用して残りのエントリを圧縮します。

圧縮テクニック:

• 文章 → テーブル行
• 関連する複数のエントリ → 単一テーブル
• 冗長な説明 → 命令形のワンライナー
• 例のリスト → パターン + 1 つの例

1. 圧縮プレビューを表示:

   Compression opportunities found:
   | Before | After | Savings |
   |--------|-------|---------|
   | "When you need to... always use..." | "Use X for Y" | 8 tokens |
   ...
   Total: ~Y% token reduction (~Z tokens)
   

   2-3 個の具体的な圧縮前後のサンプルを表示。
2. AskUserQuestion: 「メモリを圧縮しますか? (~Y% 削減)」
   • オプション: 「すべて圧縮」 / 「圧縮をスキップ」
3. Edit で圧縮を適用 (行番号を保持するため、ボトムアップ順序で)

Step 4: 検証 (自動)

目的: 最終状態を検証し、孤立した参照をクリーンアップします。

1. reviewer エージェントをスポーンして検証:
   • メモリファイル内に壊れたファイルパス参照がない
   • メモリと CLAUDE.md 間に矛盾がない
   • メモリファイルは正しく形式化された markdown である
2. 壊れた参照をクリーンアップ (Edit ツール)
3. 孤立したメモリファイルをチェック (~/.claude/projects/**/memory/ 内の MEMORY.md 参照のないファイル)
4. 孤立したファイルをレポートして削除を依頼

最終レポート:

## Memory Optimization Complete

### Summary
| Metric | Before | After | Saved |
|--------|--------|-------|-------|
| Total entries | X | Y | Z |
| Duplicate entries | X | 0 | — |
| Migrated entries | — | — | X |
| Token estimate | ~X | ~Y | ~Z (~P%) |

### Changes Made
- Step 1: Deleted X duplicate entries
- Step 2: Migrated X entries to rules/CLAUDE.md
- Step 3: Compressed X entries (Y% reduction)
- Step 4: Fixed X broken references, removed X orphaned files

### Final Memory Structure
{directory listing of ~/.claude/projects/.../memory/}

---

**Part of brewdoc:** [brewcode](https://github.com/kochetkov-ma/claude-brewcode) — docs tools: memory optimization, auto-sync, Claude installation docs, Markdown to PDF.
Install: `claude plugin marketplace add https://github.com/kochetkov-ma/claude-brewcode && claude plugin install brewdoc@claude-brewcode`