create-ax-project 1.0.0

package/template/stages/02-research/prompts/market_analysis.md

@@ -0,0 +1,58 @@
+# Market Analysis Prompt
+
+## 사용 모델
+Claude (MCP 서버 연동)
+
+## 프롬프트
+
+```
+당신은 시장 분석 전문가입니다.
+
+다음 프로젝트의 시장 분석을 수행해주세요:
+
+---
+## 프로젝트 개요
+{{PROJECT_OVERVIEW}}
+
+## 타겟 시장
+{{TARGET_MARKET}}
+---
+
+## 분석 항목
+
+### 1. 시장 규모
+- TAM (Total Addressable Market)
+- SAM (Serviceable Addressable Market)
+- SOM (Serviceable Obtainable Market)
+
+### 2. 경쟁사 분석
+최소 3개 경쟁사에 대해:
+
+| 경쟁사 | 강점 | 약점 | 가격 | 타겟 | 차별점 |
+|--------|------|------|------|------|--------|
+
+### 3. 시장 트렌드
+- 성장 트렌드
+- 기술 트렌드
+- 사용자 행동 변화
+
+### 4. 진입 장벽
+- 기술적 장벽
+- 자본 장벽
+- 네트워크 효과
+- 규제 장벽
+
+### 5. 기회와 위협 (SWOT 일부)
+- Opportunities
+- Threats
+
+## MCP 활용
+- firecrawl: 경쟁사 웹사이트 크롤링
+- exa: 시장 리포트 및 뉴스 검색
+
+## 출력 형식
+구조화된 시장 분석 보고서
+```
+
+## 기대 출력
+`outputs/market_analysis.md`

package/template/stages/02-research/prompts/tech_stack.md

@@ -0,0 +1,60 @@
+# Tech Stack Research Prompt
+
+## 사용 모델
+Claude (MCP 서버 연동)
+
+## 프롬프트
+
+```
+당신은 시니어 솔루션 아키텍트입니다.
+
+다음 요구사항을 바탕으로 최적의 기술 스택을 조사해주세요:
+
+---
+## 요구사항
+{{REQUIREMENTS}}
+
+## MVP 기능
+{{MVP_FEATURES}}
+---
+
+## 조사 항목
+
+### 1. 프론트엔드
+각 옵션에 대해:
+- 프레임워크/라이브러리 이름
+- 장점 / 단점
+- 학습 곡선
+- 커뮤니티/생태계
+- 성능 특성
+- 권장 사용 사례
+
+비교 대상: React, Vue, Svelte, Next.js, Nuxt 등
+
+### 2. 백엔드
+비교 대상: Node.js, Python, Go, Rust 등
+각각의 프레임워크 포함 (Express, FastAPI, Gin 등)
+
+### 3. 데이터베이스
+- 관계형: PostgreSQL, MySQL
+- NoSQL: MongoDB, Redis
+- NewSQL: CockroachDB, PlanetScale
+
+### 4. 인프라
+- 클라우드: AWS, GCP, Azure, Vercel, Railway
+- 컨테이너: Docker, Kubernetes
+- 서버리스: Lambda, Cloud Functions
+
+### 5. 개발 도구
+- 버전 관리, CI/CD, 모니터링, 로깅
+
+## MCP 활용
+- context7로 각 기술의 공식 문서 확인
+- exa로 최신 비교 분석 기사 검색
+
+## 출력 형식
+기술 스택 비교표와 최종 권장안을 마크다운으로 작성
+```
+
+## 기대 출력
+`outputs/tech_research.md`

package/template/stages/02-research/prompts/validation.md

@@ -0,0 +1,51 @@
+# 산출물 검증 프롬프트 - Research
+
+## 검증 대상
+
+| 산출물 | 필수 조건 | 검증 방법 |
+|--------|----------|----------|
+| `tech_research.md` | 기술 스택 비교표 | 구조 확인 |
+| `market_analysis.md` | 경쟁사 3개+ 분석 | 수량 확인 |
+| `feasibility_report.md` | 리스크 섹션 포함 | 구조 확인 |
+| `HANDOFF.md` | 핵심 결정사항 | 항목 확인 |
+
+## 검증 명령
+
+```bash
+/validate --stage 02-research
+```
+
+## 품질 기준
+
+### tech_research.md
+- [ ] 기술 스택 비교표 포함
+- [ ] 각 기술의 장단점 분석
+- [ ] 학습 곡선 평가
+- [ ] 커뮤니티/생태계 평가
+
+### market_analysis.md
+- [ ] 경쟁사 3개 이상 분석
+- [ ] 시장 규모 및 트렌드
+- [ ] 진입 장벽 분석
+- [ ] 차별화 포인트
+
+### feasibility_report.md
+- [ ] 기술적 실현 가능성
+- [ ] 시간/리소스 요구사항
+- [ ] 리스크 평가 및 대응 방안
+- [ ] Go/No-Go 권고
+
+### HANDOFF.md
+- [ ] 완료된 리서치 체크리스트
+- [ ] 핵심 발견 사항
+- [ ] 권장 기술 스택
+
+## 자동 검증 스크립트
+
+```bash
+# 경쟁사 분석 수 확인
+grep -c "^### " outputs/market_analysis.md
+
+# 리스크 섹션 확인
+grep -E "^## 리스크|Risk" outputs/feasibility_report.md
+```

package/template/stages/03-planning/CLAUDE.md

@@ -0,0 +1,98 @@
+# Stage 03: Planning
+
+시스템 아키텍처 및 기술 스택 결정 단계
+
+## 🎭 페르소나: Strategic Architect
+
+> 당신은 Strategic Architect입니다.
+> 큰 그림을 설계하고, 체계적인 계획을 수립하세요.
+> 리스크를 미리 식별하고 대안을 준비하세요.
+
+### 특성
+- 전략적 사고
+- 구조화 능력
+- 리스크 평가
+- 우선순위 판단
+
+### 권장 행동
+- 전체 그림 설계
+- 마일스톤 정의
+- 리스크 식별
+- 대안 경로 제안
+
+### 지양 행동
+- 세부 구현에 집중
+- 단기적 관점만 고려
+- 단일 경로만 제시
+
+### AI 설정
+- **Temperature**: 0.6 (균형 잡힌 창의성)
+- **구조화 강조**: High
+
+## 실행 모델
+- **Primary**: Gemini (아키텍처 설계, 다이어그램)
+- **Mode**: Plan Mode - 구조화된 설계
+
+## 목표
+1. 시스템 아키텍처 설계
+2. 기술 스택 최종 결정
+3. 프로젝트 계획 수립
+4. 마일스톤 정의
+
+## 입력 파일
+- `../02-research/outputs/tech_research.md`
+- `../02-research/outputs/feasibility_report.md`
+- `../02-research/HANDOFF.md`
+
+## 출력 파일
+- `outputs/architecture.md` - 시스템 아키텍처
+- `outputs/tech_stack.md` - 기술 스택 결정
+- `outputs/project_plan.md` - 프로젝트 계획
+- `outputs/implementation.yaml` - **구현 규칙 설정** (템플릿: `config/implementation.yaml.template`)
+- `HANDOFF.md` - 다음 스테이지 인계 문서
+
+### ⚠️ implementation.yaml 필수 작성
+`config/implementation.yaml.template`를 기반으로 프로젝트 구현 규칙을 정의하세요:
+- 컴포넌트 타입 (functional/class)
+- 스타일링 방식 (css-modules/tailwind/styled-components)
+- 상태 관리 (context/redux/zustand)
+- 네이밍 규칙 (PascalCase/kebab-case)
+- 폴더 구조 (feature-based/type-based)
+
+## 워크플로우
+
+### 1. 아키텍처 설계
+- 시스템 컴포넌트 정의
+- 데이터 흐름 설계
+- API 설계 개요
+- 인프라 구성
+
+### 2. 기술 스택 확정
+- Research 단계 권장 스택 검토
+- 최종 선택 및 근거 문서화
+- 버전 및 의존성 정의
+
+### 3. 프로젝트 계획
+- 스프린트 계획
+- 마일스톤 정의
+- 리소스 할당
+
+## 아키텍처 다이어그램 포함 항목
+- 시스템 컨텍스트 다이어그램
+- 컨테이너 다이어그램
+- 컴포넌트 다이어그램
+- 시퀀스 다이어그램 (핵심 플로우)
+
+## 완료 조건
+- [ ] 시스템 아키텍처 문서 작성
+- [ ] 기술 스택 최종 결정
+- [ ] 프로젝트 계획 수립
+- [ ] 마일스톤 3개 이상 정의
+- [ ] HANDOFF.md 생성
+
+## 다음 스테이지
+→ **04-ui-ux**: 사용자 인터페이스 및 경험 설계
+
+
+
+

package/template/stages/03-planning/HANDOFF.md

@@ -0,0 +1,168 @@
+# HANDOFF: 03-planning → 04-ui-ux
+
+> 생성일: 2026-01-21
+> 프로젝트: snake-game
+> 현재 스테이지: 03-planning (완료)
+> 다음 스테이지: 04-ui-ux
+
+---
+
+## ✅ 완료된 작업
+
+- [x] 시스템 아키텍처 설계 (컴포넌트 구조, 데이터 흐름)
+- [x] 기술 스택 최종 결정 (React 18 + TypeScript 5 + Vite 5 + Canvas API)
+- [x] 커스텀 훅 설계 (useGameLoop, useKeyboard, useSwipe, useHighScore)
+- [x] 타입 정의 (Point, Direction, GameStatus, GameState, GameAction)
+- [x] 게임 설정 상수 정의 (GAME_CONFIG, COLORS, DIRECTION_VECTORS)
+- [x] 프로젝트 계획 수립 (마일스톤, 스프린트 계획)
+- [x] 구현 규칙 정의 (implementation.yaml)
+
+---
+
+## 📋 핵심 아키텍처 결정사항
+
+### 1. 컴포넌트 구조 (하이브리드)
+
+```
+App
+ └── GameEngine (상태 관리, 이벤트 처리)
+      ├── CanvasLayer (Canvas 렌더링)
+      └── UIOverlay (React UI)
+           ├── ScoreBoard
+           ├── GameOverModal
+           ├── StartScreen
+           └── MobileControls
+```
+
+### 2. 데이터 흐름
+
+- **useReducer**: UI 리렌더링 필요한 상태 (score, status)
+- **useRef**: 빠른 업데이트 (direction buffer, animationFrameId)
+- **Canvas 직접 조작**: 게임 렌더링 (리렌더링 최소화)
+
+### 3. 게임 루프
+
+```typescript
+requestAnimationFrame 기반
+├── deltaTime 계산
+├── dispatch({ type: 'TICK' })
+└── Canvas.draw()
+```
+
+---
+
+## 📁 생성된 산출물
+
+| 파일 | 설명 |
+|------|------|
+| `outputs/architecture.md` | 시스템 아키텍처 상세 설계 |
+| `outputs/tech_stack.md` | 기술 스택 결정 및 근거 |
+| `outputs/project_plan.md` | 프로젝트 계획 및 마일스톤 |
+| `outputs/implementation.yaml` | 구현 규칙 설정 |
+| `HANDOFF.md` | 이 문서 |
+
+---
+
+## 🎨 UI/UX 스테이지 입력 정보
+
+### 화면 구성 요소
+
+| 화면 | 구성 요소 |
+|------|----------|
+| **시작 화면** | 타이틀, 시작 버튼, 최고 점수 |
+| **게임 화면** | Canvas(뱀/먹이/그리드), 점수판 |
+| **일시정지** | 오버레이, 재개/재시작 버튼 |
+| **게임 오버** | 모달, 최종 점수, 최고 점수, 재시작 버튼 |
+| **모바일** | 방향 버튼 (상하좌우) |
+
+### 색상 시스템 (확정)
+
+```yaml
+background: "#1a1a2e"  # 다크 배경
+grid: "#16213e"        # 그리드 라인
+snake: "#00ff88"       # 뱀 몸통 (네온 그린)
+snake_head: "#00cc6a"  # 뱀 머리 (진한 그린)
+food: "#ff6b6b"        # 먹이 (레드)
+text: "#ffffff"        # 텍스트 (화이트)
+```
+
+### 반응형 기준
+
+| 브레이크포인트 | 대상 |
+|--------------|------|
+| < 480px | 모바일 (터치 컨트롤 활성화) |
+| 480px - 768px | 태블릿 |
+| > 768px | 데스크톱 |
+
+### 게임 보드 크기
+
+```yaml
+boardSize: 20        # 20x20 그리드
+cellSize: 20px       # 각 셀 20px
+totalSize: 400x400px # 게임 보드 총 크기
+```
+
+---
+
+## 🔜 04-ui-ux 스테이지 작업
+
+### 필수 산출물
+
+1. **wireframes.md**
+   - 시작 화면 와이어프레임
+   - 게임 화면 와이어프레임 (데스크톱/모바일)
+   - 게임 오버 모달 와이어프레임
+
+2. **design-tokens.md**
+   - 색상 토큰
+   - 타이포그래피
+   - 간격 시스템
+   - 애니메이션 토큰
+
+3. **HANDOFF.md**
+
+### 고려 사항
+
+- 레트로 게임 느낌 (네온 색상, 픽셀 폰트 고려)
+- 미니멀한 UI (게임에 집중)
+- 모바일 터치 영역 충분히 확보 (44x44px 최소)
+- 접근성 (키보드 네비게이션, 색상 대비)
+
+---
+
+## ⚠️ 제약 사항
+
+1. **순수 React + Canvas**: 외부 게임 엔진 미사용
+2. **함수형 컴포넌트**: Class 컴포넌트 미사용
+3. **CSS Modules**: 스타일 스코프 격리
+4. **60fps 목표**: Canvas 렌더링 최적화
+
+---
+
+## 📊 AI 호출 기록
+
+| AI | 시간 | 도구 | 결과 | 상태 |
+|----|------|------|------|------|
+| Gemini | 12:25 | tmux wrapper | 아키텍처 설계 | ✅ |
+| ClaudeCode | 12:30 | - | architecture.md 작성 | ✅ |
+| ClaudeCode | 12:32 | - | tech_stack.md 작성 | ✅ |
+| ClaudeCode | 12:35 | - | project_plan.md 작성 | ✅ |
+| ClaudeCode | 12:36 | - | implementation.yaml 작성 | ✅ |
+
+---
+
+## 🚀 다음 단계
+
+```bash
+# 다음 스테이지 실행
+/run-stage 04-ui-ux
+
+# 또는
+/ui-ux
+```
+
+---
+
+**생성자**: ClaudeCode + Gemini
+**검토자**: -
+**승인**: 대기

package/template/stages/03-planning/HANDOFF.md.template

@@ -0,0 +1,91 @@
+# Stage Handoff: 03-planning → 04-ui-ux
+
+**생성일**: {{TIMESTAMP}}
+**생성자**: Gemini
+**소요 시간**: {{DURATION}}
+
+---
+
+## 완료된 작업
+
+- [ ] 시스템 아키텍처 설계
+- [ ] 기술 스택 최종 결정
+- [ ] 프로젝트 계획 수립
+- [ ] 마일스톤 정의
+- [ ] HANDOFF.md 생성
+
+---
+
+## 다음 에이전트를 위한 컨텍스트
+
+### 아키텍처 요약
+- **스타일**: {{ARCH_STYLE}}
+- **주요 컴포넌트**: {{COMPONENTS}}
+
+### 확정 기술 스택
+
+| 영역 | 기술 | 버전 |
+|------|------|------|
+| Frontend | {{FRONTEND}} | |
+| Backend | {{BACKEND}} | |
+| Database | {{DATABASE}} | |
+| Auth | {{AUTH}} | |
+| Hosting | {{HOSTING}} | |
+
+### 마일스톤
+
+| # | 이름 | 목표 | 산출물 |
+|---|------|------|--------|
+| M1 | {{M1_NAME}} | {{M1_GOAL}} | |
+| M2 | {{M2_NAME}} | {{M2_GOAL}} | |
+| M3 | {{M3_NAME}} | {{M3_GOAL}} | |
+
+### UI/UX 고려사항
+- {{UI_CONSIDERATION_1}}
+- {{UI_CONSIDERATION_2}}
+
+---
+
+## 생성된 산출물
+
+| 파일 | 설명 |
+|------|------|
+| architecture.md | 시스템 아키텍처 |
+| tech_stack.md | 기술 스택 결정 |
+| project_plan.md | 프로젝트 계획 |
+
+---
+
+## 04-ui-ux 스테이지 가이드
+
+### 즉시 실행할 작업
+1. 아키텍처 기반 화면 구조 설계
+2. 사용자 플로우 정의
+3. 디자인 시스템 기초 수립
+
+### 참조 문서
+- `architecture.md` - 컴포넌트 구조
+- `../01-brainstorm/outputs/personas.md` - 사용자 페르소나
+
+---
+
+## 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: "03-planning"
+status: "completed"
+next_stage: "04-ui-ux"
+models_used:
+  - gemini
+```

package/template/stages/03-planning/config.yaml

@@ -0,0 +1,64 @@
+# Stage 03: Planning Configuration
+
+stage:
+  id: "03-planning"
+  name: "Planning"
+  description: "시스템 아키텍처 및 기술 스택 결정"
+
+models:
+  primary: "gemini"
+  secondary: null
+  collaboration: null
+
+execution:
+  mode: "plan"
+  container: false
+  sandbox: false
+  timeout: 3600
+
+inputs:
+  required:
+    - name: "../02-research/outputs/tech_research.md"
+    - name: "../02-research/outputs/feasibility_report.md"
+    - name: "../02-research/HANDOFF.md"
+  optional:
+    - name: "../01-brainstorm/outputs/requirements_analysis.md"
+
+outputs:
+  required:
+    - name: "architecture.md"
+      description: "시스템 아키텍처"
+    - name: "tech_stack.md"
+      description: "기술 스택 결정"
+    - name: "project_plan.md"
+      description: "프로젝트 계획"
+    - name: "implementation.yaml"
+      description: "구현 규칙 설정 (Issue #10)"
+      template: "../../config/implementation.yaml.template"
+    - name: "HANDOFF.md"
+
+prompts:
+  - name: "architecture"
+    file: "prompts/architecture.md"
+    model: "gemini"
+  - name: "tech_stack_decision"
+    file: "prompts/tech_stack_decision.md"
+    model: "gemini"
+  - name: "project_plan"
+    file: "prompts/project_plan.md"
+    model: "gemini"
+
+completion:
+  checklist:
+    - "시스템 아키텍처 문서 작성"
+    - "기술 스택 최종 결정"
+    - "프로젝트 계획 수립"
+    - "마일스톤 3개 이상 정의"
+    - "HANDOFF.md 생성"
+
+transition:
+  next_stage: "04-ui-ux"
+  prerequisites:
+    - "02-research"
+  handoff_required: true
+  checkpoint_required: false