이전 commit (b127606) 의 문제 정정 :
- "박힘" / "박힌 axis" / "axis" 같은 세션 내부 표현 제거 → 평이한 한글 (단계 / 작업 / 정상으로 닫힘)
- 22-step Mermaid 의 그룹화 (Step 1-2, 3-4, 10-12, 15-19) 풀어서 각 단계 별도 박스
- 모든 라벨 한글로 통일 (영문 mix 제거)
- §1 에 핵심 용어 표 추가 — MDX / V4 / Phase Z / Frame / Internal Region /
Frame Slot 처음 보는 사람도 이해할 수 있도록 한 줄 설명
- §3 의 partial / missing 분류 표 제거 — STATUS-BOARD 참조 한 줄로 단순화
(22-step 진행 수준 표는 자주 갱신되어야 하는 문서, README 적합 X)
- §3 "박힌 axis (시간 순)" 섹션 제거 → CHANGE-LOG 참조 한 줄로 대체
내용 자체는 동일 (구조 / 로드맵 / 운영 원칙 / Mermaid 다이어그램 2 개).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
GitHub / Gitea 두 mirror 통합 README. Codex 안 채택 — 옛 AS-IS/TO-BE
(Phase Q~T) / "Phase Z 통합 설계" 섹션 폐기 (CHANGE-LOG.md 에 history 박힘).
구조:
1. 프로젝트 개요 — V4 / Phase Z / figma_to_html_agent 책임 분담
2. 전체 실행 구조 (22-step pipeline)
- Mermaid flowchart (decision diamond + Block A/B/C 그룹화)
- 22 step 텍스트 list (모든 step 명시)
- STATUS-BOARD.md 가 single source of truth (✅/⚠/❌)
3. 현재 완료 수준
- MDX03 PASS 결과
- 22-step 진행 수준 ≈ 65~70%
- 박힌 axis (시간 순) — Step 7-A/B / 8-A/B / 5 보완 / 6-A / 7-conn / 8-conn /
Step 9 v0 / F29 fix / cleanup-1
- 폐기된 안 history (compat 매트릭스 / 6-B frame ownership)
- 검증 sample 성격 (MDX 03/04/01/02 = 22-step 보완 수단)
4. 향후 로드맵
- Mermaid LR (7 단계)
- 단계별 상세 (frame 연결 / Phase Q audit / AI repair / DB / Front /
HTML 수정 / frame 지속)
5. 운영 기준
- 절대 lock (MDX 원문 보존 / 자유 디자인 금지 / 그릇 변경 / dropped)
- V4 ↔ Phase Z 책임 분담
- 렌더 정책 (rank-1 / rank 2~6 보존 / user_overrides)
+ Repository Mirrors (GitHub + Gitea)
+ 참고 문서 (CLAUDE / OVERVIEW / STATUS-BOARD / CHANGE-LOG / SPEC / ...)
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
- 무엇인가 → 구성/구현 → 문제점 → 개선 방향(AS-IS/TO-BE) → 현황 → 다음 단계
- 설계/계획 내용은 docs/architecture/ 문서로 분리 참조
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- 토큰 기반 CSS 체계 섹션 추가 (2층 구조, 글자 위계, 블록 작성 규칙)
- 스타일 폴더 구조 명시 (tokens/themes/base/blocks)
- 실행 원칙 추가 (direct-fit, recipe-path, fit 루프)
- Source of Truth 명시
- 설계 문서 링크 (IMPROVEMENT-PLAN, TOKENS-v1, BLOCK-RULES)
- 역할 분리 (figma_to_html_agent / design_agent)
- 향후 개선 방향을 진행 중/다음 단계로 분리
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- 현재 프로세스(AS-IS) 7단계 정리
- 개선 프로세스(TO-BE) 5단계 정리
- 핵심 차이: 꼭지 추출 시점, redesign 반복 조정, 빈 공간 재분배, 시각 검증
- 프로젝트 구조/산출물/향후 방향 포함
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
포함 내용:
- Phase P/Q/R/S 설계 문서 (IMPROVEMENT-PHASE-*.md)
- 영역별 검증 스크립트 (scripts/verify_*.py, test_*.py)
- 블록 템플릿 추가 (cards, emphasis 변형)
- 코드 수정: block_search, content_editor, design_director, slide_measurer
- catalog.yaml 블록 목록 업데이트
- CLAUDE.md, PROGRESS.md, README.md 업데이트
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Phase I: 전수 정합성 복구 + 넘침 처리 패러다임 전환 (14개 항목)
- I-14: SSE 유틸 공통 추출 (src/sse_utils.py 신규, 3개 파일 중복 제거)
- I-13: dead code 3건 삭제 (_call_anthropic_direct, _extract_sse_text x2) + import anthropic 제거
- I-1: STEP_B_PROMPT purpose 가이드 미존재 블록 3개 → 실존 블록 교체
- I-2: catalog.yaml not_for 13건 미존재 블록 참조 교체/제거
- I-12: BLOCK_SLOTS 주석 개수 수정 (cards 9, visuals 6, emphasis 10)
- I-10: INDEX.md 38개 동기화 (삭제된 8개 블록 행 제거)
- I-11: README.md 38개 동기화 (_legacy 제거, 트리/개수 정리)
- I-3: PURPOSE_FALLBACK 상수 + purpose 기반 미등록 블록 교체
- I-7: compare-pill-pair 단독 사용 금지 검증
- I-4: 38개 블록 전체에 slot_desc 추가
- I-5: 편집자 프롬프트에 slot_desc 전달 로직
- I-6: 제목 유사도 70% 초과 시 자동 교정
- I-9: 넘침 판단 Kei API 호출 (KEI_OVERFLOW_PROMPT, call_kei_overflow_judgment)
- I-8: 대형 콘텐츠 정보 Kei overflow 프롬프트에 포함
프로세스 재설계:
- Stage 2.5 제거 → Stage 5에서 Sonnet 감지 + Kei 판단 통합
- _review_balance() 확장: zone 예산 + overflow_detected action 추가
- Stage 5 루프에 Kei 넘침 판단 호출 통합
- _apply_adjustments()에 kei_trim/kei_restructure action 추가
- _build_overflow_context(), _convert_kei_judgment() 헬퍼 함수 추가
- DOWNGRADE_MAP은 Kei API 실패 시 비상용으로만 잔존
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- 5단계 파이프라인 상세 (Kei API/Opus/Sonnet 역할 구분)
- 블록 라이브러리 46개 (6 카테고리) 전체 목록
- FAISS 블록 검색 설명 + 인덱스 빌드 방법
- 레이아웃 프리셋 zone 예산 추가
- 기술 스택 단계별 AI 역할 구분
- 프로젝트 구조 전체 반영 (신규 파일 포함)
- 핵심 원칙 업데이트 (컨테이너 예산, grid 코드 결정 등)
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
