create-ax-project 1.0.0

package/template/.claude/commands/fork.md

@@ -0,0 +1,142 @@
+# /fork - Pipeline Forking Command
+
+파이프라인을 분기하여 여러 접근법을 동시에 탐색합니다.
+
+## 사용법
+
+```bash
+/fork [options]
+```
+
+## 옵션
+
+| 옵션 | 설명 | 기본값 |
+|------|------|--------|
+| `--reason` | 분기 이유 (필수) | - |
+| `--name` | 분기 이름 | auto |
+| `--direction` | 탐색 방향 설명 | - |
+| `--compare` | 기존 분기와 비교 | false |
+| `--merge` | 분기 병합 | false |
+| `--list` | 활성 분기 목록 | false |
+
+## 기본 사용
+
+### 새 분기 생성
+```bash
+/fork --reason "아키텍처 대안 탐색"
+```
+
+### 분기 목록 확인
+```bash
+/fork --list
+```
+
+### 분기 비교
+```bash
+/fork --compare
+```
+
+### 분기 병합
+```bash
+/fork --merge --select "fork_03_alternative_a"
+```
+
+## 분기 프로세스
+
+```
+1. 현재 상태 체크포인트 생성
+2. 분기 디렉토리 생성 (state/forks/)
+3. 상태 복사
+4. 분기용 HANDOFF 생성
+5. 분기 작업 시작
+```
+
+## 분기 비교 출력
+
+```markdown
+# Fork Comparison
+
+## Active Forks
+| ID | Name | Stage | Progress | Created |
+|----|------|-------|----------|---------|
+| 1 | alternative_a | 06 | 60% | 2024-01-20 |
+| 2 | alternative_b | 06 | 45% | 2024-01-20 |
+| 3 | main | 06 | 100% | - |
+
+## Metrics Comparison
+| Metric | Main | Alt A | Alt B |
+|--------|------|-------|-------|
+| Code Quality | 0.85 | 0.90 | 0.82 |
+| Performance | 0.80 | 0.75 | 0.88 |
+| Maintainability | 0.88 | 0.85 | 0.80 |
+
+## Recommendation
+**Alt A** 권장: 더 높은 코드 품질
+```
+
+## 병합 전략
+
+### best_performer
+```bash
+/fork --merge --strategy best_performer
+```
+- 메트릭 기반 최고 성능 분기 선택
+
+### manual
+```bash
+/fork --merge --strategy manual --select "fork_01"
+```
+- 수동 선택
+
+### cherry_pick
+```bash
+/fork --merge --strategy cherry_pick
+```
+- 여러 분기에서 최적 부분 선택
+
+## 예시
+
+```bash
+# 아키텍처 대안 탐색을 위한 분기
+/fork --reason "REST vs GraphQL 비교" --direction "GraphQL 방식 구현"
+
+# 현재 분기 상태 확인
+/fork --list
+
+# 분기 비교 및 메트릭 확인
+/fork --compare
+
+# 최고 성능 분기로 병합
+/fork --merge --strategy best_performer
+```
+
+## 분기 저장 위치
+
+```
+state/forks/
+├── fork_03_rest_20240120/
+│   ├── source_code/
+│   ├── state/
+│   └── FORK_HANDOFF.md
+├── fork_03_graphql_20240120/
+│   ├── source_code/
+│   ├── state/
+│   └── FORK_HANDOFF.md
+└── comparison.json
+```
+
+## 설정
+
+`config/pipeline_forking.yaml` 참조
+
+## 제한사항
+
+- 최대 활성 분기: 3개
+- 분기 최대 실행 시간: 2시간
+- 병합 전 체크포인트 자동 생성
+
+## 관련 커맨드
+
+- `/checkpoint` - 체크포인트 생성
+- `/restore` - 체크포인트 복구
+- `/status` - 파이프라인 상태

package/template/.claude/commands/gemini.md

@@ -0,0 +1,84 @@
+# /gemini
+
+tmux 세션을 통해 Gemini CLI를 호출합니다.
+
+## 사용법
+```
+/gemini [prompt]
+```
+
+## 동작
+
+1. **tmux 세션 확인/생성**
+   - 세션명: `ax-gemini`
+   - 없으면 새로 생성
+
+2. **Gemini CLI 실행**
+   - 프롬프트 전송
+   - 응답 대기 (wait-for 방식)
+
+3. **결과 캡처 및 반환**
+   - 출력 파일에서 결과 읽기
+   - 사용자에게 표시
+
+## 실행 스크립트
+
+```bash
+scripts/gemini-wrapper.sh "$ARGUMENTS"
+```
+
+## 예시
+
+```
+/gemini Reddit의 r/programming에서 Claude Code 관련 최신 게시물을 요약해주세요
+
+Gemini 호출 중...
+세션: ax-gemini
+타임아웃: 300초
+
+[응답]
+Reddit r/programming에서 Claude Code 관련 최신 게시물:
+
+1. "Claude Code로 전체 프로젝트 리팩토링한 경험" (3일 전)
+   - 200줄 이상의 함수를 깔끔하게 분리
+   - 테스트 커버리지 30% → 85%로 향상
+   - 장점: 컨텍스트 이해력, 단점: 큰 파일 처리 속도
+
+2. ...
+```
+
+## 활용 시나리오
+
+### 1. 브레인스토밍 (01-brainstorm)
+```
+/gemini 다음 프로젝트에 대해 창의적인 아이디어 10개를 발산해주세요:
+[프로젝트 설명]
+```
+
+### 2. 웹 리서치 (02-research)
+```
+/gemini 최신 React 서버 컴포넌트 베스트 프랙티스를 웹에서 검색해주세요
+```
+
+### 3. 경쟁사 분석
+```
+/gemini [경쟁사 URL]의 기능과 UI를 분석해주세요
+```
+
+## 타임아웃
+
+기본 타임아웃: 300초 (5분)
+
+변경:
+```
+/gemini --timeout 600 [긴 작업 프롬프트]
+```
+
+## 제한사항
+- Gemini CLI가 설치되어 있어야 함
+- tmux가 설치되어 있어야 함
+- 대화형 프롬프트는 지원하지 않음 (단발성 질의만)
+
+## 관련
+- `/codex`: Codex CLI 호출
+- `scripts/gemini-wrapper.sh`: 래퍼 스크립트

package/template/.claude/commands/handoff.md

@@ -0,0 +1,80 @@
+# /handoff
+
+현재 스테이지의 HANDOFF.md 문서를 생성합니다.
+
+## 사용법
+```
+/handoff
+```
+
+## 동작
+
+1. **현재 스테이지 확인**
+   - `state/progress.json`에서 현재 스테이지 조회
+
+2. **완료 조건 검증**
+   - 스테이지 config.yaml의 completion.checklist 확인
+   - 필수 출력 파일 존재 확인
+
+3. **HANDOFF.md 생성**
+   - `HANDOFF.md.template` 기반으로 생성
+   - 변수 치환 (타임스탬프, 산출물 등)
+   - 사용자 입력 받기 (핵심 결정사항 등)
+
+4. **상태 업데이트**
+   - `state/progress.json` 핸드오프 완료 표시
+   - `state/handoffs/` 디렉토리에 복사본 저장
+
+5. **다음 스테이지 안내**
+   - 다음 스테이지 정보 표시
+   - `/run-stage [next]` 명령어 안내
+
+## 실행 스크립트
+
+```bash
+scripts/create-handoff.sh
+```
+
+## 예시
+
+```
+/handoff
+
+현재 스테이지: 01-brainstorm
+
+완료 조건 검증:
+✓ 최소 10개 아이디어 생성
+✓ 3개 이상 사용자 페르소나 정의
+✓ 요구사항 분석 문서 완성
+
+핵심 결정사항을 입력해주세요:
+> MVP는 인증, 핵심기능 A, 핵심기능 B로 한정
+
+HANDOFF.md 생성 완료!
+- 위치: stages/01-brainstorm/HANDOFF.md
+- 백업: state/handoffs/01-brainstorm-20240120-1030.md
+
+다음 단계:
+/run-stage 02-research
+```
+
+## 완료 조건 미충족 시
+
+```
+/handoff
+
+현재 스테이지: 01-brainstorm
+
+완료 조건 검증:
+✓ 최소 10개 아이디어 생성
+✗ 3개 이상 사용자 페르소나 정의 (현재: 2개)
+✓ 요구사항 분석 문서 완성
+
+완료 조건을 충족해주세요.
+또는 --force 옵션으로 강제 생성:
+/handoff --force
+```
+
+## 옵션
+- `--force`: 완료 조건 미충족 시에도 강제 생성
+- `--draft`: 초안으로 생성 (다음 스테이지 진행 불가)

package/template/.claude/commands/implement.md

@@ -0,0 +1,82 @@
+# /implement
+
+06-implementation 스테이지를 바로 시작합니다.
+
+## 사용법
+```
+/implement [task-id]
+```
+
+## 스테이지 정보
+
+| 항목 | 값 |
+|------|-----|
+| 스테이지 | 06-implementation |
+| AI 모델 | ClaudeCode |
+| 실행 모드 | Plan Mode + Sandbox |
+| 체크포인트 | **필수** |
+| 타임아웃 | 240분 (최장) |
+
+## 동작
+
+1. **전제 조건 확인**
+   - 05-task-management 완료 여부
+   - tasks.json 존재
+
+2. **구현 실행**
+   - 태스크별 구현
+   - 단위 테스트 작성
+   - 코드 품질 검증
+
+3. **산출물 생성**
+   - src/ - 소스코드
+   - tests/ - 단위 테스트
+   - implementation-notes.md
+
+## 실행
+
+```bash
+scripts/run-stage.sh 06-implementation "$ARGUMENTS"
+```
+
+## 입력 파일
+
+- `stages/05-task-management/outputs/tasks.json`
+- `stages/05-task-management/outputs/sprints.md`
+- `stages/04-ui-ux/outputs/wireframes/`
+
+## 출력 파일
+
+- `stages/06-implementation/outputs/src/`
+- `stages/06-implementation/outputs/tests/`
+- `stages/06-implementation/outputs/implementation-notes.md`
+
+## 체크포인트 필수!
+
+이 스테이지는 **체크포인트 필수**입니다:
+
+```bash
+# 주요 마일스톤마다 실행
+/checkpoint "스프린트 1 완료"
+```
+
+## 완료 조건
+
+- [ ] 모든 태스크 구현 완료
+- [ ] 단위 테스트 통과
+- [ ] 린트/타입 체크 통과
+- [ ] 체크포인트 생성 완료
+
+## 관련 명령어
+
+- `/run-stage 06` - 전제조건 확인 후 시작
+- `/next` - 다음 스테이지 (07-refactoring)
+- `/tasks` - 이전 스테이지
+- `/checkpoint` - 체크포인트 생성
+- `/restore` - 체크포인트 복구
+
+## Tips
+
+- 스프린트 단위로 체크포인트 생성
+- 테스트와 함께 구현
+- implementation-notes.md에 결정사항 기록

package/template/.claude/commands/init-project.md

@@ -0,0 +1,49 @@
+# /init-project
+
+새 프로젝트를 ax-templates 워크플로우로 초기화합니다.
+
+## 사용법
+```
+/init-project [project-name]
+```
+
+## 동작
+
+1. **프로젝트 디렉토리 생성**
+   - `projects/[project-name]/` 생성
+   - 스테이지별 작업 디렉토리 생성
+
+2. **상태 파일 초기화**
+   - `state/progress.json` 프로젝트 정보 업데이트
+   - 타임스탬프 기록
+
+3. **입력 파일 준비**
+   - `stages/01-brainstorm/inputs/project_brief.md` 템플릿 생성
+
+4. **첫 스테이지 안내**
+   - 01-brainstorm 스테이지 CLAUDE.md 안내
+
+## 실행 스크립트
+
+```bash
+scripts/init-project.sh "$ARGUMENTS"
+```
+
+## 예시
+
+```
+/init-project my-saas-app
+
+출력:
+✓ 프로젝트 'my-saas-app' 초기화 완료
+✓ 작업 디렉토리: projects/my-saas-app/
+✓ 상태 파일 업데이트됨
+
+다음 단계:
+1. stages/01-brainstorm/inputs/project_brief.md 작성
+2. /run-stage 01-brainstorm 실행
+```
+
+## 주의사항
+- 프로젝트 이름은 영문 소문자, 숫자, 하이픈만 허용
+- 기존 프로젝트 덮어쓰기 불가

package/template/.claude/commands/next.md

@@ -0,0 +1,125 @@
+# /next
+
+현재 스테이지를 완료하고 다음 스테이지로 전환합니다.
+
+## 사용법
+```
+/next
+/next --force    # 조건 검증 건너뛰기
+/next --preview  # 전환 미리보기
+```
+
+## 동작
+
+1. **현재 스테이지 완료 조건 검증**
+   - outputs 파일 존재 확인
+   - 필수 체크포인트 확인 (해당 시)
+   - config.yaml의 completion_criteria 검증
+
+2. **HANDOFF.md 자동 생성**
+   - 완료된 작업 요약
+   - 핵심 결정사항
+   - 다음 단계 안내
+
+3. **상태 업데이트**
+   - 현재 스테이지: `completed`
+   - 다음 스테이지: `in_progress`
+   - progress.json 업데이트
+
+4. **다음 스테이지 시작**
+   - 다음 스테이지 CLAUDE.md 로드
+   - 입력 파일 확인
+
+## 실행 스크립트
+
+```bash
+scripts/next-stage.sh "$ARGUMENTS"
+```
+
+## 출력 예시
+
+### 성공적인 전환
+```
+/next
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🔄 스테이지 전환
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+현재: 04-ui-ux → 다음: 05-task-management
+
+[완료 조건 검증]
+✓ wireframes/ 디렉토리 존재
+✓ component-spec.md 생성됨
+✓ design-system.md 생성됨
+
+[HANDOFF.md 생성]
+✓ stages/04-ui-ux/HANDOFF.md 생성됨
+
+[상태 업데이트]
+✓ 04-ui-ux: completed
+✓ 05-task-management: in_progress
+✓ progress.json 업데이트됨
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ 05-task-management 스테이지 시작!
+
+다음 작업:
+1. stages/05-task-management/CLAUDE.md 참조
+2. PRD.md 기반 태스크 분해 시작
+3. /tasks 명령어로 바로 시작 가능
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### 조건 미충족
+```
+/next
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+⚠️  스테이지 전환 불가
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+현재: 06-implementation
+
+[완료 조건 검증]
+✓ src/ 디렉토리 존재
+✓ 구현 파일 생성됨
+✗ 체크포인트 필수 (미생성)
+✗ tests/ 통과 확인 필요
+
+다음 단계:
+1. /checkpoint 실행
+2. 테스트 실행 후 결과 확인
+3. /next --force로 강제 전환 (비권장)
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## 옵션
+
+| 옵션 | 설명 |
+|------|------|
+| `--force` | 완료 조건 검증 건너뛰기 (비권장) |
+| `--preview` | 전환 미리보기만 (실제 전환 안 함) |
+| `--no-handoff` | HANDOFF.md 생성 안 함 |
+
+## 완료 조건 (스테이지별)
+
+| 스테이지 | 필수 outputs | 체크포인트 |
+|----------|-------------|-----------|
+| 01-brainstorm | ideas.md, decisions.md | - |
+| 02-research | research.md, tech-stack.md | - |
+| 03-planning | PRD.md, architecture.md | - |
+| 04-ui-ux | wireframes/, components.md | - |
+| 05-task-mgmt | tasks.json, sprints.md | - |
+| 06-implementation | src/, tests/ | ✅ 필수 |
+| 07-refactoring | (변경된 src/) | ✅ 필수 |
+| 08-qa | qa-report.md | - |
+| 09-testing | test-results.md | - |
+| 10-deployment | CI/CD 완료 | - |
+
+## 관련 명령어
+
+- `/status` - 현재 상태 확인
+- `/handoff` - HANDOFF.md만 생성
+- `/checkpoint` - 체크포인트 생성
+- `/run-stage [id]` - 특정 스테이지로 이동

package/template/.claude/commands/planning.md

@@ -0,0 +1,69 @@
+# /planning
+
+03-planning 스테이지를 바로 시작합니다.
+
+## 사용법
+```
+/planning
+```
+
+## 스테이지 정보
+
+| 항목 | 값 |
+|------|-----|
+| 스테이지 | 03-planning |
+| AI 모델 | Gemini |
+| 실행 모드 | Plan Mode |
+| 체크포인트 | 선택 |
+
+## 동작
+
+1. **전제 조건 확인**
+   - 02-research 완료 여부
+   - research.md, tech-stack.md 존재
+
+2. **기획 실행**
+   - PRD (Product Requirements Document) 작성
+   - 아키텍처 설계
+   - 기술 명세
+
+3. **산출물 생성**
+   - PRD.md - 제품 요구사항 문서
+   - architecture.md - 아키텍처 설계
+
+## 실행
+
+```bash
+scripts/run-stage.sh 03-planning "$ARGUMENTS"
+```
+
+## 입력 파일
+
+- `stages/02-research/outputs/research.md`
+- `stages/02-research/outputs/tech-stack.md`
+
+## 출력 파일
+
+- `stages/03-planning/outputs/PRD.md`
+- `stages/03-planning/outputs/architecture.md`
+
+## 관련 명령어
+
+- `/run-stage 03` - 전제조건 확인 후 시작
+- `/next` - 다음 스테이지 (04-ui-ux)
+- `/research` - 이전 스테이지
+- `/gemini` - Gemini CLI 직접 호출
+
+## PRD 구조
+
+```markdown
+# PRD: [프로젝트명]
+
+## 개요
+## 목표
+## 기능 요구사항
+## 비기능 요구사항
+## 기술 스택
+## 일정
+## 위험 요소
+```

package/template/.claude/commands/qa.md

@@ -0,0 +1,81 @@
+# /qa
+
+08-qa 스테이지를 바로 시작합니다.
+
+## 사용법
+```
+/qa [focus-area]
+```
+
+## 스테이지 정보
+
+| 항목 | 값 |
+|------|-----|
+| 스테이지 | 08-qa |
+| AI 모델 | ClaudeCode |
+| 실행 모드 | Plan Mode + Sandbox |
+| 체크포인트 | 선택 |
+
+## 동작
+
+1. **전제 조건 확인**
+   - 07-refactoring 완료 여부
+   - src/, tests/ 존재
+
+2. **QA 실행**
+   - 코드 품질 검사
+   - 보안 취약점 스캔
+   - 성능 분석
+
+3. **산출물 생성**
+   - qa-report.md - QA 보고서
+   - issues.json - 발견된 이슈
+
+## 실행
+
+```bash
+scripts/run-stage.sh 08-qa "$ARGUMENTS"
+```
+
+## 입력 파일
+
+- `stages/06-implementation/outputs/src/`
+- `stages/07-refactoring/outputs/refactoring-report.md`
+
+## 출력 파일
+
+- `stages/08-qa/outputs/qa-report.md`
+- `stages/08-qa/outputs/issues.json`
+- `stages/08-qa/outputs/security-audit.md`
+
+## QA 체크리스트
+
+### 코드 품질
+- [ ] 린트 규칙 통과
+- [ ] 타입 체크 통과
+- [ ] 코드 복잡도 검사
+- [ ] 테스트 커버리지 확인
+
+### 보안
+- [ ] 의존성 취약점 스캔
+- [ ] 하드코딩된 시크릿 검사
+- [ ] OWASP Top 10 검토
+
+### 성능
+- [ ] 번들 크기 분석
+- [ ] 렌더링 성능
+- [ ] 메모리 사용량
+
+## 관련 명령어
+
+- `/run-stage 08` - 전제조건 확인 후 시작
+- `/next` - 다음 스테이지 (09-testing)
+- `/refactor` - 이전 스테이지
+- `/test` - 테스팅 바로 시작
+
+## QA 도구
+
+- ESLint/Prettier - 코드 스타일
+- TypeScript - 타입 검사
+- npm audit - 보안 스캔
+- Coverage - 테스트 커버리지