Git が追跡しているのにエージェントが読めないファイルは、どこで外れているか
エージェントのコード検索が返した2ファイルに対し、git grep は6ファイルを返しました。追跡済みのファイルが検索から静かに落ちる3つの経路を合成リポジトリと運用中のリポジトリで実測し、除外理由の特定手順と戻し方をまとめました。
Canary 継続配信になった Android 17 で、エージェントには「報告しない条件」から先に渡しました
Android 17 が Developer Preview をやめて Canary の継続配信に切り替わり、検証の締め切りが自分の側に移りました。更新を追う担当をエージェントへ渡すにあたり、報告の条件ではなく沈黙の条件から設計した記録です。
agent.md の綴り誤りが権限を広げていた — frontmatter を厳格に検証する lint を書く
agent.md の frontmatter は綴りを間違えてもエラーになりません。既定値へ静かに落ちた結果、意図と逆の権限が適用されていた実例と、権限キーだけを厳しく検証する lint の実装・実測を記録しました。
パスの空白ひとつで、エージェントのコマンド9形が「0件・成功」を返しました
パスの空白ひとつで、エージェントのコマンドが「0件・成功」を返していました。未引用パスの11形で挙動を実測し、引用の徹底では守りきれない部分を確認した上で、相対パスと入口を一本化する ws.sh、3行で足りる規約に落とし込むまでの記録です。
Android 17 のローカルネットワーク権限 — LAN に触る箇所を機械で洗い出してから、エージェントに直させる
新しい API レベルではローカルネットワークへの明示的な許可が必要になります。grep では 11 経路のうち 2 つしか見つかりませんでした。経路の種類で拾う検出器と、エージェントに渡せる作業単位への畳み方を実測とともに。
エージェントに渡した参照メモの7割は届いていませんでした — head で切る運用の限界を測った記録
head で行数を切って渡していた参照メモの7割がエージェントに届いていなかった、という実測に基づく記録です。行数ではなくセクション単位の契約で切り取り境界を設計し直し、予算内で何を残すかを決めるまでの過程を、検証データとともにまとめています。
作業中のエージェントに、次の指示をいつ渡すか — 待つ・割り込む・積むを実運用で測りました
Antigravity v2.3.0 で入ったメッセージのキューイングと Send Now。待つ・割り込む・積むの三択を同じ物差しで測り、積んだ指示が古くなる問題と、前提スタンプで手戻りを22%から9%へ下げた記録をまとめました。
エージェントのコミットに .bak が混じる — 自動修正ツールの副産物がリポジトリに入る原因と対処
エージェントに --fix 系ツールを走らせた後のコミットに .bak や .orig が紛れ込む症状について、再現条件と原因、ステージ範囲の限定・副産物の即時掃除・pre-commit での拡張子ゲートという3つの対処をまとめました。
エージェントに API キーを安全に渡す — 実行時の環境変数注入とログ漏洩の遮断
デプロイ用トークンが無人ランのログに残っていた反省から、実行の瞬間だけ環境変数を注入する起動ラッパー、出力から鍵を消すマスキングフィルタ、コミット前の二段スキャンゲートという3つの遮断層を実装した手順と、導入後に変わったことをまとめました。
Antigravity のエージェントに任せる作業と任せない作業を2週間の運用で見直す
個人開発の日々のタスクを2週間 Antigravity のエージェントに渡し続けた運用ログから、任せて正解だった作業と手元に引き戻した作業の分かれ目を振り返ります。自信満々に間違える瞬間への備えや、任せ方そのものの設計についても述べています。
書き込みより怖いのは到達先だった — エージェントの外向き通信を許可ホストだけに絞る
エージェントに実作業を委ねるとき、私が一番警戒しているのはファイルの書き換えではなく、どこへ通信するかです。到達先を deny-by-default で絞る小さなゲートの実装と、21晩の無人運用で拾った通信の内訳をまとめました。
エージェントの時計設計 — 単調時計と壁時計を分けて長時間運用を守る
スケジュール実行や夜間の長時間エージェント運用で、タイムアウト・リトライ間隔・レート制限窓を壁時計で計算すると静かに壊れます。単調時計と壁時計の役割を分ける小さな Clock 抽象と、決定表・テスト可能な実装を交えて設計を整理します。