Paul Jialiang Wu agentic-portfolio English 中文 Español 日本語✉️ 무료 구독
← 포트폴리오로 돌아가기

AI-Native 시리즈 · ANDON · 에이전트형 PR 리뷰와 CI/CD · 5부작 중 4화

자동 병합 경계선: 영향 범위는 경로 목록

에이전트형 PR 리뷰와 CI/CD, 4화. 2026-09-01, GitHub가 Copilot의 승인이 저장소의 필수 승인에 포함될 수 있는 설정을 배포했다. 초기값은 비활성화이며, 이로 촉발된 논쟁은 AI가 승인할 만큼 충분히 똑똑한가에 집중됐다. 그러나 진짜 질문은 '무엇을 승인할 수 있는가'다. 이번 화는 ANDON의 O, 즉 경계선 내부에서만 적용되는 규칙을 다룬다. 신뢰도 점수가 아니라 경로 목록으로 정의된 자동 병합 경계선을 만들고, 다섯 가지 조건이 모두 동시에 충족되어야 하며, 실제 PR이 이 경계선을 통과했으나 정확히 한 조건에서 실패했고, 브랜치 보호 API가 403을 반환해 결국 병합이 불가능했던 사례를 보고한다.

작성: Paul Jialiang Wu · futuremake.io · 2026-09-09 · 5부작 중 4화

Cover: white ground with a black left rail. Eyebrow ANDON · AGENTIC PR REVIEW & CI/CD · EPISODE 4 OF 5 · ONLY IN THE ENVELOPE above the two-line serif title The Auto-Merge Envelope: Blast Radius Is a Path List, two grey lines: On 2026-09-01 GitHub let an AI count as a required approver. Whether it may is now a setting. Where an AI may merge is a list of paths, not a confidence score; deny beats allow, always. Three grey cards: WHAT IT IS, the O in ANDON, built, five AND conditions, one path list, one proof; WHO IT IS FOR, anyone about to flip that setting, engineers, founders, the curious student; WHAT YOU LEAVE WITH, an envelope contract, allow, deny, five conditions, plus the 5 Whys. A black band: THE ONE FINDING · ONE REPOSITORY · 2026-09-09 — A docs-only PR passed the envelope; exactly one condition failed: the AI had not measured it. The envelope classifies today. It cannot merge yet: the branch-protection API still returns 403. That is reported, not rounded.
단 하나의 발견, 그 범위: 한 저장소, 한 문서 전용 PR, 하나의 403.

1분 요약 — 이 글을 읽고 얻어갈 것

이 글의 정체성 ANDON ANDON 5부작 중 4화, 에이전트형 PR 리뷰와 CI/CD를 다루는 시리즈다. 이번 화는 경계선 내부에서만 적용되는 규칙을 다룬다.엔벨로프 내부에서만 적용되는 규칙— 실제 저장소에 구현된 자동 병합 경계선이다. 자동 병합 경계선이란, 경로별 허용 목록과 거부 목록을 명시하고, 봇이 승인과 병합을 시도하기 전에 반드시 동시에 충족해야 하는 다섯 가지 조건, 변경 작성자와 변경 규모를 점검하는 두 개의 게이트, 그리고 아직 충족되지 않은 마지막 한 항목의 상태까지 투명하게 드러낸다.

왜 이 논의가 중요한가. 엔지니어라면 이제 병합 버튼의 위치가 달라졌음을 알게 된다. 벤더의 AI가 승인할 수 있고, 같은 벤더의 에이전트가 리뷰 피드백과 실패한 체크를 자동으로 처리해준다. 남은 유일한 설계 결정은 바로 '어디까지 허용할 것인가'라는 설정뿐이다. 창업자라면 Stripe가 매주 1,000건이 넘는 에이전트 생성 PR을 인간의 검토만 거쳐 병합한다는 사실을 본다. 이제 병목은 리뷰어가 아니라 병합 대기열이다. 학생에게는, 이 시리즈에서 가장 오래된 개념인 '명시적 제한'이 최신 자동화 버튼에 적용되는 장면을 보여준다.

이 글을 읽고 할 수 있는 일. 경계선을 데이터로서 경로 목록 형태로 작성하되, 허용보다 거부가 우선하도록 설계하라. 자동 병합은 다섯 가지 조건이 모두 충족되어야만 동작하게 만들고, 실패한 조건은 첫 번째만이 아니라 전부 나열하라. 커밋 트레일러에 봇의 서명은 거부하라. 그리고 브랜치 보호 상태는 있는 그대로 보고하라. 분류만 하는 경계선은 아직 실제 병합을 수행하는 경계선이 아니기 때문이다.

ANDON — 시리즈 줄기
  1. A · Assess — PR 홍수는 측정되는 것이지 느껴지는 것이 아니다 1화
  2. N · 침묵하지 않음 — 저장소를 위한 지도카 2화
  3. D · Data, not prose — 어긋날 수 없는 규칙 3화
  4. O · 경계선 내부에서만 — 영향 범위는 경로 목록으로 정한다 이번 화
  5. N · 네거티브 테스트 — 게이트는 반드시 실패(레드)를 경험한 뒤에만 설치된다 5화

이번 화의 다루는 범위와 자동 병합 경계선이 네 번째에 오는 이유

1~3화에서는 결정의 근간이 되는 부품들을 만들었다. 의견이 개입되지 않는 기계적 게이트, 게이트가 실행 불가일 때를 명확히 구분하는 제3의 상태, 그리고 모든 규칙의 근거가 되는 규칙 파일이다. 이번 화는 이 부품들이 스스로 취할 수 있는 단 하나의 행동, 즉 병합에 집중한다. 이 행동이 네 번째에 오는 이유는, 앞선 세 가지 규칙이 모두 지켜질 때만 병합이 안전하기 때문이다. 산문 규칙만 두른 2상태 게이트에 경계선만 그려놓으면, 그건 구멍에 불과하다.

이 화를 앞둔 30일 동안 병합 버튼의 위치가 실제로 바뀌었다. 2026년 9월 1일, GitHub는 Copilot 코드 리뷰 승인이 필수 승인 규칙에 포함될 수 있다고 발표했다. 이 기능은 기본적으로 비활성화되어 있고, 엔터프라이즈·조직·저장소별로 설정할 수 있으며, 새로 푸시가 발생하면 인간 승인처럼 무효화된다. 그리고 중요한 한 문장이 있다:"An approval assessment alone does not count toward merge requirements."(번역: 승인 평가만으로는 병합 요건을 충족하지 않는다.) [1] 3일 뒤 주간 릴리스 노트에서 다음 단계를 설명했다:"Agent Merge is now in public preview and gets your pull request ready to merge by resolving review feedback, failed checks, and merge conflicts."(번역: Agent Merge가 이제 공개 프리뷰로 제공되며, 리뷰 피드백·실패한 검사·병합 충돌을 자동으로 해결해 풀 리퀘스트가 병합될 준비를 마친다.) [2] Stripe는 이미 2월에 이렇게 밝혔다. "Over a thousand pull requests merged each week at Stripe are completely minion-produced, and while they're human-reviewed, they contain no human-written code."(번역: Stripe에서는 매주 1,000건이 넘는 풀 리퀘스트가 전적으로 에이전트에 의해 생성되어 병합된다. 인간이 리뷰는 하지만, 그 안에는 인간이 쓴 코드는 전혀 없다.) [3] 그리고 2026년 머지 큐 보고서에 따르면, AI가 보조한 PR이 샘플 내 비공개 병합의 14.4%를 차지했고, "broke main half as often, even after controlling for PR size and repository."(번역: PR 크기와 저장소를 통제한 후에도 메인 브랜치를 깨뜨리는 빈도가 절반에 불과했다.) [4]

"AI가 병합하기에는 아직 충분히 좋지 않다"는 주장은 증거 앞에서 설득력을 잃고 있다. 반대로 "AI가 충분히 좋다"는 주장 역시 논점이 어긋난다. '좋음'은 신뢰도 점수일 뿐이고, 신뢰도 점수는 잘못됐을 때 무슨 일이 벌어지는지 말해주지 않는다. 실제로 중요한 것은 영향 범위다. 이번 화의 규칙은 다음과 같다. 봇이 병합할 수 있는 범위는 경로 목록으로 명시하며, 이 목록 자체가 설계의 핵심이다..

30년짜리 버전: 병합 결과를 먼저 검증하고, 그다음에 문을 직렬화하라

안전한 자동 병합의 계보란 '병합'의 의미를 점점 더 좁혀온 역사다. 2013년 Rust 프로젝트의 봇 bors는 병합 결과 자체를 테스트 대상으로 삼았다. 2015년 설명에는 이렇게 적혀 있다: "Homu will take the pull request, merge it with master into a new branch, and submit that branch to a testing backend."(번역: Homu는 풀 리퀘스트를 받아 마스터와 병합한 새 브랜치를 만들고, 그 브랜치를 테스트 백엔드에 제출한다.) [5] 초록불이 켜진 PR과 초록불이 켜진 메인은 다르며, bors는 이를 처음으로 널리 인정하게 만든 사례였다. 2023년 7월 GitHub는 머지 큐를 정식 출시하며 그 목표를 이렇게 설명했다: "ensuring the branch is never broken by incompatible changes."(번역: 브랜치가 호환되지 않는 변경으로 인해 결코 깨지지 않도록 보장한다.) [6] Chromium의 커밋 큐는 모든 대형 프로젝트가 결국 도입하게 되는 재시도 규칙을 추가했는데, 그 문서에서 이례적으로 솔직하게 다음과 같이 명시했다: "If the retry succeeds, then the failure is ignored."(번역: 재시도가 성공하면, 그 실패는 무시된다.) [7] 그리고 2026년 7월에는 리뷰어가 더 이상 병목이 아니라는 관찰에 이름이 붙었다: "The constraint didn't disappear. It moved downstream, to the narrowest pipe in the system: the serialized path between 'approved' and 'on main.'"(번역: 제약이 사라진 것이 아니다. 시스템에서 가장 좁은 파이프, 즉 '승인됨'과 '메인 반영' 사이의 직렬화된 경로로 이동했을 뿐이다.) [8]

이 경로 목록 설계에 중요한 맥락이 두 가지 더 있다. 리눅스 커널의 코딩 어시스턴트 규칙은 기계의 산출물과 인간의 책임 사이의 경계를 가장 명확하게 선언한다: "AI agents MUST NOT add Signed-off-by tags. Only humans can legally certify the Developer Certificate of Origin (DCO)."(번역: AI 에이전트는 Signed-off-by 태그를 추가해서는 안 된다. 오직 인간만이 Developer Certificate of Origin(DCO)을 법적으로 인증할 수 있다.) [9] 커널은 이를 'assisted-by' 트레일러로 같은 선언을 요구한다. Apache Software Foundation에서는 이를 커밋 메시지의 'generated-by' 토큰이라 부른다 [10]. 그리고 2026년 상위 2,000개 저장소의 AI 정책 조사에서는 83.3%가 AI 사용을 허용하고, 48.8%는 공개를 요구하며, 14.9%는 금지하는 것으로 나타났다 [11]. 이 조사는 누가 쓸 수 있는지는 기록하지만, 봇이 어디에 병합할 수 있는지는 기록하지 않는다. 바로 그것이 이번 화의 질문이다.

1화에서 주방을 빗댄 그림에는 이 상황을 설명하는 이름이 있다. 찬장(콜드 스테이션)이다. 샐러드, 소스, 작은 접시는 수셰프가 맛을 보고 셰프를 부르지 않고 내보낸다. 하나가 잘못되어도 손해는 한 접시뿐이기 때문이다. 반면, 뜨거운 조리대(핫 라인)는 절대 그렇게 작동하지 않는다. 그릴에서 나온 것은 아무리 수셰프가 잘해도 셰프의 확인 없이는 나가지 않는다. 여기서 실수하면 그날 저녁 전체가 망가지기 때문이다. 경로 목록이란 찬장에서 내보낼 수 있는 항목의 명단이고, 이 명단은 수셰프의 감이 아니라 벽에 적혀 있다.

주방저장소
콜드 스테이션의 역할: 셰프의 최종 확인 없이 내보낼 수 있는 메뉴 목록허용 경로: 문서, 계획, 테스트, 케이스 데이터, Markdown 및 명세 파일
그릴을 거친 것은 고명 하나라도 반드시 셰프의 확인을 거친다거부 경로(우선 적용): 워크플로, 스크립트, 애플리케이션 코드, 마이그레이션, 에이전트 가이드
수셰프는 반드시 직접 맛을 보고, 이상이 없으며, 셰프에게 물을 것이 없어야 한다3~5번 조건: AI가 'merge' 판정으로 실제 측정됨, 인용된 지적 사항 없음, 휴먼 전용 항목 없음
오늘은 패스가 닫혔다. 접시는 모두 준비됐지만, 누구도 내보낼 수 없다이 플랜에서는 브랜치 보호가 403을 반환한다. 즉, 엔벨로프는 분류만 하고 실제 병합 단계는 한 번도 실행된 적이 없다
Table titled THE SERIES SPINE · FOUR HORIZONS · WHAT EACH ONE SETTLED ABOUT GATES with columns HORIZON, LANDMARKS (VERIFIED), THE PRINCIPLE A 2026 GATE INHERITS. Rows: 300 years (1785 to 2009): Blanc's 50 locks, the 1821 Ordnance bore plugs one to pass the other not to enter, the 1896 Toyoda loom that stops itself, the 1924 Shewhart control-chart memo, the 1950 andon cord, 1956 Western Electric rules, the 2009 WHO checklist; principle: go or no-go, never looks fine, the machine halts itself, anyone may pull the cord, rules written so two people read the chart the same way. 30 years (1999 to 2023): Beck and Fowler daily integration, Bacchelli and Bird 2013, bors, McIntosh 2014, Micco 2017 84 percent flakes, Google 2018 24 lines under 4 hours, SLSA and sigstore 2021, merge queue 2023; principle: small, fast, always-green main, test the merge result, separate flake from fault, a green build is not provenance. 30 months (2024-03 to 2026-08): Devin, Copilot agent, Octoverse 518.7M PRs, GitHub 25M to 90M per month, Stripe 1,000 agent PRs per week, enterprise 2.09x with human review 89 to 68 percent, agent PRs merge 68 to 80 percent, mis-described PRs merge at 28 percent, kernel humans sign; principle: the bottleneck moved to judging, provenance is a trailer nobody checks, no one formalised a review SLA, the merge queue is next. 30 days (2026-08-09 to 09-09), boxed in black: 09-01 Copilot can approve, 09-02 Agent Merge, 08-12 CodeRabbit 143M, 09-07 policy census 83.3 permit 48.8 disclose 14.9 forbid; principle: the AI reaches the merge button, whether it may press it is a repository setting, so the setting is the design. Footer: every landmark is in the series dossier with a verification status.
시리즈의 구조는 1화와 같다. 이번 화는 두 번째 줄(bors와 머지 큐)과 마지막 줄(설정)에 해당한다.

구성 요소: 다섯 가지 조건, 두 개의 게이트, 그리고 문(door)의 상태

1. 엔벨로프는 데이터로 정의되며, 거부 규칙이 항상 우선한다

엔벨로프는 3화에서 다룬 규칙 파일에 별도 키로 저장된다. 허용 경로 접두사, 허용 접미사, 거부 접두사 목록이 있다. 허용 대상은 docs와 plan 디렉터리, case 라이브러리와 intake 폴더, agent-configuration 디렉터리, covenant 디렉터리, 백엔드/프론트엔드 테스트 트리, 그리고 접미사로 구분되는 모든 Markdown 또는 테스트 명세 파일이다. 거부 대상은 GitHub 설정 트리 전체(워크플로 포함), scripts 디렉터리, Makefile, 백엔드 애플리케이션 및 마이그레이션 트리, 의존성 매니페스트, 프론트엔드 소스, eval 러너, 두 개의 에이전트 가이드다. 체크 함수는 단순하다. 거부 접두사가 하나라도 일치하면 해당 파일은 무조건 외부로 간주한다. 아니면 허용 접두사나 접미사가 일치하면 내부로 본다. 그 외는 외부다. 거부 규칙이 항상 먼저 적용되며, 모델이 필요 없다. 외부 파일이 하나라도 있으면 PR 전체가 외부로 분류된다.

거부 목록이 허용 목록만큼 긴 이유, 그리고 scripts 디렉터리가 포함된 이유가 바로 이 시리즈의 핵심이다. 게이트 자체가 저장소에서 가장 영향력이 큰 코드이기 때문이다. 게이트가 바뀌면, 이후 모든 PR의 허용 범위가 달라진다. 오직 인간만이 이런 변경을 병합할 수 있다.

2. 다섯 가지 조건을 모두 동시에 확인하고, 모든 실패 원인을 나열한다

PR이 Tier-1으로 분류되어 봇이 승인하고 자동 병합을 열 수 있으려면, 다섯 가지 조건이 모두 충족되어야 한다. 모든 변경 파일이 엔벨로프 내부에 있어야 하고, 모든 머신 게이트가 그린이어야 하며, AI 리뷰가 실제로 실행되어 판정이 'merge'여야 한다. 요약에는 block 또는 warn 등급의 지적 사항이 없어야 하고, 휴먼 전용 질문 목록도 비어 있어야 한다(이때 모델이 목록이 빈 이유를 출력하거나, 이유가 없음을 명시한다). 분류기는 첫 실패에서 멈추지 않고, 모든 실패 원인을 반환한다. 요약에는 '충족되지 않은 조건'이라는 제목 아래 모두 나열된다. 이 작은 설계가 큰 효과를 낸다. "엔벨로프 외부, AI 미측정, 게이트 하나 레드"라는 메시지를 본 PR 작성자는 세 가지를 한 번에 고치지만, "엔벨로프 외부"만 본 작성자는 한 번에 하나씩 두 번 더 돌아온다.

다섯 조건이 모두 충족되면, 워크플로의 자체 계정이 PR을 승인하고, 저위험 변경임을 명시하며 코드 오너를 대신해 승인한다는 코멘트를 남긴다. 그리고 자동 병합을 연다(필수 체크가 모두 그린일 때 PR이 병합됨). 둘 중 하나라도 실패하면, 실패 메시지는 요약에 기록된다. 예를 들어 워크플로 승인 허용 설정, 자동 병합을 위한 플랜/보호 조건 등이 있다. 봇은 엔벨로프 외부에 대해서는 아무리 리뷰가 좋아도 승인하지 않는다. 전편에서 밝힌 이유는 여전히 유효하다. 승인 자체가 병합 조건이 되는 AI 리뷰어는 사람들이 그 조건을 최적화하게 만든다 [12].

3. 엔벨로프가 의존하는 두 개의 게이트: 작성자와 변경 규모

플러드 명세에서 온 두 개의 게이트가 엔벨로프 아래에 있다. 출처(provenance) 게이트는 세 부분으로 구성된다. 커밋 트레일러에 에이전트 마커가 있으면 반드시 추적 마커, 세션 링크, 또는 assisted-by 라인이 함께 있어야 하며, 이를 통해 에이전트의 작업을 다시 찾을 수 있다. 커밋이 에이전트 보조를 받은 PR은 본문에 검증(verification) 섹션이 있어야 하고, 증거가 붙어 있어야 한다. 2화에서처럼, 본문이 없는 푸시 이벤트는 실패가 아니라 '미측정'이다. 그리고 커밋에 봇 이름으로 된 sign-off가 있으면 안 된다. 이는 커널의 규칙을 기계적으로 구현한 것으로, sign-off는 인간의 법적 행위이며, 봇 주소가 들어간 트레일러는 레드다.

사이즈 게이트는 3화에서 정의한 임계값 파일을 읽는다. 400 유효 라인에서 경고, 3,000 라인 또는 60 파일에서 차단, 에이전트 보조 PR은 1,500에서 차단한다. 에이전트의 하한선은 에이전트 자체에 대한 판단이 아니다. 리뷰어에 대한 판단이다. 30개월 기록에 따르면 병합되지 않는 에이전트 PR은 대체로 대형 PR이었다 [13], 그리고 인간에게 1,500줄의 에이전트 작성 코드를 리뷰하라는 것은 2006년 리뷰 데이터(200~400줄 윈도우)에서 불가능하다고 한 바로 그 일을 시키는 것이다 [14].

Diagram titled ONLY IN THE ENVELOPE · FIVE CONDITIONS, ALL AT ONCE · THE FIRST ONE NEEDS NO MODEL. Five cards: 1 PATH ENVELOPE in black, every changed file inside, allow docs, plan, tests, case data, Markdown and spec files, deny workflows, scripts, app, migrations, guides, deny wins, no model. 2 MACHINE GATES, all green, tenant, secrets, migration, foreign keys, bilingual, size, provenance, tests, cases, self-test contract. 3 AI MEASURED, brief posted with verdict merge, unmeasured fails this condition and never passes it, episode 2. 4 NO BLOCK OR WARN, zero cited findings, every finding carries file and line or is dropped, precursor article. 5 NO HUMAN ITEMS, the H1 to H6 list is empty and the brief prints the reason, or says none was given, episode 3 rules as data. A black bar: ALL FIVE means github-actions approves plus auto-merge on green checks; ANY ONE FAILS means the label needs-human and the brief lists every failed condition, not the first. A dashed box, THE PROOF ON A REAL PR 2026-09-09: PR 46, docs-only, condition 1 passed, exactly one condition failed, AI review unmeasured, the key is rejected with 401; even with a valid key the merge step cannot run, branch protection returns 403 on this plan, the audit keeps Tier-1 has merged once unmeasured. A lineage strip: 2013 bors, merge into a branch, test the result, then land it, the merge result is what gets tested not the PR; 2023 merge queue GA, never broken by incompatible changes, the queue is the narrow pipe after approved; kernel Signed-off-by, AI agents MUST NOT add Signed-off-by tags, provenance gate P6c, a bot sign-off is red; 2026-09-01 Copilot approves in black, can count toward required approvals, off by default, the setting is the design, ours never for app code. Footer: every quotation and date is in the ANDON dossier with its source; the envelope lists are read from the rules file on 2026-09-09.
다섯 조건, 하나의 기준선, 하나의 증거, 그리고 엔벨로프가 계승한 계보.

증거, 그리고 아직 닫혀 있는 문

2026-09-09, 엔벨로프는 자신을 위해 설계된 PR 유형, 즉 문서 전용 변경에서 실제로 시험됐다. 빌더 루프 결정 기록: docs 디렉터리 아래 두 개, README 쌍과 changelog를 포함한 다섯 개의 Markdown 파일이 모두 접두사 또는 접미사로 엔벨로프 내부에 해당했다. 해당 PR의 요약에는 정확히 한 가지 미충족 조건, "AI review unmeasured"가 기록됐다. 경로 엔벨로프는 통과했고, 게이트는 모두 그린이었으며, AI는 저장소 키가 401로 거부되어 실행되지 않았다. 이것이 올바른 결과이며, 조건 1이 실제 diff에서 동작함과 분류기가 남은 실패를 일반적인 "needs human" 대신 구체적으로 보고함을 보여주는 첫 실증적 증거다.

이 발견의 솔직한 절반은, 유효한 키가 있었다면 무슨 일이 일어났을지다. 아무 일도 없다. 저장소는 비공개이고, 브랜치 보호 엔드포인트는 "Upgrade to GitHub Pro or make this repository public"라는 문구와 함께 403을 반환한다. 자동 병합 설정은 false로 읽히고, 승인 및 병합 단계는 한 번도 실행된 적이 없다. 작성일 기준, 이 저장소가 사용하는 토큰에서 소유자의 플랜은 Pro로 읽히지 않는다. 이 시리즈는 결제 페이지가 바뀌었다고 동작하는 것처럼 서술하지 않는다. 2화의 루프 감사에는 "Tier-1이 엔벨로프 내부에서 한 번 병합됨"이라는 기준이 있고, "AI가 PR을 측정함"과 함께 여전히 '미측정'으로 남아 있다. 둘 다 증거가 있을 때만 그린으로 바뀐다. 브랜치 보호를 적용하는 스크립트는 업그레이드 URL과 함께 닫힌 상태로 실패하므로, 플랜이 저장소에 적용되는 날 명령 한 번으로 문이 설치된다.

다섯 번의 '왜': 왜 이 경계선은 신뢰도 점수가 아니라 경로 목록이어야 하는가

#왜 그런가?이유근거
1AI가 충분히 자신 있다고 판단하면 모든 변경을 병합해도 되는가?신뢰도(confidence)는 리뷰가 맞을 확률만 말해 준다. 하지만 병합 결정에는 그 판단이 틀렸을 때 무슨 일이 벌어지는지가 필요하다. 이 둘은 전혀 다른 값이다.GitHub의 공식 규칙: "An approval assessment alone does not count toward merge requirements."(번역: 승인 평가만으로는 병합 요건을 충족하지 않는다)1]
2‘틀렸을 때 무슨 일이 일어나는가’가 왜 경로의 속성인가?저장소에서 잘못된 병합의 피해는 변경이 닿는 범위에 따라 달라진다. 문서가 틀리면 고치면 되지만, 마이그레이션이 틀리면 데이터가 날아가고, 게이트가 틀리면 앞으로 들어올 모든 PR이 영향을 받는다.거부 목록에는 게이트 자체가 들어 있다. 게이트가 바뀌면 이후 모든 PR의 허용 범위가 바뀐다.
3왜 거부가 허용보다 먼저 적용되어야 하는가?PR은 하나의 덩어리로 들어간다. 위험한 파일이 하나라도 포함되면 전체가 위험해진다. 거부를 먼저 적용하면 허용 목록을 넓게 잡아도 안전하다.이 경계선 함수는 허용 접두사·접미사보다 거부 접두사를 먼저 검사한다.
4왜 경계선 하나만이 아니라 다섯 가지 조건이 모두 필요한가?경계선은 잘못된 병합의 피해 범위를 제한하고, 나머지 네 조건은 그 확률을 낮춘다. bors가 '초록불 PR'과 '초록불 main'이 다르다는 걸 보여줬고, 2화는 '실행 불가'와 '문제 없음'이 다르다는 걸 증명했다.[5, 6]; 조건 3은 "unmeasured"에서 실패한다
5왜 문이 열릴 때까지 기다리지 않고 403을 바로 공개하는가?이 시리즈는 실증을 부풀리지 않는다. 경계선의 분류 결과는 증거이고, 병합 단계는 아직 아니다. Shewhart의 "within limits" 원칙은 부품뿐 아니라 주장에도 적용된다.15].루프 감사표의 P6 행은 UNMEASURED이고, 도시는 그날의 403과 auto-merge 거짓 플래그를 기록한다.

핵심은 이 한 줄이다.병합 버튼의 안전성은 그 버튼이 닿을 수 있는 범위에 달려 있다. 그 범위는 읽고, diff하고, 거부할 수 있는 경로 목록이어야 한다. 확률 수치는 그 역할을 대신할 수 없다.

30분 설계서: 경계선 계약

30분은 이 계약을 베끼는 독자를 위한 시간 예산일 뿐, 내가 실제로 쟀던 시간은 아니다. 경계선과 분류기는 오후 한나절, 출처 게이트는 오전, 증거는 이미 있던 PR이었다.

구성 요소명세
엔벨로프 규칙규칙 파일 내에 정의한다.allow_prefixes, allow_suffixes, deny_prefixes거부(deny) 규칙을 먼저 적용한다. 게이트, 워크플로, 애플리케이션 코드, 마이그레이션, 의존성 명세, 에이전트 가이드 등은 모두 거부 대상이다. 변경 파일 중 하나라도 이 목록에 해당하면, 그 PR 전체가 엔벨로프 바깥으로 간주된다.
다섯 가지 조건엔벨로프 내부에 모든 파일이 포함되어 있을 것 ∧ 모든 머신 게이트가 통과(초록불)일 것 ∧ AI 리뷰가 실제로 실행되어 판정이 "merge"일 것 ∧ 차단 또는 경고 수준의 발견 사항이 0건일 것 ∧ 인간만 답할 항목이 0건일 것(이때 브리프에는 빈 목록의 사유, 즉 모델이 제시한 이유나 미제공 시 해당 사실을 명시한다). 분류기는 실패한 모든 조건을 한 번에 반환한다.
동작다섯 조건이 모두 충족되면, 워크플로의 계정이 규칙명을 명시한 코멘트와 함께 PR을 승인하고 자동 병합을 연다. 만약 이 과정에서 실패가 발생하면, 필요한 설정이나 플랜 정보를 브리프에 남긴다.
기원(프로비넌스) 게이트에이전트 마커가 있으면 트레이스 마커도 필수다. 에이전트 보조 PR은 본문에 검증 섹션이 반드시 있어야 하며(본문이 없으면 '미측정' 처리), 커밋에 봇 사인오프가 있으면 무조건 불합격(레드)이다.
크기(사이즈) 게이트임계값 파일 기준: 400줄 이상은 경고, 3,000줄 또는 60파일 이상은 차단, 에이전트 보조 PR은 1,500줄에서 차단한다. 유효 라인 수는 생성 파일을 제외한다.
문(도어) 상태브랜치 보호와 자동 병합 설정은 API에서 그대로 읽어 감사에 기록한다. 플랜이 활성화되기 전까지 보호 스크립트는 업그레이드 URL과 함께 닫힌 상태로 실패한다.
일부러 넣지 않은 항목신뢰도 임계값 없음, "AI가 N명의 리뷰어와 함께 애플리케이션 코드를 승인할 수 있다" 같은 예외 없음, 바이패스 리스트 없음. 이런 항목들은 모두 '핫라인'이 셰프(사람) 없이 나가는 길을 열어주는 방식이기 때문이다.
# The envelope is one function; deny first, no model.
def in_envelope(path, env):
    if any(path.startswith(d) for d in env["deny_prefixes"]):  return False
    return any(path.startswith(a) for a in env["allow_prefixes"]) or \
           any(path.endswith(s)   for s in env["allow_suffixes"])

# Tier-1 is a conjunction; every failed condition is returned, not the first.
def classify_tier(brief, env):
    reasons = []
    if any(not in_envelope(f, env) for f in brief.files): reasons.append("outside the envelope")
    if any(not g.ok for g in brief.gates):                 reasons.append("a machine gate is red")
    if not brief.measured:                                 reasons.append("AI review unmeasured")
    else:
        if brief.review.needs_human:                       reasons.append("human-only items present")
        if brief.review.hot_findings:                      reasons.append("block/warn findings present")
        if brief.review.verdict != "merge":                reasons.append("AI verdict is not merge")
    return ("auto" if not reasons else "human"), reasons

다섯 가지 관점에서 본 같은 원리

독자핵심 결정 하나핵심 행동 하나
학생"충분히 좋다"와 "충분히 안전하다"는 서로 다른 질문이다.스스로 의존하는 자동화 동작을 하나 골라, 어디까지 허용할지 경로 목록으로 적어보라.
엔지니어거부 조건을 먼저 따지고, 그다음 허용한다. 다섯 가지 조건을 모두 확인하고, 실패한 항목은 빠짐없이 보여준다.경로 목록 기반의 엔벨로프를 규칙 파일에 추가하고, 봇의 승인 단계가 모델을 읽기 전에 반드시 이 엔벨로프부터 확인하도록 만들어라.
창업자라면이제 병목은 리뷰어가 아니라 병합 대기열이다.이번 주 안에, 봇이 인간의 개입 없이 변경을 반영할 수 있는 디렉터리를 직접 정하고, 각 항목 옆에 그 이유를 명확히 적어두라.
임원이라면설정이 곧 설계다.조직에서 누가 AI 승인 설정을 바꿀 수 있는지, 그리고 그 설정이 바뀌면 어떤 경로 목록이 실제로 적용되는지 반드시 확인하라.
투자자라면자기 저장소의 403 오류를 스스로 공개하는 팀은, 수치도 투명하게 공개한다.팀에게 자동 병합이 거부된 PR을 직접 보여 달라고 요청하고, 그 이유까지 물어보라.

패턴, 안티패턴, 그리고 첫 번째 원칙

유효했던 패턴들. 데이터로 관리되는 엔벨로프, 거부 조건 우선. 모든 조건을 논리곱으로 평가하고, 실패한 조건을 모두 반환. 규칙명을 명시한 워크플로우 계정의 승인 코멘트. 출처 검증은 세 가지 기계적 체크로 분리. 근거가 명확한 파일에서 읽는 크기 제한. 문(door)의 상태는 API에서 읽어, 한 번이라도 열리기 전까지는 미측정으로 기록한다.

이 패턴들이 대체한 안티패턴. "AI가 자신 있으면 승인한다"는 식의 기준. 첫 실패 조건에서 멈추는 봇. 아무도 확인하지 않는 에이전트 트레일러. 봇 주소가 들어간 서명. 플랜만 구매하면 자동 병합이 된다고 적힌 릴리스 노트.

이 메커니즘의 핵심. 엔벨로프는 잘못된 병합의 피해 범위를 제한하고, 나머지 네 조건은 그 확률을 낮춘다. 두 값을 곱한 것이 위험(risk)이고, 이 중 피해 범위만이 저장소가 직접 통제할 수 있으므로, 그 부분만 경로 목록으로 명시한다.

첫 번째 원칙을 한 문장으로. 기계가 실수해도 바로 되돌릴 수 있는 영역에서만 자동화가 작동하게 하고, '되돌리기 쉬움'을 감각이 아니라 경로 목록으로 명확히 써라.

현실 적용 과제

3화에서 예고한 대로, 4화에서는 실제 문서 전용 PR로 엔벨로프를 테스트했고, 브랜치 보호 상태도 있는 그대로 공개했다. 두 가지 모두 완료: 문서 전용 PR은 엔벨로프를 통과했으나 한 조건에서 실패했고, 문(door)은 403 상태다. 5화까지 저장소의 모든 게이트가 셀프테스트로 직접 빨간불을 낼 수 있음이 입증될 것이다. 전편의 네거티브 테스트 PR은 리뷰어의 첫 측정된 발견을 남겼거나, 아직 키를 기다리고 있을 것이며, 본문에서 어느 쪽인지 밝힐 예정이다.

이어 읽을 거리

4화 ANDON · 에이전트형 PR 리뷰와 CI/CD. 모든 수치는 해당 맥락에서만 유효하다. 주방 은유는 실제 계량이 아니라 구조를 설명하는 모델이다. 엔벨로프, 분류기, 두 개의 게이트, 그리고 403은 모두 비공개 저장소에 구현되어 있으며, 그 구조는 계약서에 재현되어 있으니 접근 권한이 없어도 따라 할 수 있다. 이번 화에서 인용한 4-지평선 도시는 포트폴리오의 plans 디렉터리에 기록되어 있다.

참고 문헌

  1. GitHub 변경 로그, Copilot 코드 리뷰가 이제 풀 리퀘스트 승인을 할 수 있음, 2026-09-01. github.blog
  2. GitHub 변경 로그, 2026-08-31 주간 릴리스, 2026-09-04 게시.github.blog
  3. Stripe, Minions, 2026-02-09. stripe.dev
  4. Mergify, 2026년 머지 큐 현황, 2026-07-27. mergify.com
  5. Wilson, Rust 인프라스트럭처를 당신의 인프라로, 2015-03-17. huonw.github.io
  6. GitHub, 풀 리퀘스트 병합 대기열, 공식 출시, 2023-07-12. github.blog
  7. Chromium, 커밋 큐 문서.chromium.googlesource.com
  8. Pan, 이제 병목은 머지 큐다, 2026-07-02. tianpan.co
  9. 리눅스 커널 문서, AI 코딩 어시스턴트 활용 지침. docs.kernel.org
  10. Apache Software Foundation, 생성형 도구 활용 가이드. apache.org
  11. Hora, Robbes, Zacchiroli, "우리는 AI 사용을 허용하지만 […]", arXiv:2609.07542, 2026-09-07. arxiv.org
  12. Paul Jialiang Wu, 거짓말할 수 없는 AI PR 리뷰, 2026-09-08. futuremake.io
  13. Ehsani 외, AI 코딩 에이전트의 실패 지점, arXiv:2601.15195, 2026-01-21. arxiv.org
  14. SmartBear, 동료 코드 리뷰 모범 사례 (Cisco 연구, 2006). smartbear.com (공급업체 자료; Rigby와 Bird가 관심을 표함)
  15. Shewhart, 제조품 품질의 경제적 관리, Van Nostrand, 1931 (archive.org 스캔). archive.org