ANTIGRAVITY LABEN
記事一覧/Agents & Manager
Agents & Manager/2026-06-13上級

並列エージェントの変更を、後から追えるようにする設計

Antigravity 2.0 は複数エージェントの管制塔になりました。誰が・なぜ・何を変えたのかを後から追える監査トレイルの作り方を、実運用の失敗から設計します。

AIエージェント31監査レビュー3運用設計9Antigravity 2.02

プレミアム記事

Antigravity 2.0 は、コードを書くエディタから「複数エージェントを同時に監督する管制塔」へと位置づけを変えました。並列で動くサブエージェント、バックグラウンドのスケジュール実行。手数は確かに増えます。

増えた手数の代償は、私の場合は「誰が何をしたのか分からない」という形でやってきました。個人開発で 4 サイトを並列に自動運用していると、ある朝、見覚えのない変更がリポジトリに入っている。エージェントがやったのは間違いないのですが、どのタスクの、どの判断で入ったのかが追えない。これが一番こわい状態です。私自身、Dolice として運用するメディアでこの状態に陥り、原因の特定に半日を溶かしました。

エージェントを増やす前に、変更を後から追える設計を先に入れるべきでした。この記事は、その監査トレイルをどう作るかを、実運用の失敗から逆算して書きます。

追えなくなるのは、意図が記録されないから

エージェントの変更が追えなくなる原因は、差分そのものではありません。差分は git に残ります。失われるのは「なぜその変更をしたか」という意図です。

人間の開発者なら、コミットメッセージや PR の説明に意図を書きます。ところがエージェントは、放っておくと「Update files」のような中身のないメッセージを残しがちです。半年後にそのコミットを見ても、何のための変更だったのか分かりません。

だから監査トレイルの第一歩は、意図を機械的に残させることです。差分ではなく、意図を残す。ここが起点になります。

コミット末尾に、追跡用メタデータを刻む

私が採用しているのは、コミットメッセージの末尾に構造化メタデータを必ず付けさせる規約です。本文は人間向けの説明、末尾は機械が grep するためのタグにします。

Add: プレミアム記事 3 本を公開 (claudelab)

CLI 移行・OS 委譲・監査設計の 3 テーマ。日英セットで作成。

Agent-Task: claudelab-premium-thu
Agent-Run: 2026-06-13T20:14+09:00
Agent-Intent: premium-content-publish
Agent-Gates: article,templating,frontmatter,redirect=pass

Agent-Task でどのスケジュールタスク由来かが分かり、Agent-Run で実行時刻、Agent-Intent で意図、Agent-Gates で通過した品質ゲートが残ります。後から「あの変更はどのタスクだ」と思ったとき、これがあるだけで追跡が一瞬で終わります。

実際の抽出はこうです。

# 特定タスク由来のコミットだけを時系列で並べる
git log --all --grep="Agent-Task: claudelab-premium-thu" \
  --pretty=format:"%h %ci %s"
 
# 品質ゲートをすり抜けたコミットがないか監査する
git log --all --grep="Agent-Gates:" --pretty=%b \
  | grep "Agent-Gates:" | grep -v "=pass" || echo "全コミットがゲート通過済み"

この 2 本の grep が、私の毎朝の点検になっています。前者で昨夜どのタスクが何を入れたかを把握し、後者でゲートをすり抜けた変更がないかを確認します。

ここまでお読みいただきありがとうございます。

この記事の続きを読む

この先には、実装コードやベンチマーク結果など、実務でお役に立てる内容をご用意しています。このサイトは広告を掲載しておらず、サーバーや開発にかかる費用はメンバーの皆様のご支援で成り立っています。もしお役に立てていましたら、ご支援いただけますと大変ありがたいです。

この記事で得られること
『どのエージェントがこの変更をしたか分からない』を防ぐ、コミット末尾メタデータの設計
人間のレビューを差し込むべき変更と、自動承認してよい変更を分ける 3 段のゲート
変更の意図を 1 行で残させるプロンプト規約と、後から grep で追える実装
Stripe による安全な決済 · いつでもキャンセル可能

この記事を購入する

この先の内容をすべてお読みいただけます。一度のご購入で、いつでも何度でもアクセスできます。このサイトは広告を掲載しておらず、皆さまのご支援がサーバー費用などの運営を支えています。

または
メンバーシップなら全記事が読み放題 →
シェア

お読みいただきありがとうございます

Antigravity Lab は広告なしで運営しており、サーバー費用などの運営コストはメンバーシップのご支援で賄っています。実装コード・ベンチマーク・本番設計パターンなど、実務でお役立ていただける記事を毎日更新しています。もし読んでよかったと感じていただけましたら、ぜひご覧ください。

  • コピー&ペーストで使える実装コード付き
  • 毎日新しい上級ガイドを追加
  • ¥580/月 または ¥1,480 の永久アクセス
メンバーシップを見る →

関連記事

Agents & Manager2026-06-12
依存ライブラリの更新を Antigravity エージェントに任せる運用設計 — リスク階層・検証・巻き戻し
溜まり続ける依存更新の通知を、Antigravity のエージェントにどこまで任せられるか。semver を実績で補正するリスク4階層、worktree によるロット隔離、検証と巻き戻しの定型化まで、複数アプリ運用で固めた設計を実物のスクリプトつきで共有します。
Agents & Manager2026-06-04
6 サイトを一人で回すための自律エージェント・スケジュール設計 — 衝突とスパム判定を避ける時間割
個人開発者が 6 つのサイトとアプリ事業を一人で並行運用するために組んだ、自律エージェントのスケジュール設計の実例です。オフピーク分散・1日あたりの生成上限・タスク衝突の回避を、実際の時間割と判断基準からまとめました。
Agents & Manager2026-06-03
エージェントに渡す道具の粒度を決める — 粗くまとめるか、細かく分けるか
エージェントに与えるツールを細かく分けるか粗くまとめるか。判断軸を「意図1つ=ツール1つ」に置き、破壊的操作だけ粒度を下げる設計を、6アプリ運用の実コードと実数値で解説します。
📚RECOMMENDED BOOKS
大規模言語モデル入門
山田育矢
LLM開発
生成AIプロンプトエンジニアリング入門
我妻幸長
プロンプト
Claude CodeによるAI駆動開発入門
平川知秀
AI駆動開発
※ アフィリエイトリンクを含みます
もっと見る →