affaan-m/strategic-compact

Strategic Compactスキル

任意の自動コンパクションに依存するのではなく、ワークフローの戦略的なポイントで手動の/compactを提案します。

なぜ戦略的コンパクションか？

自動コンパクションは任意のポイントでトリガーされます：

• 多くの場合タスクの途中で、重要なコンテキストを失う
• タスクの論理的な境界を認識しない
• 複雑な複数ステップの操作を中断する可能性がある

論理的な境界での戦略的コンパクション：

• 探索後、実行前 - 研究コンテキストをコンパクト、実装計画を保持
• マイルストーン完了後 - 次のフェーズのために新しいスタート
• 主要なコンテキストシフト前 - 異なるタスクの前に探索コンテキストをクリア

仕組み

suggest-compact.jsスクリプトはPreToolUse（Edit/Write）で実行され：

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

フック設定

プラグインとしてインストール済みの場合：設定は不要です。プラグインの hooks/hooks.json が既に suggest-compact.js を登録しています（フック ID pre:edit-write:suggest-compact、standard と strict フックプロファイルで有効）。下のブロックを ~/.claude/settings.json にコピーしないでください — プラグインインストールでは ~/.claude/scripts/ は存在せず、プラグインフックを重複させると二重実行になります。

手動インストール（./install.sh）の場合、~/.claude/settings.json に追加：

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

設定

環境変数：

• COMPACT_THRESHOLD - 最初の提案前のツール呼び出し（デフォルト：50）

ベストプラクティス

1. 計画後にコンパクト - 計画が確定したら、コンパクトして新しくスタート
2. デバッグ後にコンパクト - 続行前にエラー解決コンテキストをクリア
3. 実装中はコンパクトしない - 関連する変更のためにコンテキストを保持
4. 提案を読む - フックはいつを教えてくれますが、するかどうかは自分で決める

関連

• The Longform Guide - トークン最適化セクション
• メモリ永続化フック - コンパクションを超えて存続する状態用