◉ANTIGRAVITY LABEN
記事一覧/Agents & Manager
◈ Agents & Manager/2026-06-18上級

並列エージェントが同じファイルに書き込むときの取り合いを防ぐ

並列エージェントが同じファイルへ書き込んで互いの変更を消し合う事故を防ぐために、所有権分割・直列化点・リース方式コーディネータの3戦略を整理しました。ワークツリー分離では足りない理由と、衝突を検出する番兵の置き方まで実装を交えて説明します。

Antigravity416並列エージェント7アーキテクチャ9並行制御

✦ プレミアム記事

Antigravity 2.0 のデスクトップ版で 3 つのエージェントを同時に走らせ、ある朝の作業ログを見て手が止まりました。コンポーネントを生成させたエージェントの変更が、設定ファイルを更新した別のエージェントの上書きで丸ごと消えていたのです。テストは緑のまま、git の差分にも矛盾は出ません。ただ、片方の仕事だけが静かに無かったことになっていました。

並列実行は速度を生みますが、同時にこの「書き込みの取り合い」という固有の問題を持ち込みます。ワークツリー分離の記事はよく見かけますが、あれはリポジトリを分ける話で、1 つのワークスペースを複数エージェントが共有して同じファイルに触れる状況は守ってくれません。私自身が個人開発で 4 つのサイトを並行運用するなかで何度か踏んだので、この調停をどう設計するかを整理します。

なぜワークツリー分離では足りないのか

ワークツリー分離は、エージェントごとに独立した作業コピーを与える方法です。リポジトリ単位で並行作業する場合には有効で、最後に merge すれば衝突は git が検出してくれます。

問題は、1 つの機能を複数エージェントで分担するときです。「A がコンポーネントを書き、B が API ルートを構成し、C がビジュアル回帰テストを走らせる」という Antigravity 2.0 が推す並列パターンでは、3 者が同じ package.json、同じ型定義ファイル、同じルーティング設定に同時に触れます。ここでワークツリーを分けると、最後の merge で人間が捌ききれない量の衝突が積み上がります。

つまり必要なのは、リポジトリの分離ではなく、共有された資源への書き込みをどう順序づけるかという並行制御の設計です。

衝突が起きる 3 つの典型パターン

実際に観測したのは次の 3 つでした。

パターン起きること検出の難しさ
ロストアップデートA の書き込みを B が読まずに上書きし、A の変更が消える高い(差分に矛盾が出ない)
破れた整合性A が型を変えた直後、古い型を前提に B がコードを書く中(型エラーで気づける場合あり)
インターリーブ破損2 者が同じファイルを部分編集し、構文が壊れる低い(ビルドが落ちる)

いちばん厄介なのは最上段のロストアップデートです。ビルドもテストも通り、後から「あの変更どこへ行った」と気づくまで時間が経ちます。設計の主眼はここを潰すことに置きます。

✦

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

この記事の続きを読む

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

この記事で得られること
✦ワークツリー分離だけでは防げない、同一ワークスペース内のファイル書き込み衝突の正体
✦リース方式のファイル所有権コーディネータの実装(Python・タイムアウト付き)
✦所有権分割・直列化点・追記ログの3戦略の使い分けと、本番で踏んだ落とし穴
Stripe による安全な決済 · いつでもキャンセル可能
✦

この記事を購入する

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

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

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

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

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

関連記事

◈ Agents & Manager2026-07-24
並列エージェントに実行環境をリースする — ポート帯・DBスキーマ・devサーバを1エージェント1環境で分離する設計
Antigravity 2.0 の真の並列実行で複数エージェントが同じポート・DB・devサーバに衝突する問題を、1エージェント1環境をリースする設計で解きます。ポート帯の決定的割り当てとスキーマ複製の実装、実測値つきです。
◈ Agents & Manager2026-11-14
通ったはずのエージェントの PR が翌週また直されていた。マージ後14日で残った行を git blame で数える
エージェントの PR はレビューを通りやすいのに、マージ後すぐ同じ箇所が書き直されることがあります。コミットが足した行のうち14日後にも残っている割合を git blame で数えるスクリプトと、日付の並びで数字がずれる落とし穴、止める位置の決め方をまとめました。
◈ Agents & Manager2026-10-25
空き容量 11MB で無人ジョブが止まりました。du が数えたのは 59MB だけで、残りの約 9GB は見えない場所にありました
エージェントを無人で走らせる前に、書き込み先の空きを測って止める bash スクリプト 2 本の全文です。du と df の数字が噛み合わない理由と、自分では片付けられない空き不足の見分け方も書きました。