docs(review): 2026-11-03 리뷰 조치 결과와 merge 단계 검증을 기록한다

문제
리뷰 README에 조치 결과가 없다. 사용자가 "나머지 전부 진행하세요"라고
했고, 이 세션이 발견 90건과 0929/03-03을 고치고 통합했다.

고른 방법
- 13절에 조치 중 찾은 발견 둘(11-07 CI 빌드 식별값 누출, 16-09 dev
  manifest 고정 contract set)을 36.3 양식으로 더하고 색인을 92건으로 고친다.
- 14절을 새로 둔다: 방법(수정 브랜치 11개, wave 1~3), 결정 D1~D6, 통합에서
  생긴 것, 발견별 상태(일부 9건과 결정 대기 3건), 깨끗한 clone의 merge 단계
  14개 회차별 결과(X4), 매뉴얼 재실험 막힘 7건과 처리(X2), 남은 문제.

위험·한계
- X2(매뉴얼만 보는 재실험)는 고친 뒤 다시 돌리지 않았다. 고친 것은 생성
  기능을 넣은 clone 확인과 X4로 확인했다.
- 실제 Gitea 러너, 짝 백엔드·nginx·Keycloak·Redis 연동은 확인하지 않았다.

검증
- 최종 커밋 799ab7f, 깨끗한 clone, CI env: FE-GATE-001~013·020 통과
  (FE-GATE-008은 첫 실행 Firefox 다운로드 시간 초과 1건, 재실행 2회 통과).
- verify:documentation PASS_SCOPED.

Refs: docs/reviews/2026-11-03-maturity-review/README.md 13절 14절
This commit is contained in:
DongHyeonka
2026-11-05 04:08:56 +09:00
parent 6ee20eff89
commit c7c7887937
@@ -280,7 +280,7 @@
## 12. 발견 색인
영역 문서에 36.3 양식으로 적힌 발견은 96건이다. 같은 결함 8건을 대표 항목에 합쳤다(10.3절). 리뷰 뒤 오케스트레이터가 2건(11-06, 12-09, 13절)을 더해 색인은 90건이다: High 2 · Medium 36 · Low 52, P1 14 · P2 38 · P3 38, 확인된 결함 57 · 구조적 위험 23 · 개선 제안 10. 각 영역 문서 2절의 "지난 발견 재확인" 표에만 있는 이월 항목(0929/03-03 등)은 여기 세지 않았다. 2절 차단 항목에는 포함했다. 심각도 조정은 2.3절이다.
영역 문서에 36.3 양식으로 적힌 발견은 96건이다. 같은 결함 8건을 대표 항목에 합쳤다(10.3절). 리뷰 뒤 오케스트레이터가 4건(11-06, 12-09, 11-07, 16-09, 13절)을 더해 색인은 92건이다: High 2 · Medium 38 · Low 52, P1 16 · P2 38 · P3 38, 확인된 결함 59 · 구조적 위험 23 · 개선 제안 10. 조치 상태는 14.4절이다. 각 영역 문서 2절의 "지난 발견 재확인" 표에만 있는 이월 항목(0929/03-03 등)은 여기 세지 않았다. 2절 차단 항목에는 포함했다. 심각도 조정은 2.3절이다.
| ID | 심각도·우선순위 | 성격 | 내용 | 관련 관점 | 합친 것·조정 |
|---|---|---|---|---|---|
@@ -291,6 +291,8 @@
| [09-03](09-app-core.md) | Medium·P1 | 구조적 위험 | 짝 백엔드의 인증 방식에 맞는 세션 owner가 없어, 제품마다 첫 연동 전에 owner를 처음부터 써야 한다 | 3, 15, 20, 22, 25, 13 | |
| [11-02](11-tests-browser-release-scale.md) | Medium·P1 | 확인된 결함 | CI merge job이 시각 테스트 글꼴 패키지를 설치하지 않아, 빈 러너에서는 FE-GATE-008이 코드와 무관하게 `visual-fonts` 단계에서 실패한다 (1101/11-02 남은 절반) | 21, 10, 19, 20, 16, 5 | |
| [11-06](#13-리뷰-뒤-추가-발견-2026-11-04) | Medium·P1 | 확인된 결함 | compact smoke e2e가 build id를 고정해 실제 CI 값에서 FE-GATE-008이 항상 실패한다 | 21, 10, 18, 19 | 13절(리뷰 뒤 추가) |
| [11-07](#13-리뷰-뒤-추가-발견-2026-11-04) | Medium·P1 | 확인된 결함 | CI의 빌드 식별값이 vitest와 dev server로 새어 FE-GATE-005·006·007·008·020이 실제 CI에서 항상 실패한다 | 21, 10, 18, 19 | 13절(조치 중 X4에서 찾음) |
| [16-09](#13-리뷰-뒤-추가-발견-2026-11-04) | Medium·P1 | 확인된 결함 | dev server가 고정된 contract set을 내주어 기능 추가 직후 `pnpm dev`가 부팅하지 못한다 | 20, 3, 21, 10 | 13절(조치 중 X2에서 찾음) |
| [12-01](12-guardrails-ci.md) | Medium·P1 | 확인된 결함 | `create:feature`로 기능 하나를 더하면 merge 게이트 `test:visual`이 실패하고, 통과시키려면 템플릿 소유 골든 PNG 3장을 다시 찍어야 한다 | 10, 25, 3, 21, 20, 26 | 조정 High·P1 → Medium·P1 |
| [12-09](#13-리뷰-뒤-추가-발견-2026-11-04) | Medium·P1 | 확인된 결함 | coverage 증거 검사가 istanbul summary의 `branchesTrue`를 거절해 FE-GATE-005가 항상 실패한다 | 21, 10, 16, 23 | 13절(리뷰 뒤 추가) |
| [13-01](13-build-release-supply-chain.md) | Medium·P1 | 확인된 결함 | FE-GATE-019가 run 이름만 대조하고 `config.json` 내용과 슬롯의 후보 사용을 보지 않아, 같은 run에서 다시 빌드한 release를 통과시킨다 | 18, 21, 15, 19, 5, 28 | |
@@ -414,3 +416,148 @@
| 완료 기준 | `ci:gate FE-GATE-005`가 통과한다. `branchesTrue`가 있는 summary와 없는 summary를 모두 받는 validator 테스트가 있다 |
| 검증 방법 | validator 단위 테스트 + 깨끗한 복제본에서 `ci:gate FE-GATE-005` |
| 담당·기한·상태 | 미정 · 미정 · 신규 |
### 11-07 CI가 workflow 전체에 주는 빌드 식별값이 vitest와 dev server로 새어, merge 게이트 다섯 개가 실제 CI에서 항상 실패한다
조치 단계의 깨끗한 clone 검증(14.4절 X4)에서 찾았다. 11-06과 같은 원인이고, 11-06이 고쳐지자 FE-GATE-008 안에서 가려져 있던 실패가 드러났다.
| 필드 | 내용 |
|---|---|
| 성격 | 확인된 결함 |
| 관련 관점 | 21, 10, 18, 19 |
| 근거 | `.gitea/workflows/quality-gates.yml:28-29`는 workflow 전체 env에 `VITE_BUILD_ID: gitea-<run>-<attempt>`와 `VITE_COMMIT_SHA`를 넣는다. Vite는 이 값을 `import.meta.env`로 번들에 넣는다(`src/contracts/env.ts` `getBuildConfig`). ① vitest: 앱을 local-build fixture release로 조립하는 테스트(`runtime-application`, `boot-unexpected-failure`, `runtime-composition-service-worker-telemetry`, `reference-production-vertical`, 생성 기능 페이지 테스트)가 `CONFIG_BUILD_MISMATCH`로 실패한다. ② capability e2e: dev server(`pnpm dev`)는 `public/config.json`(BUILD_ID `local-build`)을 내주는데 번들은 CI 값이라, 페이지마다 rolling-release 불일치로 한 번 다시 불러온다(`src/bootstrap/boot.tsx` reload-once). `page.evaluate`가 "Execution context was destroyed"로 30건 실패한다. 오케스트레이터 실행(깨끗한 clone `f887817`, CI env): FE-GATE-005·006·007·008·020 실패. 같은 테스트는 env 없이 모두 통과한다 |
| 발생 조건 | Gitea Actions, 또는 같은 env를 주는 러너에서 merge job을 돌릴 때마다 |
| 영향 | merge 게이트 다섯 개가 코드와 무관하게 빨갛다. CI가 꺼져 있어(1101 U-1) 지금까지 드러나지 않았다 |
| 심각도·우선순위 | Medium · P1 — 02-06과 같은 기준이다(2.3절) |
| 통제·증거 | 목표 M3 / 확인 M0 · E3(오케스트레이터 재현, 수정 전후 대조) |
| 최소 개선 방향 | 테스트와 dev server가 로컬 빌드 식별값으로 시작한다 |
| 완료 기준 | CI env로 깨끗한 clone에서 merge 단계 14개가 통과한다 |
| 담당·기한·상태 | 오케스트레이터 · 2026-11-05 · 고침(`af312de`) |
### 16-09 dev server가 고정된 contract set을 내주어, `create:feature`로 기능을 더한 직후 `pnpm dev`가 부팅하지 못한다
조치 단계의 매뉴얼 재실험(14.6절 X2 #3)에서 찾았다.
| 필드 | 내용 |
|---|---|
| 성격 | 확인된 결함 |
| 관련 관점 | 20, 3, 21, 10 |
| 근거 | dev server는 커밋된 `public/release-manifest.json`을 내주고, 그 `contractSet.packages`는 빈 목록이다. 부팅은 그 집합을 설치된 기능 선언(`EXPECTED_CONTRACT_SET_PACKAGES`)과 대조한다(`src/bootstrap/load-release-manifest.ts:296-305`). 생성 기능은 계약 패키지를 선언하므로 `CONTRACT_SET_PACKAGE_MISSING`이다. 옵션 없는 `create:feature` 하나로도 생긴다(재실험 E3) |
| 영향 | 기능을 더한 제품은 로컬 dev server와 dev server를 쓰는 capability e2e(FE-GATE-008)가 실패한다. 매뉴얼은 그 파일을 말하지 않는다 |
| 심각도·우선순위 | Medium · P1 |
| 담당·기한·상태 | 오케스트레이터 · 2026-11-05 · 고침(`799ab7f`) |
## 14. 조치 (2026-11-04~05)
사용자 지시 "나머지 전부 진행하세요"에 따라 이 리뷰의 발견을 고쳤다. 리뷰를 맡긴 세션과 수정을 겹치지 않게 정했다. 이 세션이 수정·통합·문서를 맡았고, push·PR 본문·최종 Slack 브리핑은 그 세션이 맡는다.
### 14.1 방법
- 통합 브랜치 `fix/maturity-review-2026-11-03`(기준 `004a205`). 영역별 수정 에이전트 10개가 각자 격리 worktree의 `fix/r1103-<이름>` 브랜치에서 RED 테스트부터 고치고 커밋했다(wave 1). 생성기 에이전트 1개는 wave 1의 HTTP·계약 수정이 합쳐진 `5379c80`에서 시작했다(wave 2). CHANGELOG·문서 에이전트 1개가 마지막에 미출시 절을 다시 썼다(wave 3).
- 오케스트레이터가 각 브랜치를 `--no-ff`로 합치고, 합칠 때마다 빠른 게이트를 돌렸다. 충돌과 합친 뒤에만 생긴 실패는 14.3절에 있다.
- 공통 지시: RED 먼저, 논리적 변경 하나에 커밋 하나, 커밋 규칙(`design-docs/conventions/commit-and-pr.md`), AI 꼬리말 금지, `corepack pnpm`, 무거운 실행은 공유 잠금. 합친 커밋의 AI 꼬리말은 0건이다(브랜치마다 확인).
### 14.2 결정 (6절)
| 번호 | 고른 것 | 이유 |
|---|---|---|
| D1 | (다) 프론트 문서에 "짝 아님"을 적고, (나-1) 프론트에 Fileserver multipart 한 번 업로드 client를 둔다(`src/adapters/http/fileserver-upload.ts`) | 01 영역 판단. 백엔드 repo는 이 작업에서 읽기만 했다. (가)는 백엔드 소유자의 제거 결정을 뒤집는다 |
| D2 | ① operation 단위 `commandEffect.refusedBeforeWrite` code 목록 | 가장 좁다. 함수가 아니라 code 목록이라 리뷰할 수 있다. ②는 두 repo 계약 변경이라 남겼다 |
| D3 | (a) 기능 링크·목록 영역을 숨기고 찍는다 | 수 줄이고 기능 수와 무관하다 |
| D4 | (b) 설치된 descriptor로 응답 모양을 정하고 경고 상자가 없다고 단언한다 | 응답 모양을 operation 단위로 정한 1101 결정과 같은 단위다 |
| D5 | (b) 동기화 단위 순 변경 요약 | 두 다운스트림이 범위 단위로 동기화한다 |
| D6 | (1) pin 파일 + (2) 답 표 JSON 대조 테스트 + 로컬 drift 검사 | 지금 규모에는 작고, 리뷰 중 실제로 일어난 어긋남(10.6절)을 잡는다 |
### 14.3 통합에서 생긴 것
| 커밋 | 내용 |
|---|---|
| `9b9d62a`, `b9524cf` | 세션·저장소 브랜치의 새 테스트가 `RuntimeConfig`를 글자 그대로 적어, 앱 브랜치(09-02)의 제품 확장 타입 검사가 실패했다. `testRuntimeConfig`로 바꿨다 |
| `3fba68b` | 계약 브랜치가 아직 없던 `refusedBeforeWrite`를 구조 캐스트로 읽었다. 타입으로 읽고, Envelope가 아닌 operation에 그 칸을 적은 테스트를 고쳤다 |
| `20a5b08` | HTTP 브랜치(08-05)가 필드 목록 없는 422를 입력 오류가 아닌 것으로 바꾸자, 업로드 client의 Fileserver 422(파일 거절)가 입력 오류가 아니게 됐다. 파일 거절은 입력 거절로 두고 키 재사용 불일치만 공통 판정을 따르게 했다 |
| `5379c80`, `580be58` | 백엔드가 작업 중 `bbe944bd` → `c508b1ba` → `45d2a478`로 움직였다. drift 검사가 알린 §2 변경(회복 필요 응답 안내, 처리 중·시작 거절 설명)은 프론트 판정을 바꾸지 않는다. pin을 `45d2a478`로 올리고 6.1절 인용 블록 13개를 두 판에서 대조했다 |
| `ac52a93`, `0fb78ff` | 14-03(VD-23·VD-24·원장의 V2 `COMPOSED`, 401 문장, 6.1절 현재 계약 표시), 14-05 ② |
| 짝 저장소 테스트 2건 | 게이트 브랜치(12-05)의 테스트가 다른 문서가 짝 백엔드 경로를 적지 않는다고 가정했다. 고친 문서만 보게 했다 |
| `1b8cb12`, `f887817` | 15-01이 떨어뜨린 초기 파일 하나(198 B)로 파일 상한 25를 26으로 올렸다. 초기 JS 기준선을 합친 빌드로 다시 적었다(202,927 B / 204,800, 26개, 기능 +768 B, context +233 B) |
| `af312de`, `2f2426a` | 깨끗한 clone 검증에서 찾은 11-07과, `ac52a93`이 1절에 올린 계약 문서의 참조 기능 경로가 제거 fixture에서 실패하던 것(14-04 규칙) |
| `f92cfd9`, `9bddfa5`, `2c2d459`, `5ca5340` | X4에서 찾은 것: storybook spec과 a11y 애드온 자동 검사 충돌, 시각 골든 build의 CI 식별값, 성능 문서의 샘플 경로, 샘플 ID 글자 두 곳 |
| `235143c`, `72c6e9d`, `2fef27d`, `72b8ab1`, `3d3d652`, `2e4595e`, `7f9a515`, `799ab7f` | X2에서 찾은 것(14.6절): 타입 검사 탐침 이름·덮어쓰기, 기능 제거·생성 드릴의 초기 JS 재기록, 파일 상한 32, 매뉴얼 문장, 업로드 client의 포트 import, 빌드 입력 목록, dev manifest 재작성 |
| `580be58` | pin을 `45d2a478`로 올렸다(§2 처리 중·시작 거절 설명 변경, 판정 같음) |
### 14.4 발견별 상태
고침 = 완료 기준까지 확인했다. 일부 = 일부만 고쳤고 남은 부분을 적었다. 결정 대기 = 사용자 또는 백엔드 소유자가 정해야 한다.
| ID | 상태 | 남은 것 |
|---|---|---|
| 01-01 (High) | 고침 | 실제 백엔드로 올려 보지 않았다. 백엔드 `POST /v1/files`는 `Idempotency-Key`를 읽지 않아 결과 불명 뒤 같은 키 재전송에도 파일이 둘 생길 수 있다(백엔드 결정) |
| 03-01 (= 08-01, High) | 고침 | 선언하지 않은 업무 code는 지금처럼 결과 불명이다 |
| 0929/03-03 (High) | 고침 | — |
| 02-06, 11-06, 12-09, 11-07, 16-09 | 고침 | CI 러너에서는 돌리지 않았다(14.5절은 깨끗한 clone + CI env) |
| 12-01, 15-01, 11-01(= 12-03), 16-03, 11-02 | 고침 | 16-03: 상세 라우트는 실패 상태로 검사하고 annotation만 남긴다 |
| 13-01, 13-02, 13-05, 12-07, 15-02~15-07 | 고침 | 실제 nginx·러너 미실행. HTTP/1.1·비압축 호스트는 이제 FE-GATE-019 FAIL(동작 변화) |
| 13-03 | 일부 | **결정 대기**: 운영 high advisory 2건(zod GHSA-mrhx, react-router GHSA-qwww). zod 4.6.x는 초기 JS를 약 7 KB 늘려 예산을 넘고, 두 갱신 모두 `dependency-change-evidence.json`에 owner와 다른 reviewer가 필요하다 |
| 09-04 | 일부 | **결정 대기**: 플랫폼 구성 화면(`EXAMPLES_PLATFORM`)은 끌 수 없고 FE-GATE-028 서명 대상이다. 기능으로 옮기면 lab이 443 ms로 FAIL. (가) 플랫폼 진단 화면으로 인정 (나) 라우트 청크를 병렬로 받게 고친 뒤 재측정 |
| 03-07 | 일부 | **결정 대기(백엔드)**: 백엔드 생성기에 목록 GET이 없다 |
| 09-03 | 일부 | 실제 Keycloak·Redis 연동 미확인. 백엔드 realm에 public client가 없고 Redis 모드 로그인 엔드포인트가 없다(제품 몫으로 매뉴얼 04에 적음) |
| 03-02 | 일부 | bulk `results`는 지원하지 않는다(문서화) |
| 07-04 | 일부 | 부팅 오류 `CONFIG_SECRET_NAME_REJECTED`에 키 이름을 싣지 않았다 |
| 09-05 | 일부 | SW `blockers`·`observe` 연결 칸이 템플릿 파일에 남았다 |
| 12-05 | 일부 | 지운 심볼과 1절 밖 문서는 검사하지 않는다(리뷰 5.2가 버린 대안) |
| 16-06 | 일부 | 라우트 계약 `title`·`navigationLabel`은 화면이 읽지 않는다 |
| 그 밖의 81건 | 고침 | 커밋과 근거는 각 수정 브랜치의 커밋 본문(`Refs:` 꼬리말에 발견 ID)과 CHANGELOG 미출시 절 |
리뷰가 틀렸던 것: P-07-07(CHANGELOG의 경로는 맞았고 이름과 둘째 경로가 틀렸다), 1101/07-07 주석의 "retryable은 어댑터가 읽는다"(읽는 곳이 0이다).
이월 항목(영역 문서 2절 "남음") 중 작은 것은 같이 고쳤다. 큰 것은 각 브랜치 보고에 이유를 적어 남겼다. 예: 0929/04-03(SSE `retry:` 범위, 결정 필요), 0929/08-01(locale 확장 지점), 0929/13-02·13-04·13-05·13-06, 1101/15-03(CSS 예산).
### 14.5 검증
메인 세션이 정한 방법(X4): 깨끗한 clone(`git clone --no-hardlinks`, `corepack pnpm install --frozen-lockfile --offline`)에서 CI와 같은 env(`VITE_COMMIT_SHA=<40자리>`, `VITE_BUILD_ID=gitea-1-1`, `RELEASE_ID`, `CHOKIDAR_USEPOLLING=1`)로 merge 단계 14개(FE-GATE-001~013, 020)를 `ci:gate`로 하나씩, 공유 잠금 아래에서 돌렸다. `ci:gate`는 첫 실패에서 멈추므로 고칠 때마다 다시 돌렸다.
| 회차 | 커밋 | 실패 | 원인과 수정 |
|---|---|---|---|
| 1 | `f887817` | 005, 006, 007, 008, 020 | CI 빌드 식별값이 vitest·dev server로 샌다(11-07) → `af312de`. 1절에 올린 계약 문서의 샘플 경로 → `2f2426a` |
| 2 | `5356787` | 008(storybook), 020 | a11y 애드온 자동 검사와 spec의 axe가 겹친다 → `f92cfd9`. 성능 문서의 샘플 경로 → `2c2d459` |
| 3 | `2c2d459` | 008(visual), 020 | 시각 골든 build가 CI 식별값을 그린다 → `9bddfa5`. 샘플 ID 글자 두 곳 → `5ca5340` |
| 4 | `0c9fcbd` | 008(webkit 1건), 020 | webkit "preloaded but not used" 경고 1건(부하 32.9, 다음 회차 통과). 새 dev manifest 테스트가 템플릿 상태에 기댄다 → `8b382aa` |
| 5 | `8b382aa`(005·008·020만) | 020 | dev manifest 플러그인이 Vitest에서도 돌아 src/에 샘플 경로를 쓴다 → `db5728b` |
| 6 | `db5728b`(005·020만) | 020(test:feature-scaffold) | 드릴이 생성 뒤 초기 JS 기록을 다시 쓰지 않는다(12-02 × 15-02) → `2e4595e` |
| 7 | `2e4595e` | 008(capability 1건) | dev manifest 미들웨어 뒤로 `requestfailed /release-manifest.json ERR_ABORTED`가 1~4건씩 났다. 미들웨어 있음/없음 번갈아 30건씩: 5·2 실패 / 0·0 실패. 미들웨어를 지우고 커밋 파일을 생성·제거 때 다시 쓰는 방식으로 바꿨다 → `799ab7f`(`0eba082`의 메모리 방식도 실패) |
| **최종** | **`799ab7f`** | **없음** | 14개 모두 통과. FE-GATE-008은 첫 실행에서 Firefox 다운로드 1건이 30초 시간 초과(부하 37.9)였고, 다시 두 번 돌려 두 번 다 통과했다(e2e 193, capability 66, storybook 1, visual 6). 같은 시간 초과는 플러그인 전 커밋 `5ca5340`에서도 났다(부하 26) |
최종 커밋 `799ab7f`의 결과: FE-GATE-001~007, 009~013, 020 rc=0(020: 참조 기능 제거 31 checks, 생성 기능 제거 17, feature scaffold 77, optional-recipe·browser-file-storage·realtime 제거 모두 PASS). FE-GATE-008 rc=0(재실행 2회).
생성 기능을 넣은 깨끗한 clone(`create:feature bulletin-feature --with-create --keyed`)에서 매뉴얼의 생성 뒤 단계대로 확인했다. `db5728b`: FE-GATE-012 통과(203,944 / 204,800 B, 26 / 32 파일, #4). `799ab7f`: 생성 명령이 `public/release-manifest.json`을 다시 쓰고(#3), dev server capability e2e 66건 통과(CI env), 초기 JS 기록 다시 쓰기 → FE-GATE-005 통과(#1·#2), `test:sample-removal -- --feature=bulletin-feature` 통과(17 checks, #2). **쓰기 기능 하나로 초기 JS 여유가 856 B다.**
실행하지 않은 것: 실제 Gitea 러너(`CI=true`, 러너 이미지), `test:system` 전체(이 세션의 게이트 목록 밖), 실제 짝 백엔드·nginx·Keycloak·Redis 연동.
### 14.6 매뉴얼만으로 기능 추가 재실험 (X2)
`f887817`의 깨끗한 clone에서 에이전트 하나가 `docs/manual/`만 보고 기능 하나를 더했다(`announcement-feature`, 새 context, `create:feature --with-create --keyed`, 라우트 3개, Envelope operation 3개, 기능 테스트 29개). 91분 걸렸고 그중 약 45분이 막힘 원인 추적이었다. **결과: 막힘 7건(0건이 아니다).** 지난 라운드 막힘 5건(Envelope, V2 입력 칸, routeId, items/ 경로와 a11y spec, 같은 키 재전송)은 모두 다시 막히지 않았다.
| # | 막힘 | 처리 |
|---|---|---|
| 1 | `tests/unit/product-extension-typecheck.test.ts`(09-02)의 탐침 ID가 매뉴얼 예시와 같은 `notice-feature`라, 같은 이름의 기능을 만들면 FE-GATE-005가 원인 없는 TS 오류로 실패 | 고침 `235143c`: 예약 이름 `typecheck-probe-*`, capability 선언은 덧붙이기, 없는 복사 대상 건너뛰기 |
| 2 | 기능을 더하면 초기 JS 기록(15-02)을 다시 써야 FE-GATE-005가 통과하고, 다시 쓰면 기능 제거 드릴이 반대 이유로 실패. 둘을 함께 통과시킬 수 없음 | 고침 `72c6e9d`: 기능 제거 드릴이 지운 뒤 기록을 다시 쓴다. 생성 명령 `Next:` 3번과 매뉴얼 01에 적음(`72b8ab1`) |
| 3 | 기능 생성 직후 `pnpm dev`가 `CONTRACT_SET_PACKAGE_MISSING`으로 부팅 실패. dev server를 쓰는 capability e2e 38건 실패 | 고침 `799ab7f`(16-09): 생성 명령과 기능 제거 드릴이 `public/release-manifest.json`의 contract set을 다시 쓰고, test:unit이 낡은 파일을 명령과 함께 알린다. 처음 고른 dev 전용 미들웨어(`c15345c`)는 capability e2e를 불안정하게 만들어 지웠다(14.5절 7회차) |
| 4 | 매뉴얼 검색 폼 예제를 따르면 공유 청크가 하나 떨어져 초기 파일 상한 26을 넘음 | 고침 `2fef27d`: 상한 32(HTTP/2 전제, 13-02) |
| 5 | 매뉴얼이 "드릴은 `check:bundle`을 돌리지 않는다"고 적음(12-02 뒤로 돈다) | 고침 `72b8ab1` |
| 6 | 로컬 FE-GATE-013에 `VITE_COMMIT_SHA` 40자리가 필요하다는 안내 없음 | 고침 `72b8ab1`(생성 명령 출력, 매뉴얼 01). 실패 로그 위치도 적음 |
| 7 | FE-GATE-020 드릴 셋이 깨끗한 base에서도 실패: 제거 fixture의 문서 경로·잔여 ID, 탐침의 `recipes/` 복사, 업로드 client의 browser-file-storage 포트 import | 고침 `2f2426a`, `2c2d459`, `5ca5340`, `235143c`, `3d3d652` |
자잘한 것(01 6단계 codec 문장, `global-ids.md` API 경로 예)도 `72b8ab1`에서 고쳤다. 고치지 않은 것: patterns.md에 여러 줄 입력(TextArea) 예제가 없다, 3단계의 바이트 상한 기준이 없다. 매뉴얼만 보는 재실험 전체는 다시 돌리지 않았다. 7건이 고쳐졌는지는 14.5절 X4, 생성 기능을 넣은 clone 확인, 각 커밋의 테스트로 확인했다. **"막힘 0"을 같은 방법(매뉴얼만 보는 에이전트)으로 다시 재지는 않았다.**
### 14.7 남은 문제
- 결정 대기 셋: 13-03(운영 의존성 advisory와 예산), 09-04(플랫폼 구성 화면), 03-07(백엔드 목록 GET).
- 백엔드에 넘길 것: `POST /v1/files` 멱등 키, 생성기 목록 GET, realm public client, Redis 세션 모드 엔드포인트, Envelope 단계 신호(D2 ②).
- 초기 JS 여유가 1,873 B다. `--with-create` 기능 하나(+약 964 B)를 넣으면 약 900 B가 남는다.
- `test:feature-scaffold`가 513~866초 걸린다. FE-GATE-020 job(45분 상한)에 드릴 5개가 있다.
- 기능 라우트 첫 진입(약 430 ms)을 재는 게이트가 없다(새 관찰).
- dev manifest 미들웨어가 capability e2e를 불안정하게 만든 원인(첫 manifest 요청이 200 헤더 뒤 끊기고 곧 두 번째 요청이 성공)을 끝까지 좁히지 못했다. 미들웨어를 지워 피했다.
- 초기 JS 측정용 빌드 입력 목록(`BUILD_INPUTS`)이 `scripts/scale/measure-feature-shape-growth.ts`와 `tests/unit/product-feature-selection-build.test.ts`에 두 벌 있다.
- Firefox 다운로드 capability 테스트(`browser-files.spec.ts:211`)가 부하 26~38에서 30초 시간 초과로 가끔 떨어진다(조치 전 커밋에서도 남).
- 매뉴얼만 보는 재실험(X2)을 고친 뒤 다시 돌리지 않았다.
- 리뷰 기록 두 곳(`docs/reviews/2026-11-01-maturity-review/README.md:627`, 이 폴더 `03-adapters-http-state.md:332`)과 커밋 `12f3bb7` 본문에 "memento-web이 V2 행을 쓴다"는 틀린 문장이 남아 있다. 리뷰 기록은 고치지 않는다. CHANGELOG에서는 지웠다.