# Design Agent 상세 파이프라인 개요
이 문서는 design_agent의 실제 내부 실행 단계를 설명하는 상세 파이프라인 문서다.
상위 운영 절차는 위키 2 계열을 따르고, 실제 stage 정의와 입출력과 검증은 이 문서를 따른다.
현재 구현은 Phase S 중심 실행 경로를 가지고 있고, 이 문서는 그 위에 Phase T 목표 구조를 반영해 정리한 상세 기준서다.
따라서 일부 stage는 현재 코드에 완전히 분리 구현되어 있지 않더라도, 앞으로 따라야 할 구조로 문서화한다.
상세 파이프라인 목록
- Stage 0 입력 로드 및 MDX 정규화
- Stage 1A Kei topic extraction
- Stage 1B concept refinement
- Stage 1.5a 폰트 위계와 비율 계획
- Stage 1.7 참조 블록 선정
- Stage 1.5b 디자인 버짓 재계산
- Stage 2 HTML 생성
- Stage 2 검증 및 재시도
- Stage 3 렌더와 측정
- Stage 4 품질 게이트와 최종화
설계 원칙
- 구조와 의미 판단이 먼저다.
- 폰트 위계가 먼저고 컨테이너가 따라간다.
- 생성과 검증은 분리한다.
- 실패 시 가능한 한 국소적으로 재시도한다.
현재 구현과 목표 구조의 차이
- Stage 1A와 Stage 1B는 현재
Kei API 의존이 크지만, 목표 구조에서는 문서 기반 해석과 중간 산출물 기반 흐름으로 전환한다.
- Stage 1.5a, 1.7, 1.5b는 Phase T에서 더 명시적으로 분리한다.
- 후반부의 생성, 검증, 렌더, 측정, 품질 게이트는 기존 코드 자산을 최대한 유지한다.