The Engineering of Intent 第9章:アドバンスト・コンテキストエンジニアリング

本記事は、私の著書The Engineering of Intent(英語版)を1章ずつ読み解くシリーズの第9回です。前回の記事では、4つのアーキテクチャの柱──Vibes、Specs、Skills、Agents──を見てきました。本章では、そのうちSpecsの最も具体的なかたち、つまりエージェントが毎ターン実際に読むコンテキストに焦点を当てます。


AIネイティブ開発において最もレバレッジの高い活動

コンテキストエンジニアリングとは、各セッションの冒頭でエージェントが目にする情報を形づくる実践です。うまくやれば、AIネイティブ開発において最もレバレッジの高い活動になります。下手にやれば、品質問題の最大の発生源になります。

第9章では、コンテキストエンジニアリングをVibe任せではなく実践として成り立たせるための具体的な成果物──コンテキストパック、階層型プロンプト(Layered Prompt)、そしてそのうちどれを実際に運用に乗せるかを決める経済学──を順に解説します。


コンテキストパック

コンテキストパックとは、あるプロジェクトのすべてのエージェントセッションに読み込ませる、厳選されたファイル群です。Specs、規約、そして慎重に選んだ最近のコードのサンプルを含みます。覚えてしまえるほど安定していて、モデルの作業コンテキストに余裕をもって収まるほど小さく、信頼できるほど最新であることが求められます。

階層型プロンプト

3つの層を、常にこの順序で並べます。System(不変のルール)、Context(パック)、Task(具体的な依頼)。この階層を尊重するチームは、信頼できる出力を得ます。層をひとつの長いプロンプトに押し込んでしまうチームは、不安定な出力を得ます。完全なテンプレートは本書に載せています。


コンテキストは多ければよいわけではない

「コンテキスト内のトークンは、ひとつ残らずレイテンシとお金のコストになります。あるチームがA/Bテストを行いました。セッションの半分には25Kトークンのコンテキストパックをフルで与え、残りの半分には現行の規約と最も関連性の高い5つのコード例だけに絞った8Kトークンの厳選版を与えたのです。チームが追跡していたあらゆる指標で、厳選版のほうが高品質なコードを生み出しました──しかもコストは3分の1でした。」

コンテキストは経済の問題です。規律あるチームは、セッションあたりのトークンコストを監視し、容赦なく刈り込みます。よく効く施策は、エージェントが無視している例を削る、放棄した方向性について書かれた過去のメモを削る、引用ではなく要約する、といったものです。

💡 ポイント: コンテキストパックの最良のテストは、1ページ・オンボーディングテストです。新しく入ったエンジニアがパックだけを読んで、初日に正しい変更を加えられるか? できるなら、パックは十分です。できないなら、パックはあなたのコードベースについて嘘をついています。コンテキストパックは、たまたま機械にも読まれている人間向けのオンボーディング資料として扱ってください。

3つのアンチパターン

  • 何でも詰め込みパック(kitchen sink pack) ── 何が関係あるのかを誰も決めたがらないので、すべてが入っています。エージェントは溺れます。
  • 古びたパック(stale pack) ── 6か月前に書かれ、一度も更新されていません。エージェントは削除済みのAPIを参照します。
  • 説明過多のパック(prose-heavy pack) ── 簡潔なルールで済むところに、長く回りくどい説明が書かれています。エージェントは肝心の制約を読み飛ばします。
⚠ 注意: コンテキスト腐食──パックに書かれている内容と、コードベースの実態とが少しずつ乖離していくこと──は、エージェントのワークフローにおける最も静かなバグです。症状は、もう使われていないパターンを参照した、微妙に間違ったコードをエージェントが生み出すことです。原因は規律の欠如です。治療法は容赦のないものです。重要な変更があるたびにパックを更新すること。これを完了の定義に組み込んでください。

次回 ── 第10章「Five-Layer Quality Gate Stack──5層の品質ゲート」 コンテキストが整い、計画が確認されたら、本書の第IV部:品質、セキュリティ、インテリジェントなデバッグでは、避けられないミスを本番到達前に捕まえる仕組みへと話題が移ります。同章では、多層防御のスタック──リンティング、型、セキュリティスキャン、テスト合成、エージェント型E2E──と、各層をチームのリスク許容度に合わせて調整する方法を解説します。


📖 さらに詳しく知りたい方へ

本書の第9章では、コンテキストパックの完全なテンプレート、例つきの3層プロンプト構造、ご自身で実施できるA/Bテストの方法論、3つのアンチパターンと具体的な修正方法、そしてコンテキストのための実践的な品質ゲートとしての1ページ・オンボーディングテストを解説しています。

The Engineering of Intent をAmazonで購入する →(英語版)

2026-04-25

下田 昌平

開発に関するインプットをアウトプットしています。