create-ax-project 1.0.0

package/template/config/pipeline_forking.yaml

@@ -0,0 +1,236 @@
+# ax-templates Pipeline Forking Configuration
+# Branch exploration and parallel pipeline execution
+
+pipeline_forking:
+  enabled: true
+  description: "파이프라인 분기로 다양한 접근법 동시 탐색"
+
+  # 분기점 정의
+  fork_points:
+    planning_stage:
+      stage: "03-planning"
+      condition: "multiple_architectures_proposed"
+      description: "여러 아키텍처 제안 시 분기하여 각각 탐색"
+      auto_fork: false
+      max_forks: 3
+
+    implementation_stage:
+      stage: "06-implementation"
+      condition: "alternative_approaches"
+      description: "구현 접근법이 여러 개일 때 병렬 탐색"
+      auto_fork: false
+      max_forks: 2
+
+    refactoring_stage:
+      stage: "07-refactoring"
+      condition: "optimization_tradeoffs"
+      description: "최적화 방향이 여러 개일 때 비교"
+      auto_fork: false
+      max_forks: 2
+
+  # 자동 분기 트리거
+  auto_fork_triggers:
+    enabled: false  # 기본적으로 수동 분기
+
+    conditions:
+      confidence_threshold:
+        enabled: true
+        threshold: 0.6  # 확신도가 60% 미만일 때
+        action: "suggest_fork"
+
+      multiple_solutions:
+        enabled: true
+        minimum_alternatives: 2
+        action: "suggest_fork"
+
+      high_risk_decision:
+        enabled: true
+        risk_indicators:
+          - "irreversible"
+          - "major_architecture_change"
+          - "breaking_change"
+        action: "require_fork"
+
+  # 분기 관리
+  fork_management:
+    max_active_forks: 3
+    naming_convention: "fork_{{stage}}_{{variant}}_{{timestamp}}"
+
+    storage:
+      base_path: "state/forks/"
+      structure: "isolated"  # isolated or shared
+
+    isolation:
+      separate_state: true
+      separate_outputs: true
+      shared_inputs: true  # 입력은 공유
+
+    # 분기 상태 추적
+    tracking:
+      progress: true
+      metrics: true
+      comparison_points: true
+
+  # 병합 전략
+  merge_strategy:
+    primary: "best_performer"
+    fallback: "manual_selection"
+
+    strategies:
+      best_performer:
+        description: "메트릭 기반 최고 성능 분기 선택"
+        criteria:
+          - metric: "code_quality"
+            weight: 0.3
+          - metric: "performance"
+            weight: 0.3
+          - metric: "maintainability"
+            weight: 0.2
+          - metric: "test_coverage"
+            weight: 0.2
+
+      manual_selection:
+        description: "사용자가 직접 분기 선택"
+        require_justification: true
+
+      cherry_pick:
+        description: "여러 분기에서 최적 부분만 선택"
+        supported: true
+        complexity: "high"
+
+  # 비교 설정
+  comparison:
+    enabled: true
+
+    metrics:
+      code_quality:
+        measure: "lint_score"
+        higher_is_better: true
+
+      performance:
+        measure: "benchmark_time"
+        higher_is_better: false
+
+      maintainability:
+        measure: "cyclomatic_complexity"
+        higher_is_better: false
+
+      test_coverage:
+        measure: "coverage_percentage"
+        higher_is_better: true
+
+    reporting:
+      format: "comparison_table"
+      include_recommendations: true
+
+    visualization:
+      enabled: true
+      chart_types:
+        - "radar_chart"
+        - "bar_comparison"
+
+# 분기 생성 프로세스
+creation_process:
+  steps:
+    - name: "validate_fork_point"
+      description: "분기점 유효성 검증"
+
+    - name: "create_fork_directory"
+      description: "분기 디렉토리 생성"
+
+    - name: "copy_current_state"
+      description: "현재 상태 복사"
+
+    - name: "initialize_fork_config"
+      description: "분기 설정 초기화"
+
+    - name: "create_fork_handoff"
+      description: "분기용 HANDOFF 생성"
+
+    - name: "register_fork"
+      description: "분기 등록"
+
+  fork_handoff_template: |
+    # Fork HANDOFF - {{fork_name}}
+
+    ## 분기 정보
+    - **원본 스테이지**: {{source_stage}}
+    - **분기 이유**: {{fork_reason}}
+    - **분기 시점**: {{timestamp}}
+    - **탐색 방향**: {{exploration_direction}}
+
+    ## 분기 목표
+    {{objectives}}
+
+    ## 평가 기준
+    {{evaluation_criteria}}
+
+    ## 병합 조건
+    {{merge_conditions}}
+
+# 분기 실행
+execution:
+  parallel_execution:
+    enabled: true
+    max_concurrent: 2
+
+  resource_allocation:
+    strategy: "equal"  # equal, priority_based
+
+  synchronization:
+    sync_points:
+      - "stage_complete"
+      - "milestone_reached"
+
+    timeout_minutes: 120  # 분기 최대 실행 시간
+
+# 정리 정책
+cleanup:
+  auto_cleanup: true
+
+  cleanup_triggers:
+    - after_merge
+    - on_abandon
+    - on_timeout
+
+  retention:
+    keep_merged: true
+    keep_abandoned: false
+    retention_days: 7
+
+# 알림 설정
+notifications:
+  on_fork_create:
+    enabled: true
+    message: "파이프라인 분기 생성됨: {{fork_name}}"
+
+  on_fork_complete:
+    enabled: true
+    message: "분기 완료: {{fork_name}} - {{status}}"
+
+  on_comparison_ready:
+    enabled: true
+    message: "분기 비교 준비 완료. {{fork_count}}개 분기 비교 가능"
+
+  on_merge:
+    enabled: true
+    message: "분기 병합 완료: {{selected_fork}} 선택됨"
+
+# 통합 설정
+integration:
+  git:
+    create_branches: true
+    branch_prefix: "fork/"
+    auto_merge: false
+
+  handoff:
+    include_fork_info: true
+    track_decisions: true
+
+  checkpoint:
+    create_before_fork: true
+    create_after_merge: true
+
+  memory:
+    save_fork_decisions: true
+    save_comparison_results: true

package/template/config/qa_logging.yaml

@@ -0,0 +1,166 @@
+# Q&A Logging Configuration
+# ax-templates-3 문답 자동 기록 규칙 (Q7 해결)
+
+qa_logging:
+  # 활성화 여부
+  enabled: true
+
+  # 기록 대상 파일
+  target_file: "feedback.md"
+
+  # 백업 위치
+  backup_dir: "state/qa_backups/"
+
+# 기록 트리거
+triggers:
+  # 자동 트리거
+  automatic:
+    - event: "stage_complete"
+      description: "스테이지 완료 시"
+      priority: "high"
+
+    - event: "issue_discovered"
+      description: "새로운 이슈 발견 시"
+      priority: "high"
+
+    - event: "process_change_request"
+      description: "프로세스 변경 요청 시"
+      priority: "medium"
+
+    - event: "tool_failure"
+      description: "도구 실패 시"
+      priority: "high"
+
+    - event: "workaround_found"
+      description: "우회 방법 발견 시"
+      priority: "medium"
+
+  # 수동 트리거 커맨드
+  manual:
+    command: "/log-qa"
+    description: "수동으로 문답 기록"
+
+# 기록 형식
+format:
+  # 섹션 헤더
+  section_header: "### Q{{number}}: {{title}}"
+
+  # 기록 템플릿
+  template: |
+    ### Q{{number}}: {{title}}
+
+    **질문**: {{question}}
+
+    **답변**: {{answer}}
+
+    **해결 방법**: {{solution}}
+
+    **향후 개선 제안**: {{suggestion}}
+
+    **관련 스테이지**: {{stage_id}}
+
+    **기록 일시**: {{timestamp}}
+
+    ---
+
+  # 포함 항목
+  include:
+    - question          # 원본 질문
+    - answer            # 요약된 답변
+    - solution          # 해결 방법
+    - suggestion        # 향후 개선 제안
+    - stage_id          # 관련 스테이지
+    - timestamp         # 기록 시간
+    - category          # 카테고리
+
+# 카테고리 분류
+categories:
+  - name: "workflow_improvements"
+    description: "워크플로우 개선"
+    keywords: ["프로세스", "단계", "순서", "자동화"]
+
+  - name: "tool_usage"
+    description: "도구 사용법"
+    keywords: ["MCP", "CLI", "Notion", "Git"]
+
+  - name: "process_changes"
+    description: "프로세스 변경"
+    keywords: ["변경", "수정", "추가", "삭제"]
+
+  - name: "bug_fixes"
+    description: "버그 수정"
+    keywords: ["버그", "에러", "오류", "실패"]
+
+  - name: "best_practices"
+    description: "모범 사례"
+    keywords: ["권장", "추천", "패턴", "규칙"]
+
+# 필터링 규칙
+filtering:
+  # 포함할 항목
+  include:
+    - "workflow_improvements"
+    - "tool_usage"
+    - "process_changes"
+    - "bug_fixes"
+    - "best_practices"
+
+  # 제외할 항목
+  exclude:
+    - "trivial_questions"      # 사소한 질문
+    - "repeated_questions"     # 반복되는 질문
+    - "off_topic"              # 주제 외 질문
+
+  # 제외 키워드
+  exclude_keywords:
+    - "테스트"
+    - "임시"
+    - "무시"
+
+# 자동 번호 매기기
+numbering:
+  # 자동 번호 부여
+  auto_increment: true
+
+  # 시작 번호 (기존 Q&A 이후)
+  start_from: "auto"  # feedback.md에서 마지막 번호 자동 감지
+
+  # 형식
+  format: "Q{{number}}"
+
+# 중복 감지
+deduplication:
+  # 활성화 여부
+  enabled: true
+
+  # 유사도 임계값 (0-1)
+  similarity_threshold: 0.8
+
+  # 중복 처리
+  on_duplicate: "merge"  # merge | skip | ask
+
+# 알림 설정
+notifications:
+  # 새 Q&A 기록 시 알림
+  on_new_entry:
+    enabled: true
+    message: "📝 새로운 Q&A가 feedback.md에 기록되었습니다: Q{{number}}"
+
+  # 일일 요약
+  daily_summary:
+    enabled: false
+    time: "18:00"
+
+# 내보내기 설정
+export:
+  # 지원 형식
+  formats:
+    - "markdown"
+    - "json"
+    - "csv"
+
+  # 자동 내보내기
+  auto_export:
+    enabled: false
+    format: "json"
+    path: "state/qa_export.json"

package/template/config/smart_rollback.yaml

@@ -0,0 +1,209 @@
+# ax-templates Smart Rollback Configuration
+# Intelligent rollback suggestions and execution
+
+smart_rollback:
+  enabled: true
+  description: "지능형 롤백 제안 및 실행"
+
+  # 에러 발생 시 롤백 제안
+  suggestion:
+    on_error:
+      enabled: true
+      steps:
+        - analyze_error_type
+        - find_relevant_checkpoint
+        - calculate_rollback_scope
+        - suggest_recovery_path
+
+    analysis:
+      error_patterns:
+        build_failure:
+          description: "빌드 실패"
+          common_causes: ["dependency", "syntax", "type_error"]
+          suggested_scope: "file_level"
+
+        test_failure:
+          description: "테스트 실패"
+          common_causes: ["logic_error", "state_change"]
+          suggested_scope: "function_level"
+
+        runtime_error:
+          description: "런타임 에러"
+          common_causes: ["null_reference", "type_mismatch"]
+          suggested_scope: "file_level"
+
+        configuration_error:
+          description: "설정 에러"
+          common_causes: ["invalid_config", "missing_env"]
+          suggested_scope: "config_only"
+
+    checkpoint_selection:
+      strategy: "most_recent_stable"
+      fallback: "last_stage_complete"
+
+      scoring:
+        recency: 0.4
+        stability: 0.4
+        relevance: 0.2
+
+  # 부분 롤백
+  partial_rollback:
+    enabled: true
+    description: "전체 롤백 대신 영향 범위만 선택적 복구"
+
+    granularity:
+      file_level:
+        description: "특정 파일만 롤백"
+        use_when: ["single_file_error", "isolated_change"]
+
+      function_level:
+        description: "특정 함수/메서드만 롤백"
+        use_when: ["logic_error", "refactoring_issue"]
+        supported_languages: ["typescript", "javascript", "python"]
+
+      stage_level:
+        description: "특정 스테이지 전체 롤백"
+        use_when: ["major_failure", "architecture_change"]
+
+      config_only:
+        description: "설정 파일만 롤백"
+        use_when: ["configuration_error"]
+        patterns: ["*.yaml", "*.json", "*.env*"]
+
+    # 의존성 분석
+    dependency_analysis:
+      enabled: true
+      description: "롤백 시 영향받는 파일 자동 감지"
+
+      include_dependents: true
+      max_cascade_depth: 3
+
+  # 롤백 미리보기
+  rollback_preview:
+    enabled: true
+    description: "롤백 전 변경사항 미리보기"
+
+    show_diff: true
+    show_impact: true
+    show_affected_files: true
+    show_test_status: true
+
+    require_confirmation: true
+    confirmation_prompt: |
+      ## 롤백 미리보기
+
+      **대상 체크포인트**: {{checkpoint_name}}
+      **롤백 범위**: {{scope}}
+
+      ### 영향받는 파일 ({{file_count}}개)
+      {{affected_files}}
+
+      ### 변경사항 요약
+      {{diff_summary}}
+
+      이 롤백을 실행하시겠습니까? (y/n)
+
+  # 롤백 실행
+  execution:
+    pre_rollback:
+      - create_backup_checkpoint
+      - save_current_state
+      - notify_rollback_start
+
+    rollback_steps:
+      - validate_checkpoint
+      - extract_files
+      - apply_changes
+      - verify_integrity
+      - update_state
+
+    post_rollback:
+      - run_validation
+      - update_handoff
+      - notify_completion
+
+    # 실패 처리
+    on_failure:
+      strategy: "restore_backup"
+      notify: true
+      log_details: true
+
+  # 안전 장치
+  safety:
+    # 롤백 불가 조건
+    prevent_rollback_when:
+      - uncommitted_changes: true
+      - active_processes: true
+      - locked_files: true
+
+    # 확인 필요 조건
+    require_confirmation_when:
+      - scope: "stage_level"
+      - files_affected: 10
+      - includes_production: true
+
+    # 롤백 제한
+    limits:
+      max_rollback_stages: 2
+      max_file_rollbacks: 50
+      cooldown_minutes: 5
+
+# 롤백 히스토리
+history:
+  enabled: true
+  storage_path: "state/rollback_history/"
+
+  track:
+    - timestamp
+    - trigger
+    - scope
+    - affected_files
+    - success_status
+    - recovery_time
+
+  retention_days: 30
+
+# 복구 가이드
+recovery_guide:
+  enabled: true
+  description: "롤백 후 복구 작업 안내"
+
+  templates:
+    after_file_rollback: |
+      ## 파일 롤백 완료
+
+      다음 파일이 복구되었습니다:
+      {{files}}
+
+      ### 권장 다음 단계
+      1. 변경사항 확인: `git diff`
+      2. 테스트 실행: `npm test`
+      3. 필요시 수정 후 재커밋
+
+    after_stage_rollback: |
+      ## 스테이지 롤백 완료
+
+      {{stage_id}}가 체크포인트로 복구되었습니다.
+
+      ### 복구 정보
+      - 체크포인트: {{checkpoint_name}}
+      - 복구된 파일: {{file_count}}개
+
+      ### 권장 다음 단계
+      1. HANDOFF 확인: `stages/{{stage_id}}/HANDOFF.md`
+      2. 태스크 재검토
+      3. 스테이지 재시작
+
+# 통합 설정
+integration:
+  git:
+    auto_stash: true
+    create_branch: false  # true면 롤백용 브랜치 생성
+
+  handoff:
+    update_on_rollback: true
+    include_rollback_info: true
+
+  memory:
+    save_rollback_decision: true
+    observation_type: "bugfix"