Claude Code の記憶システムのアップグレード前に共有した、Claude Code に記憶を追加するための方案について、最近一輪のアップグレードを行いました。核心的な変更は、「何を記憶するか、いつ記憶するか、どこに記憶するか」を三層に分割したことです：

捕获層 — 記憶に値する信号を定義する。15分以上の坑道体験、直感に反する技術発見、戦略的意思決定のバランス調整など。すべての対話が記憶に値するわけではなく、フィルタリングが重要です。
### 捕获層 — 価値のある信号を定義する
15分以上の坑道体験、直感に反する技術発見、戦略的意思決定のバランス調整など。すべての対話が記憶に値するわけではなく、フィルタリングが重要です。
### 時機層 — 書き込みのタイミングと制御
各タスク完了時に進捗を記録し、コミット後にプロジェクトのコンテキストを更新し、離席信号（「先にこれ」「出かける」）を検知したら即座に全量保存します。手動トリガーに依存しません。
### ルーティング層 — データの保存場所と方法
技術的な坑道体験 → プロジェクトの再利用可能な経験 → 当日の進捗 → 基盤には ChromaDB を用いたベクトルストレージ + BM25 キーワード検索を採用し、純テキストのバックアップも行います。書き込み時には二重書き（データベース + ファイル）を行い、インデックスは増分同期で更新し、全体再構築はしません。
三層はそれぞれ一つの役割を担い、新しい捕获ルールを追加しても書き込みロジックを変更せず、ストレージ位置の変更も信号認識に影響しません。Claude Code の hooks 機構は、この種のイベント駆動パイプラインに自然に適しています。
効果：セッションを跨いだ記憶がついに安定し、Claude は先週の坑道体験を覚えており、デバッグ時にはまず履歴を確認してから作業を始めることができるようになりました。