複数環境でエージェント設定が静かにずれていく — 設定ドリフトの検知と是正
2台のMacと自動運用環境でエージェントの設定が少しずつ食い違い、片方だけ失敗する——その「設定ドリフト」を、ハッシュ照合と是正手順で見える化する設計を、個人開発の現場からまとめます。
429に潰されないスケジュール — エージェント自動化のバックオフとジッター設計
複数のエージェントを並列に走らせると、レート制限の429が連鎖して全滅する瞬間があります。指数バックオフとジッターをどう設計すれば、リトライ自身が新たな混雑を生まないかを、個人開発の自動運用からまとめます。
無人実行のエージェントをタイムアウトで止めたとき、書きかけのファイルが残る問題
スケジュール実行のエージェントがタイムアウトで殺されると、書きかけのファイルが静かに残ります。原子的な書き込み・固定名temp残骸の排除・書き込み後の内容検証で、無人パイプラインを壊さない設計をまとめました。
失敗したエージェントジョブを取りこぼさない — デッドレターと再投入の設計
スケジュール実行のエージェントが夜間に失敗したまま消えていく問題を、デッドレター退避と段階的な再投入で防ぐ設計を、複数サイトを自動運用する個人開発の現場からまとめます。
エージェントのコミットを pre-commit で止める — 壊れた変更を本番リポジトリに入れない仕組み
Antigravity のエージェントが書いたコードを、コミットの瞬間に lint・型チェック・高速テスト・秘密情報スキャンで自動検査する pre-commit ゲートの組み方を、実測の所感とともにまとめました。
Managed Agents API のバッチを、途中で落ちても作り直さない形にした記録
Managed Agents API で 200 件規模のバッチを回すと、途中失敗のたびに前半をやり直してトークンを溶かしていました。チェックポイントと冪等キーを足して、落ちた箇所から再開できるようにした設計と実装をまとめます。
「直しました」を信じる前に — 本番URLの描画をエージェント自身に確かめさせる完了ゲート
エージェントが「修正してデプロイしました」と報告したのに、本番ページが真っ白だった。ビルドもデプロイも成功（200）なのに本文が空になる事故を防ぐため、Antigravity 2.0 の Browser Sub-Agent に本番URLを開かせて主要セレクタの存在を確認させる、完了前の検証ステップの組み方をまとめます。
Managed Agents API を動かして考えた、クラウド実行と手元実行の境界線
Gemini API の Managed Agents（公開プレビュー）を Python から起動し、ポーリング・アーティファクト回収・コストガードまで実装した記録です。手元の CLI エージェントとの使い分け基準も5項目にまとめました。
依存ライブラリの更新を Antigravity エージェントに任せる運用設計 — リスク階層・検証・巻き戻し
溜まり続ける依存更新の通知を、Antigravity のエージェントにどこまで任せられるか。semver を実績で補正するリスク4階層、worktree によるロット隔離、検証と巻き戻しの定型化まで、複数アプリ運用で固めた設計を実物のスクリプトつきで共有します。
Antigravity エージェントへの依頼は「レビューできる単位」で切る — 手戻りを減らすタスク設計
1行の依頼で40分待った結果を月曜に書き直した失敗から、エージェントへのタスクを「自分が15分でレビューできる単位」で切る運用に変えました。実際の依頼文3通、受け入れ条件の書き方、worktree 並列時のファイル境界の切り方まで実例で残します。
本番に触れる前にエージェントの操作を空振りさせる — 副作用ゼロのドライラン層をどう設計するか
シャドウ実行やカナリアでも防げない事故があります。エージェントが外部APIに初めて触れる、その一回目を安全にするための「副作用ゼロのドライラン層」を、Antigravity の並列エージェントに後付けで差し込む設計と実装を、6サイト自律運営の実数値とともに共有します。
AntigravityでAGENTS.mdが反映されないときの切り分けと対処
AntigravityにAGENTS.mdを置いてルールを書いたのに、エージェントが無視して暴走する——よくあるこの症状を、配置場所・優先順位・コンテキスト枠の3軸から切り分けて修正するための実践ガイドです。