---
description: spec.md 또는 prd.md를 분석하여 doc/plan.md와 Phase별 설계 문서를 자동 생성한다. 사용법: /spec-to-plan (현재 폴더의 spec.md 또는 prd.md를 자동으로 찾는다)
---

사용자가 `/spec-to-plan`을 요청하면 아래 순서로 계획 문서를 자동 생성한다.

## 규칙

1. **spec 파일 탐색**: 현재 폴더에서 `spec.md`, `prd.md`, `requirements.md` 순으로 찾는다.
   - 없으면 사용자에게 파일 경로를 물어본다.

2. **요구사항 분석**: spec을 읽고 다음을 추출한다.
   - 기능 요구사항 목록
   - 예외/에러 처리 항목
   - 범위 밖(Out of Scope) 항목
   - 기술 스택 제약

3. **Phase 분할**: 기능을 점진적 Phase로 나눈다.
   - Phase 0: 항상 pytest/테스트 환경 구성
   - Phase 1: 프로젝트 뼈대 (빈 파일, 빈 클래스)
   - Phase 2~N-1: 핵심 기능을 의존 순서대로
   - Phase N: 통합 테스트 또는 예외 처리 강화

4. **doc/plan.md 작성**: 전체 Phase 표와 원칙을 작성한다.

5. **Phase 설계 문서 작성**: `doc/design/phaseN.md`를 각 Phase마다 작성한다.
   - 구현 대상 파일/함수
   - 변경 전/후 코드 예시
   - 테스트 케이스 목록
   - 완료 기준

6. **정합성 검증 보고**: 모든 요구사항이 어느 Phase에 포함됐는지 확인한다.

## 출력 형식

```
## spec-to-plan 실행 결과

### 분석된 요구사항
- 기능: N개
- 예외 처리: N개
- Out of Scope: N개

### 생성된 Phase 구조
| Phase | 내용 | 예상 난이도 |
|-------|------|-----------|
| 0 | pytest 환경 구성 | 낮음 |
| 1 | ... | ... |

### 생성된 파일
- doc/plan.md
- doc/design/phase0.md ~ phaseN.md

### 정합성 검증
- 요구사항 커버리지: N/N (100%)
- 발견된 모호한 요구사항: <없음 / 목록>
```

## 주의사항
- Phase 수는 적을수록 좋다. 너무 잘게 쪼개면 관리 부담이 증가한다.
- 각 Phase는 1~2시간 안에 구현 가능한 크기가 이상적이다.
- 기술적 의존 관계(A가 없으면 B를 구현할 수 없는 경우)를 Phase 순서에 반영한다.