Antigravityアーティファクト生成で品質を担保する方法

⚡ 3秒でわかる！この記事のポイント

アーティファクトはAIの作業過程を「見える化」する透明性機能
タスクリスト・diff・スクリーンショットなど複数種類の成果物を自動生成
PRレビューやステークホルダー報告にアーティファクトを添付して信頼性向上

AIコーディングエージェントが自律的にコードを書く時代——便利になった反面、「AIが何をやったのか検証できない」という不安を感じていませんか？

Google Antigravityのアーティファクト生成機能は、この課題に正面から取り組んだ機能です。AIエージェントの作業過程を自動的に記録し、**検証可能な成果物（アーティファクト）**として出力します。

この記事では、アーティファクト生成の基本から、チーム開発での実践的な活用パターンまでを解説します。

アーティファクトとは？Antigravity独自の透明性機能

なぜAIエージェントに透明性が必要なのか

AIエージェントがコードを自動生成・修正する場合、以下のリスクが存在します。

意図しないロジック変更が紛れ込む
セキュリティ上の問題があるコードが生成される
テストが不十分なまま変更がマージされる
「なぜこの実装にしたのか」の根拠がわからない

アーティファクトは、これらのリスクに対する**「監査証跡」**として機能します。AIが何を考え、何を実行し、何を変更したかが明確に記録されるため、人間がレビュー・承認するプロセスを確実に挟むことができます。

アーティファクトの種類

Antigravityが生成するアーティファクトは、主に以下の4種類です。

種類	内容	用途
タスクリスト	AIが実行した作業の一覧	作業内容の全体把握
実装計画	AIが検討した設計方針と選択理由	設計判断のレビュー
diff	変更されたコードの差分	コードレビュー
スクリーンショット	ブラウザ操作の画面キャプチャ	動作確認

特に実装計画アーティファクトは、AIがなぜその実装を選んだのかの根拠が記録されるため、後から設計判断を追跡する際に非常に有用です。

アーティファクト生成の基本設定

Manager Viewでのアーティファクト確認方法

AntigravityのManager View（管理画面）から、生成されたアーティファクトを確認できます。

# Antigravityのセッションを開始
antigravity start --project my-app

# アーティファクトの保存先を指定
antigravity config set artifacts.output ./artifacts

# アーティファクト生成を有効化（デフォルトで有効）
antigravity config set artifacts.enabled true

Manager Viewでは、各タスクに紐づくアーティファクトが時系列で表示されます。

📋 Task: "ログイン画面のバリデーション追加"
├── 📝 Plan: 入力検証ロジックの設計方針（3案比較）
├── 📊 Checklist: 実行した7ステップの一覧
├── 📄 Diff: src/auth/login.ts (+45, -12)
└── 📸 Screenshot: ログイン画面のバリデーション動作

アーティファクトのエクスポートと共有

アーティファクトはMarkdown・JSON・HTML形式でエクスポートできます。

# Markdown形式でエクスポート
antigravity artifacts export --format markdown --output report.md

# JSON形式（CI/CD連携用）
antigravity artifacts export --format json --output artifacts.json

# HTML形式（ブラウザで閲覧可能なリッチレポート）
antigravity artifacts export --format html --output report.html

チームメンバーやステークホルダーとの共有には、HTML形式が最も視認性が高くおすすめです。

実践：アーティファクトを活用したコードレビュー

diffアーティファクトで変更点を把握

AIが変更したコードの全差分が、diffアーティファクトとして自動記録されます。

# artifacts/diff-20260312-task42.md

## 変更概要
ログイン画面にメールアドレスとパスワードのバリデーションを追加

## 変更理由
- ユーザーからの不正入力を防止
- XSS攻撃のリスクを軽減

## 差分
--- a/src/auth/login.ts
+++ b/src/auth/login.ts
@@ -15,6 +15,18 @@
 export async function handleLogin(email: string, password: string) {
+  // Email validation
+  const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+  if (!emailRegex.test(email)) {
+    throw new ValidationError('Invalid email format');
+  }
+
+  // Password validation
+  if (password.length < 8) {
+    throw new ValidationError('Password must be at least 8 characters');
+  }

通常のgit diffとの違いは、変更理由が自然言語で記述されている点です。「なぜこの変更が必要だったのか」がセットで記録されるため、レビューの効率が格段に上がります。

ブラウザ録画で動作確認

Antigravityがブラウザ操作を伴うタスクを実行した場合、スクリーンショットや操作録画がアーティファクトとして保存されます。

これにより、以下のような確認が可能です。

フロントエンドの変更が意図通りに表示されているか
フォームのバリデーションが正しく動作しているか
レスポンシブデザインが崩れていないか

Google Developers Blogでも、アーティファクト機能がAntigravityの透明性を担保する核心機能として紹介されています。

Antigravityアーティファクト生成フロー

チーム開発でのアーティファクト活用パターン

PRレビューへのアーティファクト添付

最も実用的な活用パターンが、PRにアーティファクトを添付することです。

# PR作成時にアーティファクトを自動添付
antigravity pr create --attach-artifacts

# GitHub CLIとの連携
antigravity artifacts export --format markdown | gh pr comment --body-file -

レビュワーは通常のコード差分に加えて、以下の情報を得られます。

AIがどのような設計判断をしたか
検討した代替案は何だったか
テスト結果のサマリー

これにより、「AIが書いたコードだから不安」という心理的障壁が大幅に下がります。

ステークホルダーへの進捗共有

非エンジニアのステークホルダーへの進捗共有にも、アーティファクトが活用できます。

HTML形式のレポートにエクスポートすれば、技術的な詳細を知らない人でも以下が把握できます。

今日完了したタスクの一覧
各タスクのスクリーンショット（ビフォー/アフター）
残りのタスクと見込み工数

アーティファクトのカスタマイズと拡張

デフォルトのアーティファクトに加えて、カスタムアーティファクトを定義することも可能です。

# .antigravity/artifacts.yaml
artifacts:
  - type: custom
    name: "performance-report"
    trigger: "on_complete"
    template: |
      ## パフォーマンスレポート
      - Bundle size: {{ bundle_size }}
      - Lighthouse score: {{ lighthouse_score }}
      - API response time: {{ api_response_time }}

  - type: custom
    name: "security-checklist"
    trigger: "on_complete"
    template: |
      ## セキュリティチェックリスト
      - [ ] 入力バリデーション
      - [ ] 認証・認可チェック
      - [ ] SQLインジェクション対策
      - [ ] XSS対策