すべての記事
エージェントに API キーを安全に渡す — 実行時の環境変数注入とログ漏洩の遮断
デプロイ用トークンが無人ランのログに残っていた反省から、実行の瞬間だけ環境変数を注入する起動ラッパー、出力から鍵を消すマスキングフィルタ、コミット前の二段スキャンゲートという3つの遮断層を実装した手順と、導入後に変わったことをまとめました。
画像の一括最適化をエージェントに任せる前に置く、見た目の劣化を止めるゲート
壁紙アプリの数百枚のアセットをエージェントに一括再エンコードさせたら、数枚だけ色がくすんでいました。サイズ削減率だけでは劣化を見抜けません。SSIM・ΔE・ファイルサイズの3軸でマージ前に不良変換を弾くゲートの設計と、Pillow と scikit-image で動く判定スクリプトをまとめます。
無人ランのログを SQLite に流し込み、失敗を横断で数える
Antigravity CLI を無人スケジュールで回すと、ランごとに JSON Lines のログが溜まっていきます。ファイルを grep で追うのをやめ、小さな SQLite に取り込んで「どのステップがいつ落ちるか」を1本のクエリで数える方法を、取り込みスクリプトと診断 SQL、実際の集計結果ごと共有します。
会話パネルの幅を変えたら、エージェントのレビューが速くなった話
Antigravity v2.2.1 で追加された Conversation Width と構文ハイライトの拡充を、エージェントが生成した diff を読み切る作業に落とし込んだ実運用メモです。表示設定という地味な調整が、レビューの手数をどう変えたかを記録しました。
Antigravity のエージェントに任せる作業と任せない作業を2週間の運用で見直す
個人開発の日々のタスクを2週間 Antigravity のエージェントに渡し続けた運用ログから、任せて正解だった作業と手元に引き戻した作業の分かれ目を振り返ります。自信満々に間違える瞬間への備えや、任せ方そのものの設計についても述べています。
自分のDSLがモノクロのままだった — Antigravity に最小構成の TextMate 文法を足して色を通す
個人開発で使う独自の設定ファイル（DSL）がエディタで真っ白なままだと、読み違いが増えます。Antigravity に最小構成の TextMate 文法とlanguage-configuration を足して、独自ファイルにハイライトを通すまでの手順を、動くコードと落とし穴つきで整理します。
書き込みより怖いのは到達先だった — エージェントの外向き通信を許可ホストだけに絞る
エージェントに実作業を委ねるとき、私が一番警戒しているのはファイルの書き換えではなく、どこへ通信するかです。到達先を deny-by-default で絞る小さなゲートの実装と、21晩の無人運用で拾った通信の内訳をまとめました。
A2A のタスクが working のまま静かに滞留していたとき — 状態遷移を計測して詰まりを名指しする運用メモ
Antigravity の A2A 連携は、エラーで落ちるより「タスクが working のまま進まない」形で静かに詰まります。状態遷移を一本の時系列として記録し、滞留したタスクをどのエージェントのどの辺で止まったかまで名指しする監視の実装を、運用の実感とあわせて整理します。
エージェントの時計設計 — 単調時計と壁時計を分けて長時間運用を守る
スケジュール実行や夜間の長時間エージェント運用で、タイムアウト・リトライ間隔・レート制限窓を壁時計で計算すると静かに壊れます。単調時計と壁時計の役割を分ける小さな Clock 抽象と、決定表・テスト可能な実装を交えて設計を整理します。
新しいマシンで Antigravity が別人になった — 移行で持ち越せるもの・作り直すもの・リポジトリへ逃がすもの
Settings Sync で設定は数分で戻るのに、認証・インデックス・ローカルLLMは戻らない。マシン買い替え時の Antigravity 環境を三つの層に分け、持ち越す・作り直す・リポジトリへ逃がすの順で整理した実践メモです。
エージェントが足した行だけを見たい — 変更行スコープの規約リンターで、レガシーの警告に埋もれない
エージェントに小さな修正を頼んだら、古いファイルに触れた瞬間に警告が13件出て、どれがエージェントの仕業か分からなくなりました。変更行だけに規約を当てるリンターを組んだら、13件が3件へ、約77%減りました。差分から追加行を取り出し、そこだけを検品する仕組みを、動くコードでまとめています。
許可を尋ねられても、答える人がいない — 統一パーミッションを無人実行の契約として書く
v2.2.1 の統一パーミッションは対話を前提にしています。深夜に走るスケジュール実行では、その前提が崩れます。allow / deny / queue の三分法でポリシーを事前宣言し、無人でも止まらない契約として書き下す設計をまとめました。