Agents & Manager の記事一覧
複数の AI エージェントを協調させるマルチエージェント開発のカテゴリです。Manager Surface による統率、オーケストレーション設計、暴走やループの防止、無人運用の監視まで、エージェント活用の実践知を集めています。
エージェントに任せた仕事の「やり直し率」を測る — 委譲境界を勘ではなく数字で引く
エージェントへの委譲境界を勘ではなく数字で引くために、タスク種別ごとの「やり直し率」を git 履歴から算出する方法を紹介します。信頼区間を添える理由や、委ねる・要レビュー・自分でやるを分ける決定ルール、実際に境界を引き直した記録まで扱います。
並列エージェントが同じタスクを二度実行して請求が膨らんでいたとき — 重複を計測して止める運用メモ
並列エージェントの請求が想定の約1.9倍に膨らんでいたのは、複数のワーカーが同じタスクを二重に実行していたからでした。重複を計測し、冪等キーで先取り予約し、コストをタスク単位に帰属させるまでの運用記録です。
Managed Agent の完了通知を取りこぼさない — サーバーレス受信とポーリング突き合わせの二重化設計
クラウドの Managed Agent が完了しても通知が届かない、という不安定さをどう設計で潰すか。Cloudflare Workers の冪等な受信口とポーリング照合を二重化し、無人ジョブの完了を確実に回収する状態機械を実装します。
エージェント開発スタックの『既知の正常』を1枚のロックファイルで守る — 可動部が同時に動く時代の変更予算設計
IDEビルド・CLI・モデル・依存が同時に動くと、回帰の原因が特定できなくなります。既知の正常を1枚のロックファイルに固定し、一度に動かす軸を絞る変更予算の設計を、実装コードと運用ログで整理しました。
自己デバッグのエージェントに、ログイン後とペイウォール後の画面を必ず踏ませる
Antigravity 2.0 の実ブラウザ自己デバッグは、既定だと未ログインの無料表示しか見ずに合格を返します。課金導線の回帰を見逃さないため、認証済みセッションと課金状態をエージェントに注入し、到達を表明で強制する設計をまとめます。
AIコードレビューエージェントの指摘を誰も読まなくなったとき — 採用率を計測して立て直す運用メモ
AI コードレビューエージェントの指摘が半年で読まれなくなった経験から、PR イベントを使った採用率の自動集計、偽陽性と疲労による無視の切り分け、重大度別の健全度しきい値の設け方まで、形骸化を立て直す運用手順を実測の数字とともに整理しました。
エージェントが実ブラウザで自己デバッグするとき、証跡と承認をどこに置くか
Antigravity 2.0 はビルド中に実際の Chrome を起動し、ボタン操作やスクリーンショットで自己修復します。速さは魅力ですが、そのまま本番に出すのは危険です。証跡の残し方と承認境界の引き方を設計します。
夜中に失敗した無人ランを翌朝の再発防止に変える — ポストモーテムの還流路を設計する
深夜の無人ランの失敗が数日後に形を変えて戻ってくる連鎖を断ち切るための、ポストモーテム還流路の設計です。失敗の証拠を run record として残し、5分類のタクソノミで還流先を決め、朝5分のレビューで回す集約スクリプトまで実装していきます。
技術的負債スコアは下がったのに同じ場所でバグが再発するとき — スコアが見落とす結合とチャーンを計測する運用メモ
Antigravityのアーキテクチャ分析エージェントに技術的負債をスコアリングさせても、リファクタリング後に同じ場所でバグが再発することがあります。静的スコアが見落とすFan-inとチャーンの掛け算を計測し、実際の障害と突き合わせる運用手順をまとめました。
対話では動いたのに夜間だけ黙る——Antigravity のエージェント定義を対話と無人で同じ挙動にする
デスクトップの Antigravity では正しく動くのに、スケジュールした CLI 実行だと黙って何もしないエージェント。承認・文脈・秘密情報・実行環境の4点で経路差を吸収し、1つの定義を対話でも無人でも同じ挙動にする設計を、動くコードとプリフライト検査つきでまとめます。
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 スキルを、一度きりの指示で終わらせず、バージョン管理されたチーム共有の設計資産として運用するための具体的な構成と判断基準を整理します。
Antigravity の計画を、承認する前に削る
Planning モードが返す7ステップの計画から不要な一手を削ってから承認する、部分編集の使い方をまとめました。削るべきステップの見抜き方、3つの編集操作、削除したステップが復活する落とし穴と同じ削除を繰り返さない書き方を実例で紹介します。
処理させる記事の本文が、そのままエージェントへの指示になっていた話
Antigravity CLI で無人のコンテンツ整形パイプラインを回していると、処理対象ファイルの本文に紛れた指示文がエージェントの動作を乗っ取ります。指示チャネルとデータチャネルを構造的に分離し、出力スコープの受け入れゲートで逸脱を弾く設計をまとめました。
dynamic sub-agents が枝分かれしすぎる前に — 深さ予算とファンアウト上限の設計
Antigravity 2.0 の dynamic sub-agents は実行中に自分でサブエージェントを生やせます。便利ですが、深さとファンアウトを制御しないとトークン予算を一晩で溶かします。3つのガードの実装を具体コードで示します。
自律エージェントの行動を、改ざんを検知できる監査ログに残す
Antigravity のエージェントが自律的に下した判断と実行を、後から追跡・検証できる形で残すために、ハッシュチェーンで改ざんを検知できる追記専用の監査ログを設計する方法を、実装コードとともにまとめました。
エージェント自動運用が壊れた朝に、何分で戻せるか — 復旧の3層設計
Antigravity 2.0 でデスクトップ・CLI・SDK と運用面が増えるほど、壊れたときに戻す対象も増えます。個人開発で複数サイトを自動運用してきた立場から、認証・定義・状態の3層で復旧可能性を保つ設計と、月1回の復元訓練の手順をまとめます。
モデルを乗り換える前に、エージェントの出力をゴールデンスナップショットで固定する
Antigravity のエンジンが Gemini 3.5 Flash へ切り替わるタイミングで、エージェントの出力が静かに変わってしまう問題を、ゴールデンスナップショットによる回帰ゲートで捕まえる設計を、実際のテストコードと移行手順とともにまとめました。
一度きりのプロンプトを、再利用できるサブエージェントに残す
Antigravity 2.0 の dynamic sub-agents で生まれた『うまくいったプロンプト』を、会話履歴に埋もれさせず再利用可能な定義として残す方法を、実際のファイル構成と蒸留手順とともにまとめました。
大型更新で無人実行が一晩で止まる前に — バージョンを段階導入するカナリアゲートの設計
大型更新の直後に無人実行が半分しか通らなくなった経験から、動作中の構成を凍結し、隔離プロファイルのカナリア検証で合否を判定してから本採用する段階導入ゲートの設計を、bashとPythonの実装とともにまとめます。
外部ページに紛れ込んだ指示で無人エージェントが動いてしまう前に — 入力の汚染を追跡して権限を落とす設計
無人エージェントが外部ページに紛れ込んだ指示に従ってしまう前に、入力の汚染を実行単位で追跡し、汚染時にケイパビリティを落とすゲートを設計します。外部コンテンツをデータとして囲うコンテンツフェンスや、運用での測定としきい値の決め方まで扱います。
Antigravity の独自ツールが本番で事故るのは『設計』ではなく『再実行』のとき — 冪等化とエラー契約の運用メモ
Antigravity エージェントに独自ツールを足したあと、実運用で本当に問題になるのは再実行と二重副作用です。冪等キー・エラー契約・ヘルスゲート・ツール乱立の抑制を、実装と判断基準ごと整理しました。
並列エージェントの同時実行数を固定しない — 観測した詰まりから自動で増減させる設計
Antigravity 2.0 で複数エージェントを並列に走らせるとき、同時実行数を固定値で決め打ちすると昼は429で詰まり夜は能力を遊ばせます。TCPの輻輳制御に学んだ適応制御（加法的増加・乗法的減少）で、詰まりの兆候から同時実行数を自動で増減させる設計を、動くPython実装と実測の所感つきでまとめました。
エージェントが足した依存を、あとから棚卸しする — ライセンスと出所を追える形で残す設計
エージェント運用を続けると package.json に見覚えのない依存が増えていきます。git 履歴から追加された依存を抽出し、ライセンスを集計してポリシーと突き合わせる棚卸しの実装と、追加理由を残す記録の設計を、動くスクリプトとともに紹介します。
Background Agent に夜間作業を任せて、朝に後悔しないために — 無人実行のガードレール設計
Antigravity の Background Agent に夜間リファクタを任せると、朝には便利さと同じだけの不安が届きます。被害範囲・完了条件・静かな劣化の検出という3点から、無人実行を安心して回すためのガードレール設計を運用視点でまとめました。
無人エージェントの実行ログを、ディスクを溢れさせずに後から追える形で残す
スケジュール実行のエージェントは、落ちた理由を後から追えなければ直せません。実行ログをディスクを溢れさせずに残すため、3層保持・スキーマ版付与・圧縮ジョブで設計する方法を、複数サイトを自動運用する個人開発の現場からまとめます。
無人実行のエージェントをタイムアウトで止めたとき、書きかけのファイルが残る問題
スケジュール実行のエージェントがタイムアウトで殺されると、書きかけのファイルが静かに残ります。原子的な書き込み・固定名temp残骸の排除・書き込み後の内容検証で、無人パイプラインを壊さない設計をまとめました。
失敗したエージェントジョブを取りこぼさない — デッドレターと再投入の設計
夜間のスケジュール実行で失敗したエージェントジョブが静かに消えていく問題を、デッドレター退避と3階層の再投入で防ぐ設計をまとめました。二重実行を避ける冪等キーの持たせ方や、朝5分で終わる確認手順など、複数サイト自動運用の実例に基づいています。
エージェントを増やしても速くならない領域がある — 並列と直列の線引きを設計する
Antigravity 2.0 の複数エージェント並列実行は強力ですが、同時実行数を上げるほど速くなるわけではありません。どの仕事を並列にし、どこを直列のまま残すかを、不変条件と依存グラフから逆算して決める設計の考え方を、個人開発の実運用とあわせてまとめました。
Antigravity のサンドボックスでマルチエージェントを動かしても、隔離は思ったほど効いていない — 被害範囲を封じ込める運用メモ
Antigravity のサンドボックスは「隔離した気持ち」を与えますが、共有ボリューム・広すぎる許可ドメイン・承認疲れの3つで隔離は漏れます。漏れどころを塞ぎ、被害範囲を設計で封じ込め、隔離をテストで証明する運用メモです。