第4章 §2-B

第4章 §2-B・マルチエージェントチーム実習

空の実習フォルダから始めてAntigravity(Desktop)/Antigravity CLIを中心にシナリオを一つずつ実践していく実習ガイド — Desktopアプリを基準に案内し、続けてCLI対応を紹介する  |  ← 第4章 §1 リファレンス文書に戻る

対象バージョン/範囲Antigravity CLI (agy) 1.1.0+、Antigravity 2.0 — Antigravityを中心に案内し、Claude Desktop App/Code対応は第4章 §2-Aを参照
このファイルの目的サブエージェントの定義・呼び出し、順次パイプライン、動的チーム構成・ワークフローの組み合わせ、並列実行をAntigravity(Desktop)/Antigravity CLI中心に手を動かして実践する4段階の実習を提供
リファレンス文書第4章 §1 共通・第4章 §1-A Claude詳細・第4章 §1-B Antigravity詳細 — 各シナリオからリンクで接続されます
作成日2026年7月14日
この全課程が従う原則 — 特定のツール一つに合わせて実習を覚えると、別のツールに移るときにまた最初から学び直さなければならない。だから以下のすべてのシナリオは、まずサブエージェントの役割をツール中立的なAGENTS.md仕様として書き、その同じ仕様をAntigravity系では自然言語の目標として「実装」する順序に従う(第2章 §5 AGENTS.md参照)。Claude系での対応方法は第4章 §2-Aで扱う。定義は一つ、実行方式だけがツールごとに異なるという原則を手を動かして確認することが、この実習の中心的な目標である。

準備: 必要なプログラムのインストール

以下の実習はAntigravity(Desktop)とAntigravity CLI(agy)を中心に進める。ローカル環境にこれらのツールがまだない場合は、このハンドブックに同梱されている環境設定自動化ツールであるsetupガイドが、この章の実習に正確に必要な構成を自動でインストールしてくれる。案内に従ってスクリプトをダウンロードし、ローカルで実行すればよい。

📦 インストール前の確認事項

スクリプトを実行する前に事前インストールチェックリストを先に読んでおく。この文書には次の前提条件がまとめられている。

  • Antigravity利用のためのGoogleアカウント(個別APIキーではなく、サブスクリプション/アカウントベースのプランであること)
  • gh auth loginを実行できるGitHubアカウント
  • 最低5GBの空きディスク容量
  • 管理者(admin)またはsudo権限
まだGitHubアカウントがない場合
① ブラウザでgithub.com/signupにアクセスする。
② メールアドレス、パスワード、ユーザー名(username)を入力する — usernameは後でリポジトリURL(github.com/<username>/...)にそのまま使われるため、慎重に決める。
③ 自動登録防止のためのパズル/コード認証を通過する。
④ 登録時に入力したメールに届いた認証メールを開き、メール認証を完了する — このステップを飛ばすと、以降gh auth loginやリポジトリ作成が阻まれることがある。
⑤ 無料(Free)プランで登録すれば十分である — このハンドブックの実習・PR練習には有料プランは不要。
登録が終わるとGitHub CLI(gh)が上記のインストールスクリプトに含まれて一緒にインストールされ、下記のgh auth loginコマンドでターミナルをそのアカウントに接続する。 
gh auth login
# 案内に従って: GitHub.comを選択 → HTTPSを選択 → ブラウザでログイン(推奨)を選択
# ブラウザが開いたら、先ほど作成したアカウントでログインし、認証コードを確認する

Windowsでのインストール

このハンドブックのパス表記はWindows基準のため、Windowsユーザーは以下のコマンドで5throck/setupリポジトリをクローンし、PowerShellを管理者権限で実行した後、続くコマンドを実行する。

PowerShellを管理者権限で開く方法
① スタートメニューを開き、PowerShellを検索する。
② 検索結果の「Windows PowerShell」を右クリックする。
③ 表示されるメニューから「管理者として実行」を選択する。
④ ユーザーアカウント制御(UAC)ウィンドウが表示されたら「はい」を押して承認する。
ウィンドウのタイトルバーに管理者: Windows PowerShellのように「管理者」が付いていれば正しく開けている。wingetインストールなど一部のステップは、管理者権限なしで実行するとエラーになったり黙ってスキップされたりすることがある。 
git clone https://github.com/5throck/setup.git
cd ./setup
.\setup-windows.ps1
# 選択オプション: -WSL2, -WezTerm, -Docker, -Force (すでにインストール済みのツールも再インストール)

スクリプトが終わったら、ターミナルを完全に閉じて再度開く必要がある。PATHの変更が反映されるためだ。

macOS / Linuxでのインストール

以下のコマンドで5throck/setupリポジトリをクローンして使用する。macOSはsetup-mac.sh、Linuxはsetup-linux.shを実行し、どちらも--wezterm、--dockerの選択フラグをサポートする。

git clone https://github.com/5throck/setup.git

# macOS
cd ./setup && bash setup-mac.sh

# Linux
cd ./setup && bash setup-linux.sh

インストールの検証

OSにかかわらず、setup-common.tsをbunで実行すると、インストール状態を点検するチェックリスト表が出力される。すべての項目が✅で表示されれば、以下の実習を進める準備が整ったことになる。

cd ./setup && bun setup-common.ts

このプロジェクトがインストールするツールのうち、この章の実習に直接関係するものは次の通りである。Antigravity(Desktop)、agy(Antigravity CLI)、そして後の章で使われるgh(GitHub CLI)まで一緒にインストールされる。

Antigravity CLI(agy)は別途ランタイムのインストールが不要な単一コンパイルバイナリである — 解凍後PATHに入れるだけですぐに実行できる。古い資料に残っている「Gemini コマンドラインインターフェース(CLI)をnpmでグローバルインストール」といった案内はもはや有効ではない。最新のインストール方法はantigravity.google/docs/cli/getting-startedで確認する。
インストール中に問題が起きた場合、Windows基準で%USERPROFILE%\workshop-setup-logs\フォルダにログが残る。トラブルシューティングの際はまずこのログを確認する。
● 初級 Getting Started Antigravity(Desktop)で目標を与え、動的生成を観察する最初のステップ
G-1 初級 最初のカスタムサブエージェントを作成して呼び出す
ハーネスを初めて使う開発者が実習専用の空フォルダharness-lab/を新しく作り、reviewer役割をツール中立的なAGENTS.md仕様として先に書いた後、Antigravity(Desktop)で自然言語の目標として「実装」して呼び出してみる。このフォルダは実習専用なので、他のプロジェクトファイルと混ざらない。
使用要素
AGENTS.md (第2章) サブエージェントを定義する サブエージェントを呼び出す
ステップ別実行
  1. ① 実習フォルダの作成と移動

    現在のフォルダの下にharness-labフォルダを新しく作り、その中に移動する。以降のすべてのコマンドはこのフォルダの中で実行する。

    mkdir -p harness-lab
cd harness-lab
  2. ② 共通の役割仕様を作成 — AGENTS.md

    ClaudeでもAntigravityでも、あるいはその他のAGENTS.md標準をサポートするどんなツールで開いても同じ意味で読めるように、reviewer役割をツール依存的な表現を使わず純粋なテキストで書く。このファイル一つが「何をする役割か」の唯一の原本となり、下のAntigravityはこの原本を自然言語の目標として実装するだけである。macOS/Linux/Git Bashでは下記のコマンドをそのまま使う。

    cat > AGENTS.md << 'EOF'
## Agent: reviewer

役割: テキストファイルの誤字脱字、論理的な欠陥、改善点を検討する。
入力: 検討対象のテキストファイルのパス
出力: 誤字脱字・論理的欠陥・改善点のリスト
権限: 読み取り専用 — ファイルを直接修正しない。
EOF

    Windows PowerShellではcatコマンド自体はGet-Contentのエイリアスとしてファイル読み込みにそのまま使える。ただし<< 'EOF'のように複数行を直接入力するheredoc構文はサポートしないため、同じ内容を引用符付きのhere-string(@'...'@)として作成し、Set-Contentでファイルに書き込む。

    @'
## Agent: reviewer

役割: テキストファイルの誤字脱字、論理的な欠陥、改善点を検討する。
入力: 検討対象のテキストファイルのパス
出力: 誤字脱字・論理的欠陥・改善点のリスト
権限: 読み取り専用 — ファイルを直接修正しない。
'@ | Set-Content AGENTS.md
Antigravity (Desktop) — 同じAGENTS.md仕様を自然言語の目標として実装

Antigravityには.claude/agentsのような事前定義ファイルの概念がない。代わりに先ほど作成したAGENTS.mdをワークスペースにそのまま置いた状態で、同じ仕様を目標プロンプトに込めてやる。

  1. ① 検討対象ファイルを事前に用意(ターミナル) 
    echo "このプロジェクトはとても良い。これは非常に良い。" > notes.txt
  2. ② Antigravity Agent ManagerでWorkspaceを作成

    Agent Managerを開き、harness-lab/フォルダ(AGENTS.mdがすでに入っているフォルダ)を指す新しいWorkspaceを一つ作る。

  3. ③ 目標指示 — Workspaceのチャット画面に下記の文章をそのまま貼り付けて送信 
    AGENTS.mdに書かれたreviewer役割仕様通りにnotes.txtを検討して。
    Workspaceを担当するエージェントがAGENTS.mdを読み、その中の役割/入力/出力/権限の仕様をそのまま目標として、必要な作業(ファイルの読み込み、改善点の整理)を自ら判断して実行する。AGENTS.mdが「何を検討基準とするか」の唯一の原本であるため、検討基準(誤字脱字・論理的欠陥・改善点)はこの仕様によって決まる。

Antigravity CLI(agy)でも同じ概念で実習できる — 事前定義ファイルなしで/goalで目標だけを与える。

cd harness-lab && agy
/goal notes.txtファイルを検討して改善点を要約して
Antigravityは定義ファイルがないため、Claude系のようにtoolsフィールドで事前に権限制限をすることはできない。代わりに目標プロンプト自体を「読んで要約だけして」のように明確に絞り込むことが安全である。AGENTS.mdに書かれた権限: 読み取り専用の仕様も、オーケストレーターに権限境界を伝える役割を果たす。
● 中級 Daily Workflow メインセッションがオーケストレーターとなり、writerとreviewerという2つの専門エージェントを順番に指揮する実務パターン
D-1 中級 writer → reviewer 2段階パイプライン
G-1を終えた実務者が、同じharness-lab/フォルダで2つ目の役割writerもG-1と同じ方式でAGENTS.mdに先に仕様を書き、Antigravity(Desktop)で自然言語の目標として実装する。writerが先に草稿を書き、reviewerがその結果を批評するパイプラインを、オーケストレーターが順序を守って指揮するようにする。
ユーザーリクエスト writer.md 草稿作成 修正依頼時はwriterに戻る reviewer.md フィードバック/承認 最終成果物 完成
使用要素
AGENTS.md (第2章) サブエージェントを定義する サブエージェントを呼び出す
ステップ別実行
  1. 共通の役割仕様を追加 — AGENTS.mdにwriter項目を続けて書く

    G-1で作成した同じAGENTS.mdにwriter役割を続けて書く。reviewer項目はそのままにして、下記の内容だけを追加する。macOS/Linux/Git Bashでは下記のコマンドをそのまま使う。

    cat >> AGENTS.md << 'EOF'

## Agent: writer

役割: 与えられたテーマで3〜5文程度の短い草稿を作成する。
入力: テーマ、保存するファイルのパス
出力: 草稿のテキストファイル
権限: 書き込み許可 — 指定されたファイルにのみ保存する。
handoff_to: reviewer (草稿完了後にレビューに引き継がれる)
EOF

    Windows PowerShellではhere-stringをAdd-Contentで追記する(Set-Contentはファイルを上書きするため、reviewer項目が消えないよう必ずAdd-Contentを使う必要がある)。

    @'

## Agent: writer

役割: 与えられたテーマで3〜5文程度の短い草稿を作成する。
入力: テーマ、保存するファイルのパス
出力: 草稿のテキストファイル
権限: 書き込み許可 — 指定されたファイルにのみ保存する。
handoff_to: reviewer (草稿完了後にレビューに引き継がれる)
'@ | Add-Content AGENTS.md
Antigravity (Desktop) — 同じAGENTS.md仕様2つを1つの目標としてオーケストレーターが自ら分解

Antigravityは事前にwriter/reviewerファイルを分けて定義しない。代わりにAGENTS.mdにすでに書いておいた2つの役割仕様(reviewerはG-1で、writerは今しがた)をそのまま参照させる。G-1で作成した同じWorkspaceのチャットで引き続き進める。

  1. ① 2段階の目標指示 — Workspaceのチャット画面に下記の文章をそのまま貼り付けて送信 
    AGENTS.mdのwriter仕様通りにdraft.txtに「リモートワークの利点」というテーマで草稿を先に作成し、完了したらAGENTS.mdのreviewer仕様通りにその草稿を検討して。2つの段階を順番に進めて。
    オーケストレーターがAGENTS.mdのhandoff_to: reviewer関係を読み取り、目標を「草稿作成 → 検討」の2つの下位作業に自ら分解した後、草稿作成が終わってから初めて検討作業を開始する。順序調整の責任がユーザーではなくオーケストレーター内部にあるという点が特徴である — ただし「何を検討基準とするか」はAGENTS.mdが唯一の原本である。

Antigravity CLI(agy)でも同じ目標を一度に与えられる。/goalでパイプライン全体を1つの文章に込めるとオーケストレーターが自動で分解し、必要なら/agentで検討段階をバックグラウンドに任せたまま他の作業を続けることもできる。

agy
/goal draft.txtに「リモートワークの利点」というテーマで草稿を先に書き、
完了したらその草稿を検討して改善点を要約して
D-2 中級 リクエストに応じてチーム構成とワークフローが変わる様子を観察する
第2章 §4bで扱った「動的チーム構成」と「多様なワークフローの組み合わせ」を直接目で確認するシナリオである。D-1で作成したwriter・reviewerという2つの役割仕様はそのままにして、リクエストの性質だけを変えながら、オーケストレーターが実際にどんな作業を、何回、どんな順序で行うかを観察する — サブエージェントの定義は一度も新しく作らないという点が核心である。
使用要素
動的チーム構成と多様なワークフロー
Antigravity (Desktop) — 自然言語の目標だけでも同じ柔軟性が現れる

Antigravityはそもそもサブエージェントを動的に生成する方式であるため、この柔軟性がより直接的に現れる。D-1で使っていた同じWorkspaceチャットで引き続き進める。

  1. ① 単純な目標指示 
    draft.txtの誤字脱字だけざっと見て。
    オーケストレーターは今回のリクエストに作成役割は不要だと判断し、検討役割一つだけをその場で構成する。AGENTS.mdに2つの役割が定義されていても、実際に投入される構成はリクエストごとにオーケストレーターがその都度決定するということを示す、最も単純な例である。
  2. ② 複合的な目標指示 
    draft2.txtに「週4日勤務制」というテーマで新しい草稿を先に書き、完了したらその草稿を文法の観点と論理の観点の2つで、それぞれ独立して同時に検討して。
    オーケストレーターは①では検討役割一つだけをその場で構成し、②では作成役割一つと検討役割二つ(互いに異なる観点)を新しく構成する。事前に定義されたサブエージェントファイルがそもそも存在しないため、「今回の作業に合ったチームを毎回新しく組む」という原則がより鮮明に現れる。
①と②を並べて比較すると、「AGENTS.mdにどんな役割を定義しておいたか」と「今回の作業に実際に投入される構成が何か」が互いに異なる階層であることがはっきりする。前者はAGENTS.mdに事前に固定されているが、後者はリクエストのたびにオーケストレーターが新しく決定する。
あわせて見る: 第2章 §4b — 動的チーム構成と多様なワークフロー、第4章 §1 リファレンス — 並列実行
● 上級 Power User writerとreviewerを独立した2つのファイルに対して同時に動かす並列運用 — Agent Manager活用
P-1 上級 独立タスクの並列実行 — Agent Manager
D-1まで終えた熟練者が、互いに依存しない2つの独立した作業(topic-a.txt、topic-b.txtの草稿作成)をAntigravity(Desktop) Agent Managerで並列に実行してみる。
使用要素
並列実行 — チーム単位に拡張する 並列実行
Antigravity (Desktop) — Agent Manager、Workspaceごとにエージェント1つ

Antigravityを開き、Agent Managerでharness-lab/を指すProjectを一つ用意する。今回は1つのWorkspaceに2つのエージェントを詰め込まず、互いに異なるWorkspace2つを作って、それぞれにエージェントを1つずつ割り当てる。

  1. ① Workspace Aの作成

    New Worktree ModeでWorkspaceを一つ作る。

  2. ② Workspace Aのチャット画面に下記の文章をそのまま貼り付けて送信 
    topic-a.txtに「在宅勤務」というテーマで3〜5文の草稿を作成して。
  3. ③ Workspace Bの作成

    別途のWorkspaceをもう一つ作る(New Worktree Mode推奨)。Workspace Aのエージェントとは完全に分離されたインスタンスである。

  4. ④ Workspace Bのチャット画面に下記の文章をそのまま貼り付けて送信 
    topic-b.txtに「週4日勤務制」というテーマで3〜5文の草稿を作成して。
  5. ⑤ Inboxで2つのエージェントの進行状況を確認

    2つのエージェントがそれぞれのWorkspaceで同時に作業している間、Inboxで承認やフィードバックが必要なメッセージが来ていないか確認し、必要であれば応答する。

2つのエージェントを同じWorkspaceに一緒に割り当てない — 同じフォルダを共有すると、一方のエージェントがもう一方のエージェントの作業コンテキストを自分のものと錯覚する「認知的重複(cognitive overlap)」が発生することがある。WorkspaceまたはworktreeでかならずWorkspaceを分離するのがAntigravityの推奨される慣行である。

Antigravity CLI(agy)でもデスクトップのAgent Managerの代わりにターミナルを複数立ち上げて同じ効果を出せる — 1つのターミナルでagyによりtopic-a.txtの作業を、別のターミナルで独立したagyセッションによりtopic-b.txtの作業を同時に進める(セッション間の並列)。互いに異なるファイルを触っている限り、2つのセッションは衝突しない。

あわせて見る: 第4章 §1 リファレンス — 並列実行

Antigravity CLI (agy) 1.1.0+・Antigravity 2.0基準 | 2026年7月14日作成
← 第4章 §2-A Claude中心実習へ

第4章 §2
Claude (A) Antigravity (B)