Android CLI が3倍速・トークン7割減になったとき、増やすべきは並列数ではなく1件あたりの検証だった
Android CLI のエージェントが3倍速・トークン約7割減になった、というニュースを見て最初に考えたのは「では何本同時に走らせようか」でした。けれど速くなって本当に変わるのは生産量ではなく、詰まる場所です。レビューと検証ゲートに移ったボトルネックを Little's Law で見積もり、WIP キャップで並列数を抑え、浮いた予算を1件あたりの検証に回す設計を、動く Python 実装と実測値でまとめました。
1,400箇所の置換を1コミットで投げてきたエージェントに、バッチで返してもらう設計
Antigravity に大規模な機械的置換（codemod）を任せると、レビュー不能な巨大1コミットが返ってくることがあります。ast-grep のルールと検証付きバッチドライバで、置換を「機械の仕事」と「人の確認」に分け、安全に通す設計を実装つきでまとめました。
外部ページに紛れ込んだ指示で無人エージェントが動いてしまう前に — 入力の汚染を追跡して権限を落とす設計
無人実行のエージェントが取得した外部ページやPDFに指示が紛れていても乗っ取られないよう、入力の汚染を追跡して副作用ツールの権限を落とす設計を、動くPythonコードと運用の実測値つきで解説します。
並列エージェントの同時実行数を固定しない — 観測した詰まりから自動で増減させる設計
Antigravity 2.0 で複数エージェントを並列に走らせるとき、同時実行数を固定値で決め打ちすると昼は429で詰まり夜は能力を遊ばせます。TCPの輻輳制御に学んだ適応制御（加法的増加・乗法的減少）で、詰まりの兆候から同時実行数を自動で増減させる設計を、動くPython実装と実測の所感つきでまとめました。
サブエージェントの受け渡しを壊さないスキーマ進化の設計
上流エージェントの成果物を下流が受け取る境界に型付き契約を置き、スキーマを変えても既存のフローが止まらないようにする設計を、検証コード・移行手順・実運用での落とし穴とともにまとめました。
並列エージェントの変更を、後から追えるようにする設計
Antigravity 2.0 は複数エージェントの管制塔になりました。誰が・なぜ・何を変えたのかを後から追える監査トレイルの作り方を、実運用の失敗から設計します。
6 サイトを一人で回すための自律エージェント・スケジュール設計 — 衝突とスパム判定を避ける時間割
個人開発者が 6 つのサイトとアプリ事業を一人で並行運用するために組んだ、自律エージェントのスケジュール設計の実例です。オフピーク分散・1日あたりの生成上限・タスク衝突の回避を、実際の時間割と判断基準からまとめました。
エージェントに渡す道具の粒度を決める — 粗くまとめるか、細かく分けるか
エージェントに与えるツールを細かく分けるか粗くまとめるか。判断軸を「意図1つ＝ツール1つ」に置き、破壊的操作だけ粒度を下げる設計を、6アプリ運用の実コードと実数値で解説します。
Antigravity のエージェント編集が patch does not apply で失敗するときの原因と対処
Antigravity のエージェントがファイルを編集しようとして patch does not apply や hunk failed で止まる症状の原因と直し方をまとめます。エージェントが読んだ後にファイルが変わってしまう競合を中心に、再発させない設定までを実体験ベースで解説します。
やり直せる操作とやり直せない操作を分けて任せる — 可逆性で自律度を決めるエージェント設計
Antigravity のエージェントに本番作業を任せるとき、賢さより先に効いてくるのは「その操作をあとから取り消せるか」です。操作を可逆性で3階層に分け、自動実行・チェックポイント付き実行・人間ゲートへ振り分ける設計を、TypeScript の実装と6アプリ並行運用の実測値つきで整理しました。
Antigravity のエージェント出力からシークレットを漏らさない多層防御 — ログ・差分・PR 本文を守る実装メモ
バックグラウンドエージェントの出力にシークレットが混入する3つの経路と、コミット差分・実行ログ・PR本文を守る多層防御の実装を、6アプリ運用の実体験と具体数値とともにまとめました。
途中で失敗したエージェントの副作用を巻き戻す — 補償トランザクション設計の実装メモ
Antigravity のエージェントに複数の外部システムをまたぐ作業を任せると、途中の一段が失敗したときに半分だけ世界が書き換わって残ります。やり直しでは直らないこの状態を、補償トランザクション（Saga）で安全に巻き戻す設計を、TypeScript の実装と実運用の数値つきで整理しました。