compact-guard

コンパクトガード

コンパクションサイクルを通じて、重要なコンテキストを保護します。Claude Code の内部仕様に基づいています。コンパクション後に復元されるのは、最大 5 ファイル（各 5K トークン）で、合計上限は 50K です。

トリガー

/compact の実行前、または自動コンパクトの警告が表示されたときに使用します。

主要な定数（Claude Code のソースコードより）

• POST_COMPACT_MAX_FILES_TO_RESTORE = 5 — 復元されるファイルは 5 つのみです
• POST_COMPACT_TOKEN_BUDGET = 50K — 復元トークンの合計上限です
• POST_COMPACT_MAX_TOKENS_PER_FILE = 5K — ファイルごとの上限です
• 自動コンパクトは context_window - 13K のバッファーで実行されます

コンパクション前のチェックリスト

コンパクションの前に、以下をメモリーまたは一時ファイルに保存します。

1. 現在のタスク — 何に取り組んでいますか？ 1 文で記します。
2. 作業中のファイル — どのファイルを編集中ですか？（最大 5 つ — コンパクションで復元されるのは 5 つのみです）
3. 決定事項 — 今回のセッションで決めたアーキテクチャ上の選択
4. ブロッカー — 進行を妨げているもの
5. 次のステップ — コンパクション直後に行うこと

戦略：まずマイクロコンパクション

完全なコンパクションの前に、マイクロコンパクションを試します。

• 大きなツールの結果（テスト出力、grep の結果など）は切り詰められます
• 関連性がなくなったファイルの読み込み内容は破棄できます
• 重い調査にはサブエージェントを使い、メインのコンテキストを整理しておきます

コンパクション後の復旧

コンパクション後、すぐに次の作業を行います。

1. 優先度が最も高いファイル（現在編集中のファイル）を再度読み込みます
2. タスクリストで現在の進捗を確認します
3. コンパクション前に保存した一時メモを確認します
4. 次のステップから再開します

予防策

戦略	トークンの節約量	タイミング
grep／検索をサブエージェントに委任する	検索ごとに 30〜60%	広範な検索では常に
必要な行のみ読み込む（offset／limit）	読み込みごとに 50〜90%	大きなファイル
タスクの区切りでコンパクションする	一貫性を維持	論理的な手順の合間
新たに開始する場合は /resume を使う	100%	関連性のない新しいタスク

出力

compact-guard の実行後：

COMPACT GUARD
  Files to preserve: [list top 5]
  Task state: [one sentence]
  Decisions: [key choices]
  Next step: [immediate action after compact]

  Ready to compact. Run /compact now.

ルール

• コンパクションの前に必ず状態を保存します — 状態を確認せずにコンパクションしてはいけません
• 現在編集中のファイルを、復元するファイルの第 1 優先にします
• 自動コンパクトが予期せず実行された場合は、作業中のファイルをすぐに再度読み込みます
• 実際のコンテキスト用の余地を残すため、CLAUDE.md は 60 行未満に保ちます