
複数AIチャットの同時実行でGit競合を防ぐ方法|worktree隔離ビルドと0トークン順番待ち実装録
AIコーディング支援ツール(Antigravity、Cursor、Claude Codeなど)で複数のチャット画面を開き、記事執筆やSEO改善、UI改修を同時並行で走らせると、「ファイル競合によるエラー停止」「待機タイマーの繰り返しによるAPI枠の浪費」「別チャットで作成中の書きかけファイルの巻き込み公開」という3つの深刻な事故に直面します。
当ラボ(公開記事数 803本[検証録 383本・AI国家構想 420本])の実運用で試行錯誤を重ねた結果、非同期プロセスの完了通知を活用した「0トークン順番待ち(wait-turn)」と、編集枠・転送枠を分離した「2層ロック×RAMDisk上のgit worktree隔離ビルド」を組み合わせることで、別ファイルの同時編集を1秒も止めずに巻き込み事故ゼロで並列完遂できる 仕組みを確立しました。
先行チャットが終わるまで書き込み手前で待たされる旧方式では「とにかく遅いし、未完了チャットがどんどんたまっていく」「今もう1本流して大丈夫かと人間側がAIの稼働状況に気を遣って思考が寸断される」という大きなストレスがありましたが、本方式への移行後は、AIの空き状況に一切気を遣うことなく思いついた瞬間に次々と処理を流せるようになっています。
本記事では、毎分タイマーでバックグラウンドタスクが139個まで増殖した手痛い失敗談から、RustとGitの標準機能を組み合わせた第3世代の無停止並列パイプラインの実装詳細までを余すことなく公開します。
-
Playwrightに公式Rust版がない理由とNode常駐162MBの罠|Chrome・Safari検証自作録 : なぜPlaywrightには公式Rust版がなく、MCPでも裏でNode.js(待機162.3MB)が常駐するのか?Pure RustでChrome・Safari実機検証…
-
Geminiが過去会話を覚えている理由|パーソナルインテリジェンスとAI執筆術 : チャット履歴の記憶構造の違いと、対話ログから高品質な記事を起こす実践ノウハウの検証録です。
-
AIエディタで複数のチャットやエージェントを同時に動かした際、ファイル競合やビルドエラーに悩まされている開発者の方
-
本番デプロイスクリプトの
git add .によって、別ウィンドウで作業中だった未完成ファイルを誤ってコミット・公開してしまった経験がある方 -
待機中のAIによるポーリング(定期確認)でトークン消費やAPI利用枠が溶けてしまう問題を根絶したい方
-
git worktreeやファイルロック(flock)を自動デプロイパイプラインに組み込み、人間の「交通整理」なしで複数タスクを並列処理したい個人開発者・メディア運営者の方
複数AIチャットを同時に動かすと起きる3つの事故
AIエージェントの自律性能が向上すると、1つのチャットが終わるのを画面の前でじっと待っているのがもったいなくなります。 「チャットAで長文の新規記事を執筆させながら、チャットBとチャットCで過去記事のSearch Console改善を走らせ、チャットDで管理ツールの不具合を直す」といった並列運用は、開発速度を数倍に引き上げる魅力的なスタイルです。
しかし、同じローカルリポジトリ(作業フォルダ)に対して複数のAIチャットを無防備に同時実行させると、人間が1人で開発していた頃には起きなかった3つの厄介な事故が次々と発生しました。

人間が1人でエディタに向かっていた時代は、同時に2つのファイルを別々の意図で保存したり、書きかけの原稿を放置したまま別コンソールから本番デプロイを走らせたりすることは少なかったからな。AIを4人同時に雇うと、作業フォルダの中で大渋滞と玉突き事故が起きるわけだ。

実際に当ラボでも、最初は「先行チャットが終わるまで60秒ごとにタイマーで待たせよう」という素朴な仕組みからスタートしたのですが、まさかあんなにログが埋め尽くされるとは思いませんでしたね……。
毎分タイマー確認でAPI枠とログが溶けた失敗例
当ラボが最初に実装した「第1世代」の排他制御は、きわめて単純な仕組みでした。
先行するチャットAが作業中の場合、後から起動したチャットB・C・Dに対して「ロックが解放されるまで、60秒のタイマースケジュール(schedule ツール)を設定して待機してください」と指示していたのです。
ところが、いざSearch Consoleの改善タスク(1件あたり約8〜10分)を複数チャットで同時に投げたところ、画面上で凄まじい事態が起きました。
先行チャットの処理が続く間、待機側のチャットが60秒ごとに目を覚ましてファイル編集を試み、そのたびに実行前フック(PreToolUse)に「先行チャットが稼働中です(denied)」と弾かれ、再び60秒タイマーをセットし直す無限ループに入ったのです。
バックグラウンドタスクの通し番号はみるみるうちに膨れ上がり、task-59 から task-139 まで80個以上のタイマー履歴が画面を埋め尽くしました。
たまらず手動で「止めてもらえる?」と緊急停止をかけましたが、この「AI自身に定期確認(ポーリング)をさせる方式」には3つの致命的な欠陥がありました。
-
待機しているだけでAPI利用枠とキャッシュが溶ける :AIが60秒ごとに起床してツールを呼び出すたび、それまでの長い会話履歴(数万トークン)が毎回LLMのAPIへ再送信されます。仮に3つの待機チャットが10分間、60秒おきに状態確認を繰り返した場合、推論 で合計約30回もの無意味なLLM推論コールが発生し、何の成果も生まないままAPI枠を浪費してしまいます。
-
先行完了の瞬間に複数チャットが一斉起床して再衝突する :60秒周期のタイマーがたまたま近いタイミングで発火すると、先行チャットが終わった直後に2つの待機チャットが数秒差で起き上がり、ロックの奪い合い(サンダリング・ハード問題)を起こして再び片方が弾かれます。
-
会話ログがタイマー通知と拒否エラーで汚染される :本来の調査結果や編集計画のログが、数十回に及ぶ「60秒待機します」「ロック中のため拒否されました」というシステムメッセージで押し流され、AI自身の文脈理解力まで低下する悪循環を招きました。
一括コミットが別チャットの書きかけ原稿を巻き込む罠
タイマー問題を乗り越えた次に立ちはだかったのが、本番公開時の「書きかけファイル巻き込み事故」です。
多くの個人開発やブログ運用の自動化スクリプトでは、作業完了後に git add .(作業フォルダ内のすべての変更を一括登録)を実行し、全体のビルド(astro build)を通してから本番サーバーへ転送する構成を採っています。
この構成のまま複数チャットを動かすと、どのような悲劇が起きるでしょうか。 実際に当ラボで発生したヒヤリハット事例では、チャットAで新規の長文検証記事(54.4KB)を約33分間かけて対話しながらじっくり執筆し、「ここで一度手直しするから一時停止して」とAIを待機させていました。
そのすぐ裏で、別チャットBに指示した軽微なシステム改修が完了し、自動デプロイパイプラインが走り出しました。
もしここで従来どおり無邪気に git add . と全体ビルドを実行していれば、チャットAで一時停止中だった「まだ監査も内部リンク結線も終わっていない書きかけ原稿」まで一緒に本番サイトへ公開されるか、あるいは未完成原稿のリンク切れエラーによってチャットBのシステム改修デプロイ自体が道連れで停止してしまいます。
当ラボの全体アーキテクチャについては AI時代の開発手法と環境構築4大基盤|Astro・SQLite・Rust・Swiftバッチ運用術 でも解説していますが、ビルド前には厳格な品質ゲート(gemini-gate)が全記事を検査するため、作業フォルダ内に1つでも未完成のファイルが混ざっていると本番転送がブロックされる構造になっていたのです。
単一ロックで別ファイルの編集まで止まる待ち時間
書きかけ原稿の巻き込みを防ぐため、次に導入した「第2世代」では、タスク開始(prep)から仕上げ・本番転送(finish 〜デプロイ)が終わるまで、1つのチャットしか .mdx 記事ファイルを編集できない単一ロック(Single-Writer Mutex)を導入しました。
同時に、後述する非同期プロセス待機(wait-turn)を組み込んだことで、毎分タイマーによるAPI浪費はピタリと止まりました。
しかし、実際に4つのチャットを並べてSearch Consoleの改善コマンド(/gsc-fix)や新規記事の執筆を連続投入してみると、新たな 最大の障壁(ボトルネック) が浮き彫りになりました。
4つのチャットはそれぞれまったく別の .mdx 記事ファイルを改修しようとしているにもかかわらず、事前調査が終わっていざ .mdx ファイルへ書き込もうとした瞬間に、先行するチャット1の執筆から本番ビルド・実機検証まで(1本あたり約8〜15分間)がすべて完了するのを1列に並んで待ち続けてしまったのです。
実際に運用してみると、この「書き込み手前での直列待機」は想像以上にストレスが溜まるものでした。
1本あたり8〜15分かかる執筆処理がすべて直列になるためとにかく遅く、アイデアを思いついて投げたチャットが .mdx 書き込みの手前でどんどん渋滞してたまっていきます。
さらに深刻だったのが、物理的な待ち時間以上に 「今もう1本チャットを流していいのか?ここで投げたらまた後ろで詰まらないか?」と、人間側がいちいちAIの稼働状況に気を遣って思考が寸断される心理的負荷 でした。 本来は人間の思考スピードに合わせてAIが並列で働くべきなのに、いつの間にか人間の方が「今は先行チャットが執筆中だから、次の指示を出すのを我慢しよう」とAIの都合に合わせて手加減する本末転倒な状態に陥っていたのです。
| 比較項目 | 第1世代 (60秒タイマー方式) |
第2世代 (単一ロック+wait-turn) |
第3世代 (2層ロック+worktree隔離) |
|---|---|---|---|
| 待機中の方式 | AIが60秒ごとに schedule 起床 |
Rustプロセスが裏で0.25秒監視 | Rustプロセスが裏で0.25秒監視 |
| 待機中のAPI消費(推論) | 3チャット10分待機で約30回発火 | 0回(完全0トークン) | 0回(完全0トークン) |
別記事 .mdx の同時編集 |
不可(毎分 denied エラー) |
不可(先行の転送完了まで直列待機) | 完全並列(待ち時間0秒で即時編集) |
| 同一記事の重複編集防止 | 全体ロックで拒否 | 全体ロックで待機 | ファイル単位の編集ロックで安全待機 |
| 本番転送時の他チャット原稿 | git add . で巻き込み危険あり |
先行1チャットしか書けないため不在 | 選択コミット+クリーンworktreeで完全隔離 |
| 4チャット同時投入時の動き | タスク番号139まで増殖し手動停止 | 調査は並列、記事編集〜転送は完全直列 | 調査も執筆も4並列、最後の転送1分のみ直列 |
ここで、3つの世代における待機コストと並行作業の待ち時間の違いを、分かりやすい条件を揃えた 推論 シミュレーション値としてグラフで比較してみましょう。 (前提条件:①3つの後続チャットが各10分間待機した場合の無駄なAPI起床回数、および ②1件8分かかる別記事の改修タスクを4チャット同時に投入した際、4番目のチャットが記事本文の編集を開始できるまでの最大待ち時間)

同じ記事を2人で同時に書き換えたらぶつかるのは分かるけれど、全然別の記事を書いているのに「前の人が郵便局に出し終わるまで、あなたは原稿用紙に1文字も書いちゃダメ」って言われていたようなものね!

まさにその通りだ。原稿を書く机(編集ロック)と、完成した原稿だけを封筒に入れて出荷する窓口(デプロイロック+隔離作業ツリー)を物理的に切り離してやれば、何人でも同時に執筆を進められるようになる。
解決策①:0トークン待機と先着順の自動バトンリレー
まず解決すべきは、「先行チャットの処理が終わるまで待たなければならない場面(同一記事の編集が重なった場合や、最後の本番転送窓口が混み合っている場合)で、どうやってAPIトークンを1ミリも消費せずに順番待ちを実現するか」という課題です。
非同期コマンド終了通知を使ったwait-turnの仕組み
現代のAIエディタ(Antigravityなど)には、バックグラウンドで実行したコマンドが終了した瞬間に、システム側からAIへ完了通知を送って自動的にターンを再開させる「リアクティブ起床(Reactive Wakeup)」という優れた仕組みが備わっています。
タイマー(schedule)を使うと「まだ終わっていないのにAIを定期的に叩き起こす」ことになりますが、逆に 「ロックが解放されるまで終了しない軽量なネイティブコマンド」をバックグラウンドで1回だけ走らせておけば、ロックが空いた瞬間にコマンドが正常終了(exit 0)し、その完了通知によってAIが1回だけピタリと目を覚ます のです。
当ラボでは、Rust製の高速検索・管理CLI(kb-search)の中に wait-turn <会話ID> というサブコマンドを実装しました。
後続チャットはロック競合を検知すると、このコマンドを非同期モード(WaitMsBeforeAsync: 1000)で1回だけ呼び出し、即座に自分のターンを終了してスリープに入ります。
-
AI側の呼び出し回数 :待機開始時にバックグラウンドで 1回起動するだけ(待機中のLLM APIコール・トークン消費は 完全ゼロ)
-
監視プロセスのリソース負荷 :コンパイル済み Pure Rust バイナリ(メモリ使用量数MB以下)が、OSのシステムコールとローカル状態ファイルを 250ミリ秒(0.25秒)周期 で軽量チェック
-
起床のレスポンス速度 :先行チャットが完了してロックを手放してから 最大0.25秒以内 に待機プロセスが
exit 0で終了し、AIエディタが後続チャットを自動再開 -
フェイルセーフ上限(最大待機時間) :万が一先行タスクが長引いた場合でもバックグラウンド切断や無限残留が起きないよう、1回あたり最大720秒(12分)×最大4回(合計48分上限) で安全に待機継続・上限停止を行う設計
この方式に切り替えた瞬間、かつて80個以上も増殖していたバックグラウンドのタイマータスクは完全に姿を消し、待機中のキャッシュ破棄やトークン浪費もゼロになりました。 AI開発におけるコンテキストキャッシュの重要性と排他制御の基本設計については、AI開発で『/clear』すると消費2.5倍?キャッシュ破棄の罠と複数AI排他制御・78%危険スキルの隔離術 でも詳しく検証しています。
放置チャットの自動スキップとRAIIによる二重起動防止
ただし、単に「ロックファイルが消えるのを待つ」だけでは、3つ以上のチャットが同時に並んだときに順番が入れ替わったり、途中で人間が閉じてしまったチャットにロックが渡って全体がフリーズ(デッドロック)したりする危険が残ります。
そこで wait-turn とロック管理ファイル(_active_gsc_lease.json)には、OSレベルのファイルロックである flock(2)(複数のプログラムが同じ設定ファイルを同時に書き換えて壊すのを防ぐ、OSカーネル提供の排他ロック機能)と組み合わせて、以下の3つの堅牢なバトンリレー機構を組み込みました。
-
ファイル削除ではなく「先頭1チャットへの直接バトン移譲(FIFO)」 :先行チャットがタスクを完了(またはターン終了の
Stopフック発火)した際、ロックを「空き状態」に戻すのではなく、待機列(waitQueue)の先頭に並んでいるチャットのIDを次のオーナー(ownerConvoId)へ直接書き換えてから保存します。これにより、後から来たチャットによる横取り(割り込み)を100%防ぎます。 -
放置・閉鎖チャットの2段階タイムアウト自動スキップ :バトンを受け取ったチャットがすでに閉じられていたり、入力待ちで放置されていたりする場合に備え、① バトン移譲後90秒間ツール実行がない場合、または② バトン移譲後15秒が経過しても対応する
wait-turn待機プロセス自体が存在しない場合 は、自動的に「不在・放置チャット」と判定して次の順番へバトンを繰り上げます。 -
RustのDropトレイト(RAII)による待機PIDの確実な掃除 :AIが誤って同じターン内で
wait-turnを2回呼び出さないよう、起動中は.wait_turn_<会話ID>.jsonというプロセスID記録ファイルを生成し、実行前フックで2個目の起動を即座にブロックします。プロセス終了時には、Rust公式ドキュメントのDropトレイト解説 で知られる RAII(変数がスコープを抜ける瞬間にファイル削除などの後始末を自動実行する仕組み) を使い、確実にPIDファイルを削除します。
実際に kb-search 内で稼働している、外部クレート依存ゼロのRAIIパターンを用いた待機PIDガード構造体(WaitTurnPidGuard)の実装イメージは以下のとおりです。
// スコープを抜けた瞬間に待機PIDファイルを自動削除するRAIIガード(外部クレート依存ゼロ)
struct WaitTurnPidGuard {
pid_file: PathBuf,
}
impl WaitTurnPidGuard {
fn new(convo_id: &str, pid_file: PathBuf, started_ms: i64) -> Self {
let json = format!(
"{{\"pid\":{},\"startedAtMs\":{},\"convoId\":\"{}\"}}",
std::process::id(),
started_ms,
convo_id
);
let _ = fs::write(&pid_file, json);
Self { pid_file }
}
}
impl Drop for WaitTurnPidGuard {
fn drop(&mut self) {
// 正常終了(exit 0)でもタイムアウトやパニック時でも確実に掃除
let _ = fs::remove_file(&self.pid_file);
}
}
このように Drop トレイトを実装しておけば、関数の途中で早期リターン(return)しようがパニックが起きようが、ゴミとなるPIDファイルがディスク上に取り残されて次回以降の待機がブロックされる事故をコンパイラレベルで根絶できます。
先行チャットの作業が完了し、ターン終了時に状態更新フックが起動します。
ロックを削除せず、waitingConvoIds 先頭の会話IDへ直接オーナー権を移譲します。
裏で監視していた wait-turn がバトン到達を検知し、exit 0 で即座に終了します。
コマンド完了通知でAIが自動起床し、キャッシュを維持したまま処理を再開します。
OSレベルのファイルロックやRAIIパターンによるメモリ・リソース安全性の確保には、やはりRustの厳格な型システムとライフタイム設計が抜群の相性を発揮します。
システムプログラミングの基礎から Drop トレイト、並行処理の安全設計までを体系的に手元で引きたい方には、以下の定番書が長く役立ちます。
解決策②:別ファイルの同時編集とworktree隔離転送
0トークン順番待ちによって待機コストは消滅しましたが、さらに一歩進めて「そもそも別々の記事や別々のコードを編集している間は、順番待ちすらさせずに完全並列で走らせる」ために設計したのが、第3世代の 「2層ロック設計 × 選択ステージング × RAMDisk上のgit worktree隔離ビルド」 です。
編集枠と本番転送枠を分離する2層ロック設計
第2世代で別ファイルの編集まで待たされていた原因は、「どの記事を編集中か」という情報と「今まさに本番転送パイプラインを回しているか」という情報を、たった1つのロック枠で兼用していたことにありました。
そこで第3世代では、ロック管理ファイル(.active_gsc_lease.json)の構造を根本から刷新し、以下の2つの独立したレイヤー(層)に分離しました。
各チャット(および配下のサブエージェント・Swarmワーカー)が「どの記事スラッグを編集中か」を記録します。編集対象が異なる限り、何チャットでも待ち時間0秒で同時に執筆・改修・Swarm起動が可能です。万が一 まったく同じ記事ファイル を2つのチャットが触ろうとした場合や、Search Console上位候補の自動抽出(--top)・最新日報抽出(--latest)同士が重なった場合のみ、第1層で安全に wait-turn 待機へ入ります。
記事の執筆が終わった後の最終仕上げ(finish:逆リンク自動注入・インデックス更新)と本番転送(npm run 本番環境転送)のフェーズだけを受け持つ単一スロットです。執筆作業の9割の時間は第1層で並列進行し、最後の出荷窓口(約1〜2分間)だけが先着順(FIFO)で整然と1本ずつ処理されます。
さらに、親チャットが長文執筆のためにSwarmワーカーやサブエージェントを起動した場合でも、「どの親チャットに属する変更か」を見失わないよう工夫しています。
実行前後のフックがサブエージェントの起動元親UUID(sender=<UUID>)を辿り、子エージェントが編集したファイルパスや新規画像ディレクトリもすべて ルート親チャットの編集履歴(.session_edited)へ自動集約 する仕組みを整えました。
実際の2層ロック状態ファイル(.active_gsc_lease.json)は、以下のように非常にシンプルなJSON構造で管理されています。
{
"ownerConvoId": "635197e6-6375-469a-be7a-ce14a1ba63a9",
"workflowKind": "new",
"targetSummary": "multi-ai-chat-git-worktree-zero-token-queue",
"updatedAtMs": 1794972600000,
"waitingConvoIds": [
"83862004-7259-4db3-880f-5b3ab48738df"
],
"activeEditors": [
{
"convoId": "83862004-7259-4db3-880f-5b3ab48738df",
"workflowKind": "edit",
"slugs": ["another-article-slug"],
"updatedAtMs": 1794972605000
}
]
}
このJSONファイルに対する読み書きはすべてOSの flock(2)(排他ロックファイル .active_gsc_lease.lock)で保護されたクリティカルセクション内で行われるため、4つのチャットがミリ秒単位で同時に状態更新をかけてもJSONが破損することは一切ありません。
この2層ロック+クリーン git worktree 方式へ移行してからは、日々の開発体験が劇的に変わりました。
別々の記事であれば 1秒も止まることなく同時並行で .mdx ファイルの作成・編集・Swarmワーカーによる長文執筆までが一気に進み、人間側が「今もう1本流して大丈夫か?」とAIの稼働状況に気を遣う必要が完全にゼロになった のです。
頭の中に新しい記事テーマや改善アイデアが浮かんだ瞬間に、先行チャットの進捗を一切気にせず次々と新しいチャットへ処理を流せるため、書込手前での渋滞・滞留が消滅し、ラボ全体のスループットが一気に跳ね上がりました。
なぜgit stashではなく選択ステージングなのか
ここで、Gitに詳しい開発者の方ならきっとこう疑問に思われるはずです。
「別チャットが作業中の未完成ファイルがあるなら、デプロイ前に git stash -u や git pull --autostash で未コミット変更を一時退避し、デプロイが終わったら git stash pop で戻せば簡単ではないか?」と。
実はこの「git stash による一時退避」こそ、複数AIチャットが同時稼働する環境では 絶対にやってはいけない危険なアンチパターン なのです。
なぜなら、git stash を実行した瞬間から git stash pop で戻すまでの数秒〜数十秒間、メインの作業フォルダ上から他チャットが編集中の書きかけファイルや変更箇所が物理的に消去(または古い状態に巻き戻し)されてしまうから です。
まさにその数秒の間に、並行稼働している別チャットのAIが edit_file(ファイルの部分置換ツール)や画像変換コマンドを実行するとどうなるでしょうか。
「置換対象のテキストがファイル内に見つかりません」「対象のファイルが存在しません」という致命的なツールエラーが発生し、別チャットの作業がその場でクラッシュするか、最悪の場合は退避していた変更を stash pop で戻す際に深刻なマージコンフリクトを引き起こします。
-
git add .を使うと、別チャットが執筆中の未完成ファイルまで一緒にコミット・公開されてしまいます。 -
git stashで一時退避すると、メイン作業フォルダから変更が一時消失するため、同時稼働中の別チャットAIがedit_fileに失敗してクラッシュします。 -
メイン作業フォルダ上で直接
astro buildを走らせると、書きかけ原稿の文法エラーや未結線リンクでデプロイ自体が停止します。
-
メイン作業フォルダにある他チャットの書きかけファイル(
foreign_wip)には 1バイトも触れず、退避も削除もしません。 -
仕上げ検証(
finish)を通過したファイル群と自分のチャットが変更した安全ファイルだけをgit add -A -- <path>で選択コミットします。 -
ビルドと本番転送は別フォルダのクリーンな
git worktree上で実行するため、メイン作業フォルダの書きかけ原稿と100%物理隔離されます。
この「選択ステージング」を寸分の狂いもなく行うため、デプロイスクリプト(auto_backup.sh)では Git公式ドキュメントのgit-status仕様 に定義されている git status --porcelain -z -uall オプションを使用しています。
通常の git status は日本語ファイル名やスペースを含むパスを引用符や8進数エスケープで囲んでしまいますが、-z(NUL文字 \0 区切り出力)と -uall(新規作成された未追跡フォルダ内の個別ファイルまで全列挙)を組み合わせることで、どのようなファイル名であっても1ファイルずつ正確に走査できます。
そして、作業フォルダ内の全変更ファイルを以下の基準で自動仕分けします。
-
仕上げ完了スタンプ(SHA-256ハッシュ)の照合 :
finishコマンドを通過した記事ファイルは、その時点のファイル内容のSHA-256ハッシュ値が.finished_stamps.jsonに記録されます。デプロイ時には現在のファイルハッシュと照合し、1文字でも仕上げ後に書き換えられていたり、まだfinishを通っていなかったりする他チャットの.mdxファイル(および同じ記事フォルダ内の未追跡画像) を「他チャットの作業中ファイル(foreign_wip)」として自動検出します。 -
他チャットの作業中ファイルをステージングから完全除外 :検出された
foreign_wipファイルは、メイン作業フォルダ上にそのまま無傷で残し、git reset -q HEAD -- <path>によってGitのインデックス(ステージング領域)から確実に除外します。 -
完了済みファイルのみを選択コミット :自分のチャット(子エージェント含む)が仕上げを完了した記事ファイルと、それに紐づくデータファイルだけを
git add -A -- <path>でピンポイントにステージングし、コミットを作成します。
RAMDisk上のworktreeで高速隔離ビルド
選択コミットによって「Gitの最新コミット(HEAD)には完了済みの安全な変更だけが含まれ、メインの作業フォルダ上には他チャットの書きかけファイルがそのまま残っている」という状態が作られました。
しかし、このままメインの作業フォルダで npm run build(Astroの全体ビルド)を実行してしまうと、AstroはGitのコミット状態ではなく「フォルダ上に実在するファイル」をすべて読み込むため、結局メイン作業フォルダに残っている他チャットの書きかけ原稿までビルドしてしまいます。
そこで登場するのが、Git公式ドキュメントのgit-worktree機能 です。
git worktree とは、1つのGitリポジトリの履歴データを共有したまま、別のフォルダに「特定のコミット状態だけを展開したもう1つの独立した作業ツリー」を瞬時に作れる標準機能です。
当ラボでは、他チャットの書きかけファイルが検出された場合、高速な16GBメモリディスク(RAMDisk:/Volumes/RAMDisk/$USER/deploy-worktree、構築手順の詳細は MacのRAMDisk(16GB)でSSD寿命を延ばす!ブラウザ・開発キャッシュ完全移行と自動同期術 を参照)の上にクリーンな worktree を自動展開し、その中で最終検問(gemini-gate)と本番ビルド(astro build)、サーバー同期(rsync)を完遂させるアーキテクチャを実装しました。
ここでは、実際にこの worktree 隔離ビルドを実装・検証する過程で踏み抜き、解決した 3つのリアルな技術的急所(エッジケース) を共有します。
-
既存の切り離された(detached)worktreeで「古いHEAD」が居座る罠 :RAMDisk上の
deploy-worktreeを再利用する際、切り離された状態(detached HEAD)の既存worktree内で文字通りgit checkout --detach -f HEADと打つと、メイン側の最新コミットではなく 「そのworktree自身が前回チェックアウトしていた古いHEAD」 に留まってしまいます。必ずメインリポジトリ側でgit rev-parse --verify HEADのコミットSHAを取得し、そのSHAを明示的に渡してチェックアウトさせる必要があります。 -
Astroの
outDir/cacheDir共有とシンボリックリンクによる0秒準備 :隔離ツリー側で毎回パッケージ導入や画像再変換が走らないよう、メイン環境のnode_modules等へシンボリックリンクを張り、さらに Astro公式の設定リファレンス(outDir / cacheDir) を活用して両環境がRAMDisk上の同一キャッシュ(astro-cache)と出力先(astro-dist)を参照するよう統一しました。これにより画像再エンコード 0枚・展開 1秒未満 でビルドが完了します。 -
既存記事リライト中の「公開記事数ズレ」防止と異常時の無傷ロールバック :別チャットが公開済みの既存記事をリライト中の場合、単純除外すると記事数カウントが減ってしまうため、既存追跡ファイル(
git cat-file -e HEAD:<path>)はコミット済みのHEAD版を基準に記事数を算出します。また万が一クリーンworktree上の最終検問でエラーが出た場合は、git push前にgit reset --soft HEAD~1で無傷ロールバックする安全弁を備えています。
実際にデプロイスクリプト(auto_backup.sh)の中で、メインリポジトリの最新コミットSHAを取得してRAMDisk上の deploy-worktree へ高速同期しているコア処理は以下のようになっています。
# 1. メインリポジトリ側で最新コミットの絶対SHAを取得(detached worktreeの古いHEAD罠を回避)
MAIN_HEAD_SHA=$(git rev-parse --verify HEAD)
WORKTREE_DIR="/Volumes/RAMDisk/$USER/deploy-worktree"
# 2. RAMDisk上にworktreeを作成または最新SHAへ強制同期
if [ ! -d "$WORKTREE_DIR/.git" ] && [ ! -f "$WORKTREE_DIR/.git" ]; then
git worktree prune || true
git worktree add --detach -f "$WORKTREE_DIR" "$MAIN_HEAD_SHA"
else
git -C "$WORKTREE_DIR" checkout --detach -f "$MAIN_HEAD_SHA"
git -C "$WORKTREE_DIR" clean -fd -e node_modules -e _local_db
fi
# 3. node_modules と _local_db をシンボリックリンクで共有し、隔離環境で高速ビルド
ln -sfn "$MAIN_REPO_ROOT/node_modules" "$WORKTREE_DIR/node_modules"
ln -sfn "$MAIN_REPO_ROOT/_local_db" "$WORKTREE_DIR/_local_db"
(cd "$WORKTREE_DIR" && npm run build)
このように「メインリポジトリのコミットSHAを明示的に渡して --detach チェックアウトする」「git clean 時に -e node_modules でシンボリックリンクを保護する」という2行の工夫を入れるだけで、2回目以降の worktree 同期は0.1秒足らずで終わるようになります。

特に1つ目の「既存の切り離された作業ツリーの中でHEADと指定すると、自分の古いコミットを指してしまう」という挙動は、実際にスクリプトを組んで動かしてみないと気づきにくい急所だな。メイン側のコミット番号(SHA)を明示的に渡すことで1bitの狂いもなく同期できる。

しかもビルドキャッシュと出力先がRAMDisk上で共通化されているので、隔離ツリーでビルドしているのに普段とまったく同じ数秒のスピードで本番公開まで終わるのが気持ちいいですね!
このように、複数AIチャットの同時稼働とRAMDisk上の git worktree 高速ビルド、さらにはローカルLLMやRustバイナリ群をストレスなく常駐させるには、ユニファイドメモリに十分な余裕がある母艦マシンがあると威力を発揮します。
当ラボでもメイン環境および検証環境としてフル活用している64GBメモリ搭載モデルの詳細は以下から確認できます。
導入時の疑問と段階的に取り入れる現実的な手順
ここまで、第3世代の無停止並列パイプラインの仕組みを解説してきました。 最後に、読者の方がご自身の開発環境へ取り入れる際によく浮かぶ疑問への回答と、最小限のステップでAIに実装させるための指示プロンプトを紹介します。
最初から毎回手動でworktreeを切る方式との違い
よくある質問の1つに、「デプロイ時だけ裏で git worktree を使うのではなく、最初からチャットごとに人間が手動で別々の worktree フォルダ(project-chat1/, project-chat2/ など)を作ってエディタで開けばいいのではないか?」というものがあります。
もちろん、数日間かけてデータベース構造や認証基盤を全面刷新するような「大規模な長期機能ブランチ開発」であれば、最初から独立した worktree を切って作業するアプローチは有効です。
しかし、日々のブログ記事執筆やSEO改善、UIの微修正といった1件5〜15分程度のタスクにおいて、毎回手動で worktree を切り分ける方式には以下の実務上の煩雑さ(二律背反(トレードオフ))が伴います。
-
エディタウィンドウと設定ファイルの管理コスト :チャットごとに別々のフォルダをAIエディタで開き直す必要があり、
.envなどの非追跡ファイルや開発サーバーのポート番号、SQLiteインデックスの同期状態をそれぞれのフォルダで意識しなければなりません。 -
共通アセットや内部リンクの即時参照性 :同じ1つのワークスペースで作業していれば、チャットAが追加した共通コンポーネントやアフィリエイト定義をチャットBから即座に参照できますが、最初から別ツリーに分かれていると毎回マージやリベースの手間が発生します。
-
人間の「交通整理」をゼロにする快適さ :普段の執筆・編集は 「いつもの1つのワークスペース」で複数のAIチャットが別ファイルを自由に同時編集し、最後の出荷(デプロイ)の1分間だけスクリプトが裏で自動的にクリーン
worktreeを使ってくれるハイブリッド方式 こそが、人間の認知負荷を最小化する最適解でした。
なお、そもそも「Step 1、Step 2、Step 3、Step 4 のような複数の工程やタスクがあるとき、1つのチャットにまとめるべきか、それとも複数のチャットに分けるべきか迷う」という場面も多いはずです。 当ラボでは実測ベンチマーク(詳細は AIエージェントへの複数指示は別チャットか1チャット一括か?5件バルク並列で消費38%減の実証録 を参照)に基づき、以下の 3パターン判定基準 で明確に使い分けています。
-
前後の依存がある段階作業(Step 1:調査 ➔ Step 2:実装 ➔ Step 3:テスト ➔ Step 4:転送) :前のステップの結果を次のステップが使う一連のパイプラインは、無理に別チャットへ分けず 「1つのチャットで一気通貫(内部でサブエージェントやSwarmが自動並列)」 で流すのが正解です。会話履歴の文脈が100%引き継がれるうえ、2ターン目以降はLLMのプロンプトキャッシュ(KVキャッシュ)によって入力トークン単価が最大9割引きになるため、別チャットで一からファイルを読み直させるより圧倒的に速く低コストに終わります。
-
全体監査などで「Step 1〜Step 4」の改善メニューが出てきた場合 :修正対象の合計が 5〜8ファイル(または記事3〜5本)以内 であれば、すでに監査チャット内に調査結果が揃っているためそのまま 「同じ1つのチャットで Step 1〜4 をまとめて実行」 させるのが最速です。一方、監査結果の Step 1〜4 が 合計10本以上の大型改修(各Stepに別々の対象ファイルが3〜5本ずつある等) の場合は、1チャットに詰め込むと30分稼働によるAPIタイムアウトの危険があるため、「Stepごとに別チャットを開いて同時に並行投入」 するのが安全かつ高速です(ただし Step 1 で共通定数を追加してから Step 2 以降で各記事に使うような順序依存があるときだけ、先に Step 1 を完了させてから残りを並列投入します)。
-
同種の独立した定型タスク(複数記事のSEO改善や定型リライトなど) :3〜5件程度であれば 「1チャットに箇条書きで一括指示(バルク並列)」 するのが最もトークン効率に優れます(個別チャット比で消費約38%削減)。一方、対象が6件以上ある場合は1チャットのコンテキスト肥大化を防ぐため、「3〜4件ずつの束に分けて複数チャットへ同時投入」 するのがベストバランスです。
-
作業中にふと思いついた「無関係な別テーマ・別記事・別バグ修正」 :長文記事を執筆している最中に「あ、あのUIのバグも直したい」「別テーマの記事も1本仕込みたい」と思いついた場合は、同じチャットに混ぜると文脈が混濁してキャッシュ効率も落ちるため、「迷わず新しいチャット画面(+ボタン)を開いて即時並行投入」 します。第3世代の2層ロックと
worktree隔離ビルドがあるおかげで、先行チャットの終了を1秒も待たずに思いついた瞬間すぐ横で走らせることができます。
また、エージェントが意図しないDB更新や暴走を起こさないためのガードレール設計については、AIエージェントの暴走提訴と「勝手なDB更新」を防ぐ設計術|GKE待機費40%削減と一意性検問 もあわせて参照してください。
個人開発で最小限から導入するAI指示プロンプト
ご自身のAstroやNext.js、その他のWeb開発プロジェクトにおいて、手元のAIコーディングツール(Antigravity、Claude Code、Cursorなど)に本記事の仕組みを段階的に実装させたい場合は、以下の設計指示プロンプトをそのままコピー&ペーストして活用してみてください。
私たちのプロジェクトで複数のAIチャットを同時に動かした際、以下の3つの問題を防ぐ仕組みを段階的に実装してください。
1. 【0トークン順番待ち(wait-turn)の実装】
- AI自身がタイマー(scheduleやsleepループ)でポーリングするのを禁止してください。
- 同一ファイルの編集競合やデプロイ枠の順番待ちが発生した際は、バックグラウンドで1回だけ起動してロック解放時に `exit 0` で終了する軽量な待機コマンド(`wait-turn <session_id>`)を用意し、コマンド完了通知(Reactive Wakeup)でAIが自動再開する設計にしてください。
- 待機キューは先着順(FIFO)とし、先行セッション終了時はファイル削除ではなく待機先頭セッションへ直接オーナー権を移譲してください(90秒無応答または待機プロセス不在時は次順位へ自動スキップ)。
2. 【編集ロックとデプロイロックの2層分離】
- ロック状態ファイルを「並行編集マップ(ファイルパス単位:別ファイルなら複数チャット同時編集OK)」と「デプロイスロット(ビルド〜本番転送の最終フェーズのみ1チャット直列)」の2層に分離してください。
3. 【選択ステージングと git worktree 隔離ビルド】
- デプロイ時に `git add .` や `git stash` を使わないでください(同時稼働中の他チャットの作業ファイルを消したり巻き込んだりしないため)。
- `git status --porcelain -z -uall` と完了スタンプを用いて、現在のチャットが完了させたファイルのみを選択コミットし、他チャットの未完了ファイルが作業ツリーに残っている場合は `/tmp` または RAMDisk 上のクリーンな `git worktree`(`git rev-parse --verify HEAD` のSHAを `--detach` チェックアウト)でビルド・検証・デプロイを実行するスクリプトを作成してください。
まとめ:人間の「交通整理」をなくして並列開発する
本記事では、AIエディタで複数のチャットを同時並行で動かした際に直面した3つの事故(毎分タイマー確認によるAPI浪費、書きかけ原稿の巻き込み公開、単一ロックによる別ファイル編集の待ち時間)と、それらを根本から解決した第3世代の並列パイプライン実装録をお届けしました。
最後に、今回の設計の要点を振り返ります。
-
ポーリングを捨てて「非同期プロセスの終了通知」で待つ :AIにタイマーで定期確認させるのではなく、軽量なネイティブプロセス(
wait-turn)の終了通知(Reactive Wakeup)を使うことで、待機中のAPIトークン消費を 完全0トークン に抑え、先着順(FIFO)で確実に自動再開させます。 -
「机(編集枠)」と「出荷窓口(転送枠)」を2層に分ける :ロックをファイル単位の並行編集マップ(
activeEditors)と最終転送スロット(ownerConvoId)に分離することで、別々の記事やコードなら何チャットでも待ち時間ゼロで同時並行で書き進められます。 -
メイン作業フォルダの書きかけ原稿には1バイトも触れず、worktreeで隔離出荷する :
git stashで作業中ファイルを一時消去する危険を冒さず、完了ファイルのみを選択コミットした上で、RAMDisk上のクリーンなgit worktree(ビルドキャッシュ共有)から安全・高速に本番転送を完遂します。
AIエージェントが複数同時に働く時代において、人間が「今はあっちのチャットがビルド中だから、こっちの指示は待とう」と頭の中で交通整理をする必要はもうありません。
OSのファイルロックとGitの worktree、そして非同期プロセス通知を正しく組み合わせることで、思いついたアイデアや改善タスクをいつでも好きなだけ並列で投げ込める快適な開発環境が手に入ります。

これで4つのチャットに別々の仕事を頼んでも、お互いの原稿を混ぜちゃうこともないし、順番待ちでチケット代(トークン)を無駄遣いすることもなくなったのね!

人間の交通整理がいらなくなったおかげで、ボクも安心してキーボードの横で昼寝ができるにゃ。でも、AIが4人同時に働いていても、ボクのおやつの順番待ちだけは0秒でお願いするにゃ!
