create-ax-project 1.0.0

package/template/config/ai_collaboration.yaml

@@ -0,0 +1,159 @@
+# ax-templates AI Collaboration Configuration
+# Multi-AI orchestration modes and collaboration strategies
+
+collaboration_modes:
+  # Parallel Execution: 동일 작업을 여러 AI로 동시 실행
+  parallel_execution:
+    description: "동일 작업을 여러 AI로 동시 실행하여 최상의 결과 선택"
+    enabled: true
+
+    stages:
+      - "01-brainstorm"
+      - "02-research"
+
+    models:
+      - "gemini"
+      - "claude"
+
+    merge_strategy:
+      type: "best_of_n"
+      selection_criteria:
+        - quality_score
+        - completeness
+        - creativity
+      require_human_review: true
+      auto_select_threshold: 0.85  # 85% 이상 점수 시 자동 선택
+
+  # Sequential Handoff: AI 간 순차 전달 (리뷰 체인)
+  sequential_handoff:
+    description: "AI 간 순차 전달로 결과물 점진적 개선"
+    enabled: true
+
+    chains:
+      code_review:
+        - model: "claude"
+          role: "초안 작성"
+          output: "draft.md"
+        - model: "gemini"
+          role: "창의적 개선"
+          output: "improved.md"
+        - model: "codex"
+          role: "기술 검증"
+          output: "verified.md"
+
+      planning_review:
+        - model: "gemini"
+          role: "아이디어 발산"
+          output: "ideas.md"
+        - model: "claude"
+          role: "실현 가능성 분석"
+          output: "analysis.md"
+        - model: "claude"
+          role: "최종 계획 수립"
+          output: "plan.md"
+
+    handoff_format:
+      include:
+        - context
+        - key_decisions
+        - modifications
+        - next_instructions
+
+  # Debate Mode: AI 간 토론으로 최적 결론 도출
+  debate_mode:
+    description: "AI 간 토론을 통해 다양한 관점에서 최적 결론 도출"
+    enabled: true
+
+    stages:
+      - "03-planning"
+      - "04-ui-ux"
+
+    participants:
+      - model: "claude"
+        role: "advocate"
+        perspective: "기술적 실현 가능성"
+      - model: "gemini"
+        role: "challenger"
+        perspective: "혁신적 접근법"
+
+    rules:
+      rounds: 3
+      max_tokens_per_turn: 2000
+      require_evidence: true
+      convergence_check: true
+
+    output:
+      format: "structured_summary"
+      include_dissenting_opinions: true
+      final_decision_method: "consensus"  # or "vote", "weighted"
+
+# Task Type Mappings for Collaboration
+task_collaboration_mapping:
+  ideation:
+    mode: "parallel_execution"
+    models: ["gemini", "claude"]
+
+  analysis:
+    mode: "sequential_handoff"
+    chain: "planning_review"
+
+  implementation:
+    mode: null  # Single AI preferred
+    primary: "claude"
+
+  review:
+    mode: "sequential_handoff"
+    chain: "code_review"
+
+  architecture:
+    mode: "debate_mode"
+    participants: ["claude", "gemini"]
+
+# Collaboration Output Handling
+output_handling:
+  storage_path: "state/collaborations/"
+
+  merge_strategies:
+    best_of_n:
+      description: "점수 기반 최고 결과 선택"
+      scoring:
+        - metric: "completeness"
+          weight: 0.3
+        - metric: "quality"
+          weight: 0.4
+        - metric: "creativity"
+          weight: 0.3
+
+    consensus:
+      description: "공통점 추출 + 차이점 병합"
+      conflict_resolution: "human_review"
+
+    synthesis:
+      description: "모든 결과물의 장점만 추출하여 새 결과물 생성"
+      synthesizer: "claude"
+
+# Collaboration Triggers
+triggers:
+  auto_collaborate:
+    on_low_confidence:
+      threshold: 0.7
+      action: "parallel_execution"
+
+    on_complex_task:
+      complexity_threshold: "high"
+      action: "debate_mode"
+
+    on_creative_task:
+      task_types: ["brainstorm", "design"]
+      action: "parallel_execution"
+
+# Resource Limits
+resource_limits:
+  max_concurrent_models: 2
+  total_token_budget_per_collaboration: 50000
+  timeout_per_model: 300  # 5 minutes
+
+  fallback:
+    on_timeout: "use_partial_results"
+    on_error: "single_model_fallback"
+    primary_fallback: "claude"

package/template/config/ai_logging.yaml

@@ -0,0 +1,129 @@
+# AI Logging Configuration
+# ax-templates-3 AI 호출 검증 및 로깅 규칙 (개선 제안 #2, #3 해결)
+
+ai_logging:
+  # 활성화 여부
+  enabled: true
+
+  # 로그 저장 위치
+  log_file: "state/ai_calls.log"
+
+# Gemini 호출 검증 체크리스트 (개선 제안 #2)
+gemini_verification:
+  # 호출 전 체크리스트
+  pre_call_checklist:
+    - name: "cli_installed"
+      check: "which gemini"
+      description: "Gemini CLI 설치 확인"
+
+    - name: "wrapper_exists"
+      check: "test -f scripts/gemini-wrapper.sh"
+      description: "래퍼 스크립트 존재 확인"
+
+    - name: "prompt_file_ready"
+      check: "test -f ${PROMPT_FILE}"
+      description: "프롬프트 파일 준비 확인"
+
+  # 호출 후 체크리스트
+  post_call_checklist:
+    - name: "tmux_session_active"
+      check: "tmux has-session -t ax-gemini 2>/dev/null"
+      description: "tmux 세션 활성 확인"
+
+    - name: "output_saved"
+      check: "test -f outputs/${OUTPUT_FILE}"
+      description: "출력 파일 저장 확인"
+
+# Codex 호출 검증 체크리스트
+codex_verification:
+  pre_call_checklist:
+    - name: "cli_installed"
+      check: "which codex"
+      description: "Codex CLI 설치 확인"
+
+    - name: "wrapper_exists"
+      check: "test -f scripts/codex-wrapper.sh"
+      description: "래퍼 스크립트 존재 확인"
+
+    - name: "sandbox_ready"
+      check: "docker ps | grep -q codex-sandbox || true"
+      description: "샌드박스 준비 확인 (선택)"
+
+  post_call_checklist:
+    - name: "tmux_session_active"
+      check: "tmux has-session -t ax-codex 2>/dev/null"
+      description: "tmux 세션 활성 확인"
+
+    - name: "output_saved"
+      check: "test -f outputs/${OUTPUT_FILE}"
+      description: "출력 파일 저장 확인"
+
+# HANDOFF.md AI 호출 로그 포함 설정 (개선 제안 #3)
+handoff_ai_log:
+  # 활성화 여부
+  enabled: true
+
+  # 로그 테이블 형식
+  format: |
+    ## AI 호출 기록
+
+    | AI | 호출 시간 | 프롬프트 파일 | 결과 파일 | 상태 |
+    |----|----------|--------------|----------|------|
+    {{#each ai_calls}}
+    | {{model}} | {{timestamp}} | {{prompt_file}} | {{output_file}} | {{status}} |
+    {{/each}}
+
+  # 포함할 정보
+  include:
+    - model              # AI 모델명 (Gemini, Codex, ClaudeCode)
+    - timestamp          # 호출 시간
+    - prompt_file        # 프롬프트 파일 경로
+    - output_file        # 출력 파일 경로
+    - status             # 성공/실패
+    - duration_seconds   # 실행 시간 (선택)
+
+# 스테이지별 AI 호출 추적
+stage_tracking:
+  # 각 스테이지에서 호출된 AI 추적
+  enabled: true
+
+  # 추적 항목
+  track:
+    - stage_id           # 스테이지 ID
+    - ai_model           # 사용된 AI 모델
+    - call_count         # 호출 횟수
+    - total_duration     # 총 소요 시간
+    - success_rate       # 성공률
+
+# 로그 형식
+log_format:
+  # 단일 호출 로그
+  single_call: |
+    [{{timestamp}}] {{stage_id}} - {{model}}
+    Prompt: {{prompt_file}}
+    Output: {{output_file}}
+    Status: {{status}}
+    Duration: {{duration}}s
+
+  # 일일 요약
+  daily_summary: |
+    === AI 호출 일일 요약 ({{date}}) ===
+    총 호출: {{total_calls}}
+    Gemini: {{gemini_calls}}
+    Codex: {{codex_calls}}
+    ClaudeCode: {{claude_calls}}
+    성공률: {{success_rate}}%
+
+# 경고 설정
+alerts:
+  # 연속 실패 시 경고
+  consecutive_failures:
+    threshold: 3
+    action: "notify_user"
+    message: "⚠️ AI 호출이 {{count}}회 연속 실패했습니다. 설정을 확인하세요."
+
+  # 응답 시간 초과 경고
+  slow_response:
+    threshold_seconds: 300
+    action: "warn"
+    message: "⚠️ AI 응답이 {{threshold}}초를 초과했습니다."

package/template/config/auto_checkpoint.yaml

@@ -0,0 +1,189 @@
+# ax-templates Auto-Checkpoint Configuration
+# Automatic checkpoint creation and management
+
+auto_checkpoint:
+  enabled: true
+  description: "자동 체크포인트 생성 및 관리"
+
+  # 트리거 조건
+  triggers:
+    # 태스크 완료 기반
+    task_based:
+      enabled: true
+      condition: "tasks_completed"
+      threshold: 5  # 5개 태스크 완료마다
+      action: "create_checkpoint"
+      naming: "auto_task_{{count}}_{{timestamp}}"
+
+    # 파일 변경 기반
+    file_change_based:
+      enabled: true
+      condition: "major_file_change"
+      threshold: 100  # 100줄 이상 변경
+      action: "create_checkpoint"
+      naming: "auto_change_{{timestamp}}"
+
+      # 파일 유형별 가중치
+      file_weights:
+        "*.ts": 1.0
+        "*.tsx": 1.0
+        "*.js": 1.0
+        "*.jsx": 1.0
+        "*.py": 1.0
+        "*.yaml": 0.5
+        "*.json": 0.5
+        "*.md": 0.3
+
+    # 파괴적 작업 전
+    before_destructive:
+      enabled: true
+      condition: "destructive_action_detected"
+      patterns:
+        - "rm -rf"
+        - "git reset --hard"
+        - "drop table"
+        - "DELETE FROM"
+        - "truncate"
+      action: "force_checkpoint"
+      naming: "pre_destructive_{{timestamp}}"
+      require_confirmation: true
+
+    # 시간 기반
+    time_based:
+      enabled: true
+      condition: "interval"
+      interval_minutes: 30
+      action: "create_checkpoint"
+      naming: "auto_interval_{{timestamp}}"
+      only_if_changes: true  # 변경이 있을 때만
+
+    # 스테이지 기반
+    stage_based:
+      enabled: true
+      conditions:
+        on_stage_start: false
+        on_stage_complete: true
+        on_stage_error: true
+      action: "create_checkpoint"
+      naming: "stage_{{stage_id}}_{{status}}_{{timestamp}}"
+
+  # 보존 정책
+  retention:
+    max_checkpoints: 20
+    max_age_days: 30
+
+    cleanup_strategy: "keep_milestones"
+
+    milestone_criteria:
+      - stage_complete
+      - pre_destructive
+      - user_created
+      - tagged
+
+    # 자동 정리
+    auto_cleanup:
+      enabled: true
+      schedule: "daily"
+      preserve_minimum: 5
+
+  # 체크포인트 내용
+  checkpoint_content:
+    include:
+      - source_code: true
+      - config_files: true
+      - state_files: true
+      - handoffs: true
+      - outputs: true
+
+    exclude:
+      - "node_modules/"
+      - ".git/"
+      - "*.log"
+      - "*.tmp"
+      - "__pycache__/"
+      - ".cache/"
+
+    # 메타데이터
+    metadata:
+      - timestamp
+      - stage_id
+      - task_count
+      - trigger_reason
+      - file_changes_summary
+      - git_commit_hash
+
+  # 스토리지 설정
+  storage:
+    base_path: "state/checkpoints/"
+    format: "tar.gz"  # tar.gz, zip, directory
+    compression_level: 6  # 1-9
+
+    naming_convention: "{{stage}}_{{trigger}}_{{timestamp}}"
+
+    # 외부 스토리지 백업 (옵션)
+    external_backup:
+      enabled: false
+      provider: null  # s3, gcs, azure
+      path: null
+
+# 체크포인트 생성 프로세스
+creation_process:
+  steps:
+    - name: "validate_state"
+      description: "현재 상태 유효성 검증"
+      required: true
+
+    - name: "collect_files"
+      description: "포함할 파일 수집"
+      required: true
+
+    - name: "generate_metadata"
+      description: "메타데이터 생성"
+      required: true
+
+    - name: "create_archive"
+      description: "아카이브 생성"
+      required: true
+
+    - name: "verify_integrity"
+      description: "무결성 검증"
+      required: true
+
+    - name: "cleanup_old"
+      description: "오래된 체크포인트 정리"
+      required: false
+
+  # 실패 처리
+  on_failure:
+    retry: 2
+    fallback: "skip_with_warning"
+    notify: true
+
+# 알림 설정
+notifications:
+  on_create:
+    enabled: true
+    message: "체크포인트 생성됨: {{name}}"
+
+  on_cleanup:
+    enabled: true
+    message: "오래된 체크포인트 정리됨: {{count}}개"
+
+  on_threshold:
+    enabled: true
+    threshold: 15  # 15개 초과 시
+    message: "체크포인트가 {{count}}개입니다. 정리가 필요할 수 있습니다."
+
+# Git 통합
+git_integration:
+  tag_checkpoints: true
+  tag_prefix: "checkpoint/"
+
+  commit_message_template: |
+    chore(checkpoint): Auto-checkpoint {{trigger}}
+
+    Stage: {{stage_id}}
+    Trigger: {{trigger_reason}}
+    Files: {{file_count}}
+
+  push_tags: false  # true면 원격에 태그 푸시

package/template/config/context.yaml

@@ -0,0 +1,78 @@
+# Context Management Configuration
+# ax-templates-3 컨텍스트 관리 설정
+
+context_management:
+  # 퍼센트 기반 임계값 (남은 컨텍스트 기준)
+  thresholds:
+    warning: 60       # 60% 남으면 경고 표시
+    action: 50        # 50% 남으면 자동 저장 + 압축 권장
+    critical: 40      # 40% 남으면 /clear 강제 권고
+
+  # 태스크 기반 저장 주기
+  task_save_frequency: 5  # 5개 태스크마다 자동 상태 저장
+
+  # 예상 최대 토큰 (Claude 기준)
+  max_tokens: 200000
+
+# 자동 동작 설정
+auto_actions:
+  on_warning:
+    - display_warning_banner
+    - calculate_compression_ratio
+
+  on_action_threshold:
+    - save_state_to_file
+    - generate_context_summary
+    - suggest_compression
+
+  on_critical:
+    - force_state_save
+    - generate_recovery_handoff
+    - prompt_clear_confirmation  # 사용자 확인 후 /clear 실행
+
+# 상태 저장 설정
+state_saving:
+  directory: "state/context"
+  filename_format: "state_{timestamp}_{stage}.md"
+
+  # 저장 트리거
+  triggers:
+    - threshold_crossed
+    - task_batch_complete
+    - manual_checkpoint
+    - stage_transition
+
+  # 저장할 항목
+  include:
+    - current_stage
+    - progress_summary
+    - active_tasks
+    - key_decisions
+    - recovery_instructions
+    - file_modifications
+
+# 컨텍스트 압축 설정
+compression:
+  auto_activate_at: 50  # action 임계값에서 자동 활성화
+
+  strategies:
+    - name: "summarize_completed"
+      description: "완료된 작업을 요약으로 대체"
+      priority: 1
+
+    - name: "externalize_code"
+      description: "코드 블록을 파일 참조로 대체"
+      priority: 2
+
+    - name: "handoff_generation"
+      description: "현재 상태를 HANDOFF.md로 외부화"
+      priority: 3
+
+# 모니터링 설정
+monitoring:
+  display_in_prompt: true
+  update_interval: "per_response"
+
+  # 상태 표시 형식
+  display_format: |
+    [Context: {remaining_percent}% | {remaining_tokens}k tokens]

package/template/config/git.yaml

@@ -0,0 +1,161 @@
+# Git Configuration
+# ax-templates-3 Git 자동 커밋 규칙 (Issue #15 해결)
+
+git:
+  # 자동 커밋 설정
+  auto_commit:
+    enabled: true
+
+    # 트리거 이벤트
+    triggers:
+      on_task_complete: true      # 태스크 완료 시
+      on_stage_complete: true     # 스테이지 완료 시
+      on_checkpoint: true         # 체크포인트 생성 시
+      on_milestone: true          # 마일스톤 완료 시
+
+  # 커밋 메시지 규칙 (Conventional Commits)
+  commit_convention:
+    format: "<type>(<scope>): <description>"
+
+    # 커밋 타입
+    types:
+      - name: "feat"
+        description: "새로운 기능 추가"
+        stages: ["06-implementation"]
+
+      - name: "fix"
+        description: "버그 수정"
+        stages: ["08-qa"]
+
+      - name: "refactor"
+        description: "코드 리팩토링"
+        stages: ["07-refactoring"]
+
+      - name: "test"
+        description: "테스트 추가/수정"
+        stages: ["09-testing"]
+
+      - name: "docs"
+        description: "문서 수정"
+        stages: ["all"]
+
+      - name: "chore"
+        description: "기타 변경사항"
+        stages: ["10-deployment"]
+
+      - name: "style"
+        description: "코드 스타일 변경"
+        stages: ["04-ui-ux", "06-implementation"]
+
+      - name: "perf"
+        description: "성능 개선"
+        stages: ["07-refactoring"]
+
+      - name: "ci"
+        description: "CI/CD 설정"
+        stages: ["10-deployment"]
+
+    # 스테이지별 스코프 매핑
+    scope_mapping:
+      "01-brainstorm": "brainstorm"
+      "02-research": "research"
+      "03-planning": "plan"
+      "04-ui-ux": "ui"
+      "05-task-management": "tasks"
+      "06-implementation": "impl"
+      "07-refactoring": "refactor"
+      "08-qa": "qa"
+      "09-testing": "test"
+      "10-deployment": "deploy"
+
+    # 설명 규칙
+    description_rules:
+      max_length: 72
+      language: "Korean"         # Korean | English
+      start_with_verb: true      # 동사로 시작
+      no_period_at_end: true     # 끝에 마침표 없음
+
+  # 커밋 메시지 예시
+  examples:
+    task_complete: "feat(impl): 사용자 인증 기능 구현"
+    stage_complete: "chore(impl): Stage 06 완료 - HANDOFF.md 생성"
+    bug_fix: "fix(qa): 로그인 세션 만료 버그 수정"
+    refactor: "refactor(refactor): 인증 서비스 코드 최적화"
+    test: "test(test): 사용자 인증 E2E 테스트 추가"
+
+  # 브랜치 규칙
+  branch:
+    # 브랜치 네이밍
+    naming:
+      feature: "feature/{stage}-{task-id}"
+      bugfix: "bugfix/{issue-id}"
+      release: "release/v{version}"
+
+    # 기본 브랜치
+    default: "main"
+    develop: "develop"
+
+    # 스테이지별 브랜치 전략
+    strategy: "feature-branch"   # feature-branch | trunk-based
+
+  # 자동화 동작
+  automation:
+    # 태스크 완료 시
+    on_task_complete:
+      actions:
+        - "stage_changes"
+        - "generate_commit_message"
+        - "commit"
+
+    # 스테이지 완료 시
+    on_stage_complete:
+      actions:
+        - "stage_all_changes"
+        - "generate_stage_commit_message"
+        - "commit"
+        - "create_tag"
+
+    # 체크포인트 시
+    on_checkpoint:
+      actions:
+        - "commit_all"
+        - "create_checkpoint_tag"
+
+  # 커밋 메시지 생성 템플릿
+  templates:
+    task_complete: |
+      {{type}}({{scope}}): {{description}}
+
+      Task: {{task_id}}
+      Stage: {{stage_id}}
+
+    stage_complete: |
+      chore({{scope}}): Stage {{stage_number}} 완료
+
+      완료된 작업:
+      {{#each completed_tasks}}
+      - {{this}}
+      {{/each}}
+
+      다음 스테이지: {{next_stage}}
+
+    checkpoint: |
+      chore(checkpoint): {{description}}
+
+      Stage: {{stage_id}}
+      Checkpoint: {{checkpoint_id}}
+      Created: {{timestamp}}
+
+# 금지 사항
+prohibited:
+  - "커밋 메시지 없이 커밋"
+  - "WIP 커밋 (임시 저장용)"
+  - "대문자 시작 (영어의 경우)"
+  - "의미 없는 커밋 메시지"
+
+# 권장 사항
+recommended:
+  - "작은 단위 커밋"
+  - "의미 있는 커밋 메시지"
+  - "관련 파일만 스테이징"
+  - "커밋 전 lint/format 실행"