5단계 파이프라인 전면 재작성 + Figma 추출 계획 업데이트

DA-12: 1단계 Kei 실장 — 꼭지 2~5개 추출 + 레이어/강조/배치/이미지/표/자세히보기 판단
DA-13: 2단계 디자인 팀장 — catalog 연동 + 블록 매핑 + 공간 배분 + 글자 수 가이드
DA-13b: 3단계 텍스트 편집자 — 글자 수 가이드 참고, 의미 우선 편집 + 자세히보기(요약+상세)
DA-14: 4단계 실무자(AI+코드) + 5단계 팀장 재검토 (균형 점검 → 2차 조정)

문서:
- CLAUDE.md: 5단계 프로세스 + 이미지/표/자세히보기 처리 원칙
- PLAN.md: DA-12~14 태스크 전면 재작성
- PROGRESS.md: 동기화
- FIGMA-COMPONENT-EXTRACTION-PLAN.md: 모드 독립 블록, 변환 규칙, image-block/details-block, MCP, 토큰 매핑

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

PLAN.md

@@ -77,35 +77,57 @@
 
 ## Phase 3: AI 파이프라인 연결
 
-### DA-12: Kei API 연동 — 콘텐츠 분류 (Opus)
+### DA-12: 1단계 — Kei 실장 (꼭지 추출 + 분석)
 - **파일:** src/kei_client.py
-- **내용:** Kei API (`localhost:8000/api/message`)에 콘텐츠 전송 → Opus 분류 결과 수신. Kei API 미연결 시 수동 분류 fallback
+- **내용:** 본문에서 핵심 꼭지 추출 + 다단계 분석
+  - 꼭지 추출: 본문에서 2~5개 핵심 파트 식별 (1페이지 적정: 5개)
+  - 페이지 분리: 5개 초과 + 레이어 동등 → 2페이지 (의미 기반 분할 2/3, 3/4 등)
+  - 5개 + 내용 많음 → 세부 내용은 자세히보기 대상
+  - 레이어 수준: 각 꼭지가 도입/핵심/보조/결론 중 어디인지
+  - 강조 판단: 어떤 꼭지를 시각적으로 눈에 띄게 할 것인가
+  - 배치 방향: 세로로 긴 꼭지, 가로로 나열할 꼭지 판단
+  - 이미지 판단: 몇 개, 어떤 꼭지 소속, 핵심/보조, 텍스트 포함 여부
+  - 표 판단: 행/열 규모, 전체 표시 가능 여부
+  - 상세 콘텐츠 판단: 자세히보기 대상 식별
+- **기술:** Anthropic API (Sonnet)
 - **의존성:** DA-2
-- **완료 기준:** 테스트 콘텐츠 전송 → 유형 분류 JSON 반환
+- **완료 기준:** 꼭지 목록 + 레이어 + 강조 + 배치 + 이미지/표/상세 판단 JSON
 
-### DA-13: 디자인 팀장 — 레이아웃 컨셉 (Sonnet)
+### DA-13: 2단계 — 디자인 팀장 (레이아웃 설계)
 - **파일:** src/design_director.py
-- **내용:** Anthropic API 직접 호출. Opus 분류 결과 + 원본 콘텐츠 → 레이아웃 컨셉만 결정. 텍스트 정리 안 함.
-- **출력:** 블록 배치 + 페이지 수 + 슬롯 목록 (텍스트 없이 구조만)
-- **기술:** Anthropic API (Sonnet), JSON 반환
+- **내용:** 블록 매핑 + 공간 배분 + 글자 수 가이드
+  - 블록 매핑: catalog 메뉴판에서 각 꼭지 성격에 맞는 블록 선택
+  - 이미지 배치: Pillow로 원본 크기 확인 → 가로/세로에 따라 영역 결정 (크기만 조절, crop 안 함)
+  - 표 배치: 행×열 규모 보고 공간 판단 (안 되면 요약 요청 또는 페이지 분리)
+  - 자세히보기: 상세 콘텐츠는 `<details>` 영역으로 설계
+  - 공간 배분: 영역별 비율, 겹침 방지
+  - 글자 수 가이드: 각 블록 공간에 맞는 대략적 글자 수 (하드코딩 아닌 판단)
+  - 페이지 판단: 안 들어가면 2페이지 분리
+- **기술:** Anthropic API (Sonnet) + Pillow (이미지 크기)
 - **의존성:** DA-12
-- **완료 기준:** "이 파트는 카드로, 이건 비교로, 2페이지 필요" 수준의 컨셉 JSON 반환
+- **완료 기준:** 블록 배치 + 이미지/표 배치 + 글자 수 가이드 JSON
 
-### DA-13b: 텍스트 편집자 — 슬롯 텍스트 정리 (Kei 역할)
-- **파일:** src/content_editor.py (신규)
-- **내용:** Anthropic API 직접 호출. 디자인 팀장의 레이아웃 컨셉 + 원본 콘텐츠 → 각 슬롯에 맞는 텍스트 편집. 도메인 지식 보존, 핵심 유지.
-- **역할:** 도메인 전문가로서 콘텐츠를 정리하는 편집자 (Kei persona 규칙 일부 적용)
-- **규칙:** 핵심 내용 유지, 개조식, 출처 보존, 슬롯 분량 준수, 내용 날조 금지
-- **기술:** Anthropic API (Sonnet), JSON 반환
+### DA-13b: 3단계 — Kei 텍스트 편집자 (텍스트 정리)
+- **파일:** src/content_editor.py
+- **내용:** 팀장의 글자 수 가이드 참고하되 내용 의미 우선
+  - 전체 컨텍스트와 핵심 용어 유지
+  - 세련된 표현으로 편집 (의미 > 글자 수)
+  - 출처 보존, 개조식, 날조 금지
+  - 표 내용 편집 (핵심 행/열 선택, 요약)
+  - 자세히보기 대상: 요약 버전 + 상세 버전 둘 다 작성
+- **기술:** Anthropic API (Sonnet)
 - **의존성:** DA-13
-- **완료 기준:** 슬롯별 텍스트가 채워진 JSON 반환. 원본 핵심 내용 보존 확인.
+- **완료 기준:** 슬롯별 텍스트 JSON. 핵심 용어 보존. 자세히보기 포함.
 
-### DA-14: 전체 파이프라인 연결 (3단계)
-- **파일:** src/pipeline.py
-- **내용:** 콘텐츠 입력 → Opus 분류 → 디자인 팀장 컨셉 → 텍스트 편집자 정리 → 렌더러 조립 → HTML 출력
-- **기술:** 순차 호출, 다중 페이지 지원
+### DA-14: 4단계 — 디자인 실무자 (디자인 조정 + HTML 조립) + 5단계 재검토
+- **파일:** src/pipeline.py, src/renderer.py
+- **내용:**
+  - 4단계 (AI + 코드): 편집자 텍스트에 맞게 디자인 조정 (폰트/여백/박스 — 텍스트 자르지 않음)
+    + Jinja2 HTML 조립, 이미지 object-fit:contain, 표 container query, `<details>` 접기, 인쇄 펼침 JS
+  - 5단계 (AI): 팀장이 전체 균형 재검토 → 채움 비율, 블록 균형, 이미지/표 크기 점검 → 2차 조정
+- **기술:** Anthropic API Sonnet (디자인 조정 + 재검토) + Jinja2/CSS (조립)
 - **의존성:** DA-11, DA-12, DA-13, DA-13b
-- **완료 기준:** 텍스트 입력 → 완성 슬라이드 HTML 출력 (엔드투엔드, 다중 페이지 포함)
+- **완료 기준:** 텍스트 입력 → 균형 잡힌 슬라이드 HTML (이미지/표/자세히보기 포함, 재검토 완료)
 
 ---
 
@@ -148,13 +170,14 @@
 ## 의존 관계
 
 ```
-DA-1 → DA-2 → DA-12 → DA-13 ─┐
-                                ├→ DA-14 → DA-15 → DA-16
-DA-3 → DA-4~DA-10 → DA-11 ────┘
+DA-1 → DA-2 → DA-12(실장) → DA-13(팀장) → DA-13b(편집자) ─┐
+                                                             ├→ DA-14(조립+재검토) → DA-15 → DA-16
+DA-3 → DA-4~DA-10 → DA-11(렌더러) ─────────────────────────┘
 ```
 
-Phase 1(DA-1~3)과 Phase 2(DA-4~11)는 AI 없이 진행 가능.
-Phase 3(DA-12~14)부터 Kei API + Anthropic API 필요.
+- Phase 1~2: AI 없이 진행 가능
+- Phase 3: Anthropic API 필요 (5단계 파이프라인)
+- 5단계 흐름: 실장 → 팀장 → 편집자 → 조립 → 재검토
 
 ---