문제
config/ci/ungated-scripts.json의 check:feature-index 이유는 "--check는
로컬 사본이 오래됐다는 것만 알려 줄 수 있다"이다. 쓸모없다는 말로 읽혀
리뷰가 지울 후보로 올렸다. 실제로는 scripts/verify-extreme-scale.ts가
EXTREME_SCALE_GATES 첫 단계로 이 script를 부른다.
고른 방법
- 지우지 않는다. 이유 문구를 "로컬에서 생성 인덱스가 오래됐는지 확인,
verify:extreme-scale(scripts/verify-extreme-scale.ts)의 첫 단계. 게이트는
인덱스를 먼저 다시 만들어서 얻는 것이 없다"로 고친다.
- ungated-scripts 테스트가 EXTREME_SCALE_GATES에 이 script가 있고 이유가
verify:extreme-scale을 적는지 확인한다. verify:extreme-scale이 이
script를 그만 부르면 실패해서 다시 지울 후보가 된다.
- 12-05의 나머지(script 4개 삭제, scan: 접두어 검사)는 98b9682가 했다.
버린 대안
- check:feature-index 삭제: verify-extreme-scale.ts의 단계 목록과
tests/scripts/verify-extreme-scale.test.ts를 같이 고쳐야 하고, 로컬에서
생성 인덱스가 오래됐는지 볼 방법이 없어진다.
위험·한계
- 게이트 명령은 바뀌지 않는다. CI 계약 기준선은 그대로다.
검증
- RED: 새 테스트 "names verify:extreme-scale as the user of
check:feature-index"가 실패(expected 'The generated indexes
(src/.generated…' to contain 'verify:extreme-scale').
- GREEN: ungated-scripts·ungated-tests·verify-extreme-scale 31/31 통과.
- check:ci 세 단계를 pnpm 없이 직접 실행: generate-artifact-schemas --check
PASS, check-ci-contract.ts PASS(27 gates), generate-ci-workflow --check
PASS. 바꾼 테스트 eslint 통과.
Refs: docs/reviews/2026-11-01-maturity-review/12-guardrails-ci.md 12-05
문제
package.json에 어디서도 부르지 않는 script 4개가 있다.
- scan:security:fixture: FE-GATE-013은 이것 대신 check:security:fixtures를
돈다. supply-chain.test.ts는 "게이트에 없어야 한다"고 단언하는데 script는
남아 있다. 게이트 밖 script 검사는 check|verify|test|drill|review만 봐서
scan:을 놓쳤다.
- build:profile: 이름과 달리 generate-runtime-config.ts만 돈다.
- generate:contract-set: 참조 0건.
- build:app-only: vite build와 매니페스트만 만든다. build-frontend.ts의
계약 세트·런타임 설정·Service Worker 단계가 빠진 dist가 나온다. 참조는
product-index-entrypoints 테스트의 진입점 목록 하나다.
참조 확인(새 기준 298201f, docs/reviews 제외): package.json 정의와 위 두
테스트 말고는 config/ci/gates.json, 생성 workflow, scripts, docs 어디에도
없다. 아래 세 script가 부르던 파일(generate-runtime-config.ts,
generate-contract-set.ts, generate-build-manifest.ts)은 build-frontend.ts가
그대로 부른다.
고른 방법
- 네 script를 지우고 진입점 목록에서 build:app-only를 뺀다.
- VERIFICATION_SCRIPT에 scan을 더한다. 게이트가 닿지 않는 scan:* script는
ungated-scripts.json 항목 없이는 check:ci에서 실패한다. 지금 남은
scan:security는 build:release-candidate를 거쳐 게이트가 닿는다.
- docs/operations/ci-quality-gates.md의 접두어 목록에 scan:*을 더한다.
버린 대안
- build:app-only를 build:vite-only로 이름만 바꾸기: 남길 사용처를 찾지
못했다.
- 접두어 대신 "게이트 밖 모든 script는 예외 목록에": dev·storybook·
update:*까지 목록에 올라가 목록이 커진다(리뷰 대안 비교와 같다).
- check:feature-index 정리(리뷰 개선 (4)): 지우기와 이유 문구 고치기 중
하나를 고르는 일이라 이번에 하지 않았다.
위험·한계
- 개인 습관으로 이 script를 쓰던 사람은 build-frontend.ts나 node
scripts/...를 직접 불러야 한다.
- 게이트 명령은 바뀌지 않아 CI 계약 기준선은 그대로다.
검증
- RED: 새 테스트 "rejects a scan script that no gate reaches"가 실패
(expected [ …(2) ] to deep equally contain '…: scan:orphan'). 정규식만
넓히면 저장소 검사 "reaches every verification script …"가
scan:security:fixture 한 건으로 실패.
- GREEN: ungated-scripts·product-index-entrypoints·supply-chain·
ci-workflow-generation 4파일 457/457 통과. check:ci의 세 단계를 pnpm
없이 직접 실행: generate-artifact-schemas --check PASS,
check-ci-contract.ts PASS(27 gates), generate-ci-workflow --check PASS.
tsc(tsconfig.node, tsconfig.test), 바꾼 파일 eslint 통과.
Refs: docs/reviews/2026-11-01-maturity-review/12-guardrails-ci.md 12-05
check-ci-contract only caught test files outside the gates; check:* scripts
such as check:request-fanout and check:remediation-ledger ran nowhere. The
new check reads config/ci/ungated-scripts.json; three checks are now wired
into FE-GATE-010 and FE-GATE-012 and the rest carry a reason.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>