CloudflareのCodex：AIによるエンジニアリング標準の大規模適用 | Manul X

CloudflareはAIによるエンジニアリング標準適用の内部実験を実施しており、その数字は無視できません。過去4か月間で、AIコードレビュアーは会社の標準からの逸脱を約25万件フラグし、1万6千件のマージをブロックしました。別の仕様レビュアーは、実装開始前に約600件の技術設計を評価しました。両システムは、人間とエージェントの両方のために構築された共有のエンジニアリングガイダンスソースであるCloudflare Codexから情報を取得しています。

Codex以前は、Cloudflareの開発者向けガイダンスは散在していました：正式なドキュメント、リポジトリファイル、チャットスレッド、そしてシニアエンジニアの頭の中。適切な標準を見つけることは、しばしば時代遅れのWikiを探検するか、知っているかもしれない誰かに連絡することを意味しました。会社が成長するにつれて、そのモデルは崩壊しました。誰もすべての標準を読むことができず、レビュアーはすべての要件を確実にチェックできませんでした。

Codex：管理されたRFCパイプライン

Codexはドメインごとに整理されています—アーキテクチャ、セキュリティ、信頼性、TypeScriptやRustなどの特定言語—それぞれにコンテンツ品質を担当するオーナーがいます。標準はRFC 2119のSHOULDおよびMUSTキーワードを使用してRFCとして記述されます。任意の従業員がマージリクエストを介してRFCを提案でき、ドメインオーナーの承認前にフィードバックのラウンドを経ます。承認されたRFCはCodexの一部となり、内部のAstroベースのサイトに公開されます。

しかし、承認は適用ではありません。RFCは、そのMUST要件がマージをブロックできるようになる前に、承認済みから適用済みに明示的に昇格される必要があります。この2段階プロセスにより、チームは新しい要件を吸収する時間を得られ、適用に追加作業が必要なケースに対応できます。

コンテキストウィンドウを壊さずにLLMに供給する

60以上のRFCがあり、増え続けているため、Codex全体をLLMに供給するとコンテキストウィンドウに負荷がかかり、結果が劣化します。そこでCloudflareは、SHOULDおよびMUSTステートメントを抽出してコンパクトな構造化JSON形式に変換するエージェントを構築し、遅延ディスカバリと段階的開示のためのメタデータを追加しました。各ステートメントには、RFCの更新を超えて持続する安定したスラッグ識別子が付けられ、システム間での追跡が可能になります。

JSON形式には、RFC番号、ドメイン、ステートメントレベル、および完全なRFCセクションへのリンクが含まれます。これにより、エージェントはドキュメント全体を読み込まずに正確にフィルタリングできます。

3つのエージェント、1つのCodex

AIコードレビュアーは、Codexコンプライアンスに対してマージリクエストを評価します。関連するRFCを取得し、ステートメントを解析し、SHOULD対MUSTおよびRFCステータスに基づいて決定します。開始以来、約23万件の違反をフラグし、そのうち約1万6千件が承認の保留を引き起こしました。

レイテンシの苦情に対処するため、Cloudflareは2つの代替手段を追加しました：言語固有の要件（TypeScriptが最初、Rustが開発中、Goは後で）のためのカスタムリンタ設定パッケージで、問題をミリ秒単位で表面化し、CIラウンドトリップを排除する同じOpenCodeベースのエージェントをローカルで実行するCLIです。

仕様レビュアーは、実装前に設計ドキュメントを評価します。Cloudflare Workerとして実行され、状態をD1に保存し、AI Gatewayを介してモデルリクエストをルーティングし、Cron Triggerを介して新しい仕様をスキャンします。2026年5月以降、3,200回以上の呼び出しで約600件のユニークな仕様をレビューしました。調査結果は重大度で評価されます：65%が重大、29%が軽微、6%が致命的。

インシデントレポートレビュアーは、同じパターンをポストモーテムに適用し、インシデントの説明、貢献要因、解決策、およびフォローアップアクションの完全性と品質をチェックします。

要点

CloudflareのCodexは、エンジニアリング標準を文書化するだけでなく実行可能にする真剣な試みです。重要な洞察は、承認と適用の分離、およびLLMコンテキストウィンドウを健全に保つ構造化抽出です。機械的チェックのためのリンタアプローチは実用的であり、CLIオプションはエンジニアの好みを尊重します。これは他の大規模組織がおそらく参考にする青写真です。