二重起動するバックグラウンドエージェント — リースとフェンシングトークンで止める設計
同じスケジュールジョブが2台のマシンから同時に走り、成果物を上書きし合う。Antigravity 2.0 のバックグラウンドエージェントで起きるこの事故を、リースとフェンシングトークンで根本から防ぐ設計をコード付きで整理します。
無人エージェントの実行ログを、ディスクを溢れさせずに後から追える形で残す
スケジュール実行のエージェントは、落ちた理由を後から追えなければ直せません。実行ログをディスクを溢れさせずに残すため、3層保持・スキーマ版付与・圧縮ジョブで設計する方法を、複数サイトを自動運用する個人開発の現場からまとめます。
複数環境でエージェント設定が静かにずれていく — 設定ドリフトの検知と是正
片方の環境でだけエージェントが失敗する原因は、数週間前の設定変更の反映漏れでした。設定の正本を決め、正規化してからハッシュで照合し、ドリフトを3段階で扱う検知と是正の仕組みを、複数 Mac と自動運用環境をまたぐ実運用に基づいて設計します。
複数案を出させたあと、どれを採用するか — 検証で裁定する Best-of-N の設計
Gemini 3.5 Flash の速さで、同じ実装を複数案つくらせるのは現実的になりました。難しいのは生成ではなく裁定です。多数決でも自己申告の自信でもなく、検証可能な信号だけで採用案を決める Best-of-N アービターの設計と TypeScript 実装を共有します。
どのエージェントがいくら使ったかを会計する — タスク別コスト帰属の設計
月末の請求は1つの数字でも、Gemini 3.5 Flash で複数エージェントを走らせていると、どのタスクが費用を食ったかが見えません。予算で止めるガードとは別に、使用量をタスク別・サイト別の原価へ帰属させる会計設計を、個人運用の実装と数値で共有します。
並行エージェントの動きを後から辿る — 構造化ログとスパンで作る可観測性
Antigravity 2.0 のデスクトップで複数エージェントを並行させると、どれが何をしているか追えなくなります。混線する print デバッグを捨て、run_id と span で実行を後から辿れるようにする可観測性の設計を、個人運用の実装と数値で共有します。
Managed Agents の無人バッチを再実行で壊さない — 冪等性とチェックポイントの設計
Antigravity 2.0 の Managed Agents API で夜間バッチを組むと、途中失敗からの再実行が必ず問題になります。二重実行で投稿が重複した失敗を起点に、冪等キー・チェックポイントストア・再開ロジックの実装を、個人開発の運用実数値とともに共有します。
クラウドに出した夜間バッチが「昨日と違う結果」になる — 再現性を守る入力契約とスナップショット設計
Managed Agents API でバッチをクラウドのエフェメラルワーカーに出すと、手元では当たり前だった環境の前提が消えます。同じ入力でも結果がぶれる原因を、環境スナップショット・入力契約・シード固定の三層で押さえる設計と実装を共有します。
agy の非同期ジョブで夜間タスクを束ねる — fan-out・poll・join の運用設計
Go 製になった Antigravity CLI（agy）は、ジョブをデタッチして非同期に走らせられます。複数の長時間タスクを一度に投げ、ジョブIDを束ね、完了をポーリングで待ち合わせる fan-out・poll・join の運用設計を、実際の夜間バッチの構成とともに共有します。
並列エージェントの変更を、後から追えるようにする設計
並列エージェントの変更で「誰が何をしたのか分からない」状態に陥らないための監査トレイル設計です。コミット末尾への追跡メタデータ、人間が見る変更と自動承認してよい変更の切り分け、意図を1行で書かせるプロンプト側の規約まで具体的にまとめました。
Antigravity CLI を非対話で回す — CI と cron に載せる前の設計
Gemini CLI の提供終了を機に移行した Antigravity CLI を、CI と cron に載せる前の設計です。対話前提のまま置くと固まる理由、二重起動に耐える冪等性、終了コードと JSON での成否判定、認証情報の安全な渡し方までを扱います。
Gemini CLI 終了まで残り6日 — 自動化スクリプトの依存を棚卸しして Antigravity CLI へ移行する
6月18日の Gemini CLI 提供終了を前に、cron・CI・シェルスクリプトに潜む gemini コマンド依存を洗い出し、Antigravity CLI へ移行して検証するまでの実務手順を整理しました。