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は一枚岩で、中身が見えず、明文化されていない前提に縛られています。

💡 ポイント: Skillsカタログの成熟度は、AIネイティブなチームの成熟度を示す先行指標です。簡潔でよくドキュメント化されたSkillを20個持つチームは、ひとつも持たないチームの2〜3倍の速度で出荷します。テストカバレッジを追うのと同じように、これを追跡してください。

Agents ── 実行層

Agentsは、意図が行動に変わる場所です。Agentは、モデルとSkillsのセット、そしてタスクを組み合わせたものです。Agentsの範囲は狭くあるべきです──仕事の種類ごとにひとつのエージェント。責任範囲が広く曖昧なエージェントは予測不能な振る舞いをし、デバッグも困難です。責任範囲が狭く明確なエージェントは、土台のモデルが不完全であっても信頼できます。


健全なサイクルと、倍のコストがかかる近道

4つの柱は独立していません。アイデアが昇格に値すると、VibesはSpecsへと流れ込みます。SpecsはSkillsの設計の拠りどころになります。SkillsはAgentsによって使われます。健全なサイクルは時計回りです。

「不健全なモードとは、VibesからAgentsへ直行する近道です──SpecsとSkillsを丸ごと飛ばしてしまうのです。あらゆる近道は今日を加速させ、次の四半期に倍のコストを請求してきます。」

⚠ 注意: 私がアドバイスしていたある成長段階の企業は、Agentsが強くSpecsが弱い状態でした。機能は速く出荷できましたが、毎月、前の月に出荷したものを何かしら壊していました。3週間かけてSpecを再構築したところ──実際のアーキテクチャを文書化し、ルールを明文化し、それをゲートスタックで強制したところ──リグレッション率が80パーセント下がりました。Agentsは何も変わっていません。SpecsがようやくAgentsに追いついたのです。

私が監査するAIネイティブなチームのほとんどが、同じ不均衡を抱えています。Agentsは過剰に発達し、Specsは未発達、Skillsはほぼ存在せず、Vibesは存在しない(安全にプロトタイプを作る場所がない)か、あらゆる場所にある(プロトタイプを昇格させる規律がない)かのどちらかです。リバランスはたいてい3〜6週間のプロジェクトで、その後何年にもわたって複利のリターンを生みます。


次回 ── 第9章「アドバンスト・コンテキストエンジニアリング」 Specsが契約層だとすれば、コンテキストはエージェントが毎ターン実際に読むものです。同章では、コンテキストパック、階層型プロンプト(Layered Prompt)、コンテキストの経済学、そして新しいコントリビューター(人間でもエージェントでも)を1日で戦力にする、1ページのオンボーディング資料の設計方法を扱います。


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

本書の第8章では、各柱の完全なヘルスチェック、柱同士の相互作用図、最もよくある3つのリバランスのパターン、そしてリグレッション率を80%削減した柱のリバランスのケーススタディを解説しています。

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

2026-04-24

下田 昌平

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