すべての記事
Guide スキルとコードの乖離を検出して直す仕組み
Guide スキルに書いた手順がコードの変更で静かに古びていく問題を扱います。ずれが起きる3つの層の整理、参照先の実体を照合して乖離を検出するスクリプト、コードを真実として Guide を薄く保つ直し方と運用への組み込みまでを順に紹介します。
モデルがフォールバックしても命名と書式をぶらさない — エージェント出力の一貫性を保つ契約
実行中にモデルがフォールバックすると、生成コードの命名規約や書式が静かにぶれ始めます。モデルに依存しないスタイル契約の固定、差分からのドリフト検知、正規化パスの実装で出力の一貫性を保つ方法を、実際につまずいた点と対処もあわせてまとめました。
Android CLI が3倍速・トークン7割減になったとき、増やすべきは並列数ではなく1件あたりの検証だった
Android CLI のエージェントが3倍速・トークン約7割減になった、というニュースを見て最初に考えたのは「では何本同時に走らせようか」でした。けれど速くなって本当に変わるのは生産量ではなく、詰まる場所です。レビューと検証ゲートに移ったボトルネックを Little's Law で見積もり、WIP キャップで並列数を抑え、浮いた予算を1件あたりの検証に回す設計を、動く Python 実装と実測値でまとめました。
1,400箇所の置換を1コミットで投げてきたエージェントに、バッチで返してもらう設計
Antigravity に大規模な機械的置換（codemod）を任せると、レビュー不能な巨大1コミットが返ってくることがあります。ast-grep のルールと検証付きバッチドライバで、置換を「機械の仕事」と「人の確認」に分け、安全に通す設計を実装つきでまとめました。
並行サブエージェントが同じAPIの上限を奪い合うとき — 共有トークンバケットで集約レートを抑える
Antigravity 2.0 の dynamic sub-agents を並行で走らせると、各エージェントが独立に外部APIを叩いて集約レートが上限を超え、429が連鎖します。共有トークンバケットで集約レートを先回りで抑える設計と、Redis化までを実装コード付きで解説します。
Antigravity のエージェントが開く PR の説明が「Update files」のままになる問題と、レビューできる要約を強制するゲート
Antigravity のエージェントが自動で開く PR は、説明が「Update files」のように空疎になりがちです。差分からリスクを見積もり、空疎な説明を弾いてレビューできる要約を強制する検証ゲートを、動くコードとともにまとめます。
止まったまま生きているエージェントを見抜く — 進捗ハートビートとウォッチドッグの設計
プロセスは生きているのに6時間まったく進んでいない、という沈黙状態を見抜くために、進捗マーカーの外部化と無進捗タイムアウトによるウォッチドッグを設計しました。安全な止め方や導入の順序、夜間の記事生成エージェントで踏んだ落とし穴も共有します。
二重起動するバックグラウンドエージェント — リースとフェンシングトークンで止める設計
同じスケジュールジョブが2台のマシンから同時に走り、成果物を上書きし合う。Antigravity 2.0 のバックグラウンドエージェントで起きるこの事故を、リースとフェンシングトークンで根本から防ぐ設計をコード付きで整理します。
Antigravity に書かせたテストが「通るだけ」になっていないか — ミューテーションで実効性を測る
Antigravity のエージェントに書かせたテストは、通っても肝心のバグを捕まえられないことがあります。ミューテーションテストで実効性を測り、生存ミュータントを潰してから採用する運用を、動くコードとともにまとめます。
並行で走らせたエージェントの差分を、安全に1本へ束ねるレビューゲートの設計
Antigravity 2.0 で複数エージェントを並行実行できるようになった一方、各エージェントの成果物をどう検証して1本のブランチに統合するかは設計者に委ねられています。差分単位のレビューゲートを段階的に組む方法を、判断基準とスクリプトつきで整理します。
頼んでいないことまでやられた — エージェントのタスク範囲を契約で縛る
ボタンの色を直すだけの依頼にリファクタやリネームまで付いてくる問題を、権限ではなく範囲の事故と捉え直しました。タスク範囲契約の書き方、範囲を越えたときの挙動の決め方、ヘッドレス実行への載せ方、逸脱を差分で自動的に拾う方法を順序立てて説明します。
組み込み Guide スキルを使い捨てにせず、設計資産として育てる
Antigravity v2.2.1 で加わった組み込み Guide スキルを、一度きりの指示で終わらせず、バージョン管理されたチーム共有の設計資産として運用するための具体的な構成と判断基準を整理します。