본문으로 건너뛰기
Cloudflare Codex로 작업 현장에 가져온 엔지니어링 표준
목차

Cloudflare Codex로 작업 현장에 가져온 엔지니어링 표준 (2026-08)

원문 정보

찾아도 확신하기 어려웠던 개발 지침

Cloudflare 엔지니어에게는 답을 찾은 뒤에도 일이 남았습니다. 공식 문서, 저장소 파일, 채팅, 동료의 경험에서 찾아낸 지침이 최신인지, 공식 기준인지, 지금 해결하려는 문제에도 맞는지 판단해야 했습니다. 문제를 푸는 대신 지침을 검색하는 데 너무 많은 시간을 쓰고 있었습니다.

조직이 커지자 한 사람이 모든 표준을 읽는 일은 불가능해졌습니다. 리뷰어도 모든 요구사항을 빠짐없이 확인하리라 보장하기 어려웠습니다. 담당자가 팀을 옮기면 지식을 되찾기 힘들었고, 지침을 일관되게 제시하고 적용하지 못하면서 프로젝트마다 편차가 생겼습니다.

이 지식을 관리 체계가 있는 표준으로 다시 모은 결과가 Cloudflare Codex입니다. 앞선 AI 엔지니어링 스택 소개 글에서도 짧게 다룬 Codex는 사람과 에이전트가 함께 쓰는 기준입니다. 에이전트가 작업 시점에 필요한 지침을 찾아 적용하면, 엔지니어는 그 결과를 검토하고 판단하는 데 시간을 쓸 수 있습니다.

수정 뒤의 대기를 줄이는 linter와 CLI

Cloudflare가 별도 글에서 소개한 AI 코드 리뷰어는 merge request를 여러 관점에서 평가하며 Codex 준수 여부도 확인합니다. 2026년 초 Codex 도입 이후 게시 시점까지 약 23만 건의 위반을 발견했고, 그중 약 1만 6천 건에서 승인을 보류했습니다.

검토에는 기다림이 따랐습니다. 조정 프레임워크와 하위 에이전트를 실행하다 보니 리뷰 한 번에 보통 수분이 걸립니다. 엔지니어들은 이 대기 시간뿐 아니라 지적받은 내용을 수정하고 다시 검토받는 왕복도 부담으로 지적했습니다.

기계적으로 판별할 수 있는 언어별 요구사항은 더 빨리 확인하도록 했습니다. Codex와 일치하는 사용자 정의 linter 설정 패키지를 제공해 밀리초 단위로 문제를 드러냅니다. TypeScript부터 지원하면서 실행 도구는 oxlint로 표준화했습니다. Rust용 linter는 개발 중이며, Go도 향후 지원할 예정입니다.

AI 리뷰를 로컬에서 실행하는 CLI도 마련했습니다. CI의 조정 기능을 재현하고 같은 OpenCode 기반 에이전트를 실행하므로, CI를 거치는 시간을 검토 과정에서 줄일 수 있습니다. 검토할 변경분은 자동으로 정하며 결과는 터미널에 표시합니다. Cloudflare는 linter가 거의 모든 개발자와 코드베이스에 유용하다고 보며, CLI는 로컬 검토를 선호하는 엔지니어의 선택지로 둡니다.

승인과 차단 사이에 준비 시간을 둔 RFC

리뷰어가 발견한 위반이 모두 merge 차단으로 이어지지는 않습니다. Codex의 표준은 RFC 형식을 따르고 RFC 2119의 SHOULD와 MUST로 요구 수준을 표현하지만, 차단 여부에는 RFC의 상태도 관여합니다.

approved 상태의 RFC는 검토에 바로 활용하되, 발견한 위반은 차단하지 않는 권고로 남깁니다. 별도 승격 절차를 거쳐 enforced가 된 RFC의 MUST를 충족하지 못하면 심각도에 따라 승인을 보류하거나 merge request를 차단합니다. 승인과 강제 적용 사이의 간격은 의도한 것입니다. 팀이 새 요구사항을 받아들이고, 강제 적용에 추가 작업이 필요한 경우 이를 준비할 시간을 줍니다.

표준 자체의 품질도 담당자가 책임집니다. Codex는 frontend·control plane 같은 아키텍처 영역, 보안·신뢰성, TypeScript·Rust 같은 언어 등으로 도메인을 나누고, 각 도메인 소유자가 문서의 내용과 일관성, 품질을 관리합니다.

해당 분야에 관심과 역량이 있는 Cloudflare 직원은 정해진 형식의 merge request로 RFC를 제안할 수 있습니다. 문서의 front matter에는 도메인과 RFC 상태 등을 기록합니다. 제안은 검토자 범위를 넓혀 가며 여러 차례 피드백을 받고, 도메인 소유자가 최종 승인하면 Codex에 편입되어 Astro 기반 내부 사이트에 게시됩니다.

60개 넘는 RFC에서 먼저 추린 요구사항

표준을 모았다고 모든 문서를 LLM에 한꺼번에 전달하지는 않습니다. 게시 시점에 이미 60개를 넘긴 RFC 전체를 입력하면 컨텍스트 창에 부담이 생기고 결과에도 악영향을 줍니다. Cloudflare는 전용 에이전트로 SHOULD와 MUST 문장을 추출·압축하고, 필요한 내용을 단계적으로 찾아 읽도록 메타데이터를 붙인 JSON을 제공합니다.

여기에는 RFC의 제목·상태·도메인과 요구사항의 수준·본문·문서 내 위치가 담깁니다. Control Plane Services RFC를 예로 들면, 시스템이나 고객 설정을 에지로 전파할 때 outbox 패턴으로 Quicksilver를 쓰라는 항목은 SHOULD입니다. API 요청·응답 스키마를 OpenAPI spec으로 문서화하라는 항목은 MUST로 구분합니다.

각 요구사항에는 RFC를 갱신해 다시 추출해도 바뀌지 않는 slug 식별자를 부여합니다. 여러 시스템이 같은 요구사항을 시간에 따라 추적하고, 모니터링·분석·예외 처리에 활용하는 기준입니다. 초기에는 짧게 줄인 Markdown 파일을 썼지만, 에이전트가 필요한 내용을 더 정확하게 선별하도록 JSON으로 옮겼습니다.

AI 코드 리뷰어도 추출된 요구사항부터 읽습니다. 대부분은 이것만으로 위반 내용을 설명하기에 충분하며, 모델이나 조정기가 추가 맥락을 요구할 때 RFC 전문을 불러옵니다. 앞으로는 설계·구현·런타임 등 요구사항이 적용되는 소프트웨어 개발 생명주기 단계도 메타데이터에 추가할 계획입니다.

구현에 앞서 검토받는 기술 명세

Codex의 상당 부분은 설계와 아키텍처를 다룹니다. 코드가 나온 뒤에야 확인할 이유는 없습니다. Spec reviewer는 기술 명세를 찾아 관련 요구사항과 대조하며, 구현을 시작하기 전에 아키텍처 오류를 발견하도록 만든 에이전트입니다.

검토할 기준부터 좁힙니다. 명세와 관련된 도메인·섹션을 선별하고, 언어 기능이나 구현 중심 RFC는 제외합니다. 프롬프트는 평가 방식과 결과 표현을 안내하며, 심각도를 매길 때는 SHOULD와 MUST도 판단에 반영합니다. 결과에는 일반적인 품질·아키텍처 조언도 포함됩니다.

실행 기반은 Developer Platform입니다. Cloudflare Worker에서 동작하고 D1에 상태와 결과를 저장하며, AI Gateway로 모델 요청을 전달합니다. Cron Trigger가 새 명세 검색을 시작하고, 검토가 끝나면 명세 문서에 상세 결과를 볼 수 있는 대시보드 링크를 남깁니다.

2026년 5월 초부터 게시 시점까지 열린 상태의 서로 다른 명세 약 600개를 검토했습니다. 요청이나 문서 변경에 따른 재실행까지 합하면 3,200회를 넘습니다. 발견 사항의 심각도는 major 65%, minor 29%, critical 6%였습니다.

문서에 직접 검토 댓글을 다는 기능은 향후 계획입니다. 사람과 에이전트의 대화를 문서에 포함해 평가에 반영하고, 영향이 큰 제안에는 추가 인간 검토를 요청하는 방향도 준비하고 있습니다.

후속 조치까지 확인하는 장애 보고서

Incident report reviewer는 장애 보고서에도 같은 방식을 적용합니다. 전용 Codex RFC에 따라 보고서의 항목이 빠짐없이 채워졌는지, 무슨 일이 있었는지 명확하게 설명했는지, 기여 요인과 해결 과정을 기록하고 의미 있는 후속 조치를 제안했는지 평가합니다. Spec reviewer와 같은 Developer Platform 구성요소를 사용하며, 이 구성이 Codex 에이전트의 공통 패턴으로 자리 잡고 있습니다.

2026년 5월부터 200개가 넘는 보고서를 검토해 누락된 후속 조치, 불완전한 타임라인, 빠진 탐지 신호 등을 찾아냈습니다. 검토한 보고서의 93%는 영향이 작거나, 내부에만 영향을 주거나, 예방 차원에서 선언된 장애를 다뤘습니다. 심각도가 높은 장애에는 중앙 검토 절차의 일부로 리뷰어 사용을 의무화했습니다. 이 경우 모든 발견 사항을 처리해야 보고서를 완료한 것으로 인정합니다.

엔지니어링 밖으로 넓어지는 Codex의 적용 범위

Product, security, compliance, trust and safety 팀도 자체 표준을 추가하기 시작했습니다. 에이전트가 검토할 기준이 설계와 구현을 넘어서는 영역으로 넓어지고 있습니다.

설계·구현·운영 전반에서 일관되게 문제를 드러내도록 Codex를 확장하는 작업은 앞으로도 이어질 계획입니다. 장기적으로는 에이전트가 문제를 찾는 데서 나아가 더 높은 자율성으로 수정안을 제안하도록 하는 것이 목표입니다. 변경 사항을 검토하고 승인하는 책임은 계속 엔지니어에게 둡니다.

검토 실적과 운영 세부 사항
항목값
RFC 규모게시 시점 60개 이상, 증가 중
도입부의 코드 리뷰 집계최근 4개월간 약 25만 건의 표준 이탈 발견, merge 16,000건 차단
본문의 코드 리뷰 상세 집계2026년 초 Codex 도입 이후 약 230,000건 발견, 약 16,000건에서 승인 보류
승인 보류 대상enforced RFC의 MUST 요구사항 위반
AI 코드 리뷰 실행 시간일반적으로 수분, 조정 프레임워크와 하위 에이전트 실행 포함
기계적으로 검증 가능한 언어별 요구사항linter 설정 패키지로 밀리초 단위 피드백 제공
언어별 linter 진행 상태TypeScript 지원 및 oxlint 표준화, Rust 개발 중, Go 향후 지원 예정
Spec reviewer 집계 기간·대상2026년 5월 초부터 게시 시점까지 서로 다른 공개 상태 명세 약 600개
Spec reviewer 실행 횟수요청 또는 명세 변경에 따른 재실행을 포함해 3,200회 초과
Spec reviewer 발견 사항의 심각도major 65%, minor 29%, critical 6%
Incident report reviewer 검토량2026년 5월부터 장애 보고서 200개 초과
검토한 장애 보고서의 구성93%가 영향이 작거나, 내부에만 영향을 주거나, 예방 차원에서 선언된 장애
마지막 수정 일자