# STAGE-1-Overview

## 목적
이 문서는 1단계의 기준 문서다.
1단계의 목표는 `design_agent`의 현재 구조를 충분히 이해하고, 그 이해를 `C.E.L._slide_test`의 위키 및 관련 문서로 정리하는 것이다.

이 단계에서는 아직 전체 구조를 뜯어고치지 않는다.
먼저 현재 구조와 목표 구조를 명확히 분리해서 기록한다.

## 1단계의 핵심 질문
1. 현재 `design_agent`는 실제로 어떤 순서로 동작하는가
2. 어떤 단계가 코드로 구현되어 있는가
3. 어떤 단계가 외부 해석에 의존하는가
4. `Phase T`는 현재 구조에서 무엇을 바꾸려 하는가
5. 위키 1/2/3 체계로 이 내용을 어떻게 옮길 것인가

## 현재 design_agent에 대한 이해
현재 `design_agent`는 완전히 새로운 Phase T 구현체라기보다, 기존 실행 경로 위에 일부 T 방향 수정이 얹혀 있는 상태로 이해하는 것이 정확하다.

현재 흐름은 크게 다음과 같다.

1. 입력 수신
2. 초기 해석
3. 공간/영역 제약 계산
4. HTML 생성
5. 콘텐츠 검증 및 부분 재시도
6. 렌더링
7. 실제 측정
8. 품질 게이트
9. 결과 저장 및 응답

즉, 전체 시스템의 후반부는 코드 기반으로 꽤 많이 구현되어 있고, 초반부의 의미 해석과 개념 정리가 별도 해석 단계로 분리 가능한 구조다.

## 현재 구현과 위키 계층의 연결
### 위키 1
- 어떻게 판단하는가
- 어떤 의미를 보존해야 하는가
- 무엇을 경계해야 하는가

### 위키 2
- 작업을 어떤 상위 절차로 진행하는가
- 언제 판단 기준을 호출하는가
- 언제 상세 파이프라인으로 내려가는가

### 위키 3
- 실제 내부 파이프라인 stage 정의
- 각 stage의 입력, 출력, 검증, 실패 처리 기준

즉 1단계에서는 현재 `design_agent`를 위키 2와 위키 3의 구조로 다시 서술하는 것이 핵심이다.

## Phase T를 1단계에 반영해야 하는 이유
1단계가 단순히 현재 코드 복사만 되면 안 된다.
현재는 `Phase T` 진행 중이므로, 문서화는 다음 두 축을 함께 가져야 한다.

- 현재 실제 코드가 무엇을 하고 있는가
- 앞으로 Phase T에서 어떤 구조로 정리하려는가

특히 다음 항목은 1단계 문서화에 반드시 반영해야 한다.

- Stage 0 MDX normalization
- Stage 1A / 1B 분리
- Stage 1.5a / 1.7 / 1.5b 분리
- font hierarchy first
- stage별 validation
- partial retry
- quality gate

## 1단계 산출물
1단계에서 만들어야 할 핵심 산출물은 다음과 같다.

- 위키 1 계열 정리
- 위키 2 계열 정리
- 위키 3 계열 정리
- 현재 코드와 위키 단계 매핑 문서
- 외부 해석 의존 지점 정리 문서
- Phase T 반영 포인트 정리 문서

## 완료 기준
1단계는 아래 조건을 만족하면 완료로 본다.

- `design_agent`의 전체 흐름을 위키 2와 위키 3으로 설명할 수 있다.
- 어떤 단계가 코드 책임인지, 어떤 단계가 초기 해석 책임인지 구분되어 있다.
- 초기 해석 단계를 분리 전환할 때 무엇을 바꿔야 하는지 문서로 드러난다.
- `Phase T` 반영 포인트가 누락되지 않는다.
