すべての記事
Managed Agents API を動かして考えた、クラウド実行と手元実行の境界線
Gemini API の Managed Agents（公開プレビュー）を Python から起動し、ポーリング・アーティファクト回収・コストガードまで実装した記録です。手元の CLI エージェントとの使い分け基準も5項目にまとめました。
依存ライブラリの更新を Antigravity エージェントに任せる運用設計 — リスク階層・検証・巻き戻し
溜まり続ける依存更新の通知を、Antigravity のエージェントにどこまで任せられるか。semver を実績で補正するリスク4階層、worktree によるロット隔離、検証と巻き戻しの定型化まで、複数アプリ運用で固めた設計を実物のスクリプトつきで共有します。
Antigravity エージェントへの依頼は「レビューできる単位」で切る — 手戻りを減らすタスク設計
1行の依頼で40分待った結果を月曜に書き直した失敗から、エージェントへのタスクを「自分が15分でレビューできる単位」で切る運用に変えました。実際の依頼文3通、受け入れ条件の書き方、worktree 並列時のファイル境界の切り方まで実例で残します。
6 サイトを一人で回すための自律エージェント・スケジュール設計 — 衝突とスパム判定を避ける時間割
個人開発者が 6 つのサイトとアプリ事業を一人で並行運用するために組んだ、自律エージェントのスケジュール設計の実例です。オフピーク分散・1日あたりの生成上限・タスク衝突の回避を、実際の時間割と判断基準からまとめました。
エージェントに渡す道具の粒度を決める — 粗くまとめるか、細かく分けるか
エージェントに与えるツールを細かく分けるか粗くまとめるか。判断軸を「意図1つ＝ツール1つ」に置き、破壊的操作だけ粒度を下げる設計を、6アプリ運用の実コードと実数値で解説します。
やり直せる操作とやり直せない操作を分けて任せる — 可逆性で自律度を決めるエージェント設計
Antigravity のエージェントに本番作業を任せるとき、賢さより先に効いてくるのは「その操作をあとから取り消せるか」です。操作を可逆性で3階層に分け、自動実行・チェックポイント付き実行・人間ゲートへ振り分ける設計を、TypeScript の実装と6アプリ並行運用の実測値つきで整理しました。
Antigravity のエージェント出力からシークレットを漏らさない多層防御 — ログ・差分・PR 本文を守る実装メモ
バックグラウンドエージェントの出力にシークレットが混入する3つの経路と、コミット差分・実行ログ・PR本文を守る多層防御の実装を、6アプリ運用の実体験と具体数値とともにまとめました。
Antigravity のエージェントに『差分を小さく刻む』癖をつけてもらう — 1ヶ月の運用で変えたレビューの流儀
エージェントが一度に大きな差分を返すと、個人開発ではレビューが追いつかなくなります。Antigravity に『小さく刻んで』と最初に頼むようにして1ヶ月、レビューの体感がどう変わったかを、実際に渡している指示文とともに残しました。
本番に触れる前にエージェントの操作を空振りさせる — 副作用ゼロのドライラン層をどう設計するか
シャドウ実行やカナリアでも防げない事故があります。エージェントが外部APIに初めて触れる、その一回目を安全にするための「副作用ゼロのドライラン層」を、Antigravity の並列エージェントに後付けで差し込む設計と実装を、6サイト自律運営の実数値とともに共有します。
並行エージェントのトークンコストを予算で抑える — 暴走を止めるバジェットガードの設計
複数のエージェントを並行で走らせると、トークン費は気づかないうちに膨らみます。トークンを減らす最適化ではなく、予算で消費を遮断するガバナンス層を Antigravity の並列エージェントに組み込む設計と実装を、6サイト自律運営の実数値とともに共有します。
途中で失敗したエージェントの副作用を巻き戻す — 補償トランザクション設計の実装メモ
Antigravity のエージェントに複数の外部システムをまたぐ作業を任せると、途中の一段が失敗したときに半分だけ世界が書き換わって残ります。やり直しでは直らないこの状態を、補償トランザクション（Saga）で安全に巻き戻す設計を、TypeScript の実装と実運用の数値つきで整理しました。
自律エージェントの流量を制御する — バックプレッシャーと待ち行列で本番を壊さない設計
Antigravity のエージェントを複数同時に走らせると、賢さより先に「下流が捌けない」問題にぶつかります。同時実行数・到着レート・処理能力の3つで流量を捉え、待ち行列・セマフォ・トークンバケット・バックプレッシャーで本番を守る設計を、TypeScript の実装と実測値つきで整理しました。