diff --git a/docs/architecture/IMP-04-FRAME-SUITABILITY-MATRIX.md b/docs/architecture/IMP-04-FRAME-SUITABILITY-MATRIX.md index bfb1038..f939a72 100644 --- a/docs/architecture/IMP-04-FRAME-SUITABILITY-MATRIX.md +++ b/docs/architecture/IMP-04-FRAME-SUITABILITY-MATRIX.md @@ -66,12 +66,16 @@ ## §2. ACTIVE 4 frames (이미 Phase Z 등록) -| template_id | frame_id | fn | family / layout | builder | partial | -|---|---|---|---|---|---| -| `three_parallel_requirements` | 1171281190 | 13 | list / 3-column | `items_with_role` + `pillar_item` | `f13b` (157 lines) | -| `process_product_two_way` | 1171281210 | 29 | compare / banner-top-2col-bottom | `process_product_pair` | `f29b` (294 lines) | -| `bim_issues_quadrant_four` | 1171281193 | 16 | cards / quadrant-4 | `quadrant_flat_slots` + `quadrant_item` | `f16b` (223 lines) | -| `three_persona_benefits` | 1171281191 | 14 | cards / persona-3col | `items_with_role` + `quadrant_item` | `f14b` (110 lines, **refinement 필요** — index.html base 안 씀) | +> **Fix 1** (Codex #15345 — wording precision) : "ACTIVE" = catalog-registered / +> runtime-active. *resource completeness (A+T+I+F+S 5 자원 보유) 와 별 axis*. +> F13 (`three_parallel_requirements`) 는 ACTIVE 이지만 `assets/` 부재. + +| template_id | frame_id | fn | family / layout | builder | partial | resource status (A/T/I/F/S) | +|---|---|---|---|---|---|---| +| `three_parallel_requirements` | 1171281190 | 13 | list / 3-column | `items_with_role` + `pillar_item` | `f13b` (157 lines) | A T I F **−** (assets 부재) | +| `process_product_two_way` | 1171281210 | 29 | compare / banner-top-2col-bottom | `process_product_pair` | `f29b` (294 lines) | A T I F S | +| `bim_issues_quadrant_four` | 1171281193 | 16 | cards / quadrant-4 | `quadrant_flat_slots` + `quadrant_item` | `f16b` (223 lines) | A T I F S | +| `three_persona_benefits` | 1171281191 | 14 | cards / persona-3col | `items_with_role` + `quadrant_item` | `f14b` (110 lines, **refinement 필요** — index.html base 안 씀) | A T I F S | --- @@ -127,24 +131,53 @@ ### Track A — Visual activation (16 reusable-now + 1 active refinement) -priority 진행 순서 (자체 추천 — V4 신호 ↑ 순서) : +> **Fix 4** (Codex #15345 — Track A priority wording) : 본 priority 순서 = +> **execution ordering only. scope filter X**. *all 16 reusable-now frames 활성 +> 대상*. V4 신호 약한 11 frame 도 모두 포함. builder family grouping 도 *secondary +> ordering* (Codex 허용 — 단 first refinement 의 calibration 결과 이후, 새 hidden +> filter 화 절대 X). -1. **`three_persona_benefits` refinement** (active 1, V4 use_as_is=1) — index.html base 재작성 +priority 진행 순서 (자체 추천 — V4 신호 ↑ 우선, builder 재사용 grouping 보조) : + +1. **`three_persona_benefits` refinement** (active 1, V4 use_as_is=1) — index.html base 재작성. **first refinement = calibration point** 2. `dx_sw_necessity_three_perspectives` (LE=2 가장 높음, persona builder 재사용 가능) -3. `construction_goals_three_circle_intersection` (UAI=1+LE=1+RS=1, V4 신호 강함, 단 새 builder 필요 — cycle-intersect) +3. `construction_goals_three_circle_intersection` (UAI=1+LE=1+RS=1, *새 builder cycle-intersect-3*) 4. `construction_bim_three_usage` (UAI=1, persona builder 재사용) -5. `bim_dx_comparison_table` (UAI=1, 새 builder — compare_table_2col) -6. 잔여 11 reusable-now (V4 신호 0 — 단순 catalog 확보 목적, 진행 순서 임의) +5. `bim_dx_comparison_table` (UAI=1, *새 builder compare_table_2col*) +6. 잔여 11 reusable-now (V4 신호 0 — catalog 확보 목적, builder 재사용 grouping 으로 ordering 가능) + +> **Fix 5** (Codex #15345 — review granularity 명시) : +> - **첫 refinement** = Codex review 필수 +> - **새 builder pattern** 도입 frame = Codex review 필수 +> - **ambiguous mapping** frame = Codex review 필수 +> - **shared catalog/builder logic** 영향 frame = Codex review 필수 +> - **low-risk repeated** (proven builder, 단순 catalog entry) = small grouped commit 허용 (단 pattern proven 후) +> +> **Fix 6** (자체 catch 1, Codex #15371 — Calibration failure modes) : first +> refinement 의 Codex review 에서 issue 발견 시 escalation path : +> - **F1 — small styling/wording issue** : `index.html`-base approach valid, detail correction 만 필요 → *same-frame follow-up commit* + Codex re-review. +> - **F2 — approach-level problem** : Phase Z geometry/runtime 와 fit 안 됨, raster/CSS/min-height rule 재정의 필요 → *Track A pause* → *approach re-lock round* → retry refinement. +> - **F3 — scope/resource problem** : figma_to_html output 부재 / visual-resource assumption 잘못 → *scope/resource axis reopen* → IMP-04b route 가능, *bulk activation 차단*. +> +> F1/F2/F3 = review escalation guide. *first refinement 차단 gate 아님*. trigger source = 보통 Codex review (Claude self-trigger 도 가능). ### Track B — visual-pending 12 frames +> **Fix 2** (Codex #15345 — Track B wording 강화) : Track B 는 **exclusion / discard / +> scope reduction 아님**. visual-resource-pending 안 *32-frame scope 보존*. visual- +> resource 확보 *시점* 만 다른 별 axis. +> +> **Fix 3** (Codex #15345 — option (b) guard) : option (b) (minimal CSS) 는 **main +> path X, explicit temporary placeholder 만**. frame 1 사례와 같은 quality failure +> 위험. + option (a/b/c) 결정 필요 (user 확인) : -- **(a)** figma_to_html agent 재실행 → 별 issue (IMP-04b "visual extraction") -- **(b)** analysis.md + texts.md 만으로 minimal CSS partial 작성 (시각 디테일 손실 인정) -- **(c)** 본 issue scope 외 — IMP-04b 로 분리, 본 issue 는 16 frame 만 활성 +- **(a)** figma_to_html agent 재실행 → 별 issue (IMP-04b "visual extraction"). 32-frame scope 안. +- **(b)** analysis.md + texts.md 만으로 minimal CSS partial 작성 — **main path X. explicit temporary placeholder 만 허용**. 시각 디테일 손실 인정. +- **(c)** 본 issue 의 *즉시 활성* = 16 frame. 12 frame 은 IMP-04b 별 axis 에서 *visual base 확보 후* 활성. **32-frame scope 보존**. -자체 추천 = **(c)** — 본 issue 는 *visual base 있는 frame* 만 활성. 12 missing 은 별 axis. scope 명확 + 진행 속도 ↑. +자체 추천 = **(c)** — 32-frame scope 보존 + Track A 진행 속도 ↑ + Track B 의 visual extraction 작업과 분리. ### Track C — Matching schema canonical decision (Codex #15340)