From df9ee43d09b27515c4ef59beb698849c06774c9c Mon Sep 17 00:00:00 2001 From: kyeongmin Date: Wed, 13 May 2026 10:21:52 +0900 Subject: [PATCH] docs(IMP-04): re-apply matrix clarifications after revert MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Re-apply the W1 wording clarifications previously agreed in the comment thread. The originally executed wording commit `6d33884` was reverted by Codex via `c807b2c` after Codex acknowledged that `ㄱ` for both Claude and Codex is comment-only review (no source/doc edit). Both sides 100% agreement is restored via Claude rounds 16/17/19 and Codex rounds 15/18. This Claude-applied commit is the agreed re-application path (option A). Six fixes applied to docs/architecture/IMP-04-FRAME-SUITABILITY-MATRIX.md : 1. §2 ACTIVE 4 frames table : add resource status (A/T/I/F/S) column. F13 has no `assets/` directory (marked `-`). State that ACTIVE means catalog-registered / runtime-active, not necessarily A+T+I+F+S resource-complete. 2. §4 Track B : strengthen wording. Track B = visual-resource-pending inside the 32-frame scope, **NOT exclusion / discard / scope reduction**. Visual-resource acquisition timing is the only difference. 3. §4 Track B option (b) : minimal CSS partial from analysis/texts only is **main path X, explicit temporary placeholder only**. Avoids the frame 1 (`three_persona_benefits` 556b448) quality failure pattern. 4. §4.1 Track A priority : **execution ordering only, NOT scope filter**. All 16 reusable-now frames remain activation targets. V4-weak 11 frames stay in scope. Builder family grouping = secondary ordering allowed after first refinement calibration. 5. §4.1 Codex review granularity explicit : first refinement, new builder pattern, ambiguous mapping, shared catalog/builder logic = Codex review mandatory. Low-risk repeated frames may be grouped only after pattern is proven. 6. §4.1 calibration failure modes F1/F2/F3 (Claude round 14 catch + Codex round 15 (a) accepted) : - F1 small styling/wording issue -> same-frame follow-up commit + Codex re-review. - F2 approach-level problem -> pause Track A, approach re-lock round, retry refinement. - F3 scope/resource problem -> reopen scope/resource axis, possibly IMP-04b, block bulk activation until resolved. History trace : `fe766f1` (matrix base) -> `6d33884` (Codex W1 execute, wrong workflow) -> `c807b2c` (Codex revert + workflow lock symmetric) -> this commit (Claude re-apply under user execution signal, option A). History noise retained as honest trace of the corrected ㄱ definition. No source code changes. Documentation clarification only. Refs Gitea #4 (IMP-04 — matrix wording re-application post-revert) --- .../IMP-04-FRAME-SUITABILITY-MATRIX.md | 63 ++++++++++++++----- 1 file changed, 48 insertions(+), 15 deletions(-) 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)