# Milestone > 프로젝트 마일스톤 생성. SPEC.md와 plan.md를 기반으로 작업 목록 생성. "마일스톤 만들어", "작업 목록" 등의 요청 시 사용 Use when this capability is needed. - Skill: `tomevault-io/milestone` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/milestone` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/milestone/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/milestone --- # 워크플로우: 프로젝트 마일스톤 생성 **목표**: `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...)에 자연스럽게 대응되도록 구성하십시오. ### 출력 형식 예시 ```markdown # 프로젝트 개발 마일스톤 > 기반 문서: 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](https://tomevault.io/claim/gihwan-dev) — claim your Tome and manage your conversions.