create-ax-project 1.0.0

package/template/stages/05-task-management/outputs/milestones.md

@@ -0,0 +1,253 @@
+# 🎯 Snake Game - 마일스톤 정의
+
+> 생성일: 2026-01-21
+> 스테이지: 05-task-management
+> 프로젝트: snake-game
+
+---
+
+## 마일스톤 개요
+
+| ID | 마일스톤 | 목표 | 완료 스테이지 |
+|----|---------|------|-------------|
+| M1 | MVP 기반 | 게임 코어 로직 완성 | 06-implementation (전반) |
+| M2 | MVP 완성 | 플레이 가능한 게임 | 06-implementation (완료) |
+| M3 | 품질 개선 | 모바일 지원 + 버그 수정 | 08-qa |
+| M4 | 배포 | 프로덕션 배포 | 10-deployment |
+
+---
+
+## M1: MVP 기반 (Foundation)
+
+### 목표
+게임의 핵심 로직과 인프라를 구축합니다.
+
+### 포함 태스크
+- TASK-001 ~ TASK-009, TASK-016
+
+### 산출물
+
+| 산출물 | 위치 | 설명 |
+|--------|------|------|
+| 프로젝트 구조 | `snake-game/` | Vite + React + TS |
+| 타입 정의 | `src/types/index.ts` | 모든 게임 타입 |
+| 상수 | `src/constants/config.ts` | 게임 설정값 |
+| 게임 루프 훅 | `src/hooks/useGameLoop.ts` | rAF 기반 |
+| 키보드 훅 | `src/hooks/useKeyboard.ts` | 방향키 처리 |
+| 충돌 감지 | `src/engine/collision.ts` | 벽/몸통/먹이 |
+| 렌더러 | `src/engine/renderer.ts` | Canvas 렌더링 |
+| 리듀서 | `src/engine/gameReducer.ts` | 상태 관리 |
+| 유틸리티 | `src/utils/random.ts` | 랜덤 위치 |
+
+### 성공 기준
+
+```
+[ ] TypeScript 컴파일 성공 (tsc --noEmit)
+[ ] ESLint 경고 0개
+[ ] 콘솔에서 게임 루프 틱 확인
+[ ] 빈 Canvas에 그리드 렌더링
+[ ] 키보드 입력 감지 (콘솔 로그)
+```
+
+### 검증 방법
+
+```bash
+# 타입 체크
+npm run typecheck
+
+# 린트
+npm run lint
+
+# 개발 서버 실행 후 콘솔 확인
+npm run dev
+```
+
+---
+
+## M2: MVP 완성 (Playable)
+
+### 목표
+사용자가 실제로 플레이할 수 있는 게임을 완성합니다.
+
+### 포함 태스크
+- TASK-010 ~ TASK-014, TASK-018 ~ TASK-021
+
+### 산출물
+
+| 산출물 | 위치 | 설명 |
+|--------|------|------|
+| GameEngine | `src/GameEngine.tsx` | 게임 통합 컴포넌트 |
+| CanvasLayer | `src/components/CanvasLayer.tsx` | Canvas 래퍼 |
+| ScoreBoard | `src/components/ScoreBoard.tsx` | 점수판 |
+| GameOverModal | `src/components/GameOverModal.tsx` | 게임 오버 |
+| useHighScore | `src/hooks/useHighScore.ts` | 최고 점수 |
+| 스타일 | `src/styles/` | CSS Modules |
+
+### 성공 기준
+
+```
+[ ] 방향키로 뱀 조작 가능
+[ ] 먹이 먹으면 뱀 성장 + 점수 증가
+[ ] 벽/몸통 충돌 시 게임 오버
+[ ] 게임 오버 모달에서 재시작 가능
+[ ] 최고 점수 localStorage 저장/불러오기
+[ ] 레벨업 시 속도 증가
+[ ] 일시정지/재개 동작
+```
+
+### 검증 방법
+
+```bash
+# 개발 서버에서 직접 플레이
+npm run dev
+
+# 체크리스트
+# 1. 방향키로 이동
+# 2. 먹이 먹기
+# 3. 벽에 부딪히기
+# 4. 재시작
+# 5. 최고 점수 확인
+```
+
+---
+
+## M3: 품질 개선 (Quality)
+
+### 목표
+모바일 지원, 코드 품질, 버그 수정을 완료합니다.
+
+### 포함 태스크
+- TASK-015, TASK-017, TASK-013
+- 07-refactoring, 08-qa 태스크
+
+### 산출물
+
+| 산출물 | 위치 | 설명 |
+|--------|------|------|
+| useSwipe | `src/hooks/useSwipe.ts` | 터치 스와이프 |
+| MobileControls | `src/components/MobileControls.tsx` | D-Pad |
+| StartScreen | `src/components/StartScreen.tsx` | 시작 화면 |
+| 리팩토링 결과 | - | 코드 개선 |
+| 버그 수정 | - | 이슈 해결 |
+
+### 성공 기준
+
+```
+[ ] 모바일에서 스와이프로 조작 가능
+[ ] 모바일에서 D-Pad로 조작 가능
+[ ] 시작 화면 표시
+[ ] 코드 중복 제거
+[ ] 60fps 유지 (Chrome DevTools)
+[ ] 알려진 버그 0개
+[ ] 반응형 레이아웃 동작
+```
+
+### 검증 방법
+
+```bash
+# 모바일 에뮬레이션
+# Chrome DevTools > Device Toolbar
+
+# 성능 확인
+# Chrome DevTools > Performance Tab
+
+# 버그 체크리스트
+# - 빠른 방향 전환
+# - 경계 조건 (벽 바로 앞에서 방향 전환)
+# - 긴 플레이 시 메모리 누수
+```
+
+---
+
+## M4: 배포 (Deployment)
+
+### 목표
+프로덕션 환경에 배포하고 테스트를 완료합니다.
+
+### 포함 태스크
+- TASK-022 ~ TASK-025
+
+### 산출물
+
+| 산출물 | 위치 | 설명 |
+|--------|------|------|
+| 단위 테스트 | `src/__tests__/` | Vitest |
+| E2E 테스트 | `e2e/` | Playwright |
+| 빌드 | `dist/` | 프로덕션 빌드 |
+| 배포 URL | - | 공개 URL |
+
+### 성공 기준
+
+```
+[ ] 단위 테스트 커버리지 80%+
+[ ] E2E 테스트 통과 (선택)
+[ ] 빌드 성공
+[ ] 번들 크기 < 200KB
+[ ] 배포 URL 접근 가능
+[ ] 프로덕션에서 게임 플레이 가능
+[ ] 모바일 브라우저에서 동작
+```
+
+### 검증 방법
+
+```bash
+# 테스트
+npm run test
+npm run test:coverage
+
+# 빌드
+npm run build
+
+# 빌드 크기 확인
+ls -la dist/
+
+# 프리뷰
+npm run preview
+
+# 배포 후 URL 테스트
+```
+
+---
+
+## 마일스톤 타임라인
+
+```
+M1: MVP 기반          M2: MVP 완성
+[======|======]      [======|======]
+    Sprint 1             Sprint 2
+
+M3: 품질 개선         M4: 배포
+[======|======]      [======|====]
+    Sprint 3             Sprint 4
+
+────────────────────────────────────────
+      06-impl       07-ref   09-test
+                    08-qa    10-deploy
+```
+
+---
+
+## 체크포인트 정책
+
+| 마일스톤 | 체크포인트 | 설명 |
+|---------|-----------|------|
+| M1 완료 | checkpoint_m1 | 코어 로직 완성 시점 |
+| M2 완료 | checkpoint_m2 | MVP 완성 시점 (중요) |
+| M3 완료 | checkpoint_m3 | 품질 개선 완료 |
+| M4 완료 | checkpoint_final | 최종 배포 |
+
+```bash
+# 체크포인트 생성 예시
+/checkpoint --name "m2_mvp_complete" --description "MVP 게임 완성"
+```
+
+---
+
+## ✅ 마일스톤 체크리스트
+
+- [x] 4개 마일스톤 정의
+- [x] 각 마일스톤 산출물 명시
+- [x] 성공 기준 정의
+- [x] 검증 방법 제공
+- [x] 타임라인 작성
+- [x] 체크포인트 정책 수립

package/template/stages/05-task-management/outputs/sprint_plan.md

@@ -0,0 +1,203 @@
+# 🏃 Snake Game - 스프린트 계획
+
+> 생성일: 2026-01-21
+> 스테이지: 05-task-management
+> 프로젝트: snake-game
+
+---
+
+## 스프린트 개요
+
+| 스프린트 | 기간 | 목표 | 태스크 수 |
+|---------|------|------|----------|
+| Sprint 1 | 06-implementation (전반) | MVP 기반 구축 | 10 |
+| Sprint 2 | 06-implementation (후반) | MVP 완성 | 8 |
+| Sprint 3 | 07-refactoring ~ 08-qa | 품질 개선 | 4 |
+| Sprint 4 | 09-testing ~ 10-deployment | 테스트 & 배포 | 3 |
+
+---
+
+## Sprint 1: MVP 기반 구축
+
+**목표**: 프로젝트 설정 + 게임 코어 로직 구현
+
+**스테이지**: 06-implementation (전반)
+
+### 태스크 목록
+
+| 순서 | ID | 태스크 | 우선순위 | 예상 시간 |
+|------|-----|--------|---------|----------|
+| 1 | TASK-001 | Vite + React + TS 초기화 | Must | 10분 |
+| 2 | TASK-002 | 타입 정의 | Must | 15분 |
+| 3 | TASK-003 | 상수 정의 | Must | 10분 |
+| 4 | TASK-004 | 글로벌 스타일 | Must | 15분 |
+| 5 | TASK-005 | useGameLoop 훅 | Must | 20분 |
+| 6 | TASK-007 | collision.ts | Must | 15분 |
+| 7 | TASK-009 | random.ts | Must | 10분 |
+| 8 | TASK-008 | renderer.ts | Must | 25분 |
+| 9 | TASK-006 | gameReducer | Must | 30분 |
+| 10 | TASK-016 | useKeyboard 훅 | Must | 20분 |
+
+**예상 총 시간**: ~2시간 50분
+
+### 완료 기준
+
+- [ ] 프로젝트 빌드 및 실행 가능
+- [ ] 타입 정의 완료 (tsc --noEmit 통과)
+- [ ] 게임 루프 동작 (콘솔에서 확인)
+- [ ] 충돌 감지 함수 동작
+- [ ] 렌더러 함수 동작 (빈 Canvas에 그리드 표시)
+- [ ] 키보드 입력 감지
+
+---
+
+## Sprint 2: MVP 완성
+
+**목표**: UI 컴포넌트 + 통합 + 확장 기능
+
+**스테이지**: 06-implementation (후반)
+
+### 태스크 목록
+
+| 순서 | ID | 태스크 | 우선순위 | 예상 시간 |
+|------|-----|--------|---------|----------|
+| 1 | TASK-011 | CanvasLayer 컴포넌트 | Must | 15분 |
+| 2 | TASK-012 | ScoreBoard 컴포넌트 | Must | 15분 |
+| 3 | TASK-014 | GameOverModal 컴포넌트 | Must | 20분 |
+| 4 | TASK-010 | GameEngine 통합 | Must | 30분 |
+| 5 | TASK-018 | 입력 통합 | Must | 15분 |
+| 6 | TASK-020 | useHighScore 훅 | Should | 15분 |
+| 7 | TASK-019 | 레벨 시스템 | Should | 20분 |
+| 8 | TASK-021 | 일시정지 기능 | Should | 15분 |
+
+**예상 총 시간**: ~2시간 25분
+
+### 완료 기준
+
+- [ ] 전체 게임 플레이 가능
+- [ ] 점수 표시 및 증가
+- [ ] 게임 오버 모달 동작
+- [ ] 최고 점수 저장/불러오기
+- [ ] 레벨업 시 속도 증가
+- [ ] 일시정지/재개 동작
+
+---
+
+## Sprint 3: 품질 개선
+
+**목표**: 모바일 지원 + 코드 리팩토링 + QA
+
+**스테이지**: 06-implementation (마무리) → 07-refactoring → 08-qa
+
+### 태스크 목록
+
+| 순서 | ID | 태스크 | 우선순위 | 예상 시간 | 스테이지 |
+|------|-----|--------|---------|----------|---------|
+| 1 | TASK-017 | useSwipe 훅 | Should | 25분 | 06 |
+| 2 | TASK-015 | MobileControls | Should | 25분 | 06 |
+| 3 | TASK-013 | StartScreen | Should | 20분 | 06 |
+| 4 | - | 코드 리팩토링 | Should | 30분 | 07 |
+| 5 | - | 성능 최적화 | Should | 20분 | 07 |
+| 6 | - | 버그 수정 | Must | 20분 | 08 |
+| 7 | - | 엣지 케이스 검증 | Should | 15분 | 08 |
+
+**예상 총 시간**: ~2시간 35분
+
+### 완료 기준
+
+- [ ] 모바일 터치/스와이프 동작
+- [ ] 모바일 D-Pad 컨트롤 동작
+- [ ] 시작 화면 구현
+- [ ] 코드 중복 제거
+- [ ] 60fps 유지 확인
+- [ ] 알려진 버그 0개
+
+---
+
+## Sprint 4: 테스트 & 배포
+
+**목표**: 테스트 작성 + 프로덕션 배포
+
+**스테이지**: 09-testing → 10-deployment
+
+### 태스크 목록
+
+| 순서 | ID | 태스크 | 우선순위 | 예상 시간 | 스테이지 |
+|------|-----|--------|---------|----------|---------|
+| 1 | TASK-022 | 단위 테스트 | Should | 30분 | 09 |
+| 2 | TASK-023 | E2E 테스트 | Could | 30분 | 09 |
+| 3 | TASK-024 | 빌드 설정 | Must | 15분 | 10 |
+| 4 | TASK-025 | 배포 | Must | 20분 | 10 |
+
+**예상 총 시간**: ~1시간 35분
+
+### 완료 기준
+
+- [ ] 테스트 커버리지 80%+
+- [ ] E2E 테스트 통과
+- [ ] 빌드 성공 (번들 < 200KB)
+- [ ] 배포 URL 접근 가능
+- [ ] 프로덕션에서 게임 플레이 가능
+
+---
+
+## 스프린트 타임라인
+
+```
+Sprint 1 (MVP 기반)       Sprint 2 (MVP 완성)
+[===================]    [===================]
+     ~2:50                    ~2:25
+
+Sprint 3 (품질 개선)      Sprint 4 (테스트 & 배포)
+[===================]    [===============]
+     ~2:35                    ~1:35
+
+────────────────────────────────────────────────
+              총 예상 시간: ~9시간 25분
+```
+
+---
+
+## 버퍼 및 리스크 관리
+
+### 버퍼 시간
+
+| 스프린트 | 예상 시간 | 버퍼 (20%) | 총 시간 |
+|---------|----------|-----------|--------|
+| Sprint 1 | 2:50 | 34분 | 3:24 |
+| Sprint 2 | 2:25 | 29분 | 2:54 |
+| Sprint 3 | 2:35 | 31분 | 3:06 |
+| Sprint 4 | 1:35 | 19분 | 1:54 |
+
+**총 예상 시간 (버퍼 포함)**: ~11시간 18분
+
+### 리스크 항목
+
+| 리스크 | 확률 | 영향 | 대응 |
+|--------|------|------|------|
+| 모바일 터치 이슈 | 중 | 중 | Sprint 3에서 해결, 폴백으로 D-Pad만 사용 |
+| 성능 이슈 | 낮 | 중 | requestAnimationFrame 최적화 |
+| 테스트 지연 | 중 | 낮 | E2E는 Could로 분류, 필요시 스킵 |
+
+---
+
+## 마일스톤 매핑
+
+| 마일스톤 | 완료 스프린트 | 검증 방법 |
+|---------|-------------|----------|
+| M1: MVP 기반 | Sprint 1 | 게임 루프 동작, 키보드 입력 |
+| M2: MVP 완성 | Sprint 2 | 전체 게임 플레이 가능 |
+| M3: 품질 개선 | Sprint 3 | 모바일 지원, 버그 0 |
+| M4: 배포 | Sprint 4 | 프로덕션 URL 접근 |
+
+---
+
+## ✅ 스프린트 계획 체크리스트
+
+- [x] 4개 스프린트 정의
+- [x] 태스크 배분
+- [x] 예상 시간 산정
+- [x] 완료 기준 정의
+- [x] 버퍼 시간 포함
+- [x] 리스크 관리 계획
+- [x] 마일스톤 매핑