strategic-compact

戦略的なコンテキスト圧縮

概要

長時間の会話では、コンテキストウィンドウには限りがあり、劣化していきます。このスキルでは、いつ圧縮するか、何を保持し何を破棄するか、そして永続的な状態をどのように外部化するかを説明します。

基本原則：任意のタイミングではなく、論理的な区切りで圧縮します。

軽量なコンテキストエンジニアリングガード

重要なフェーズの開始時、引き継ぎ時、圧縮前に、次の短いテキストを使って実行します。

objective:
plan_5_steps_or_less:
context_audit:
- keep:
- externalize:
- discard:
- stale_or_conflicting:
next_boundary:

計画は最大 5 ステップにします。5 ステップで表現できない場合は、範囲を広げず、まず現在の作業単位を絞り込みます。

圧縮の判断表

現在のフェーズ	次のフェーズ	圧縮するか	理由
調査／探索	計画	はい	探索の詳細を計画に持ち込む必要はありません
計画	実装	はい	計画を保持し、計画に至る過程は破棄します
実装ステップ N	実装ステップ N+1	いいえ	実装の途中で圧縮するとコンテキストが失われます
実装完了	検証	任意	コンテキストが上限に近い場合
検証	コミット	いいえ	検証結果をコミットに引き継ぐ必要があります
タスク A 完了	タスク B 開始	はい	タスク間で圧縮します

コンテキスト監査

圧縮前に、必ず分類します。

• keep：目標、制約、現在のブランチ、変更したファイル、重要な決定、最新の検証結果、次のステップ
• externalize：未加工のログ、大きな diff、広範な検索結果、CI の全出力、長い JSON
• discard：解決済みエラーの完全なスタックトレース、探索の過程、失敗した仮説に関する重複した詳細
• stale_or_conflicting：古い計画、古い head SHA、期限切れの CI、現在のファイルと矛盾する記憶

外部化には、リポジトリの成果物、チェックポイント、issue／PR の説明、実行ログ、またはユーザー指定のスクラッチパッドを優先して使用します。未加工のセッションログを現在の事実の情報源として扱わないでください。

圧縮後に保持するチェックリスト

必ず保持するもの：

• 現在のタスクの目標と制約
• 5 ステップ以内の現在の計画
• 実施済みのアーキテクチャ上の決定とその理由
• 変更したファイルの一覧
• 未完了のステップ
• 発見した問題と TODO
• VibeGuard の制約（常に保持）
• 最新の検証エビデンス
• 次にランディングする場合のレビューゲートの判断

破棄してよいもの：

• ファイル内容の完全な引用（パスだけを保持します）
• 検索中に得た中間結果
• 解決済みエラーの完全なスタックトレース
• 探索的なコード閲覧の記録

使用方法

コンテキストが尽きそうだと感じたら：

1. 現在どのフェーズにいるか判断します
2. 圧縮の判断表を確認し、圧縮に適したタイミングか判断します
3. コンテキスト監査を実施し、keep／externalize／discard／stale_or_conflicting に分類します
4. 圧縮に適している場合は、保持するチェックリストに沿って要約を整理します
5. 圧縮を実行します

アンチパターン

• 実装の途中で圧縮する → 重要なコンテキストが失われ、作業のやり直しにつながります
• 圧縮時に制約を破棄する → 後続のステップでルールに違反します
• あふれるまで圧縮しない → 受動的な切り詰めは、能動的な圧縮よりも危険です
• 古い要約をリモートの真実として扱う → 再度 fetch するか、ファイルを確認するか、API を照会する必要があります