コーディングエージェントに正しいコンテキストを与えよ（それ以上ではなく）

ログインエンドポイントを求める一文だけでは足りない。エージェントはまだエラー形式、フォルダレイアウト、認証ライブラリ、バリデーションパターン、そして「done」がどのようなものかを知る必要がある。Legare KerrisonのIBM Technology短い動画Context-Aware Coding: Give AI Agents the Right Context（2026年11月2日公開）は、すでにコーディングエージェントを使っているチームにとってポイントを具体的で実用的にしている。

これは高レベルのボトルネックエッセイのもう一つではない。実際に出力を変える入力の短いリストだ。

重要な入力

1. ファイルと構造。 強いエージェントは自分でファイルを検索して開ける。あなたの仕事は正しい方向に指し示すこと（「READMEのパターンに従え」）で、理想的にはファイルとシンボルのコンパクトなリポジトリマップを与え、すべての行を読まずに形を見るようにする。

2. 正確な依存関係のバージョン。 ライブラリを使っていることを知るだけでは足りない。ロックファイルは解決されたバージョン（推移的なものも含む）を記録し、したがってどのAPIが実際に存在するかを記録する。多くの「幻覚」関数は単にバージョンの不一致だ。

3. エージェントが通せるテスト。 失敗するテストはセッションをwrite–run–fixループに変える。エージェントが良いものがどのようなものかを知っているとき、エージェント的コーディングはよりうまくいく。

4. 慣習と制約。 ビルドコマンド、コーディング標準、硬いルール（「このディレクトリに触るな」）をチェックインされたAGENTS.md（またはツールがすでに読む同等物）に置く。これは共有のチームインターフェースになりつつある。

5. 意図。 doneが何を意味するか、制約は何か、エージェントがしてはいけないことを知っているのは人間だけだ。エージェントはリポジトリを読むことでこれを発見できない。

どんなコードが書かれる前の三つの動き

• エージェントにあなたをインタビューさせ、タスクを理解するまで質問を続けさせる。
• リポジトリを探索し、構造を平易な言葉であなたに説明させる。これで二人ともマップを共有する。
• 計画を書かせ、仮定をリストアップさせる。実装前にそれらの仮定をレビューする。セッションが終わったら、有用な発見を指示ファイルに書き戻し、次の人（またはエージェント）が先から始められるようにする。

リポジトリ全体をダンプするな

モデルは長いコンテキストのすべてに等しく注意を払わない。始まりと終わりの情報は、中間に埋もれた材料よりよく使われる傾向がある（「lost in the middle」）。無関係なファイルはすべて関連するものと競争する。ログインフローの変更では、エージェントは認証モジュール、そのテスト、慣習を必要とする——請求サービスや3週間前のビルドログではない。

実際的な結果：

• 新しいタスクごとに新鮮なセッションを始める。
• 特定のファイルを指し、セッションが長くなったらノイズを片付ける。
• 一つの過負荷された会話より、クリーンなコンテキストで焦点を絞ったサブタスクを立ち上げるオーケストレータを好む。

目標はより多くのコンテキストではない。正しいコンテキストであり、人間がまだ決定を下していることだ。

Hacker Newsの関連議論は、エージェントが完成した保守可能なソフトウェアより多くのコードを生成し続けることを指摘し続けている。レビューと検証が希少なステップのままである。より良いコンテキストはそれらのステップを取り除かないが、それらに到達するスロップの量を減らす。

出典：上記のIBM Technology動画。同じテーマはエージェントの準備と共有インターフェースに関する最近のAgentic AI FoundationとAI Engineerのトークに現れるが、短く具体的なチェックリストがこの動画を月曜の朝に有用にするものだ。