docs(IMP-04): adopt 3-layer architecture + 4-class failure taxonomy
Wording-only matrix clarification per Codex #15477 architecture
correction + #15485 acceptance + Claude rounds 32/34 agreement.
Two foundational changes :
1. New §0 — Architecture context (3-layer)
- V4 = matching basis / design-selection authority
- figma_to_html = rich source/evidence layer (visual hierarchy,
assets, layer structure, geometry, source intent, provenance)
- Phase Z = runtime orchestration / assembly / recovery layer
(consumes V4 candidates + source evidence; does NOT replace V4
as the matching authority)
- Explicit correction: earlier "Phase Z = execution SoT" framing
was a 2-layer dichotomy that conflated matching authority (V4)
with runtime execution (Phase Z). 3-layer is the correct
architecture.
2. Fix 7 in §4.1 — 4-class failure taxonomy as primary
- Replaces F1/F2/F3 as the primary technical failure
classification. F1/F2/F3 remain only as secondary review /
process severity labels.
- 4 classes (Codex #15477) :
- class 1: adapter/runtime readiness (partial/asset/slot/
contract missing — V4 ranking stays valid)
- class 2: content-fit issue (overflow / light edit needed)
- class 3: V4 ↔ figma_to_html mapping issue (metadata wrong)
- class 4: popup/secondary content routing case
- Prior-history reclassification documented :
- 556b448 minimum viable persona — class 1
- 2fcd8bb strict CSS-only refinement — class 2
- a1c06b7 MDX02 chain dependency — class 1 (construction_goals
catalog readiness, NOT V4 logic issue)
- Round 26 "Phase Z = 실행 SoT" framing — wording error
No source code, runtime catalog, builder, partial, V4 evidence,
mapper, or composition planner changes. Documentation clarification
only.
History preserved : previous commits stand. This is a forward-only
clarification, not a rewrite of past commit messages.
Refs Gitea #4 (IMP-04 — architecture wording fix, 3-layer + 4-class)
kyeongmin
46e9db30b2