# RETROSPECTIVE.md

## 프로젝트: 00-프로젝트생성기 v2.0 업그레이드

### 기간

- 시작: 2026-07-05
- 완료: 2026-07-05

### 목표

04-사진줄이기 프로젝트에서 발견된 문제점을 해결하기 위해
AI-WORKS 프로젝트 생성기를 Standard v2.0으로 업그레이드한다.

### 주요 문제점

1. 템플릿 변수 미치환 (`{PROJECT_NAME}` 등이 실제로 대체되지 않음)
2. placeholder 문서가 검증 없이 생성됨
3. DESIGN_FREEZE가 실제 설계 완료 전에 승인되는 문제
4. STATE.json, PROJECT_CONTEXT.md, SESSION.md 상태 불일치

### 해결 방법

1. substitute_template_vars() 함수 추가
2. validate_documents() 함수로 placeholder/길이/섹션 검사 추가
3. can_approve_design_freeze() 함수로 DESIGN_FREEZE 조건 검증 추가
4. STATE.json을 Single Source of Truth로 지정하고 document_status 필드 추가

### 결과

- 4가지 최종 검증 모두 통과
- 99-test 프로젝트 생성 검증 완료
- Syntax check, module import check 통과

### 배운 점

1. 검증 로직은 생성 후가 아니라 생성 과정에 통합해야 한다
2. 상태 문서는 여러 개가 아닌 하나로 관리해야 불일치가 없다
3. DESIGN_FREEGE 조건은 자동 검증이어야 신뢰할 수 있다

### 개선 영역 (v2.1 후보)

1. State Machine 기반 프로세스 제어
2. 독립 Validation Tool
3. Test Harness
4. Immutable Zones
