すべての記事
半年前にエージェントが書いた行の意図を追えるようにする — コミット粒度と来歴トレーラの設計
エージェントが 14 ファイル 800 行を 1 コミットに詰め込むと、半年後の git blame は何も語ってくれません。コミットを意図の単位に割り、Git trailer に来歴を機械可読で残し、blame から設計判断まで逆引きする仕組みを、動くコードとともにまとめます。
エージェントが書いたファイルが .gitignore に飲まれる — commit 前に気づくための検出ゲート
エージェントが生成したファイルが .gitignore に一致していると、差分レビューでは正常に見えるのに commit には含まれません。ignored な生成物を push 前に検出するゲートスクリプトと、その運用調整をまとめました。
エージェントに任せた仕事の「やり直し率」を測る — 委譲境界を勘ではなく数字で引く
エージェントへの委譲境界を勘ではなく数字で引くために、タスク種別ごとの「やり直し率」を 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つの定義を対話でも無人でも同じ挙動にする設計を、動くコードとプリフライト検査つきでまとめます。