コーディングエージェントのコンテキスト設計：範囲、検索、永続状態

リポジトリ指示は長期的な約束、タスク証拠は現在のコードと障害、外部資料は上流契約、ツール出力は観測、作業メモは一時的な解釈です。すべてを一つの会話へ混ぜると、どの情報が新しく、権威があり、再利用できるか判断しにくくなります。

各分類に所有者、出典、更新条件、保持規則を付けます。ビルドコマンドは長く有効でも、修正後のスタックトレースはすぐ更新すべきです。Issue の文章は、保守担当者が明示的に採用しない限り指示ではなく証拠です。

タスク、許可されたパス、受け入れコマンド、最も近いリポジトリ指示から始めます。関連する入口を確認してから範囲を広げ、判断に必要な資料だけを追加し、URL またはファイルパスを結論と一緒に記録します。

小ささのために必要事項を落としてはいけません。パッケージ固有のテストや生成コード規則が欠ける方が余分な文章より危険なので、リポジトリ構造と変更範囲に照らして十分性を確認します。

複数セッションにまたがる作業では、現在の commit、決定、証拠、変更ファイル、実行コマンド、未解決事項、次の行動を短い引き継ぎへ残します。資格情報を含めず、次のセッションが会話全体を再生せずに再開できる内容にします。

長期規則へ昇格するのは人がレビューした安定事項だけです。一時的な仮説はタスク内に保ち、証拠が変わったら削除または失効表示します。

診断から実装、実装から検証、別のサブシステムへ移るときに作業セットを再構成します。変更後のファイルと最新コマンド結果を読み直し、キャッシュした出力に依存しません。

重要な判断に出典があるか、適用指示を読み込んだか、最終検証が現在の diff を対象にしたか、信頼できない文章を永続指示へ移していないか確認します。これは不可視な推論ではなく、コンテキスト工程を評価する方法です。