🚀 Antigravity 2.0 初心者向け10の鉄則 — Googleのマルチエージェント基盤を使いこなす

はじめに

Google I/O 2026で一番の衝撃は、新モデルではなく Antigravity 2.0 でした。AI搭載IDEだった1.0から、マルチエージェント・オーケストレーション基盤へと完全に生まれ変わったのです。

内部テストの数字は圧倒的です：

• 93体のエージェントが協調し、260億トークンを消費して複雑なシステムをゼロから構築
• エージェントチームが完全なOSをゼロから構築 — API費用は1,000ドル未満
• Gemini 3.5 Flashが他社の最先端モデルより12倍高速、品質低下なし

Antigravity 1.0が「一人のAIアシスタントを雇う」なら、2.0は「あなたがAI施工チームのプロジェクトマネージャーになる」感覚です。しかし、強力なツールには正しい使い方があります。実践で磨いた10の鉄則を紹介します。

---

🛡️ 鉄則1：審査モードを有効にする — 最初からフルオートにしない

インストール時のモード選択、初心者は必ず**2番目の「レビュー駆動」**を選びましょう：

モード	初心者向け？	意味
セキュア	❌ うるさすぎ	毎回確認が必要
レビュー駆動	✅ これを選ぶ	重要局面で停止、確認待ち
フルオート	❌ 危険	エージェントが暴走、後で被害を発見
カスタム	❌ まだ早い	慣れてから調整

さらに、Settings → Agent → Permissions で git status や ls などの安全コマンドをホワイトリストに登録しましょう。確認ポップアップのストレスが大幅に減ります。

---

📋 鉄則2：常に「計画モード」で提出する

重要な依頼をする前に、入力欄左上のモード切替を 「Planning」 にします。

あなたの入力：「ECサイトのホームページを作って」
↓
エージェントがまず出力：
┌─────────────────────────────┐
│ Implementation Plan          │
│ 1. プロジェクト構造を作成     │
│ 2. ルーティング設定          │
│ 3. 商品リストコンポーネント   │
│ 4. カート機能               │
│ 5. ブラウザテスト            │
└─────────────────────────────┘
      ↑ ここで確認。違ったら修正。

コードを書く前に方向性を確認できる — これは後で修正するより10倍効率的です。

---

💬 鉄則3：成果物に直接コメントする — プロンプトを書き直さない

AntigravityはGoogle Docsのようなレビュー体験を提供します。気に入らない部分があったら、新しいプロンプトを書くのではなく、成果物に直接コメントします：

エージェントがコードを生成

あなたのコメント（成果物に直接記入）：
→ 「ここはFastAPIを使って」
→ 「DB呼び出しにエラーハンドリングを追加」
→ 「SQLiteに保存、インメモリじゃなくて」
→ 「新しい認証コンポーネントは作らないで、既存のを使う」

エージェントはコメントされた部分だけ修正します。プロンプトを書き直すより3〜5倍速く、正しかった部分はそのまま残ります。

---

🔀 鉄則4：並列エージェントはファイル領域を分ける

複数エージェントを同時実行する際の最大の罠：2体が同じファイルを触ること。Antigravityにはマージ競合の解決機能がなく、後から書き込んだ方が静かに上書きします。

解決策はシンプル：

Agent 1 → /api/ だけ担当（バックエンド）
Agent 2 → /components/ だけ担当（フロントエンド）
Agent 3 → /tests/ だけ担当（テスト）

絶対に相手の領域を触らせない！

指示は自然言語で：「エージェントAはバックエンドAPIを書いて、/api/に保存。エージェントBはフロントエンドを書いて、/components/に保存。互いのフォルダには触らないで。」

---

📝 鉄則5：学んだことは即座にルール化する

Antigravityはセッションを越えて記憶しません。コメントで20分かけて教えた内容も、ウィンドウを閉じれば消えます。

鉄の掟： 重要なことをエージェントに教えたら、すぐにルールファイルに書き込む。

# .agents/rules/code-style.md

- PythonはPEP 8準拠
- Pydantic v2のmodel_validateを使う（parse_obj禁止）
- APIレスポンスは統一Responseクラスでラップ
- DB接続文字列は環境変数から、ハードコード禁止
- 新機能には必ずテストファイルを付ける

ルールには2つのスコープがあります：

種類	パス	範囲
グローバル	~/.gemini/GEMINI.md	全プロジェクト
ワークスペース	.agents/rules/*.md	このプロジェクトのみ

---

⚡ 鉄則6：スラッシュでワークフローを召喚する

同じ作業を何度も頼んでいませんか？「テストを生成して」「コードレビューして」「ステージングにデプロイして」— 毎回説明するのをやめましょう。ワークフローを作成します：

# .agents/workflows/generate-tests.md

- 現在のファイルのpytestユニットテストを生成
- 外部依存はモックを使う
- テストファイル名は test_[元のファイル名].py
- 生成後に自動実行してパスを確認

これで入力欄に /generate-tests と打つだけ。段落の説明が一つのスラッシュに。ワークフローはネストも可能 — 複合パイプラインも構築できます。

---

💰 鉄則7：Opusで考え、Geminiで実行する

初心者が一番やりがちなミス：全部Claude Opus 4.5 Thinkingでやる。最も賢いですが、クォータも最も消費します。

正しいパターン：

フェーズ	モデル	理由
計画・設計	Claude Opus 4.5 Thinking	最高の推論力
実装	Gemini 3 Pro (Low)	安くて速い、十分な品質
簡単な修正	Gemini 3 Flash	爆速

Antigravityはタスクの途中でモデル切替が可能 — 右上のパネルから切り替えれば、同じ会話を継続できます。高い頭脳で計画し、効率的な頭脳で実行。結果は同じ、クォータ消費は大幅減。

---

🎯 鉄則8：スキルは説明文が命 — 曖昧だと自動ロードされない

スキルはエージェントの知識パックです。しかしエージェントは全スキルを自動ロードせず、name と description を見て起動判断します。

良い説明：

name: db-migration-guide
description: DBテーブルの追加・変更時に、プロジェクトの
             マイグレーション規約とPrismaワークフローを提供

悪い説明（エージェントは使うタイミングがわからない）：

name: db-stuff
description: データベース関連

公式： 「[トリガー条件]のとき、このスキルは[何をする]ことで[どんな結果]を達成する」

---

🧪 鉄則9：まずPlayground、それからプロジェクト

AntigravityのPlayground機能はアイデアの高速検証専用です。プロジェクト作成も設定も不要。

フロー：

1. アイデアが浮かぶ → 「エージェントにSnakeゲーム作れる？」
2. Playgroundを開き、一文で説明
3. ブラウザが自動で開き、テスト
4. 動いた → 本格プロジェクトに変換
5. ダメだった → 5分で終了、損害ゼロ

Playgroundは実現可能性の検証用。製品レベルの完成を求めないこと。

---

🌐 鉄則10：テストスクリプトを書かずにブラウザテスト

AntigravityはChromeブラウザ制御を内蔵しています。エージェントが自動でページを開き、ボタンをクリックし、スクリーンショットを撮影します。

プロンプトに一文追加するだけ：

「作り終わったらブラウザでテストして、ボタンが動くことと
 データが読み込まれることを確認して」

エージェントが：

1. ページを開く
2. DOM構造を分析
3. 主要な要素をクリック
4. 結果をスクリーンショットで報告

Selenium不要、Playwright不要。フロントエンド初心者にとって、これは革命的です。

---

🎁 ボーナス：初日にやるべき3つのファイル設定

何かを作り始める前に、10分だけ使ってこの3ファイルを設定してください。

グローバルルール（~/.gemini/GEMINI.md）

- パスワードやAPIキーは絶対にハードコードしない
- 全関数にdocstring必須
- 新機能は別ファイルで
- コミット前にテスト実行

プロジェクトルール（.agents/rules/project-rules.md）

- バックエンド: FastAPI + Pydantic v2
- フロントエンド: React + TypeScript, any型禁止
- APIパスは /api/v1 プレフィックス
- DB: Prisma ORM

自動化フック（.agents/hooks.json）

{ "hooks": [{ "event": "on_commit", "action": "run_workflow", "workflow": "run-tests", "filter": "src/**/*.py" }] }

これで毎回の git commit が自動テスト実行付きに。もう意識する必要はありません。

---

まとめ

Antigravity 2.0の本質は「より賢いAI」ではなく、あなたがプロジェクトマネージャーになり、エージェントが施工チームになること。この10の鉄則を身につければ、Antigravityを使うのではなく、Antigravityを指揮できるようになります。