並行サブエージェントが同じAPIの上限を奪い合うとき — 共有トークンバケットで集約レートを抑える
Antigravity 2.0 の dynamic sub-agents を並行で走らせると、各エージェントが独立に外部APIを叩いて集約レートが上限を超え、429が連鎖します。共有トークンバケットで集約レートを先回りで抑える設計と、Redis化までを実装コード付きで解説します。
頼んでいないことまでやられた — エージェントのタスク範囲を契約で縛る
ボタンの色を直すだけの依頼にリファクタやリネームまで付いてくる問題を、権限ではなく範囲の事故と捉え直しました。タスク範囲契約の書き方、範囲を越えたときの挙動の決め方、ヘッドレス実行への載せ方、逸脱を差分で自動的に拾う方法を順序立てて説明します。
処理させる記事の本文が、そのままエージェントへの指示になっていた話
Antigravity CLI で無人のコンテンツ整形パイプラインを回していると、処理対象ファイルの本文に紛れた指示文がエージェントの動作を乗っ取ります。指示チャネルとデータチャネルを構造的に分離し、出力スコープの受け入れゲートで逸脱を弾く設計をまとめました。
自作 MCP サーバの巨大なツール結果でエージェントのコンテキストを溢れさせない設計
自作 MCP サーバのツールが大きな結果を一度に返すと、Antigravity のエージェントは静かに劣化します。フィールド射影・ページング・resource_link・出力予算で、コンテキストを溢れさせない実装を TypeScript の具体コードと実測値で示します。
大型更新で無人実行が一晩で止まる前に — バージョンを段階導入するカナリアゲートの設計
大型更新の直後に無人実行が半分しか通らなくなった経験から、動作中の構成を凍結し、隔離プロファイルのカナリア検証で合否を判定してから本採用する段階導入ゲートの設計を、bashとPythonの実装とともにまとめます。
Antigravity の独自ツールが本番で事故るのは『設計』ではなく『再実行』のとき — 冪等化とエラー契約の運用メモ
Antigravity エージェントに独自ツールを足したあと、実運用で本当に問題になるのは再実行と二重副作用です。冪等キー・エラー契約・ヘルスゲート・ツール乱立の抑制を、実装と判断基準ごと整理しました。
エージェントを増やしても速くならない領域がある — 並列と直列の線引きを設計する
Antigravity 2.0 の複数エージェント並列実行は強力ですが、同時実行数を上げるほど速くなるわけではありません。どの仕事を並列にし、どこを直列のまま残すかを、不変条件と依存グラフから逆算して決める設計の考え方を、個人開発の実運用とあわせてまとめました。
並列にするか、順番に残すか — 複数エージェントを束ねるときの損益分岐
複数のエージェントを並列で走らせるべきか、直列のまま残すべきか。調整コストと待ち時間短縮の損益分岐をざっくり見積もる式と、4サイト運用での実際の線引き、判定を自動化する小さなスクリプトまでまとめました。
複数エージェントをどう束ねるか: 並列化する仕事と直列に残す仕事の線引き
Antigravity 2.0 で複数エージェントの真の並列実行が可能になりました。ただ全部を並列にすれば速くなるわけではありません。どの作業を並列に分け、どこを直列のまま残すか。依存関係と競合の観点から、破綻しないオーケストレーション設計を考えます。
Antigravity 2.0 の並列エージェントに視覚回帰テストを任せる設計
Antigravity 2.0 の並列オーケストレーションで、実装エージェントとは別にヘッドレスの視覚回帰テストエージェントを走らせる設計を解説します。基準画像の保管と更新、アンチエイリアス由来のフレーキー対策など、運用の勘所も押さえました。
Antigravity 2.0 のエージェントに任せる前に引く、3本の境界線
Gemini CLI の提供終了を機に Antigravity 2.0 のバックグラウンドエージェントへ移行した際、任せる作業と手元に残す作業の間に引いた3本の境界線を紹介します。停止条件をコードに落とす方法や、運用して見えた誤算も率直に記しています。
Gemini API の Managed Antigravity Agent で多言語リリースノートを生成する実装メモ
Gemini API 経由で公開プレビューになった Managed Antigravity Agent を使い、git のコミットログから App Store / Google Play 向けの多言語リリースノートを生成するパイプラインを実装した記録です。