문제: config/schemas/에 산출물 JSON Schema 4개가 있다. 코드·테스트·
workflow·문서 어디서도 경로나 $id(ART-FE-FIELD-WEB-VITALS@1,
ART-FE-LAB@1, ART-FE-003@1, ART-FE-RUNBOOK-DRILL@2)로 읽지 않는다
(git grep, CHANGELOG·리뷰 기록 제외). 산출물을 실제로 검사하는 것은
scripts/contracts/release-artifacts.ts의 zod schema다. 그런데도
81701ad(2026-11-05)가 lab 칸을 더하면서 이 파일도 손으로 고쳤다. 읽는
곳 없는 사본을 맞추는 일이 생긴다.
schemas/의 생성 스키마와 비교: scripts/generate-artifact-schemas.ts가
만드는 4개(build-manifest, dependency-inventory, registry-snapshot,
supply-chain-verification)와 이름·대상이 겹치는 것이 없다. 그래서 각
파일을 그 산출물의 zod 정본과 대조했다.
- field-web-vitals ↔ fieldWebVitalsArtifactSchema: 최상위 칸 9개와
context 칸 9개가 같다. zod가 더 엄격하다(window.days = 28,
consentRequired = true, 숫자 범위, 하위 객체 strict).
- lab-performance ↔ labPerformanceArtifactSchema: zod는 context·metrics를
아무 객체로 받는다. JSON만 context 필수 칸 7개, metrics 필수 칸 5개,
fixtures 2개 이상을 적었다. context 칸 7개는
scripts/lib/performance-budgets.ts evaluateLabBudget가 없으면 실패로
판정한다. metrics 5칸과 fixtures 3개는 scripts/test-performance.ts가
늘 만든다.
- release-verification ↔ releaseVerificationArtifactSchema: zod가 더
엄격하다(artifact.releaseId 필수, fixture 칸 strict). JSON만 fixtures
2개 이상을 적었다. scripts/verify-release.ts는
config/release/coherence-fixtures.json의 4개를 쓴다.
- runbook-drill-record ↔ runbookRecordArtifactSchema: 칸이 같다. zod는
result가 판정들의 합과 맞는지도 본다. JSON만 recoveryAssertions 4개
이상을 적었다. scripts/drill-runbook.ts의 runbook 5개는 모두 4개를
만든다.
JSON에만 있는 최소 개수 셋은 지금 만드는 쪽이 늘 채우지만 아무도
검사하지 않는다. 이 파일도 읽는 곳이 없어 지워도 검사가 줄지 않는다.
버린 대안: schemas/로 옮기거나 zod에서 생성하기. 읽는 곳이 없는 파일을
옮기거나 생성하면 지킬 것 없는 사본이 하나 더 생긴다. 스키마 자리를 한
곳으로 모으는 일은 3단계(schemas/ → config/schemas/)다.
위험·한계: 다운스트림이 이 파일을 외부 도구에 물렸다면 그쪽이 끊긴다.
템플릿 안에는 그런 곳이 없다.
검증: git grep으로 경로와 $id 넷을 찾아 0건(CHANGELOG·리뷰 기록 제외).
desktop(네 커밋의 끝 30a379f, 로그 ~/l1-layout-cleanup-logs/):
check:types, test:unit(212 files, 3091 tests), check:ci, lint exit 0.
Refs: design-docs repo-structure/04-frontend-layout.md 2.1절, 9.2절