【実践ガイド】Claude Code×Antigravity併用ワークフロー完全解説｜複数エージェントを効率的に回すコツ

【実践ガイド】Claude Code×Antigravity併用ワークフロー完全解説｜複数エージェントを効率的に回すコツ

本記事では、Claude CodeとAntigravityを組み合わせて、複数エージェントを効率的に回すための実践的なワークフロー

を解説します。単にツールの機能紹介に留まらず、実際の開発・業務フローにどう組み込めば生産性が最大化できるかにフォーカスします。

1. Claude CodeとAntigravity併用の全体像

1-1. Claude Codeの役割

Claude Codeは、エディタと統合されたコード特化型エージェントです。主な特徴は以下の通りです。

• コードベース全体を読み込み、文脈を理解した上で提案してくれる
• ファイル編集・リファクタリング・バグ修正など、実作業を伴うタスクに強い
• テストコード生成、型定義の補完など、既存コードを壊さずに拡張するのが得意

要するに、Claude Codeは「実際に手を動かしてくれるペアプロ相手」のようなポジションです。

1-2. Antigravityの役割

一方のAntigravityは、複数エージェントをオーケストレーションするプラットフォームとしての役割を持ちます。

• タスクを細かく分割し、目的別のエージェントに自動で振り分けできる
• 各エージェントのアウトプットをまとめて、人間がレビューしやすい形に整える
• 企画・調査・設計・ドキュメント作成など、コード以外の知的作業を並列化できる

つまりAntigravityは「プロジェクト全体を管理するディレクター兼PM」のような存在です。

1-3. 2つを組み合わせると何が変わるか

Claude Code単体でも十分強力ですが、Antigravityと組み合わせることで次のようなシナジーが生まれます。

• Antigravityが要件整理・タスク分解・仕様書作成を担当
• Claude Codeが具体的なコード編集・テスト・リファクタリングを担当
• タスクの前後関係（例：API設計 → 実装 → テスト → ドキュメント化）が自動的に整流化される

結果として、人間は「意思決定」と「レビュー」に集中できるようになり、プロジェクトのスループットが大幅に向上します。

2. 複数エージェントを効率的に回す基本原則

2-1. まず「役割」を明確に分ける

複数エージェント運用のコツは、人間とエージェント、それぞれの役割をはっきり分けることです。

• 人間：ゴール設定、優先順位、最終レビュー、リスク判断
• Antigravity：タスク分解、情報収集、案出し、ドラフト作成
• Claude Code：コード編集、リファクタリング、テストコード生成、実装の具体化

最初にこの「役割分担」を決めておくことで、プロンプトがぶれにくくなり、エージェント同士の衝突も減ります。

2-2. タスクは「単一目的＋明確な入出力」にする

複数エージェントを効率的に回すには、タスクを小さく・単純に・明確にする必要があります。具体的には：

• 目的：このタスクで何を達成したいのか（例：API仕様のドラフトを作る）
• 入力：どの情報を前提にするか（例：既存のDBスキーマ、要求一覧）
• 出力：どのフォーマットで成果物を返してほしいか（例：OpenAPI形式、Markdownテーブル）

1タスク1目的を徹底することで、Antigravity上でのタスク管理がシンプルになります。

2-3. 「並列」と「直列」を上手く切り分ける

エージェントを増やすときに重要なのが、どこまで並列化できるかの判断です。

• 並列できる例：
  – 画面ごとのUIコピー案の作成
  – 競合サービスのリサーチと、テックスタックの調査
  – 仕様の言語別ドキュメント（日本語版と英語版）の作成
• 直列にすべき例：
  – DB設計 → API設計 → 実装 → テストコード生成
  – ユースケースの整理 → 画面遷移図の作成 → コンポーネント設計

Antigravityでは、この「並列タスク」と「依存関係のあるタスク」を意識的に分けることで、全体のリードタイムを短縮できます。

3. Claude Code×Antigravityの実践ワークフロー（ステップ別）

3-1. ステップ0：プロジェクトのゴールと制約条件を決める

最初に人間側で以下を整理します。

• 最終的なゴール（例：新規Web機能のβ版を2週間でリリース）
• 期限・予算・使用技術スタック
• 品質基準（例：テストカバレッジ、パフォーマンス要件）

これをAntigravityに渡す「プロジェクトブリーフ」としてまとめておくと、以降のタスク分解がスムーズになります。

3-2. ステップ1：Antigravityでタスク分解＆全体設計

次にAntigravityに対して、ブリーフを渡し、大まかなタスク分解と全体アーキテクチャ案を生成させます。

• 機能一覧の洗い出し
• 画面ごとの要件とユースケース
• データモデルとAPIのラフ設計
• 実装順序（マイルストーン）の提案

ここでは「とりあえず案を出させる」ことに集中し、人間はレビューと修正指示に専念します。

3-3. ステップ2：Claude Codeでコードベースを準備

設計の方向性が固まったら、Claude Codeの出番です。

• 既存リポジトリを読み込ませ、構造を把握させる
• 不足しているベースコード（ディレクトリ構成、ベースコンポーネントなど）をClaude Codeに生成させる
• Antigravityで決まったAPI仕様やデータモデルをもとに、型定義やInterfaceを一気に用意する

この段階では、「後から拡張しやすい骨組み」を作ることを意識します。

3-4. ステップ3：並列タスクをAntigravityで一気に回す

骨組みができたら、Antigravityで並列化できるタスクを一気に流します。

• 画面ごとのコピー・マイクロコピー案の生成
• バリデーションルールの整理と、エラーメッセージ案
• ユーザーフロー図のテキストベース草案
• テクニカルリサーチ（使用ライブラリの比較表など）

ここでは「コード以外のテキスト作業」をAntigravityに任せ、人間は要所だけ確認します。

3-5. ステップ4：Claude Codeで実装とテストを高速化

Antigravityで固まった仕様・文言をもとに、Claude Codeで実装を進めます。

• コンポーネント実装（UIロジックを含む）
• APIコールの実装とエラーハンドリング
• テストコードの自動生成（ユニットテスト・E2Eテストの雛形）
• リファクタリング提案と不要コードの削除

Claude Codeには、「どのファイルをどう変えたいか」を具体的に伝えると精度が一気に上がります。Antigravityでまとめた仕様を、そのままプロンプトに貼り付けるのも有効です。

3-6. ステップ5：レビューとドキュメントもエージェントに手伝わせる

最後に、品質を担保するための作業もエージェントに分散します。

• Claude Code：変更差分に対するレビューコメント案の生成
• Antigravity：リリースノート、開発者向けドキュメント、ユーザー向けFAQドラフトの作成

人間は、これらのドラフトをチェックし、プロダクトや組織のトーン＆マナーに合わせて調整するだけで済みます。

4. Claude CodeとAntigravityを併用する際のプロンプト設計のコツ

4-1. 「前提」「ゴール」「制約」の3点セットを書く

複数エージェントを使うときほど、プロンプトの構造が重要になります。基本形としては、次の3点を必ず含めます。

1. 前提：既存の状況や使っている技術、関連するファイルなど
2. ゴール：このやりとりで達成したいこと
3. 制約：守るべきルール（フレームワーク、コーディング規約、UIのトーンなど）

これを共通フォーマットとしてテンプレート化し、AntigravityとClaude Codeの両方に同じスタイルで投げると、アウトプットのブレが大幅に減ります。

4-2. エージェントごとに「担当フェーズ」を明示する

プロンプトのどこかで、必ず「あなたはこのプロジェクトの◯◯担当です」と明言しましょう。

• Antigravityには「情報設計・仕様整理担当」
• Claude Codeには「実装・リファクタリング担当」

こうすることで、タスクが混線して「仕様と実装が一度に語られてしまう」問題を避けられます。

4-3. 途中経過を「箇条書き」で返させる

長いタスクや複雑なプロジェクトでは、途中経過をサマリ＋箇条書きで返してもらうよう指示すると、レビューが格段にしやすくなります。

• どのファイルを編集したか
• どの仕様を前提にしているか
• 未解決の疑問点や、判断を保留した箇所

これを常に把握しておくことで、人間側が主導権を持ったままプロジェクトを前に進められます。

5. よくあるつまずきポイントと対策

5-1. エージェント同士の前提がズレてしまう

Antigravityで決めた仕様と、Claude Codeの実装内容が微妙に食い違うケースはよく起こります。

対策としては：

• Antigravity側に「最新版仕様の要約」を常に更新させる
• Claude Codeに作業させる前に、その要約を必ずプロンプトへ貼り付ける
• 定期的に「仕様と実装の差分チェック」タスクを設ける

5-2. タスクが細かすぎて管理コストが増える

タスクを細分化しすぎると、逆に人間のマネジメント負荷が上がってしまいます。

これを避けるために：

• 「1タスク30〜90分相当」を目安にする
• Antigravity側に「細かすぎるタスクを統合する提案」もさせる
• 日次・週次で「完了タスク」と「未着手タスク」を俯瞰する時間を取る

5-3. 人間のレビュー時間がボトルネックになる

エージェントが高速でアウトプットを出す一方、人間のレビューが追いつかない問題も出やすいです。

この場合：

• レビュー観点（チェックリスト）をAntigravityに作らせ、そのフォーマットに沿ってClaude Codeにもセルフレビューさせる
• 人間は「重要度の高い部分」だけを見るようにする（例：セキュリティ関連、外部公開APIなど）
• 小さな変更は「バッチでまとめてレビュー」する運用に切り替える

6. まとめ：Claude Code×Antigravityで「人間の集中を最大化」する

Claude CodeとAntigravityを併用する最大のメリットは、人間がやるべき仕事を極限まで「意思決定」と「レビュー」に絞れることです。

• Antigravity：仕様整理・タスク分解・情報収集・文書ドラフト
• Claude Code：コード編集・実装・テスト・リファクタリング
• 人間：ゴール設定・優先度判断・重要箇所のレビュー

この3者の役割分担が明確になるほど、プロジェクト全体のスピードと品質が両立しやすくなります。複数エージェントを「なんとなく」使うのではなく、ワークフロー単位で設計することが、これからのAI時代の開発・業務における鍵になるでしょう。

この記事の内容を踏まえつつ、まずは小さなプロジェクトからClaude CodeとAntigravityの併用ワークフローを試してみてください。慣れてくると、1人でも小さなチームのような生産性を出せる感覚が掴めるはずです。

動画はこちら：
https://youtu.be/MDKJA5lqELo?si=bX5t8NNeb_ErYWPN