すべての記事
Antigravity の計画を、承認する前に削る
Planning モードが返す7ステップの計画から不要な一手を削ってから承認する、部分編集の使い方をまとめました。削るべきステップの見抜き方、3つの編集操作、削除したステップが復活する落とし穴と同じ削除を繰り返さない書き方を実例で紹介します。
処理させる記事の本文が、そのままエージェントへの指示になっていた話
Antigravity CLI で無人のコンテンツ整形パイプラインを回していると、処理対象ファイルの本文に紛れた指示文がエージェントの動作を乗っ取ります。指示チャネルとデータチャネルを構造的に分離し、出力スコープの受け入れゲートで逸脱を弾く設計をまとめました。
dynamic sub-agents が枝分かれしすぎる前に — 深さ予算とファンアウト上限の設計
Antigravity 2.0 の dynamic sub-agents は実行中に自分でサブエージェントを生やせます。便利ですが、深さとファンアウトを制御しないとトークン予算を一晩で溶かします。3つのガードの実装を具体コードで示します。
自律エージェントの行動を、改ざんを検知できる監査ログに残す
Antigravity のエージェントが自律的に下した判断と実行を、後から追跡・検証できる形で残すために、ハッシュチェーンで改ざんを検知できる追記専用の監査ログを設計する方法を、実装コードとともにまとめました。
エージェント自動運用が壊れた朝に、何分で戻せるか — 復旧の3層設計
Antigravity 2.0 でデスクトップ・CLI・SDK と運用面が増えるほど、壊れたときに戻す対象も増えます。個人開発で複数サイトを自動運用してきた立場から、認証・定義・状態の3層で復旧可能性を保つ設計と、月1回の復元訓練の手順をまとめます。
モデルを乗り換える前に、エージェントの出力をゴールデンスナップショットで固定する
Antigravity のエンジンが Gemini 3.5 Flash へ切り替わるタイミングで、エージェントの出力が静かに変わってしまう問題を、ゴールデンスナップショットによる回帰ゲートで捕まえる設計を、実際のテストコードと移行手順とともにまとめました。
一度きりのプロンプトを、再利用できるサブエージェントに残す
Antigravity 2.0 の dynamic sub-agents で生まれた『うまくいったプロンプト』を、会話履歴に埋もれさせず再利用可能な定義として残す方法を、実際のファイル構成と蒸留手順とともにまとめました。
大型更新で無人実行が一晩で止まる前に — バージョンを段階導入するカナリアゲートの設計
大型更新の直後に無人実行が半分しか通らなくなった経験から、動作中の構成を凍結し、隔離プロファイルのカナリア検証で合否を判定してから本採用する段階導入ゲートの設計を、bashとPythonの実装とともにまとめます。
外部ページに紛れ込んだ指示で無人エージェントが動いてしまう前に — 入力の汚染を追跡して権限を落とす設計
無人エージェントが外部ページに紛れ込んだ指示に従ってしまう前に、入力の汚染を実行単位で追跡し、汚染時にケイパビリティを落とすゲートを設計します。外部コンテンツをデータとして囲うコンテンツフェンスや、運用での測定としきい値の決め方まで扱います。
Antigravity の独自ツールが本番で事故るのは『設計』ではなく『再実行』のとき — 冪等化とエラー契約の運用メモ
Antigravity エージェントに独自ツールを足したあと、実運用で本当に問題になるのは再実行と二重副作用です。冪等キー・エラー契約・ヘルスゲート・ツール乱立の抑制を、実装と判断基準ごと整理しました。
並列エージェントの同時実行数を固定しない — 観測した詰まりから自動で増減させる設計
Antigravity 2.0 で複数エージェントを並列に走らせるとき、同時実行数を固定値で決め打ちすると昼は429で詰まり夜は能力を遊ばせます。TCPの輻輳制御に学んだ適応制御（加法的増加・乗法的減少）で、詰まりの兆候から同時実行数を自動で増減させる設計を、動くPython実装と実測の所感つきでまとめました。
エージェントが足した依存を、あとから棚卸しする — ライセンスと出所を追える形で残す設計
エージェント運用を続けると package.json に見覚えのない依存が増えていきます。git 履歴から追加された依存を抽出し、ライセンスを集計してポリシーと突き合わせる棚卸しの実装と、追加理由を残す記録の設計を、動くスクリプトとともに紹介します。