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