すべての記事
Antigravity のマルチエージェントを本番で壊さない封じ込め設計 — 連鎖障害を止める3つの境界の実装メモ
Antigravity のマルチエージェント構成は単体では綺麗に動くのに、本番では小さな失敗が全体に波及します。連鎖障害を止めるための制御の階層化・信頼境界・観測と冪等性という3つの境界を、TOML 設定と相関IDラッパーの実装まで含めて整理しました。
サブエージェントの受け渡しを壊さないスキーマ進化の設計
上流エージェントの成果物を下流が受け取る境界に型付き契約を置き、スキーマを変えても既存のフローが止まらないようにする設計を、検証コード・移行手順・実運用での落とし穴とともにまとめました。
Managed Agents にクラウドで動いてもらうとき、資格情報をどう渡すか
Antigravity 2.0 の Managed Agents API は、手元を離れたクラウドでエージェントを走らせます。便利な反面、自分の端末では当たり前だった資格情報の扱いが急に難しくなります。長く生きるトークンを直接渡さず、実行ごとに発行して短く失効させるための設計をまとめました。
Managed Agents API のバッチを、途中で落ちても作り直さない形にした記録
Managed Agents API で 200 件規模のバッチを回すと、途中失敗のたびに前半をやり直してトークンを溶かしていました。チェックポイントと冪等キーを足して、落ちた箇所から再開できるようにした設計と実装をまとめます。
「直しました」を信じる前に — 本番URLの描画をエージェント自身に確かめさせる完了ゲート
エージェントが「修正してデプロイしました」と報告したのに、本番ページが真っ白だった。ビルドもデプロイも成功（200）なのに本文が空になる事故を防ぐため、Antigravity 2.0 の Browser Sub-Agent に本番URLを開かせて主要セレクタの存在を確認させる、完了前の検証ステップの組み方をまとめます。
並列エージェントの変更を、後から追えるようにする設計
Antigravity 2.0 は複数エージェントの管制塔になりました。誰が・なぜ・何を変えたのかを後から追える監査トレイルの作り方を、実運用の失敗から設計します。
エージェントに品質チェックを飛ばさせない — Antigravity CLI Hooks と git pre-push の二段ゲート設計
依存更新を任せたエージェントが、落ちたテストを『無関係』と自己判断して push まで進めてしまった経験から、Antigravity CLI の Hooks と git pre-push を重ねた二段ゲートを組みました。品質チェックの省略を仕組みで防ぐ設定とスクリプトの実物をまとめています。
スケジュール実行のエージェントが二重に走る — 重複と再実行に耐える冪等設計
前回の実行が終わらないうちに次回がトリガーされ、スケジュール実行のエージェントが同じ作業を二重に行うことがあります。重なり防止のロックと、途中失敗からの再実行に耐える冪等化を、実運用で踏んだ二重投稿の事例とともに設計します。
スケジュール実行エージェントの指示書ドリフト — 定義・文書・実態の乖離を検知する三層整合の設計
スケジュール実行のエージェントは、指示書と実態が乖離しても成功ログを出し続けます。定義・文書・実態の三層で整合を検査するスクリプトと週次レビューの組み立てを、運用で踏んだ無音失敗の実例とともにまとめました。
複数エージェントを同じリポジトリで並走させると壊れる — worktree で作業領域を分離する設計
Antigravity 2.0 で複数エージェントを同じリポジトリに同時に走らせると、index.lock の衝突や中途半端なステージングで失敗します。git worktree と projects を使ってエージェントごとに作業領域を分ける分離設計を、実運用で踏んだ事故とあわせてまとめました。
Antigravity SDK で定期実行エージェントを冪等に組む — 二重起動と取りこぼしを防ぐ実装
Antigravity SDK のスケジュール実行は、cron 式を一行足すだけで動きます。難しいのはそこではなく、同じジョブが二重に走ったり、前回の続きを取りこぼしたりせず「何度動いても結果が一つ」になる実装です。個人開発の定期メンテナンスで踏んだ失敗をもとに、冪等な定期エージェントの組み方をまとめました。
AIエージェントの git push が成功表示なのにリモートへ反映されないときの原因と対処
エージェントに任せた git push が「Everything up-to-date」のまま空振りし、リモートに何も反映されない症状について、再現条件と原因、identity 明示・SHA 照合・GitHub REST API という3つの対処をまとめました。