create-ax-project 1.0.0 → 1.0.1

package/template/stages/05-task-management/HANDOFF.md

@@ -1,187 +0,0 @@
-# HANDOFF: 05-task-management → 06-implementation
-
-> 생성일: 2026-01-21
-> 프로젝트: snake-game
-> 현재 스테이지: 05-task-management (완료)
-> 다음 스테이지: 06-implementation
-
----
-
-## ✅ 완료된 작업
-
-- [x] 25개 태스크 분해 (6개 에픽)
-- [x] 4개 스프린트 계획
-- [x] 4개 마일스톤 정의
-- [x] 의존성 그래프 작성
-- [x] 우선순위 지정 (MoSCoW)
-
----
-
-## 📁 생성된 산출물
-
-| 파일 | 설명 |
-|------|------|
-| `outputs/tasks.md` | 25개 태스크 상세 목록 |
-| `outputs/sprint_plan.md` | 4개 스프린트 계획 |
-| `outputs/milestones.md` | 4개 마일스톤 정의 |
-| `HANDOFF.md` | 이 문서 |
-
----
-
-## 🚀 06-implementation 즉시 실행 태스크
-
-### Sprint 1 태스크 (순서대로)
-
-| 순서 | ID | 태스크 | 예상 시간 |
-|------|-----|--------|----------|
-| 1 | TASK-001 | Vite + React + TS 프로젝트 초기화 | 10분 |
-| 2 | TASK-002 | 타입 정의 (types/index.ts) | 15분 |
-| 3 | TASK-003 | 상수 정의 (constants/config.ts) | 10분 |
-| 4 | TASK-004 | 글로벌 스타일 (styles/index.css) | 15분 |
-| 5 | TASK-005 | useGameLoop 훅 | 20분 |
-| 6 | TASK-007 | collision.ts | 15분 |
-| 7 | TASK-009 | random.ts | 10분 |
-| 8 | TASK-008 | renderer.ts | 25분 |
-| 9 | TASK-006 | gameReducer | 30분 |
-| 10 | TASK-016 | useKeyboard 훅 | 20분 |
-
----
-
-## 📐 프로젝트 구조 (목표)
-
-```
-snake-game/
-├── public/
-│   └── favicon.svg
-├── src/
-│   ├── components/
-│   │   ├── CanvasLayer.tsx
-│   │   ├── CanvasLayer.module.css
-│   │   ├── ScoreBoard.tsx
-│   │   ├── ScoreBoard.module.css
-│   │   ├── StartScreen.tsx
-│   │   ├── GameOverModal.tsx
-│   │   └── MobileControls.tsx
-│   │
-│   ├── hooks/
-│   │   ├── useGameLoop.ts
-│   │   ├── useKeyboard.ts
-│   │   ├── useSwipe.ts
-│   │   └── useHighScore.ts
-│   │
-│   ├── engine/
-│   │   ├── gameReducer.ts
-│   │   ├── collision.ts
-│   │   └── renderer.ts
-│   │
-│   ├── types/
-│   │   └── index.ts
-│   │
-│   ├── constants/
-│   │   └── config.ts
-│   │
-│   ├── utils/
-│   │   └── random.ts
-│   │
-│   ├── styles/
-│   │   └── index.css
-│   │
-│   ├── App.tsx
-│   ├── GameEngine.tsx
-│   └── main.tsx
-│
-├── index.html
-├── package.json
-├── tsconfig.json
-└── vite.config.ts
-```
-
----
-
-## 🎯 핵심 구현 사항
-
-### 1. 타입 정의 (TASK-002)
-
-```typescript
-// 필수 타입
-export interface Point { x: number; y: number; }
-export type Direction = 'UP' | 'DOWN' | 'LEFT' | 'RIGHT';
-export type GameStatus = 'IDLE' | 'PLAYING' | 'PAUSED' | 'GAME_OVER';
-export interface GameState { ... }
-export type GameAction = { type: '...' } | ...;
-```
-
-### 2. 게임 설정 (TASK-003)
-
-```typescript
-export const GAME_CONFIG = {
-  boardSize: 20,
-  cellSize: 20,
-  initialSpeed: 150,
-  speedDecrement: 10,
-  minSpeed: 50,
-  pointsPerFood: 10,
-  pointsForLevelUp: 50,
-};
-```
-
-### 3. 디자인 토큰 (TASK-004)
-
-```css
-:root {
-  --color-primary: #00ff88;
-  --color-secondary: #ff6b6b;
-  --color-bg: #1a1a2e;
-  --color-surface: #16213e;
-}
-```
-
----
-
-## ⚠️ 주의사항
-
-1. **순서 준수**: 의존성 순서대로 구현
-2. **타입 우선**: 모든 코드에 타입 적용
-3. **함수형 컴포넌트**: Class 컴포넌트 금지
-4. **CSS Modules**: 스타일 스코프 격리
-5. **외부 엔진 금지**: 순수 React + Canvas
-
----
-
-## 📊 예상 시간
-
-| 항목 | 시간 |
-|------|------|
-| Sprint 1 (MVP 기반) | ~2시간 50분 |
-| Sprint 2 (MVP 완성) | ~2시간 25분 |
-| **06-implementation 총계** | ~5시간 15분 |
-
----
-
-## 🔗 참조 문서
-
-| 문서 | 경로 |
-|------|------|
-| 아키텍처 | `stages/03-planning/outputs/architecture.md` |
-| 기술 스택 | `stages/03-planning/outputs/tech_stack.md` |
-| 구현 규칙 | `stages/03-planning/outputs/implementation.yaml` |
-| 와이어프레임 | `stages/04-ui-ux/outputs/wireframes.md` |
-| 디자인 시스템 | `stages/04-ui-ux/outputs/design_system.md` |
-
----
-
-## 🚀 다음 단계
-
-```bash
-# 다음 스테이지 실행
-/run-stage 06-implementation
-
-# 또는
-/implement
-```
-
----
-
-**생성자**: ClaudeCode
-**검토자**: -
-**승인**: 대기

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

@@ -1,253 +0,0 @@
-# 🎯 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

@@ -1,203 +0,0 @@
-# 🏃 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] 마일스톤 매핑