コマンドが読めなくても、エージェントの作業で見る場所は3か所で足ります
エージェントがターミナルに流す文字列が読めず、承認ボタンを押すのが怖い方へ。作業前の戻り口・実行前の動詞・終了後の差分という3か所だけを見る、非エンジニア向けの確認線の引き方です。
Antigravity の自動コミットメッセージを、どこまで受け入れるか決めました
Review ペインの自動コミットメッセージを、どこまで受け入れてどこから自分で書くか。prepare-commit-msg に Why 行を足す実装と、リベースやリバートで手が止まった実測を書き残します。
Antigravity 2.10.0 の埋め込みターミナルで、エージェントの変更を検証するループを組む
2.10.0 でサイドバーから直接ターミナルを開けるようになりました。エージェントの変更を通す前の検証を3つのコマンドに固定し、変更ファイルだけを対象にする手順を、実測値とスクリプト付きでまとめます。
7桁ハッシュが指しているのはコミットだけではない — エージェントの記録が解決不能になる境界を測る
7桁の短縮ハッシュが git log では通るのに git show では落ちる——プレフィックス探索がオブジェクト全体に及ぶことが原因でした。衝突境界の計算、記録側を完全ハッシュに直す設計、散らばったログを検査する fail-closed ゲートを紹介します。
同じ履歴を読むのに 38 秒と 0.4 秒 — 読み取り専用になった .git をエージェントへどう渡すか
Antigravity CLI 1.1.10 でサンドボックスから .git を読み取り専用で参照できるようになりました。履歴要約を毎セッション渡すための実装を2通り書いて実測し、約100倍の速度差とその原因、shallow clone で集計が静かに壊れる問題への対処をまとめます。
Antigravity で CHANGELOG.md を git ログから半自動で書く — 個人開発でも意思決定の履歴を残す
半年前の自分の判断が思い出せない — 個人開発でよくある問題です。Antigravity に git log を読ませて CHANGELOG.md のドラフトを作る半自動ワークフローを、実際のスクリプト付きで紹介します。
エージェントのコミットに .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 などの中間生成物でした。何がどこに残るのかの棚卸し、消してよいかを疑い深く判定する安全ガード、週次 dry-run と月次実行で回す掃除タスクの設計を、実測とともにまとめます。