The Engineering of Intent 第23章:コンテキストパックのレシピ

本記事は、私の著書The Engineering of Intent(英語版)を1章ずつ読み解くシリーズの第23回です。前回の記事では、実際の一日を実況したセッションを見ました。第23章からは本書の第VIII部:パターンカタログと実例が始まります──その最初の章として、自分の状況に合わせてすぐに使える12のコンテキストパックのレシピを紹介します。


12の状況。12のパック。コピーして、合わせて調整する。

第9章「アドバンスト・コンテキストエンジニアリング」では、コンテキストエンジニアリングこそがAIネイティブ開発において最もレバレッジの効く活動だと論じました。第23章は、その主張を持ち運べる形にします。私が実際にパックを組む状況ごとに12のコンテキストパックのレシピを用意し、それぞれに対象となる状況、含めるファイル、サイズの予算、そして最もよくある失敗モードを示しています。


12のレシピ

  1. グリーンフィールド ── 新規プロジェクトの最初の1週間。3K〜6Kトークン。最大の失敗は、最初に出荷できるインクリメントで仮説を検証する前に、アーキテクチャを決め込みすぎることです。
  2. レガシーなモノリス ── 10K〜15Kトークン。実際に作業が発生する部分をドキュメント化し、暗がりは暗がりのままにしておくと割り切ります。エージェントは不慣れな領域では、手を止めて質問するようにします。
  3. 移行(AからBへ、両者が共存する期間)── 8K〜12Kトークン。古い側を「親切心で」モダナイズしてしまうのを防ぐ、明示的なガードレールを設けます。エージェントにはモダナイズしたがる偏りがあります。
  4. マイクロサービス ── サービスごとに5K〜8K。サービス固有のagents.mdに、共有のconventions.mdを組み合わせます。共有部分は自動化で強制します。
  5. ライブラリ ── 4K〜8Kトークン。public-api.md + invariants.md + 正しい例と誤った例。API設計のタスクでは内部実装は省きます。
  6. セキュリティ重視 ── 6K〜10Kトークン。threat-model.md + forbidden-patterns.md。「安全にして」は実行可能な指示ではありません。
  7. フロントエンド ── 6K〜10Kトークン。デザインシステムのドキュメント + コンポーネントの命名 + 状態管理のルール + 参考コンポーネント3〜5個。
  8. データエンジニアリング ── 6K〜10Kトークン。スキーマ + パイプラインの全体図 + SLA。SLAを省くと、正しいけれど運用上は壊れているパイプラインが出来上がります。
  9. デバッグ ── 4K〜8Kトークン。症状 + 再現手順 + 最近の変更 + 関連するソース + 関係のあるトレース。それ以外はすべて除外します。
  10. リファクタリング ── 5K〜10Kトークン。現在のコード + 具体的なゴール(理想は、別の場所ですでに実施済みの例)+ 呼び出し箇所の一覧。「もっときれいにして」はゴールではありません。
  11. 探索 ── 3K〜5Kトークン。問題 + 制約 + ほかのコードベースにある既存の解決策を2〜3個。エージェントに決めさせてはいけません。
  12. オンボーディング ── 3K〜5Kトークン。1ページの概要 + 初日のタスク + コアモジュールへの案内 + 明示的な「手を止めて質問すべきこと」。
💡 ポイント: サイズの予算は目安ではありません。ガードレールです。レシピごとにコンテキストの経済性は異なり、予算はその状況に何が属するべきかを表しています。パックが予算を超えて膨らもうとするとき、それは何かを伝えています──たいていは、パックを長くする必要があるのではなく、タスクが広がりすぎていて分割が必要だ、ということです。

12のレシピすべての根底にあるパターン

「どのレシピにも、『含めるもの』と同じくらい重要な『含めないもの』のセクションがあります。コンテキストパックの設計で最も難しいのは、何を入れるかではありません。何を外すかです──そして実践で最も良い成果を出すレシピは、最も規律ある除外をしているレシピなのです。」

⚠ 何でも放り込む反射: 迷ったとき、エンジニアはさらに多くを放り込みます。その結果、エージェントは集中するどころか溺れてしまいます。デバッグは、絞り込まれたコンテキストの恩恵をとりわけ大きく受けます──レシピが8Kトークンに制限しているのには理由があるのです。容赦なく削りましょう。

次回 ── 第24章「失敗モード辞典」 第23章が肯定的なパターン・ランゲージだとすれば、第24章は否定的なパターン・ランゲージです──苦境にあるAIネイティブなプロジェクトに助言する中で私が分類してきた、名前のついた失敗モードと、それぞれを出荷前に見抜く方法を取り上げます。


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

本章では、12のレシピそれぞれを完全な形で紹介しています。対象となる状況、含めるファイル、サイズの予算、よくある失敗モード、そして今日の午後にでも自分のリポジトリに取り込める、コピーして調整するためのテンプレートです。

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

2026-05-09

下田 昌平

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