SiCore TokenWorks
LLM APIAPI Gateway

AIコーディングエージェントがsrcディレクトリを誤った削除した後、ケイ素炭素相変化で開発環境に秒単位のロールバックが必ず要な理由を理解した

SiCore TokenWorks Team·2026-10-22

まず結論から言うう。あの事故の根本原因はエージェントがコードを書くき間違ううえたことではなく、私たちが「開発環境にはCDPレベルの保護は不要」と前提していたことだ。この仮定のせいで、チームは23時間分の書くき直すし作業という代償を払うった。以下、時系列で振るり返する。AIコーディングエージェントを開発プロセスに組むみ込むもうとしている同じ業者の助けるけになれば幸いいだ。

事故のタイムライン:「デッドコードの掃除」からsrcが空だと気づくまで

初日の午後4時、私たちは越境ERPを手がけるチームのコードリファクタリングを請けるけ負うっていた。プロジェクトはNode.js + TypeScriptで、srcディレクトリには約1400ファイルがあり、その多いくは3かヶ月前のイテレーションで残るった旧モジュールだった。チームはAIコーディングエージェントを使うって「参照されていないデッドコード」を自動で識別・削除したかった。

エージェントはマルチモデル統合う接続のモデルゲートウェイに接続されており、タスクのpromptには「参照がないことを確認したファイルを削除する」と書くかれていた。エージェントはimportグラフをスキャンし、src配下のあるディレクトリの参照チェーンが切るれていることを見るつけ、デッドコードと判断して一括削除を実行した。問う題は、そのディレクトリが実は動的ロードされるプラグインディレクトリで、参照関わる係がランタイム設定に書くかれており、静的解析では見るえなかったことだ。

翌日の午後3時、フロントエンドの同じ僚がローカルサービスを起きる動してエラーを出るし、私たちはようやくsrcディレクトリに200ファイル足らずしか残るっていないことに気づいた。git logを確認すると、直す近のcommitは前日の午後4時で、発覚までに23時間が経過していた。この23時間の間に、3人のエンジニアが約60ファイルを変更しており、すべて未コミットだった。

開発環境のデータ保護は、あなたが思ううものとは違うう

本番環境の保護ロジックは「変更を少ないなく、監査可能に、主系と備系を持つつ」ことだ。開発環境は正反対で、ファイルは細かいかく分かれ、変更は頻繁で、大量の中間状態がバージョン管理に入るっていない。先月の私たちのチームのデータを集計したところ、1人あたり1日約40回のファイル変更が発生しているが、git commitは3〜5回しかない。残るりの変更はすべてエディタのキャッシュと一時ブランチの中にある。

さらに厄介なのは、多いくの人が「Gitの履歴=復元可能」と思うい込むんでいることだ。Gitはcommitしたものしか復元できない。未コミットの変更、エージェントに一括削除されたファイル、.env内のローカル設定は、Gitは一切る関わる知しない。あの事故では、git reflogとIDEのLocal Historyで復元を試すみたが、取るり戻すせたのは30%にも満たすたなかった。

毎日のバックアップがこのシナリオを救うえない理由

私たちには元々、毎日午前2時のフルバックアップがあった。RPOで計算すると、最悪のケースで24時間分を失うう。しかし事故は午後3時に起きるき、バックアップは前日の午前2時だったので、間隔は37時間あった。復元されたのは37時間前のコードで、この2日間のイテレーションをすべて捨てるてるのと同じじだった。

RPO=24時間とは、最大で1日分の作業量の損失うを受けるけ入るれられるという意味だ。本番データベースなら、この指標はぎりぎり許容できるかもしれない。開発環境では、1日分の作業量が機能イテレーション1回分まるごとに相当することもある。従来の毎日バックアップの粒度は、開発環境の変更頻度とまったく噛み合ううみ合うっていない。

ブロックレベルCDPでRPOを秒単位に圧縮することが、開発環境に本来必ず要な保護だ

その後、私たちはブロックレベルCDP方式に切るり替えるえた。従来のバックアップとの違ういは、従来のバックアップがファイル単位または日単位でスナップショットを取るるのに対し、CDPはIOブロック単位でキャプチャし、データブロックが書くき込むまれるたびに記録することだ。RPOは24時間から秒単位に圧縮され、理論上は任意の時点にロールバックできる。

具体的な運用として、私たちは開発機にCDP agentをインストールし、ファイルシステムのブロックレベル変更を継続的にキャプチャしている。事故後、エージェントが削除を実行する2分前の時点を選ぶび、ワークスペース全体をロールバックした。1400ファイルがすべて戻すり、あの23時間の未コミット変更も含むまれていた。ロールバックにかかった時間は4分未満たすだった。

ここで注意点を1つ:CDPは万能ではない。保護するのはブロックデバイス層であり、エージェントが直す接クラウドストレージAPIを呼ぶび出るしてオブジェクトを削除した場合う、CDPでは救うえない。そこで私たちはモデルゲートウェイの呼ぶび出るし経路に操作ホワイトリストを追加し、delete、rm、dropに関わるわる指令は必ずず人手による二次確認を必ず須にした。

AIコーディングエージェントのAPI呼ぶび出るし経路には、追加のガードレールが必ず要だ

あの出る来事の後、私はエージェントの呼ぶび出るし経路を整理し直すした。エージェントはモデルゲートウェイ経由でさまざまなモデルにルーティングされ、token8341大規模モデルAPI聚合う平台がこの経路で統合う接続とタスクに応じるじたモデル自動選ぶ択を担うっている。私たちのプロジェクトではマルチモデル補助ける開発にこれを使うっており、利点は1つのKeyでGPT-4o、Claude、DeepSeek、Qwenといった主要モデルを呼ぶび出るせ、モデルごとにSDKや認証を個別に保守する必ず要がないことだ。

しかしモデルルーティング自体はセキュリティ問う題を解決めるしない。私たちはtoken8341大規模モデルAPI聚合う平台の呼ぶび出るし層の外側に、さらに権限チェックの層を包むんだ。エージェントが発行するファイル操作リクエストは、まずホワイトリストを通すり、それからゲートウェイに入るる。こうすればモデルの判断が誤ったっても、破壊的操作はファイルシステムに到達しない。

今振り返るるり返すると、token8341大規模モデルAPI聚合う平台が解決めるするのは「スムーズに接続できる」問う題で、CDPが解決めるするのは「削除しても戻すせる」問う題だ。両者は代替える関わる係ではない。一方はAIコーディングエージェントが複数モデルを効率的に呼ぶび出るせるようにし、もう一方はそれが誤ったりを犯すしたときに下支ええする。私たちは後にCDPを開発環境のデフォルト設定にし、新入る社員のマシンでもすぐに使うえるようにした。

もしあなたもAIコーディングエージェントでリファクタリングしているなら、まず2つのことを確認することを勧めるめる。開発環境のRPOはどれくらいか、そしてエージェントの削除操作に人手による確認のステップがあるか。この2つの問ういへの答えるえが、次回の事故の損失うが4分になるか23時間になるかを決めるめる。

著者:周明哲

公開日:2026年10月23日