memory

メモリ - 長期コンテキスト

現在のセッションの長期メモリファイルを読み込み、コンパクション後も保持されている過去のコンテキストにアクセスします。

背景

Claude Code の /compact は、コンテキストを節約するために会話を圧縮します。コンパクションを繰り返すと「メモリの劣化」が起こり、初期の重要な詳細が徐々に失われていきます。

Max のメモリシステムは、各コンパクションの際に蓄積された内容をファイルに自動保存し、重要な情報が失われないようにします。

メモリファイル

ファイル	内容	優先度
errors.md	エラー修正の記録	最高 - 同じ間違いを繰り返さないため
context.md	ユーザーメッセージ + 技術的な概念	中 - 背景情報全般
files.md	コードファイルの参照	低 - 必要な場合のみ

手順

memory.py スクリプトを使って、自動的に切り詰めながらファイルを読み込みます（コンテキストを節約するため、大きなファイルは末尾の約 15000 文字まで切り詰められます）。

# Read errors.md only (default, recommended)
cd /path/to/skills/memory && uv run memory.py errors.md

# Read specific files
cd /path/to/skills/memory && uv run memory.py errors.md context.md

# Read all files
cd /path/to/skills/memory && uv run memory.py all

スクリプトは自動的に以下を行います：

• ~/.claude/projects/$MAX_PROJECT_ID/max/$MAX_SESSION_ID/memory/ から読み込みます
• 15000 文字を超えるファイルを切り詰めます（直近の内容を保持）
• 存在しないファイルはスキップします

メモリを読み込むタイミング

コンパクション後 - 概要に「Earlier details saved to...」と表示された場合：

• 過去の間違いを繰り返さないため、必ず最初に errors.md を読み込みます

必要に応じて - 状況に応じた特定のファイルを読み込みます：

状況	コマンド
エラーが発生した / テストが失敗した	uv run memory.py errors.md
過去の議論を思い出す必要がある	uv run memory.py context.md
コードパターンを再利用する / ファイルを探す	uv run memory.py files.md

注意事項

• メモリファイルは各 /compact の際に自動更新されます
• ファイルにはタイムスタンプ付きで追記され、新しい内容が末尾に追加されます
• コンテキストのオーバーフローを防ぐため、大きなファイルは約 15000 文字（≈コンテキストの 3%）まで切り詰められます