docs + V4 catalog + samples + Phase Q legacy 보존

전체 26 files (20 추가 + 6 수정), 10507 insertions.

Phase Z 문서 :
- docs/architecture/PHASE-Z-CHANGE-LOG.md (신설) — axis-by-axis 의사결정 history
  (newest-on-top). Step 7-A 부터 6 entry 박힘 + 2026-05-08 / 2026-05-08 #2
  (compat 매트릭스 폐기 / 6-B 폐기 / F14 표현 정정 / label gate policy 분리).
- docs/architecture/PHASE-Z-PIPELINE-OVERVIEW.md (수정) — Step 5/6/9 Gap note
  append (구조 무변, append-only). 6-B 폐기 사실 + Refinement F.
- docs/architecture/PHASE-Z-PIPELINE-STATUS-BOARD.md (수정) — snapshot date
  2026-05-08 갱신. §3 핵심 missing item 5 (Step 5/6/9 boundary axis breakdown
  + 폐기 기록). §6 한 줄 갱신 — 다음 axis 후보 A~F.

Project root docs :
- PLAN.md / PROGRESS.md / README.md (수정) — 토큰 체계 / 폴더 구조 / 설계 문서 /
  역할 분리 반영.
- IMPROVEMENT-REDESIGN.md (신설) — Phase Z 설계 핵심 문서.
- PROCESS_OVERVIEW.html (신설) — 파이프라인 개요 시각.
- docs/tasks/* (신설) — Phase Z task 문서.

V4 catalog (Phase Z runtime 필수 의존성) :
- tests/matching/v4_full32_result.yaml (신설, 4888 줄) — V4 매칭 결과 32 frame
  × 10 MDX section. lookup_v4_match() / lookup_v4_candidates() 가 본 파일 read.
  Phase Z runtime 이 *없으면 즉시 abort* — clone 후 즉시 동작 가능 보장.

Samples :
- samples/mdx_batch/04.mdx (신설) — MDX04 기본 sample.
- samples/mdx/04. DX 지연 요인.mdx (신설) — MDX04 원본.

Phase Q legacy 보존 (별 axis "Phase Q audit & salvage" 영역) :
- src/block_matcher_tfidf.py / catalog_blocks.py / frame_extractor.py /
  pipeline_v2.py — Phase Q (옛 파이프라인) src 신규 untracked 파일들.
  Phase Z runtime 와 의존성 0. Phase Q audit axis 에서 검토 예정.
- scripts/eval_block_matcher.py / fetch_all_frame_screenshots.py /
  match_17_units_my_matcher.py / match_mdx_strict.py / match_mdx_to_frames_tfidf.py /
  ocr_augment_texts.py / run_pipeline_v2.py / previews/ — Phase Q 작업 시
  사용한 옛 script. 같이 보존.
- run_mdx03_pipeline.py (수정) — Phase Q 진입점 (no flag) + Phase Z 진입점
  (--phase-z2 flag) 동시 wrapper. Phase Z 만 사용 시 `python -m
  src.phase_z2_pipeline samples/mdx_batch/03.mdx <run_id>` 직접 호출.

비-scope :
- tests/matching/ (v4_full32_result.yaml 외 ~63MB) — V4 진화 history /
  reports / DECK / ATTACH. Phase Q audit axis 에서 검토.
- tests/pipeline/ (~15MB) — pipeline data. Phase Q audit 영역.
- templates/catalog/blocks.yaml — 옛 block catalog. Phase Q audit.
- templates/phase_z2/frames/ — 옛 frame partial 위치. Phase Q audit.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

PROGRESS.md

@@ -154,6 +154,15 @@ Phase R은 접근 C로 가기로 합의했으나, 구현에서 기존 블록 선
 
 ## 📋 Phase R': 접근 C — 블록 CSS 참고 + AI 구조 결정 (설계 확정)
 
+> ⚠️ **Legacy — Phase Z 로 대체됨 (2026-04-28)**
+>
+> Phase R' 의 "AI 가 HTML 구조를 직접 생성" 흐름은 Phase Z 에서 다음과 같이 변경됨:
+> - **HTML 구조** = `slide-base.html` + 코드 (Jinja2) 가 결정 (AI 가 생성하지 않음)
+> - **AI 의 역할** = zone 안의 콘텐츠 / 텍스트 매핑 / 텍스트 다듬기 / 디자인 변형만
+> - **자유 디자인 금지** — 항상 Figma 프레임 DB 참고
+>
+> 아래 R' 설계 내용은 히스토리 / 참고용. 실제 구현은 [`IMPROVEMENT-REDESIGN.md`](IMPROVEMENT-REDESIGN.md) 의 5 단계 흐름 따름.
+
 **상세:** [IMPROVEMENT-PHASE-R-PRIME.md](IMPROVEMENT-PHASE-R-PRIME.md)
 
 ### 핵심 전환
@@ -165,6 +174,8 @@ R' (접근 C):   콘텐츠가 구조를 결정 → 블록 CSS를 참고하여 HT
 
 ### 프로세스 변경
 
+> ⚠️ **아래 표는 폐기된 Phase R' 기록이며 신규 구현 지시가 아니다.** 새 구현은 [IMPROVEMENT-REDESIGN.md](IMPROVEMENT-REDESIGN.md) 의 Phase Z 5 단계 흐름 따름.
+
 | 단계 | 현재 (P=Q=R) | R' (접근 C) |
 |------|-------------|------------|
 | 1단계 Kei 분석 | 유지 | 유지 |
@@ -213,15 +224,115 @@ C_reference.png와 동일 수준의 결과를 **자동으로** 생성:
 
 ---
 
+## Phase Z: 매칭 시스템 통합 설계 (2026-04-28)
+
+### 배경
+별도 검증한 매칭 시스템 (V1~V4) 을 기존 design_agent pipeline 에 통합하기 위한 설계.
+
+**매칭 시스템 (`tests/matching/`) 검증 결과**:
+- V1 키워드 매칭 (Logistic Regression 가중치, TARGET 4/4 LOOCV 검증)
+- V2 의미 매칭 (ko-sroberta cosine)
+- V3 구조 매칭 (layout / content_affinity / structure_intent)
+- V4 종합 판정 (5축 + 라벨)
+- TARGET 정답률 3/4 (75%), BM25 / IDF 보다 우위
+- V4 slot 축 ablation: Top-1 매칭 7/7 동일 (slot 축 frame 선별 무영향)
+
+### 설계 결정 사항
+
+**위계 + 용어 정리** :
+```
+[ slide ] 1280×720
+   ├─ slide-title           ← MDX 대목차 제목
+   ├─ slide-divider         (고정)
+   ├─ slide-body ≈ 1200×590 ← 콘텐츠 영역
+   │     └─ 레이아웃 (Type A/B/B'/B'')
+   │           └─ Zone (top/bottom_l/bottom_r 등)
+   │                 └─ 프레임 (Figma 디자인 단위)
+   └─ slide-footer          ← MDX 대목차 결론
+```
+
+**5 단계 새 흐름**:
+1. STAGE 1 — MDX 분석 + 레이아웃 매칭 (Type A/B/B'/B'')
+2. STAGE 2 — Zone 별 텍스트 1차 배치
+3. STAGE 3 — Zone 별 프레임 매칭 (완벽 / 어정쩡 / 안 됨 분기)
+4. STAGE 4 — 프레임 검토 + 컨테이너 조정 (5 차 Fallback)
+5. STAGE 5 — HTML 조립 + 검증 + 출력
+
+**핵심 원칙**:
+- MDX 1 파일 = 대목차 1 개 = 슬라이드 1 장
+- 텍스트 원문 무손실 보존 (본문 미리보기 + 팝업 원문)
+- 자유 디자인 금지 (항상 Figma 프레임 DB 참고)
+- 불일치 시 레이아웃 회귀 (콘텐츠 줄이지 않고 그릇 변경)
+
+### 산출물 (이번 세션)
+
+| 파일 | 용도 |
+|---|---|
+| [`IMPROVEMENT-REDESIGN.md`](IMPROVEMENT-REDESIGN.md) | 매칭 시스템 통합 설계 문서 (전체 명세) |
+| [`PROCESS_OVERVIEW.html`](PROCESS_OVERVIEW.html) | 임원 보고용 A4 2 페이지 (프로세스 + 구조도) |
+| [`tests/PIPELINE.md`](tests/PIPELINE.md) | V1~V4 통합 정리 + frame 단위 명확화 |
+| [`tests/pipeline/`](tests/pipeline/) | 매칭 시스템 코드 + 결과 + 보고서 (분류 복사본) |
+
+### 다음 단계 (구현)
+
+`IMPROVEMENT-REDESIGN.md` 의 **단계적 진행 계획** 참조.
+- **Phase Z-1**: 통합 prototype (MDX 03 회귀 통과)
+- **Phase Z-2**: 매칭 + 프리셋 통합
+- **Phase Z-3**: 컨테이너 검증 + Fallback
+- **Phase Z-4**: 전체 통합 + 검증
+
+### 발견된 약점 (8가지) — Phase Z 진행 시 대응
+
+`IMPROVEMENT-REDESIGN.md` 11 장 (리스크) + `tests/PROGRESS.md` 약점 표 참조.
+
+핵심 :
+- 02-2.2 매칭 실패 (Frame 14 anchor 재라벨링 필요)
+- 32 frame DB 사이즈 라벨링 부족 (zone 단위 vs 슬라이드 단위)
+- slot 의미 매핑 부재
+- V3 콘텐츠 성격 분류 부정확 (키워드 사전 한계)
+
+---
+
+## Phase Z-1 사전 작업 진행 (2026-04-28)
+
+> **Phase Z-1 자체는 진행 중**. 본 entry 는 사전 작업 중 **Frame / Style Inventory 완료** 만 기록.
+
+### ✅ 완료 — Frame / Style Inventory (사전 작업 일부)
+
+| 산출 | 위치 | 내용 |
+|---|---|---|
+| Frame Integration Map | [`docs/architecture/FRAME-INTEGRATION-MAP.md`](docs/architecture/FRAME-INTEGRATION-MAP.md) | 32 frame Zone 적용 분류 (`zone_direct` / `zone_adapt` / `zone_extract` / `reference_only`). row 21~28 Figma ID 정정. 1171281171 부록 처리 |
+| Frame Style Inventory | [`docs/architecture/PHASE-Z-FRAME-STYLE-INVENTORY.md`](docs/architecture/PHASE-Z-FRAME-STYLE-INVENTORY.md) | 32 frame (변환 14 + 미변환 18) + Token 18 행 (covered 7 / gap 5 / hierarchy 3 / hold 3) + Legacy 6 행 |
+
+### ⬜ 다음 — Phase Z-2 본격 (catalog / runtime 설계)
+
+- Phase Z-1 의 catalog / runtime 설계 prep 부분 (slide-base 검증 등) 은 미진행
+- Phase Z-2 본격 (매칭 + 4 프리셋 통합) 도 미진행
+
+### ⚠️ 미실행 / 의도적으로 보류
+
+- 기존 `templates/blocks/` 삭제 / 교체 실행
+- catalog / runtime 구현
+- `templates/styles/frame-patterns/` 신규 파일 생성
+- `templates/styles/tokens/` 의 `gap_candidate` token 추가
+- legacy structures 6 파일 삭제
+
+→ 모두 **승인 전 보류**. Frame / Style Inventory 는 추출 / 검증 단계이고, 실제 변경은 별도 승인 단계.
+
+---
+
 ## 프로젝트 구조
 
 | 항목 | 파일 | 상태 |
 |------|------|------|
-| 프로젝트 규칙 | CLAUDE.md | Phase R' 반영 |
-| 개선 계획 | IMPROVEMENT.md | Phase R' 반영 |
-| 진행 추적 | PROGRESS.md | 이 파일 (2026-03-30 갱신) |
+| 프로젝트 규칙 | CLAUDE.md | Phase Z 반영 (2026-04-28) |
+| 개선 계획 (이전) | IMPROVEMENT.md | Phase R' 반영 |
+| **개선 계획 (신규)** | **IMPROVEMENT-REDESIGN.md** | **Phase Z 매칭 시스템 통합 (2026-04-28)** |
+| 임원 보고용 | PROCESS_OVERVIEW.html | Phase Z 흐름 반영 |
+| 진행 추적 | PROGRESS.md | 이 파일 (2026-04-28 갱신) |
 | 전체 감사 | CLEANUP-AUDIT.md | 유효/무력화 분류 완료 |
 | Phase별 상세 | IMPROVEMENT-PHASE-{A~R'}.md | 각 Phase 기록 |
 | Phase R 실패 기록 | IMPROVEMENT-PHASE-R.md | 블록 선택 위에 variant 패치 — 실패 |
 | Phase R' 설계 | IMPROVEMENT-PHASE-R-PRIME.md | 접근 C 기반 재설계 |
-| README | README.md | Phase R' 반영 |
+| 매칭 시스템 (별도 검증) | tests/PIPELINE.md + tests/pipeline/ | V1~V4 검증 완료 (2026-04-27) |
+| README | README.md | Phase Z 반영 |