llm-wiki/raw/branch-notes/feature-frontend-test-taxonomy-contract.md

title, source_type, status, id, kind, project, work_item, inherits, refines, overrides, depends_on, contract_packet, branch, parent_branch, related_projects, governing_docs, tags, created, target_merge, status_label, contract_packet_sha256, imports

title	source_type	status	id	kind	project	work_item	inherits	refines	overrides	depends_on	contract_packet	branch	parent_branch	related_projects	governing_docs	tags	created	target_merge	status_label	contract_packet_sha256	imports
branch / feature-frontend-test-taxonomy-contract	branch-note	raw	BR-CA-SKELETON-FRONTEND-OPERATIONAL-CONTRACT-017	project-work-item	ca-skeleton-frontend-operational-contract	WI-CA-SKELETON-FRONTEND-OPERATIONAL-CONTRACT-017	DEC-CA-SKELETON-FRONTEND-OPERATIONAL-CONTRACT-TEST-STACK-001@1			WI-CA-SKELETON-FRONTEND-OPERATIONAL-CONTRACT-001	1	feature-frontend-test-taxonomy-contract		ca-skeleton-frontend ca-skeleton	raw/project-notes/ca-skeleton-frontend-operational-contract.md	branch ca-skeleton frontend testing react javascript	2026-07-18		in-progress	160ba678c61d567516938e08a0a4413a55424796822f145f22d575376746274d	ART-FE-001@1 ART-FE-002@1 ART-FE-004@1 FE-GATE-001@1 FE-GATE-002@1 FE-GATE-003@1 FE-GATE-004@1 FE-GATE-009@1 FE-GATE-010@1 FE-GATE-011@1 FE-GATE-012@1 FE-GATE-013@1 FE-GATE-020@1 FE-OC-019@1 FE-OC-021@1 FE-OC-025@1

branch: feature-frontend-test-taxonomy-contract

Layer: raw/branch-notes/ — 단일 브랜치의 TODO·결정·진행 기록. 현재는 /branch-spec 로 spec 을 채운 planned 단계다(frontend 코드 저장소 미생성).

부모 (필수)

• raw/project-notes/ca-skeleton-frontend-operational-contract

브랜치 계약 패킷

• 생성 시 프로젝트 개정: 1
• 패킷 스키마: contract_packet: 1
• 완료 조건: gate·fixture·artifact mapping과 test level별 최소 1개 test가 존재한다

상속한 프로젝트 결정

Decision Ref	Project Summary	Branch Application	Source
DEC-CA-SKELETON-FRONTEND-OPERATIONAL-CONTRACT-TEST-STACK-001@1	test stack default는 Vitest, RTL, MSW, Playwright, axe다	test level·gate·fixture·artifact taxonomy에 적용한다	raw/project-notes/ca-skeleton-frontend-operational-contract

브랜치 지역 결정

Decision ID	Decision	Relation	Supporting Claims	Status
D1	frontend test stack default를 고정한다	local	raw/project-notes/ca-skeleton-frontend-operational-contract	proposed
D2	gate를 KIND별 단일 책임으로 분리한다	local	raw/project-notes/ca-skeleton-frontend-operational-contract	proposed
D3	test level별 대표 test와 gate별 negative fixture를 요구한다	local	raw/project-notes/ca-skeleton-frontend-operational-contract	proposed
D4	gate failure를 warning으로 낮추지 않는다	local	raw/project-notes/ca-skeleton-frontend-operational-contract	proposed
D5	공유 artifacts evidence tree를 사용한다	local	raw/project-notes/ca-skeleton-frontend-operational-contract	proposed
D6	gate별 test level과 fixture KIND taxonomy를 이 branch가 소유한다 (gate-to-contract coverage mapping은 hub §15.1 소유)	local	raw/project-notes/ca-skeleton-frontend-operational-contract	proposed

선언한 예외

Override ID	Overrides	Reason	Approval	Status

없음.

목표

이 branch 는 FE-OC-020(owner) — "gate 종류별 책임·fixture·artifact 를 분리하고 실패를 warning 으로 낮추면 안 됨" — 을 구현 착수 가능한 spec 으로 내린다. 구체적으로 frontend quality-gate taxonomy 를 정의한다: 각 gate 가 어느 test level 에 속하고 어떤 fixture 종류 를 요구하는지(각 gate 의 blocking scope·Covered FE-OC·pass condition·증거 artifact 는 hub §15.1 소유), "test level 당 대표 test 최소 1개(one-test-per-level)" 수락 규칙, "gate 당 최소 1개의 의도적 실패 negative fixture" 규칙(raw/project-notes/ca-skeleton-frontend-operational-contract §15.2), 그리고 gate 실패를 warning 으로 downgrade 하지 않는다는 불변식(§15.3 promotion formula). 아울러 test stack default(Vitest + RTL + MSW + Playwright + axe — raw/project-notes/ca-skeleton-frontend-operational-contract FE-D022)를 고정한다. gate→FE-OC coverage-mapping 의 owner 는 hub §15.1 이고 본 branch 가 아니다 — hub §15.1 이 "이 표가 gate 의 정의다 … branch 는 이 표를 옮겨 적지 않는다" 라고 명시하며, hub §2.1.1 이 gate 26개의 Owner 를 각각 확정한다. 본 branch 가 소유하는 것은 gate → test level / fixture KIND taxonomy 다(약 8개 sibling branch 가 자신의 gate artifact 를 이 taxonomy 에 예치). 모든 진술 등급은 planned — frontend repository 가 아직 없다.

• 이슈: 없음 (repository 미생성)
• PR: 없음

범위

포함 범위

FE-OC-020 이 소유하는 것만:

• Gate KIND 열거 + 스키마: §15.1 의 26-gate 를 gate → test level → 필요한 fixture 종류 로 매핑. 각 gate 의 blocking scope · Covered FE-OC · pass condition · 증거 artifact 는 hub §15.1 소유이므로 여기서 재진술하지 않고 gate ID 로 참조한다.
• (제외) gate→FE-OC coverage-mapping 의 owner 는 hub §15.1 이다. 이전 판에서 본 branch 를 SSOT 로 적었던 것은 Single-Owner 위반이었고 2026-07-21 에 hub 로 확정했다.
• one-test-per-level 수락 규칙 — 각 test level(runtime-schema / unit / component / integration / e2e / a11y)마다 최소 1개 대표 test 로 taxonomy 가 선택한 stack 으로 realizable 함을 증명.
• negative-fixture-per-gate 규칙(§15.2) — 각 gate 는 ≥1 의도적 실패 fixture 를 실제 실행; rule 존재만으로는 locally-verified 증거 불충분.
• no-downgrade 불변식 + blocking-scope promotion formula(§15.3: MERGE_READY / RELEASE_READY / PROD_PROMOTION_READY / FIELD_SLO_READY / DOCUMENTATION_READY).
• test stack default 도구 배정(raw/project-notes/ca-skeleton-frontend-operational-contract FE-D022) — 각 level 을 어떤 도구가 실행하는지.
• 공유 artifacts/ evidence-tree taxonomy(§14.3 artifact column, §4.6 blueprint) — sibling gate 들이 예치하는 정본 트리.

제외 범위

의도적으로 제외 — 다른 owner branch 소유. 여기서는 이름만 가리키고 detail 을 재명세하지 않는다(CLAUDE.md §15.5 R3).

• CI workflow orchestration(gate job dependency graph, artifact retention wiring, blocking-gate 배선) → raw/branch-notes/feature-frontend-ci-quality-gates-contract (FE-OC-020 공동 기여). 이 branch 는 taxonomy 를 정의하고, CI 가 그것을 어떻게 실행/보관하는지는 저 branch.
• 각 gate 의 fixture 본문(content) 은 contract owner 에 위임: runtime-schema fixture → raw/branch-notes/feature-runtime-schema-validation-contract (FE-OC-007); error taxonomy fixture → raw/branch-notes/feature-frontend-error-classification-boundary-contract (FE-OC-008); architecture forbidden-import fixture → raw/branch-notes/feature-frontend-architecture-enforcement-lint-contract (FE-OC-002); build/bundle/security fixture → raw/branch-notes/feature-frontend-build-bundle-supply-chain-contract (FE-OC-018); component gate 의 browser-security 슬라이스 fixture → raw/branch-notes/feature-frontend-browser-security-boundary-contract (FE-OC-019); performance threshold → raw/branch-notes/feature-web-vitals-performance-budget-contract (FE-OC-021); sample-removal fixture → raw/branch-notes/feature-sample-feature-slice-contract-fixture (FE-OC-024); runbook drill → raw/branch-notes/feature-frontend-operational-runbook-contract (FE-OC-025).
• Toolchain / package-script host(pnpm script, engine, lockfile) → raw/branch-notes/feature-frontend-project-bootstrap-toolchain-contract (FE-OC-003). 이 branch 는 script slot 을 consume 만.
• NFR 임계값 자체(timeout 10s, retry ≤2, bundle KiB, axe 0) → 각 NFR contract owner. taxonomy 는 assertion slot 만 hosting.

근거 (필수, 최소 1개+)

Source	정당화하는 결정
raw/official-docs/vite-build-tool-official (VITE-C1, VITE-C2)	D1 배경 근거 — build/test 파이프라인이 Vite 위에 올라감(dev = native ESM 위 기능, prod = Rolldown 정적 자산 산출). 단 특정 test runner(Vitest 등) 선택은 이 문서가 말하지 않음 — 도구 선택 자체는 hub FE-D022 project decision. build gate artifact(§14.3 pnpm build)의 정적 자산 산출 근거로만 직접 인용 가능.
raw/project-notes/ca-skeleton-frontend-operational-contract FE-D022 (§15, §14)	D1 test stack default(Vitest+RTL+MSW+Playwright+axe)의 1차 근거. Vite/browser/component/e2e 책임 분리라는 conditional-default.
raw/project-notes/ca-skeleton-frontend-operational-contract §15.1 gate matrix	D2 gate-kind 분리의 근거(26-row acceptance gate registry). gate→FE-OC mapping 은 이 §15.1 이 소유하며 D6 는 그 위에 test level / fixture KIND 층만 얹는다.
raw/project-notes/ca-skeleton-frontend-operational-contract §15.2 negative fixture requirement	D3 one-test-per-level + gate 당 ≥1 negative fixture 근거.
raw/project-notes/ca-skeleton-frontend-operational-contract §15.3 promotion formula	D4 no-downgrade / blocking-in-scope 불변식 근거.
raw/project-notes/ca-skeleton-frontend-operational-contract §14 planned commands + §4 directory blueprint	D5 공유 artifacts/ evidence-tree taxonomy 근거(script→artifact 매핑, artifacts/ 트리).

TODO

• repository(src/, tests/) 생성 후 §15.1 26-gate 를 gate→test level→fixture-kind taxonomy 로 고정(artifact·blocking scope 는 hub §15.1 소유) — 등급: planned
• 각 test level(runtime-schema / unit / component / integration / e2e / a11y)마다 대표 test 최소 1개 작성(one-test-per-level) — 등급: planned
• 각 gate 에 ≥1 의도적 실패 negative fixture 연결(§15.2 카탈로그) 후 "예상대로 실패" 확인 — 등급: planned
• artifacts/{quality,tests,performance,security,release,runbooks} evidence-tree + pnpm test:* script→artifact 매핑 확정(§14.3) — 등급: planned
• no-downgrade 불변식 + promotion formula(§15.3)를 반영한 gate 상태 판정 규칙 정의 — 등급: planned
• 구현 repository 와 검증 evidence 식별 — 등급: needs-confirmation

진행 중 메모

• /branch-spec self-map 완료(2026-07-19): hub §15 gate matrix + §14.3 planned commands + §8.5 negative fixtures + FE-D022 가 이 branch 의 SSOT. 6개 official-doc source 중 testing-tool 을 직접 말하는 claim 은 없음 → 도구 선택 근거는 hub project decision, Vite 문서는 파이프라인 배경으로만 인용. 외부 web research 불필요(모든 결정 hub-grounded). frontend 코드 부재 → 전부 planned.

결정 사항

각 결정의 근거는 아래 Sources 및 Decision Evidence Map 참조.

• 2026-07-19: test stack default = Vitest + RTL + MSW + Playwright + axe / 이유: Vite 위 build/test 파이프라인 통합 + unit/component/integration/e2e/a11y 책임 분리 / 검토한 대안: Jest + Cypress, 조직 test platform / 근거: raw/project-notes/ca-skeleton-frontend-operational-contract FE-D022 (conditional-default).
• 2026-07-19: gate 는 KIND별 단일 책임으로 분리하고 blocking scope(merge / release / prod-promotion / field / documentation)를 명시; 통합 test job 으로 합치지 않음 / 검토한 대안: 단일 test 스텝 / 근거: §15.1 26-gate matrix.
• 2026-07-19: one-test-per-level + gate 당 ≥1 negative fixture 불변식; rule 존재만으로는 evidence 불충분 / 근거: §15.2 + §20 measurable completion.
• 2026-07-19: gate 실패를 warning 으로 낮추지 않음(scope 내 전부 blocking), promotion 은 §15.3 formula 준수 / 근거: FE-OC-020 normative summary + §15.3.
• 2026-07-19: 공유 artifacts/ evidence-tree taxonomy; sibling gate 는 자체 트리를 만들지 않고 여기에 machine-readable artifact 예치 / 근거: §14.3 + §4.6.
• 2026-07-19: §15.1 gate→FE-OC coverage-mapping 표의 single owner(SSOT) → 2026-07-21 철회: 그 매핑의 owner 는 hub §15.1 이다(§15.1 서두 "이 표가 gate 의 정의다 … branch 는 이 표를 옮겨 적지 않는다"). 본 branch 가 SSOT 를 자처한 것은 Single-Owner 위반이었다. 남는 결정: 본 branch 는 gate → test level / fixture KIND taxonomy 를 소유하고 sibling 은 그 taxonomy 를 복제·재정의하지 않는다.

결정-근거 매핑

Decision ID	Decision	선택 조건 (언제 이 결정 / 언제 대안)	Supporting Claims	Evidence Strength	Open Risk
D1	test stack default = Vitest + RTL + MSW + Playwright + axe (FE-OC-020 / hub FE-D022)	이 조건: Vite 기반 client-only SPA + React + 자체 CI. 대안 전환: 조직 표준 test platform 이 다른 runner(Jest/Cypress 등)를 강제하거나 CI 가 이 스택 미지원 시 runner 교체	raw/project-notes/ca-skeleton-frontend-operational-contract FE-D022; raw/official-docs/vite-build-tool-official.md#VITE-C1, #VITE-C2 (파이프라인 배경)	conditional-default (도구 선택은 project decision; 외부 doc 는 Vite 배경만 제공, Vitest 를 직접 말하지 않음)	5개 도구가 6개 test level 을 gap 없이 커버하는지 미검증; DOM 환경(jsdom vs happy-dom) 미확정
D2	gate 를 KIND별 단일 책임으로 분리하고 blocking scope(merge/release/prod-promotion/field/documentation) 명시; 통합 job 금지 (FE-OC-020)	이 조건: gate 들이 서로 다른 fixture/artifact/blocking scope 를 가질 때(§15.1 26-row 전부). 대안: 새 gate 가 기존 KIND 책임과 1:1 이면 별도 gate 가 아니라 그 row 의 superseding clarification 으로 병합	raw/project-notes/ca-skeleton-frontend-operational-contract §15.1 (26-gate matrix); FE-OC-020 normative summary	project-decision	26개 gate 가 실제 CI 에서 독립 실행 가능한지, 중복 없이 FE-OC 를 완전 분해하는지 미검증
D3	one-test-per-level + gate 당 ≥1 의도적 실패 negative fixture; rule 존재만으로는 evidence 불충분 (FE-OC-020)	불변식(분기 N/A) — gate 가 실제로 위반을 잡는다고 말하려면 negative fixture 가 실행돼야 하고(§15.2), level 이 realizable 하려면 대표 test 1개가 필요하므로 항상 요구	raw/project-notes/ca-skeleton-frontend-operational-contract §15.2 (negative fixture requirement); §20 measurable completion	project-decision (invariant)	negative fixture 가 "예상대로 실패" 하는지는 repository 생성 후에만 검증 가능
D4	gate 실패를 warning 으로 낮추지 않음; 선언된 scope 내 모든 gate 는 blocking, promotion 은 §15.3 formula 준수 (FE-OC-020)	불변식(분기 N/A) — MERGE_READY / RELEASE_READY / PROD_PROMOTION_READY / FIELD_SLO_READY / DOCUMENTATION_READY 각 단계는 지정 gate PASS 없이 통과 불가로 고정되어 downgrade 여지가 없음	raw/project-notes/ca-skeleton-frontend-operational-contract FE-OC-020 normative summary; §15.3 promotion formula	accepted-documented-only (invariant)	CI wiring 이 실제로 downgrade 를 막는지는 CI 계약 구현 후에 검증(위임 대상은 §Edge·Dependency 참조)
D5	공유 artifacts/ evidence-tree taxonomy(quality/tests/performance/security/release/runbooks); sibling gate 는 자체 트리 없이 여기에 machine-readable artifact 예치 (FE-OC-020, contributes FE-OC-021/FE-OC-025)	이 조건: gate 가 CI 에서 재사용 가능한 evidence 를 남겨야 할 때. 대안: script rename 은 허용하되 gate+artifact 매핑을 동시 갱신해야 함(§14.3 말미) — 매핑 갱신 없는 rename 금지	raw/project-notes/ca-skeleton-frontend-operational-contract §14 (planned artifact column); §4 (artifacts/ blueprint)	project-decision	artifact 포맷(JUnit XML / SARIF / JSON)이 실제 CI reporter 와 호환되는지 미검증
D6	이 branch 는 gate→test level / fixture KIND taxonomy 의 owner 다. gate→FE-OC coverage-mapping 과 gate 정의(blocking scope·pass condition·artifact)의 owner 는 hub §15.1 이고, gate 별 Owner 는 hub §2.1.1 이 확정한다 (FE-OC-020)	이 조건: 다수 sibling 이 test artifact 를 이 taxonomy 에 위임할 때(§20 contributes-to 8개 FE-OC). gate 추가/supersede 는 hub §15.1·§2.1.1 소관이며 본 branch 는 test-level 슬롯만 따라 갱신	raw/project-notes/ca-skeleton-frontend-operational-contract §15.1 서두("branch 는 이 표를 옮겨 적지 않는다"); §2.1.1 gate registry; §20 (contributes-to 매핑)	project-decision	매핑이 모든 FE-OC 의 test evidence 를 빠짐없이 덮는지는 coverage-auditor 가 별도 판정. 2026-07-21 정정 — 이전 판이 본 branch 를 coverage-mapping SSOT 로 적어 hub 와 Single-Owner 충돌이었다

구현 가이드

전 항목 planned — frontend repository 미생성. 경로/스크립트는 hub §14.3(planned commands)·§15.1(gate matrix)·§4.6(directory blueprint)에서 도출된 blueprint 이며 repo 생성 시 변경 가능.

1. Gate → test level / fixture-kind 매핑 (taxonomy core)

Trace: D2 + D3 + D5 + D6 · raw/project-notes/ca-skeleton-frontend-operational-contract §15.1 / §14.3 / FE-OC-020

• UNSUPPORTED_IMPL_DECISION: 없음 — 아래 표에서 본 branch 가 정하는 것은 Test level / KIND 열뿐이다. 나머지 열(blocking scope · Covered FE-OC · 필요 fixture 본문 · 증거 artifact · pass condition)은 hub §15.1 소유이며 옮겨 적지 않는다(§15.1: "branch 는 이 표를 옮겨 적지 않는다").

아래는 gate → test level taxonomy 다. 이전 판은 hub §15.1 의 blocking scope·fixture·artifact 열까지 복제했는데, 그 사본이 실제로 낡아 있었다(FE-GATE-013 에 dependency-review fixture 누락, FE-GATE-008 의 repeated guarded-route 한정어 소실). 그래서 정의 열은 전부 걷어내고 gate ID 참조만 남긴다.

Gate (raw/project-notes/ca-skeleton-frontend-operational-contract §15.1)	Test level / KIND (본 branch 소유)	Fixture 본문 owner
FE-GATE-001	manifest/lockfile	bootstrap-toolchain
FE-GATE-002	lint	architecture-enforcement
FE-GATE-003	typecheck-equivalent	bootstrap-toolchain + runtime-schema
FE-GATE-004	runtime-schema	runtime-schema-validation
FE-GATE-005	unit	api-client / boundary-mapper / contract-registry
FE-GATE-006	component	async-ui-state / render-recovery / browser-security(FE-OC-019 슬라이스)
FE-GATE-007	integration	api-client / error-classification / auth-session
FE-GATE-008	e2e	routing / auth-session / release-cache
FE-GATE-009	accessibility	accessibility-baseline
FE-GATE-010	architecture	architecture-enforcement
FE-GATE-011	build	build-bundle
FE-GATE-012	bundle	build-bundle / web-vitals
FE-GATE-013	security	build-bundle / browser-security
FE-GATE-020	sample-removal	sample-feature-slice

나머지 gate — FE-GATE-014..019, FE-GATE-021..026 — 도 hub §15.1 에 같은 형태로 등재돼 있고 fixture 본문·artifact 는 각 contract owner(release-cache / contract-compatibility / operational-runbook / web-vitals; FE-GATE-019 의 security-header 축 정책은 browser-security 공급) 소유다. 이 branch 는 그 row 들의 test-level 슬롯만 관리한다(D6).

2. Test-stack 도구 배정 per level

Trace: D1 · raw/project-notes/ca-skeleton-frontend-operational-contract FE-D022 / §14.3

• UNSUPPORTED_IMPL_DECISION: (a) DOM 환경 = jsdom 을 default 로 제안 — hub 는 Vitest+RTL 만 규정하고 환경을 명시하지 않음(trade-off: happy-dom 이 더 빠르나 Web API 커버리지 낮아 boundary/error 테스트 신뢰도 저하 위험). (b) integration 을 Vitest+jsdom+MSW 로 실행 — hub §14.3 는 test:integration=MSW matrix 만 말하고 runner 를 명시하지 않음(추론; 대안은 Playwright request-mocking).

Test level	도구	실행 환경	비고
runtime-schema	Vitest	node/jsdom	zod fixture 가 invalid 입력을 기대 kind 로 reject
unit	Vitest	node	retry fake-clock, mapper, registry 순수 로직(§15.1 FE-GATE-005)
component	Vitest + RTL	jsdom	async/success/empty/terminal-error state, render boundary, keyboard
integration	Vitest + MSW	jsdom	API status/failure/auth-recovery taxonomy (UNSUPPORTED: runner 추론)
e2e	Playwright	Chromium/Firefox/WebKit	boot/route/mutation/chunk-mismatch/redirect-pair(§14.1 FE-NFR-C02)
a11y	axe	Playwright 또는 component	critical/serious 0(FE-NFR-009) + manual checklist

3. Blocking scope + no-downgrade promotion 집행

Trace: D4 · raw/project-notes/ca-skeleton-frontend-operational-contract §15.3 / FE-OC-020

• UNSUPPORTED_IMPL_DECISION: 없음 — promotion formula 가 §15.3 verbatim 이라는 것은 곧 owner 가 §15.3 이라는 뜻이므로 tier→gate 집합을 복제하지 않는다.

taxonomy 가 강제하는 불변식:

• 각 gate 는 정확히 하나의 blocking scope 를 가지며(§15.1 Blocking scope 열), 실패 시 그 scope 를 blocking 한다. warning/soft-fail/continue-on-error 로 낮출 수 없다(FE-OC-020).
• promotion 은 tier→gate 집합으로 고정된다. 그 집합의 owner 는 raw/project-notes/ca-skeleton-frontend-operational-contract §15.3 이며 여기에 옮겨 적지 않는다 — hub 가 gate 를 추가·supersede 하면 복제본만 낡는다. tier 는 MERGE_READY → RELEASE_READY → PROD_PROMOTION_READY → FIELD_SLO_READY 의 누적 순서이고 DOCUMENTATION_READY 는 그와 직교한다.
• CI 에서 이 tier 배선을 실제로 실행/강제하는 것은 out of scope → raw/branch-notes/feature-frontend-ci-quality-gates-contract (FE-OC-020 공동 기여). 이 branch 는 no-downgrade 불변식만 소유하고, tier→gate 집합 자체는 hub §15.3 소유다(R3).

4. Negative-fixture 요구(taxonomy 레벨)

Trace: D3 · raw/project-notes/ca-skeleton-frontend-operational-contract §15.2 / FE-OC-020

• UNSUPPORTED_IMPL_DECISION: 없음 — §15.2 카탈로그 참조. 각 fixture "본문" 은 owner branch 소유(R3).

규칙: 모든 gate 는 최소 1개의 의도적으로 실패하는 fixture 를 실행해야 한다. rule 존재만 확인한 결과는 locally-verified 증거로 불충분(§15.2 말미). 대표 카탈로그(본문은 owner):

Gate	Negative fixture 예 (§15.2)
architecture	presentation 이 adapters/http 를 import
checkJs	application port 를 잘못된 shape 로 호출
runtime schema	data 없는 success envelope
retry	idempotency key 없는 POST 가 503 수신
storage	token key 등록 시도
telemetry	event 에 raw URL/query 포함
release	HTML build A + asset manifest B
reload guard	같은 release pair 에서 2번째 chunk 실패
lab performance	context metadata 누락 또는 named threshold 초과

failure 로 정규화되는 경계 fixture(§8.5)도 integration/runtime-schema gate 의 negative fixture 로 재사용: CONTENT_TYPE_MISMATCH, AUTH_INTEGRATION_FAILURE, RELEASE_MANIFEST_FAILURE, QUERY_CACHE_FAILURE, UNKNOWN_CLIENT_FAILURE, UNKNOWN_FAILURE — 단 기대 kind 정의는 error-classification owner 소유.

5. 공유 artifacts/ evidence-tree + one-test-per-level bootstrap

Trace: D5 + D3 · raw/project-notes/ca-skeleton-frontend-operational-contract §14.3 / §4.6

• UNSUPPORTED_IMPL_DECISION: artifact 포맷(test:* → JUnit XML, security → SARIF, performance/release → JSON)은 §14.3 가 확장자(.xml/.sarif/.json)만 규정 → 구체 스키마는 reporter 선택 시 결정(trade-off: JUnit XML 은 CI 호환 넓으나 표현력 낮음).

evidence-tree(§4.6 artifacts/ + §14.3 artifact 열):

artifacts/
  quality/     install.txt · lint.txt · check-types.txt
  tests/       runtime-schema.xml · unit.xml · component.xml · integration.xml · a11y.json · sample-removal.xml · e2e/
  performance/ bundle.json · lab.json · field-web-vitals.json
  security/    scan.sarif
  release/     build-manifest.json · verification.json · hosting-headers.json
  runbooks/    FE-RB-00N/<release-id>/record.json

one-test-per-level bootstrap(이 branch 가 직접 인도, sibling 의 full suite 와 구분): 각 level 에서 taxonomy 가 realizable 함을 증명하는 최소 대표 test 1개 —

• runtime-schema: 1개 valid + 1개 invalid envelope → 기대 결과 확인
• unit: fake-clock retry 1개(≤2 backoff)
• component: async state 4종(initial/success/empty/terminal-error) 1개 컴포넌트
• integration: MSW 로 1개 실패 status → normalized kind 1개
• e2e: boot → 1개 route 진입 smoke 1개
• a11y: 1개 sample route axe critical/serious 0

각 script 는 §14.3 pnpm test:* slot 에 매핑되고 위 artifact 경로로 결과를 남긴다. script rename 은 gate+artifact 매핑 동시 갱신 조건으로만 허용(§14.3, D5).

엣지·실패·의존

• 실패·엣지 경로:
  • gate 에 negative fixture 없이 rule 존재만 확인 → §15.2 위반, locally-verified 불충분(기대: taxonomy 가 그 gate 를 "unverified" 로 표시, promotion 미충족).
  • gate 실패가 warning 으로 downgrade → FE-OC-020 위반(기대: promotion formula 가 해당 tier 를 NOT_READY 로 유지).
  • 어떤 test level 에 대표 test 0개 → one-test-per-level 미충족(기대: taxonomy 불완전으로 merge 차단).
  • script rename 시 gate+artifact 매핑 미갱신 → §14.3 위반(기대: drift check 가 매핑 불일치 검출).
  • flaky e2e/perf gate → deterministic fixture(fake clock, recorded context metadata §14.1)로 강제; 비결정성은 gate 신뢰도 훼손이므로 taxonomy 는 결정적 fixture 를 요구.
• 다른 계약 의존:
  • raw/branch-notes/feature-frontend-project-bootstrap-toolchain-contract (FE-OC-003) — pnpm script host / engine 없이는 pnpm test:* 를 실행할 수 없음(§20 dependency). 그 계약의 script 명이 바뀌면 이 taxonomy 의 script→artifact 매핑도 갱신 필요.
  • raw/branch-notes/feature-frontend-ci-quality-gates-contract — CI orchestration/retention 이 이 taxonomy 를 consume; 그쪽 wiring 이 blocking 집행에 영향(FE-OC-020 공동).
  • fixture-content 의존(test level 슬롯은 본 branch, 본문은 owner): runtime-schema FE-OC-007 · error FE-OC-008 · architecture FE-OC-002 · build/bundle/security FE-OC-018 · browser-security 슬라이스 FE-OC-019 · performance FE-OC-021 · sample-removal FE-OC-024 · runbook FE-OC-025. 각 owner 의 fixture kind 가 바뀌면 본 branch 의 §1 taxonomy 표(D6)를 갱신한다 — hub §15.1 표는 hub 소유이므로 건드리지 않는다.

검증해야 할 주장

Claim	Why uncertain	How to verify	Status
Vitest+RTL+MSW+Playwright+axe 가 6개 test level 을 gap 없이 커버	repository 부재, 도구 조합 미실행	repo 생성 후 level 별 대표 test(pnpm test:runtime-schema/unit/component/integration/e2e/a11y) 실행(§14.3)	needs-confirmation
각 gate 의 negative fixture 가 "예상대로 실패"	rule 존재만으로 불충분(§15.2)	§15.2 카탈로그 fixture 를 실행해 기대 kind 로 실패하는지 확인	needs-confirmation
gate 실패가 CI 에서 warning 으로 downgrade 되지 않음	CI wiring 미구현(위임 대상)	CI 계약 구현 후 promotion formula(§15.3) 위반 시 tier NOT_READY 확인	planned
26-gate 매핑이 모든 FE-OC 의 test evidence 를 완전 분해	매핑 완전성 미검증	coverage-auditor + §15.1 Covered-FE-OC 대조	needs-confirmation
boot config ≤500ms / retry ≤2 / axe 0 등 NFR 임계 slot	값 owner 는 sibling, taxonomy 는 slot 만 hosting	각 gate 가 해당 NFR assertion 을 실행(§14.2 target + §14.3 command)	planned

관심사 커버리지 (coverage-auditor 자동 생성 — 있을 때)

관심사	상태	owner	심각도	근거

마주친 문제

• 없음 — 구현 착수 전(planned).

묶음 (이 branch에서 파생된 자료)

가져온 artifact 계약

Artifact Ref	Owner	Producer	Schema Ref
ART-FE-001@1	raw/branch-notes/feature-frontend-project-bootstrap-toolchain-contract	raw/branch-notes/feature-frontend-project-bootstrap-toolchain-contract	harness/source/artifact-schemas/ca-skeleton-frontend/build-manifest.schema.json
ART-FE-002@1	raw/branch-notes/feature-frontend-build-bundle-supply-chain-contract	raw/branch-notes/feature-frontend-build-bundle-supply-chain-contract	harness/source/artifact-schemas/ca-skeleton-frontend/bundle-report.schema.json
ART-FE-004@1	raw/branch-notes/feature-accessibility-baseline-contract	raw/branch-notes/feature-accessibility-baseline-contract	harness/source/artifact-schemas/ca-skeleton-frontend/a11y-report.schema.json

가져온 프로젝트 계약

Ref	Owner	요약	Branch 적용
FE-GATE-001@1	raw/branch-notes/feature-frontend-project-bootstrap-toolchain-contract	lockfile 이 manifest 와 어긋나면 merge·release 를 MUST 차단	import 참조로 적용
FE-GATE-002@1	raw/branch-notes/feature-frontend-architecture-enforcement-lint-contract	금지된 API·import 가 남아 있으면 merge 를 MUST 차단	import 참조로 적용
FE-GATE-003@1	raw/branch-notes/feature-frontend-project-bootstrap-toolchain-contract	production diagnostic 이 남아 있으면 merge 를 MUST 차단	import 참조로 적용
FE-GATE-004@1	raw/branch-notes/feature-runtime-schema-validation-contract	invalid fixture 가 예상 kind 로 거부되지 않으면 merge 를 MUST 차단	import 참조로 적용
FE-GATE-009@1	raw/branch-notes/feature-accessibility-baseline-contract	automated threshold 미달이거나 manual checklist 서명이 없으면 merge·release 를 MUST 차단	import 참조로 적용
FE-GATE-010@1	raw/branch-notes/feature-frontend-architecture-enforcement-lint-contract	금지된 layer import 가 통과하면 merge 를 MUST 차단	import 참조로 적용
FE-GATE-011@1	raw/branch-notes/feature-frontend-build-bundle-supply-chain-contract	clean production build 가 실패하거나 기대 artifact 가 없으면 merge·release 를 MUST 차단	import 참조로 적용
FE-GATE-012@1	raw/branch-notes/feature-frontend-build-bundle-supply-chain-contract	번들 NFR threshold 초과면 release 를 MUST 차단	import 참조로 적용
FE-GATE-013@1	raw/branch-notes/feature-frontend-build-bundle-supply-chain-contract	secret·vulnerability·license·dependency review 정책 위반이면 merge·release 를 MUST 차단	import 참조로 적용
FE-GATE-020@1	raw/branch-notes/feature-sample-feature-slice-contract-fixture	sample 제거 후 build·smoke 가 실패하면 merge·release 를 MUST 차단	import 참조로 적용
FE-OC-019@1	raw/branch-notes/feature-frontend-browser-security-boundary-contract	browser bundle에 secret을 넣지 않고 untrusted HTML injection을 기본 금지	import 참조로 적용
FE-OC-021@1	raw/branch-notes/feature-web-vitals-performance-budget-contract	NFR은 device/network/cache/build context와 함께 MUST 측정	import 참조로 적용
FE-OC-025@1	raw/branch-notes/feature-frontend-operational-runbook-contract	boot, chunk mismatch, API degradation, telemetry failure, rollback runbook을 MUST 유지	import 참조로 적용

Sub-branches (세부 작업)

• 없음 — 구현 착수 전.

오류 기록 (이 branch 작업 중 발생)

• 없음 — 구현 착수 전.

면접 준비 (이 작업에서 나올 수 있는 면접 질문)

• 없음 — 구현 착수 전.

강의 (이 작업을 위해 학습한 강의)

• 없음 — 구현 착수 전.

job-posting tie-ins (이 작업에서 파생된 글감)

• 없음 — 구현 착수 전.

관련 일일 노트

• 없음 — 구현 착수 전.

완료 후 정리

• PR 링크: TODO
• 리뷰 메모: TODO
• 머지 결과 / 배포 환경: TODO
• wiki 추출 대상: 없음 — 구현 착수 전(전부 planned).
• 추출하지 않을 항목: 현재 전 항목 planned — verified evidence 확보 전까지 추출 금지.