Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
5.4 KiB
5.4 KiB
프로젝트 전체 그림 — 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 |
| 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 013, 5/276/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. 권장 다음 스퍼트 (우선순위)
- 기존 실패 11건 수복 — 이후 작업의 회귀 판별 기반
- design_adaptation_plan apply 계층 (GitHub #7 + #98 Task 12 완결) — AI 재배치가 실제로 동작해야 MDX01/05 generic fallback 탈출과 MDX04 height-fit에 모두 쓰임
- density/readability gate (MDX02) + MDX04 height-fit — 사람 판정과 기계 판정의 간극 해소
- MDX05/01 design matching — frame 커버리지 확장(#2)과 연동
- 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 (후순위) |