create-ax-project 1.0.0

package/template/stages/10-deployment/HANDOFF.md

@@ -0,0 +1,141 @@
+# HANDOFF: 10-deployment (완료)
+
+> 생성일: 2026-01-21
+> 프로젝트: snake-game
+> 현재 스테이지: 10-deployment (완료)
+> 다음 스테이지: 파이프라인 완료
+
+---
+
+## 완료된 작업
+
+- [x] 빌드 설정 검증
+  - Vite 빌드 성공 (204.59KB)
+  - TypeScript 컴파일 통과
+  - ESLint 검사 통과
+- [x] GitHub Pages 배포 설정
+  - `vite.config.ts`에 `base: '/snake-game/'` 추가
+  - `.github/workflows/deploy.yml` 생성
+- [x] CI/CD 파이프라인 구성
+  - 테스트 실행 → 빌드 → 배포 자동화
+  - main 브랜치 push 시 자동 실행
+- [x] README.md 작성
+  - 프로젝트 설명, 기능, 기술 스택
+  - 설치 방법, 조작 방법
+  - 프로젝트 구조, 테스트 정보
+
+---
+
+## 배포 정보
+
+| 항목 | 값 |
+|------|-----|
+| 호스팅 | GitHub Pages |
+| URL | https://youjungmin.github.io/snake-game/ |
+| 배포 트리거 | main 브랜치 push |
+| 빌드 도구 | Vite 7 |
+| 빌드 크기 | 204.59KB |
+
+---
+
+## 생성/수정된 파일
+
+| 파일 | 변경 유형 | 설명 |
+|------|----------|------|
+| `vite.config.ts` | 수정 | base 경로 추가 |
+| `.github/workflows/deploy.yml` | 생성 | GitHub Actions 워크플로우 |
+| `README.md` | 수정 | 프로젝트 문서화 |
+| `HANDOFF.md` | 생성 | 배포 완료 문서 |
+
+---
+
+## 배포 워크플로우
+
+```yaml
+name: Deploy to GitHub Pages
+on:
+  push:
+    branches: ['main']
+
+jobs:
+  build:
+    - Checkout
+    - Setup Node.js 20
+    - Install dependencies (npm ci)
+    - Run tests (npm run test:run)
+    - Build (npm run build)
+    - Upload artifact
+
+  deploy:
+    - Deploy to GitHub Pages
+```
+
+---
+
+## 파이프라인 완료 요약
+
+### 전체 스테이지 현황
+
+| 스테이지 | 상태 | 주요 산출물 |
+|---------|------|-----------|
+| 01-brainstorm | 완료 | ideas.md, requirements_analysis.md |
+| 02-research | 완료 | tech_research.md, feasibility_report.md |
+| 03-planning | 완료 | architecture.md, tech_stack.md |
+| 04-ui-ux | 완료 | wireframes.md, design_system.md |
+| 05-task-management | 완료 | tasks.md, sprint_plan.md |
+| 06-implementation | 완료 | 전체 게임 소스코드 |
+| 07-refactoring | 완료 | 코드 최적화 |
+| 08-qa | 완료 | BUG-001 수정, qa_report.md |
+| 09-testing | 완료 | 43개 테스트 (100% 통과) |
+| 10-deployment | 완료 | GitHub Pages 배포 |
+
+### 핵심 기술 결정
+
+1. **렌더링**: Canvas API (CSS Grid 대신)
+2. **상태 관리**: useReducer 패턴
+3. **게임 루프**: requestAnimationFrame + Fixed Timestep
+4. **테스트**: Vitest + Testing Library
+5. **배포**: GitHub Actions + GitHub Pages
+
+### 버그 수정 기록
+
+| ID | 문제 | 해결 |
+|----|------|------|
+| BUG-001 | 게임 시작 즉시 Game Over | useGameLoop 첫 프레임 초기화 수정 |
+
+---
+
+## 배포 후 권장 작업
+
+1. **GitHub Repository 설정**
+   - Settings → Pages → GitHub Actions 선택
+   - Repository를 public으로 설정
+
+2. **첫 배포 확인**
+   - main 브랜치에 push
+   - Actions 탭에서 워크플로우 실행 확인
+   - 배포 URL 접속 테스트
+
+3. **향후 개선 (선택)**
+   - 모바일 터치 지원
+   - 사운드 효과
+   - 리더보드 (백엔드 필요)
+
+---
+
+## 프로젝트 통계
+
+| 항목 | 값 |
+|------|-----|
+| 총 소요 시간 | 약 4시간 |
+| 파일 수 | 20+ |
+| 코드 라인 | 1,500+ |
+| 테스트 수 | 43개 |
+| 커버리지 | 77-87% (핵심 로직) |
+
+---
+
+**ax-templates 10단계 파이프라인 완료**
+
+생성자: ClaudeCode
+완료일: 2026-01-21

package/template/stages/10-deployment/HANDOFF.md.template

@@ -0,0 +1,148 @@
+# Stage Handoff: 10-deployment → PROJECT COMPLETE
+
+**생성일**: {{TIMESTAMP}}
+**생성자**: ClaudeCode
+**소요 시간**: {{DURATION}}
+
+---
+
+## 완료된 작업
+
+- [ ] CI 파이프라인 설정
+- [ ] CD 파이프라인 설정
+- [ ] 스테이징 배포 성공
+- [ ] 프로덕션 배포 성공
+- [ ] 모니터링 설정
+- [ ] 배포 문서 작성
+- [ ] HANDOFF.md 생성 (최종)
+
+---
+
+## 프로젝트 완료 요약
+
+### 배포 정보
+
+| 환경 | URL | 상태 |
+|------|-----|------|
+| Production | {{PROD_URL}} | {{PROD_STATUS}} |
+| Staging | {{STAGE_URL}} | {{STAGE_STATUS}} |
+
+### CI/CD 파이프라인
+
+| 파이프라인 | 상태 | 마지막 실행 |
+|------------|------|-------------|
+| CI | {{CI_STATUS}} | {{CI_LAST}} |
+| CD (Staging) | {{CD_STAGE_STATUS}} | {{CD_STAGE_LAST}} |
+| CD (Production) | {{CD_PROD_STATUS}} | {{CD_PROD_LAST}} |
+
+### 모니터링
+
+| 서비스 | 용도 | 대시보드 |
+|--------|------|----------|
+| {{MONITOR_1}} | 에러 트래킹 | {{DASH_1}} |
+| {{MONITOR_2}} | 성능 모니터링 | {{DASH_2}} |
+
+---
+
+## 전체 파이프라인 회고
+
+### 스테이지별 소요 시간
+
+| 스테이지 | 소요 시간 | 모델 |
+|----------|-----------|------|
+| 01-brainstorm | {{TIME_01}} | Gemini + ClaudeCode |
+| 02-research | {{TIME_02}} | Claude |
+| 03-planning | {{TIME_03}} | Gemini |
+| 04-ui-ux | {{TIME_04}} | Gemini |
+| 05-task-management | {{TIME_05}} | ClaudeCode |
+| 06-implementation | {{TIME_06}} | ClaudeCode |
+| 07-refactoring | {{TIME_07}} | Codex |
+| 08-qa | {{TIME_08}} | ClaudeCode |
+| 09-testing | {{TIME_09}} | Codex |
+| 10-deployment | {{TIME_10}} | ClaudeCode |
+| **총계** | **{{TOTAL_TIME}}** | |
+
+### 주요 성과
+1. {{ACHIEVEMENT_1}}
+2. {{ACHIEVEMENT_2}}
+3. {{ACHIEVEMENT_3}}
+
+### 학습 내용
+1. {{LEARNING_1}}
+2. {{LEARNING_2}}
+
+### 향후 개선점
+1. {{IMPROVEMENT_1}}
+2. {{IMPROVEMENT_2}}
+
+---
+
+## 운영 가이드
+
+### 배포 명령어
+```bash
+# 스테이징 배포
+npm run deploy:staging
+
+# 프로덕션 배포
+npm run deploy:production
+
+# 롤백
+npm run rollback
+```
+
+### 환경 변수
+- `DATABASE_URL`: 데이터베이스 연결 문자열
+- `API_KEY`: 외부 API 키
+- (`.env.example` 참조)
+
+### 트러블슈팅
+- 배포 실패 시: {{TROUBLESHOOT_1}}
+- 성능 이슈 시: {{TROUBLESHOOT_2}}
+
+---
+
+## 생성된 산출물
+
+| 파일 | 설명 |
+|------|------|
+| .github/workflows/ | CI/CD 워크플로우 |
+| deployment_config/ | 배포 설정 |
+| deployment_log.md | 배포 로그 |
+
+---
+
+## 프로젝트 종료
+
+이 프로젝트는 성공적으로 완료되었습니다.
+
+### 다음 단계 제안
+1. 사용자 피드백 수집
+2. 성능 모니터링 검토
+3. 다음 이터레이션 계획
+
+---
+
+## 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: "10-deployment"
+status: "completed"
+project_status: "COMPLETED"
+models_used:
+  - claudecode
+total_stages: 10
+total_duration: "{{TOTAL_TIME}}"
+production_url: "{{PROD_URL}}"
+```

package/template/stages/10-deployment/config.yaml

@@ -0,0 +1,61 @@
+# Stage 10: CI/CD & Deployment Configuration
+
+stage:
+  id: "10-deployment"
+  name: "CI/CD & Deployment"
+  description: "배포 파이프라인 설정 및 배포"
+
+models:
+  primary: "claudecode"
+  secondary: null
+  collaboration: null
+
+execution:
+  mode: "headless"
+  container: false
+  sandbox: false
+  timeout: 3600
+
+inputs:
+  required:
+    - name: "source_code/"
+    - name: "../09-testing/outputs/tests/"
+    - name: "../09-testing/outputs/test_report.md"
+    - name: "../09-testing/HANDOFF.md"
+
+outputs:
+  required:
+    - name: ".github/workflows/"
+      description: "GitHub Actions 워크플로우"
+    - name: "deployment_config/"
+      description: "배포 설정 파일"
+    - name: "deployment_log.md"
+      description: "배포 로그"
+    - name: "HANDOFF.md"
+
+prompts:
+  - name: "ci_setup"
+    file: "prompts/ci_setup.md"
+    model: "claudecode"
+  - name: "cd_setup"
+    file: "prompts/cd_setup.md"
+    model: "claudecode"
+  - name: "monitoring"
+    file: "prompts/monitoring.md"
+    model: "claudecode"
+
+completion:
+  checklist:
+    - "CI 파이프라인 설정"
+    - "CD 파이프라인 설정"
+    - "스테이징 배포 성공"
+    - "프로덕션 배포 성공"
+    - "모니터링 설정"
+    - "배포 문서 작성"
+
+transition:
+  next_stage: null  # 마지막 스테이지
+  prerequisites:
+    - "09-testing"
+  handoff_required: true
+  checkpoint_required: false

package/template/stages/10-deployment/prompts/collaboration.md

@@ -0,0 +1,80 @@
+# AI 협업 프롬프트 - CI/CD & Deployment
+
+## 협업 모드: Deployment Chain
+
+이 스테이지에서는 **배포 체인**을 사용하여 안전한 배포를 수행합니다.
+
+### 참여 모델
+- **ClaudeCode**: CI/CD 설정, 배포 자동화
+
+### 협업 프롬프트
+
+```
+# 배포 체인
+/collaborate --mode sequential --chain "claudecode:ci_setup -> claudecode:cd_setup -> claudecode:deploy"
+```
+
+### 배포 단계
+
+| 단계 | 작업 | 검증 |
+|------|------|------|
+| CI 설정 | 빌드/테스트 파이프라인 | 테스트 통과 |
+| CD 설정 | 스테이징/프로덕션 파이프라인 | 환경 분리 |
+| 배포 | 실제 배포 실행 | 헬스 체크 |
+
+### CI/CD 파이프라인 구성
+
+```yaml
+# .github/workflows/ci.yml
+name: CI
+on: [push, pull_request]
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+      - run: npm ci
+      - run: npm run lint
+      - run: npm run type-check
+      - run: npm test
+      - run: npm run build
+```
+
+### 배포 플랫폼 선택
+
+| 플랫폼 | 장점 | 권장 사용 |
+|--------|------|----------|
+| Vercel | Next.js 최적화 | 프론트엔드 |
+| Railway | 풀스택 지원 | 풀스택 앱 |
+| AWS | 확장성 | 엔터프라이즈 |
+| Cloudflare | Edge 배포 | 정적/Edge |
+
+### 롤백 전략
+
+```bash
+# 롤백 준비
+/checkpoint --reason "배포 전 상태"
+
+# 롤백 실행 (필요시)
+/restore checkpoint_id
+```
+
+### 출력 형식
+
+```markdown
+## 배포 결과
+
+### CI 파이프라인
+- 빌드: 성공/실패
+- 테스트: 통과/실패
+- Lint: 통과/실패
+
+### CD 파이프라인
+- 스테이징: [URL]
+- 프로덕션: [URL]
+
+### 모니터링
+- 에러 트래킹: [설정 여부]
+- 성능 모니터링: [설정 여부]
+```

package/template/stages/10-deployment/prompts/validation.md

@@ -0,0 +1,93 @@
+# 산출물 검증 프롬프트 - CI/CD & Deployment
+
+## 검증 대상
+
+| 산출물 | 필수 조건 | 검증 방법 |
+|--------|----------|----------|
+| `.github/workflows/` | CI 파이프라인 | 구조 확인 |
+| `deployment_config/` | 환경 설정 | 구조 확인 |
+| `deployment_log.md` | 배포 기록 | 항목 확인 |
+| `HANDOFF.md` | 최종 상태 | 항목 확인 |
+
+## 검증 명령
+
+```bash
+/validate --stage 10-deployment
+```
+
+## 품질 기준
+
+### .github/workflows/
+- [ ] CI 워크플로우 존재 (ci.yml)
+- [ ] CD 워크플로우 존재 (cd.yml)
+- [ ] 빌드 단계 포함
+- [ ] 테스트 단계 포함
+- [ ] 배포 단계 포함
+
+### deployment_config/
+- [ ] 환경 변수 관리
+- [ ] 시크릿 설정 가이드
+- [ ] 도메인/SSL 설정
+
+### deployment_log.md
+- [ ] 스테이징 배포 기록
+- [ ] 프로덕션 배포 기록
+- [ ] 배포 URL
+
+### HANDOFF.md (최종)
+- [ ] 프로젝트 완료 체크리스트
+- [ ] 운영 가이드 링크
+- [ ] 모니터링 설정 확인
+
+## 자동 검증 스크립트
+
+```bash
+# GitHub Actions 워크플로우 확인
+ls -la outputs/.github/workflows/
+
+# 워크플로우 유효성 검사 (yamllint)
+yamllint outputs/.github/workflows/*.yml
+
+# 배포 설정 확인
+ls -la outputs/deployment_config/
+```
+
+## CI/CD 검증
+
+| 항목 | 기준 | 확인 |
+|------|------|------|
+| CI 워크플로우 | 존재 | - |
+| CD 워크플로우 | 존재 | - |
+| 스테이징 배포 | 성공 | - |
+| 프로덕션 배포 | 성공 | - |
+| 헬스 체크 | 통과 | - |
+
+## 모니터링 체크리스트
+
+- [ ] 에러 트래킹 설정 (Sentry 등)
+- [ ] 성능 모니터링 설정
+- [ ] 로그 수집 설정
+- [ ] 알림 설정
+
+## 문서 체크리스트
+
+- [ ] 배포 가이드
+- [ ] 운영 매뉴얼
+- [ ] 트러블슈팅 가이드
+- [ ] 롤백 절차
+
+## 파이프라인 완료 확인
+
+```bash
+# 모든 스테이지 완료 확인
+/status
+
+# 최종 검증
+/validate --all
+```
+
+## 실패 시 조치
+
+1. CI 실패 → 워크플로우 수정
+2. 배포 실패 → 설정 확인 및 재시도
+3. 헬스 체크 실패 → 로그 분석 및 수정

package/template/stages/10-deployment/templates/github-actions-cd.yaml

@@ -0,0 +1,118 @@
+# GitHub Actions CD Template
+# ax-templates generated
+
+name: CD
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+    inputs:
+      environment:
+        description: 'Deployment environment'
+        required: true
+        default: 'staging'
+        type: choice
+        options:
+          - staging
+          - production
+
+env:
+  NODE_VERSION: '20'
+
+jobs:
+  deploy-staging:
+    name: Deploy to Staging
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/main' || github.event.inputs.environment == 'staging'
+    environment:
+      name: staging
+      url: ${{ steps.deploy.outputs.url }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+        env:
+          NODE_ENV: production
+
+      # Vercel 배포 예시
+      - name: Deploy to Vercel (Staging)
+        id: deploy
+        uses: amondnet/vercel-action@v25
+        with:
+          vercel-token: ${{ secrets.VERCEL_TOKEN }}
+          vercel-org-id: ${{ secrets.VERCEL_ORG_ID }}
+          vercel-project-id: ${{ secrets.VERCEL_PROJECT_ID }}
+          scope: ${{ secrets.VERCEL_ORG_ID }}
+
+      - name: Comment PR
+        if: github.event_name == 'pull_request'
+        uses: actions/github-script@v7
+        with:
+          script: |
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: '🚀 Staging deployed: ${{ steps.deploy.outputs.url }}'
+            })
+
+  deploy-production:
+    name: Deploy to Production
+    runs-on: ubuntu-latest
+    needs: deploy-staging
+    if: github.event.inputs.environment == 'production'
+    environment:
+      name: production
+      url: ${{ steps.deploy.outputs.url }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+        env:
+          NODE_ENV: production
+
+      - name: Deploy to Vercel (Production)
+        id: deploy
+        uses: amondnet/vercel-action@v25
+        with:
+          vercel-token: ${{ secrets.VERCEL_TOKEN }}
+          vercel-org-id: ${{ secrets.VERCEL_ORG_ID }}
+          vercel-project-id: ${{ secrets.VERCEL_PROJECT_ID }}
+          vercel-args: '--prod'
+          scope: ${{ secrets.VERCEL_ORG_ID }}
+
+      - name: Create Release
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const tag = `v${new Date().toISOString().slice(0,10).replace(/-/g, '.')}`;
+            await github.rest.repos.createRelease({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              tag_name: tag,
+              name: `Release ${tag}`,
+              body: 'Production deployment',
+              draft: false,
+              prerelease: false
+            });