Claude Codeの自動メモリにおけるコンテキスト肥大化を命名スキーマと監査スクリプトで修正する

r/ClaudeAIの開発者が、Claude Codeの自動メモリにおけるメモリドリフトとコンテキスト肥大化に対処する実用的なスキルを共有しました。このスキルは、ファイル命名規則と必須のフロントマターフィールドを強制し、問題を検出するbash監査スクリプトを含みます。

スキルの機能

Claude Codeの自動メモリ（v2.1.59+）は、~/.claude/projects/<slug>/memory/にプレーンマークダウンを書き込みます。このスキルはその上に構造を追加します。ファイルは<type>_<topic>.mdの命名規則に従い、フロントマターにname、description、typeが必要で、フィードバックエントリにはWhyセクションを含める必要があります。自動メモリは引き続き書き込みますが、スキルはClaudeが仕様に従って書き込むようにします。

主な機能

• フレーズトリガーによるレビュー：「メモリ監査」と言えば監査スクリプトを実行；「セッションレビュー」は最近のセッションを確認し、保持すべきものを提示。
• ソフト警告：監査はドリフトを報告しますが、書き込みをブロックしません。
• プレーンマークダウン：ファイルはgrepやgitなどで編集可能。データベースやデーモンは不要。

メモリへの影響

1ファイルに1トピックとすることで、Claudeは初回のルックアップで正しいエントリに到達します。重複排除されたライブラリはセッションごとに読み込むファイルが減り、実際の作業のためのコンテキストが増えます。

監査出力例

Memory audit · 2026-05-15 · 132 files
Hard checks (must be zero):
  missing frontmatter     0
  frontmatter fields      0
  feedback missing Why    1
  naming violations       0
  broken MEMORY.md links  0
Soft signals:
  oversized files         78
  groups over 15 entries  3
  untouched 30+ days      31
  not in MEMORY.md        0
Hard-rule compliance: 99.2% (1 violation / 132 files)

インストール

任意のClaude Codeセッションに貼り付け: Install the claude-memory-manager skill from https://github.com/jau123/claude-memory-manager。その後「audit memory」と発言して確認。

組み込み自動メモリとの比較

• 自動メモリのみ：スキーマなし、監査なし。Claudeが命名と構造を決定。
• このスキルあり：3タイプのスキーマ + 必須フィールド + フィードバックのWhy + ワンコマンド監査スクリプト。

制限

• 単一プロジェクトのみ。
• セマンティックランキングなし – 監査はパターンマッチのみ。
• Bashスクリプト; Windows/git-bashは未テスト。
• 小規模ライブラリ（約10エントリ未満または1ヶ月未満）には過剰。