EliaAlberti/cpr-compress-preserve-resume

何を解決するか

Claude Code にはセッション間で永続的なメモリが存在しないため、ユーザーは毎回再起動するたびにプロジェクトの文脈、意思決定、修正内容を再説明しなければなりません。また、標準的なコンテキスト圧縮は重要な詳細を平坦化し、微細な意思決定や特定のファイルパスが時間とともに失われる原因となります。

仕組み

CPR は Claude Code 用のプラグインで、キュレートされたセッションログと自動フックのシステムを実装しています：

• キュレートされたログ：/cpr:compress を使用すると、意思決定、学び、保留中のタスクの要約を含む構造化された Markdown ファイルが作成されます。Python スクリプトを介して生の会話トランスクリプトを追加することで、モデルのトークンを無駄にすることを回避します。
• 自動フック：PreCompact フックは、コンパクションが行われる前に生のトランスクリプトを自動保存し、SessionStart フックは新しいセッションに簡潔なメモリ要約を自動的に挿入します。
• コンテキストの復元：/cpr:resume コマンドにより、最近のコンテキストを復元したり、要約と生ログの両方でトピックごとに過去のセッションを検索できます。
• 知識の保存：/cpr:preserve コマンドは、重要なアーキテクチャ的決定やパターンを CLAUDE.md ファイルに更新し、将来のすべてのセッションにわたって持続させます。

対象ユーザー

複数回の Claude Code セッションで同じプロジェクトに取り組む開発者で、繰り返しのコンテキスト設定を避け、作業状態の検索可能な履歴を維持したい人。

特徴

• トークン効率：手動での再説明をコンパクトな要約に置き換えることで、セッション再起動時のトークンコストを約 51–74% 削減します。
• 検索可能な履歴：モデルのコンテキストウィンドウに読み込まれることなく、トピックごとに検索可能な生トランスクリプトの完全なディスクアーカイブを維持します。
• 自動的な安全網：PreCompact フックにより、自動または手動のコンパクション中に生の会話データが失われるリスクがありません。
• カスタマイズ可能なストレージ：設定ファイルを介してログを特定のディレクトリにルーティングしたり、複数のフォルダにミラー化することをサポートします。