kyeongmin
c42e65fc7e
콘텐츠를 시각적으로 구조화된 슬라이드 HTML로 변환하는 독립 에이전트. 아키텍처 (4단계 파이프라인): 1. Kei 실장 (Opus) — 콘텐츠 유형 분류 + 블록 배치 2. 디자인 팀장 (Sonnet) — 레이아웃 컨셉 (블록 배치 + 페이지 수) 3. 텍스트 편집자 (Sonnet) — 슬롯 텍스트 정리 (핵심 유지) 4. CSS Grid 렌더러 — HTML 조립 블록 템플릿 7종: comparison, card-grid, relationship, process, quote-block, conclusion-bar, comparison-table 기술 스택: FastAPI + Anthropic API + Jinja2 + CSS Grid Pretendard Variable 한국어 폰트 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
4.5 KiB
4.5 KiB
Design Agent — 진행 상황
현재 상태 요약
| 상태 | 개수 |
|---|---|
| done | 13 |
| in-progress | 0 |
| todo | 3 |
| blocked | 0 |
| 전체 | 16 |
Phase 1: 기반 구축
| 태스크 | 상태 | 담당 | 시작 | 완료 | 메모 |
|---|---|---|---|---|---|
| DA-1: 프로젝트 셋업 | done | - | - | - | pyproject.toml, .env |
| DA-2: FastAPI 서버 | done | - | - | - | DA-1 이후 |
| DA-3: 디자인 토큰 + 기본 CSS | done | - | - | - | 독립 작업 가능 |
Phase 2: 블록 템플릿 제작
| 태스크 | 상태 | 담당 | 시작 | 완료 | 메모 |
|---|---|---|---|---|---|
| DA-4: 비교 블록 | done | - | - | - | DA-3 이후 |
| DA-5: 카드 그리드 | done | - | - | - | DA-3 이후 |
| DA-6: 관계도 | done | - | - | - | DA-3 이후 |
| DA-7: 프로세스 | done | - | - | - | DA-3 이후 |
| DA-8: 강조 인용 | done | - | - | - | DA-3 이후 |
| DA-9: 결론 바 | done | - | - | - | DA-3 이후 |
| DA-10: 비교 테이블 | done | - | - | - | DA-3 이후 |
| DA-11: 슬라이드 조합 렌더러 | done | - | - | - | DA-4~10 이후 |
Phase 3: AI 파이프라인 연결
| 태스크 | 상태 | 담당 | 시작 | 완료 | 메모 |
|---|---|---|---|---|---|
| DA-12: Kei API 연동 (Opus) | done | - | - | - | DA-2 이후 |
| DA-13: 디자인 팀장 — 레이아웃 컨셉만 | todo | - | - | - | 기존에서 텍스트 정리 제거. 컨셉만 반환 |
| DA-13b: 텍스트 편집자 (Kei 역할) | todo | - | - | - | 신규. 도메인 전문가로 슬롯 텍스트 정리 |
| DA-14: 전체 파이프라인 (3단계) | todo | - | - | - | 분류→컨셉→텍스트→렌더링. 다중 페이지 |
Phase 4: UI + 출력
| 태스크 | 상태 | 담당 | 시작 | 완료 | 메모 |
|---|---|---|---|---|---|
| DA-15: 프론트엔드 | done | - | - | - | DA-14 이후. HTML 다운로드만 |
| DA-16: 통합 테스트 | done | - | - | - | DA-15 이후 |
버그 수정 이력
BF-1: 프론트엔드 SSE 파싱 실패 [발견: DA-15 이후]
- 현상: 서버는 정상 응답하지만 브라우저에서 결과 미표시. "시작 중..." 고정.
- 원인: main.py Python 문자열 안에 HTML/JS를 넣어서
\n이 실제 줄바꿈으로 변환 → JSsplit('\n\n')깨짐. 또한 Windows SSE가\r\n\r\n(CRLF)로 구분. - 해결: static/index.html 별도 파일로 분리. FileResponse로 서빙. SSE split을
/\r?\n\r?\n/정규식으로 변경. - 기술: FileResponse (FastAPI 내장), 추가 의존성 0
- 충돌 검토: API 경로와 충돌 없음. 기존 코드 변경 없음. Kei persona 무관.
- 상태: done
BF-2: 블록 내용이 비어있음 (Jinja2 include 변수 전달 실패) [발견: BF-1 이후]
- 현상: 슬라이드 HTML은 생성되지만 모든 블록 텍스트가 비어있음. 레이아웃 구조만 있고 내용 없음.
- 원인: renderer.py에서 Jinja2
include로 블록 템플릿을 삽입하는데,include는 블록별 변수를 개별 전달하지 못함. Sonnet이 채운 data가 템플릿에 도달 안 함. - 해결:
include대신 각 블록 템플릿을env.get_template().render(**data)로 개별 렌더링 후 완성된 HTML을 삽입.render_standalone_block()이 이미 이 방식으로 동작 중 → 통일. - 기술: Jinja2
get_template().render()(내장), 추가 의존성 0 - 수정 파일: renderer.py, templates/slide-base.html
- 충돌 검토: 블록 템플릿 7개 변경 없음. pipeline.py 호출 시그니처 동일. Kei persona 무관.
- 상태: done
BF-3: 한글 깨짐 (다운로드 HTML 파일) [발견: BF-1 이후]
- 현상: 다운로드한 HTML 파일에서 한글이
ê±´ì¤ì°ì같은 깨진 문자로 표시. - 원인: Blob 다운로드 시 UTF-8 BOM 미포함. 일부 에디터/브라우저가 인코딩 자동 감지 실패.
- 해결: download() 함수에서 Blob 생성 시 UTF-8 BOM(
'\uFEFF') 접두사 추가. - 기술: JavaScript BOM 1줄, 추가 의존성 0
- 수정 파일: static/index.html
- 충돌 검토: 미리보기(iframe)에 영향 없음. SSE 파싱에 영향 없음.
- 상태: done
블로킹 이슈
없음
완료된 준비 사항
| 항목 | 파일 | 상태 |
|---|---|---|
| 프로젝트 규칙 | CLAUDE.md | 완료 |
| 실행 계획 | PLAN.md | 완료 |
| 진행 추적 | PROGRESS.md | 완료 (이 파일) |
| 기술 조사 | docs/RESEARCH.md | 완료 |
| 폴더 구조 | templates/, samples/, docs/ | 생성 완료 |