Kyeongmin/C.E.L_Slide_test2
1
0
Fork 0
Code Issues 6 Pull Requests Actions Packages Projects Releases Wiki Activity

docs(IMP-04): re-apply matrix clarifications after revert

Browse Source 
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)
This commit is contained in:
이경민
2026-05-13 10:21:52 +09:00
parent c807b2c56a
commit df9ee43d09
1 changed files with 48 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files

63
docs/architecture/IMP-04-FRAME-SUITABILITY-MATRIX.md
View File

@@ -66,12 +66,16 @@
## §2. ACTIVE 4 frames (이미 Phase Z 등록) ## §2. ACTIVE 4 frames (이미 Phase Z 등록)
| template_id | frame_id | fn | family / layout | builder | partial | > **Fix 1** (Codex #15345 — wording precision) : "ACTIVE" = catalog-registered /
|---|---|---|---|---|---| > runtime-active. *resource completeness (A+T+I+F+S 5 자원 보유) 와 별 axis*.
| `three_parallel_requirements` | 1171281190 | 13 | list / 3-column | `items_with_role` + `pillar_item` | `f13b` (157 lines) | > F13 (`three_parallel_requirements`) 는 ACTIVE 이지만 `assets/` 부재.
| `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) | | template_id | frame_id | fn | family / layout | builder | partial | resource status (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 안 씀) | |---|---|---|---|---|---|---|
| `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) ### 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 재사용 가능) 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 재사용) 4. `construction_bim_three_usage` (UAI=1, persona builder 재사용)
5. `bim_dx_comparison_table` (UAI=1, 새 builder — compare_table_2col) 5. `bim_dx_comparison_table` (UAI=1, *새 builder compare_table_2col*)
6. 잔여 11 reusable-now (V4 신호 0 — 단순 catalog 확보 목적, 진행 순서 임의) 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 ### 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 확인) : option (a/b/c) 결정 필요 (user 확인) :
- **(a)** figma_to_html agent 재실행 → 별 issue (IMP-04b "visual extraction") - **(a)** figma_to_html agent 재실행 → 별 issue (IMP-04b "visual extraction"). 32-frame scope 안.
- **(b)** analysis.md + texts.md 만으로 minimal CSS partial 작성 (시각 디테일 손실 인정) - **(b)** analysis.md + texts.md 만으로 minimal CSS partial 작성 — **main path X. explicit temporary placeholder 만 허용**. 시각 디테일 손실 인정.
- **(c)** 본 issue scope 외 — IMP-04b 로 분리, 본 issue 는 16 frame 만 활성 - **(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) ### Track C — Matching schema canonical decision (Codex #15340)