루트 항목 하나를 옮기려면 코드 7곳의 루트 경로 목록을 같이 고쳐야
했다(복사 대상, 비밀값 검사 범위, 공급망 시험의 필수 입력, 이력 문서
검사, 규모 입력, vite 입력, TS 전용 규칙). 서로 다른 부분집합이고 한
곳에서 선언하지 않았다. 목록이 갈라져 공급망 생성이 깨진 적도 있다
(removal-fixture.ts 주석). 루트에는 JSON Schema 5개만 담은 `schemas/`가
`config/` 옆에 따로 있었다. `artifacts/`(출력 폴더)에는 사람이 쓴 수동
a11y 기록이, `config/hosting/`(호스트 계약)에는 시험 fixture가 섞였다.
고른 방법(design-docs repo-structure/04-frontend-layout.md 9.2절 3단계,
11절 R1·R2, 소유자 승인 2026-11-07):
- `config/repository-layout.json`이 루트 항목마다 종류·역할·읽는 곳과
들어가는 목록(`sets`, 항목 안 경로는 `setPaths`)을 적는다.
`scripts/lib/repository-layout.ts`가 읽고 검증한다. 6곳은 이름 붙은
집합을 고른다. JSON인 비밀값 검사 정책은 집합의 사본을 두고 시험이
같은지 본다(정책 파일은 릴리스 후보에 실려 형식을 바꾸지 않았다).
공급망 시험의 필수 입력 목록은 그 시험으로 대신한다.
- `tests/unit/repository-layout.test.ts`: 등록부에 없는 루트 항목이
추적되면 실패(R1). 7곳이 등록부 모듈을 쓰고 루트 이름 둘 이상의
문자열 배열을 갖지 않는지(R2).
- `schemas/artifacts/` → `config/schemas/artifacts/`, recipe 카탈로그
스키마 → `config/schemas/recipes/`. 정책 입력 순서(ASCII)에 맞춰
`config/schemas/`가 `config/security/` 앞에 온다.
- 수동 a11y 기록 3개 → `docs/accessibility/route-reviews/`. `artifacts/`는
`.gitkeep`만 추적한다. 기록은 단위 시험이 읽어서 drill 사본에도
복사한다(`fixture-copy` 집합의 `docs/accessibility/route-reviews`).
- `config/hosting/response-headers.fixture.json` →
`tests/fixtures/hosting/response-headers.json`.
버린 것: 비밀값 검사 정책이 집합 이름을 참조하게 바꾸는 방법. 정책
파일은 릴리스 후보와 로컬 증거 평가가 읽는 형식이라 바꾸면 릴리스
증거 계약이 바뀐다. 루트 항목이 지워졌는데 등록부에 남는 경우는
시험하지 않았다. drill 사본은 일부만 복사해 그 방향을 볼 수 없다.
그런 항목은 그 집합을 쓰는 곳(복사, 비밀값 검사)에서 실패한다.
위험: 하네스 작업(fe-c)이 더할 `AGENTS.md`·`.claude/`를 미리 등록했다
(optional). 등록부가 이력 문서(`SPEC.md`)와 `CLAUDE.md` 이름을 적어서
이력 문서 검사에서 등록부 파일은 뺐다. 다운스트림은 자기 루트 항목을
등록부에 더해야 한다(CHANGELOG). CI 계약 기준선을 다시 받았다(a11y
기록 산출물 id·경로).
검증(desktop): 아래 4단계 커밋까지 쌓은 트리에서 test:unit,
check:types, check:ci, lint, verify:documentation을 돌렸다(그 커밋에
적음). 이 커밋 단독으로 test:unit·check:ci·check:types를 돌렸다.
Refs: design-docs repo-structure/04-frontend-layout.md 2.4·9.2·11절, README.md 3.4절
음성 타입 fixture마다 옵션이 같은 tsconfig 하나, package script 하나,
게이트 명령 하나가 있었다(23벌). 옵션은 모두 같고 파일 하나만 달라서
fixture를 더할 때마다 세 곳을 같이 고쳤다. `tsconfig.recipes.json`도
`tsconfig.test.json`과 lib가 같고 types만 하나 적었다.
`tsconfig.web-worker.json`은 `files: []`로 0파일을 검사하고 통과했다
(2026-09-25 리뷰가 기록, FE-GATE-003이 통과로 보였다).
고른 방법(design-docs repo-structure/04-frontend-layout.md 5.3절 (가),
소유자 승인 2026-11-07):
- fixture 첫 줄에 기대(`// expect: TS2322`, `// expect: pass`)를 쓰고
`scripts/check-type-fixtures.ts`가 fixture마다 `.tmp/type-fixtures/`에
한 파일 tsconfig를 써서 tsc를 돈다. 판정은 run-ci-gate.ts가 명령마다
하던 것과 같다(exit 1과 `error TS<code>:`). 결과를 fixture별로 출력한다.
기대 줄이 없는 fixture와 fixture 0개는 실패한다.
- recipes는 `tsconfig.test.json` include로 옮긴다.
- web-worker tsconfig와 script는 지운다(결정 D4). Worker를 들일 때 더하는
단계는 매뉴얼 03에 쓴다(뒤 커밋).
- `scripts/check-typecheck-inputs.ts`를 `check:types` 끝에 둔다. package
script가 tsc에 넘기는 tsconfig마다 이 repo 파일이 1개 이상인지 본다.
`files: []` tsconfig가 통과로 보이던 구멍을 막는다(R8).
버린 것: TypeScript API로 한 프로세스에서 돌리는 방법. 이 repo의
TypeScript 7.0(네이티브판)은 JS API를 싣지 않는다. 위반마다
`@ts-expect-error`를 쓰는 방법(5.3절 (나))은 오류 코드 고정을 잃는다.
위험: recipe가 이제 `vite/client` 타입이 있는 프로그램에서 검사된다.
recipe가 `import.meta.env`를 쓰면 전에는 실패했고 이제는 통과한다
(복사한 제품도 Vite라 가치가 작다, 설계 5.1절). CI 계약 기준선을 다시
받았다(명령 99 → 76).
검증(desktop): `check:types:fixtures` 23개 PASS, 각 fixture의 기대 코드가
출력에 그대로 나온다. `TelemetryPort.emit` 인자를 `string`으로 넓히는
변이(2026-09-25 리뷰 07-05)에서 `invalid-diagnostics-port.ts`가 TS2578로
FAIL, 실행기 rc=1. 되돌린 뒤 작업 트리 0줄. `check:types` rc=0
(Typecheck inputs: app 379, node 312, service-worker 22, test 915).
Refs: design-docs repo-structure/04-frontend-layout.md 5.3·9.2·9.3절, README.md 3.4절 D4
문제: pnpm audit(2026-11-04) 결과 advisory 44건(critical 1, high 16)이
있었고, 템플릿 자신의 취약점 정책(high 이상 차단, 예외 0건)을 어겼다.
대부분 개발 의존성이다: storybook 10.5.4(critical, dev 서버 코드 주입),
vite 8.1.5, vitest 4.1.10, 그리고 jsdom 경유 undici 7.28.0,
brace-expansion 5.0.8, nanoid 3.3.16, source-map-js 1.2.1.
고른 방법: 고친 버전이 있는 가장 가까운 줄로 올린다. vite 8.1.6(같은
8.1 줄), vitest·@vitest/coverage-v8 4.1.12(같은 4.1 줄), storybook
3종 10.6.5. 전이 의존성은 `pnpm update --depth Infinity`로 선언된 범위
안에서만 올렸다(undici 7.30.1, brace-expansion 5.0.12, nanoid 3.3.20,
source-map-js 1.2.2, postcss 8.5.23). 의존성 기준선을
update:dependency-baseline으로 다시 승인했다.
버린 대안: 운영 의존성 zod 4.6.7·react-router-dom 7.18.5도 함께 올리기.
직접 운영 의존성 변경은 dependency-change-evidence.json에 owner와 다른
reviewer가 필요해 기준선 생성이 거절했다(add:zod@4.6.7,
add:react-router-dom@7.18.5). 또 zod 4.6.7은 초기 JS를 약 7 KB 늘려
예산(204,800 B)을 넘긴다(측정 208,444 B). 그래서 이 커밋에 넣지 않고
다음 커밋에서 남은 위반으로 기록한다.
위험·한계: 남은 high 2건은 운영 의존성(zod GHSA-mrhx-c7xc-m3w5,
react-router GHSA-qwww-vcr4-c8h2)이다. 남은 moderate 2건(minimatch,
glob)은 고친 버전이 선언된 major 범위 밖이라 올리지 않았다. 의존성 수
561 → 562.
검증: pnpm audit → high 2(운영), moderate 2, critical 0. 이 상태에서
test:component 263, test:integration 117, build:storybook 성공,
check:bundle PASS(200,939 B, 25개), feature-shape-growth·supply-chain·
build-environment-bundle 39건 통과. 운영 의존성까지 올린 상태의
test:unit은 2,611건 통과였다(전체 test:unit은 브랜치 끝에서 다시 돌린다).
Refs: docs/reviews/2026-11-03-maturity-review/13-build-release-supply-chain.md 13-03