すべての記事
自作 MCP サーバの巨大なツール結果でエージェントのコンテキストを溢れさせない設計
自作 MCP サーバのツールが大きな結果を一度に返すと、Antigravity のエージェントは静かに劣化します。フィールド射影・ページング・resource_link・出力予算で、コンテキストを溢れさせない実装を TypeScript の具体コードと実測値で示します。
翻訳済みの一行が、いつの間にか英語へ戻っていた — エージェントが触った文字列リソースを差分で守る
エージェントに values フォルダの整理を任せると、訳済みの値が静かに原文へ戻ることがあります。既定言語を正、各ロケールを差分として鍵単位で突き合わせ、欠落・戻し訳・書式引数の崩れだけを pre-commit で止める設計と実装をまとめました。
エージェントに渡すMCPツールを絞る — 最小権限の許可リスト設計
Antigravity 2.0 に MCP サーバーを足していくと、各エージェントが触れるツールはいつの間にか「全部入り」になります。読み取りしか必要ないエージェントに削除系ツールまで見えている状態は、いつか事故を起こします。ツールをエージェント単位の許可リストで絞り、呼び出し直前で弾き、破壊的操作だけ二段階にする最小権限の設計を、動くPython実装と運用の所感つきでまとめました。
Antigravity CLI の JSON Lines 出力を自作スクリプトで受ける — 部分行と終了コードでつまずいた記録
Antigravity CLI の機械可読出力（JSON Lines）を自前スクリプトに流し込むと、3回に1回ほど JSONDecodeError で止まりました。部分行・終了コード・stderr 混入という3つの罠と、行バッファリングで安定させた実運用の受け口を記録します。
Gemini CLI から Antigravity CLI へ: 自動化を止めずに移行する段取り
Gemini CLI が提供終了となり、Go で書き直された Antigravity CLI が後継になりました。CI やスケジュール実行に CLI を組み込んでいる場合、移行を一度に行うと自動化が止まります。並走テストから段階的に切り替えるための具体的な段取りをまとめます。
Antigravity CLI を無人で動かすとき、失敗だけを静かに知らせる仕組み
Antigravity CLI をスケジュール実行する際、成功時は沈黙し、人が対応すべき失敗だけを通知する小さなラッパーの作り方を、終了コードの扱い・一過性エラーの切り分け・重複抑制まで含めて整理します。
Antigravity CLI への切り替え当日、出力ではなく副作用の等価性で本番自動化を検証する
Gemini CLI から Antigravity CLI へ切り替える当日に、標準出力の一致ではなく副作用（書き込んだファイル・コミット・ネットワーク呼び出し）の等価性で本番自動化を検証する方法です。サンドボックスでの並走と切り替え可否ゲートを実装の手順で整理しました。
エージェントのコミットを pre-commit で止める — 壊れた変更を本番リポジトリに入れない仕組み
Antigravity のエージェントが書いたコードを、コミットの瞬間に lint・型チェック・高速テスト・秘密情報スキャンで自動検査する pre-commit ゲートの組み方を、実測の所感とともにまとめました。
Antigravity CLI が無人実行中に 401 で止まるとき — 認証切れと再ログイン待ちを切り分ける
Antigravity CLI を無人のスケジュール実行に組み込んだあと、ある朝から 401 が一度出て止まる症状の原因と、認証切れと再ログイン待ちを切り分けて自動運用を立て直す手順をまとめます。
スケジュール実行の直前に、Antigravity CLI が本当に応答するかを1回だけ確かめる
6月18日の Gemini CLI 提供終了で Antigravity CLI へ載せ替えると、認証切れや当日の不調が無人のジョブを静かに空振りさせます。スケジュール本体を起動する前に CLI の生存を1回だけ確かめ、失敗を種類で振り分けて止める preflight の設計と実装をまとめました。
axe-core の検出をエージェントに渡して直す — アクセシビリティ改善を CI に組み込む実装メモ
axe-core で検出したアクセシビリティ違反を Antigravity のエージェントに渡し、検出→トリアージ→修正→再検証のループを CI に組み込む実装メモです。新規違反だけを止める差分ゲートと、エージェントの修正範囲を絞る設計を本番運用の形でまとめました。
クラウドに出した夜間バッチが「昨日と違う結果」になる — 再現性を守る入力契約とスナップショット設計
Managed Agents API でバッチをクラウドのエフェメラルワーカーに出すと、手元では当たり前だった環境の前提が消えます。同じ入力でも結果がぶれる原因を、環境スナップショット・入力契約・シード固定の三層で押さえる設計と実装を共有します。