組み込み Guide スキルは助言にすぎない — Antigravity の出力を機械的に弾くゲートを併設する
v2.2.1 の組み込み Guide スキルはエージェントの遵守率を引き上げますが、確率的な助言である点は変わりません。残った違反を確実に止める決定論的な検証ゲートの設計を、動くコードと実測値で示します。
並行サブエージェントが同じ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本の境界線
バックグラウンドエージェントに何を任せ、何を手元に残すか。個人開発の並行運用で実際に引いた3本の境界線と、それをコードに落とすための具体的なパターンをまとめました。