| name | milestone |
| description | 프로젝트 마일스톤 생성. SPEC.md와 plan.md를 기반으로 작업 목록 생성. "마일스톤 만들어", "작업 목록" 등의 요청 시 사용 Use when this capability is needed. |
| metadata | {"author":"gihwan-dev"} |
워크플로우: 프로젝트 마일스톤 생성
목표: SPEC.md와 plan.md를 분석하여, 개발 진행 상황을 추적할 수 있는 **논리적이고 순차적인 작업 목록(Milestone)**을 milestone.md로 생성하십시오.
1단계: 작업 맥락 파악
프로젝트 루트에서 다음 2개 파일을 읽습니다:
SPEC.md — 요구사항 (기능/비기능 요구사항, 제약조건, 사용자 시나리오)plan.md — 구현 상세 (아키텍처, 디렉토리 구조, 데이터 흐름 등)
- SPEC.md가 없으면
/spec을 먼저 실행하도록 안내합니다.
- plan.md가 없으면
/planner를 먼저 실행하도록 안내합니다.
분석 항목:
- 핵심 목표 식별: 프로젝트가 달성해야 할 비즈니스 목표와 주요 기능을 파악하십시오.
- 의존성 분석: 기능 구현을 위해 선행되어야 할 작업(예: DB 설정 -> API 구현 -> UI 연동)의 흐름을 파악하십시오.
- 작업 단위 정의: 파일 단위가 아닌, **"하나의 의미 있는 기능이 동작하는가?"**를 기준으로 작업을 정의하십시오.
2단계: 마일스톤 구성 전략
아키텍처 계층(레이어)이 아닌, 기능의 완성도를 기준으로 단계를 나누십시오:
1. 기반 작업
- 프로젝트 전반에 영향을 미치는 공통 설정, 환경 구성, 핵심 데이터 모델링(공통 엔터티) 등을 정의합니다.
- 기준: 이 작업이 안 되면 다른 기능을 시작할 수 없는가?
2. 핵심 기능 구현
- 비즈니스 로직과 UI가 결합된 완전한 기능 단위로 구성합니다.
- 엔터티, 로직, UI를 굳이 나누지 말고, **"OO 기능 개발 완료"**라는 하나의 마일스톤으로 묶으십시오.
- 나쁜 예: [엔터티] User 생성 -> [기능] Login 로직 -> [UI] Login 페이지 (파편화됨)
- 좋은 예: [기능] 사용자 인증(로그인) 기능 구현 (통합됨)
3. 화면 및 통합
- 개별 기능들을 조립하여 최종 사용자에게 보여지는 페이지를 구성하고 라우팅을 연결하는 작업입니다.
3단계: milestone.md 작성
다음 형식을 사용하여 milestone.md를 생성하십시오.
- 각 항목은 명확한 **'완료 조건'**을 포함해야 합니다.
- 구체적인 파일 경로나 아키텍처 용어(FSD 등)보다는 개발 내용에 집중하십시오.
- 각 Phase/항목이 SPEC.md의 기능 요구사항(F1, F2...)에 자연스럽게 대응되도록 구성하십시오.
출력 형식 예시
# 프로젝트 개발 마일스톤
> 기반 문서: SPEC.md, plan.md
## Phase 1. 프로젝트 기반 및 공통 모듈
- [ ] **핵심 데이터 모델링 및 API 클라이언트 구성**
- 목표: User, Product 등 전역에서 사용되는 핵심 타입 정의 및 API 통신 환경 구축
- 검증: API 호출 테스트 성공 및 타입 추론 동작 확인
## Phase 2. 핵심 기능 개발
- [ ] **상품 결제 프로세스 구현**
- 목표: 장바구니 담기부터 결제 승인까지의 로직 및 UI 컴포넌트 개발
- 포함: 결제 모달 UI, PG사 연동 로직, 주문 데이터 업데이트
- 검증: 결제 성공 시 주문 내역 생성 확인
## Phase 3. 페이지 조립 및 배포 준비
- [ ] **마이페이지 대시보드 완성**
- 목표: 프로필 수정, 주문 내역 조회 등 개별 기능을 한 페이지에서 통합
- 작업: 기존 개발된 위젯들을 조합하여 레이아웃 구성
실행 지시
위의 논리를 바탕으로, 개발자가 작업의 흐름을 한눈에 파악할 수 있는 실용적인 milestone.md를 생성하십시오. 아키텍처 이론보다는 **'무엇을 구현해야 하는가'**에 집중하십시오.
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
