create-ax-project 1.0.0

package/template/.claude/commands/benchmark.md

@@ -0,0 +1,103 @@
+# /benchmark - AI Model Benchmarking Command
+
+AI 모델 성능을 비교하고 최적 모델을 선택합니다.
+
+## 사용법
+
+```bash
+/benchmark [options]
+```
+
+## 옵션
+
+| 옵션 | 설명 | 기본값 |
+|------|------|--------|
+| `--task` | 벤치마크할 태스크 유형 | code_generation |
+| `--models` | 비교할 모델 (쉼표 구분) | claude,codex |
+| `--samples` | 샘플 태스크 수 | 3 |
+| `--metrics` | 측정 메트릭 | correctness,performance |
+| `--verbose` | 상세 출력 | false |
+
+## 벤치마크 태스크 유형
+
+### code_generation
+```bash
+/benchmark --task code_generation --models "claude,codex"
+```
+- 메트릭: correctness, performance, style_compliance, readability
+
+### refactoring
+```bash
+/benchmark --task refactoring --models "codex,claude"
+```
+- 메트릭: complexity_reduction, test_coverage, maintainability
+
+### test_generation
+```bash
+/benchmark --task test_generation --models "codex,claude"
+```
+- 메트릭: coverage, edge_cases, quality
+
+## 출력 형식
+
+```markdown
+# AI Benchmark Results
+
+## Task: code_generation
+## Models: claude, codex
+
+### Score Summary
+| Model | Score | Rank |
+|-------|-------|------|
+| Claude | 0.88 | 1 |
+| Codex | 0.82 | 2 |
+
+### Metric Breakdown
+| Metric | Weight | Claude | Codex |
+|--------|--------|--------|-------|
+| Correctness | 0.4 | 0.95 | 0.85 |
+| Performance | 0.2 | 0.80 | 0.90 |
+| Style | 0.2 | 0.90 | 0.80 |
+| Readability | 0.2 | 0.85 | 0.75 |
+
+### Recommendation
+현재 태스크에 **Claude** 사용 권장
+```
+
+## 예시
+
+```bash
+# 코드 생성 벤치마크
+/benchmark --task code_generation
+
+# 상세 결과 출력
+/benchmark --task refactoring --verbose
+
+# 특정 모델만 비교
+/benchmark --task test_generation --models "codex"
+```
+
+## 결과 저장
+
+- 결과: `state/ai_benchmarks/`
+- 리포트: `state/ai_benchmarks/reports/`
+
+## 히스토리 조회
+
+```bash
+# 최근 벤치마크 결과 확인
+cat state/ai_benchmarks/latest.json
+
+# 주간 트렌드 확인
+scripts/ai-benchmark.sh --history weekly
+```
+
+## 설정
+
+`config/ai_benchmarking.yaml` 참조
+
+## 관련 커맨드
+
+- `/collaborate` - AI 협업
+- `/gemini` - Gemini 직접 호출
+- `/codex` - Codex 직접 호출

package/template/.claude/commands/brainstorm.md

@@ -0,0 +1,67 @@
+# /brainstorm
+
+01-brainstorm 스테이지를 바로 시작합니다.
+
+## 사용법
+```
+/brainstorm [topic]
+```
+
+## 스테이지 정보
+
+| 항목 | 값 |
+|------|-----|
+| 스테이지 | 01-brainstorm |
+| AI 모델 | Gemini + ClaudeCode |
+| 실행 모드 | YOLO (Container) |
+| 체크포인트 | 선택 |
+
+## 동작
+
+1. **전제 조건 확인**
+   - 프로젝트 초기화 여부 (progress.json)
+
+2. **스테이지 시작**
+   - Gemini CLI 호출 (창의적 아이디어)
+   - ClaudeCode 병렬 실행 (기술 검토)
+
+3. **산출물 생성**
+   - ideas.md - 브레인스토밍 아이디어
+   - decisions.md - 핵심 결정사항
+
+## 실행
+
+```bash
+# /run-stage 01과 동일
+scripts/run-stage.sh 01-brainstorm "$ARGUMENTS"
+```
+
+## 출력 예시
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🧠 Stage 01: Brainstorm
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+AI: Gemini + ClaudeCode (병렬)
+Mode: YOLO (Container)
+
+주제: $ARGUMENTS
+
+[Gemini] 창의적 아이디어 생성 중...
+[ClaudeCode] 기술 검토 중...
+
+완료 후: /next 또는 /research
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## 관련 명령어
+
+- `/run-stage 01` - 전제조건 확인 후 시작
+- `/next` - 다음 스테이지 (02-research)
+- `/gemini` - Gemini CLI 직접 호출
+
+## Tips
+
+- YOLO 모드: 실패해도 괜찮음, 창의성 우선
+- 여러 아이디어를 자유롭게 탐색
+- decisions.md에 최종 선택 기록

package/template/.claude/commands/checkpoint.md

@@ -0,0 +1,93 @@
+# /checkpoint
+
+현재 상태의 체크포인트를 생성합니다.
+
+## 사용법
+```
+/checkpoint [description]
+```
+
+## 동작
+
+1. **현재 상태 캡처**
+   - 현재 스테이지 정보
+   - 모든 outputs 파일
+   - state/progress.json
+   - 소스 코드 (해당 시)
+
+2. **체크포인트 생성**
+   - ID: `CP-[stage]-[timestamp]`
+   - 위치: `state/checkpoints/[CP-ID]/`
+
+3. **메타데이터 저장**
+   ```json
+   {
+     "id": "CP-06-20240120-1430",
+     "stage": "06-implementation",
+     "description": "스프린트 1 완료",
+     "created_at": "2024-01-20T14:30:00Z",
+     "files": [...],
+     "progress_snapshot": {...}
+   }
+   ```
+
+4. **state/progress.json 업데이트**
+   - checkpoints 배열에 추가
+
+## 실행 스크립트
+
+```bash
+scripts/create-checkpoint.sh "$ARGUMENTS"
+```
+
+## 예시
+
+```
+/checkpoint 스프린트 1 완료
+
+체크포인트 생성 중...
+✓ 현재 상태 캡처 완료
+✓ 파일 복사 완료 (42개 파일)
+✓ 메타데이터 저장 완료
+
+체크포인트 생성 완료!
+- ID: CP-06-20240120-1430
+- 위치: state/checkpoints/CP-06-20240120-1430/
+- 설명: 스프린트 1 완료
+
+복구 명령어:
+scripts/restore-checkpoint.sh CP-06-20240120-1430
+```
+
+## 체크포인트 목록 보기
+
+```
+/checkpoint --list
+
+체크포인트 목록:
+| ID | 스테이지 | 설명 | 생성일 |
+|----|----------|------|--------|
+| CP-06-20240120-1030 | 06-impl | 프로젝트 초기화 | 2024-01-20 10:30 |
+| CP-06-20240120-1430 | 06-impl | 스프린트 1 완료 | 2024-01-20 14:30 |
+```
+
+## 체크포인트 복구
+
+```bash
+scripts/restore-checkpoint.sh CP-06-20240120-1030
+
+경고: 현재 상태가 체크포인트 CP-06-20240120-1030 시점으로 복구됩니다.
+현재 변경사항이 손실될 수 있습니다.
+계속하시겠습니까? [y/N] y
+
+✓ 체크포인트 복구 완료
+✓ 현재 스테이지: 06-implementation
+```
+
+## 필수 체크포인트 스테이지
+- `06-implementation`: 구현 중 주요 마일스톤마다
+- `07-refactoring`: 리팩토링 전/후
+
+## 옵션
+- `--list`: 체크포인트 목록 표시
+- `--delete [CP-ID]`: 체크포인트 삭제

package/template/.claude/commands/codex.md

@@ -0,0 +1,107 @@
+# /codex
+
+tmux 세션을 통해 OpenAI Codex CLI를 호출합니다.
+
+## 사용법
+```
+/codex [prompt]
+```
+
+## 동작
+
+1. **tmux 세션 확인/생성**
+   - 세션명: `ax-codex`
+   - 없으면 새로 생성
+
+2. **Codex CLI 실행**
+   - 프롬프트 전송
+   - 응답 대기 (wait-for 방식)
+
+3. **결과 캡처 및 반환**
+   - 출력 파일에서 결과 읽기
+   - 사용자에게 표시
+
+## 실행 스크립트
+
+```bash
+scripts/codex-wrapper.sh "$ARGUMENTS"
+```
+
+## 예시
+
+```
+/codex 다음 함수를 리팩토링해주세요. 가독성과 성능을 개선하고,
+타입 안전성을 높여주세요:
+
+function processData(data) {
+  // 긴 함수 코드
+}
+
+Codex 호출 중...
+세션: ax-codex
+타임아웃: 300초
+
+[응답]
+리팩토링된 코드:
+
+\`\`\`typescript
+interface DataItem {
+  id: string;
+  value: number;
+}
+
+function processData(data: DataItem[]): ProcessedResult {
+  // 깔끔하게 리팩토링된 코드
+}
+\`\`\`
+
+변경 사항:
+1. TypeScript 타입 추가
+2. 함수를 3개의 작은 함수로 분리
+3. 불필요한 루프 제거로 O(n²) → O(n) 최적화
+```
+
+## 활용 시나리오
+
+### 1. 코드 리팩토링 (07-refactoring)
+```
+/codex 다음 코드의 중복을 제거하고 DRY 원칙을 적용해주세요:
+[코드]
+```
+
+### 2. 테스트 코드 생성 (09-testing)
+```
+/codex 다음 함수에 대한 Jest 테스트 코드를 작성해주세요.
+엣지 케이스를 포함해주세요:
+[함수 코드]
+```
+
+### 3. 성능 최적화
+```
+/codex 다음 코드의 성능 병목을 분석하고 최적화해주세요:
+[코드]
+```
+
+### 4. 코드 분석
+```
+/codex 다음 코드의 복잡도를 분석하고 개선점을 제안해주세요:
+[코드]
+```
+
+## 타임아웃
+
+기본 타임아웃: 300초 (5분)
+
+변경:
+```
+/codex --timeout 600 [긴 작업 프롬프트]
+```
+
+## 제한사항
+- Codex CLI가 설치되어 있어야 함
+- tmux가 설치되어 있어야 함
+- 대화형 프롬프트는 지원하지 않음 (단발성 질의만)
+
+## 관련
+- `/gemini`: Gemini CLI 호출
+- `scripts/codex-wrapper.sh`: 래퍼 스크립트

package/template/.claude/commands/collaborate.md

@@ -0,0 +1,85 @@
+# /collaborate - Multi-AI Collaboration Command
+
+여러 AI 모델을 협업시켜 더 나은 결과물을 생성합니다.
+
+## 사용법
+
+```bash
+/collaborate [options]
+```
+
+## 옵션
+
+| 옵션 | 설명 | 기본값 |
+|------|------|--------|
+| `--mode` | 협업 모드 (parallel, sequential, debate) | parallel |
+| `--task` | 수행할 작업 설명 | - |
+| `--models` | 참여 AI 모델 (쉼표 구분) | gemini,claude |
+| `--chain` | 순차 체인 이름 (sequential 모드) | - |
+| `--rounds` | 토론 라운드 수 (debate 모드) | 3 |
+| `--topic` | 토론 주제 (debate 모드) | - |
+
+## 협업 모드
+
+### 1. Parallel (병렬 실행)
+```bash
+/collaborate --mode parallel --task "아이디어 생성" --models "gemini,claude"
+```
+- 동일 작업을 여러 AI가 동시 수행
+- 결과 비교 후 최적 선택
+
+### 2. Sequential (순차 핸드오프)
+```bash
+/collaborate --mode sequential --chain "code_review"
+```
+- AI 간 릴레이로 점진적 개선
+- 체인: `code_review`, `planning_review`
+
+### 3. Debate (토론)
+```bash
+/collaborate --mode debate --topic "아키텍처 선택" --rounds 3
+```
+- AI 간 토론으로 최적 결론 도출
+- 다양한 관점 비교
+
+## 사전 체인 정의
+
+### code_review
+1. Claude: 초안 작성
+2. Gemini: 창의적 개선
+3. Codex: 기술 검증
+
+### planning_review
+1. Gemini: 아이디어 발산
+2. Claude: 실현 가능성 분석
+3. Claude: 최종 계획 수립
+
+## 출력
+
+- 각 AI 결과물
+- 비교 분석 리포트
+- 최종 선택/병합 결과
+- 저장: `state/collaborations/{task_id}/`
+
+## 예시
+
+```bash
+# 기본 병렬 협업
+/collaborate --task "사용자 인증 설계"
+
+# 코드 리뷰 체인
+/collaborate --mode sequential --chain code_review
+
+# 아키텍처 토론
+/collaborate --mode debate --topic "마이크로서비스 vs 모놀리식"
+```
+
+## 설정
+
+`config/ai_collaboration.yaml` 참조
+
+## 관련 커맨드
+
+- `/benchmark` - AI 모델 벤치마킹
+- `/gemini` - Gemini 직접 호출
+- `/codex` - Codex 직접 호출

package/template/.claude/commands/context.md

@@ -0,0 +1,154 @@
+# /context
+
+컨텍스트 상태를 확인하고 관리합니다.
+
+## 사용법
+```
+/context                 # 현재 상태 확인
+/context --save [desc]   # 스냅샷 저장
+/context --compress      # 압축 실행
+/context --restore       # 저장된 상태 복구
+/context --clean         # 오래된 스냅샷 정리
+```
+
+## 동작
+
+### 상태 확인 (`/context`)
+- 추정 토큰 사용량 표시
+- 임계값 대비 상태
+- 저장된 스냅샷 목록
+
+### 스냅샷 저장 (`--save`)
+- 현재 상태를 state.md로 저장
+- 설명 추가 가능
+- state/context/ 디렉토리에 저장
+
+### 압축 실행 (`--compress`)
+- context-compression 스킬 활성화
+- 불필요한 컨텍스트 정리
+- 핵심 정보만 유지
+
+### 복구 (`--restore`)
+- 저장된 스냅샷에서 복구
+- /clear 후 사용
+
+## 실행 스크립트
+
+```bash
+scripts/context-manager.sh "$ARGUMENTS"
+```
+
+## 출력 예시
+
+### 상태 확인
+
+```
+/context
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📊 Context Status
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+토큰 사용량: ~45,230 / 80,000
+상태: ████████████░░░░░░░░ 56% [정상]
+
+임계값:
+• 경고 (50k): 아직 여유 있음
+• 한도 (80k): ~35,000 토큰 남음
+
+현재 스테이지: 04-ui-ux
+대화 메시지: 28개
+
+[저장된 스냅샷]
+• state-20240120-1030.md (03-planning 완료 시점)
+• state-20240120-1430.md (04-ui-ux 시작)
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### 경고 상태
+
+```
+/context
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+⚠️ Context Status - 경고
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+토큰 사용량: ~52,000 / 80,000
+상태: ████████████████░░░░ 65% [경고]
+
+⚠️ 경고 임계값(50k) 초과!
+
+권장 조치:
+1. /context --compress 로 압축
+2. /context --save 후 /clear
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### 스냅샷 저장
+
+```
+/context --save "UI 설계 완료"
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+💾 Context Snapshot Saved
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+파일: state/context/state-20240120-1530.md
+설명: UI 설계 완료
+스테이지: 04-ui-ux
+토큰: ~45,000
+
+[저장 내용]
+✓ 현재 스테이지 정보
+✓ 진행 상황
+✓ 핵심 결정사항 (5개)
+✓ 참조 파일 목록
+
+복구: /context --restore state-20240120-1530.md
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## 옵션
+
+| 옵션 | 설명 |
+|------|------|
+| (없음) | 현재 상태 확인 |
+| `--save [desc]` | 스냅샷 저장 |
+| `--compress` | 컨텍스트 압축 |
+| `--restore [file]` | 스냅샷 복구 |
+| `--list` | 스냅샷 목록 |
+| `--clean` | 오래된 스냅샷 정리 |
+| `--json` | JSON 형식 출력 |
+
+## 설정 참조
+
+settings.json의 context 설정:
+
+```json
+{
+  "context": {
+    "warning_threshold": 50000,
+    "limit_threshold": 80000,
+    "auto_save": true
+  }
+}
+```
+
+## 관련 스킬
+
+- `context-compression` - 자동 압축 스킬
+
+## 관련 명령어
+
+- `/status` - 파이프라인 상태
+- `/checkpoint` - 체크포인트 생성
+- `/restore` - 체크포인트 복구
+
+## Tips
+
+- 긴 작업 전 `/context --save` 권장
+- 50k 경고 시 `/context --compress` 실행
+- /clear 후 `/context --restore` 로 복구

package/template/.claude/commands/deploy.md

@@ -0,0 +1,102 @@
+# /deploy
+
+10-deployment 스테이지를 바로 시작합니다.
+
+## 사용법
+```
+/deploy [environment]
+```
+
+## 스테이지 정보
+
+| 항목 | 값 |
+|------|-----|
+| 스테이지 | 10-deployment |
+| AI 모델 | ClaudeCode |
+| 실행 모드 | Headless |
+| 체크포인트 | 선택 |
+
+## 동작
+
+1. **전제 조건 확인**
+   - 09-testing 완료 여부
+   - test-results.md 존재
+   - 모든 테스트 통과
+
+2. **배포 실행**
+   - CI/CD 파이프라인 설정
+   - 환경별 배포
+   - 모니터링 설정
+
+3. **산출물 생성**
+   - CI/CD 설정 파일
+   - deployment-log.md
+
+## 실행
+
+```bash
+scripts/run-stage.sh 10-deployment "$ARGUMENTS"
+```
+
+## 입력 파일
+
+- `stages/09-testing/outputs/test-results.md`
+- `stages/06-implementation/outputs/src/`
+- 모든 이전 스테이지 outputs
+
+## 출력 파일
+
+- `.github/workflows/ci.yaml`
+- `.github/workflows/cd.yaml`
+- `stages/10-deployment/outputs/deployment-log.md`
+
+## 배포 환경
+
+| 환경 | 설명 |
+|------|------|
+| dev | 개발 환경 |
+| staging | 스테이징 |
+| prod | 프로덕션 |
+
+## CI/CD 워크플로우
+
+```
+Push
+  ↓
+CI (Build + Test)
+  ↓
+Quality Gate
+  ↓
+CD (Deploy)
+  ↓
+Health Check
+```
+
+## 관련 명령어
+
+- `/run-stage 10` - 전제조건 확인 후 시작
+- `/test` - 이전 스테이지
+- `/status` - 파이프라인 상태
+
+## 배포 체크리스트
+
+- [ ] 환경 변수 설정
+- [ ] 시크릿 설정 (GitHub Secrets)
+- [ ] 도메인/DNS 설정
+- [ ] SSL 인증서
+- [ ] 모니터링 설정
+- [ ] 롤백 계획
+
+## 완료 시
+
+🎉 **파이프라인 완료!**
+
+모든 10개 스테이지가 완료되었습니다.
+- `/status`로 최종 상태 확인
+- `state/handoffs/`에서 전체 문서 검토
+
+## Tips
+
+- prod 배포 전 staging 검증
+- 롤백 스크립트 준비
+- 배포 후 스모크 테스트