Strategic Compact Skill

ワークフロー内の戦略的なポイントで /compact を手動実行することをお勧めします。任意の自動compactionに頼るのではなく。

アクティベートする場面

• コンテキスト制限に近づく長時間のセッション（200K以上のトークン）
• マルチフェーズタスク（リサーチ → 計画 → 実装 → テスト）
• 同じセッション内で関連性のないタスク間での切り替え
• 主要なマイルストーン完了後、新しい作業を開始する場合
• レスポンスが遅くなったり、一貫性が低下した場合（コンテキスト圧力）

なぜ Strategic Compaction なのか？

自動compactionは任意のポイントでトリガーされます：

• タスクの途中でトリガーされることが多く、重要なコンテキストが失われる
• 論理的なタスク境界を認識していない
• 複雑なマルチステップ操作を中断する可能性がある

論理的な境界での Strategic compaction：

• 探索完了、実装開始前 — リサーチコンテキストをコンパクトにして、実装計画を保持
• マイルストーン完了後 — 次のフェーズへの新規スタート
• 主要なコンテキストシフト前 — 異なるタスク前に探索コンテキストをクリア

仕組み

suggest-compact.js スクリプトは PreToolUse (Edit/Write) で実行され、以下を実行します：

1. ツール呼び出しを追跡 — セッション内のツール呼び出しをカウント
2. 閾値検出 — 設定可能な閾値（デフォルト: 50呼び出し）で提案
3. 定期的なリマインダー — 閾値後、25呼び出しごとにリマインド

Hook 設定

~/.claude/settings.json に追加してください：

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit",
        "hooks": [{ "type": "command", "command": "node ~/.claude/skills/strategic-compact/suggest-compact.js" }]
      },
      {
        "matcher": "Write",
        "hooks": [{ "type": "command", "command": "node ~/.claude/skills/strategic-compact/suggest-compact.js" }]
      }
    ]
  }
}

設定

環境変数：

• COMPACT_THRESHOLD — 最初の提案までのツール呼び出し数（デフォルト: 50）

Compaction 判断ガイド

compactionのタイミングを決める際の参考表：

フェーズ遷移	Compact?	理由
リサーチ → 計画	はい	リサーチコンテキストは量が多く、計画が蒸留されたアウトプット
計画 → 実装	はい	計画は TodoWrite またはファイルにあり、コード用にコンテキストを解放
実装 → テスト	場合による	テストが最近のコードを参照する場合は保持、フォーカスを切り替える場合はcompact
デバッグ → 次の機能	はい	デバッグトレースは関連のない作業のコンテキストを汚す
実装の途中	いいえ	変数名、ファイルパス、部分的な状態の喪失はコスト高
失敗したアプローチ後	はい	新しいアプローチを試す前に、行き止まりの推論をクリア

Compaction で残るもの

何が残るかを理解することで、自信を持ってcompactできます：

残るもの	失われるもの
CLAUDE.md の指示	中間的な推論と分析
TodoWrite タスクリスト	以前に読んだファイル内容
メモリファイル (~/.claude/memory/)	マルチステップの会話コンテキスト
Git の状態（コミット、ブランチ）	ツール呼び出し履歴とカウント
ディスク上のファイル	口頭で述べられたニュアンスなユーザー設定

ベストプラクティス

1. 計画後にcompact — 計画が TodoWrite で確定したら、compactして新規スタート
2. デバッグ後にcompact — エラー解決コンテキストをクリアしてから継続
3. 実装途中ではcompactしない — 関連する変更のコンテキストを保持
4. 提案を読む — hook が いつ かを教えてくれます。するかどうか はあなたが判断
5. compact 前に書き込む — 重要なコンテキストをファイルまたはメモリに保存
6. /compact にサマリーを付けて使う — カスタムメッセージを追加: /compact Focus on implementing auth middleware next

関連

• The Longform Guide — Token optimization セクション
• Memory persistence hooks — Compaction を通じて存続する状態
• continuous-learning skill — セッション終了前にパターンを抽出