4,000行のログをエージェントに渡す三つの道 — 貼り付け・.txt 添付・@ 参照を測り分ける
v2.3.0 でプレーンテキスト添付に対応しました。長いログをエージェントへ渡す手段が三つに増えたことで、どれをいつ選ぶかという新しい迷いが生まれています。切り出し・計測・判断フローを実装込みで整理しました。
AGENTS.md を厚くするほどルールが守られなくなった — 遵守率を計測して指示を削るまで
AGENTS.md を厚くするほどルールが守られなくなる現象を、ルールを述語に分解して3週間分の遵守率として計測しました。console.log 残留の見逃しから始まった検証と、残すルール・lint に移すルールを分けて書き直すまでの一部始終を記録しています。
作業中のエージェントに、次の指示をいつ渡すか — 待つ・割り込む・積むを実運用で測りました
Antigravity v2.3.0 で入ったメッセージのキューイングと Send Now。待つ・割り込む・積むの三択を同じ物差しで測り、積んだ指示が古くなる問題と、前提スタンプで手戻りを22%から9%へ下げた記録をまとめました。
エージェントのコミットに .bak が混じる — 自動修正ツールの副産物がリポジトリに入る原因と対処
エージェントに --fix 系ツールを走らせた後のコミットに .bak や .orig が紛れ込む症状について、再現条件と原因、ステージ範囲の限定・副産物の即時掃除・pre-commit での拡張子ゲートという3つの対処をまとめました。
エージェントが足した依存を、インストール前に検疫する — postinstall を既定で止めて通す設計
npm install の postinstall を既定で止め、エージェントが足した依存をインストール前に検疫する設計です。スクリプトを持つ依存の棚卸し、新規依存への検疫スコア付け、無人ランへの差し込みを実装し、導入後1ヶ月の運用も振り返ります。
無人ランで作業フォルダが突然『別の人の持ち物』になる — 所有者ドリフトを検知して書ける場所へ逃がす
数週間緑だった無人スケジュールが、ある朝 git config を書けずに止まりました。原因は永続作業フォルダの所有者ドリフト。存在チェックでは通り書き込みだけが弾かれる罠を切り分け、書込可否を実測して別の場所へ逃がすプリフライトを実装まで残します。
ls には見えるのに、エージェントが開けない — 日本語ファイル名が macOS と Linux で別物になるとき
エージェントが「そのファイルは存在しません」と言い、ターミナルの ls には確かに写っている。三日かけて同期を疑った末に辿り着いたのは、濁点が一文字ではなかったという事実でした。検出スクリプトと三層ゲートまで残します。
AdMob を載せた画面のスクリーンショットテストを、広告の非決定性から守る
広告つきの画面はスクリーンショットテストが毎回赤くなり、やがて誰も差分を見なくなります。AdMob バナーの非決定性を封じ、レイアウトの崩れだけを検知に残す設計を、Compose の実装例と Antigravity での差分トリアージまで含めてまとめます。
デプロイは成功なのに、ユーザーには古いビルドが出ていたとき — 出荷したコミットがエッジに届いたかを検証するゲートの運用メモ
CI は緑、デプロイも成功表示、それでも本番には古いビルドが残っていた——その経験から、出荷したコミットがエッジに届いたかを検証するゲートを作りました。ビルドへの印の焼き込み、エッジからの実物取得、キャッシュの罠と実測効果をまとめた運用メモです。
ローカル Gemma とクラウド Gemini 3.5 Flash を「検証しやすさ」で振り分ける設計
ローカルとクラウドの振り分けを「機密かどうか」「速いかどうか」で決めていた頃、判断が毎回ぶれていました。本当に効いた軸は、出力が間違っていたときに安く気づけて安く戻せるか、でした。検証しやすさと復旧コストからモデルを選ぶルーターを、判定コードと実測ログの設計まで含めて組み立てます。
AGENTS.md を一行直したら挙動が崩れた — 指示そのものを回帰テストする仕組み
エージェントに渡す指示(AGENTS.md やスキル文)を直すたびに、別のタスクが静かに壊れます。コードでなく指示を被験体にした回帰ハーネスを、固定タスク集と決定的アサーションで実装し、無人運用に組み込むまでを示します。
エージェントに API キーを安全に渡す — 実行時の環境変数注入とログ漏洩の遮断
デプロイ用トークンが無人ランのログに残っていた反省から、実行の瞬間だけ環境変数を注入する起動ラッパー、出力から鍵を消すマスキングフィルタ、コミット前の二段スキャンゲートという3つの遮断層を実装した手順と、導入後に変わったことをまとめました。