create-ax-project 1.0.0

package/template/config/output_validation.yaml

@@ -0,0 +1,352 @@
+# ax-templates Output Validation Configuration
+# Stage output verification and quality assurance
+
+validation:
+  enabled: true
+  description: "스테이지별 산출물 검증 및 품질 보증"
+
+  # 스테이지별 검증 규칙
+  per_stage:
+    "01-brainstorm":
+      description: "아이디어 및 요구사항 산출물 검증"
+
+      required_outputs:
+        ideas.md:
+          exists: true
+          min_size_bytes: 500
+          content_checks:
+            min_ideas: 5
+            has_sections: ["아이디어 목록", "평가 기준"]
+
+        requirements_analysis.md:
+          exists: true
+          min_size_bytes: 1000
+          content_checks:
+            sections:
+              - "기능 요구사항"
+              - "비기능 요구사항"
+            has_priorities: true
+
+      validation_commands: []
+
+      quality_metrics:
+        idea_diversity: 0.7  # 아이디어 다양성 점수
+        requirement_completeness: 0.8
+
+    "02-research":
+      description: "리서치 산출물 검증"
+
+      required_outputs:
+        tech_research.md:
+          exists: true
+          min_size_bytes: 2000
+          content_checks:
+            has_sources: true
+            min_sources: 3
+
+        feasibility_report.md:
+          exists: true
+          content_checks:
+            sections:
+              - "기술적 타당성"
+              - "리스크 분석"
+              - "결론"
+
+      validation_commands: []
+
+      quality_metrics:
+        source_quality: 0.8
+        analysis_depth: 0.7
+
+    "03-planning":
+      description: "계획 산출물 검증"
+
+      required_outputs:
+        architecture.md:
+          exists: true
+          min_size_bytes: 2000
+          content_checks:
+            has_diagrams: true
+            sections:
+              - "시스템 구조"
+              - "컴포넌트 설계"
+              - "데이터 흐름"
+
+        tech_stack.md:
+          exists: true
+          content_checks:
+            has_justification: true
+
+        project_plan.md:
+          exists: true
+          content_checks:
+            has_timeline: true
+            has_milestones: true
+
+      validation_commands: []
+
+    "04-ui-ux":
+      description: "UI/UX 설계 산출물 검증"
+
+      required_outputs:
+        wireframes.md:
+          exists: true
+          content_checks:
+            min_screens: 3
+
+        user_flows.md:
+          exists: true
+          content_checks:
+            has_flow_diagram: true
+
+        design_system.md:
+          exists: true
+          content_checks:
+            sections:
+              - "색상"
+              - "타이포그래피"
+              - "컴포넌트"
+
+      validation_commands: []
+
+    "05-task-management":
+      description: "태스크 관리 산출물 검증"
+
+      required_outputs:
+        tasks.md:
+          exists: true
+          content_checks:
+            min_tasks: 10
+            has_estimates: true
+            has_priorities: true
+
+        sprint_plan.md:
+          exists: true
+          content_checks:
+            has_sprint_goals: true
+
+      validation_commands: []
+
+    "06-implementation":
+      description: "구현 산출물 검증"
+
+      required_outputs:
+        "source_code/":
+          exists: true
+          is_directory: true
+
+        implementation_log.md:
+          exists: true
+          format: "changelog"
+
+      validation_commands:
+        - name: "lint"
+          command: "npm run lint"
+          required: true
+          allow_warnings: true
+
+        - name: "typecheck"
+          command: "npm run typecheck"
+          required: true
+
+        - name: "build"
+          command: "npm run build"
+          required: true
+
+      quality_metrics:
+        lint_score: 0.9
+        type_coverage: 0.95
+
+    "07-refactoring":
+      description: "리팩토링 산출물 검증"
+
+      required_outputs:
+        "refactored_code/":
+          exists: true
+          is_directory: true
+
+        refactoring_report.md:
+          exists: true
+          content_checks:
+            sections:
+              - "변경 사항"
+              - "개선 내용"
+              - "성능 비교"
+
+      validation_commands:
+        - name: "lint"
+          command: "npm run lint"
+          required: true
+
+        - name: "test"
+          command: "npm run test"
+          required: true
+
+      quality_metrics:
+        complexity_improvement: true
+        no_regression: true
+
+    "08-qa":
+      description: "QA 산출물 검증"
+
+      required_outputs:
+        qa_report.md:
+          exists: true
+          content_checks:
+            sections:
+              - "발견된 이슈"
+              - "해결된 이슈"
+              - "품질 평가"
+
+        bug_fixes.md:
+          exists: true
+          content_checks:
+            has_bug_list: true
+
+      validation_commands:
+        - name: "lint"
+          command: "npm run lint"
+          required: true
+
+        - name: "test"
+          command: "npm run test"
+          required: true
+
+      quality_metrics:
+        bug_resolution_rate: 0.9
+
+    "09-testing":
+      description: "테스트 산출물 검증"
+
+      required_outputs:
+        "tests/":
+          exists: true
+          is_directory: true
+
+        test_report.md:
+          exists: true
+          content_checks:
+            pass_rate_min: 100
+
+        coverage_report.md:
+          exists: true
+          content_checks:
+            coverage_min: 80
+
+      validation_commands:
+        - name: "test"
+          command: "npm run test"
+          required: true
+
+        - name: "coverage"
+          command: "npm run test:coverage"
+          required: true
+          threshold:
+            lines: 80
+            branches: 75
+            functions: 80
+
+      quality_metrics:
+        test_coverage: 0.8
+        all_tests_pass: true
+
+    "10-deployment":
+      description: "배포 산출물 검증"
+
+      required_outputs:
+        ".github/workflows/":
+          exists: true
+          is_directory: true
+
+        "deployment_config/":
+          exists: true
+          is_directory: true
+
+        deployment_log.md:
+          exists: true
+
+      validation_commands:
+        - name: "workflow_validate"
+          command: "gh workflow list"
+          required: false
+
+      quality_metrics:
+        ci_configured: true
+        deployment_documented: true
+
+# 검증 프로세스
+validation_process:
+  steps:
+    - name: "check_required_files"
+      description: "필수 파일 존재 확인"
+      required: true
+
+    - name: "validate_file_content"
+      description: "파일 내용 검증"
+      required: true
+
+    - name: "run_validation_commands"
+      description: "검증 명령어 실행"
+      required: false
+
+    - name: "calculate_quality_score"
+      description: "품질 점수 계산"
+      required: false
+
+    - name: "generate_report"
+      description: "검증 리포트 생성"
+      required: true
+
+  on_failure:
+    action: "block_transition"
+    allow_override: true
+    require_justification: true
+
+# 리포트 설정
+reporting:
+  format: "markdown"
+  output_path: "state/validations/"
+
+  include:
+    - validation_summary
+    - file_checks
+    - command_results
+    - quality_scores
+    - recommendations
+
+  severity_levels:
+    error:
+      description: "스테이지 전환 차단"
+      icon: "❌"
+    warning:
+      description: "경고만 표시"
+      icon: "⚠️"
+    info:
+      description: "정보 제공"
+      icon: "ℹ️"
+    pass:
+      description: "검증 통과"
+      icon: "✅"
+
+# 자동 수정 제안
+auto_fix:
+  enabled: true
+  suggest_fixes: true
+  auto_apply: false
+
+  fixable_issues:
+    - missing_sections
+    - format_errors
+    - lint_errors
+
+# 통합 설정
+integration:
+  handoff:
+    include_validation_status: true
+    block_if_failed: true
+
+  checkpoint:
+    save_validation_results: true
+
+  memory:
+    save_quality_trends: true

package/template/config/pipeline.yaml

@@ -0,0 +1,357 @@
+# ax-templates Pipeline Configuration
+# Multi-AI Development Workflow Pipeline Definition
+
+pipeline:
+  name: "Multi-AI Development Workflow"
+  version: "1.0.0"
+  description: "10-stage software development workflow with multi-AI orchestration"
+
+stages:
+  - id: "01-brainstorm"
+    name: "Brainstorming"
+    description: "발산적 아이디어 생성 및 요구사항 탐색"
+    models: ["gemini", "claudecode"]
+    mode: "yolo"
+    container: true
+    inputs:
+      - "project_brief.md"
+      - "user_requirements.md"
+    outputs:
+      - "ideas.md"
+      - "requirements_analysis.md"
+      - "HANDOFF.md"
+    timeout: 3600  # 1 hour
+
+  - id: "02-research"
+    name: "Research"
+    description: "기술 리서치 및 시장 분석"
+    models: ["claude"]
+    mode: "plan"
+    mcp_servers: ["firecrawl", "exa", "context7"]
+    inputs:
+      - "requirements_analysis.md"
+    outputs:
+      - "tech_research.md"
+      - "market_analysis.md"
+      - "feasibility_report.md"
+      - "HANDOFF.md"
+    timeout: 7200  # 2 hours
+
+  - id: "03-planning"
+    name: "Planning"
+    description: "시스템 아키텍처 및 기술 스택 결정"
+    models: ["gemini"]
+    mode: "plan"
+    inputs:
+      - "tech_research.md"
+      - "feasibility_report.md"
+    outputs:
+      - "architecture.md"
+      - "tech_stack.md"
+      - "project_plan.md"
+      - "HANDOFF.md"
+    timeout: 3600
+
+  - id: "04-ui-ux"
+    name: "UI/UX Planning"
+    description: "사용자 인터페이스 및 경험 설계"
+    models: ["gemini"]
+    mode: "plan"
+    inputs:
+      - "requirements_analysis.md"
+      - "architecture.md"
+    outputs:
+      - "wireframes.md"
+      - "user_flows.md"
+      - "design_system.md"
+      - "HANDOFF.md"
+    timeout: 3600
+
+  - id: "05-task-management"
+    name: "Task Management"
+    description: "태스크 분해 및 스프린트 계획"
+    models: ["claudecode"]
+    mode: "plan"
+    inputs:
+      - "project_plan.md"
+      - "architecture.md"
+    outputs:
+      - "tasks.md"
+      - "sprint_plan.md"
+      - "milestones.md"
+      - "HANDOFF.md"
+    timeout: 1800  # 30 minutes
+
+  - id: "06-implementation"
+    name: "Implementation"
+    description: "핵심 기능 구현"
+    models: ["claudecode"]
+    mode: "plan_sandbox"
+    sandbox: true
+    inputs:
+      - "tasks.md"
+      - "architecture.md"
+      - "design_system.md"
+    outputs:
+      - "source_code/"
+      - "implementation_log.md"
+      - "HANDOFF.md"
+    timeout: 14400  # 4 hours
+    checkpoint_required: true
+
+  - id: "07-refactoring"
+    name: "Refactoring"
+    description: "코드 품질 개선 및 최적화"
+    models: ["codex"]
+    mode: "deep_dive"
+    inputs:
+      - "source_code/"
+      - "implementation_log.md"
+    outputs:
+      - "refactored_code/"
+      - "refactoring_report.md"
+      - "HANDOFF.md"
+    timeout: 7200
+    checkpoint_required: true
+
+  - id: "08-qa"
+    name: "QA"
+    description: "품질 보증 및 코드 리뷰"
+    models: ["claudecode"]
+    mode: "plan_sandbox"
+    sandbox: true
+    inputs:
+      - "refactored_code/"
+      - "refactoring_report.md"
+    outputs:
+      - "qa_report.md"
+      - "bug_fixes.md"
+      - "HANDOFF.md"
+    timeout: 3600
+
+  - id: "09-testing"
+    name: "Testing & E2E"
+    description: "테스트 코드 작성 및 E2E 테스트"
+    models: ["codex"]
+    mode: "sandbox_playwright"
+    sandbox: true
+    mcp_servers: ["playwright"]
+    inputs:
+      - "source_code/"
+      - "qa_report.md"
+    outputs:
+      - "tests/"
+      - "test_report.md"
+      - "coverage_report.md"
+      - "HANDOFF.md"
+    timeout: 7200
+
+  - id: "10-deployment"
+    name: "CI/CD & Deployment"
+    description: "배포 파이프라인 설정 및 배포"
+    models: ["claudecode"]
+    mode: "headless"
+    inputs:
+      - "source_code/"
+      - "tests/"
+      - "test_report.md"
+    outputs:
+      - ".github/workflows/"
+      - "deployment_config/"
+      - "deployment_log.md"
+    timeout: 3600
+
+# State Management Configuration
+state_management:
+  progress_file: "state/progress.json"
+  checkpoints_dir: "state/checkpoints"
+  context_dir: "state/context"
+  handoffs_dir: "state/handoffs"
+
+  # Context management thresholds (percentage-based, remaining context)
+  # See config/context.yaml for detailed settings
+  context_thresholds:
+    warning: 60      # 60% remaining - display warning
+    action: 50       # 50% remaining - auto-save state
+    critical: 40     # 40% remaining - recommend /clear
+
+  # Task-based auto-save
+  task_save_frequency: 5  # Save every 5 completed tasks
+
+  # Auto-actions when thresholds are reached
+  auto_actions:
+    on_warning:      # 60% remaining
+      - display_banner
+    on_action:       # 50% remaining
+      - save_snapshot
+      - suggest_compact
+    on_critical:     # 40% remaining
+      - save_snapshot
+      - require_compact
+
+  # Statusline API integration for real-time monitoring
+  statusline:
+    enabled: true
+    script: ".claude/hooks/statusline.sh"
+    update_interval_ms: 300
+
+  # Legacy absolute thresholds (deprecated, kept for compatibility)
+  context_warning: 50000    # tokens - trigger state save
+  context_limit: 80000      # tokens - trigger /clear
+
+  # Automatic behaviors
+  auto_checkpoint: true
+  auto_handoff: true
+  preserve_failed_states: true
+
+# Hook Configuration
+hooks:
+  pre_stage:
+    - "validate_inputs"
+    - "check_previous_handoff"
+    - "verify_prerequisites"
+
+  post_stage:
+    - "generate_handoff"
+    - "update_progress"
+    - "create_checkpoint"
+    - "notify_completion"
+
+# Transition Rules
+transitions:
+  allow_skip: false
+  require_handoff: true
+  require_checkpoint:
+    - "06-implementation"
+    - "07-refactoring"
+
+  # Rollback configuration
+  rollback:
+    enabled: true
+    max_rollback_stages: 2
+
+# Test-First Flow Configuration
+# Ensures tests are run at key stages to catch bugs early
+test_first_flow:
+  enabled: true
+  description: "구현/리팩토링 단계 후 즉시 테스트 실행으로 버그 조기 발견"
+
+  # Stages requiring tests after completion
+  test_gates:
+    - stage: "06-implementation"
+      required_tests:
+        - type: "smoke"
+          command: "npm run dev"
+          description: "개발 서버 실행 확인"
+          timeout: 60
+        - type: "lint"
+          command: "npm run lint"
+          description: "정적 분석"
+          timeout: 120
+        - type: "typecheck"
+          command: "npm run typecheck"
+          description: "타입 체크"
+          timeout: 120
+        - type: "playwright_smoke"
+          command: "npx playwright test --grep @smoke"
+          description: "UI 기본 동작 확인"
+          timeout: 180
+          optional: true  # Playwright 설정 없으면 건너뜀
+      on_failure:
+        action: "block_handoff"
+        message: "테스트 실패 - 문제 해결 후 HANDOFF 진행"
+
+    - stage: "07-refactoring"
+      required_tests:
+        - type: "regression"
+          command: "npm run test"
+          description: "기존 테스트 실행 (회귀 방지)"
+          timeout: 300
+        - type: "lint"
+          command: "npm run lint"
+          description: "리팩토링 후 코드 품질 확인"
+          timeout: 120
+      on_failure:
+        action: "warn_and_continue"
+        message: "회귀 테스트 실패 - 주의 필요"
+
+    - stage: "08-qa"
+      required_tests:
+        - type: "full_test"
+          command: "npm run test"
+          description: "전체 테스트 스위트"
+          timeout: 600
+        - type: "e2e"
+          command: "npx playwright test"
+          description: "E2E 테스트"
+          timeout: 600
+          optional: true
+      on_failure:
+        action: "block_handoff"
+        message: "QA 테스트 실패 - 버그 수정 필요"
+
+  # Test result tracking
+  tracking:
+    enabled: true
+    log_file: "state/test_results.json"
+    include_in_handoff: true
+
+  # Notifications
+  notifications:
+    on_test_failure: true
+    on_bug_found: true
+    include_stack_trace: true
+
+# Pipeline Forking Configuration
+# See config/pipeline_forking.yaml for detailed settings
+forking:
+  enabled: true
+
+  # Stages where forking is allowed
+  fork_points:
+    - stage: "03-planning"
+      condition: "multiple_architectures_proposed"
+      description: "아키텍처 대안 탐색용 분기"
+
+    - stage: "06-implementation"
+      condition: "technology_alternatives"
+      description: "기술 스택 대안 탐색용 분기"
+
+  # Fork management
+  management:
+    max_active_forks: 3
+    state_directory: "state/forks"
+
+    # Auto-merge settings
+    auto_merge:
+      enabled: false
+      strategy: "best_performer"
+
+    # Cleanup settings
+    cleanup:
+      delete_merged_forks: false
+      archive_directory: "state/forks/archived"
+
+  # Fork comparison metrics
+  comparison:
+    enabled: true
+    metrics:
+      - name: "code_quality"
+        weight: 0.4
+        command: "npm run lint -- --format json"
+
+      - name: "performance"
+        weight: 0.3
+        command: "npm run benchmark"
+
+      - name: "maintainability"
+        weight: 0.3
+        tool: "sonarqube"
+
+  # Integration with commands
+  commands:
+    create: "/fork create"
+    list: "/fork list"
+    compare: "/fork compare"
+    merge: "/fork merge"
+    delete: "/fork delete"