memory-optimize

プラグイン: 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          # no args — starts 4-step interactive workflow

スキルのテキストは LLM による消費を想定して書かれており、トークン効率を最適化しています。

---

Memory Optimizer

Claude Code のメモリファイルを 4 つの対話的なステップで最適化します。

context: fork は使用しません — エージェントを起動するにはメインの会話で実行する必要があります。

フェーズ 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]

ステップ 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 |
   |-------|-------------|------------|--------|
   | "Search via Bash grep" | MEMORY.md:5 | rules/code-search.md | DELETE |
   ...
   

4. AskUserQuestion: 「X 件の重複エントリ (メモリの Y%) を削除しますか? これは安全です — 内容は他の場所に存在します。」
   • 選択肢: 「はい、すべて削除」 / 「1 件ずつ確認」 / 「このステップをスキップ」
5. 承認された場合は Edit ツールで削除を適用する

ステップ 2: 移行 — Rules/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 件のエントリを rules/CLAUDE.md に移行しますか?」
   • 選択肢: 「はい、すべて移行」 / 「1 件ずつ確認」 / 「このステップをスキップ」
3. 承認された場合:
   • Edit で対象のルールファイルを作成/追記する
   • Edit でメモリから移行済みエントリを削除する
   • 対象ファイルが存在しない場合は作成する

ステップ 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)
   

   具体的な before/after のサンプルを 2～3 件示します。
2. AskUserQuestion: 「残りのメモリを圧縮しますか? (約 Y% 削減)」
   • 選択肢: 「はい、すべて圧縮」 / 「圧縮をスキップ」
3. Edit で圧縮を適用する (行番号を保つため下から順に)

ステップ 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, Claude installation docs, Markdown to PDF.
Install: `claude plugin marketplace add https://github.com/kochetkov-ma/claude-brewcode && claude plugin install brewdoc@claude-brewcode`