Cloudflare가 AI로 엔지니어링 표준을 강제하는 방식

Cloudflare의 AI 코드 리뷰어가 지난 4개월 동안 엔지니어링 표준 위반 nearly 25만 건을 찾아내고, 1만6,000건의 merge를 차단했다. 기술 설계 검토 에이전트도 같은 표준을 적용해 약 600건의 설계를 구현 전에 평가했다.

이 시스템의 기반은 사람과 AI 에이전트가 함께 사용하는 엔지니어링 지식 저장소 Cloudflare Codex다. 기존 지침은 공식 문서, 저장소 파일, 채팅 기록, 개별 엔지니어의 경험 등 여러 곳에 흩어져 있어 최신성이나 권위, 적용 가능성을 판단하기 어려웠다.

Codex는 엔지니어링 표준을 영역별로 관리한다.

• 프론트엔드·컨트롤 플레인 등 아키텍처 영역
• 보안·신뢰성 등 여러 영역에 걸친 공통 관심사
• TypeScript·Rust 등 프로그래밍 언어별 기준

각 영역의 소유자는 문서의 내용과 일관성, 품질을 관리한다. 표준은 RFC 2119에 정의된 SHOULD와 MUST 키워드를 사용하는 RFC 형식으로 작성하며, 도메인과 RFC 상태 같은 메타데이터도 함께 관리한다.

직원은 정해진 구조의 merge request로 RFC를 제안할 수 있다. 제안서는 점차 범위를 넓혀가는 검토 과정을 거치고, 도메인 소유자가 최종 승인하면 Codex에 편입돼 Astro 기반 내부 사이트에 공개된다.

승인된 RFC는 Codex 클라이언트와 에이전트가 코드, 설정, 문서의 위반 사항을 즉시 탐지하는 데 활용할 수 있다. 다만 실제 merge 차단은 RFC가 approved에서 enforced 상태로 승격된 뒤에만 이뤄진다. 이 별도 단계는 팀이 새 요구사항을 받아들일 시간을 제공하고, 자동화된 집행 작업이 추가로 필요한 경우에도 대응할 수 있게 한다.