create-ax-project 1.0.0

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

@@ -0,0 +1,222 @@
+# 📋 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개

package/template/stages/01-brainstorm/prompts/collaboration.md

@@ -0,0 +1,46 @@
+# AI 협업 프롬프트 - Brainstorming
+
+## 협업 모드: Parallel Execution
+
+이 스테이지에서는 **병렬 실행** 모드를 사용하여 여러 AI 모델이 동시에 아이디어를 생성합니다.
+
+### 참여 모델
+- **Gemini**: 창의적 아이디어 발산, 웹 리서치
+- **Claude**: 구조화, 실현 가능성 검토
+
+### 협업 프롬프트
+
+```
+/collaborate --mode parallel --models gemini,claude --task "아이디어 브레인스토밍"
+```
+
+### 병합 전략
+
+1. **Gemini 결과**: 창의적 아이디어, 다양한 관점
+2. **Claude 결과**: 구조화된 분석, 실현 가능성 평가
+3. **병합**: Best-of-N 선택 후 통합
+
+### 토론 모드 (선택적)
+
+복잡한 아이디어 평가 시 토론 모드 활용:
+```
+/collaborate --mode debate --topic "최적의 MVP 범위 결정" --rounds 2
+```
+
+### 출력 형식
+
+```markdown
+## AI 협업 결과
+
+### Gemini 아이디어
+- [아이디어 1]
+- [아이디어 2]
+...
+
+### Claude 분석
+- [구조화된 평가]
+...
+
+### 통합 결과
+- [최종 아이디어 목록]
+```

package/template/stages/01-brainstorm/prompts/ideation.md

@@ -0,0 +1,62 @@
+# Ideation Prompt Template
+
+프로젝트 브레인스토밍을 위한 발산적 아이디어 생성 프롬프트
+
+## 사용 모델
+Gemini (창의적 발산에 적합)
+
+## 프롬프트
+
+```
+당신은 창의적인 프로덕트 매니저이자 아이디어 전문가입니다.
+
+다음 프로젝트 브리프를 분석하고 포괄적인 브레인스토밍을 수행해주세요:
+
+---
+{{PROJECT_BRIEF}}
+---
+
+## 요청 사항
+
+### 1. 핵심 기능 아이디어 (최소 10개)
+각 아이디어에 대해:
+- 기능 이름 및 한 줄 설명
+- 사용자 가치 (어떤 문제를 해결하는가?)
+- 구현 복잡도 (Low/Medium/High)
+- 혁신성 점수 (1-5)
+
+### 2. 사용자 페르소나 (3개 이상)
+각 페르소나에 대해:
+- 이름, 나이, 직업
+- 목표와 동기
+- 불만 사항과 pain points
+- 기술 친숙도
+
+### 3. 경쟁사/유사 서비스 분석
+- Reddit, HackerNews, ProductHunt 검색
+- 유사 프로젝트 3-5개 식별
+- 각각의 강점/약점 분석
+- 차별화 기회 식별
+
+### 4. 발산적 아이디어
+- "미친" 아이디어 3개 (실현 가능성 무시)
+- 각 아이디어가 성공할 경우의 임팩트
+
+## 출력 형식
+마크다운 형식으로 구조화하여 출력해주세요.
+```
+
+## 사용 예시
+
+```bash
+# Gemini CLI 호출
+/gemini "$(cat prompts/ideation.md | sed 's/{{PROJECT_BRIEF}}/'"$(cat inputs/project_brief.md)"'/')"
+
+# 또는 직접 호출
+scripts/gemini-wrapper.sh "$(cat prompts/ideation.md)"
+```
+
+## 기대 출력
+- `outputs/ideas.md`로 저장
+- 최소 10개 이상의 아이디어 포함
+- 구조화된 마크다운 형식

package/template/stages/01-brainstorm/prompts/persona.md

@@ -0,0 +1,73 @@
+# Persona Generation Prompt Template
+
+사용자 페르소나 생성을 위한 프롬프트
+
+## 사용 모델
+Gemini
+
+## 프롬프트
+
+```
+당신은 UX 리서처이자 사용자 심리 전문가입니다.
+
+다음 프로젝트에 대한 상세 사용자 페르소나를 생성해주세요:
+
+---
+프로젝트: {{PROJECT_NAME}}
+설명: {{PROJECT_DESCRIPTION}}
+대상 시장: {{TARGET_MARKET}}
+---
+
+## 페르소나 생성 요청
+
+각 페르소나에 대해 다음 정보를 포함해주세요:
+
+### 기본 정보
+- **이름**: (가상의 현실적인 이름)
+- **나이**:
+- **직업**:
+- **위치**:
+- **교육 수준**:
+
+### 심리적 프로필
+- **성격 유형** (MBTI 참고):
+- **가치관**:
+- **라이프스타일**:
+
+### 목표와 동기
+- **주요 목표** (이 제품과 관련하여):
+- **숨겨진 동기**:
+- **성공의 정의**:
+
+### Pain Points
+- **현재 해결책의 불만**:
+- **시간/비용 낭비 요소**:
+- **감정적 좌절감**:
+
+### 기술 프로필
+- **기술 친숙도** (1-5):
+- **주로 사용하는 기기**:
+- **앱 사용 패턴**:
+
+### 사용 시나리오
+- **제품을 발견하는 상황**:
+- **핵심 사용 사례**:
+- **기대하는 결과**:
+
+### 인용구
+이 페르소나가 할 법한 말:
+> "..."
+
+## 출력 형식
+3개 이상의 페르소나를 마크다운 형식으로 출력해주세요.
+각 페르소나는 명확히 구분되어야 합니다.
+```
+
+## 변수 치환
+- `{{PROJECT_NAME}}`: 프로젝트 이름
+- `{{PROJECT_DESCRIPTION}}`: 프로젝트 설명
+- `{{TARGET_MARKET}}`: 대상 시장
+
+## 기대 출력
+- `outputs/personas.md`로 저장
+- 최소 3개 이상의 상세 페르소나

package/template/stages/01-brainstorm/prompts/requirements.md

@@ -0,0 +1,73 @@
+# Requirements Analysis Prompt Template
+
+요구사항 분석 및 구조화를 위한 프롬프트
+
+## 사용 모델
+ClaudeCode (구조화 및 분석에 적합)
+
+## 프롬프트
+
+```
+당신은 시니어 시스템 분석가입니다.
+
+다음 브레인스토밍 결과와 프로젝트 브리프를 바탕으로
+체계적인 요구사항 분석을 수행해주세요:
+
+---
+## 프로젝트 브리프
+{{PROJECT_BRIEF}}
+
+## 브레인스토밍 결과
+{{BRAINSTORM_IDEAS}}
+
+## 사용자 페르소나
+{{PERSONAS}}
+---
+
+## 분석 요청
+
+### 1. 기능적 요구사항 (Functional Requirements)
+카테고리별로 분류:
+- 사용자 관리
+- 핵심 기능
+- 데이터 관리
+- 통합/연동
+- 보고/분석
+
+각 요구사항에 대해:
+| ID | 요구사항 | 우선순위 | 복잡도 | 의존성 |
+|----|----------|----------|--------|--------|
+
+### 2. 비기능적 요구사항 (Non-Functional Requirements)
+- **성능**: 응답 시간, 처리량
+- **확장성**: 사용자 수, 데이터 볼륨
+- **보안**: 인증, 권한, 데이터 보호
+- **가용성**: 업타임 목표
+- **사용성**: 접근성, UX 기준
+
+### 3. 제약조건 (Constraints)
+- 기술적 제약
+- 비즈니스 제약
+- 시간/예산 제약
+- 규제/법적 제약
+
+### 4. 가정사항 (Assumptions)
+검증이 필요한 가정들
+
+### 5. MVP 범위 제안
+- **필수 기능** (Must Have)
+- **있으면 좋은 기능** (Nice to Have)
+- **향후 버전** (Future)
+
+### 6. 리스크 식별
+| 리스크 | 영향도 | 발생 확률 | 완화 전략 |
+|--------|--------|-----------|-----------|
+
+## 출력 형식
+구조화된 마크다운 문서로 출력해주세요.
+```
+
+## 기대 출력
+- `outputs/requirements_analysis.md`로 저장
+- MoSCoW 우선순위가 적용된 요구사항 목록
+- MVP 범위 명확히 정의

package/template/stages/01-brainstorm/prompts/validation.md

@@ -0,0 +1,50 @@
+# 산출물 검증 프롬프트 - Brainstorming
+
+## 검증 대상
+
+| 산출물 | 필수 조건 | 검증 방법 |
+|--------|----------|----------|
+| `ideas.md` | 최소 10개 아이디어 | 수량 확인 |
+| `requirements_analysis.md` | 기능/비기능 섹션 포함 | 구조 확인 |
+| `HANDOFF.md` | 완료 체크리스트 | 항목 확인 |
+
+## 검증 명령
+
+```bash
+/validate --stage 01-brainstorm
+```
+
+## 품질 기준
+
+### ideas.md
+- [ ] 최소 10개 아이디어 존재
+- [ ] 각 아이디어에 장단점 분석
+- [ ] 우선순위 또는 카테고리 분류
+- [ ] 실현 가능성 초기 평가
+
+### requirements_analysis.md
+- [ ] 기능적 요구사항 섹션
+- [ ] 비기능적 요구사항 섹션
+- [ ] 제약조건 식별
+- [ ] MVP 범위 제안
+
+### HANDOFF.md
+- [ ] 완료된 작업 체크리스트
+- [ ] 핵심 결정사항
+- [ ] 다음 스테이지 준비 항목
+
+## 자동 검증 스크립트
+
+```bash
+# ideas.md 아이디어 수 확인
+grep -c "^## " outputs/ideas.md
+
+# requirements_analysis.md 섹션 확인
+grep -E "^## (기능|비기능)" outputs/requirements_analysis.md
+```
+
+## 실패 시 조치
+
+1. 부족한 항목 식별
+2. 추가 아이디어 생성 또는 분석 보완
+3. 재검증 실행

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

@@ -0,0 +1,91 @@
+# Brainstorming Ideas
+
+**프로젝트**: {{PROJECT_NAME}}
+**생성일**: {{DATE}}
+**생성자**: {{MODEL}} (Gemini + ClaudeCode)
+
+---
+
+## 핵심 기능 아이디어
+
+### 아이디어 요약 테이블
+
+| # | 기능명 | 설명 | 사용자 가치 | 복잡도 | 혁신성 |
+|---|--------|------|-------------|--------|--------|
+| 1 | | | | | |
+| 2 | | | | | |
+| 3 | | | | | |
+| ... | | | | | |
+
+### 상세 아이디어
+
+#### 아이디어 1: [기능명]
+- **설명**:
+- **사용자 가치**:
+- **구현 복잡도**: Low / Medium / High
+- **혁신성 점수**: ⭐⭐⭐⭐⭐ (5/5)
+- **비고**:
+
+---
+
+## 발산적 아이디어 ("미친" 아이디어)
+
+### 🚀 아이디어 A: [이름]
+- **설명**:
+- **성공 시 임팩트**:
+- **실현 장벽**:
+
+### 🚀 아이디어 B: [이름]
+- **설명**:
+- **성공 시 임팩트**:
+- **실현 장벽**:
+
+### 🚀 아이디어 C: [이름]
+- **설명**:
+- **성공 시 임팩트**:
+- **실현 장벽**:
+
+---
+
+## 경쟁사/유사 서비스 분석
+
+### 식별된 서비스
+
+| 서비스 | 유형 | 강점 | 약점 | 차별화 기회 |
+|--------|------|------|------|-------------|
+| | | | | |
+
+### 상세 분석
+
+#### [서비스 1]
+- **URL**:
+- **핵심 기능**:
+- **가격 모델**:
+- **타겟 사용자**:
+- **우리의 차별화 포인트**:
+
+---
+
+## 아이디어 우선순위 매트릭스
+
+```
+높은 임팩트
+    │
+    │   ⭐ Quick Wins    │   🎯 Big Bets
+    │   (아이디어 #)      │   (아이디어 #)
+    │                    │
+────┼────────────────────┼────────────────
+    │                    │
+    │   ❌ Not Worth It   │   🔬 Experiments
+    │   (아이디어 #)      │   (아이디어 #)
+    │
+낮은 임팩트
+         낮은 노력          높은 노력
+```
+
+---
+
+## 다음 단계
+1. Research 스테이지에서 기술적 실현 가능성 검토
+2. Quick Wins 아이디어 우선 검증
+3. Big Bets 아이디어 심층 분석