The Engineering of Intent 第8章:AIアーキテクチャの四本柱
本記事は、私の著書The Engineering of Intent(英語版)を1章ずつ読み解くシリーズの第8回です。前回の記事では、生成駆動開発(GenDD)の5ステップの実行ループを順に見ていきました。本章のテーマは、そのループの土台となる4つのアーキテクチャ上の基本要素──そして、ほとんどのチームがそのうちのひとつに過剰投資し、残りをおろそかにしてしまうという問題です。
4つの柱。異なる半減期。異なる失敗モード。
現実の荒波を乗り越えて生き残るAIネイティブなプロジェクトは、振り返ってみると、どれも同じ4つのアーキテクチャの柱を備えています。Vibes、Specs、Skills、Agentsです。それぞれが異なる半減期、異なる読み手、異なる失敗モードを持っています。このバランスを誤ることこそ、AIネイティブなチームが6か月目や9か月目に失速する最もよくある原因です。
Vibes ── プロトタイプ層
Vibesは、アイデアが仕様に昇格する資格を得る前に置かれる場所です。スケッチ、ノートブック、使い捨てのスクリプト。その目的は、最大速度での探索です。Vibesにあるものは、まずSpecとして表現し直さない限り、決して本番に漏れ出してはいけません。
最もよくある間違いは、うまくいったプロトタイプを本番コードとして扱うことです。プロトタイプがうまくいったのは、本番が課すあらゆる制約を無視したからこそです。出荷すべきは洞察であって、コードではありません。
Specs ── 契約層
Specsは、人間とエージェントのあいだの契約です。AGENTS.md、CONVENTIONS.md、ARCHITECTURE.mdに書き込まれるのが、まさにこれです。Specsは最新で、正確で、強制されていなければなりません。古くなったSpecは、Specがないよりも悪いのです。エージェントはそれを正しいものとして扱うからです。
ここでの規律は「コードより先にSpec」というルールです。関連するSpecsが更新されるまで、どんなコード変更も完了とはみなしません。これを完了の定義に組み込んでください。乖離を計測してください。古くなったセクションは四半期ごとに廃止してください。
Skills ── 再利用可能な能力
Skillsは、エージェントが呼び出せる、モジュール化された組み合わせ可能な能力です。AIネイティブ版のライブラリと言えますが、メタデータはより豊富です。説明、例、事前条件、評価。良いSkillは見つけやすく、範囲が狭く、組み合わせやすいものです。悪いSkillは一枚岩で、中身が見えず、明文化されていない前提に縛られています。
Agents ── 実行層
Agentsは、意図が行動に変わる場所です。Agentは、モデルとSkillsのセット、そしてタスクを組み合わせたものです。Agentsの範囲は狭くあるべきです──仕事の種類ごとにひとつのエージェント。責任範囲が広く曖昧なエージェントは予測不能な振る舞いをし、デバッグも困難です。責任範囲が狭く明確なエージェントは、土台のモデルが不完全であっても信頼できます。
健全なサイクルと、倍のコストがかかる近道
4つの柱は独立していません。アイデアが昇格に値すると、VibesはSpecsへと流れ込みます。SpecsはSkillsの設計の拠りどころになります。SkillsはAgentsによって使われます。健全なサイクルは時計回りです。
「不健全なモードとは、VibesからAgentsへ直行する近道です──SpecsとSkillsを丸ごと飛ばしてしまうのです。あらゆる近道は今日を加速させ、次の四半期に倍のコストを請求してきます。」
私が監査するAIネイティブなチームのほとんどが、同じ不均衡を抱えています。Agentsは過剰に発達し、Specsは未発達、Skillsはほぼ存在せず、Vibesは存在しない(安全にプロトタイプを作る場所がない)か、あらゆる場所にある(プロトタイプを昇格させる規律がない)かのどちらかです。リバランスはたいてい3〜6週間のプロジェクトで、その後何年にもわたって複利のリターンを生みます。
次回 ── 第9章「アドバンスト・コンテキストエンジニアリング」 Specsが契約層だとすれば、コンテキストはエージェントが毎ターン実際に読むものです。同章では、コンテキストパック、階層型プロンプト(Layered Prompt)、コンテキストの経済学、そして新しいコントリビューター(人間でもエージェントでも)を1日で戦力にする、1ページのオンボーディング資料の設計方法を扱います。
📖 さらに詳しく知りたい方へ
本書の第8章では、各柱の完全なヘルスチェック、柱同士の相互作用図、最もよくある3つのリバランスのパターン、そしてリグレッション率を80%削減した柱のリバランスのケーススタディを解説しています。
下田 昌平
開発に関するインプットをアウトプットしています。カテゴリー
タグ
検索ログ
開発・技術相談
システム開発や技術検証、要件定義の作成、アーキテクチャ設計、 テスト設計、運用設計まで、一気通貫で支援しています。 企画段階の「まず相談したい」レベルから、実装・運用まで 幅広く対応できますので、お気軽にお問い合わせください。
お問い合わせ