Background Agent に夜間作業を任せて、朝に後悔しないために — 無人実行のガードレール設計
Antigravity の Background Agent に夜間リファクタを任せると、朝には便利さと同じだけの不安が届きます。被害範囲・完了条件・静かな劣化の検出という3点から、無人実行を安心して回すためのガードレール設計を運用視点でまとめました。
Antigravity CLI の JSON Lines 出力を自作スクリプトで受ける — 部分行と終了コードでつまずいた記録
Antigravity CLI の機械可読出力（JSON Lines）を自前スクリプトに流し込むと、3回に1回ほど JSONDecodeError で止まりました。部分行・終了コード・stderr 混入という3つの罠と、行バッファリングで安定させた実運用の受け口を記録します。
無人エージェントの実行ログを、ディスクを溢れさせずに後から追える形で残す
スケジュール実行のエージェントは、落ちた理由を後から追えなければ直せません。実行ログをディスクを溢れさせずに残すため、3層保持・スキーマ版付与・圧縮ジョブで設計する方法を、複数サイトを自動運用する個人開発の現場からまとめます。
Play Store の密度分割で、特定の端末だけ内蔵壁紙が消えた — drawable と nodpi の境界設計
App Bundle の密度分割は、密度別に分けてはいけない画像まで分けてしまうと、特定の密度バケットの端末からだけリソースを取りこぼします。bundletool で再現し、drawable-nodpi への移動か密度分割の無効化で直すまでを、判断基準ごと残しました。
審査ガイドラインのPDFをエージェントに読ませて、アプリごとのリリース前チェックリストを作る
Antigravity v2.1.4 のPDF添付を使い、App Store と Play の審査ガイドラインをエージェントに文脈として読ませ、アプリの機能に紐づくリリース前チェックリストへ落とし込む手順をまとめました。
複数環境でエージェント設定が静かにずれていく — 設定ドリフトの検知と是正
片方の環境でだけエージェントが失敗する原因は、数週間前の設定変更の反映漏れでした。設定の正本を決め、正規化してからハッシュで照合し、ドリフトを3段階で扱う検知と是正の仕組みを、複数 Mac と自動運用環境をまたぐ実運用に基づいて設計します。
429に潰されないスケジュール — エージェント自動化のバックオフとジッター設計
複数のエージェントを並列に走らせると、レート制限の429が連鎖して全滅する瞬間があります。指数バックオフとジッターをどう設計すれば、リトライ自身が新たな混雑を生まないかを、個人開発の自動運用からまとめます。
並列で走らせたエージェントの依存インストールが lockfile を壊すとき、インストールだけを直列化する
Antigravity の並列エージェントが同じ pnpm store と lockfile を同時に書き換えて壊す失敗を、コード生成は並列のまま、インストールだけをファイルロックで直列化して防いだ実践メモです。
無人実行のエージェントをタイムアウトで止めたとき、書きかけのファイルが残る問題
スケジュール実行のエージェントがタイムアウトで殺されると、書きかけのファイルが静かに残ります。原子的な書き込み・固定名temp残骸の排除・書き込み後の内容検証で、無人パイプラインを壊さない設計をまとめました。
自動実行の再現性を守る — Antigravity CLI のバージョンを固定して挙動のブレを抑える
Go 製の Antigravity CLI が全ユーザーへ提供開始となり、更新も速いペースで続いています。自動運用に組み込んだ CLI が裏で上がると、ある朝のジョブだけ挙動が変わることがあります。バイナリのバージョンを固定し、各ランのログに素性を残し、更新は一本から慣らす——という再現性の守り方を、4サイトを夜間に自動運用している実作業からまとめます。
失敗したエージェントジョブを取りこぼさない — デッドレターと再投入の設計
夜間のスケジュール実行で失敗したエージェントジョブが静かに消えていく問題を、デッドレター退避と3階層の再投入で防ぐ設計をまとめました。二重実行を避ける冪等キーの持たせ方や、朝5分で終わる確認手順など、複数サイト自動運用の実例に基づいています。
Managed Agents API でバックグラウンドタスクを安全に走らせる設計
Antigravity 2.0 の Managed Agents API は、単一の API 呼び出しで隔離された Linux 環境にエージェントを起動し、推論・ツール実行・コード実行までを任せられます。便利な反面、放置すると暴走やコスト超過を招きます。バックグラウンド常駐タスクとして安全に運用する設計を考えます。