StoreKit 2 で「課金したのに使えない」と言われたとき — サブスク権利状態のズレを直す運用メモ
StoreKit 2 のサブスクリプションは実装より運用でつまずきます。currentEntitlements と subscription.status のズレ、Transaction.updates の取りこぼし、未 finish トランザクション、復元と返金の扱いを、本番で効いた整流ロジックとともに記録します。
シェア画像の日本語だけが □ になる — Antigravity に next/og の CJK フォント供給を直させた実装メモ
next/og の ImageResponse で日本語タイトルだけが豆腐（□）になる。原因の Satori と woff2 の関係を解きほぐし、Google Fonts の text= サブセットをエッジで軽量に引き当てる実装を、Antigravity に直させる手順とあわせて記録します。
入れ子になったAGENTS.mdの優先順位 — 複数プロジェクトを一つのワークスペースで束ねる合流設計
一つのワークスペースに複数のプロジェクトを置き、それぞれにAGENTS.mdを持たせると、エージェントはどの指示に従うのか曖昧になります。ルートと各プロジェクトの指示が静かに衝突し、片方だけが効いたり両方が混ざったりします。「近いほど強い」を基本則に、上書きと追記を区別して合流させる設計を、動くPython実装と運用の所感つきでまとめました。
保存するエージェントログから秘密を消す — 投入前のリダクション層を設計する
無人で走るエージェントのログを残し始めると、いつかトークンやAPIキーが平文で記録されます。ローテートしても、流出したログは消えません。書き込みの直前で秘密を確実に落とすリダクション層を、正規表現だけに頼らず既知の秘密を登録して消す方式まで含めて、動くPython実装と運用の所感つきで設計します。
エージェントに渡すMCPツールを絞る — 最小権限の許可リスト設計
Antigravity 2.0 に MCP サーバーを足していくと、各エージェントが触れるツールはいつの間にか「全部入り」になります。読み取りしか必要ないエージェントに削除系ツールまで見えている状態は、いつか事故を起こします。ツールをエージェント単位の許可リストで絞り、呼び出し直前で弾き、破壊的操作だけ二段階にする最小権限の設計を、動くPython実装と運用の所感つきでまとめました。
Antigravity の独自ツールが本番で事故るのは『設計』ではなく『再実行』のとき — 冪等化とエラー契約の運用メモ
Antigravity エージェントに独自ツールを足したあと、実運用で本当に問題になるのは再実行と二重副作用です。冪等キー・エラー契約・ヘルスゲート・ツール乱立の抑制を、実装と判断基準ごと整理しました。
並列エージェントの同時実行数を固定しない — 観測した詰まりから自動で増減させる設計
Antigravity 2.0 で複数エージェントを並列に走らせるとき、同時実行数を固定値で決め打ちすると昼は429で詰まり夜は能力を遊ばせます。TCPの輻輳制御に学んだ適応制御（加法的増加・乗法的減少）で、詰まりの兆候から同時実行数を自動で増減させる設計を、動くPython実装と実測の所感つきでまとめました。
戻るボタンで広告が出る／出ないが安定しない — 入れ子のifを独立ガードのリストに作り替えた記録
戻るボタン押下時のインタースティシャル表示判定が、入れ子のif文で優先度が暗黙化して壊れていました。各条件を理由つきの独立ガードに分解し、決定表からテストを生成した設計をまとめます。
エージェントが足した依存を、あとから棚卸しする — ライセンスと出所を追える形で残す設計
エージェントに任せて数ヶ月が経つと、package.json に見覚えのない依存が静かに増えていきます。何が・いつ・なぜ足されたかを後から追える形に整える、棚卸しと出所記録の設計をまとめます。
長く走ったエージェントが何をしたかを遡る — 会話内検索を起点にしたレビュー術
Antigravity v2.1.4 で加わった会話ビュー内の検索を、長時間エージェントのレビューの起点として使う方法を整理します。検索語の選び方、見るべき分岐点、背景エージェントのログ突き合わせまで、実際の手順を具体的にまとめました。
Background Agent に夜間作業を任せて、朝に後悔しないために — 無人実行のガードレール設計
Antigravity の Background Agent に夜間リファクタを任せると、朝には便利さと同じだけの不安が届きます。被害範囲・完了条件・静かな劣化の検出という3点から、無人実行を安心して回すためのガードレール設計を運用視点でまとめました。
Antigravity CLI の JSON Lines 出力を自作スクリプトで受ける — 部分行と終了コードでつまずいた記録
Antigravity CLI の機械可読出力（JSON Lines）を自前スクリプトに流し込むと、3回に1回ほど JSONDecodeError で止まりました。部分行・終了コード・stderr 混入という3つの罠と、行バッファリングで安定させた実運用の受け口を記録します。