Files
clean-architecture-frontend…/tests
DongHyeonka b6bfc9b7d9 fix(removal): sample 제거 fixture의 문서 검사를 fixture 전용 삭제와 맞춘다
문제
c4d5870 뒤 test:sample-removal이 문서를 복사하고 verify:documentation과 문서
테스트를 돌린다. 실제 드릴 실행(snapshot 0edc3fc)에서 두 가지로 실패했다.
- 드릴은 fixture에서만 tests/unit/ci-workflow-generation.test.ts와
  tests/unit/removal-fixture.test.ts를 지운다(전체 저장소를 고정하는 테스트라).
  docs/operations/adapter-remediation-ledger.md가 그 두 파일을 백틱 경로로 적어,
  fixture의 문서 검사와 문서 테스트 7건이 실패했다. 샘플을 지운 실제 프로젝트는
  그 테스트를 지우지 않으므로 이 실패는 fixture에만 있다.
- 잔여 검사가 tests/unit/documentation-readiness.test.ts의 정규식
  REFERENCE_RESOURCE_[A-Z]+를 샘플 흔적으로 잡았다. 그 파일은 예전에는 fixture
  에서 지워져 검사되지 않았다.

고른 방법
- 원장(기록 문서)의 그 세 곳을 백틱 없는 경로로 바꾼다. 드릴의 fixture 전용
  삭제 목록 옆에 "현재 계약 문서는 이 파일들을 백틱 경로로 적지 않는다"를
  적었다.
- 정규식을 [A-Z]+_RESOURCE_[A-Z]+로 쓴다. 라우트 ID를 지우는 용도는 같다.
- 버린 대안: 문서 검사에 fixture 전용 예외 경로를 넘기는 환경 변수. 운영
  스크립트에 테스트용 입력이 생긴다. fixture 전용 삭제를 그만두기.
  ci-workflow-generation 스냅샷은 줄어든 CI 계약과 맞지 않는다.

위험·한계
- 앞으로 현재 계약 문서가 그 두 테스트를 백틱으로 적으면 sample 드릴이 다시
  문서 검사에서 실패한다. 실패 메시지가 파일과 경로를 적는다.

검증
- 수정 전 snapshot 0edc3fc의 test:sample-removal exit 1: documentation,
  unit-integration, coverage, fixture-id-residue와 scaffold- 세 검사가 이 두
  원인으로 실패. lint·check:i18n·check:design-system 등 나머지는 통과.
- 샘플·SAMPLE_EXTRAS·fixture 전용 테스트를 지운 복사본(sim-sample-docs.sh)에서
  verify:documentation PASS_SCOPED. 저장소에서 documentation-readiness 19건
  통과, verify:documentation PASS_SCOPED.

Refs: docs/reviews/2026-11-03-maturity-review/14-template-product-docs.md 14-04
2026-11-04 21:39:41 +09:00
..