create-ax-project 1.0.0

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

@@ -0,0 +1,129 @@
+# Requirements Analysis
+
+**프로젝트**: {{PROJECT_NAME}}
+**생성일**: {{DATE}}
+**버전**: 1.0
+
+---
+
+## 1. 기능적 요구사항 (Functional Requirements)
+
+### 1.1 사용자 관리
+
+| ID | 요구사항 | 우선순위 | 복잡도 | 의존성 |
+|----|----------|----------|--------|--------|
+| FR-UM-001 | | Must | | |
+| FR-UM-002 | | Should | | |
+
+### 1.2 핵심 기능
+
+| ID | 요구사항 | 우선순위 | 복잡도 | 의존성 |
+|----|----------|----------|--------|--------|
+| FR-CF-001 | | Must | | |
+| FR-CF-002 | | Must | | |
+
+### 1.3 데이터 관리
+
+| ID | 요구사항 | 우선순위 | 복잡도 | 의존성 |
+|----|----------|----------|--------|--------|
+| FR-DM-001 | | Should | | |
+
+### 1.4 통합/연동
+
+| ID | 요구사항 | 우선순위 | 복잡도 | 의존성 |
+|----|----------|----------|--------|--------|
+| FR-INT-001 | | Could | | |
+
+---
+
+## 2. 비기능적 요구사항 (Non-Functional Requirements)
+
+### 2.1 성능 (Performance)
+- **응답 시간**: 페이지 로드 < 3초, API 응답 < 500ms
+- **처리량**: 동시 사용자 X명 지원
+- **데이터 볼륨**: 초기 X GB, 연간 성장률 Y%
+
+### 2.2 확장성 (Scalability)
+- **수평 확장**:
+- **수직 확장**:
+- **목표 용량**:
+
+### 2.3 보안 (Security)
+- **인증**:
+- **권한 관리**:
+- **데이터 암호화**:
+- **감사 로그**:
+
+### 2.4 가용성 (Availability)
+- **업타임 목표**: 99.9%
+- **RTO (복구 시간 목표)**:
+- **RPO (복구 시점 목표)**:
+
+### 2.5 사용성 (Usability)
+- **접근성**: WCAG 2.1 Level AA
+- **반응형**: 모바일, 태블릿, 데스크탑
+- **브라우저 지원**:
+
+---
+
+## 3. 제약조건 (Constraints)
+
+### 3.1 기술적 제약
+-
+
+### 3.2 비즈니스 제약
+-
+
+### 3.3 시간/예산 제약
+- **일정**:
+- **예산**:
+- **팀 규모**:
+
+### 3.4 규제/법적 제약
+-
+
+---
+
+## 4. 가정사항 (Assumptions)
+
+| ID | 가정 | 검증 필요 | 검증 방법 |
+|----|------|-----------|-----------|
+| A-001 | | Yes | |
+| A-002 | | No | |
+
+---
+
+## 5. MVP 범위
+
+### 5.1 필수 기능 (Must Have)
+1.
+2.
+3.
+
+### 5.2 있으면 좋은 기능 (Should Have)
+1.
+2.
+
+### 5.3 가능하면 (Could Have)
+1.
+
+### 5.4 향후 버전 (Won't Have - This Time)
+1.
+2.
+
+---
+
+## 6. 리스크 식별
+
+| ID | 리스크 | 영향도 | 확률 | 완화 전략 |
+|----|--------|--------|------|-----------|
+| R-001 | | High | Medium | |
+| R-002 | | Medium | Low | |
+
+---
+
+## 7. 다음 단계
+
+1. [ ] Research 스테이지에서 기술적 실현 가능성 검토
+2. [ ] Planning 스테이지에서 아키텍처 설계
+3. [ ] 이해관계자 리뷰 및 승인

package/template/stages/02-research/CLAUDE.md

@@ -0,0 +1,101 @@
+# Stage 02: Research
+
+기술 리서치 및 시장 분석 단계
+
+## 🎭 페르소나: Analytical Investigator
+
+> 당신은 Analytical Investigator입니다.
+> 모든 주장에는 근거를 제시하고, 다양한 관점에서 조사하세요.
+> 트레이드오프를 명확히 하고 객관적인 분석을 제공하세요.
+
+### 특성
+- 체계적 조사
+- 증거 기반 분석
+- 비교 평가
+- 종합적 판단
+
+### 권장 행동
+- 다양한 소스 조사
+- 데이터 기반 분석
+- 트레이드오프 비교
+- 명확한 근거 제시
+
+### 지양 행동
+- 추측에 의존
+- 단일 소스 의존
+- 감정적 판단
+
+### AI 설정
+- **Temperature**: 0.4 (높은 정확도)
+- **엄격성**: High
+
+## 실행 모델
+- **Primary**: Claude (심층 분석, 문서 합성)
+- **Mode**: Plan Mode - 구조화된 리서치
+
+## 목표
+1. 기술 스택 실현 가능성 검토
+2. 시장 분석 및 경쟁 환경 파악
+3. 외부 API/서비스 조사
+4. 기술적 리스크 식별
+
+## 입력 파일
+- `../01-brainstorm/outputs/ideas.md`
+- `../01-brainstorm/outputs/requirements_analysis.md`
+- `../01-brainstorm/HANDOFF.md`
+
+## 출력 파일
+- `outputs/tech_research.md` - 기술 리서치 결과
+- `outputs/market_analysis.md` - 시장 분석
+- `outputs/feasibility_report.md` - 실현 가능성 보고서
+- `HANDOFF.md` - 다음 스테이지 인계 문서
+
+## MCP 서버 활용
+
+### firecrawl
+웹 크롤링 및 데이터 수집
+```
+firecrawl로 경쟁사 웹사이트 분석
+```
+
+### exa
+AI 기반 검색
+```
+최신 기술 트렌드 및 베스트 프랙티스 검색
+```
+
+### context7
+문서 검색
+```
+라이브러리/프레임워크 공식 문서 조회
+```
+
+## 워크플로우
+
+### 1. 기술 스택 리서치
+- MVP 기능별 최적 기술 스택 조사
+- 각 기술의 장단점 비교
+- 학습 곡선 및 커뮤니티 지원 평가
+
+### 2. 시장 분석
+- 경쟁사 상세 분석
+- 시장 규모 및 트렌드
+- 진입 장벽 분석
+
+### 3. 실현 가능성 평가
+- 기술적 실현 가능성
+- 시간/리소스 요구사항
+- 리스크 평가
+
+## 완료 조건
+- [ ] 기술 스택 비교 분석 완료
+- [ ] 경쟁사 3개 이상 심층 분석
+- [ ] 실현 가능성 보고서 작성
+- [ ] HANDOFF.md 생성
+
+## 다음 스테이지
+→ **03-planning**: 시스템 아키텍처 및 기술 스택 결정
+
+
+
+

package/template/stages/02-research/HANDOFF.md

@@ -0,0 +1,158 @@
+# HANDOFF: 02-research → 03-planning
+
+> 생성일: 2026-01-21
+> 프로젝트: snake-game
+> 현재 스테이지: 02-research (완료)
+> 다음 스테이지: 03-planning
+
+---
+
+## ✅ 완료된 작업
+
+- [x] Canvas 게임 루프 구현 방법 조사
+- [x] React + Canvas 통합 패턴 분석
+- [x] 모바일 터치 이벤트 처리 조사
+- [x] 충돌 감지 알고리즘 정리
+- [x] localStorage 하이스코어 구현 방법
+- [x] 성능 최적화 기법 조사
+- [x] 오픈소스 프로젝트 사례 수집
+- [x] 실현 가능성 보고서 작성
+
+---
+
+## 📋 핵심 기술 결정사항
+
+### 1. 렌더링 방식
+- **선택**: Canvas API
+- **이유**: 게임 성능, 60fps 유지, 복잡한 애니메이션 지원
+- **대안 기각**: CSS Grid (대량 요소 시 성능 저하)
+
+### 2. 게임 루프
+- **선택**: requestAnimationFrame
+- **이유**: 브라우저 최적화, 탭 비활성화 시 자동 일시정지
+- **대안 기각**: setInterval (정확도 낮음)
+
+### 3. 상태 관리
+- **선택**: useReducer + useRef 조합
+- **이유**: 복잡한 게임 상태, 리렌더링 최소화
+- **패턴**: 게임 로직은 useRef, UI 표시용만 useState
+
+### 4. 모바일 조작
+- **선택**: Custom useSwipe 훅 + 방향 버튼
+- **이유**: 검증된 패턴, 두 가지 입력 방식 모두 지원
+
+---
+
+## 📁 생성된 산출물
+
+| 파일 | 설명 |
+|------|------|
+| `outputs/tech_research.md` | 기술 리서치 상세 결과 |
+| `outputs/feasibility_report.md` | 실현 가능성 보고서 |
+| `HANDOFF.md` | 이 문서 |
+
+---
+
+## 🔧 권장 기술 스택
+
+```yaml
+# 프로젝트 구조
+framework: React 18+
+language: TypeScript 5+
+build: Vite 5+
+rendering: Canvas API
+state: useReducer + useRef
+styling: CSS Modules 또는 Tailwind CSS
+testing: Vitest + React Testing Library
+```
+
+---
+
+## 📊 핵심 코드 패턴 요약
+
+### 게임 루프 훅
+```typescript
+const useGameLoop = (callback: (deltaTime: number) => void) => {
+  const requestRef = useRef<number>();
+  const previousTimeRef = useRef<number>();
+  // ... requestAnimationFrame 기반 루프
+};
+```
+
+### 스와이프 감지 훅
+```typescript
+const useSwipe = (handlers: { left, right, up, down }) => {
+  // touchstart/touchend 기반 방향 감지
+};
+```
+
+### 타입 정의
+```typescript
+type Direction = 'UP' | 'DOWN' | 'LEFT' | 'RIGHT';
+type GameStatus = 'idle' | 'playing' | 'paused' | 'gameover';
+interface Position { x: number; y: number; }
+interface GameState { snake, food, direction, score, status }
+```
+
+---
+
+## 🔜 다음 스테이지 작업
+
+### 03-planning에서 결정할 사항
+
+1. **상세 아키텍처**
+   - 컴포넌트 구조도
+   - 데이터 흐름 다이어그램
+   - 훅 의존성 관계
+
+2. **파일 구조**
+   - src/ 디렉토리 구조
+   - 컴포넌트/훅/유틸/타입 분리
+
+3. **게임 설정 상수**
+   - 보드 크기, 셀 크기
+   - 초기 속도, 속도 증가량
+   - 레벨업 조건
+
+4. **API 설계**
+   - 게임 상태 인터페이스
+   - 액션 타입 정의
+   - 리듀서 로직
+
+---
+
+## ⚠️ 주의사항
+
+1. **외부 게임 엔진 미사용**: Phaser, PixiJS 등 금지
+2. **순수 React 구현**: jQuery 미사용
+3. **리렌더링 최소화**: Canvas는 직접 업데이트
+4. **성능 우선**: 60fps 목표
+
+---
+
+## 📊 AI 호출 기록
+
+| AI | 시간 | 도구 | 결과 | 상태 |
+|----|------|------|------|------|
+| Claude | 12:10 | Exa MCP | Canvas 게임 루프 패턴 수집 | ✅ |
+| Claude | 12:12 | Exa MCP | 모바일 터치 조작 패턴 수집 | ✅ |
+| Claude | 12:15 | - | tech_research.md 작성 | ✅ |
+| Claude | 12:16 | - | feasibility_report.md 작성 | ✅ |
+
+---
+
+## 🚀 다음 단계
+
+```bash
+# 다음 스테이지 실행
+/run-stage 03-planning
+
+# 또는
+/planning
+```
+
+---
+
+**생성자**: ClaudeCode
+**검토자**: -
+**승인**: 대기

package/template/stages/02-research/HANDOFF.md.template

@@ -0,0 +1,102 @@
+# Stage Handoff: 02-research → 03-planning
+
+**생성일**: {{TIMESTAMP}}
+**생성자**: Claude
+**소요 시간**: {{DURATION}}
+
+---
+
+## 완료된 작업
+
+- [ ] 기술 스택 리서치
+- [ ] 시장 분석 (경쟁사 {{COMPETITOR_COUNT}}개)
+- [ ] 실현 가능성 평가
+- [ ] HANDOFF.md 생성
+
+---
+
+## 다음 에이전트를 위한 컨텍스트
+
+### 권장 기술 스택
+
+| 영역 | 선택 | 대안 | 선택 이유 |
+|------|------|------|-----------|
+| Frontend | {{FRONTEND}} | | |
+| Backend | {{BACKEND}} | | |
+| Database | {{DATABASE}} | | |
+| Infrastructure | {{INFRA}} | | |
+
+### 핵심 결정사항
+
+| 결정 | 이유 | 되돌릴 수 있음 |
+|------|------|----------------|
+| {{DECISION_1}} | {{REASON_1}} | Yes/No |
+
+### 실현 가능성 요약
+- **기술**: {{TECH_SCORE}}/10
+- **경제**: {{ECON_SCORE}}/10
+- **일정**: {{TIME_SCORE}}/10
+- **시장**: {{MARKET_SCORE}}/10
+- **종합**: {{TOTAL_SCORE}}/40
+- **권고**: {{RECOMMENDATION}}
+
+### 주요 리스크
+1. {{RISK_1}}
+2. {{RISK_2}}
+3. {{RISK_3}}
+
+---
+
+## 생성된 산출물
+
+| 파일 | 설명 |
+|------|------|
+| tech_research.md | 기술 스택 리서치 |
+| market_analysis.md | 시장 분석 |
+| feasibility_report.md | 실현 가능성 보고서 |
+
+---
+
+## 03-planning 스테이지 가이드
+
+### 즉시 실행할 작업
+1. 권장 기술 스택 기반 아키텍처 설계
+2. 시스템 컴포넌트 정의
+3. 데이터 모델 설계
+
+### 아키텍처 고려사항
+- {{ARCH_CONSIDERATION_1}}
+- {{ARCH_CONSIDERATION_2}}
+
+### 검증된 가정
+- {{VALIDATED_ASSUMPTION_1}}
+
+### 미검증 가정 (Planning에서 결정 필요)
+- {{UNVALIDATED_ASSUMPTION_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: "02-research"
+status: "completed"
+next_stage: "03-planning"
+models_used:
+  - claude
+mcp_servers_used:
+  - firecrawl
+  - exa
+  - context7
+```

package/template/stages/02-research/config.yaml

@@ -0,0 +1,68 @@
+# Stage 02: Research Configuration
+
+stage:
+  id: "02-research"
+  name: "Research"
+  description: "기술 리서치 및 시장 분석"
+
+models:
+  primary: "claude"
+  secondary: null
+  collaboration: null
+
+execution:
+  mode: "plan"
+  container: false
+  sandbox: false
+  timeout: 7200  # 2 hours
+
+mcp_servers:
+  - firecrawl
+  - exa
+  - context7
+
+inputs:
+  required:
+    - name: "../01-brainstorm/outputs/requirements_analysis.md"
+      description: "요구사항 분석 결과"
+    - name: "../01-brainstorm/HANDOFF.md"
+      description: "이전 스테이지 핸드오프"
+  optional:
+    - name: "../01-brainstorm/outputs/ideas.md"
+      description: "브레인스토밍 아이디어"
+
+outputs:
+  required:
+    - name: "tech_research.md"
+      description: "기술 리서치 결과"
+    - name: "market_analysis.md"
+      description: "시장 분석"
+    - name: "feasibility_report.md"
+      description: "실현 가능성 보고서"
+    - name: "HANDOFF.md"
+      description: "다음 스테이지 인계 문서"
+
+prompts:
+  - name: "tech_stack"
+    file: "prompts/tech_stack.md"
+    model: "claude"
+  - name: "market_analysis"
+    file: "prompts/market_analysis.md"
+    model: "claude"
+  - name: "feasibility"
+    file: "prompts/feasibility.md"
+    model: "claude"
+
+completion:
+  checklist:
+    - "기술 스택 비교 분석 완료"
+    - "경쟁사 3개 이상 심층 분석"
+    - "실현 가능성 보고서 작성"
+    - "HANDOFF.md 생성"
+
+transition:
+  next_stage: "03-planning"
+  prerequisites:
+    - "01-brainstorm"
+  handoff_required: true
+  checkpoint_required: false