create-ax-project 1.0.0

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

@@ -0,0 +1,105 @@
+# Stage 05: Task Management
+
+> ⚠️ **Notion 태스크 생성 규칙**
+> - 태스크는 반드시 **하나씩 순차적으로** 생성하세요
+> - 모든 태스크에 **Status** 필드 필수 (기본값: To Do)
+> - **Order** 필드로 순서 지정 (View 정렬은 수동 설정)
+> - 스키마: `templates/task_schema.yaml` | 가이드: `templates/notion_integration.md`
+
+태스크 분해 및 스프린트 계획 단계
+
+## 🎭 페르소나: Project Organizer
+
+> 당신은 Project Organizer입니다.
+> 모든 작업을 실행 가능한 작은 단위로 분해하세요.
+> 각 태스크는 명확한 완료 조건과 의존성을 가져야 합니다.
+
+### 특성
+- 체계적 분해
+- 의존성 분석
+- 우선순위 설정
+- 실행 가능성
+
+### 권장 행동
+- 작은 단위로 분해
+- 명확한 완료 조건
+- 의존성 명시
+- 실행 가능한 태스크
+
+### 지양 행동
+- 모호한 태스크
+- 거대한 단위
+- 의존성 무시
+
+### AI 설정
+- **Temperature**: 0.3 (높은 정밀도)
+- **정밀도**: High
+
+## 실행 모델
+- **Primary**: ClaudeCode (구조화된 태스크 분해)
+- **Mode**: Plan Mode
+
+## 목표
+1. 기능별 태스크 분해
+2. 의존성 맵핑
+3. 스프린트 계획 수립
+4. 마일스톤별 산출물 정의
+
+## 입력 파일
+- `../03-planning/outputs/project_plan.md`
+- `../03-planning/outputs/architecture.md`
+- `../04-ui-ux/outputs/design_system.md`
+- `../04-ui-ux/HANDOFF.md`
+
+## 출력 파일
+- `outputs/tasks.md` - 태스크 목록
+- `outputs/sprint_plan.md` - 스프린트 계획
+- `outputs/milestones.md` - 마일스톤 정의
+- `HANDOFF.md` - 다음 스테이지 인계 문서
+
+## 워크플로우
+
+### 1. 태스크 분해
+- 기능 → 에픽 → 스토리 → 태스크
+- 예상 작업량 산정
+- 기술적 의존성 파악
+
+### 2. 우선순위 결정
+- MoSCoW 분류
+- 비즈니스 가치 vs 기술 복잡도
+- 리스크 기반 우선순위
+
+### 3. 스프린트 계획
+- 스프린트 길이 결정
+- 용량 기반 할당
+- 버퍼 포함
+
+### 4. 마일스톤 정의
+- 체크포인트별 산출물
+- 성공 기준
+- 검증 방법
+
+## 태스크 형식
+```markdown
+## TASK-XXX: [태스크명]
+- **에픽**: [에픽명]
+- **스토리**: [유저스토리]
+- **우선순위**: Must/Should/Could
+- **예상 시간**: Xh
+- **의존성**: [TASK-YYY, TASK-ZZZ]
+- **담당 스테이지**: 06-implementation
+```
+
+## 완료 조건
+- [ ] 전체 태스크 목록 작성
+- [ ] 의존성 그래프 생성
+- [ ] 스프린트 3개 이상 계획
+- [ ] 마일스톤 산출물 정의
+- [ ] HANDOFF.md 생성
+
+## 다음 스테이지
+→ **06-implementation**: 핵심 기능 구현
+
+
+
+

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

@@ -0,0 +1,187 @@
+# 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/HANDOFF.md.template

@@ -0,0 +1,97 @@
+# Stage Handoff: 05-task-management → 06-implementation
+
+**생성일**: {{TIMESTAMP}}
+**생성자**: ClaudeCode
+**소요 시간**: {{DURATION}}
+
+---
+
+## 완료된 작업
+
+- [ ] 태스크 분해 (총 {{TASK_COUNT}}개)
+- [ ] 의존성 맵핑
+- [ ] 스프린트 계획 ({{SPRINT_COUNT}}개)
+- [ ] 마일스톤 정의
+- [ ] HANDOFF.md 생성
+
+---
+
+## 다음 에이전트를 위한 컨텍스트
+
+### 스프린트 1 태스크 (즉시 시작)
+
+| ID | 태스크 | 우선순위 | 의존성 |
+|----|--------|----------|--------|
+| {{TASK_1_ID}} | {{TASK_1}} | Must | - |
+| {{TASK_2_ID}} | {{TASK_2}} | Must | {{DEP_2}} |
+| {{TASK_3_ID}} | {{TASK_3}} | Should | {{DEP_3}} |
+
+### 의존성 요약
+```mermaid
+graph TD
+    {{DEPENDENCY_GRAPH}}
+```
+
+### 마일스톤
+
+| 마일스톤 | 목표 | 완료 기준 |
+|----------|------|-----------|
+| M1 | {{M1_GOAL}} | {{M1_CRITERIA}} |
+| M2 | {{M2_GOAL}} | {{M2_CRITERIA}} |
+
+### 기술적 주의사항
+- {{TECH_NOTE_1}}
+- {{TECH_NOTE_2}}
+
+---
+
+## 생성된 산출물
+
+| 파일 | 설명 |
+|------|------|
+| tasks.md | 전체 태스크 목록 |
+| sprint_plan.md | 스프린트 계획 |
+| milestones.md | 마일스톤 정의 |
+
+---
+
+## 06-implementation 스테이지 가이드
+
+### 즉시 실행할 작업
+1. 프로젝트 초기화 (scaffolding)
+2. 공통 컴포넌트 구현
+3. {{FIRST_FEATURE}} 구현 시작
+
+### 구현 순서 권장
+1. {{IMPL_ORDER_1}}
+2. {{IMPL_ORDER_2}}
+3. {{IMPL_ORDER_3}}
+
+### 체크포인트 트리거
+- 스프린트 1 완료 시
+- 핵심 기능 구현 완료 시
+
+---
+
+## AI 호출 기록
+
+| AI | 호출 시간 | 프롬프트 | 결과 | 상태 |
+|----|----------|---------|------|------|
+| {{AI_1}} | {{TIME_1}} | {{PROMPT_1}} | {{OUTPUT_1}} | {{STATUS_1}} |
+| {{AI_2}} | {{TIME_2}} | {{PROMPT_2}} | {{OUTPUT_2}} | {{STATUS_2}} |
+
+> 설정: `config/ai_logging.yaml`
+
+---
+
+## 메타데이터
+
+```yaml
+stage: "05-task-management"
+status: "completed"
+next_stage: "06-implementation"
+models_used:
+  - claudecode
+total_tasks: {{TASK_COUNT}}
+total_sprints: {{SPRINT_COUNT}}
+```

package/template/stages/05-task-management/config.yaml

@@ -0,0 +1,81 @@
+# Stage 05: Task Management Configuration
+
+stage:
+  id: "05-task-management"
+  name: "Task Management"
+  description: "태스크 분해 및 스프린트 계획"
+
+models:
+  primary: "claudecode"
+  secondary: null
+  collaboration: null
+
+execution:
+  mode: "plan"
+  container: false
+  sandbox: false
+  timeout: 1800  # 30 minutes
+
+inputs:
+  required:
+    - name: "../03-planning/outputs/project_plan.md"
+    - name: "../03-planning/outputs/architecture.md"
+    - name: "../04-ui-ux/HANDOFF.md"
+  optional:
+    - name: "../04-ui-ux/outputs/design_system.md"
+    - name: "../01-brainstorm/outputs/requirements_analysis.md"
+
+outputs:
+  required:
+    - name: "tasks.md"
+      description: "태스크 목록"
+    - name: "sprint_plan.md"
+      description: "스프린트 계획"
+    - name: "milestones.md"
+      description: "마일스톤 정의"
+    - name: "HANDOFF.md"
+
+# Notion 연동 설정 (Issue #4, #5, #6, #8, #16 해결)
+notion_integration:
+  enabled: true
+  schema: "templates/task_schema.yaml"
+  guide: "templates/notion_integration.md"
+
+  # 태스크 생성 규칙
+  task_creation:
+    mode: "sequential"     # 순차 생성 필수!
+    batch_size: 1          # 한 번에 하나씩
+    delay_ms: 100          # 생성 간 딜레이
+
+  # 필수 필드
+  required_fields:
+    - "Task Name"
+    - "Status"             # Issue #16: 필수!
+    - "Order"              # Issue #5: 정렬용!
+
+  # 기본값
+  defaults:
+    status: "To Do"
+    priority: "Medium"
+
+prompts:
+  - name: "task_breakdown"
+    file: "prompts/task_breakdown.md"
+    model: "claudecode"
+  - name: "sprint_planning"
+    file: "prompts/sprint_planning.md"
+    model: "claudecode"
+
+completion:
+  checklist:
+    - "전체 태스크 목록 작성"
+    - "의존성 그래프 생성"
+    - "스프린트 3개 이상 계획"
+    - "마일스톤 산출물 정의"
+
+transition:
+  next_stage: "06-implementation"
+  prerequisites:
+    - "04-ui-ux"
+  handoff_required: true
+  checkpoint_required: false