The Engineering of Intent 第7章:GenDD実行ループ
本記事は、私の著書The Engineering of Intent(英語版)を1章ずつ読み解くシリーズの第7回です。前回の記事では、オーケストレーション──タスクが十分に機械的であるとき、多数のエージェントがどのように協調して働けるか──を見てきました。この章は本書の第III部:生成駆動開発(GenDD)の幕開けです。すべてをひとつに結びつける方法論、生成駆動開発(GenDD)を扱います。
セレモニーの一式を置き換える5ステップのループ
GenDDは、従来のアジャイルのセレモニーの一式を、より引き締まった5ステップのループに置き換えます。Context(コンテキスト)→ Plan(計画)→ Confirm(確認)→ Execute(実行)→ Validate(検証)。このループはフラクタルです。1行の変更のレベルでも、ひとつの機能のレベルでも、ひとつのスプリントのレベルでも当てはまります。リズムは変わります。構造は変わりません。
第7章では、各ステップを順に見ていき、それを省いたときに何がうまくいかなくなるのかを説明し、完全な例をループ全体に通して検証します。ここでは、その凝縮版をご紹介します。
ステップ1──Context(人間)
人間が種を提供します。これは仕様ではありません──仕様はあとから導き出されます。これは権威ある出発点です。意図、制約、受け入れ基準、そして既存の状態のうち関連する部分です。
良いコンテキストは、範囲がきっちりと絞られています。広すぎれば、エージェントは多くの解釈のうちどれが意図されているのかを推測しなければなりません。狭すぎれば、既存のコードとの衝突を避けるために必要な情報がエージェントに届きません。私のルールはこうです。限られた時間の中で、エージェントが自力で発見することを合理的には期待できないものは、すべて含める。ドメインの語彙、自明ではない制約、手本となるコードへのポインター。モデルがすでに持っている一般知識や、ファイルの配置のように簡単に発見できる事実は省きます。
ステップ2──Plan(AI)
本番コードが1文字でも書かれる前に、エージェントは計画を作成します。番号付きのステップのリスト。変更するファイルの明示的な列挙。前提条件の明記。
良い計画は、驚くほど退屈なものです。コードが存在する前のプルリクエストの説明のように読めます。そしてそれは反証可能でもあります──各ステップは、明記された成果を達成するか、しないかのどちらかであり、人間はコードを1行も読まずにそれを判断できます。
ステップ3──Confirm(人間)
人間は計画を読み、確認するか、修正するか、却下します。ここはループの中でもっともレバレッジの効く瞬間であり、そして大半のチームが投資を怠っている瞬間です。
確認とは、形だけの承認ではありません。意図を検証する能動的な行為です。この計画は実際の目標と整合しているか? 厳格な制約を守っているか? 既存のアーキテクチャを尊重しているか? もし自分がこのプルリクエストの説明を初めて目にするシニアレビュアーだったとしたら、この計画から良い変更が生まれると期待するだろうか?
「確認の段階で見つかったバグは、検証の段階で見つかったバグよりも桁違いに安く済む。計画に費やした5分は、まずい実行で失う30分を救う。計画に費やした30分は、見当違いの機能をデバッグする1週間を救う。」
ステップ4──Execute(AI)
エージェントは、確認された計画を実行します。成熟したワークフローでは、このステップに人の手はかかりません。人間は見守っていませんし、エージェントも不要な質問をしません。実行によって、差分、それに対応するテストの更新、そして必要なドキュメントの変更が生み出されます。完全で、レビュー可能な成果物が出てくるのです。
計画が想定していなかったもの──存在しないファイル、足りない依存関係、変更前からすでに壊れていたテスト──に遭遇したら、エージェントは黙って適応するのではなく、立ち止まって問題を提示すべきです。黙って適応するところから、ドリフトが生まれます。このループは、想定外の事態を人間のもとへ持ち帰るように設計されています。
ステップ5──Validate(人間+AI)
検証は、自動化されたものでもあり、人間によるものでもあります。自動化された部分では、品質ゲートのスタック(第10章「Five-Layer Quality Gate Stack──5層の品質ゲート」)を実行します。人間の部分は、第2章「認知負荷と物質的離脱」で紹介した印象主義的スキャニングです。両方を通過して初めて、変更はマージされます。
検証は、Confirmに次いで2番目に投資が不足しているステップです。検証を「テストは通ったか?」として扱うチームは、要点を外しています。検証における人間の仕事は、メタレベルのチェックです。私たちは正しいものを検証したのか?
1時間のサイクルから10分のサイクルへ
この最後の点が重要です。GenDDはエージェントを速くするためのものではありません。人間の時間を、それが複利で効いてくる場所──最初のConfirmと、最後のValidate──に投資し、その間を速く走らせるためのものです。Executeを速くしようとするチームは、オートコンプリートの罠にはまります。ループの両端に投資するチームは、負債を抱えることなく、望んでいた速度を手に入れます。
次回 ── 第8章「AIアーキテクチャの四本柱」 GenDDのループは、4つのアーキテクチャ上の基本要素──Vibes、Specs、Skills、Agents──の上に成り立っています。そして大半のチームは、ひとつの柱に過剰に投資し、ほかの柱への投資が不足しています。第8章は、自分たちにどの柱が足りないのかを見極め、どうバランスを取り直すかについての章です。
📖 さらに詳しく知りたい方へ
この章では、完全な例を5ステップのループの最初から最後まで通して検証し、良い計画と悪い計画の具体的な構造の違いを示し、検証におけるメタレベルのチェックを詳しく扱い、そしてサイクルタイムの改善前後の内訳を含む決済チームのケーススタディの全容を紹介しています。
下田 昌平
開発に関するインプットをアウトプットしています。カテゴリー
タグ
検索ログ
開発・技術相談
システム開発や技術検証、要件定義の作成、アーキテクチャ設計、 テスト設計、運用設計まで、一気通貫で支援しています。 企画段階の「まず相談したい」レベルから、実装・運用まで 幅広く対応できますので、お気軽にお問い合わせください。
お問い合わせ