context-optimization

コンテキスト最適化ハブ

使用するタイミング

• しきい値アラート：コンテキスト使用量がウィンドウの 50% に近づいたとき。
• 複雑なタスク：複数ファイルの分析や長いツールチェーンが必要な操作。

使用しないタイミング

• コンテキスト使用量が少ない、単純な 1 ステップのタスク
• ツールチェーンにすでに mcp-code-execution を使用している場合

ハブの主な役割

1. コンテキストの負荷と MECW への準拠状況を評価します。
2. 適切な専門モジュールに振り分けます。
3. サブエージェントベースのワークフローを調整します。
4. モジュール間のトークン予算の割り当てを管理します。
5. モジュール実行の結果を統合します。

モジュール選択戦略

def select_optimal_modules(context_situation, task_complexity):
    if context_situation == "CRITICAL":
        return ["mecw-assessment", "subagent-coordination"]
    elif task_complexity == "high":
        return ["mecw-principles", "subagent-coordination"]
    else:
        return ["mecw-assessment"]

コンテキストの分類

使用率	状態	対応
< 30%	LOW	通常どおり続行します
30-50%	MODERATE	監視し、原則を適用します
> 50%	CRITICAL	直ちに最適化が必要です

大きな出力の処理（Claude Code 2.1.2+）

動作の変更：大きな bash コマンドやツールの出力は切り捨てられず、ディスクに保存されます。アクセス用にファイル参照が提供されます。

コンテキスト最適化への影響

シナリオ	2.1.2 より前	2.1.2 以降
大きなテスト出力	切り捨てられ、一部のデータのみ	ファイル参照から出力全体を取得
詳細なビルドログ	30K 文字を超えると失われる	完全な状態で、必要に応じてアクセス可能
コンテキストの負荷	切り捨てにより軽減	同じ — 読み込んだときのみ負荷がかかる

ベストプラクティス

• 先回りして読み込まない：大きな出力は参照されますが、コンテキストに自動的に読み込まれることはありません。
• 必要な部分だけ読む：ファイル参照に対して head、tail、または grep を使用します。
• データ全体を活用する：品質ゲートでは、ファイルを通じてテスト結果全体にアクセスできます。
• 増加を監視する：ファイル参照は小さいものの、ファイル全体を読むとコンテキストの負荷が増えます。

統合ポイント

• トークン節約：使用戦略を受け取り、MECW に準拠した最適化を返します。
• CPU/GPU パフォーマンス：コンテキスト最適化をリソースの制約に合わせます。
• MCP Code Execution：複雑なパターンを専門の MCP モジュールに委任します。

リソース

• MECW 理論：基本概念、50% ルール、クイックスタート用のコード例については、modules/mecw-principles.md を参照してください。
• コンテキスト分析：リスクの特定については、modules/mecw-assessment.md を参照してください。
• ワークフローの委任：分解パターンについては、modules/subagent-coordination.md を参照してください。
• コンテキスト待機：遅延読み込みの戦略については、modules/context-waiting.md を参照してください。
• キャッシュとの整合：プロバイダーの KV キャッシュがヒットするようにコンテキストを並べ替える方法（安定したプレフィックスを先に、変動するものを最後に）については、modules/cache-aligned-prefixes.md を参照してください。
• 圧縮方法の選択：節約効果とリスクを踏まえ、/clear と /catchup、継続エージェント、アーカイブして要約する方法、委任のいずれかを選ぶには、modules/compression-strategies.md を参照してください。
• 大きなツール出力：取得可能なハンドルを使って大きすぎる出力をアーカイブする方法については、modules/reversible-compression.md を参照してください。
• 貼り付けたログ：圧縮する前にログをフィルタリングする方法については、modules/log-debugging-hygiene.md を参照してください。/filter-log はこの方法を基準にします。

トラブルシューティング

よくある問題

最適化後もコンテキスト使用量が高い場合は、選択的にではなく、ファイル全体を読み込んでいないか確認してください。MECW の評価に失敗する場合は、環境が正確なトークン数のメタデータを提供していることを確認してください。出力ログを /tmp に書き込む際に権限エラーが発生した場合は、プロジェクトの一時ディレクトリに書き込み可能であることを確認してください。

終了条件

• MECW の 50% ルールに照らしてコンテキストの負荷を評価した
• 現在の状態に対するメモリ階層または振り分けの判断を記録した
• 大きな出力は全体を読み込まず、ファイルまたはハンドルで参照した
• リクエストがプロバイダーのペイロードを制御する場合、プレフィックスの順序を modules/cache-aligned-prefixes.md に照らして確認した（安定したものを先に、変動するものを最後に）
• ハーネスがすでにキャッシュしている場合、最適化を助言にとどめた（繰り返し使わないプレフィックスでは、キャッシュへの書き込みコストが節約効果を上回るため）