create-ax-project 1.0.0 → 1.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-ax-project",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Multi-AI Workflow Pipeline - Create new projects with 10-stage development workflow",
   "type": "module",
   "bin": {

package/template/.claude/CLAUDE.md

@@ -1,7 +0,0 @@
-<claude-mem-context>
-# Recent Activity
-
-<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
-
-*No recent activity*
-</claude-mem-context>

package/template/stages/01-brainstorm/HANDOFF.md

@@ -1,110 +0,0 @@
-# HANDOFF: 01-brainstorm → 02-research
-
-> 생성일: 2026-01-21
-> 프로젝트: snake-game
-> 현재 스테이지: 01-brainstorm (완료)
-> 다음 스테이지: 02-research
-
----
-
-## ✅ 완료된 작업
-
-- [x] 프로젝트 브리프 작성 (`inputs/project_brief.md`)
-- [x] 핵심 기능 아이디어 12개 브레인스토밍
-- [x] 사용자 페르소나 3개 정의
-- [x] 유사 프로젝트 사례 조사
-- [x] 장단점 분석 완료
-- [x] MVP 범위 제안
-
----
-
-## 📋 핵심 결정사항
-
-### 1. 기술 스택 방향
-- **렌더링**: Canvas (성능 우선, 모바일 지원)
-- **상태관리**: useReducer + Custom Hook
-- **게임 루프**: requestAnimationFrame
-
-### 2. MVP 기능 범위
-| 우선순위 | 기능 |
-|---------|------|
-| 🔴 필수 | 기본 조작, 먹이 시스템, 충돌 감지, 점수, 재시작 |
-| 🟡 중요 | 레벨 시스템, 하이스코어 저장, 일시정지, 모바일 터치 |
-| 🟢 선택 | Combo System, Portal Edges, Different Food |
-
-### 3. 타겟 사용자 (우선순위)
-1. **Persona A**: 캐주얼 게이머 (모바일, 5-10분 플레이)
-2. **Persona B**: 경쟁적 게이머 (데스크톱, 하이스코어 추구)
-3. **Persona C**: 레트로 팬 (클래식 스타일 선호)
-
----
-
-## 📁 생성된 산출물
-
-| 파일 | 설명 |
-|------|------|
-| `inputs/project_brief.md` | 프로젝트 개요 및 요구사항 |
-| `outputs/ideas.md` | 브레인스토밍 아이디어 (12개) |
-| `outputs/requirements_analysis.md` | 요구사항 분석 |
-| `HANDOFF.md` | 이 문서 |
-
----
-
-## 🔜 다음 스테이지 즉시 실행 작업
-
-### 02-research에서 조사할 항목
-
-1. **Canvas 게임 루프 구현 방법**
-   - requestAnimationFrame vs setInterval
-   - 최적화 기법 (더블 버퍼링)
-
-2. **React + Canvas 통합 패턴**
-   - useRef로 Canvas 접근
-   - Canvas 리렌더링 최소화
-
-3. **모바일 터치 이벤트 처리**
-   - touchstart/touchmove/touchend
-   - 스와이프 방향 감지 로직
-
-4. **localStorage 하이스코어 저장**
-   - 데이터 구조 설계
-   - 보안 고려사항
-
-5. **충돌 감지 알고리즘**
-   - O(n) 자기 몸 충돌
-   - 최적화 방안
-
----
-
-## ⚠️ 주의사항
-
-1. **외부 게임 엔진 미사용**: Phaser, PixiJS 등 금지
-2. **순수 React 구현**: jQuery 미사용
-3. **정적 배포 가능**: 백엔드 서버 없음
-
----
-
-## 📊 AI 호출 기록
-
-| AI | 시간 | 프롬프트 | 결과 | 상태 |
-|----|------|---------|------|------|
-| Gemini | 11:58 | Snake Game 브레인스토밍 | 12개 아이디어, 3 페르소나 | ✅ |
-| ClaudeCode | 11:57 | 결과 구조화 | ideas.md, HANDOFF.md | ✅ |
-
----
-
-## 🚀 다음 단계
-
-```bash
-# 다음 스테이지 실행
-/run-stage 02-research
-
-# 또는
-/research
-```
-
----
-
-**생성자**: ClaudeCode
-**검토자**: -
-**승인**: 대기

package/template/stages/01-brainstorm/inputs/project_brief.md

@@ -1,40 +0,0 @@
-# Project Brief: Snake Game
-
-## 프로젝트 이름
-Snake Game
-
-## 한 줄 설명
-클래식 스네이크 게임의 현대적 웹 버전
-
-## 문제 정의
-간단하지만 중독성 있는 캐주얼 게임 필요
-
-## 타겟 사용자
-- 짧은 시간 게임을 즐기고 싶은 사용자
-- 레트로 게임 팬
-- 모바일/데스크톱 모두에서 게임을 원하는 사용자
-
-## 핵심 기능
-1. 방향키/터치로 뱀 조작
-2. 먹이 수집 및 성장
-3. 충돌 감지 (벽, 자기 몸)
-4. 점수 시스템
-
-## 기술 요구사항
-- React + TypeScript
-- Vite 빌드 도구
-- Canvas 또는 CSS Grid 기반 렌더링
-- 반응형 디자인 (모바일 지원)
-
-## 성공 지표
-- 게임 플레이 가능 (기본 기능 완성)
-- 모바일/데스크톱 모두 지원
-- 테스트 커버리지 80% 이상
-- 배포 완료 (GitHub Pages 또는 Vercel)
-
-## 타임라인
-- 전체 파이프라인 (01~10): 약 4시간
-
-## 제약사항
-- 외부 게임 엔진 미사용 (순수 React)
-- 복잡한 백엔드 없음 (프론트엔드 only)

package/template/stages/01-brainstorm/outputs/ideas.md

@@ -1,159 +0,0 @@
-# 🐍 Snake Game - 브레인스토밍 아이디어
-
-> 생성일: 2026-01-21
-> 스테이지: 01-brainstorm
-> 프로젝트: snake-game
-> AI 도구: Gemini CLI + ClaudeCode
-
----
-
-## 📋 핵심 기능 아이디어 (12개)
-
-### 🎮 기본 게임플레이 (필수)
-
-| # | 아이디어 | 설명 | 우선순위 |
-|---|---------|------|---------|
-| 1 | **기본 뱀 조작** | 방향키(↑↓←→)로 뱀 이동 | 🔴 필수 |
-| 2 | **먹이 시스템** | 먹이를 먹으면 뱀 길이 +1, 점수 +10 | 🔴 필수 |
-| 3 | **충돌 감지** | 벽/자기 몸 충돌 시 게임 오버 | 🔴 필수 |
-| 4 | **점수 시스템** | 실시간 점수 표시 | 🔴 필수 |
-| 5 | **게임 재시작** | 게임 오버 후 다시 시작 기능 | 🔴 필수 |
-
-### ⭐ Gemini 제안 기능
-
-| # | 아이디어 | 설명 | 우선순위 |
-|---|---------|------|---------|
-| 6 | **Dash / Sprint** | 제한된 스태미나로 2배속 이동 | 🟢 선택 |
-| 7 | **Ghost Mode** | 자기 몸 통과 파워업 (5초) | 🟢 선택 |
-| 8 | **Dynamic Obstacles** | 10초마다 위치 변경되는 장애물 | 🟢 선택 |
-| 9 | **Combo System** | 연속 먹이 획득 시 점수 배율 (x1→x2→x4) | 🟡 중요 |
-| 10 | **Portal Edges** | 벽 통과 시 반대편으로 이동 (팩맨 스타일) | 🟡 중요 |
-| 11 | **Different Food Types** | 사과(+1), 황금사과(점수만), 고추(속도↑), 얼음(속도↓) | 🟢 선택 |
-| 12 | **Puzzle Levels** | 미로 레벨에서 모든 먹이 수집 | 🟢 선택 |
-
----
-
-## 📊 장단점 분석 (Gemini 분석)
-
-| 아이디어 | 장점 | 단점 |
-|:---------|:-----|:-----|
-| **Dash / Sprint** | 스킬 요소 추가, "클러치" 모멘트 | 속도로 인한 실수 충돌 가능 |
-| **Ghost Mode** | 초보자 친화적, 좌절감 감소 | 너무 쉬워질 수 있음 |
-| **Dynamic Obstacles** | 신선함 유지, 안전지대 캠핑 방지 | 불공정하게 느껴질 수 있음 |
-| **Combo System** | 공격적이고 위험한 플레이 유도 | UI 복잡해짐 (타이머 표시) |
-| **Portal Edges** | 클래식하고 만족스러운 플로우 | "코너 함정" 긴장감 감소 |
-| **Different Food** | 전략적 깊이 (위험 vs 보상) | 플레이어가 색상별 효과 기억 필요 |
-| **Puzzle Levels** | 명확한 진행감/완료감 | 무한 모드 대비 재플레이성 낮음 |
-
----
-
-## 👥 사용자 페르소나 (Gemini 생성)
-
-### 페르소나 A: "The Commuter" (캐주얼)
-- **인구통계**: 28세 직장인
-- **행동**: 지하철에서 모바일로 5-10분 플레이
-- **니즈**:
-  - 한 손 조작 (스와이프)
-  - 빠른 시작 (로딩 없음)
-  - 오프라인 가능
-  - 브라우저 닫아도 자동 저장
-- **불만**: 복잡한 메뉴, 작은 버튼, 광고
-
-### 페르소나 B: "The High-Scorer" (경쟁적)
-- **인구통계**: 16세 학생
-- **행동**: 쉬는 시간에 데스크톱 PC로 플레이, 리더보드에 집착
-- **니즈**:
-  - 정밀한 키보드 조작 (입력 지연 제로)
-  - 고대비 시각 (장애물 명확히 보임)
-  - 즉시 재시작 기능 ("R" 키)
-  - 글로벌 리더보드
-- **불만**: 불공정한 RNG, 랙, 느린 애니메이션
-
-### 페르소나 C: "The Retro Fan" (향수)
-- **인구통계**: 40세 개발자
-- **행동**: 픽셀 아트와 칩튠 음악 선호, 휴식용 플레이
-- **니즈**:
-  - 클래식 CRT 필터 또는 픽셀아트 미학
-  - 단순하고 "순수한" 게임플레이
-  - 게임패드/컨트롤러 지원
-- **불만**: 과도하게 현대적인 "화려한" 효과, 소액결제
-
----
-
-## 🔍 유사 프로젝트 사례 (Gemini 조사)
-
-### 1. Google Snake (검색 이스터에그)
-- **특징**: "접근 가능한" 스네이크의 표준
-- **핵심 기능**: 토글 가능한 모드 (속도, 포털, 평화 모드)
-
-### 2. Slither.io
-- **특징**: "현대 멀티플레이어" 시대 정의
-- **핵심 기능**: 마우스 따라가기 (아날로그), "차단" 메카닉
-
-### 3. Classic Nokia Snake (Snake II)
-- **특징**: 장르의 기초
-- **핵심 기능**: 단색, 그리드 기반, 벽 랩어라운드 옵션
-
-### 4. React-Snake (GitHub Topics)
-- **공통 기술 스택 패턴**:
-  - `useInterval` 훅으로 게임 루프
-  - 좌표 배열 `[{x,y}, {x,y}]`로 뱀 몸통
-  - CSS Grid (쉬움) vs HTML5 Canvas (성능 좋음)
-  - Redux/Zustand로 하이스코어 관리
-
----
-
-## 🎯 MVP 권장사항 (Gemini 제안)
-
-**페르소나 A (The Commuter)**와 **페르소나 B (The Competitive)**를 염두에 두고:
-
-### 기술 스택
-- **렌더링**: React + Canvas (모바일 성능 우선)
-- **입력**: 키보드 (Arrow/WASD) + 모바일 스와이프
-
-### MVP 기능 세트
-- [x] 클래식 무한 모드
-- [x] LocalStorage에 하이스코어 저장
-- [x] 3단계 속도 (느림, 보통, 빠름)
-- [x] "즉시 재시작" (한 번 더 시도 루프)
-
----
-
-## 📊 최종 우선순위 매트릭스
-
-```
-                    높은 가치
-                        │
-    ┌───────────────────┼───────────────────┐
-    │  Combo System     │  기본 조작        │
-    │  Portal Edges     │  먹이 시스템      │
-    │  레벨 시스템      │  충돌 감지        │
-    │                   │  점수 시스템      │
-적은 ─────────────────────────────────────── 많은
-노력  │                   │  게임 재시작      │ 노력
-    │  일시정지         │                   │
-    │  하이스코어 저장  │  Different Food   │
-    │                   │  Ghost Mode       │
-    └───────────────────┼───────────────────┘
-                        │
-                    낮은 가치
-```
-
----
-
-## ✅ 브레인스토밍 완료 체크리스트
-
-- [x] 최소 10개 아이디어 생성 (12개 완료)
-- [x] 3개 이상 사용자 페르소나 정의 (3개 완료)
-- [x] 각 아이디어 장단점 분석
-- [x] 유사 프로젝트 조사
-- [x] MVP 범위 제안
-
----
-
-## 📝 AI 호출 기록
-
-| AI | 호출 시간 | 프롬프트 | 결과 | 상태 |
-|----|----------|---------|------|------|
-| Gemini | 2026-01-21 11:58 | Snake Game 브레인스토밍 | 12개 아이디어, 3 페르소나, 사례 조사 | ✅ 성공 |
-| ClaudeCode | 2026-01-21 11:57 | 결과 구조화 | ideas.md 작성 | ✅ 성공 |

package/template/stages/01-brainstorm/outputs/requirements_analysis.md

@@ -1,222 +0,0 @@
-# 📋 Snake Game - 요구사항 분석
-
-> 생성일: 2026-01-21
-> 스테이지: 01-brainstorm
-> 프로젝트: snake-game
-
----
-
-## 1. 기능적 요구사항 (Functional Requirements)
-
-### FR-01: 게임 시작/종료
-| ID | 요구사항 | 상세 | 우선순위 |
-|----|---------|------|---------|
-| FR-01-1 | 게임 시작 | 시작 버튼 클릭 또는 스페이스바로 게임 시작 | 필수 |
-| FR-01-2 | 게임 종료 | 충돌 시 게임 오버 화면 표시 | 필수 |
-| FR-01-3 | 재시작 | 게임 오버 후 재시작 버튼 제공 | 필수 |
-| FR-01-4 | 일시정지 | P키 또는 버튼으로 일시정지/재개 | 중요 |
-
-### FR-02: 뱀 조작
-| ID | 요구사항 | 상세 | 우선순위 |
-|----|---------|------|---------|
-| FR-02-1 | 키보드 조작 | 방향키(↑↓←→)로 이동 방향 변경 | 필수 |
-| FR-02-2 | 터치 조작 | 스와이프 또는 방향 버튼으로 조작 | 중요 |
-| FR-02-3 | 연속 이동 | 뱀은 자동으로 현재 방향으로 이동 | 필수 |
-| FR-02-4 | 반대 방향 제한 | 즉시 반대 방향 이동 불가 (자기 충돌 방지) | 필수 |
-
-### FR-03: 먹이 시스템
-| ID | 요구사항 | 상세 | 우선순위 |
-|----|---------|------|---------|
-| FR-03-1 | 먹이 생성 | 게임 보드 내 랜덤 위치에 먹이 생성 | 필수 |
-| FR-03-2 | 먹이 획득 | 뱀 머리가 먹이와 충돌 시 획득 | 필수 |
-| FR-03-3 | 성장 | 먹이 획득 시 뱀 길이 +1 | 필수 |
-| FR-03-4 | 새 먹이 | 먹이 획득 후 즉시 새 먹이 생성 | 필수 |
-
-### FR-04: 충돌 감지
-| ID | 요구사항 | 상세 | 우선순위 |
-|----|---------|------|---------|
-| FR-04-1 | 벽 충돌 | 보드 경계 충돌 시 게임 오버 | 필수 |
-| FR-04-2 | 자기 충돌 | 뱀이 자기 몸과 충돌 시 게임 오버 | 필수 |
-| FR-04-3 | 장애물 충돌 | (선택) 장애물과 충돌 시 게임 오버 | 선택 |
-
-### FR-05: 점수 시스템
-| ID | 요구사항 | 상세 | 우선순위 |
-|----|---------|------|---------|
-| FR-05-1 | 점수 표시 | 현재 점수 실시간 표시 | 필수 |
-| FR-05-2 | 점수 계산 | 먹이당 10점 (레벨에 따라 보너스) | 필수 |
-| FR-05-3 | 최고 점수 | 최고 점수 저장 및 표시 | 중요 |
-| FR-05-4 | 점수 저장 | localStorage에 하이스코어 저장 | 중요 |
-
-### FR-06: 레벨 시스템
-| ID | 요구사항 | 상세 | 우선순위 |
-|----|---------|------|---------|
-| FR-06-1 | 레벨 표시 | 현재 레벨 표시 | 중요 |
-| FR-06-2 | 레벨업 조건 | 50점마다 레벨 증가 | 중요 |
-| FR-06-3 | 속도 증가 | 레벨당 10% 속도 증가 | 중요 |
-| FR-06-4 | 최대 레벨 | 레벨 10 이후 속도 고정 | 중요 |
-
----
-
-## 2. 비기능적 요구사항 (Non-Functional Requirements)
-
-### NFR-01: 성능
-| ID | 요구사항 | 목표 | 측정 방법 |
-|----|---------|------|----------|
-| NFR-01-1 | 프레임레이트 | 60fps 유지 | Chrome DevTools |
-| NFR-01-2 | 초기 로딩 | 2초 이내 | Lighthouse |
-| NFR-01-3 | 입력 지연 | 16ms 이내 | 수동 테스트 |
-| NFR-01-4 | 번들 크기 | 200KB 이하 | 빌드 분석 |
-
-### NFR-02: 호환성
-| ID | 요구사항 | 대상 | 비고 |
-|----|---------|------|------|
-| NFR-02-1 | 데스크톱 브라우저 | Chrome, Firefox, Safari, Edge 최신 2버전 | |
-| NFR-02-2 | 모바일 브라우저 | iOS Safari, Android Chrome | |
-| NFR-02-3 | 화면 크기 | 320px ~ 1920px | 반응형 |
-
-### NFR-03: 접근성
-| ID | 요구사항 | 상세 |
-|----|---------|------|
-| NFR-03-1 | 키보드 네비게이션 | 모든 UI 키보드로 접근 가능 |
-| NFR-03-2 | 색상 대비 | WCAG AA 기준 충족 |
-| NFR-03-3 | 포커스 표시 | 명확한 포커스 인디케이터 |
-
-### NFR-04: 코드 품질
-| ID | 요구사항 | 기준 |
-|----|---------|------|
-| NFR-04-1 | 타입 안전성 | TypeScript strict 모드 |
-| NFR-04-2 | 린트 | ESLint 규칙 통과 |
-| NFR-04-3 | 테스트 커버리지 | 80% 이상 |
-| NFR-04-4 | 코드 포맷 | Prettier 적용 |
-
----
-
-## 3. 기술적 제약조건
-
-### 필수 기술 스택
-- **프론트엔드**: React 18+
-- **언어**: TypeScript 5+
-- **빌드 도구**: Vite
-- **렌더링**: Canvas API
-
-### 금지 사항
-- 외부 게임 엔진 (Phaser, PixiJS 등) 미사용
-- jQuery 미사용
-- 백엔드 서버 미사용 (정적 배포)
-
-### 권장 사항
-- Custom Hook으로 로직 분리
-- 컴포넌트 단위 테스트 작성
-- CSS Modules 또는 Tailwind CSS
-
----
-
-## 4. 데이터 모델
-
-### 게임 상태 (GameState)
-```typescript
-interface GameState {
-  status: 'idle' | 'playing' | 'paused' | 'gameover';
-  score: number;
-  level: number;
-  highScore: number;
-}
-```
-
-### 뱀 (Snake)
-```typescript
-interface Position {
-  x: number;
-  y: number;
-}
-
-interface Snake {
-  body: Position[];
-  direction: 'UP' | 'DOWN' | 'LEFT' | 'RIGHT';
-}
-```
-
-### 먹이 (Food)
-```typescript
-interface Food {
-  position: Position;
-  type: 'normal' | 'bonus';
-}
-```
-
-### 게임 설정 (GameConfig)
-```typescript
-interface GameConfig {
-  boardWidth: number;
-  boardHeight: number;
-  cellSize: number;
-  initialSpeed: number;
-  speedIncrement: number;
-}
-```
-
----
-
-## 5. 사용자 시나리오
-
-### 시나리오 1: 첫 게임 플레이
-1. 사용자가 웹사이트 접속
-2. "Start Game" 버튼 표시됨
-3. 버튼 클릭 또는 스페이스바로 게임 시작
-4. 뱀이 화면 중앙에서 시작
-5. 방향키로 뱀 조작
-6. 먹이를 먹으면 점수 증가
-7. 벽 또는 자기 몸과 충돌하면 게임 오버
-8. "Game Over" 화면과 최종 점수 표시
-9. "Restart" 버튼으로 재시작
-
-### 시나리오 2: 최고 점수 갱신
-1. 게임 플레이 중 현재 점수가 최고 점수 초과
-2. 화면에 "New High Score!" 표시
-3. 게임 오버 시 최고 점수 localStorage에 저장
-4. 다음 게임 시작 시 저장된 최고 점수 표시
-
-### 시나리오 3: 모바일 플레이
-1. 모바일 기기로 접속
-2. 화면이 모바일 크기에 맞게 조정됨
-3. 화면 하단에 방향 버튼 표시
-4. 터치/스와이프로 뱀 조작
-5. 세로 모드에서 최적화된 레이아웃
-
----
-
-## 6. 인수 기준 (Acceptance Criteria)
-
-### 게임 기본 기능
-- [ ] 게임 시작 시 뱀이 화면 중앙에 나타난다
-- [ ] 방향키 입력에 따라 뱀이 즉시 방향을 바꾼다
-- [ ] 뱀이 먹이를 먹으면 길이가 1 증가한다
-- [ ] 먹이를 먹으면 점수가 10점 증가한다
-- [ ] 벽에 부딪히면 게임이 끝난다
-- [ ] 자기 몸에 부딪히면 게임이 끝난다
-- [ ] 게임 오버 후 재시작할 수 있다
-
-### 추가 기능
-- [ ] 50점마다 레벨이 1 증가한다
-- [ ] 레벨이 오르면 뱀의 속도가 빨라진다
-- [ ] 최고 점수가 브라우저에 저장된다
-- [ ] P키를 누르면 일시정지된다
-- [ ] 모바일에서 터치로 조작할 수 있다
-
-### 품질 기준
-- [ ] TypeScript 타입 에러가 없다
-- [ ] ESLint 경고/에러가 없다
-- [ ] 테스트 커버리지 80% 이상
-- [ ] 60fps로 부드럽게 동작한다
-
----
-
-## 📝 요약
-
-| 카테고리 | 필수 | 중요 | 선택 |
-|---------|------|------|------|
-| 기능적 요구사항 | 12개 | 8개 | 2개 |
-| 비기능적 요구사항 | 8개 | 3개 | 0개 |
-| 총계 | 20개 | 11개 | 2개 |
-
-**MVP 범위**: 필수 요구사항 20개 + 중요 요구사항 중 선택 5개