エージェントのコミットに .bak が混じる — 自動修正ツールの副産物がリポジトリに入る原因と対処
エージェントに --fix 系ツールを走らせた後のコミットに .bak や .orig が紛れ込む症状について、再現条件と原因、ステージ範囲の限定・副産物の即時掃除・pre-commit での拡張子ゲートという3つの対処をまとめました。
半年前にエージェントが書いた行の意図を追えるようにする — コミット粒度と来歴トレーラの設計
エージェントが 14 ファイル 800 行を 1 コミットに詰め込むと、半年後の git blame は何も語ってくれません。コミットを意図の単位に割り、Git trailer に来歴を機械可読で残し、blame から設計判断まで逆引きする仕組みを、動くコードとともにまとめます。
エージェントが書いたファイルが .gitignore に飲まれる — commit 前に気づくための検出ゲート
エージェントが生成したファイルが .gitignore に一致していると、差分レビューでは正常に見えるのに commit には含まれません。ignored な生成物を push 前に検出するゲートスクリプトと、その運用調整をまとめました。
エージェントに任せた仕事の「やり直し率」を測る — 委譲境界を勘ではなく数字で引く
どこまでをエージェントに任せるか。この線引きを私は長らく勘で引いていました。タスク種別ごとの「やり直し率」を git 履歴から算出し、委譲境界を数字で引き直す実践を、動くコードとともに整理します。
エージェントのコミットに余計なファイルが混ざる問題を、ステージング範囲とメッセージ規約で断つ
エージェントに任せたコミットに .bak やキャッシュが紛れ込み、メッセージが「Fix」だけになる。ステージング範囲の許可リストとプリフライト、埋めるだけのメッセージ規約でこの事故を止めます。
並列エージェントは生成物も並列に増える — 中間生成物の寿命と掃除の設計
worktree・スクリーンショット・一時ブランチなど、並列エージェントが残す中間生成物に寿命を定義し、未コミット作業を守りながら自動で掃除する設計を実測値とともに紹介します。
Antigravity が一気に書いた巨大な差分を、意味単位のコミットに分け直す
エージェントが書いた数百行の差分を、そのままコミットしていませんか。レビューできない一括コミットを、関心ごとに分け直すための実践的なワークフローとスクリプトを紹介します。
エージェントのコミットを pre-commit で止める — 壊れた変更を本番リポジトリに入れない仕組み
Antigravity のエージェントが書いたコードを、コミットの瞬間に lint・型チェック・高速テスト・秘密情報スキャンで自動検査する pre-commit ゲートの組み方を、実測の所感とともにまとめました。
「完了しました」のあとに検証を置く — Antigravity のバックグラウンドエージェントの成果を確かめる運用
Antigravity 2.0 のバックグラウンドエージェントが「完了しました」と報告したのに、成果物がどこにも残っていない。個人開発で複数サイトを自動運用するなかで何度かぶつかったこの落とし穴と、自己申告ではなく地上の事実を見る検証ステップの組み方を整理しました。
エージェントに品質チェックを飛ばさせない — Antigravity CLI Hooks と git pre-push の二段ゲート設計
依存更新を任せたエージェントが、落ちたテストを『無関係』と自己判断して push まで進めてしまった経験から、Antigravity CLI の Hooks と git pre-push を重ねた二段ゲートを組みました。品質チェックの省略を仕組みで防ぐ設定とスクリプトの実物をまとめています。
AIエージェントの git push が成功表示なのにリモートへ反映されないときの原因と対処
エージェントに任せた git push が「Everything up-to-date」のまま空振りし、リモートに何も反映されない症状について、再現条件と原因、identity 明示・SHA 照合・GitHub REST API という3つの対処をまとめました。
Antigravity の Agent から git push したら permission denied になるときの切り分けと恒久対策
Antigravity でエージェントに任せた作業の最後、git push で「remote: Permission to ... denied」「fatal: Authentication failed」と弾かれる問題。複数アカウント・PAT・SSH/HTTPS 混在環境で起きる認証エラーを、現場で使っている診断フローに沿って切り分け、恒久的に塞ぐ方法をまとめました。