From 402fe122318d8f84f848b0836e74b0ebf70352c2 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Thu, 5 Nov 2026 22:15:44 +0900 Subject: [PATCH] =?UTF-8?q?docs(improvement):=20=EA=B2=80=EC=A6=9D=20?= =?UTF-8?q?=EC=9C=84=EC=B9=98=C2=B7merge=20=ED=8C=90=EC=A0=95=20=EB=B0=A9?= =?UTF-8?q?=EB=B2=95=EA=B3=BC=20=EA=B2=B0=EC=A0=95=20=EC=83=89=EC=9D=B8?= =?UTF-8?q?=EC=9D=84=20=EC=A0=81=EB=8A=94=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: "merge 가능" 판정을 고른 스크립트 목록이나 CI=true 없는 env로 해서 실제 러너에서 항상 실패하는 게이트를 놓친 적이 있다. 테스트를 어디서 돌리는지(desktop, 잠금, 되돌림)는 사용자 지시로만 있다. 소유자 결정이 리뷰 README·SPEC.md·ADR·세션 기록에 흩어져 다시 묻게 된다. 고른 방법: 07장에 때별로 돌릴 것, ci:gate로 merge 단계 14개를 workflow env로 돌리는 방법, 가끔 떨어지는 게이트의 기록법, desktop의 FE-GATE-013 처리, CI env에서만 나는 실패, PASS 뒤 실패, 문서 검사의 범위와 도는 곳, 소유자 환경을 적는다. 08장에 결정을 적는 곳, 다시 묻지 않는 규칙, 작업 방식 결정 O-1~O-14와 기술 결정 묶음의 색인, 결정 대기 형식과 지금 열린 D1~D6, 커밋·PR에서 이 repo가 덧붙이는 것을 적는다. 결정 원문은 옮기지 않는다. 위험·한계: 열린 결정 표는 4라운드 시점이다. 다음 라운드가 닫으면 고쳐야 한다. CLAUDE.md 27줄의 리뷰 게이트 목록이 merge 단계와 다르다는 발견(1105/12-03)은 고치지 않고 07장이 merge 단계를 함께 돌리라고만 적는다. 검증: 로컬 정적 대조. desktop 검사는 연결 커밋 뒤. --- docs/improvement/07-verification-gates.md | 177 ++++++++++++++++++++++ docs/improvement/08-decisions-records.md | 123 +++++++++++++++ 2 files changed, 300 insertions(+) create mode 100644 docs/improvement/07-verification-gates.md create mode 100644 docs/improvement/08-decisions-records.md diff --git a/docs/improvement/07-verification-gates.md b/docs/improvement/07-verification-gates.md new file mode 100644 index 00000000..0e2ed20a --- /dev/null +++ b/docs/improvement/07-verification-gates.md @@ -0,0 +1,177 @@ +# 07. 검증과 게이트 + +## 핵심 + +무엇을 돌릴지는 **언제인지**로 정한다. 작업 중에는 바뀐 테스트 파일만, 커밋 전에는 빠른 게이트 8개, 통합 때는 +5개를 더, merge 가능을 말할 때는 merge 단계 14개를 CI와 같은 env로 돌린다. + +```text +작업 중 바뀐 테스트 파일 하나 (1절) +커밋 전 빠른 게이트 8개 (2절, SPEC.md 31줄) +레인 끝·통합 + 5개 (2절, SPEC.md 32줄) +merge 판정 ci:gate로 merge 단계 14개, workflow env (3절) +리뷰 시작 CLAUDE.md 목록 11개 + merge 단계 14개 (3절) +``` + +게이트 ID·단계·명령의 정본은 `config/ci/gates.json`이다. 이 장은 그 목록을 다시 적지 않는다. + +## 1. 명령 규칙 + +- 패키지 스크립트는 `corepack pnpm