ANTIGRAVITY LABEN
記事一覧/Agents & Manager
Agents & Manager/2026-07-01上級

モデルがフォールバックしても命名と書式をぶらさない — エージェント出力の一貫性を保つ契約

実行中にモデルがフォールバックすると、生成コードの命名規約や書式が静かにぶれ始めます。モデルに依存しないスタイル契約の固定、差分からのドリフト検知、正規化パスの実装で出力の一貫性を保つ方法を、実際につまずいた点と対処もあわせてまとめました。

Antigravity353エージェント65モデルフォールバックコード品質2自動化36

プレミアム記事

先週、Antigravity のエージェントに 4 つのアプリの設定画面をまとめて実装させていたとき、途中から生成されるコードの雰囲気が変わっていることに気づきました。前半のファイルは handleSubmit のようなキャメルケースで揃っていたのに、後半では on_submit が混ざり、インデントもタブとスペースが入れ替わっていたのです。

原因はすぐに分かりました。実行の途中で上位モデルが混雑し、下位モデルへフォールバックしていたのです。モデルが変われば、既定の書式や命名の癖も変わります。人間には些細に見えても、レビュー時の認知負荷は確実に増えますし、diff が無駄に膨らみます。

個人開発でアプリを 12 年ほど続けてきて、私自身がいちばん時間を溶かしてきたのは、こういう「機能ではなく一貫性の欠如」に対するレビューでした。前置きは省いて、モデルがフォールバックしても出力がぶれない仕組みを、実際に組んだ順番でお伝えします。

フォールバックが「静かなドリフト」を生む理由

モデルのフォールバックは、多くの場合ログにしか残りません。エージェントは処理を止めずに続行するため、成果物の見た目だけがじわりと変わります。ここが厄介な点です。エラーで止まってくれれば気づけますが、ドリフトは正常終了の中に埋もれます。

ぶれやすいのは次の 3 種類でした。

  1. 命名規約(キャメルケースとスネークケースの混在、Boolean の is/has 接頭辞の有無)
  2. 書式(インデント幅、末尾セミコロン、import の並び順)
  3. 出力構造(コメントの粒度、関数分割の細かさ、早期リターンの好み)

書式はフォーマッタで吸収できますが、命名と構造はフォーマッタでは直りません。ここを人間のレビューに丸投げすると、モデルが変わるたびに指摘コストが跳ね上がります。

対策の骨子 — モデルに依存しないスタイル契約

私が採ったのは、「生成するモデルが何であっても、通過しなければならない機械的な契約を先に固定する」という方針です。モデル側の善意に一貫性を期待するのをやめ、出口で強制する発想です。

契約は 3 層に分けました。

  • 第 1 層: フォーマッタ(Prettier)で書式を無条件に正規化する
  • 第 2 層: Lint(ESLint)で命名規約と構造ルールを機械判定する
  • 第 3 層: ドリフト検知で「同じ実行内で規約がぶれた箇所」を差分から洗い出す

第 1 層と第 2 層は既存資産で足ります。肝は第 3 層です。フォーマッタと Lint は「ルール違反」しか見ませんが、ドリフトは「実行の前半と後半で癖が変わった」という相対的な現象だからです。

ここまでお読みいただきありがとうございます。

この記事の続きを読む

この先には、実装コードやベンチマーク結果など、実務でお役に立てる内容をご用意しています。このサイトは広告を掲載しておらず、サーバーや開発にかかる費用はメンバーの皆様のご支援で成り立っています。もしお役に立てていましたら、ご支援いただけますと大変ありがたいです。

この記事で得られること
モデル切替で起きる命名・書式ドリフトを検知する差分チェックの実装
ESLint/Prettier/命名規約をモデル非依存で強制するスタイル契約の構成
フォールバック発生率とドリフト率を計測して閾値で止める運用の作り方
Stripe による安全な決済 · いつでもキャンセル可能

この記事を購入する

この先の内容をすべてお読みいただけます。一度のご購入で、いつでも何度でもアクセスできます。このサイトは広告を掲載しておらず、皆さまのご支援がサーバー費用などの運営を支えています。

または
メンバーシップなら全記事が読み放題 →
シェア

お読みいただきありがとうございます

Antigravity Lab は広告なしで運営しており、サーバー費用などの運営コストはメンバーシップのご支援で賄っています。実装コード・ベンチマーク・本番設計パターンなど、実務でお役立ていただける記事を毎日更新しています。もし読んでよかったと感じていただけましたら、ぜひご覧ください。

  • コピー&ペーストで使える実装コード付き
  • 毎日新しい上級ガイドを追加
  • ¥580/月 または ¥1,480 の永久アクセス
メンバーシップを見る →

関連記事

Agents & Manager2026-07-15
エージェントのコミットに .bak が混じる — 自動修正ツールの副産物がリポジトリに入る原因と対処
エージェントに --fix 系ツールを走らせた後のコミットに .bak や .orig が紛れ込む症状について、再現条件と原因、ステージ範囲の限定・副産物の即時掃除・pre-commit での拡張子ゲートという3つの対処をまとめました。
Agents & Manager2026-07-12
Antigravity のエージェントに任せる作業と任せない作業を2週間の運用で見直す
個人開発の日々のタスクを2週間 Antigravity のエージェントに渡し続けた運用ログから、任せて正解だった作業と手元に引き戻した作業の分かれ目を振り返ります。自信満々に間違える瞬間への備えや、任せ方そのものの設計についても述べています。
Agents & Manager2026-04-27
Antigravity を個人開発の「夜のもう1人」として迎え入れる運用モデル
Antigravity のエージェントを、個人開発者にとっての「夜のもう1人」として運用するための設計指針。タスクの渡し方・境界線の引き方・朝に何をレビューするかまで、実際に運用して整えてきた手順を共有します。
📚RECOMMENDED BOOKS
大規模言語モデル入門
山田育矢
LLM開発
生成AIプロンプトエンジニアリング入門
我妻幸長
プロンプト
Claude CodeによるAI駆動開発入門
平川知秀
AI駆動開発
※ アフィリエイトリンクを含みます
もっと見る →