# 프로젝트 전체 그림 — 2026-07-03 종합

> 근거: Gitea C.E.L_Slide_test2 이슈 #43~#98 (56건) + #98 코멘트 95개 전문 (5/27~6/4)
> + repo 문서/코드 실측 + GitHub keimin86/design_agent 이슈 #1~#12 처리 결과.

## 1. 연대기 (무엇이 언제 일어났나)

| 시기 | 축 | 내용 |
|---|---|---|
| ~4월 | 기반 구축 | Phase 1~5/T/V: 블록 46개, renderer, 적합성 검증 (31/31). figma_to_html_agent 완성 (32 frame 변환, 8개 promoted) |
| 4월 말 | 매칭 시스템 | tests/matching V1~V4 구축. **TARGET 4/4** (v4_full32, 4/29) — 문서의 "3/4"는 낡은 기록 |
| 5월 | IMP wave | Gitea #43~#95: overflow chain(IMP-34/35/36), AI fallback 실선화(IMP-33/46/47B), 사용자 편집·영속(IMP-51/52/54/90), Layer A(#89→94/95/96 분할) 등 50건 closed |
| 5/26 | Emergency | mdx 01~05 empty shell 발생 → root cause 3개(C1/C2/C3) 진단, P2~P5 정책 확정 (emergency.md) |
| 5/27~6/4 | **#98 E2E 스퍼트** | Task 0~13으로 사용자 체감 품질 복구 (아래 §2). 로컬 수정만, 커밋 없이 중단 |
| 6/4~7/2 | 공백 | 미커밋 상태로 방치 (다른 프로젝트 작업) |
| 7/2~3 | 보존+정리 | 스냅샷 커밋 b836e79 push. GitHub 이슈 12건 등록, 5건 처리 (#1,#4,#9,#10,#12) |

## 2. #98 스퍼트가 이룬 것 (Task 0~13, 5/27~6/4)

달성 (모든 mdx): 텍스트 손실 0 (missing_atoms=0) / section 순서·분리 보존 /
`__empty__` zone 제거 / markdown 문법 노출 제거 / clean generate (--ignore-user-overrides) /
false PASS 차단 / stale overlay 제거 / AI trace 관측성.

**6/4 최종 5-MDX presentation readiness** (마지막 코멘트 30028):

| MDX | 기계 판정 | 사람 판정 | 남은 문제 |
|---|---|---|---|
| 01 | PASS | needs_review | generic fallback (intro), bottom dense |
| 02 | PASS | **needs_review** | **false-positive 최악** — 카드 cramped, density gate 없음 |
| 03 | PASS | ready | 유일한 design-matched ✓ |
| 04 | VISUAL_REGRESSION | not_ready | overflow 실재 (honest fail) — height-fit 필요 |
| 05 | PASS | needs_review | 양쪽 zone generic fallback — design matching 필요 |

## 3. 7/2~3 세션이 추가로 해결한 것

- **#12**: SlideCanvas.tsx 한글 손상 복구 (ad10657)
- **#9-P4**: AI proposal envelope 버그 — #98 Task 12가 남긴 "AI 호출되나 no_proposal" 문제의 근본 원인이 envelope 미명시였음을 확인·수정 (9717898). 이제 design_adaptation_plan이 **검증 통과** (apply 계층만 미구현)
- **#10**: V4 evidence trace가 P4b 복구 경로에서 유실되던 것 수정 (d75c063) — Gitea #95(89-c)의 실질 마무리
- 전제가 낡은 이슈 정정: #1 (변환기 이미 push됨), #4 (TARGET 이미 4/4)
- 발견: tests/phase_z2 기존 실패 11건 (layout cols / fixtures / imp88 salvage / step17 — #98 스퍼트의 WIP 잔재로 추정)

## 4. 남은 갭 — 목표 축별 정리

### 목표 A: Figma→HTML 정확 변환
- frame 커버리지 8/32 promoted — 매칭 성공해도 partial 없어 못 그리는 frame 존재 (GitHub #2)
- **MDX01/05 generic fallback 탈출이 이 축의 실전 과제** — catalog matching 개선 또는 AI adaptation (#98 추천 4번)
- provenance 손실 (GitHub #3, P3)

### 목표 B: 콘텐츠 의미 → HTML 반영
- **design_adaptation_plan apply 계층 미구현** — proposal 검증까지 도달, 적용만 남음 (GitHub #7과 통합, #98 Task 12의 완결)
- T25 node_slot_mapping runtime 배선 (GitHub #7)
- 분류 LLM화 (GitHub #5), V4 가중치 재조정 (GitHub #6) — 방법론 개선, 후순위

### 목표 C: 품질 게이트 신뢰성 (#98이 남긴 최우선)
- **density/readability gate** — MDX02 false-positive 차단 (#98 추천 1·2번)
- **MDX04 height-fit escalation** — overflow 해소 (#98 추천 3번)
- readiness 신호 통합 (text coverage + design_readiness + density)
- popup/details live fixture (#98 추천 5번)
- 기존 테스트 실패 11건 수복

### 인프라 큐 (Gitea #97 Queue Tracker, paused 5/26)
- P0: #91 multi-sample regression CI → #71 진단 도구 → #73 mismatch warning → …
- 열린 축: #55 (contract validator, deferred), #66 (IMP-37 stage0 normalizer ★), #83 (AI 결과 자산화, Future), #96 (89-d marker)

## 5. 권장 다음 스퍼트 (우선순위)

1. **기존 실패 11건 수복** — 이후 작업의 회귀 판별 기반
2. **design_adaptation_plan apply 계층** (GitHub #7 + #98 Task 12 완결) — AI 재배치가 실제로 동작해야 MDX01/05 generic fallback 탈출과 MDX04 height-fit에 모두 쓰임
3. **density/readability gate** (MDX02) + **MDX04 height-fit** — 사람 판정과 기계 판정의 간극 해소
4. **MDX05/01 design matching** — frame 커버리지 확장(#2)과 연동
5. Gitea #91 (regression CI) — 위 작업들의 안전망 자동화

## 6. 이슈 트래커 대응표

| GitHub (7/2 등록) | Gitea 대응 | 상태 |
|---|---|---|
| #1 변환기 통합 | — | closed (전제 낡음) |
| #4 02-2.2 교정 | — | closed (이미 4/4) |
| #9 Emergency P2~P5 | emergency.md, #98 Task 10 | closed (P4 수정 완료) |
| #10 V4 evidence 배선 | #95 (89-c) | closed (trace 유실 수정) |
| #12 인코딩 복구 | — | closed |
| #7 슬롯 매핑+apply | #98 Task 12, #83 선행 | **open — 다음 핵심** |
| #2 frame 32개 완성 | #98 추천 4 (design matching) | open |
| #11 trace 계약 검증 | #98 Task 6/7 (구현됨 — 검증만) | open (경량화 가능) |
| #5, #6, #8, #3 | 방법론/보강 | open (후순위) |