Antigravity ユーザーガイド

Antigravity は、Google DeepMind の Advanced Agentic Coding チームによって開発された自律型 AI コーディングアシスタントです。ユーザーとのペアプログラミングを通じて、コードベースの調査、設計、実装、テスト、ドキュメント作成などの開発タスクを自律的かつ安全に遂行します。

1. はじめに

Antigravity は、単なるチャットボットではなく、ファイル操作やコマンド実行、ウェブ検索、ブラウザ操作、さらにはサブエージェントの作成・管理といった各種ツールを統合した「エージェント（Agent）」です。複雑な指示に対しても自律的に解決へのアプローチを検討し、計画的にタスクを完了させることができます。

2. 主な機能とコンセプト

2.1. 計画モード (Planning Mode)

大規模なリファクタリングや新規機能開発など、影響範囲が広いタスクや複雑なタスクを依頼された場合、Antigravity は自動的に「計画モード（Planning Mode）」へと移行します。

調査 (Research): コードベースやドキュメントを調査し、変更箇所を特定します（このフェーズではソースコードの書き換えは行いません）。
実装計画の作成 (Implementation Plan): implementation_plan.md というアーティファクトを作成し、変更対象のコンポーネントや検証方法をまとめます。
ユーザーの承認: ユーザーから実装計画の承認を得て初めて、実際のコード修正に移ります。
タスク管理 (Task List): 実行フェーズに入ると、task.md に TODO リストを作成して進捗を管理します。
変更の検証とウォークスルー (Walkthrough): 実装が完了したら walkthrough.md で修正内容をまとめ、検証結果を報告します。

Note

調査タスクや、ごく単純なバグ修正（タイポの修正、設定の微調整など）については、計画モードを通さずに直接実行される場合があります。

2.2. アーティファクト (Artifacts)

アーティファクトは、タスクの進捗、設計計画、実行レポートなどを記述した構造化 Markdown ドキュメントです。アプリケーションデータディレクトリ（後述）内に生成され、ユーザーはチャット UI 等を通じてこれらの情報を確認・レビューできます。

主なアーティファクト：

implementation_plan.md: 技術的な実装アプローチ、ユーザーへの確認事項、検証計画
task.md: タスクの進捗チェックリスト
walkthrough.md: 実装完了後の変更サマリーとテスト結果

2.3. サブエージェント (Subagents)

重いタスク（並行した広範囲のコード調査や、独立したモジュールの実装など）を効率化するため、Antigravity は自身から子エージェント（サブエージェント）を呼び出すことができます。

research: 読み取り専用ツールを装備し、コードベースや Web 調査に特化したエージェント。
self: メインエージェントと同等の権限（ファイル書き込みやコマンド実行）を持ち、独立したコンテキストで並行処理を行うエージェント。
カスタムサブエージェント: 必要に応じて、独自の役割やシステムプロンプトを持つサブエージェントを動的に定義（define_subagent）して呼び出すことも可能です。

2.4. スラッシュコマンド (Slash Commands)

チャット UI で利用できる便利なショートカットコマンドです。Antigravity から提案された場合に、ユーザーが実行をトリガーできます。

/goal: 長時間実行されるタスクを設定し、エージェントが目標を達成するまで自律的に作業を継続させます。
/schedule: 定期的なタスク実行や、ワンタイムタイマーをセットします。
/browser: Web サイトの確認や対話的ブラウジングが必要なタスクを開始します。
/grill-me: エージェントからの詳細なインタビューを通じて、実装方針やデザイン決定のすり合わせを行います。

3. 設定ファイルとプロジェクト構成

プロジェクトのルートディレクトリに配置される各種ファイルと、その役割は以下の通りです。

3.1. `GEMINI.md`

プロジェクト固有のルールや規約を記述するファイルです。Antigravity は動作を開始する前に必ずこのファイルを読み込み、指定された指示（ドキュメントの配置場所や命名規則など）を厳格に遵守します。

3.2. `.geminiignore`

Git の .gitignore と同様の役割を持ち、Antigravity が読み込みや検索の対象から除外すべきファイルやフォルダを指定します。ビルド生成物や一時ファイル、大規模なデータセットなどを指定して、探索のノイズを減らします。

3.3. `.mcp.json`

Model Context Protocol (MCP) の設定ファイルです。エージェントが利用できる追加の外部ツールや API サーバーがある場合、このファイルで接続設定を行います。

3.4. アプリケーションデータディレクトリ

会話履歴や実行ログ、一時的なスクラッチファイルは以下のローカルパスに保存されます。

パス: ~/.gemini/antigravity
- 会話ログ: ~/.gemini/antigravity/brain/<conversation-id>/.system_generated/logs/transcript.jsonl
- アーティファクト: ~/.gemini/antigravity/brain/<conversation-id>/
- スクラッチファイル: ~/.gemini/antigravity/brain/<conversation-id>/scratch/

スクラッチファイル（Scratch Files / Scripts）について

エージェントが一時的な動作検証やデバッグを行うために作成する、使い捨てのスクリプトやデータファイルです。

デバッグスクリプト: コードベースに直接変更を加える前に、一時的なスクリプトを書いて挙動を確認します。
テスト用データ: テスト実行に必要な一時ファイルなどを配置します。
永続性: 作成されたスクラッチファイルは、会話（セッション）が終了した後もディレクトリ内に残るため、必要に応じて後から内容を確認できます。

4. 基本的なワークフロー

graph TD
    A[ユーザーの依頼] --> B{複雑なタスクか？}
    B -- Yes (要計画) --> C[調査 & 実装計画の作成]
    C --> D[ユーザーによる計画の承認/修正指示]
    D -- 承認 --> E[タスクリストの作成 & 実装開始]
    E --> F[自動テスト / 動作確認]
    F --> G[ウォークスルーの作成 & 完了報告]
    B -- No (シンプル/調査) --> H[直接実行/回答]
    H --> I[結果報告]

ステップ 1: タスクの指示

チャットで自然言語を使って指示を出します。

例:

「src/utils.js に日付フォーマット関数を追加して、テストを書いてください」

「ビルドが通らない原因を調べて修正してください」

具体的な指示: 修正対象のファイルパスや期待される動作、使用したいライブラリなどを明示すると、より正確な計画が作成されます。
ルール（GEMINI.md）の活用: コーディング規約やドキュメント規約がある場合は、プロジェクトルートの GEMINI.md に記述しておくと、エージェントが自動的にそれに従います。
コマンド実行のレビュー: Antigravity がコマンド実行の許可を求めてきた際は、特に破壊的なコマンドや外部通信が発生するコマンドではないか、内容を確認してから承認してください。
会話ログの参照: 過去のエージェントの思考プロセスや実行されたツールの詳細を知りたい場合は、アプリケーションデータディレクトリ配下の transcript.jsonl を参照することで、詳細な履歴を確認できます。