create-ax-project 1.0.0

package/template/.claude/commands/refactor.md

@@ -0,0 +1,95 @@
+# /refactor
+
+07-refactoring 스테이지를 바로 시작합니다.
+
+## 사용법
+```
+/refactor [focus-area]
+```
+
+## 스테이지 정보
+
+| 항목 | 값 |
+|------|-----|
+| 스테이지 | 07-refactoring |
+| AI 모델 | Codex → ClaudeCode |
+| 실행 모드 | Deep Dive |
+| 체크포인트 | **필수** |
+
+## 동작
+
+1. **전제 조건 확인**
+   - 06-implementation 완료 여부
+   - src/, tests/ 존재
+   - 06 체크포인트 존재
+
+2. **리팩토링 실행**
+   - Codex: 코드 분석 및 개선 제안
+   - ClaudeCode: 리팩토링 적용
+
+3. **산출물 생성**
+   - (개선된) src/
+   - refactoring-report.md
+
+## 실행
+
+```bash
+scripts/run-stage.sh 07-refactoring "$ARGUMENTS"
+```
+
+## 워크플로우
+
+```
+Codex (분석)
+    ↓
+개선점 식별
+    ↓
+ClaudeCode (적용)
+    ↓
+테스트 검증
+```
+
+## 입력 파일
+
+- `stages/06-implementation/outputs/src/`
+- `stages/06-implementation/outputs/tests/`
+
+## 출력 파일
+
+- (수정된) `src/`
+- `stages/07-refactoring/outputs/refactoring-report.md`
+
+## 체크포인트 필수!
+
+리팩토링 전후로 **체크포인트 필수**:
+
+```bash
+# 리팩토링 전
+/checkpoint "리팩토링 전 상태"
+
+# 리팩토링 후
+/checkpoint "리팩토링 완료"
+```
+
+## 리팩토링 영역
+
+- 코드 중복 제거
+- 함수/클래스 분리
+- 명명 규칙 통일
+- 성능 최적화
+- 보안 개선
+
+## 관련 명령어
+
+- `/run-stage 07` - 전제조건 확인 후 시작
+- `/next` - 다음 스테이지 (08-qa)
+- `/implement` - 이전 스테이지
+- `/codex` - Codex CLI 직접 호출
+- `/checkpoint` - 체크포인트 생성
+- `/restore` - 롤백
+
+## Tips
+
+- 리팩토링 전 반드시 체크포인트
+- 작은 단위로 점진적 개선
+- 테스트 통과 확인 후 커밋

package/template/.claude/commands/research.md

@@ -0,0 +1,60 @@
+# /research
+
+02-research 스테이지를 바로 시작합니다.
+
+## 사용법
+```
+/research [focus-area]
+```
+
+## 스테이지 정보
+
+| 항목 | 값 |
+|------|-----|
+| 스테이지 | 02-research |
+| AI 모델 | Claude + MCP |
+| 실행 모드 | Plan Mode |
+| 체크포인트 | 선택 |
+
+## 동작
+
+1. **전제 조건 확인**
+   - 01-brainstorm 완료 여부
+   - ideas.md 파일 존재
+
+2. **리서치 실행**
+   - MCP 도구 활용 (웹 검색, API)
+   - 기술 스택 조사
+   - 경쟁 제품 분석
+
+3. **산출물 생성**
+   - research.md - 리서치 결과
+   - tech-stack.md - 기술 스택 권장사항
+
+## 실행
+
+```bash
+scripts/run-stage.sh 02-research "$ARGUMENTS"
+```
+
+## 입력 파일
+
+- `stages/01-brainstorm/outputs/ideas.md`
+- `stages/01-brainstorm/outputs/decisions.md`
+
+## 출력 파일
+
+- `stages/02-research/outputs/research.md`
+- `stages/02-research/outputs/tech-stack.md`
+
+## 관련 명령어
+
+- `/run-stage 02` - 전제조건 확인 후 시작
+- `/next` - 다음 스테이지 (03-planning)
+- `/brainstorm` - 이전 스테이지
+
+## MCP 도구 활용
+
+- Context7 - 라이브러리 문서
+- WebFetch - 웹 페이지 분석
+- WebSearch - 검색 결과 수집

package/template/.claude/commands/restore.md

@@ -0,0 +1,113 @@
+# /restore
+
+체크포인트에서 프로젝트 상태를 복구합니다.
+
+## 사용법
+```
+/restore --list          # 체크포인트 목록 보기
+/restore --latest        # 최신 체크포인트로 복구
+/restore [CP-ID]         # 특정 체크포인트로 복구
+```
+
+## 동작
+
+### 목록 보기 (`--list`)
+1. `state/checkpoints/` 디렉토리 스캔
+2. 각 체크포인트 메타데이터 읽기
+3. 표 형식으로 출력
+
+### 복구 (`[CP-ID]` 또는 `--latest`)
+1. **확인 프롬프트** (자동화 모드 아닌 경우)
+2. **현재 상태 백업** (선택적)
+3. **체크포인트 파일 복원**
+   - progress.json 복원
+   - outputs 파일 복원
+   - HANDOFF.md 복원 (있는 경우)
+4. **상태 업데이트**
+
+## 실행 스크립트
+
+```bash
+scripts/restore-checkpoint.sh "$ARGUMENTS"
+```
+
+## 출력 예시
+
+### 목록 보기
+```
+/restore --list
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+💾 Checkpoint List
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ ID                    Stage             Created
+─────────────────────────────────────────────────
+ CP-06-20240120-1030   06-implementation 2024-01-20 10:30
+ CP-06-20240120-1430   06-implementation 2024-01-20 14:30
+ CP-07-20240121-0900   07-refactoring    2024-01-21 09:00
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+총 3개 체크포인트 | /restore [ID]로 복구
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### 복구 실행
+```
+/restore CP-06-20240120-1430
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+⚠️  체크포인트 복구
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+체크포인트: CP-06-20240120-1430
+스테이지:   06-implementation
+설명:       스프린트 1 완료
+생성일:     2024-01-20 14:30
+
+⚠️  경고: 현재 상태가 해당 시점으로 복구됩니다.
+   현재 변경사항이 손실될 수 있습니다.
+
+복구를 진행하시겠습니까? [y/N] y
+
+복구 중...
+✓ progress.json 복원됨
+✓ outputs 파일 복원됨 (42개)
+✓ HANDOFF.md 복원됨
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ 체크포인트 복구 완료!
+현재 스테이지: 06-implementation
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## 옵션
+
+| 옵션 | 설명 |
+|------|------|
+| `--list` | 체크포인트 목록 표시 |
+| `--latest` | 최신 체크포인트로 복구 |
+| `--force` | 확인 없이 강제 복구 |
+| `--backup` | 복구 전 현재 상태 백업 |
+| `--dry-run` | 실제 복구 없이 미리보기 |
+
+## 주의사항
+
+- 복구 시 현재 작업 내용이 **덮어쓰기** 됩니다
+- 중요한 변경사항이 있다면 먼저 `/checkpoint` 실행
+- `--backup` 옵션으로 현재 상태 자동 백업 가능
+
+## 사용 사례
+
+1. **구현 실패 후 롤백**
+   ```
+   /restore --latest
+   ```
+
+2. **특정 시점으로 복원**
+   ```
+   /restore --list
+   /restore CP-06-20240120-1030
+   ```
+
+3. **안전한 복구 (백업 포함)**
+   ```
+   /restore CP-06-20240120-1030 --backup
+   ```

package/template/.claude/commands/run-stage.md

@@ -0,0 +1,78 @@
+# /run-stage
+
+특정 스테이지를 실행합니다.
+
+## 사용법
+```
+/run-stage [stage-id]
+```
+
+## 스테이지 ID
+- `01-brainstorm` - 브레인스토밍
+- `02-research` - 리서치
+- `03-planning` - 기획
+- `04-ui-ux` - UI/UX 설계
+- `05-task-management` - 태스크 관리
+- `06-implementation` - 구현
+- `07-refactoring` - 리팩토링
+- `08-qa` - QA
+- `09-testing` - 테스팅
+- `10-deployment` - 배포
+
+## 동작
+
+1. **전제조건 검증**
+   - 이전 스테이지 완료 여부 확인
+   - 이전 스테이지 HANDOFF.md 존재 확인
+   - 필수 입력 파일 존재 확인
+
+2. **스테이지 설정 로드**
+   - `stages/[stage-id]/config.yaml` 로드
+   - `stages/[stage-id]/CLAUDE.md` 로드
+
+3. **상태 업데이트**
+   - `state/progress.json` 현재 스테이지 업데이트
+   - 시작 시간 기록
+
+4. **스테이지 실행**
+   - 스테이지 CLAUDE.md 지침 따름
+   - 프롬프트 템플릿 활용
+
+## 실행 스크립트
+
+```bash
+scripts/run-stage.sh "$ARGUMENTS"
+```
+
+## 예시
+
+```
+/run-stage 02-research
+
+출력:
+✓ 전제조건 검증 완료
+  - 01-brainstorm: 완료 ✓
+  - HANDOFF.md: 존재 ✓
+✓ 스테이지 설정 로드됨
+✓ 현재 스테이지: 02-research
+
+[02-research CLAUDE.md 내용 표시]
+```
+
+## 전제조건 실패 시
+
+```
+/run-stage 03-planning
+
+오류:
+✗ 전제조건 미충족
+  - 02-research: 진행 중 (미완료)
+  - 02-research HANDOFF.md: 없음
+
+먼저 02-research 스테이지를 완료해주세요.
+/handoff 를 실행하여 핸드오프 문서를 생성하세요.
+```
+
+## 주의사항
+- 스테이지 건너뛰기 불가 (순차 실행)
+- 체크포인트 필수 스테이지 (06, 07)는 체크포인트 없이 진행 불가

package/template/.claude/commands/stages.md

@@ -0,0 +1,109 @@
+# /stages
+
+10단계 파이프라인의 모든 스테이지 목록과 상세 정보를 표시합니다.
+
+## 사용법
+```
+/stages
+/stages [stage-id]
+```
+
+## 동작
+
+1. **스테이지 목록 표시** (`/stages`)
+   - 모든 스테이지 번호/이름
+   - 담당 AI 모델
+   - 현재 상태
+   - 실행 모드
+
+2. **특정 스테이지 상세** (`/stages [id]`)
+   - 스테이지 config.yaml 정보
+   - 입출력 파일 목록
+   - 완료 조건
+
+## 실행 스크립트
+
+```bash
+scripts/list-stages.sh "$ARGUMENTS"
+```
+
+## 출력 예시
+
+### 목록 보기 (`/stages`)
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📋 Pipeline Stages
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ ##  Stage            AI Model        Mode          Status
+─────────────────────────────────────────────────────────
+ 01  brainstorm       Gemini+Claude   YOLO          ✅
+ 02  research         Claude+MCP      Plan Mode     ✅
+ 03  planning         Gemini          Plan Mode     ✅
+ 04  ui-ux            Gemini          Plan Mode     🔄 ←
+ 05  task-management  ClaudeCode      Plan Mode     ⏳
+ 06  implementation   ClaudeCode      Plan+Sandbox  ⏳
+ 07  refactoring      Codex           Deep Dive     ⏳
+ 08  qa               ClaudeCode      Plan+Sandbox  ⏳
+ 09  testing          Codex           Playwright    ⏳
+ 10  deployment       ClaudeCode      Headless      ⏳
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+현재: 04-ui-ux | 다음: /run-stage 05 또는 /tasks
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### 상세 보기 (`/stages 06`)
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📋 Stage 06: Implementation
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+AI Model:    ClaudeCode
+Mode:        Plan Mode + Sandbox
+Timeout:     240분 (가장 긴 스테이지)
+Checkpoint:  필수
+
+[Inputs]
+ • 05-task-management/outputs/tasks.json
+ • 05-task-management/outputs/sprint-plan.md
+ • 04-ui-ux/outputs/wireframes/
+
+[Outputs]
+ • src/ (구현된 소스코드)
+ • tests/ (단위 테스트)
+ • implementation-notes.md
+
+[Completion Criteria]
+ □ 모든 태스크 구현 완료
+ □ 단위 테스트 통과
+ □ 린트/타입 체크 통과
+ □ 체크포인트 생성 완료
+
+[Quick Commands]
+ • /implement     - 이 스테이지 바로 시작
+ • /run-stage 06  - 전제조건 확인 후 시작
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## 스테이지 정보 참조
+
+| 스테이지 | 입력 | 출력 | 특징 |
+|----------|------|------|------|
+| 01-brainstorm | (없음) | ideas.md, decisions.md | YOLO 모드, 병렬 AI |
+| 02-research | ideas.md | research.md, tech-stack.md | MCP 도구 활용 |
+| 03-planning | research.md | PRD.md, architecture.md | 기획 문서화 |
+| 04-ui-ux | PRD.md | wireframes/, components.md | 시각 설계 |
+| 05-task-mgmt | PRD, wireframes | tasks.json, sprints.md | 태스크 분해 |
+| 06-implementation | tasks.json | src/, tests/ | 핵심 구현 |
+| 07-refactoring | src/ | src/ (개선) | 코드 품질 |
+| 08-qa | src/ | qa-report.md | 품질 검증 |
+| 09-testing | src/, qa | test-results.md | E2E 테스트 |
+| 10-deployment | all | CI/CD, deploy | 배포 자동화 |
+
+## 옵션
+
+| 옵션 | 설명 |
+|------|------|
+| `--json` | JSON 형식으로 출력 |
+| `--pending` | 대기 중인 스테이지만 표시 |
+| `--completed` | 완료된 스테이지만 표시 |

package/template/.claude/commands/status.md

@@ -0,0 +1,73 @@
+# /status
+
+파이프라인 전체 상태를 한눈에 확인합니다.
+
+## 사용법
+```
+/status
+```
+
+## 동작
+
+1. **progress.json 읽기**
+   - 현재 스테이지 확인
+   - 각 스테이지 완료 상태
+
+2. **시각적 상태 표시**
+   - 진행률 바 (프로그레스)
+   - 각 스테이지 상태 아이콘
+   - 체크포인트 수
+   - 토큰 사용량 (컨텍스트)
+
+## 실행 스크립트
+
+```bash
+scripts/show-status.sh
+```
+
+## 출력 예시
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📊 Pipeline Status: my-app
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Progress: [████████░░░░░░░░░░░░] 40% (4/10)
+
+ 01 ✅ brainstorm     완료     [Gemini+Claude]
+ 02 ✅ research       완료     [Claude+MCP]
+ 03 ✅ planning       완료     [Gemini]
+ 04 🔄 ui-ux         진행중    [Gemini]
+ 05 ⏳ task-mgmt     대기      [ClaudeCode]
+ 06 ⏳ implementation 대기      [ClaudeCode]
+ 07 ⏳ refactoring   대기      [Codex]
+ 08 ⏳ qa            대기      [ClaudeCode]
+ 09 ⏳ testing       대기      [Codex]
+ 10 ⏳ deployment    대기      [ClaudeCode]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+체크포인트: 2개 | 마지막 핸드오프: 03-planning
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## 상태 아이콘
+
+| 아이콘 | 의미 |
+|--------|------|
+| ✅ | 완료 (completed) |
+| 🔄 | 진행중 (in_progress) |
+| ⏳ | 대기 (pending) |
+| ❌ | 실패 (failed) |
+| ⏸️ | 일시중지 (paused) |
+
+## 옵션
+
+| 옵션 | 설명 |
+|------|------|
+| `--json` | JSON 형식으로 출력 |
+| `--brief` | 간략한 한 줄 상태만 출력 |
+
+## 사용 사례
+
+- 새 세션 시작 시 현재 상태 파악
+- 작업 전 진행 상황 확인
+- 팀원에게 현재 상태 공유

package/template/.claude/commands/tasks.md

@@ -0,0 +1,80 @@
+# /tasks
+
+05-task-management 스테이지를 바로 시작합니다.
+
+## 사용법
+```
+/tasks
+```
+
+## 스테이지 정보
+
+| 항목 | 값 |
+|------|-----|
+| 스테이지 | 05-task-management |
+| AI 모델 | ClaudeCode |
+| 실행 모드 | Plan Mode |
+| 체크포인트 | 선택 |
+
+## 동작
+
+1. **전제 조건 확인**
+   - 04-ui-ux 완료 여부
+   - wireframes/, component-spec.md 존재
+
+2. **태스크 분해**
+   - PRD 기반 태스크 추출
+   - 의존성 분석
+   - 스프린트 계획
+
+3. **산출물 생성**
+   - tasks.json - 태스크 목록 (구조화)
+   - sprints.md - 스프린트 계획
+
+## 실행
+
+```bash
+scripts/run-stage.sh 05-task-management "$ARGUMENTS"
+```
+
+## 입력 파일
+
+- `stages/03-planning/outputs/PRD.md`
+- `stages/04-ui-ux/outputs/wireframes/`
+- `stages/04-ui-ux/outputs/component-spec.md`
+
+## 출력 파일
+
+- `stages/05-task-management/outputs/tasks.json`
+- `stages/05-task-management/outputs/sprints.md`
+
+## tasks.json 구조
+
+```json
+{
+  "tasks": [
+    {
+      "id": "T001",
+      "title": "사용자 인증 구현",
+      "sprint": 1,
+      "priority": "high",
+      "dependencies": [],
+      "estimate": "4h",
+      "status": "pending"
+    }
+  ]
+}
+```
+
+## 관련 명령어
+
+- `/run-stage 05` - 전제조건 확인 후 시작
+- `/next` - 다음 스테이지 (06-implementation)
+- `/ui-ux` - 이전 스테이지
+- `/implement` - 구현 바로 시작
+
+## Tips
+
+- 태스크는 4시간 이내로 분해
+- 의존성 명확히 표시
+- 스프린트당 5-7개 태스크 권장

package/template/.claude/commands/test.md

@@ -0,0 +1,93 @@
+# /test
+
+09-testing 스테이지를 바로 시작합니다.
+
+## 사용법
+```
+/test [test-type]
+```
+
+## 스테이지 정보
+
+| 항목 | 값 |
+|------|-----|
+| 스테이지 | 09-testing |
+| AI 모델 | Codex |
+| 실행 모드 | Sandbox + Playwright MCP |
+| 체크포인트 | 선택 |
+
+## 동작
+
+1. **전제 조건 확인**
+   - 08-qa 완료 여부
+   - qa-report.md 존재
+
+2. **테스팅 실행**
+   - 통합 테스트
+   - E2E 테스트 (Playwright)
+   - 회귀 테스트
+
+3. **산출물 생성**
+   - test-results.md - 테스트 결과
+   - coverage-report.html - 커버리지
+
+## 실행
+
+```bash
+scripts/run-stage.sh 09-testing "$ARGUMENTS"
+```
+
+## 입력 파일
+
+- `stages/06-implementation/outputs/src/`
+- `stages/06-implementation/outputs/tests/`
+- `stages/08-qa/outputs/qa-report.md`
+
+## 출력 파일
+
+- `stages/09-testing/outputs/test-results.md`
+- `stages/09-testing/outputs/e2e-results/`
+- `stages/09-testing/outputs/coverage/`
+
+## 테스트 유형
+
+| 유형 | 도구 | 설명 |
+|------|------|------|
+| Unit | Jest/Vitest | 단위 테스트 |
+| Integration | Testing Library | 통합 테스트 |
+| E2E | Playwright | 엔드투엔드 |
+| Visual | Playwright | 스크린샷 비교 |
+
+## Playwright MCP 활용
+
+```bash
+# 브라우저 스냅샷
+mcp__playwright__browser_snapshot
+
+# 스크린샷
+mcp__playwright__browser_take_screenshot
+
+# 폼 테스트
+mcp__playwright__browser_fill_form
+```
+
+## 관련 명령어
+
+- `/run-stage 09` - 전제조건 확인 후 시작
+- `/next` - 다음 스테이지 (10-deployment)
+- `/qa` - 이전 스테이지
+- `/deploy` - 배포 바로 시작
+
+## 커버리지 목표
+
+| 메트릭 | 목표 |
+|--------|------|
+| Line | ≥ 80% |
+| Branch | ≥ 70% |
+| Function | ≥ 80% |
+
+## Tips
+
+- E2E는 핵심 플로우 중심
+- 실패 시 스크린샷 자동 저장
+- CI에서 headless 모드 실행