エージェントの時計設計 — 単調時計と壁時計を分けて長時間運用を守る
スケジュール実行や夜間の長時間エージェント運用で、タイムアウト・リトライ間隔・レート制限窓を壁時計で計算すると静かに壊れます。単調時計と壁時計の役割を分ける小さな Clock 抽象と、決定表・テスト可能な実装を交えて設計を整理します。
Android CLI が3倍速・トークン7割減になったとき、増やすべきは並列数ではなく1件あたりの検証だった
Android CLI のエージェントが3倍速・トークン約7割減になった、というニュースを見て最初に考えたのは「では何本同時に走らせようか」でした。けれど速くなって本当に変わるのは生産量ではなく、詰まる場所です。レビューと検証ゲートに移ったボトルネックを Little's Law で見積もり、WIP キャップで並列数を抑え、浮いた予算を1件あたりの検証に回す設計を、動く Python 実装と実測値でまとめました。
429に潰されないスケジュール — エージェント自動化のバックオフとジッター設計
複数のエージェントを並列に走らせると、レート制限の429が連鎖して全滅する瞬間があります。指数バックオフとジッターをどう設計すれば、リトライ自身が新たな混雑を生まないかを、個人開発の自動運用からまとめます。
失敗したエージェントジョブを取りこぼさない — デッドレターと再投入の設計
スケジュール実行のエージェントが夜間に失敗したまま消えていく問題を、デッドレター退避と段階的な再投入で防ぐ設計を、複数サイトを自動運用する個人開発の現場からまとめます。
やり直せる操作とやり直せない操作を分けて任せる — 可逆性で自律度を決めるエージェント設計
Antigravity のエージェントに本番作業を任せるとき、賢さより先に効いてくるのは「その操作をあとから取り消せるか」です。操作を可逆性で3階層に分け、自動実行・チェックポイント付き実行・人間ゲートへ振り分ける設計を、TypeScript の実装と6アプリ並行運用の実測値つきで整理しました。
途中で失敗したエージェントの副作用を巻き戻す — 補償トランザクション設計の実装メモ
Antigravity のエージェントに複数の外部システムをまたぐ作業を任せると、途中の一段が失敗したときに半分だけ世界が書き換わって残ります。やり直しでは直らないこの状態を、補償トランザクション（Saga）で安全に巻き戻す設計を、TypeScript の実装と実運用の数値つきで整理しました。
自律エージェントの流量を制御する — バックプレッシャーと待ち行列で本番を壊さない設計
Antigravity のエージェントを複数同時に走らせると、賢さより先に「下流が捌けない」問題にぶつかります。同時実行数・到着レート・処理能力の3つで流量を捉え、待ち行列・セマフォ・トークンバケット・バックプレッシャーで本番を守る設計を、TypeScript の実装と実測値つきで整理しました。
エージェントが壊す前提で組む — ブラスト半径を小さく保つ運用設計
Antigravity のエージェントに本番作業を任せ始めると、性能より先に「事故ったときの被害範囲」が問題になります。ブラスト半径を縮小する4層の封じ込め設計を、TypeScript の実装と実測値つきで整理しました。