Agents & Manager の記事一覧
複数の AI エージェントを協調させるマルチエージェント開発のカテゴリです。Manager Surface による統率、オーケストレーション設計、暴走やループの防止、無人運用の監視まで、エージェント活用の実践知を集めています。
途中で失敗したエージェントの副作用を巻き戻す — 補償トランザクション設計の実装メモ
Antigravity のエージェントに複数の外部システムをまたぐ作業を任せると、途中の一段が失敗したときに半分だけ世界が書き換わって残ります。やり直しでは直らないこの状態を、補償トランザクション（Saga）で安全に巻き戻す設計を、TypeScript の実装と実運用の数値つきで整理しました。
自律エージェントの流量を制御する — バックプレッシャーと待ち行列で本番を壊さない設計
Antigravity のエージェントを複数同時に走らせると、賢さより先に「下流が捌けない」問題にぶつかります。同時実行数・到着レート・処理能力の3つで流量を捉え、待ち行列・セマフォ・トークンバケット・バックプレッシャーで本番を守る設計を、TypeScript の実装と実測値つきで整理しました。
Antigravity のエージェントが node や python を『command not found』にするときの原因と対処
自分のターミナルでは動くのに、Antigravity のエージェントがコマンドを実行すると command not found になる。PATH 継承の仕組みから、nvm・pyenv・Homebrew・WSL 環境ごとの具体的な解決手順と、直ったかどうかの確かめ方までまとめます。
エージェントが壊す前提で組む — ブラスト半径を小さく保つ運用設計
Antigravity のエージェントに本番作業を任せ始めると、性能より先に「事故ったときの被害範囲」が問題になります。ブラスト半径を縮小する4層の封じ込め設計を、TypeScript の実装と実測値つきで整理しました。
Antigravity Agent に渡す Negative Spec の設計 — 5,000 万 DL アプリで使っている『触れてはならない領域』リスト
Antigravity の自律エージェントに『やってよいこと』ではなく『絶対に触れてはならない領域』を渡す Negative Spec の実装と、6 本のアプリを並行運営している現場で使っている運用ノウハウを整理しました。
Antigravity 長時間実行エージェントの監視設計 — watchdog と段階的リカバリ
長時間実行エージェントの3つの停止モードに対し、heartbeat プロトコルと watchdog タイマー、段階的リカバリで備える監視設計を解説します。8週間・142件の運用で得た段階別リカバリの成績と、実際にハマったポイントも包み隠さず公開しています。
Qwen3.7-Max が示す『35時間自律』の重み — Antigravity と Claude Code を併用する個人開発者の設計メモ
Alibaba Qwen チームの新モデル Qwen3.7-Max が公開した『35時間自律実行・1158回ツール呼び出し』のデモを起点に、Antigravity と Claude Code を併用している個人開発者の視点で、長時間自律タスクの設計・モデル選定・コスト試算を整理しました。
Antigravity Background Agent のフォレンジック設計 — 6 ヶ月後でも判断を再現できる Cloudflare R2 監査ログ運用
Antigravity Background Agent の本番運用が長期化したときに必要になる、6 ヶ月後でも判断理由を再現できる監査ログの設計を、Cloudflare R2 への書き込み層・PII マスキング・Polars クエリまで実装パターンとしてまとめました。
6 アプリ並行の iOS 更新を Antigravity の Main / Sub エージェントで束ねた実体験
Beautiful HD Wallpapers / Ukiyo-e Wallpapers / Relaxing Healing / Law of Attraction を含む 6 アプリの iOS 更新を、Antigravity の Main エージェント + 6 サブエージェント構成で並行運用した実装ノート。直列化すべきところと並列化すべきところの判断軸を残します。
AdMob メディエーション 50 グループ超を一人で回すために、エージェントへ渡した 4 工程と手元に残した 4 判断
iOS / Android の壁紙アプリ 2 本で AdMob メディエーション 50+ グループを運用しています。任せた 4 工程と握り続ける 4 領域の線引きに加えて、掲載していた判定コードに残っていた母数不足の穴と、その直し方をお伝えします。
Antigravity Agent の Record & Replay — 失敗を3分で再現する本番運用パターン
Antigravity の自律エージェントが本番で失敗した瞬間を、後からオフラインで決定的に再生する Record & Replay の設計と実装。実際に運用してきた経験から、ストレージ設計・PII マスク・ハーネスのコードまで具体的に解説します。
Antigravity のサブエージェントでリリース直前 QA を 4 経路並列に分散する設計ノート
6 本のアプリを並行運用する個人開発者の視点から、Antigravity のサブエージェントを使ってリリース直前 QA を 4 経路に分けて並列化する設計を書き残します。プロンプト雛形・終了条件・合流点までを実例付きで整理しました。
Antigravity の Browser Sub-Agent が SPA を空ページと誤認する原因と待機戦略
Antigravity の Browser Sub-Agent に SPA ダッシュボードを読ませると、本文が描画される前に get_page_text が返ってきて空ページ扱いされる。原因と、私の運用で安定した3つの待機パターンを整理しました。
Antigravity マルチエージェントの状態タイプ階層 — ephemeral / journal / canonical の3層設計と引き継ぎパターン
Antigravity の Background Agent と Sub-agent の状態を ephemeral / journal / canonical の3層に分け、Cloudflare KV / Durable Objects / R2 / D1 へ落とす判断軸と、write-back に承認ゲートを噛ませる TypeScript 実装。ヘッドレス実行で承認が素通りしていた頃の失敗も書き残しました。
Antigravity の並列エージェントで AdMob メディエーションを A/B 検証する実装ノート
累計 5,000 万 DL の壁紙アプリ群で AdMob メディエーションの A/B 検証を Antigravity の並列エージェントに任せた実装メモ。eCPM と ARPU の同時最適化、7 日サイクルの自動検証パイプライン、本番崩しを起こさないロールアウト設計を実装サンプルとともに共有します。
Antigravity エージェントのコスト按分設計 — 複数プロダクトで実行コストをテナントに帰着させる Showback アーキテクチャ
Antigravity の AI エージェントを複数プロダクトで並行運用する際の実行コストを、テナント単位で正しく按分する Showback アーキテクチャを、4 サイト × 6 アプリの実運用ログを添えて整理しました。
Antigravity の長時間バッチエージェントを完走させる — 4層の耐久設計と私の実装メモ
数時間〜数日にわたるバッチエージェントは、必ずどこかで落ちます。Antigravity を個人開発のアプリ運営自動化に組み込んだ実体験から、チェックポイント粒度・永続化レイヤ・冪等リストア・コンテキスト要約という 4 層の耐久設計を、実装コード・コスト試算・運用判断まで踏み込んでまとめました。
壁紙アプリの夜間アセット更新を Background Agent に任せる — 時間予算・重複検出・完了ゲートまで含めた運用設計
壁紙アプリの夜間アセット更新を Antigravity の Background Agent に任せた実運用記録を、再現できる形に落とし込みました。タスク定義の書き方、知覚ハッシュによる重複検出、12 プロファイル一括リサイズ、5 分で終わる朝の確認レポート、そして時間予算と完了ゲートの設計までをコード付きでまとめます。
Antigravity Agent のフォールバック階層設計 — モデル劣化・API障害・コスト超過を 4 段で受け止める Resilience アーキテクチャ
モデル応答の劣化・API 障害・コスト超過を4段階のフォールバック階層で受け止める Antigravity Agent の設計を解説します。Gemini 3 Pro から Gemma 4 ローカル推論、キャッシュ応答までの階層遷移を、6アプリ並行運用の実装ログに基づき整理しました。
Antigravity AIエージェントの『知識鮮度』を運用設計する — モデルカットオフ・コーパス老朽化・実世界時刻ずれを本番で扱う時間管理アーキテクチャ
Antigravity で動かす AI エージェントは、モデル側・RAG コーパス側・実世界側の三つの時間軸を別々に管理しないと、半年前のドキュメントを根拠に古い実装を提案してきます。Freshness Oracle と時間認識プロンプトで知識の鮮度を運用設計する実装パターンを、TypeScript の動くコードとともに整理しました。
Antigravity エージェントのプロンプトキャッシュとコンテキスト戦略 — 長期運用で月額APIコストを6〜8割削る実装パターン
長く回し続けるエージェントほど、月末の請求は地味に効いてきます。個人開発で5,000万DL規模のアプリ事業を回しながらAdMob収益と並走させてみたところ、プロンプトキャッシュとコンテキスト戦略の組み合わせで API 費用を 6〜8 割削減できた実装の手応えがありました。本番運用で実際に使っているキャッシュ階層・コンテキスト圧縮・TTL 設計を、コードと数値でまとめました。
リリース後72時間を Antigravity Background Agent に見張らせる：6アプリ並行アップデートで固まった指標監視ワークフロー
壁紙アプリ6本を並行リリースしてきた経験から、リリース直後72時間の指標崩れを Antigravity Background Agent に見張らせる運用設計を共有します。Firebase Analytics・Crashlytics・AdMob を統合した1通のMarkdownレポートに収束させる組み立て方を、実際のクエリと閾値ごと残しました。
本番運用で壊れない HITL 承認パイプライン — Antigravity Agent で確率的アクションを安全に流す設計
Antigravity Agent で実装する Human-in-the-Loop 承認パイプライン。信頼度スコアによるルーティング、監査ログ、段階的自動化、レビュアー UI の削ぎ落とし方を、個人運営の本番環境で踏んだ落とし穴とあわせて整理しました。
Crashlyticsの毎朝トリアージを5つのAntigravityサブエージェントに分担させた話
個人で6本のアプリを運営している中で毎朝のクラッシュトリアージが負担になり、Antigravityのサブエージェント5つに責務を分割しました。Fetcher/Classifier/Repro/Patch/PRの各段で人間レビューの境界線をどこに置いたかを、二週間の実運用データと合わせて記録します。
AntigravityのAgents機能をAndroidリリースフローに組み込んだ話——どこまで任せられて、どこで手を戻すか
壁紙アプリをAndroid v2.1.0へ上げる際、Antigravity Agentsをリリースフローに組み込んだ3ヶ月の実体験。クラッシュ診断の当たり外れ、段階公開のGo/No-Go判定、文脈設計のチェックリストまで、委譲の境界線を実コードとともに整理します。
AIエージェントに「なぜ」を伝える — コンテキスト設計5原則で判断ミスを防ぐ
AIエージェントが「正しいコード」で「間違った仕事」をする根本原因は、Whatだけ伝えてWhyを伝えていないことにあります。Antigravityエージェントへの意図コンテキスト設計5原則と、AGENTS.md・タスク指示・エラー診断の3つの実装パターンを解説します。
AIに任せた、そして後悔した — 個人開発者が気づいたエージェント委任の境界線
Antigravity エージェントへの委任で後悔した実体験をもとに、エージェントが得意な3つの作業類型と、人間が持ち続けるべき意図の境界を整理しました。委任前の5分間設計や、実装意図を残す AGENTS.md の活用方法もあわせて紹介します。
Antigravity エージェントの判断を追跡する — 意思決定ログと説明可能性の実装設計
AIエージェントが「なぜその判断をしたか」を記録・分析する意思決定ログの設計を、動作するPythonコード例とともに解説します。本番環境での予期しない動作を根本から追跡し、品質改善サイクルを実装します。
AI エージェントのカナリアデプロイと自動ロールバック — Antigravity と Burn-Rate SLO で本番を守る
AI エージェントの新バージョンを Antigravity 上でカナリアデプロイし、Burn-Rate SLO で自動ロールバックする実装パターン。個人開発でも回せる軽量運用のコード例付きで詳しく書きました。
Antigravity でエージェントと「完了」を合意する — Definition of Done をプロンプトに書き込む実践
Antigravity のエージェントが「途中までしか動かないコード」を返してくる原因の多くは、Definition of Done が共有されていないことにあります。3つの層で完了条件を組み立てて、プロンプトに書き込む実践方法をまとめました。
Antigravityでルートと子フォルダのAGENTS.mdが衝突するときの解決法
monorepoでルートとサブフォルダの両方にAGENTS.mdを置くと、エージェントがどちらの指示を優先するかわからず混乱します。Antigravityの読み込み順序と、衝突を回避する書き方を実例で整理します。
AntigravityのAIエージェントに『時間予算』を持たせる — タイムアウト・優先度・締切を統合した本番スケジューリング設計
AIエージェントの応答が遅すぎてユーザーが離脱する、想定外のコストが発生する。Antigravityのエージェントに『時間予算』という一つの概念を持たせ、タイムアウト・優先度・締切を束ねる実装と、半年の運用で踏んだ落とし穴を書き残します。
Antigravityのエージェントから.envが読まれないときに最初に疑うべき3つの伝搬経路
Antigravityのエージェント実行時だけ.envが読まれずMissing API_KEYで止まる現象を、GUI起動・AGENTS.md誤解・dotenv未ロードの3経路に分けて整理し、確実に伝搬させる4ステップを示します。
Antigravity Agent の出力に「自信スコア」を付ける — 確実な処理は自動承認、曖昧な判断だけ人に渡す設計
Antigravity Agent の出力すべてを人がレビューしていては運用が回りません。出力に「自信スコア」を付け、確実なものは自動承認、曖昧なものだけエスカレーションする graduated approval パターンを、実装例とキャリブレーション手法まで含めて解説します。
AIエージェントの「自己批評」アーキテクチャ — Antigravityで信頼できる出力を生む4つの内省パターン
AI エージェントの出力品質を上げる自己批評アーキテクチャを、Critic-Generator 分離型・Self-Reflection 一体型・多視点レビュー型・信頼度ゲート型の4パターンで整理しました。内省の暴走を止める停止条件と本番での失敗例も紹介します。
AIエージェントのリプレイ設計 — 過去のセッションを再現する時間旅行デバッグの作法
本番のAIエージェントで一度きり起きた不具合を、開発機で再現できるようにします。Antigravity の Manager Surface とイベントログを組み合わせた、決定論的リプレイ・因果リプレイ・監査リプレイの3層設計を、TypeScript の実装コードで解説します。
エージェントに「審美眼」を持たせる — Antigravity × Gemini Vision で構築する UI 品質自動評価パイプライン
「このUIは良いか悪いか」という曖昧な判断をコードに落とし込む方法を探ります。Antigravity と Gemini Vision を組み合わせて、スクリーンショット取得からAI評価、改善提案、自動修正、CI/CD統合までを一本のエージェントパイプラインとして実装します。
マルチエージェント環境でSKILL.mdを一元管理する — gh skillによる企業・チーム向けスキルポータビリティの設計
複数のAIエージェントを使うチームでSKILL.mdを効率的に管理・配布する方法。gh skillのプロファイル設計、CI/CDによる整合性検証、エージェント別の解釈能力差の吸収戦略を実装コード付きで解説します。
「gh skill」でAIエージェントをまたいでスキルを共有する — Claude Code・Copilot・Cursorが同じ知識を参照できる仕組み
gh skillコマンドを使うと、SKILL.mdで定義したスキルをClaude Code・GitHub Copilot・Cursor・Gemini CLIなど複数のAIエージェントで共有できます。仕組みと基本的な使い方を解説します。
AIコーディングエージェントを実務で使い分ける — Claude Code・OpenCode・Cursor・Gemini CLI（2026年版）
2026年のAIコーディングエージェントは群雄割拠の状態です。Claude Code・OpenCode・Cursor・Gemini CLIそれぞれの強みと限界を実務視点で比較し、プロジェクト特性に応じた使い分けの基準を整理します。