マルチエージェントアーキテクチャ設計 — Manager Surface で AI チームを統率する
ソフトウェア開発の未来は 1 つの AI がすべてを行うことではなく、複数の特化した AI エージェントが協調し、競争し、相互にレビューすることです。Antigravity の Manager Surface がこの振付を主導します。AI の動作を「見る」だけでなく、主導するコマンド・センターです。
これはエンジニアリング・リーダー、アーキテクト、上級実務家向けプレミアム・レベル・ガイドです。複数の特化したエージェントがゼネラリストを上回る理由、エージェント階層を構成する方法、スケールでの品質のために レビュー駆動開発を活かす方法を探ります。
マルチエージェント > シングルエージェント：専門化論文
複雑な機能を考えます：「Stripe 統合、エラー処理、包括的なテスト付き支払いチェックアウト・フロー構築」
シングル・ゼネラリスト・エージェント：
- 支払いフロー、UI、バックエンド、テストを理解
- 順序立って意思決定：フロントエンド → API → テスト
- 専門化がなく、単一ドメインの深い専門知識がない
- 特化した関心事のレビューと検証が困難
マルチ・エージェント・スペシャリスト・チーム：
- フロントエンド・エージェント：React パターン、Tailwind、アクセシビリティの専門家
- バックエンド・エージェント：API 設計、Stripe 統合、エラー処理の専門家
- テスト・エージェント：Jest、カバレッジ、エッジ・ケースの専門家
- 各エージェントはドメインを深く掘り下げる
差は複合します。フロントエンド・エージェントは Stripe 内部について心配する必要がなく、優れたコンポーネントを書きます。バックエンド・エージェントは「テストを同時に書く」制約なしでより堅牢な API を作成します。各エージェントはピークで動作します。
Manager Surface：オーケストレーション・レイヤー
Manager Surface はあなたのダッシュボード。次を表示します：
- エージェント状態：実行中のエージェント、進行状況、推定完了時間
- 依存関係グラフ：どのエージェントが別のエージェント出力を必要とするか
- コード・レビュー・キュー：人間の承認待機中のエージェント間レビュー
- 並列実行タイムライン：エージェント重複とボトルネック発生箇所の可視化
- 出力インスペクション：任意のエージェントをクリックして生成コード、ログ、検証結果をインスペクト
出力待機するブラックボックス AI システムとは異なり、Manager Surface は AI チームを可視化します。並列化が実際に発生するのを確認。1 つのエージェントが別のエージェント待機中にブロックされるとき発見。必要に応じて介入。
この可視性は大規模プロジェクトに重大です。5 つのエージェント並列実行で 10,000 行コードベースはすべてのエージェント全体で毎分 800 行生成します。オーバーサイトなく、生成されたコードは矛盾に迷路できます。Manager Surface はあなたの管制室です。
AGENTS.md：憲法
Antigravity のすべてのエージェントは単一ドキュメント AGENTS.md に従います。これは彼らが従わなければならない憲法です。
SaaS バックエンド向け AGENTS.md 例：
# Antigravity エージェント憲法
## プロジェクト・コンテキスト
- 製品：リアルタイム分析ダッシュボード
- スタック：Next.js 14、TypeScript、PostgreSQL、Redis
- チーム規模：1（Antigravity を使用するフリーランサー）
## アーキテクチャ原則
- モノレポ構造：apps/（web、api）、libs/（共有）
- API ファースト：すべての機能は API 駆動、プライベート・データのサーバー側レンダリング禁止
- キャッシング戦略：セッション Redis、データベース・クエリ結果 5 分キャッシュ
- イベント駆動：すべての重要な状態変更時にイベント発行
## コード標準
- TypeScript：ストリクト・モード有効
- `any` 型禁止；`unknown` 使用して狭める
- 関数：関数ごと最大 20 行
- 命名：PascalCase コンポーネント、camelCase 関数
- コメント：「何」ではなく「なぜ」を説明
## データベース・パターン
- マイグレーション：機能ごと 1 件、デプロイ後不変
- ID：すべてのプライマリ・キーに UUID v7
- タイムスタンプ：created_at、updated_at すべてのテーブルに
- ソフト削除：`deleted_at` 列パターン使用
## API 標準
- RESTful：標準 HTTP メソッドとステータス・コード
- ページネーション：カーソル・ベース、ページあたり最大 100 項目
- バージョニング：URL パス・バージョニング（v1、v2）
- エラー応答：error_code、message、context 含む
## テスティング
- Jest：最小 80% カバレッジ
- ユニット・テスト：ビジネス・ロジックに集中
- 統合テスト：API → データベース往路
- E2E：重要なユーザー・フロー Selenium
## セキュリティ
- 環境変数：コードにシークレット禁止
- 入力検証：すべての外部入力検証
- SQL インジェクション：常にパラメータ化されたクエリ使用
- 認証：JWT 1 時間有効期限、リフレッシュ・トークン
## パフォーマンス
- API 応答時間：95 パーセンタイル < 100ms
- データベース・クエリ：WHERE 句すべてにインデックス
- キャッシング：キャッシュ・ミスはカスケード禁止
- 監視：すべてのサービスに Datadog エージェント
## デプロイメント
- ステージング：PR マージで自動デプロイ
- 本番：手動承認必須
- ロールバック：前バージョン 5 分切り替え
- 監視：エラー率 > 0.5% でアラートすべてのエージェントは起動時 AGENTS.md を読み取ります。提案ではなく、憲法です。フロントエンド・エージェントがコンポーネント生成するとき、最初に AGENTS.md チェック：「命名規則とは？TypeScript ストリクト・レベル？」テスト・エージェント AGENTS.md 読み取り：「最小カバレッジとは？どのパターンをテスト？」
リモート・チームとフリーランサーにとって、AGENTS.md はあなたの運用コードブック。デプロイするすべての AI エージェントにアーキテクチャ決定、ベスト・プラクティス、品質標準を埋め込みます。
親子エージェント階層
Antigravity は階層的エージェント関係をサポート：
Manager（Manager Surface の人間）
├── フロントエンド・エージェント
│ ├── Layout Agent（子）
│ ├── Component Agent（子）
│ └── Style Agent（子）
├── バックエンド・エージェント
│ ├── API Agent（子）
│ ├── Database Agent（子）
│ └── Validation Agent（子）
└── QA Agent
├── Unit Test Agent（子）
├── Integration Test Agent（子）
└── E2E Test Agent（子）
親エージェントは子エージェントに委譲できます。例：
- フロントエンド・エージェント「ログイン・フォーム・コンポーネント必要」
- Component Agent に委譲 → 「LoginForm.tsx 生成」
- Style Agent に委譲 → 「LoginForm Tailwind クラス生成」
- 両方が並列実行
- Component Agent は Style Agent 出力待機して最終化
- 結果は Frontend Agent にバブルアップ
このカスケード構造は大規模プロジェクトを数十のエージェントにファン・アウト、各狭いフォーカス。人間（Manager Surface 上のあなた）が上部で制御状態を保ちます。
Manager Surface vs Copilot Studio
Microsoft の Copilot Studio もマルチエージェント・ワークフロー対応。Antigravity の Manager Surface との比較：
| 側面 | Manager Surface | Copilot Studio |
|---|---|---|
| 主要用途 | スケール・コード生成 | チャットボット・オーケストレーション |
| エージェント通信 | 直接コード共有、プル・リクエスト | メッセージ・パッシング |
| コード・レビュー | エージェント間統合ピア・レビュー | 手動または外部レビュー |
| 視覚的オーケストレーション | リアルタイム依存関係グラフ、並列化 | フローチャート・ベースだが細分化低い |
| AGENTS.md 相当 | 統合憲法システム | 相当なし |
| 速度 | 並列コード生成最適化 | 会話的、順序立った |
| 最適な用途 | 製品開発、コード生成 | カスタマー・サービス、サポート自動化 |
Manager Surface はコード特化。Copilot Studio は会話特化。「20 分で 5,000 行本番コード記述」目標なら Manager Surface 勝利。「複数 AI モデルでチャットボット会話オーケストレーション」目標なら Copilot Studio 勝利。
レビュー駆動開発：QA エージェント・ループ
従来開発：コード → レビュー → 修正 → マージ
Antigravity でのレビュー駆動開発：
- フロントエンド・エージェントが React コンポーネント生成
- テスト・エージェントが自動的に Jest テスト生成
- Lint Agent が TypeScript ストリクト・ネスとコード・スタイル確認
- バックエンド・エージェントがフロントエンド・エージェント API 消費パターンレビュー
- セキュリティ・エージェント一般的な脆弱性レビュー
- すべてのピア・レビュー合格後のみコード PR キュー入力
各レビューは自動ですが Manager Surface 上の人間がオーバーライド可能。各エージェント・レビュー・コメント表示。同意しなければオーバーライド—ただし安全ネット残る。
これは従来コード・レビューより高速度。人間レビュアーがコード読み取り待機する（遅い）のではなく、エージェント相互作業ミリ秒でレビュー。
レビュー・チェーン例：
フロントエンド・エージェント出力：
→ テスト・エージェント：「コンポーネント・カバレッジ 92%、15 テスト・ケース生成」
→ Lint Agent：「TypeScript エラー：0、警告：0」
→ バックエンド・エージェント：「API コール すべてタイプ安全、適切なエラー処理」
→ セキュリティ・エージェント：「XSS 脆弱性なし、入力検証存在」
→ [すべてのレビュー合格]
→ コード main にマージ
セキュリティ・エージェント脆弱性フラグ立てたら、フロントエンド・エージェント通知、コード Manager Surface 人間レビュー待機中保持。
実践的例：フルスタック SaaS 機能
Antigravity が「OAuth と 2FA を使用したユーザー認証」を複数エージェント・チームでどう構築するか追跡：
Manager Surface 設定：
- フロントエンド・エージェント 1
- バックエンド・エージェント 1
- テスト・エージェント 1
- セキュリティ・エージェント 1
- DevOps エージェント 1
実行タイムライン：
T+0s：すべてのエージェント開始
フロントエンド：「AGENTS.md 読み取り中...ログイン・フロー構築」
バックエンド：「AGENTS.md 読み取り中...OAuth プロバイダー統合セットアップ」
テスト：「フロントエンド・バックエンド・コード待機中...」
セキュリティ：「脆弱性スキャナー初期化中...」
DevOps：「ステージング環境デプロイメント準備中」
T+120s：フロントエンド完了
フロントエンド：「LoginForm.tsx、OAuthButton.tsx、2FASetup.tsx 生成（45 行）」
テスト：「フロントエンド・テスト記述可能...89 テスト・ケース生成」
バックエンド：「作業中...OAuth トークン、データベース・スキーマ、リフレッシュ・ロジック」
T+180s：バックエンド完了
バックエンド：「Auth API エンドポイント完成（230 行）、2FA ミドルウェア、データベース・マイグレーション」
テスト：「API 統合テスト生成中（156 テスト・ケース）」
セキュリティ：「フロントエンド・バックエンド・コード・スキャン中...」
T+300s：すべてのコード完成
フロントエンド：✓ 45 行
バックエンド：✓ 230 行
テスト：✓ 245 テスト・ケース（92% カバレッジ）
セキュリティ：✓ 脆弱性フラグなし
DevOps：✓ ステージング・デプロイ、スモーク・テスト合格
T+310s：Manager Surface 上で人間がレビュー
要約確認：520 行コード、完全テスト、ステージング・デプロイ
「本番に承認＆マージ」クリック
DevOps エージェント・ロールアウト処理
合計時間：~5 分（通常 2〜3 時間の機能）
並列化は複合。フロントエンド・エージェント作業中、バックエンド思考中。テスト・エージェント 100% コード完成待たず、フロントエンド利用可能になるとテスト開始。セキュリティ・エージェント同時実行。
高度なパターン：カスケード・エージェント、条件付分岐、エラー回復
カスケード・エージェント： 複数の洗練レイヤー必要なら、カスケード・エージェント・チェーン作成：
ドラフティング・エージェント → 洗練エージェント → 最適化エージェント → 最終エージェント
各エージェント前出力置き換えではなく反復し改善。
条件付分岐： コード複雑性に基づき異なるエージェントにルート：
- 機能 < 100 行：SingleFeatureAgent にルート
- 機能 100-500 行：FeatureTeamAgent にルート
- 機能 > 500 行：最初に相談のためアーキテクチャ・エージェントにルート
エラー回復： エージェント失敗または無効コード生成：
- Error Agent 自動トリガー
- Error Agent 失敗分析
- Error Agent 適切な回復エージェント（別アプローチで再試行、人間にエスカレート）にルート
- 出力はワークフロー復帰前検証
収益含意：なぜこれが重要
フリーランサーとエージェンシーにとって、マルチエージェント・アーキテクチャは新しい事業モデル開放：
Antigravity 前：
- 機能構築、テスト、デプロイで 8 時間
- 請求：$200/時間 → 機能 $1,600
- クライアント・キャパシティ：1 日 1 機能
Antigravity マルチエージェント：
- Manager Surface 使用で 20 分機能
- 有効努力：1 時間（レビュー、修正含む）
- 請求：$200/時間 → 機能 $200
- クライアント・キャパシティ：1 日 8 機能
- 日次収益：$1,600（前と同じ）
- ただし 8 クライアント 1 日 1 機能 vs. 1 クライアント 1 日 1 機能で処理
経済学は強力。選択肢：
- クライアント請求額削減し市場シェア獲得
- 価格維持し利益保持、クライアント負荷スケール
- 高複雑性作業（アーキテクチャ、戦略、デザイン）に集中
エージェンシーでは効果さらに劇的。5 人開発チーム 5 人開発アーキテクト 50 AI エージェント方向 50 人開発チームに。スループット倍増。
全体を振り返って：見守るではなく主導
Manager Surface はあなたの役割を「コード記述」から「AI エージェント主導」に変えます。AGENTS.md で標準定義、Manager Surface で実行監督、重要決定レビュー、デリバリー。
エージェント、コード生成速度処理。あなた戦略、品質ゲート、アーキテクチャ決定処理。人間と機械の専門知識両方最大化で協力。
小さく開始。AGENTS.md 定義。単純エージェント・チーム通じて単一機能実行。並列化がおこるのを観察。その後スケール。