워크플로우: 프로젝트 마일스톤 생성

목표: SPEC.md와 plan.md를 분석하여, 개발 진행 상황을 추적할 수 있는 **논리적이고 순차적인 작업 목록(Milestone)**을 milestone.md로 생성하십시오.

1단계: 작업 맥락 파악

프로젝트 루트에서 다음 2개 파일을 읽습니다:

1. SPEC.md — 요구사항 (기능/비기능 요구사항, 제약조건, 사용자 시나리오)
2. plan.md — 구현 상세 (아키텍처, 디렉토리 구조, 데이터 흐름 등)

• SPEC.md가 없으면 /spec을 먼저 실행하도록 안내합니다.
• plan.md가 없으면 /planner를 먼저 실행하도록 안내합니다.

분석 항목:

1. 핵심 목표 식별: 프로젝트가 달성해야 할 비즈니스 목표와 주요 기능을 파악하십시오.
2. 의존성 분석: 기능 구현을 위해 선행되어야 할 작업(예: DB 설정 -> API 구현 -> UI 연동)의 흐름을 파악하십시오.
3. 작업 단위 정의: 파일 단위가 아닌, **”하나의 의미 있는 기능이 동작하는가?”**를 기준으로 작업을 정의하십시오.

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를 생성하십시오. 아키텍처 이론보다는 **’무엇을 구현해야 하는가’**에 집중하십시오.