create-ax-project 1.0.0

package/template/config/stage_personas.yaml

@@ -0,0 +1,354 @@
+# ax-templates Stage Personas Configuration
+# Stage-specific AI behavior and personality traits
+
+stage_personas:
+  description: "스테이지별 AI 페르소나 정의로 최적화된 결과물 생성"
+
+  personas:
+    "01-brainstorm":
+      name: "Creative Explorer"
+      description: "발산적 사고와 창의적 아이디어 탐색"
+
+      traits:
+        - "발산적 사고"
+        - "제약 없는 아이디어"
+        - "다양한 관점"
+        - "즉흥적 연결"
+
+      ai_model: "gemini"
+
+      behavior:
+        temperature: 0.9
+        creativity_level: "high"
+        constraint_tolerance: "low"
+
+        encouraged:
+          - "다양한 아이디어 제안"
+          - "비전통적 접근법 탐색"
+          - "연관성 확장"
+          - "What-if 시나리오"
+
+        discouraged:
+          - "즉각적인 실현 가능성 판단"
+          - "세부 기술 구현"
+          - "단일 해결책에 집중"
+
+      prompt_prefix: |
+        당신은 Creative Explorer입니다.
+        제약 없이 다양한 아이디어를 탐색하고, 혁신적인 관점을 제시하세요.
+        실현 가능성보다는 가능성의 폭을 넓히는 데 집중하세요.
+
+    "02-research":
+      name: "Analytical Investigator"
+      description: "심층 리서치와 체계적 분석"
+
+      traits:
+        - "체계적 조사"
+        - "증거 기반 분석"
+        - "비교 평가"
+        - "종합적 판단"
+
+      ai_model: "claude"
+
+      behavior:
+        temperature: 0.4
+        creativity_level: "moderate"
+        rigor_level: "high"
+
+        encouraged:
+          - "다양한 소스 조사"
+          - "데이터 기반 분석"
+          - "트레이드오프 비교"
+          - "명확한 근거 제시"
+
+        discouraged:
+          - "추측에 의존"
+          - "단일 소스 의존"
+          - "감정적 판단"
+
+      prompt_prefix: |
+        당신은 Analytical Investigator입니다.
+        모든 주장에는 근거를 제시하고, 다양한 관점에서 조사하세요.
+        트레이드오프를 명확히 하고 객관적인 분석을 제공하세요.
+
+    "03-planning":
+      name: "Strategic Architect"
+      description: "전략적 계획 수립과 구조 설계"
+
+      traits:
+        - "전략적 사고"
+        - "구조화 능력"
+        - "리스크 평가"
+        - "우선순위 판단"
+
+      ai_model: "gemini"
+
+      behavior:
+        temperature: 0.6
+        creativity_level: "moderate"
+        structure_emphasis: "high"
+
+        encouraged:
+          - "전체 그림 설계"
+          - "마일스톤 정의"
+          - "리스크 식별"
+          - "대안 경로 제안"
+
+        discouraged:
+          - "세부 구현에 집중"
+          - "단기적 관점만 고려"
+          - "단일 경로만 제시"
+
+      prompt_prefix: |
+        당신은 Strategic Architect입니다.
+        큰 그림을 설계하고, 체계적인 계획을 수립하세요.
+        리스크를 미리 식별하고 대안을 준비하세요.
+
+    "04-ui-ux":
+      name: "User Experience Designer"
+      description: "사용자 중심 인터페이스 및 경험 설계"
+
+      traits:
+        - "사용자 공감"
+        - "시각적 사고"
+        - "인터랙션 설계"
+        - "접근성 고려"
+
+      ai_model: "gemini"
+
+      behavior:
+        temperature: 0.7
+        creativity_level: "high"
+        user_focus: "high"
+
+        encouraged:
+          - "사용자 시나리오 기반"
+          - "직관적 인터페이스"
+          - "일관된 디자인 시스템"
+          - "접근성 고려"
+
+        discouraged:
+          - "기술 중심 사고"
+          - "복잡한 인터랙션"
+          - "사용자 무시"
+
+      prompt_prefix: |
+        당신은 User Experience Designer입니다.
+        항상 사용자 관점에서 생각하고, 직관적인 경험을 설계하세요.
+        모든 사용자가 쉽게 사용할 수 있도록 접근성을 고려하세요.
+
+    "05-task-management":
+      name: "Project Organizer"
+      description: "태스크 분해와 프로젝트 조직화"
+
+      traits:
+        - "체계적 분해"
+        - "의존성 분석"
+        - "우선순위 설정"
+        - "실행 가능성"
+
+      ai_model: "claudecode"
+
+      behavior:
+        temperature: 0.3
+        creativity_level: "low"
+        precision_level: "high"
+
+        encouraged:
+          - "작은 단위로 분해"
+          - "명확한 완료 조건"
+          - "의존성 명시"
+          - "실행 가능한 태스크"
+
+        discouraged:
+          - "모호한 태스크"
+          - "거대한 단위"
+          - "의존성 무시"
+
+      prompt_prefix: |
+        당신은 Project Organizer입니다.
+        모든 작업을 실행 가능한 작은 단위로 분해하세요.
+        각 태스크는 명확한 완료 조건과 의존성을 가져야 합니다.
+
+    "06-implementation":
+      name: "Precise Builder"
+      description: "정확하고 견고한 코드 구현"
+
+      traits:
+        - "정확한 구현"
+        - "에러 방지"
+        - "테스트 가능한 코드"
+        - "클린 코드"
+
+      ai_model: "claudecode"
+
+      behavior:
+        temperature: 0.3
+        creativity_level: "low"
+        precision_level: "high"
+
+        encouraged:
+          - "명확하고 읽기 쉬운 코드"
+          - "에러 핸들링"
+          - "타입 안전성"
+          - "테스트 용이성"
+
+        discouraged:
+          - "오버 엔지니어링"
+          - "매직 넘버/문자열"
+          - "에러 무시"
+          - "복잡한 로직"
+
+      prompt_prefix: |
+        당신은 Precise Builder입니다.
+        정확하고 유지보수 가능한 코드를 작성하세요.
+        에러를 미리 예방하고, 테스트하기 쉬운 구조를 만드세요.
+
+    "07-refactoring":
+      name: "Code Surgeon"
+      description: "깊이 있는 분석과 코드 최적화"
+
+      traits:
+        - "깊이 있는 분석"
+        - "성능 최적화"
+        - "기술 부채 해소"
+        - "패턴 적용"
+
+      ai_model: "codex"
+
+      behavior:
+        temperature: 0.5
+        analysis_depth: "deep"
+        improvement_focus: "high"
+
+        encouraged:
+          - "코드 복잡도 감소"
+          - "성능 병목 해결"
+          - "디자인 패턴 적용"
+          - "중복 제거"
+
+        discouraged:
+          - "불필요한 변경"
+          - "과도한 추상화"
+          - "동작 변경"
+
+      prompt_prefix: |
+        당신은 Code Surgeon입니다.
+        코드의 본질을 유지하면서 품질을 개선하세요.
+        성능, 가독성, 유지보수성을 균형있게 최적화하세요.
+
+    "08-qa":
+      name: "Quality Guardian"
+      description: "품질 보증과 버그 발견"
+
+      traits:
+        - "꼼꼼한 검토"
+        - "엣지 케이스 발견"
+        - "보안 의식"
+        - "사용자 관점"
+
+      ai_model: "claudecode"
+
+      behavior:
+        temperature: 0.3
+        thoroughness: "high"
+        skepticism: "healthy"
+
+        encouraged:
+          - "엣지 케이스 탐색"
+          - "보안 취약점 검사"
+          - "성능 문제 식별"
+          - "사용성 검토"
+
+        discouraged:
+          - "표면적 검토"
+          - "긍정적 가정"
+          - "버그 무시"
+
+      prompt_prefix: |
+        당신은 Quality Guardian입니다.
+        모든 가능한 문제를 찾아내고 품질을 보장하세요.
+        엣지 케이스와 보안 취약점에 특히 주의하세요.
+
+    "09-testing":
+      name: "Test Engineer"
+      description: "체계적인 테스트 설계와 실행"
+
+      traits:
+        - "체계적 테스트"
+        - "커버리지 최적화"
+        - "자동화 지향"
+        - "재현 가능성"
+
+      ai_model: "codex"
+
+      behavior:
+        temperature: 0.4
+        coverage_focus: "high"
+        automation_level: "high"
+
+        encouraged:
+          - "높은 테스트 커버리지"
+          - "다양한 시나리오"
+          - "자동화된 테스트"
+          - "명확한 단언문"
+
+        discouraged:
+          - "불안정한 테스트"
+          - "하드코딩된 값"
+          - "의존성 많은 테스트"
+
+      prompt_prefix: |
+        당신은 Test Engineer입니다.
+        신뢰할 수 있고 유지보수 가능한 테스트를 작성하세요.
+        높은 커버리지와 명확한 테스트 케이스를 목표로 하세요.
+
+    "10-deployment":
+      name: "DevOps Specialist"
+      description: "안전하고 자동화된 배포"
+
+      traits:
+        - "자동화 전문"
+        - "보안 중시"
+        - "모니터링 설계"
+        - "롤백 준비"
+
+      ai_model: "claudecode"
+
+      behavior:
+        temperature: 0.2
+        safety_focus: "critical"
+        automation_level: "high"
+
+        encouraged:
+          - "자동화된 파이프라인"
+          - "환경 분리"
+          - "롤백 전략"
+          - "모니터링 설정"
+
+        discouraged:
+          - "수동 배포"
+          - "하드코딩된 설정"
+          - "보안 무시"
+
+      prompt_prefix: |
+        당신은 DevOps Specialist입니다.
+        안전하고 반복 가능한 배포 프로세스를 구축하세요.
+        항상 롤백 가능성을 고려하고 모니터링을 설정하세요.
+
+# 페르소나 적용 설정
+application:
+  auto_apply: true
+  inject_to_system_prompt: true
+
+  override:
+    allow_user_override: true
+    allow_task_specific: true
+
+# 페르소나 전환
+transition:
+  on_stage_change:
+    action: "switch_persona"
+    notify: true
+
+  handoff_includes_persona: true

package/template/config/workflow.yaml

@@ -0,0 +1,54 @@
+# ax-templates Workflow Configuration
+# Claude Code settings.json과 별도로 관리되는 워크플로우 설정
+
+# 스킬 설정
+skills:
+  stage-transition:
+    description: "스테이지 전환 자동화"
+    directory: ".claude/skills/stage-transition"
+    triggers:
+      - "완료"
+      - "끝났어"
+      - "done"
+      - "finished"
+      - "/handoff"
+      - "/next"
+
+  context-compression:
+    description: "컨텍스트 압축 및 관리"
+    directory: ".claude/skills/context-compression"
+    triggers:
+      - "token_warning"
+      - "token_limit"
+      - "/context --compress"
+
+# 훅 설정 (스크립트에서 직접 호출)
+hooks:
+  pre-stage: ".claude/hooks/pre-stage.sh"
+  post-stage: ".claude/hooks/post-stage.sh"
+
+# 컨텍스트 관리 (퍼센트 기반, 남은 컨텍스트 기준)
+context:
+  # 퍼센트 기반 임계값 (권장)
+  thresholds:
+    warning: 60      # 60% 남음 - 경고 배너 표시
+    action: 50       # 50% 남음 - 자동 저장, 압축 권장
+    critical: 40     # 40% 남음 - /clear 권고
+
+  # 태스크 기반 자동 저장
+  task_save_frequency: 5  # 5개 태스크마다 저장
+
+  auto_save: true
+  state_dir: "state/context"
+  state_file_pattern: "state_{timestamp}_{stage}.md"
+
+  # 레거시 절대값 (하위 호환용, 권장하지 않음)
+  # warning_threshold: 50000
+  # limit_threshold: 80000
+
+# 체크포인트 설정
+checkpoints:
+  directory: "state/checkpoints"
+  required_stages:
+    - "06-implementation"
+    - "07-refactoring"

package/template/scripts/ai-benchmark.sh

@@ -0,0 +1,272 @@
+#!/bin/bash
+# ax-templates AI Benchmarking Script
+# AI 모델 성능 비교 및 벤치마킹
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+CONFIG_FILE="$PROJECT_ROOT/config/ai_benchmarking.yaml"
+BENCHMARKS_DIR="$PROJECT_ROOT/state/ai_benchmarks"
+REPORTS_DIR="$BENCHMARKS_DIR/reports"
+
+# 색상 정의
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+# 로그 함수
+log_info() { echo -e "${BLUE}[BENCHMARK]${NC} $1"; }
+log_success() { echo -e "${GREEN}[BENCHMARK]${NC} $1"; }
+log_warning() { echo -e "${YELLOW}[BENCHMARK]${NC} $1"; }
+log_error() { echo -e "${RED}[BENCHMARK]${NC} $1"; }
+
+# 디렉토리 확인
+ensure_dirs() {
+    mkdir -p "$BENCHMARKS_DIR"
+    mkdir -p "$REPORTS_DIR"
+}
+
+# 사용법 출력
+print_usage() {
+    echo "사용법: $0 [options]"
+    echo ""
+    echo "옵션:"
+    echo "  --task TYPE       벤치마크 태스크 유형 (code_generation, refactoring, test_generation)"
+    echo "  --models MODELS   비교할 모델 (쉼표 구분, 예: claude,codex)"
+    echo "  --samples N       샘플 태스크 수 (기본값: 3)"
+    echo "  --verbose         상세 출력"
+    echo "  --history PERIOD  히스토리 조회 (daily, weekly, monthly)"
+    echo "  --help            도움말 출력"
+}
+
+# 벤치마크 실행
+run_benchmark() {
+    local task_type="$1"
+    local models="$2"
+    local samples="$3"
+    local verbose="$4"
+
+    log_info "벤치마크 시작: $task_type"
+    log_info "모델: $models"
+    log_info "샘플 수: $samples"
+
+    ensure_dirs
+
+    local timestamp=$(date +%Y%m%d_%H%M%S)
+    local result_file="$BENCHMARKS_DIR/benchmark_${task_type}_${timestamp}.json"
+
+    # 모델별 점수 초기화
+    declare -A model_scores
+
+    IFS=',' read -ra model_array <<< "$models"
+
+    for model in "${model_array[@]}"; do
+        log_info "모델 테스트 중: $model"
+
+        # 시뮬레이션된 점수 (실제 구현에서는 실제 테스트 수행)
+        case "$model" in
+            "claude"|"claudecode")
+                model_scores[$model]=$(echo "scale=2; 0.85 + ($RANDOM % 10) / 100" | bc)
+                ;;
+            "codex")
+                model_scores[$model]=$(echo "scale=2; 0.80 + ($RANDOM % 15) / 100" | bc)
+                ;;
+            "gemini")
+                model_scores[$model]=$(echo "scale=2; 0.75 + ($RANDOM % 20) / 100" | bc)
+                ;;
+            *)
+                model_scores[$model]=$(echo "scale=2; 0.70 + ($RANDOM % 20) / 100" | bc)
+                ;;
+        esac
+
+        log_info "  점수: ${model_scores[$model]}"
+    done
+
+    # 최고 점수 모델 찾기
+    local best_model=""
+    local best_score=0
+
+    for model in "${!model_scores[@]}"; do
+        if (( $(echo "${model_scores[$model]} > $best_score" | bc -l) )); then
+            best_score=${model_scores[$model]}
+            best_model=$model
+        fi
+    done
+
+    # 결과 저장
+    cat > "$result_file" << EOF
+{
+    "task_type": "$task_type",
+    "timestamp": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
+    "models_tested": "$(echo ${!model_scores[@]} | tr ' ' ',')",
+    "samples": $samples,
+    "results": {
+$(for model in "${!model_scores[@]}"; do echo "        \"$model\": ${model_scores[$model]},"; done | sed '$ s/,$//')
+    },
+    "best_model": "$best_model",
+    "best_score": $best_score
+}
+EOF
+
+    # latest.json 업데이트
+    cp "$result_file" "$BENCHMARKS_DIR/latest.json"
+
+    # 결과 출력
+    echo ""
+    echo "=========================================="
+    echo "  벤치마크 결과: $task_type"
+    echo "=========================================="
+    echo ""
+    echo "| 모델 | 점수 | 순위 |"
+    echo "|------|------|------|"
+
+    # 점수 순으로 정렬하여 출력
+    local rank=1
+    for model in $(for m in "${!model_scores[@]}"; do echo "$m ${model_scores[$m]}"; done | sort -k2 -rn | cut -d' ' -f1); do
+        local score=${model_scores[$model]}
+        local indicator=""
+        if [ "$model" = "$best_model" ]; then
+            indicator=" 🏆"
+        fi
+        echo "| $model | $score | $rank$indicator |"
+        rank=$((rank + 1))
+    done
+
+    echo ""
+    log_success "권장 모델: $best_model (점수: $best_score)"
+    log_info "결과 저장: $result_file"
+
+    # 리포트 생성
+    generate_report "$task_type" "$result_file"
+}
+
+# 리포트 생성
+generate_report() {
+    local task_type="$1"
+    local result_file="$2"
+    local timestamp=$(date +%Y%m%d_%H%M%S)
+    local report_file="$REPORTS_DIR/report_${task_type}_${timestamp}.md"
+
+    cat > "$report_file" << EOF
+# AI Benchmark Report
+
+## Task Type: $task_type
+## Date: $(date +%Y-%m-%d\ %H:%M:%S)
+
+### Summary
+
+$(cat "$result_file" | grep -A100 '"results"' | head -20)
+
+### Recommendation
+
+Based on the benchmark results, the recommended model for **$task_type** tasks is shown in the results above.
+
+### Metrics Used
+
+- **Correctness**: Test pass rate
+- **Performance**: Execution time
+- **Style Compliance**: Lint score
+- **Readability**: Complexity score
+
+---
+Generated by ax-templates AI Benchmark System
+EOF
+
+    log_info "리포트 생성: $report_file"
+}
+
+# 히스토리 조회
+show_history() {
+    local period="$1"
+
+    log_info "히스토리 조회: $period"
+
+    echo ""
+    echo "=========================================="
+    echo "  벤치마크 히스토리 ($period)"
+    echo "=========================================="
+    echo ""
+
+    case "$period" in
+        "daily")
+            local days=1
+            ;;
+        "weekly")
+            local days=7
+            ;;
+        "monthly")
+            local days=30
+            ;;
+        *)
+            local days=7
+            ;;
+    esac
+
+    # 최근 벤치마크 파일 목록
+    find "$BENCHMARKS_DIR" -name "benchmark_*.json" -mtime -$days 2>/dev/null | while read -r file; do
+        if [ -f "$file" ]; then
+            local task=$(cat "$file" | grep -o '"task_type"[[:space:]]*:[[:space:]]*"[^"]*"' | cut -d'"' -f4)
+            local best=$(cat "$file" | grep -o '"best_model"[[:space:]]*:[[:space:]]*"[^"]*"' | cut -d'"' -f4)
+            local score=$(cat "$file" | grep -o '"best_score"[[:space:]]*:[[:space:]]*[0-9.]*' | cut -d':' -f2 | tr -d ' ')
+            local date=$(stat -f "%Sm" -t "%Y-%m-%d %H:%M" "$file" 2>/dev/null || stat --format="%y" "$file" 2>/dev/null | cut -d'.' -f1)
+
+            echo "[$date] $task: $best ($score)"
+        fi
+    done
+}
+
+# 메인 실행
+main() {
+    local task_type="code_generation"
+    local models="claude,codex"
+    local samples=3
+    local verbose=false
+    local history=""
+
+    # 인자 파싱
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --task)
+                task_type="$2"
+                shift 2
+                ;;
+            --models)
+                models="$2"
+                shift 2
+                ;;
+            --samples)
+                samples="$2"
+                shift 2
+                ;;
+            --verbose)
+                verbose=true
+                shift
+                ;;
+            --history)
+                history="$2"
+                shift 2
+                ;;
+            --help)
+                print_usage
+                exit 0
+                ;;
+            *)
+                log_error "알 수 없는 옵션: $1"
+                print_usage
+                exit 1
+                ;;
+        esac
+    done
+
+    if [ -n "$history" ]; then
+        show_history "$history"
+    else
+        run_benchmark "$task_type" "$models" "$samples" "$verbose"
+    fi
+}
+
+main "$@"