Add Stage 1 docs, run-001 artifacts, and no-Kei bridge

docs/run-001/04-plan/execution-plan.md

@@ -0,0 +1,100 @@
+# Execution Plan
+
+## Run
+- run id: `run-001`
+- input: `01. 건설산업 DX의 올바른 이해(0127).mdx`
+- planning basis: `Wiki-2-4` and `Wiki-3` series
+
+## Planning Summary
+이번 작업은 `DX와 BIM의 관계를 오해 없이 설명하는 1장 슬라이드`를 목표로 한다.
+실행은 `Phase T` 상세 파이프라인을 기준으로 하되, 초기 해석 단계는 이미 run 폴더에 기록된 문서 기반 결과를 우선 사용하고, 후반부의 계산/생성/검증/렌더는 기존 `design_agent` 코드 자산을 활용하는 방식으로 계획한다.
+
+## Stage Plan
+
+### Stage 0 입력 로드 및 MDX 정규화
+- 목표: 원문 MDX를 후속 stage가 다루기 쉬운 형태로 정리한다.
+- 입력: `01-input/01. 건설산업 DX의 올바른 이해(0127).mdx`
+- 산출물: 정규화된 본문 또는 정규화 메모
+- 검증: 핵심 섹션 `문제 제기`, `용어 정의`, `상호관계`, `핵심 요약`이 유지되어야 한다.
+- 비고: 필요 시 현재 `html_generator.py`의 정규화 방향을 참고한다.
+
+### Stage 1A Topic Extraction
+- 목표: 주요 topic과 relation_type 초안을 명확히 한다.
+- 입력: 원문 MDX + `02-kei-interpretation/kei-interpretation.md`
+- 산출물: topic 목록, relation, expression_hint 초안, source_data 초안
+- 검증: `혼용 문제`, `정의`, `상호관계`, `핵심 결론` 4축이 유지되어야 한다.
+- 운영 원칙: `Kei API`는 호출하지 않고 문서 기반으로 수행한다.
+
+### Stage 1B Concept Refinement
+- 목표: topic 결과를 slide 생성에 적합한 개념 단위로 정제한다.
+- 입력: Stage 1A 결과 + `03-structure/content-structure.md`
+- 산출물: refined concepts, core/support 구분, expression_hint 보강
+- 검증: `DX는 상위`, `BIM은 핵심 기술` 메시지가 최종 중심으로 남아야 한다.
+
+### Stage 1.5a 폰트 위계와 비율 계획
+- 목표: DX를 최상위 메시지로 두는 타이포그래피 위계와 body/sidebar 비율을 계획한다.
+- 입력: refined concept, 구조화 결과
+- 산출물: 타이포 위계 계획, body/sidebar 비율 가정
+- 검증: 결론이 본문 하단에 묻히지 않아야 한다.
+
+### Stage 1.7 참조 블록 선정
+- 목표: 계층 관계와 오해 바로잡기 메시지를 잘 드러낼 reference block 방향을 정한다.
+- 입력: expression_hint, 구조화 결과, block catalog
+- 산출물: 추천 블록 또는 레이아웃 방향 메모
+- 검증: `BIM ⊂ DX` 관계를 한눈에 보여줄 수 있어야 한다.
+
+### Stage 1.5b 디자인 버짓 재계산
+- 목표: 핵심 메시지 강조 구조에 맞게 영역별 budget을 계산한다.
+- 입력: 위계 계획, 비율 계획, reference block 가정
+- 산출물: container specs, text budget, height budget
+- 검증: 본문에 핵심 관계 설명이 충분히 들어가고, sidebar는 근거/비교 보조 정보 중심이어야 한다.
+
+### Stage 2 HTML 생성
+- 목표: 1장 slide HTML을 생성한다.
+- 입력: refined concepts, budget, reference block 방향
+- 산출물: slide HTML, body/sidebar/footer fragment
+- 검증: 핵심 관계 문장이 가장 먼저 읽혀야 하며, 비교표는 요약형이 적절하다.
+
+### Stage 2 검증 및 재시도
+- 목표: 의미 보존과 구조 적합성을 확인하고 실패 영역만 수정한다.
+- 입력: 생성된 HTML, 원문, interpretation 결과
+- 산출물: 검증 결과, 실패 영역 목록, 재시도 결과
+- 검증: DX 축소 해석 금지, BIM 과대/과소평가 금지, 결론 누락 금지
+
+### Stage 3 렌더와 측정
+- 목표: 실제 화면에서 overflow와 균형을 측정한다.
+- 입력: 검증 통과 HTML
+- 산출물: 렌더 결과, 측정값, overflow 경고
+- 검증: 핵심 메시지와 관계 설명이 과밀하지 않게 보여야 한다.
+
+### Stage 4 품질 게이트와 최종화
+- 목표: 1장 슬라이드가 `오해 바로잡기 + 개념 계층 설명`을 성공적으로 전달하는지 최종 판단한다.
+- 입력: 렌더 결과, 측정값, 시각 검토 결과
+- 산출물: 최종 결과물, 최종 판정, 남은 수정 포인트
+- 검증: 첫 시선에 `DX는 상위`, `BIM은 핵심 기술` 관계가 읽혀야 한다.
+
+## Validation Points
+- 원문 메시지의 중심이 `정의 비교`가 아니라 `계층 관계 설명`으로 유지되는가
+- 비교표 세부가 본문을 압도하지 않는가
+- 혼용 사례는 문제 제기 역할만 하고 핵심 메시지를 가리지 않는가
+- 핵심 결론 문장이 시각적으로 충분히 강조되는가
+- 이미지 사용 시 `DX 상위 구조`를 강화하는가
+
+## Retry Rules
+- Stage 1A/1B 실패 시: interpretation과 structure 문서를 먼저 보강한 뒤 재수행
+- Stage 1.5a/1.5b 실패 시: 정보량과 비율을 먼저 조정
+- Stage 2 실패 시: 전체 재생성보다 실패 영역 부분 재생성을 우선
+- Stage 3 실패 시: overflow 영역 중심으로 budget 또는 HTML 구조 수정
+- Stage 4 실패 시: 시각 강조 구조와 핵심 결론 위치를 우선 수정
+
+## Fallback Path
+- 기본 경로는 `문서 기반 해석 -> run 산출물 -> 코드 기반 후반부 실행`
+- `Kei API`는 기본 경로에서 제외한다.
+- 후반부 코드 자산을 그대로 쓰기 어렵다면, 우선 수동/에이전트 기반 산출물로 Stage 1A/1B만 대체하고 이후 파이프라인은 최소 수정으로 연결한다.
+
+## Ready-for-Next Step
+다음 단계에서는 아래 항목을 실제 파일로 추가하면 좋다.
+- `04-plan/stage-1a-topics.md`
+- `04-plan/stage-1b-refined-concepts.md`
+- `04-plan/design-budget-notes.md`
+- `04-plan/reference-block-notes.md`