create-ax-project 1.0.0

package/template/stages/09-testing/HANDOFF.md.template

@@ -0,0 +1,113 @@
+# Stage Handoff: 09-testing → 10-deployment
+
+**생성일**: {{TIMESTAMP}}
+**생성자**: Codex
+**소요 시간**: {{DURATION}}
+
+---
+
+## 완료된 작업
+
+- [ ] 단위 테스트 작성 ({{UNIT_COUNT}}개)
+- [ ] 통합 테스트 작성 ({{INT_COUNT}}개)
+- [ ] E2E 테스트 작성 ({{E2E_COUNT}}개)
+- [ ] 모든 테스트 통과
+- [ ] 커버리지 보고서 생성
+- [ ] HANDOFF.md 생성
+
+---
+
+## 다음 에이전트를 위한 컨텍스트
+
+### 테스트 결과 요약
+
+| 유형 | 총 개수 | 통과 | 실패 | 스킵 |
+|------|--------|------|------|------|
+| Unit | {{UNIT_COUNT}} | {{UNIT_PASS}} | {{UNIT_FAIL}} | {{UNIT_SKIP}} |
+| Integration | {{INT_COUNT}} | {{INT_PASS}} | {{INT_FAIL}} | {{INT_SKIP}} |
+| E2E | {{E2E_COUNT}} | {{E2E_PASS}} | {{E2E_FAIL}} | {{E2E_SKIP}} |
+
+### 커버리지 보고서
+
+| 메트릭 | 결과 | 목표 | 상태 |
+|--------|------|------|------|
+| Statements | {{STMT_COV}}% | 80% | {{STMT_STATUS}} |
+| Branches | {{BRANCH_COV}}% | 75% | {{BRANCH_STATUS}} |
+| Functions | {{FUNC_COV}}% | 80% | {{FUNC_STATUS}} |
+| Lines | {{LINE_COV}}% | 80% | {{LINE_STATUS}} |
+
+### E2E 테스트 시나리오
+
+| 시나리오 | 상태 | 실행 시간 |
+|----------|------|-----------|
+| {{E2E_1}} | Pass | {{TIME_1}} |
+| {{E2E_2}} | Pass | {{TIME_2}} |
+| {{E2E_3}} | Pass | {{TIME_3}} |
+
+### CI 통합 준비 사항
+- 테스트 명령어: `npm test`
+- 커버리지 명령어: `npm run coverage`
+- E2E 명령어: `npm run test:e2e`
+
+---
+
+## 생성된 산출물
+
+| 파일 | 설명 |
+|------|------|
+| tests/ | 테스트 코드 |
+| test_report.md | 테스트 결과 |
+| coverage_report.md | 커버리지 보고서 |
+
+---
+
+## 10-deployment 스테이지 가이드
+
+### 즉시 실행할 작업
+1. GitHub Actions 워크플로우 설정
+2. 배포 환경 설정
+3. 환경 변수 구성
+
+### CI/CD 파이프라인 제안
+```yaml
+workflow:
+  - lint
+  - type-check
+  - unit-tests
+  - integration-tests
+  - build
+  - e2e-tests
+  - deploy
+```
+
+### 배포 전 체크리스트
+- [ ] 환경 변수 설정
+- [ ] 도메인 설정
+- [ ] SSL 인증서
+- [ ] 데이터베이스 마이그레이션
+
+---
+
+## 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: "09-testing"
+status: "completed"
+next_stage: "10-deployment"
+models_used:
+  - codex
+total_tests: {{TOTAL_TESTS}}
+coverage: {{TOTAL_COV}}%
+e2e_scenarios: {{E2E_COUNT}}
+```

package/template/stages/09-testing/config.yaml

@@ -0,0 +1,65 @@
+# Stage 09: Testing & E2E Configuration
+
+stage:
+  id: "09-testing"
+  name: "Testing & E2E"
+  description: "테스트 코드 작성 및 E2E 테스트"
+
+models:
+  primary: "codex"
+  secondary: null
+  collaboration: null
+
+execution:
+  mode: "sandbox_playwright"
+  container: false
+  sandbox: true
+  timeout: 7200  # 2 hours
+
+mcp_servers:
+  - playwright
+
+inputs:
+  required:
+    - name: "source_code/"
+      description: "테스트할 소스 코드"
+    - name: "../08-qa/outputs/qa_report.md"
+    - name: "../08-qa/HANDOFF.md"
+
+outputs:
+  required:
+    - name: "tests/"
+      description: "테스트 코드"
+    - name: "test_report.md"
+      description: "테스트 결과 보고서"
+    - name: "coverage_report.md"
+      description: "커버리지 보고서"
+    - name: "HANDOFF.md"
+
+prompts:
+  - name: "unit_tests"
+    file: "prompts/unit_tests.md"
+    model: "codex"
+  - name: "integration_tests"
+    file: "prompts/integration_tests.md"
+    model: "codex"
+  - name: "e2e_tests"
+    file: "prompts/e2e_tests.md"
+    model: "codex"
+
+completion:
+  checklist:
+    - "단위 테스트 작성 (커버리지 80%+)"
+    - "통합 테스트 작성"
+    - "E2E 테스트 작성"
+    - "모든 테스트 통과"
+    - "커버리지 보고서 생성"
+  validation:
+    min_coverage: 80
+
+transition:
+  next_stage: "10-deployment"
+  prerequisites:
+    - "08-qa"
+  handoff_required: true
+  checkpoint_required: false

package/template/stages/09-testing/outputs/test_report.md

@@ -0,0 +1,146 @@
+# Test Report - Snake Game
+
+> 생성일: 2026-01-21
+> 프로젝트: snake-game
+> 스테이지: 09-testing
+
+---
+
+## 테스트 요약
+
+| 항목 | 값 |
+|------|-----|
+| 테스트 프레임워크 | Vitest 4.0.17 |
+| 총 테스트 수 | 43개 |
+| 통과 | 43개 (100%) |
+| 실패 | 0개 |
+| 실행 시간 | 880ms |
+
+---
+
+## 커버리지 요약
+
+| 파일 | Statements | Branches | Functions | Lines |
+|------|------------|----------|-----------|-------|
+| **collision.ts** | 76.19% | 85.71% | 80% | 77.77% |
+| **gameReducer.ts** | 87.5% | 86.11% | 100% | 87.27% |
+| **config.ts** | 100% | 100% | 100% | 100% |
+| **전체** | 30.87% | 37.81% | 29.03% | 31.44% |
+
+### 핵심 로직 커버리지
+- **충돌 감지 (collision.ts)**: 77% - 우수
+- **게임 상태 관리 (gameReducer.ts)**: 87% - 우수
+- **설정 (config.ts)**: 100% - 완벽
+
+---
+
+## 테스트 파일 목록
+
+### 1. collision.test.ts (23 tests)
+
+#### isSamePoint
+- ✅ 동일한 포인트 판별
+- ✅ 다른 포인트 판별
+- ✅ y만 다른 포인트 판별
+
+#### checkWallCollision
+- ✅ 보드 내부 포인트
+- ✅ 음수 x 좌표
+- ✅ 음수 y 좌표
+- ✅ 보드 경계 x
+- ✅ 보드 경계 y
+- ✅ 코너 (0,0)
+- ✅ 최대 유효 위치 (19,19)
+
+#### checkSelfCollision
+- ✅ 충돌 없는 짧은 뱀
+- ✅ 머리와 몸 충돌
+- ✅ 길이 1 뱀
+
+#### checkFoodCollision
+- ✅ 머리가 음식 위치에 있을 때
+- ✅ 머리가 음식 위치에 없을 때
+
+#### detectCollision
+- ✅ 벽 충돌 반환
+- ✅ 자기 충돌 반환
+- ✅ 음식 충돌 반환
+- ✅ 충돌 없음 반환
+- ✅ 벽 충돌 우선순위
+
+#### isOnSnake
+- ✅ 뱀 머리 위 포인트
+- ✅ 뱀 몸 위 포인트
+- ✅ 뱀 위에 없는 포인트
+
+---
+
+### 2. gameReducer.test.ts (20 tests)
+
+#### createInitialState
+- ✅ 기본 초기 상태 생성
+- ✅ 제공된 최고 점수로 초기화
+- ✅ 뱀이 보드 중앙에서 시작
+
+#### START_GAME action
+- ✅ IDLE → PLAYING 상태 전이
+- ✅ GAME_OVER → PLAYING 상태 전이
+- ✅ PLAYING 상태에서 변경 안됨
+- ✅ 최고 점수 유지
+
+#### PAUSE_GAME action
+- ✅ PLAYING → PAUSED 상태 전이
+- ✅ PLAYING 아닐 때 변경 안됨
+
+#### RESUME_GAME action
+- ✅ PAUSED → PLAYING 상태 전이
+- ✅ PAUSED 아닐 때 변경 안됨
+
+#### CHANGE_DIRECTION action
+- ✅ 유효한 방향 변경
+- ✅ 반대 방향(180도 회전) 차단
+- ✅ PLAYING 아닐 때 변경 안됨
+
+#### MOVE action
+- ✅ 뱀 전진 이동
+- ✅ PLAYING 아닐 때 이동 안됨
+- ✅ 벽 충돌 시 게임 오버
+- ✅ 음식 먹으면 뱀 성장
+
+#### RESET_GAME action
+- ✅ 게임 초기화 및 최고 점수 유지
+
+#### SET_HIGH_SCORE action
+- ✅ 최고 점수 업데이트
+
+---
+
+## 테스트 환경
+
+```json
+{
+  "vitest": "4.0.17",
+  "jsdom": "27.4.0",
+  "@testing-library/react": "16.3.2",
+  "@testing-library/jest-dom": "6.9.1",
+  "@vitest/coverage-v8": "4.0.17"
+}
+```
+
+---
+
+## 권장 개선 사항
+
+### 추가 테스트 필요
+1. **useGameLoop 훅** - 게임 루프 타이밍 테스트
+2. **useKeyboard 훅** - 키보드 이벤트 테스트
+3. **renderer.ts** - Canvas 렌더링 테스트 (jsdom 제한)
+
+### E2E 테스트 (향후)
+- Playwright를 사용한 전체 게임 플로우 테스트
+- 브라우저 호환성 테스트
+
+---
+
+**작성자**: ClaudeCode
+**검토일**: 2026-01-21

package/template/stages/09-testing/prompts/collaboration.md

@@ -0,0 +1,77 @@
+# AI 협업 프롬프트 - Testing & E2E
+
+## 협업 모드: Test Generation Chain
+
+이 스테이지에서는 **테스트 생성 체인**을 사용하여 포괄적인 테스트를 작성합니다.
+
+### 참여 모델
+- **Codex**: 테스트 코드 생성
+- **ClaudeCode**: E2E 테스트, Playwright 통합
+
+### 협업 프롬프트
+
+```
+# 테스트 생성 체인
+/collaborate --mode sequential --chain "codex:unit_tests -> codex:integration_tests -> claude:e2e_tests"
+```
+
+### 테스트 계층
+
+| 계층 | 담당 AI | 도구 |
+|------|---------|------|
+| 단위 테스트 | Codex | Vitest/Jest |
+| 통합 테스트 | Codex | Testing Library |
+| E2E 테스트 | Claude | Playwright |
+
+### Codex 활용
+
+```bash
+# 단위 테스트 생성
+/codex "다음 함수에 대한 단위 테스트 작성:
+[함수 코드]
+테스트 프레임워크: Vitest
+커버리지 목표: 80%"
+
+# E2E 테스트 생성
+/codex "다음 사용자 플로우에 대한 Playwright 테스트:
+1. 로그인
+2. 핵심 기능
+3. 에러 시나리오"
+```
+
+### MCP 서버: Playwright
+
+```javascript
+// E2E 테스트 예시
+test('로그인 플로우', async ({ page }) => {
+  await page.goto('/login');
+  await page.fill('[name="email"]', 'test@example.com');
+  await page.fill('[name="password"]', 'password');
+  await page.click('button[type="submit"]');
+  await expect(page).toHaveURL('/dashboard');
+});
+```
+
+### 출력 형식
+
+```markdown
+## AI 협업 결과
+
+### Codex 단위 테스트
+- [파일]: [테스트 케이스 수]
+...
+
+### Codex 통합 테스트
+- [시나리오]: [커버리지]
+...
+
+### Claude E2E 테스트
+- [플로우]: [테스트 케이스]
+...
+
+### 커버리지 요약
+- Statements: X%
+- Branches: X%
+- Functions: X%
+- Lines: X%
+```

package/template/stages/09-testing/prompts/validation.md

@@ -0,0 +1,83 @@
+# 산출물 검증 프롬프트 - Testing & E2E
+
+## 검증 대상
+
+| 산출물 | 필수 조건 | 검증 방법 |
+|--------|----------|----------|
+| `tests/` | 커버리지 80%+ | `npm run test:coverage` |
+| `test_report.md` | 100% 통과 | 결과 확인 |
+| `coverage_report.md` | 메트릭 포함 | 구조 확인 |
+| `HANDOFF.md` | 배포 준비 상태 | 항목 확인 |
+
+## 검증 명령
+
+```bash
+/validate --stage 09-testing
+```
+
+## 품질 기준
+
+### tests/
+- [ ] 단위 테스트 존재
+- [ ] 통합 테스트 존재
+- [ ] E2E 테스트 존재 (핵심 플로우)
+- [ ] 모든 테스트 통과
+
+### 커버리지 목표
+- [ ] Statements: 80%+
+- [ ] Branches: 75%+
+- [ ] Functions: 80%+
+- [ ] Lines: 80%+
+
+### test_report.md
+- [ ] 테스트 케이스 목록
+- [ ] 통과/실패 현황
+- [ ] 실패 테스트 분석 (있는 경우)
+
+### coverage_report.md
+- [ ] 커버리지 요약
+- [ ] 파일별 커버리지
+- [ ] 커버되지 않은 영역 식별
+
+### HANDOFF.md
+- [ ] 테스트 통과 확인
+- [ ] 커버리지 달성 확인
+- [ ] 배포 준비 체크리스트
+
+## 자동 검증 스크립트
+
+```bash
+# 단위/통합 테스트 실행
+npm run test
+
+# 커버리지 측정
+npm run test:coverage
+
+# E2E 테스트 실행
+npm run test:e2e
+
+# 커버리지 임계값 확인
+npm run test:coverage -- --coverageThreshold='{"global":{"statements":80,"branches":75,"functions":80,"lines":80}}'
+```
+
+## 커버리지 메트릭
+
+| 메트릭 | 목표 | 실제 | 상태 |
+|--------|------|------|------|
+| Statements | 80% | - | - |
+| Branches | 75% | - | - |
+| Functions | 80% | - | - |
+| Lines | 80% | - | - |
+
+## E2E 테스트 체크리스트
+
+- [ ] 인증 플로우 테스트
+- [ ] 핵심 기능 플로우 테스트
+- [ ] 에러 시나리오 테스트
+- [ ] 반응형 테스트 (선택적)
+
+## 실패 시 조치
+
+1. 테스트 실패 → 버그 수정 후 재실행
+2. 커버리지 미달 → 테스트 추가
+3. E2E 실패 → UI/로직 수정

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

@@ -0,0 +1,117 @@
+# Stage 10: CI/CD & Deployment
+
+배포 파이프라인 설정 및 배포 단계
+
+## 🎭 페르소나: DevOps Specialist
+
+> 당신은 DevOps Specialist입니다.
+> 안전하고 반복 가능한 배포 프로세스를 구축하세요.
+> 항상 롤백 가능성을 고려하고 모니터링을 설정하세요.
+
+### 특성
+- 자동화 전문
+- 보안 중시
+- 모니터링 설계
+- 롤백 준비
+
+### 권장 행동
+- 자동화된 파이프라인
+- 환경 분리
+- 롤백 전략
+- 모니터링 설정
+
+### 지양 행동
+- 수동 배포
+- 하드코딩된 설정
+- 보안 무시
+
+### AI 설정
+- **Temperature**: 0.2 (안전 최우선)
+- **안전성 집중**: Critical
+- **자동화 수준**: High
+
+## 실행 모델
+- **Primary**: ClaudeCode (CI/CD 설정)
+- **Mode**: Headless - CI/CD 환경 자동화
+
+## 목표
+1. CI/CD 파이프라인 설정
+2. 배포 환경 구성
+3. 모니터링 설정
+4. 문서화 완료
+
+## 입력 파일
+- `source_code/` - 최종 소스 코드
+- `../09-testing/outputs/tests/`
+- `../09-testing/outputs/test_report.md`
+- `../09-testing/HANDOFF.md`
+
+## 출력 파일
+- `outputs/.github/workflows/` - GitHub Actions
+- `outputs/deployment_config/` - 배포 설정
+- `outputs/deployment_log.md` - 배포 로그
+- `HANDOFF.md` (최종)
+
+## 워크플로우
+
+### 1. CI 파이프라인 설정
+```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
+```
+
+### 2. CD 파이프라인 설정
+- 스테이징 환경 배포
+- 프로덕션 환경 배포
+- 롤백 전략
+
+### 3. 환경 설정
+- 환경 변수 관리
+- 시크릿 설정
+- 도메인/SSL
+
+### 4. 모니터링 설정
+- 에러 트래킹 (Sentry)
+- 성능 모니터링
+- 로그 수집
+
+### 5. 문서화
+- 배포 가이드
+- 운영 매뉴얼
+- 트러블슈팅 가이드
+
+## 배포 플랫폼 옵션
+- **Vercel**: Next.js 권장
+- **Railway**: 풀스택
+- **AWS**: 엔터프라이즈
+- **Cloudflare**: Edge
+
+## 완료 조건
+- [ ] CI 파이프라인 설정
+- [ ] CD 파이프라인 설정
+- [ ] 스테이징 배포 성공
+- [ ] 프로덕션 배포 성공
+- [ ] 모니터링 설정
+- [ ] 배포 문서 작성
+- [ ] HANDOFF.md 생성 (최종)
+
+## 파이프라인 종료
+이것이 마지막 스테이지입니다. 배포 완료 후:
+1. 전체 프로젝트 회고
+2. 학습 내용 문서화
+3. 유지보수 계획 수립
+
+
+
+