半年前にエージェントが書いた行の意図を追えるようにする — コミット粒度と来歴トレーラの設計
エージェントが 14 ファイル 800 行を 1 コミットに詰め込むと、半年後の git blame は何も語ってくれません。コミットを意図の単位に割り、Git trailer に来歴を機械可読で残し、blame から設計判断まで逆引きする仕組みを、動くコードとともにまとめます。
エージェントが書いたファイルが .gitignore に飲まれる — commit 前に気づくための検出ゲート
エージェントが生成したファイルが .gitignore に一致していると、差分レビューでは正常に見えるのに commit には含まれません。ignored な生成物を push 前に検出するゲートスクリプトと、その運用調整をまとめました。
審査リジェクトの朝に慌てないために — App Store の指摘をエージェントで分類し、再提出までの手順を固定する
App Store 審査リジェクトの文面を Antigravity に渡して分類し、ガイドライン別プレイブックと Info.plist リントで再提出まで最短で戻す運用設計。実測の所要時間短縮も紹介します。
背景スケジューリングで自分のピークを作らない時刻分散設計
Antigravity 2.0 のデスクトップは背景でタスクを自動スケジュールします。便利な反面、丸い時刻に寄せると自分でピークを作り、深夜のジョブがまとめてこけます。時刻を散らして重なりを禁じる設計を実例でまとめます。
Guide スキルとコードの乖離を検出して直す仕組み
Guide スキルに書いた手順がコードの変更で静かに古びていく問題を扱います。ずれが起きる3つの層の整理、参照先の実体を照合して乖離を検出するスクリプト、コードを真実として Guide を薄く保つ直し方と運用への組み込みまでを順に紹介します。
モデルがフォールバックしても命名と書式をぶらさない — エージェント出力の一貫性を保つ契約
実行中にモデルがフォールバックすると、生成コードの命名規約や書式が静かにぶれ始めます。モデルに依存しないスタイル契約の固定、差分からのドリフト検知、正規化パスの実装で出力の一貫性を保つ方法を、実際につまずいた点と対処もあわせてまとめました。
Antigravity のエージェントが開く PR の説明が「Update files」のままになる問題と、レビューできる要約を強制するゲート
Antigravity のエージェントが自動で開く PR は、説明が「Update files」のように空疎になりがちです。差分からリスクを見積もり、空疎な説明を弾いてレビューできる要約を強制する検証ゲートを、動くコードとともにまとめます。
Antigravity に書かせたテストが「通るだけ」になっていないか — ミューテーションで実効性を測る
Antigravity のエージェントに書かせたテストは、通っても肝心のバグを捕まえられないことがあります。ミューテーションテストで実効性を測り、生存ミュータントを潰してから採用する運用を、動くコードとともにまとめます。
並行で走らせたエージェントの差分を、安全に1本へ束ねるレビューゲートの設計
Antigravity 2.0 で複数エージェントを並行実行できるようになった一方、各エージェントの成果物をどう検証して1本のブランチに統合するかは設計者に委ねられています。差分単位のレビューゲートを段階的に組む方法を、判断基準とスクリプトつきで整理します。
組み込み Guide スキルを使い捨てにせず、設計資産として育てる
Antigravity v2.2.1 で加わった組み込み Guide スキルを、一度きりの指示で終わらせず、バージョン管理されたチーム共有の設計資産として運用するための具体的な構成と判断基準を整理します。
Antigravity 2.0 で IDE とエージェントが別アプリになって最初に困ったこと
Antigravity 2.0 のモジュラー構成で IDE とチャット型エージェントが2つのアプリに分かれました。両者の見ているファイル状態がずれて混乱した実体験と、ソース・オブ・トゥルースを一本化する運用をまとめます。
Antigravity 4サーフェスを1案件で組み合わせる — SDKで自作エージェントを動かすまで
Antigravity 2.0・CLI・IDE・SDK を1つの案件の中でどう使い分け、どう橋渡しするか。設計の発散から本番の収束、そして Python SDK で小さなカスタムエージェントを動かすところまでを、実際の運用フローに沿って実装込みで解説します。