create-ax-project 1.0.0

package/template/.claude/commands/ui-ux.md

@@ -0,0 +1,61 @@
+# /ui-ux
+
+04-ui-ux 스테이지를 바로 시작합니다.
+
+## 사용법
+```
+/ui-ux
+```
+
+## 스테이지 정보
+
+| 항목 | 값 |
+|------|-----|
+| 스테이지 | 04-ui-ux |
+| AI 모델 | Gemini |
+| 실행 모드 | Plan Mode |
+| 체크포인트 | 선택 |
+
+## 동작
+
+1. **전제 조건 확인**
+   - 03-planning 완료 여부
+   - PRD.md 존재
+
+2. **UI/UX 설계**
+   - 와이어프레임 설계
+   - 컴포넌트 명세
+   - 디자인 시스템
+
+3. **산출물 생성**
+   - wireframes/ - 와이어프레임 파일
+   - component-spec.md - 컴포넌트 명세
+   - design-system.md - 디자인 시스템
+
+## 실행
+
+```bash
+scripts/run-stage.sh 04-ui-ux "$ARGUMENTS"
+```
+
+## 입력 파일
+
+- `stages/03-planning/outputs/PRD.md`
+- `stages/03-planning/outputs/architecture.md`
+
+## 출력 파일
+
+- `stages/04-ui-ux/outputs/wireframes/`
+- `stages/04-ui-ux/outputs/component-spec.md`
+- `stages/04-ui-ux/outputs/design-system.md`
+
+## 관련 명령어
+
+- `/run-stage 04` - 전제조건 확인 후 시작
+- `/next` - 다음 스테이지 (05-task-management)
+- `/planning` - 이전 스테이지
+
+## 도구 활용
+
+- Figma MCP - 디자인 컨텍스트 (설정 시)
+- 21st Magic - UI 컴포넌트 영감

package/template/.claude/commands/validate.md

@@ -0,0 +1,174 @@
+# /validate - Output Validation Command
+
+현재 스테이지의 산출물을 검증합니다.
+
+## 사용법
+
+```bash
+/validate [options]
+```
+
+## 옵션
+
+| 옵션 | 설명 | 기본값 |
+|------|------|--------|
+| `--stage` | 검증할 스테이지 ID | 현재 스테이지 |
+| `--verbose` | 상세 출력 | false |
+| `--fix` | 자동 수정 제안 | false |
+| `--skip-commands` | 명령어 검증 건너뛰기 | false |
+| `--force` | 실패해도 통과 처리 | false |
+
+## 검증 항목
+
+### 1. 필수 파일 존재
+```bash
+/validate
+# → ideas.md ✅, requirements_analysis.md ❌ (누락)
+```
+
+### 2. 파일 내용 검증
+```bash
+/validate --verbose
+# → ideas.md: 8개 아이디어 (최소 5개) ✅
+# → 필수 섹션: 기능 요구사항 ✅, 비기능 요구사항 ❌
+```
+
+### 3. 명령어 검증
+```bash
+/validate
+# → npm run lint ✅
+# → npm run typecheck ✅
+# → npm run test ❌ (3개 실패)
+```
+
+### 4. 품질 점수
+```bash
+/validate
+# → 종합 점수: 0.85/1.0
+```
+
+## 출력 형식
+
+### 간단 출력
+```
+✅ 검증 통과: 06-implementation (점수: 0.95)
+```
+
+### 실패 시
+```
+❌ 검증 실패: 06-implementation
+
+실패 항목:
+1. 테스트 실패 (3개)
+2. 커버리지 미달 (75% < 80%)
+
+수정 필요:
+- [ ] tests/auth.test.ts:45 수정
+- [ ] 테스트 커버리지 5% 향상
+```
+
+### 상세 출력 (--verbose)
+```markdown
+# 산출물 검증 리포트
+
+## 스테이지: 06-implementation
+## 상태: ⚠️ 부분 통과
+## 점수: 0.85
+
+### 파일 검증
+| 파일 | 상태 | 상세 |
+|------|------|------|
+| source_code/ | ✅ | 디렉토리 존재 |
+| implementation_log.md | ✅ | 필수 형식 충족 |
+
+### 명령어 검증
+| 명령 | 결과 | 시간 |
+|------|------|------|
+| lint | ✅ | 2.3s |
+| typecheck | ✅ | 4.1s |
+| test | ❌ | 15.2s |
+
+### 품질 메트릭
+| 메트릭 | 현재 | 목표 | 상태 |
+|--------|------|------|------|
+| Lint | 0.95 | 0.90 | ✅ |
+| Coverage | 0.75 | 0.80 | ❌ |
+```
+
+## 자동 수정 제안
+
+```bash
+/validate --fix
+```
+
+```markdown
+## 자동 수정 제안
+
+### 1. 누락된 섹션 추가
+**파일**: requirements_analysis.md
+**제안**: "비기능 요구사항" 섹션 추가
+
+### 2. 테스트 수정
+**파일**: tests/auth.test.ts:45
+**원인**: 반환 타입 불일치
+**수정안**:
+```typescript
+expect(result).toHaveProperty('token');
+// 변경 →
+expect(result.data).toHaveProperty('token');
+```
+
+자동 수정을 적용하시겠습니까? (y/n)
+```
+
+## 강제 통과
+
+```bash
+/validate --force
+```
+
+```
+⚠️ 검증 실패 항목이 있습니다.
+강제로 통과 처리하시겠습니까?
+
+이유를 입력하세요:
+> 테스트 환경 문제로 일시적 실패, 로컬에서 통과 확인됨
+
+✅ 강제 통과 처리됨 (이유 기록됨)
+```
+
+## 예시
+
+```bash
+# 현재 스테이지 검증
+/validate
+
+# 특정 스테이지 상세 검증
+/validate --stage 06 --verbose
+
+# 자동 수정 제안 포함
+/validate --fix
+
+# 빠른 검증 (명령어 건너뛰기)
+/validate --skip-commands
+```
+
+## 검증 결과 저장
+
+- 결과: `state/validations/{stage}_{timestamp}.json`
+- 리포트: `state/validations/{stage}_{timestamp}.md`
+
+## 설정
+
+`config/output_validation.yaml` 참조
+
+## 스테이지 전환 시 자동 실행
+
+`/next` 명령어 실행 시 자동으로 검증이 수행됩니다.
+검증 실패 시 스테이지 전환이 차단됩니다.
+
+## 관련 커맨드
+
+- `/next` - 다음 스테이지 전환
+- `/status` - 파이프라인 상태
+- `/stages` - 스테이지 목록

package/template/.claude/hooks/ai-selector.sh

@@ -0,0 +1,223 @@
+#!/bin/bash
+# ax-templates AI Selector Hook
+# 동적 AI 모델 선택
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+CONFIG_FILE="$PROJECT_ROOT/config/models.yaml"
+BENCHMARKS_DIR="$PROJECT_ROOT/state/ai_benchmarks"
+PROGRESS_FILE="$PROJECT_ROOT/state/progress.json"
+
+# 색상 정의
+BLUE='\033[0;34m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m'
+
+# 로그 함수
+log_info() { echo -e "${BLUE}[AI-SELECT]${NC} $1"; }
+log_success() { echo -e "${GREEN}[AI-SELECT]${NC} $1"; }
+log_suggest() { echo -e "${YELLOW}[AI-SELECT]${NC} $1"; }
+
+# 현재 스테이지 확인
+get_current_stage() {
+    if [ -f "$PROGRESS_FILE" ]; then
+        cat "$PROGRESS_FILE" 2>/dev/null | grep -o '"current_stage"[[:space:]]*:[[:space:]]*"[^"]*"' | cut -d'"' -f4
+    else
+        echo "unknown"
+    fi
+}
+
+# 스테이지 기반 모델 선택
+get_stage_model() {
+    local stage="$1"
+
+    case "$stage" in
+        "01-brainstorm")
+            echo "gemini"
+            ;;
+        "02-research")
+            echo "claude"
+            ;;
+        "03-planning"|"04-ui-ux")
+            echo "gemini"
+            ;;
+        "05-task-management"|"06-implementation"|"08-qa"|"10-deployment")
+            echo "claudecode"
+            ;;
+        "07-refactoring"|"09-testing")
+            echo "codex"
+            ;;
+        *)
+            echo "claudecode"
+            ;;
+    esac
+}
+
+# 태스크 유형 기반 모델 선택
+get_task_model() {
+    local task_type="$1"
+
+    case "$task_type" in
+        "brainstorming"|"creative"|"ideation")
+            echo "gemini"
+            ;;
+        "research"|"analysis"|"documentation")
+            echo "claude"
+            ;;
+        "implementation"|"debugging"|"review")
+            echo "claudecode"
+            ;;
+        "refactoring"|"testing"|"optimization")
+            echo "codex"
+            ;;
+        *)
+            echo "claudecode"
+            ;;
+    esac
+}
+
+# 이전 성능 기반 모델 선택
+get_performance_model() {
+    local task_type="$1"
+    local benchmark_file="$BENCHMARKS_DIR/latest.json"
+
+    if [ -f "$benchmark_file" ]; then
+        # 최근 벤치마크 결과에서 최고 성능 모델 추출
+        local best_model=$(cat "$benchmark_file" 2>/dev/null | grep -o '"best_model"[[:space:]]*:[[:space:]]*"[^"]*"' | cut -d'"' -f4)
+
+        if [ -n "$best_model" ]; then
+            echo "$best_model"
+            return
+        fi
+    fi
+
+    # 벤치마크 없으면 기본값
+    echo "claudecode"
+}
+
+# 복잡도 기반 모델 선택
+get_complexity_model() {
+    local complexity="$1"
+
+    case "$complexity" in
+        "simple"|"low")
+            echo "claudecode"  # 빠른 응답
+            ;;
+        "moderate"|"medium")
+            echo "claudecode"
+            ;;
+        "complex"|"high")
+            echo "claudecode"  # 복잡한 로직 처리
+            ;;
+        *)
+            echo "claudecode"
+            ;;
+    esac
+}
+
+# 최적 모델 선택 (종합)
+select_best_model() {
+    local stage="$1"
+    local task_type="$2"
+    local complexity="$3"
+
+    # 가중치
+    local stage_weight=0.4
+    local task_weight=0.3
+    local perf_weight=0.2
+    local complexity_weight=0.1
+
+    # 각 기준별 모델
+    local stage_model=$(get_stage_model "$stage")
+    local task_model=$(get_task_model "$task_type")
+    local perf_model=$(get_performance_model "$task_type")
+    local comp_model=$(get_complexity_model "$complexity")
+
+    log_info "모델 선택 분석:"
+    log_info "  스테이지 기반: $stage_model (가중치: $stage_weight)"
+    log_info "  태스크 기반: $task_model (가중치: $task_weight)"
+    log_info "  성능 기반: $perf_model (가중치: $perf_weight)"
+    log_info "  복잡도 기반: $comp_model (가중치: $complexity_weight)"
+
+    # 스테이지 기반이 가장 높은 가중치이므로 우선 선택
+    # 실제 구현에서는 점수 계산 필요
+    local selected_model="$stage_model"
+
+    log_success "선택된 모델: $selected_model"
+    echo "$selected_model"
+}
+
+# 모델 정보 출력
+print_model_info() {
+    local model="$1"
+
+    case "$model" in
+        "claudecode")
+            echo "Claude Code - 정확한 코드 생성, 복잡한 로직 분석"
+            ;;
+        "claude")
+            echo "Claude - 심층 리서치, 문서 분석 및 요약"
+            ;;
+        "gemini")
+            echo "Gemini - 창의적 아이디어, 다양한 관점 탐색"
+            ;;
+        "codex")
+            echo "Codex - 코드 분석, 리팩토링, 테스트 생성"
+            ;;
+    esac
+}
+
+# 메인 실행
+main() {
+    local action="$1"
+    shift
+
+    case "$action" in
+        "stage")
+            local stage="${1:-$(get_current_stage)}"
+            local model=$(get_stage_model "$stage")
+            echo "$model"
+            ;;
+        "task")
+            local task_type="$1"
+            local model=$(get_task_model "$task_type")
+            echo "$model"
+            ;;
+        "select")
+            local stage="${1:-$(get_current_stage)}"
+            local task_type="${2:-implementation}"
+            local complexity="${3:-moderate}"
+            select_best_model "$stage" "$task_type" "$complexity"
+            ;;
+        "info")
+            local model="$1"
+            print_model_info "$model"
+            ;;
+        "current")
+            local stage=$(get_current_stage)
+            local model=$(get_stage_model "$stage")
+            log_info "현재 스테이지: $stage"
+            log_info "권장 모델: $model"
+            print_model_info "$model"
+            ;;
+        *)
+            echo "사용법: $0 {stage|task|select|info|current} [args]"
+            echo ""
+            echo "명령어:"
+            echo "  stage [stage_id]     - 스테이지 기반 모델 선택"
+            echo "  task [task_type]     - 태스크 유형 기반 모델 선택"
+            echo "  select [stage] [task] [complexity] - 종합 모델 선택"
+            echo "  info [model]         - 모델 정보 출력"
+            echo "  current              - 현재 스테이지 권장 모델"
+            exit 1
+            ;;
+    esac
+}
+
+# 직접 실행 시에만 main 호출
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+    main "$@"
+fi

package/template/.claude/hooks/auto-checkpoint.sh

@@ -0,0 +1,187 @@
+#!/bin/bash
+# ax-templates Auto-Checkpoint Hook
+# 자동 체크포인트 트리거 감지 및 생성
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+CONFIG_FILE="$PROJECT_ROOT/config/auto_checkpoint.yaml"
+CHECKPOINTS_DIR="$PROJECT_ROOT/state/checkpoints"
+PROGRESS_FILE="$PROJECT_ROOT/state/progress.json"
+
+# 색상 정의
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+# 로그 함수
+log_info() { echo -e "${BLUE}[INFO]${NC} $1"; }
+log_success() { echo -e "${GREEN}[SUCCESS]${NC} $1"; }
+log_warning() { echo -e "${YELLOW}[WARNING]${NC} $1"; }
+log_error() { echo -e "${RED}[ERROR]${NC} $1"; }
+
+# 체크포인트 디렉토리 확인
+ensure_checkpoint_dir() {
+    mkdir -p "$CHECKPOINTS_DIR"
+}
+
+# 현재 스테이지 확인
+get_current_stage() {
+    if [ -f "$PROGRESS_FILE" ]; then
+        cat "$PROGRESS_FILE" 2>/dev/null | grep -o '"current_stage"[[:space:]]*:[[:space:]]*"[^"]*"' | cut -d'"' -f4
+    else
+        echo "unknown"
+    fi
+}
+
+# 변경된 라인 수 계산
+get_changed_lines() {
+    if git rev-parse --is-inside-work-tree > /dev/null 2>&1; then
+        git diff --stat 2>/dev/null | tail -1 | grep -oE '[0-9]+ insertion|[0-9]+ deletion' | grep -oE '[0-9]+' | paste -sd+ | bc 2>/dev/null || echo "0"
+    else
+        echo "0"
+    fi
+}
+
+# 체크포인트 생성
+create_checkpoint() {
+    local trigger_reason="$1"
+    local checkpoint_name="$2"
+
+    ensure_checkpoint_dir
+
+    local timestamp=$(date +%Y%m%d_%H%M%S)
+    local stage=$(get_current_stage)
+
+    if [ -z "$checkpoint_name" ]; then
+        checkpoint_name="${trigger_reason}_${stage}_${timestamp}"
+    fi
+
+    local checkpoint_path="$CHECKPOINTS_DIR/$checkpoint_name"
+
+    log_info "체크포인트 생성 중: $checkpoint_name"
+
+    # 체크포인트 디렉토리 생성
+    mkdir -p "$checkpoint_path"
+
+    # 소스 코드 복사 (node_modules 제외)
+    if [ -d "$PROJECT_ROOT/src" ]; then
+        rsync -a --exclude='node_modules' --exclude='.git' --exclude='state/checkpoints' \
+            "$PROJECT_ROOT/src" "$checkpoint_path/" 2>/dev/null || true
+    fi
+
+    # 설정 파일 복사
+    if [ -d "$PROJECT_ROOT/config" ]; then
+        cp -r "$PROJECT_ROOT/config" "$checkpoint_path/" 2>/dev/null || true
+    fi
+
+    # 상태 파일 복사
+    if [ -d "$PROJECT_ROOT/state" ]; then
+        mkdir -p "$checkpoint_path/state"
+        cp "$PROJECT_ROOT/state/progress.json" "$checkpoint_path/state/" 2>/dev/null || true
+    fi
+
+    # 스테이지 outputs 복사
+    if [ -d "$PROJECT_ROOT/stages" ]; then
+        mkdir -p "$checkpoint_path/stages"
+        find "$PROJECT_ROOT/stages" -name "outputs" -type d -exec cp -r {} "$checkpoint_path/stages/" \; 2>/dev/null || true
+    fi
+
+    # HANDOFF 복사
+    find "$PROJECT_ROOT/stages" -name "HANDOFF.md" -exec cp {} "$checkpoint_path/" \; 2>/dev/null || true
+
+    # 메타데이터 생성
+    cat > "$checkpoint_path/metadata.json" << EOF
+{
+    "name": "$checkpoint_name",
+    "timestamp": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
+    "trigger": "$trigger_reason",
+    "stage": "$stage",
+    "git_commit": "$(git rev-parse HEAD 2>/dev/null || echo 'unknown')",
+    "files_changed": $(git diff --stat 2>/dev/null | grep -c '|' || echo 0)
+}
+EOF
+
+    log_success "체크포인트 생성 완료: $checkpoint_name"
+
+    # Git 태그 생성 (옵션)
+    if git rev-parse --is-inside-work-tree > /dev/null 2>&1; then
+        git tag -a "checkpoint/$checkpoint_name" -m "Auto-checkpoint: $trigger_reason" 2>/dev/null || true
+    fi
+
+    # 오래된 체크포인트 정리
+    cleanup_old_checkpoints
+
+    echo "$checkpoint_name"
+}
+
+# 오래된 체크포인트 정리
+cleanup_old_checkpoints() {
+    local max_checkpoints=20
+    local checkpoint_count=$(ls -1 "$CHECKPOINTS_DIR" 2>/dev/null | wc -l)
+
+    if [ "$checkpoint_count" -gt "$max_checkpoints" ]; then
+        local to_delete=$((checkpoint_count - max_checkpoints))
+        log_info "오래된 체크포인트 정리: ${to_delete}개"
+
+        # 가장 오래된 것부터 삭제 (milestone 제외)
+        ls -1t "$CHECKPOINTS_DIR" | tail -n "$to_delete" | while read -r checkpoint; do
+            # milestone 체크포인트는 보존
+            if [[ ! "$checkpoint" =~ (stage_complete|pre_destructive|manual) ]]; then
+                rm -rf "$CHECKPOINTS_DIR/$checkpoint"
+                log_info "삭제됨: $checkpoint"
+            fi
+        done
+    fi
+}
+
+# 파괴적 작업 감지
+check_destructive_action() {
+    local command="$1"
+
+    # 파괴적 패턴
+    local patterns=("rm -rf" "git reset --hard" "drop table" "DELETE FROM" "truncate")
+
+    for pattern in "${patterns[@]}"; do
+        if [[ "$command" == *"$pattern"* ]]; then
+            log_warning "파괴적 작업 감지: $pattern"
+            create_checkpoint "pre_destructive" ""
+            return 0
+        fi
+    done
+
+    return 1
+}
+
+# 메인 실행
+main() {
+    local action="$1"
+    shift
+
+    case "$action" in
+        "create")
+            create_checkpoint "${1:-manual}" "${2:-}"
+            ;;
+        "check-destructive")
+            check_destructive_action "$*"
+            ;;
+        "cleanup")
+            cleanup_old_checkpoints
+            ;;
+        "list")
+            ls -1t "$CHECKPOINTS_DIR" 2>/dev/null || echo "체크포인트 없음"
+            ;;
+        *)
+            echo "사용법: $0 {create|check-destructive|cleanup|list} [args]"
+            exit 1
+            ;;
+    esac
+}
+
+# 직접 실행 시에만 main 호출
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+    main "$@"
+fi