create-ax-project 1.0.0

package/template/config/handoff_intelligence.yaml

@@ -0,0 +1,229 @@
+# ax-templates HANDOFF Intelligence Configuration
+# Smart context extraction and summarization
+
+smart_handoff:
+  enabled: true
+  description: "자동 컨텍스트 추출 및 지능형 HANDOFF 생성"
+
+  # 자동 추출 설정
+  auto_extraction:
+    enabled: true
+    description: "HANDOFF에 포함할 정보 자동 추출"
+
+    extract_from:
+      completed_tasks:
+        enabled: true
+        format: "checklist"
+        include_timestamps: true
+
+      key_decisions:
+        enabled: true
+        format: "decision_log"
+        include_rationale: true
+        include_alternatives: false
+
+      modified_files:
+        enabled: true
+        format: "file_list"
+        include_diff_summary: true
+        max_files: 20
+
+      pending_issues:
+        enabled: true
+        format: "issue_list"
+        priority_order: true
+
+      ai_call_history:
+        enabled: true
+        format: "table"
+        include_prompts: false  # 토큰 절약
+        include_results_summary: true
+
+    # 추출 우선순위 (높을수록 먼저)
+    priority:
+      - blocking_issues: 100
+      - key_decisions: 90
+      - pending_issues: 80
+      - modified_files: 70
+      - completed_tasks: 60
+      - ai_call_history: 50
+
+  # 압축 설정
+  compression:
+    enabled: true
+    strategy: "semantic"
+    description: "의미 기반 컨텍스트 압축"
+
+    max_tokens: 4000
+    compression_ratio_target: 0.3  # 원본의 30%
+
+    preserve:
+      always:
+        - "critical_decisions"
+        - "blocking_issues"
+        - "current_task"
+      conditionally:
+        - "file_changes"
+        - "test_results"
+
+    summarization:
+      enabled: true
+      method: "extractive"  # extractive or abstractive
+      model: "claude"
+
+  # 컨텍스트 전달 최적화
+  context_transfer:
+    format: "structured_markdown"
+
+    sections:
+      critical:
+        title: "Critical Context"
+        max_tokens: 1500
+        content:
+          - blocking_issues
+          - critical_decisions
+
+      primary:
+        title: "Primary Context"
+        max_tokens: 1500
+        content:
+          - current_task_state
+          - key_file_changes
+          - next_steps
+
+      secondary:
+        title: "Secondary Context"
+        max_tokens: 1000
+        content:
+          - completed_tasks_summary
+          - ai_call_summary
+
+    # 다음 스테이지에 즉시 필요한 정보 하이라이트
+    highlight:
+      enabled: true
+      marker: "!!"
+      content:
+        - immediate_actions
+        - required_inputs
+
+# 컨텍스트 요약 설정
+contextual_summarization:
+  enabled: true
+  description: "스테이지별 맞춤 요약 생성"
+
+  strategies:
+    completed_tasks:
+      method: "bullet_points"
+      max_items: 10
+      grouping: "by_type"  # by_type, by_priority, chronological
+
+    file_changes:
+      method: "impact_analysis"
+      include:
+        - file_path
+        - change_type
+        - impact_scope
+      exclude_patterns:
+        - "*.log"
+        - "*.tmp"
+        - "node_modules/*"
+
+    decisions:
+      method: "structured"
+      format: |
+        **결정**: {{decision}}
+        **이유**: {{rationale}}
+        **영향**: {{impact}}
+
+    next_steps:
+      method: "actionable"
+      format: "numbered_list"
+      include_prerequisites: true
+
+  # 스테이지별 요약 초점
+  stage_focus:
+    "01-brainstorm":
+      emphasize: ["ideas", "requirements"]
+      de_emphasize: ["technical_details"]
+
+    "06-implementation":
+      emphasize: ["code_changes", "technical_decisions"]
+      de_emphasize: ["ideation"]
+
+    "08-qa":
+      emphasize: ["bugs", "test_results"]
+      de_emphasize: ["planning_details"]
+
+# HANDOFF 템플릿 설정
+templates:
+  default:
+    sections:
+      - name: "Summary"
+        required: true
+        auto_generate: true
+
+      - name: "Completed Tasks"
+        required: true
+        auto_generate: true
+
+      - name: "Key Decisions"
+        required: true
+        auto_generate: true
+
+      - name: "Modified Files"
+        required: false
+        auto_generate: true
+
+      - name: "Pending Issues"
+        required: false
+        auto_generate: true
+
+      - name: "Next Steps"
+        required: true
+        auto_generate: true
+
+      - name: "AI Call History"
+        required: false
+        auto_generate: true
+
+  # 스테이지 전환용 간소화 템플릿
+  compact:
+    max_tokens: 2000
+    sections:
+      - name: "Critical"
+        required: true
+      - name: "Next Actions"
+        required: true
+
+  # 세션 복구용 상세 템플릿
+  recovery:
+    max_tokens: 6000
+    sections:
+      - name: "Full Context"
+        required: true
+      - name: "Step-by-Step Recovery"
+        required: true
+
+# 품질 검증
+quality_assurance:
+  validation:
+    check_completeness: true
+    check_consistency: true
+    check_actionability: true
+
+  scoring:
+    enabled: true
+    criteria:
+      - clarity: 0.3
+      - completeness: 0.3
+      - actionability: 0.4
+
+    minimum_score: 0.7
+
+  auto_improve:
+    enabled: true
+    max_iterations: 2
+    improvement_prompts:
+      low_clarity: "이 섹션을 더 명확하게 다시 작성하세요."
+      low_completeness: "누락된 정보가 있습니다. 다음을 추가하세요: {{missing}}"
+      low_actionability: "다음 단계를 더 구체적인 액션으로 변환하세요."

package/template/config/implementation.yaml.template

@@ -0,0 +1,181 @@
+# Implementation Rules Template
+# ax-templates-3 프로젝트별 구현 규칙 정의 (Issue #10 해결)
+#
+# 이 파일은 Planning 스테이지(03)에서 프로젝트에 맞게 작성하고
+# Implementation 스테이지(06)에서 참조합니다.
+#
+# 사용법:
+# 1. 이 템플릿을 프로젝트 루트에 implementation.yaml로 복사
+# 2. 프로젝트 요구사항에 맞게 수정
+# 3. 구현 시 이 규칙을 따름
+
+project:
+  name: "{{PROJECT_NAME}}"
+  created_at: "{{TIMESTAMP}}"
+
+# 컴포넌트 규칙
+components:
+  # 컴포넌트 타입
+  type: "functional"  # functional | class | both
+
+  # export 방식
+  export: "named"     # named | default | both
+
+  # 파일당 컴포넌트 수
+  single_component_per_file: true
+
+  # Props 정의 방식
+  props_definition: "interface"  # interface | type | inline
+
+  # 기본 구조
+  structure: |
+    // imports
+    // types/interfaces
+    // component
+    // exports
+
+# 스타일링 규칙
+styling:
+  # 접근 방식
+  approach: "css-modules"  # css-modules | styled-components | tailwind | emotion | vanilla
+
+  # 파일 위치
+  location: "colocated"    # colocated | separate | global
+
+  # 네이밍
+  naming: "BEM"            # BEM | camelCase | kebab-case
+
+  # CSS 변수 사용
+  css_variables: true
+
+# 상태 관리 규칙
+state_management:
+  # 전역 상태
+  global: "context"        # context | redux | zustand | recoil | jotai
+
+  # 서버 상태
+  server: "tanstack-query" # tanstack-query | swr | rtk-query
+
+  # 로컬 상태
+  local: "useState"        # useState | useReducer
+
+# 파일/폴더 네이밍
+file_naming:
+  # 컴포넌트 파일
+  components: "PascalCase"     # PascalCase | kebab-case | camelCase
+
+  # 훅 파일
+  hooks: "camelCase"           # useXxx 패턴
+
+  # 유틸리티 파일
+  utilities: "camelCase"
+
+  # 상수 파일
+  constants: "SCREAMING_SNAKE_CASE"
+
+  # 테스트 파일
+  tests: "{name}.test.{ext}"   # {name}.test.{ext} | {name}.spec.{ext}
+
+# 폴더 구조
+folder_structure:
+  # 구조 타입
+  type: "feature-based"  # feature-based | type-based | atomic
+
+  # 기본 구조
+  structure: |
+    src/
+    ├── components/     # 공용 컴포넌트
+    ├── features/       # 기능별 모듈
+    │   └── [feature]/
+    │       ├── components/
+    │       ├── hooks/
+    │       ├── utils/
+    │       └── index.ts
+    ├── hooks/          # 공용 훅
+    ├── utils/          # 공용 유틸리티
+    ├── types/          # 타입 정의
+    ├── constants/      # 상수
+    └── styles/         # 전역 스타일
+
+# API 연동 규칙
+api:
+  # HTTP 클라이언트
+  client: "axios"       # axios | fetch | ky
+
+  # API 호출 위치
+  location: "services"  # services | features | hooks
+
+  # 에러 핸들링
+  error_handling: "centralized"  # centralized | per-request
+
+  # 인터셉터 사용
+  interceptors: true
+
+# 에러 처리 규칙
+error_handling:
+  # Error Boundary 사용
+  error_boundary: true
+
+  # 로깅
+  logging: "console"    # console | service | both
+
+  # 사용자 알림
+  user_notification: "toast"  # toast | modal | inline
+
+# 테스트 규칙
+testing:
+  # 테스트 프레임워크
+  framework: "vitest"   # vitest | jest
+
+  # E2E 프레임워크
+  e2e: "playwright"     # playwright | cypress
+
+  # 커버리지 목표
+  coverage_target: 80
+
+  # 필수 테스트
+  required:
+    - "unit"
+    - "integration"
+
+# 코드 품질 규칙
+code_quality:
+  # 린터
+  linter: "eslint"
+
+  # 포매터
+  formatter: "prettier"
+
+  # 타입 체크
+  type_check: "strict"  # strict | loose
+
+  # 커밋 훅
+  commit_hooks: true
+
+# 문서화 규칙
+documentation:
+  # JSDoc 사용
+  jsdoc: true
+
+  # README 필수
+  readme_per_feature: false
+
+  # 컴포넌트 문서
+  component_docs: "storybook"  # storybook | docz | none
+
+# 금지 사항
+prohibited:
+  - "any 타입 사용 (명시적 escape 제외)"
+  - "console.log (개발 중 제외)"
+  - "인라인 스타일 (동적 스타일 제외)"
+  - "매직 넘버/스트링"
+  - "중첩 삼항 연산자"
+  - "var 키워드"
+
+# 권장 사항
+recommended:
+  - "Early return 패턴"
+  - "Descriptive naming"
+  - "Small functions (< 30 lines)"
+  - "Composition over inheritance"
+  - "Immutable data patterns"

package/template/config/mcp_fallbacks.yaml

@@ -0,0 +1,252 @@
+# MCP Fallback Configuration
+# ax-templates-3 MCP 도구 폴백 설정 (Issue #3 해결)
+
+mcp_fallbacks:
+  # 활성화 여부
+  enabled: true
+
+  # 폴백 트리거 조건
+  triggers:
+    - quota_exceeded       # 할당량 초과
+    - service_unavailable  # 서비스 불가
+    - timeout              # 타임아웃
+    - rate_limited         # 요청 제한
+
+# 검색 도구 우선순위
+search:
+  # 코드/문서 검색
+  code_documentation:
+    primary: "context7"
+    fallbacks:
+      - "exa"
+      - "web_search"
+
+    # 폴백 규칙
+    rules:
+      on_quota_exceeded: "use_fallback"
+      on_timeout: "retry_then_fallback"
+      retry_count: 2
+      retry_delay_ms: 1000
+
+  # 웹 검색
+  web_search:
+    primary: "exa"
+    fallbacks:
+      - "web_search"
+
+    rules:
+      on_quota_exceeded: "use_fallback"
+      on_timeout: "use_fallback"
+
+  # Reddit/커뮤니티 검색
+  community:
+    primary: "exa"
+    fallbacks:
+      - "web_search"
+
+    # 커뮤니티 검색 전용 설정
+    settings:
+      include_domains:
+        - "reddit.com"
+        - "news.ycombinator.com"
+        - "dev.to"
+        - "stackoverflow.com"
+
+# 브라우저/웹 도구 우선순위
+browser:
+  primary: "playwright"
+  fallbacks:
+    - "chrome-devtools"
+
+  rules:
+    on_connection_failed: "use_fallback"
+
+# Notion 도구 (폴백 없음)
+notion:
+  primary: "notion"
+  fallbacks: []
+
+  # Notion은 폴백 불가, 에러 시 알림만
+  on_error:
+    action: "notify_user"
+    message: "Notion 연결 실패. MCP 설정을 확인하세요."
+
+# Figma 도구 (폴백 없음)
+figma:
+  primary: "figma-dev-mode"
+  fallbacks: []
+
+  on_error:
+    action: "notify_user"
+    message: "Figma 연결 실패. Dev Mode MCP 설정을 확인하세요."
+
+# 스테이지별 MCP 우선순위
+stage_preferences:
+  "01-brainstorm":
+    search: ["exa", "web_search"]  # 웹 리서치 중심
+    reason: "커뮤니티/아이디어 검색에 Exa 우선"
+
+  "02-research":
+    search: ["context7", "exa", "web_search"]
+    reason: "기술 문서 검색에 Context7 우선"
+
+  "03-planning":
+    search: ["context7", "exa"]
+    reason: "아키텍처 패턴/문서 검색"
+
+  "04-ui-ux":
+    browser: ["figma-dev-mode", "playwright"]
+    search: ["exa", "web_search"]
+    reason: "UI 레퍼런스 검색"
+
+  "06-implementation":
+    search: ["context7"]
+    reason: "라이브러리 문서 검색에 Context7 필수"
+
+  "09-testing":
+    browser: ["playwright", "chrome-devtools"]
+    reason: "E2E 테스트에 Playwright 필수"
+
+# 상태 모니터링
+monitoring:
+  # 할당량 경고
+  quota_warning:
+    threshold_percent: 80
+    action: "warn_user"
+
+  # 사용량 로깅
+  usage_logging:
+    enabled: true
+    log_file: "state/mcp_usage.log"
+
+# 에러 처리
+error_handling:
+  # 모든 폴백 실패 시
+  all_fallbacks_failed:
+    action: "notify_user_and_continue"
+    message: |
+      ⚠️ 모든 MCP 검색 도구가 실패했습니다.
+      - 수동 검색을 진행하거나
+      - MCP 서버 상태를 확인하세요.
+
+  # 복구 불가 에러
+  fatal_error:
+    action: "save_state_and_notify"
+    message: "MCP 치명적 오류. 상태를 저장하고 세션을 재시작하세요."
+
+# =============================================================================
+# AI 모델 폴백 설정 (외부 AI: Gemini, Codex)
+# =============================================================================
+ai_model_fallbacks:
+  enabled: true
+  description: "외부 AI CLI 실패 시 ClaudeCode로 자동 폴백"
+
+  # 폴백 트리거 조건
+  triggers:
+    - cli_not_installed    # CLI 미설치
+    - authentication_failed # 인증 실패
+    - api_timeout          # API 타임아웃
+    - rate_limited         # 요청 제한
+    - service_error        # 서비스 오류
+
+  # 스테이지별 AI 폴백 설정
+  stage_fallbacks:
+    "01-brainstorm":
+      primary: "gemini"
+      fallback: "claudecode"
+      fallback_reason_template: "Gemini CLI 호출 실패: {{ERROR}} - ClaudeCode로 폴백"
+
+    "03-planning":
+      primary: "gemini"
+      fallback: "claudecode"
+      fallback_reason_template: "Gemini CLI 호출 실패: {{ERROR}} - ClaudeCode로 폴백"
+
+    "04-ui-ux":
+      primary: "gemini"
+      fallback: "claudecode"
+      fallback_reason_template: "Gemini CLI 호출 실패: {{ERROR}} - ClaudeCode로 폴백"
+
+    "07-refactoring":
+      primary: "codex"
+      fallback: "claudecode"
+      fallback_reason_template: "Codex CLI 호출 실패: {{ERROR}} - ClaudeCode로 폴백"
+
+    "09-testing":
+      primary: "codex"
+      fallback: "claudecode"
+      fallback_reason_template: "Codex CLI 호출 실패: {{ERROR}} - ClaudeCode로 폴백"
+
+  # 폴백 동작 설정
+  behavior:
+    # 자동 폴백 활성화
+    auto_fallback: true
+
+    # 재시도 설정
+    retry:
+      enabled: true
+      max_attempts: 2
+      delay_ms: 3000
+
+    # 폴백 전 경고 표시
+    show_warning_before_fallback: true
+    warning_message: |
+      ⚠️ 외부 AI {{PRIMARY_MODEL}} 호출 실패
+      - 오류: {{ERROR_MESSAGE}}
+      - 폴백: {{FALLBACK_MODEL}}로 계속 진행
+
+  # 폴백 기록 (HANDOFF.md에 포함)
+  logging:
+    enabled: true
+    log_file: "state/ai_fallback.log"
+    include_in_handoff: true
+
+    # 기록 형식
+    format:
+      timestamp: true
+      stage: true
+      intended_model: true
+      fallback_model: true
+      error_reason: true
+      result: true
+
+    # HANDOFF.md 폴백 섹션 템플릿
+    handoff_template: |
+      ### 폴백 기록
+
+      | 시도한 AI | 실패 시간 | 오류 | 폴백 AI | 결과 |
+      |----------|----------|------|---------|------|
+      {{#each FALLBACK_EVENTS}}
+      | {{this.attempted_model}} | {{this.failure_time}} | {{this.error}} | {{this.fallback_model}} | {{this.result}} |
+      {{/each}}
+
+# 사전 점검 스크립트 통합
+pre_run_check:
+  enabled: true
+  script: "scripts/pre-run-check.sh"
+
+  # 점검 항목
+  checks:
+    - name: "gemini_cli"
+      command: "which gemini"
+      on_failure: "warn"
+      message: "Gemini CLI 미설치 - 01, 03, 04 스테이지에서 ClaudeCode 폴백 예상"
+
+    - name: "codex_cli"
+      command: "which codex"
+      on_failure: "warn"
+      message: "Codex CLI 미설치 - 07, 09 스테이지에서 ClaudeCode 폴백 예상"
+
+    - name: "tmux"
+      command: "which tmux"
+      on_failure: "error"
+      message: "tmux 미설치 - 외부 AI 호출 불가"
+
+    - name: "gemini_wrapper"
+      command: "test -x scripts/gemini-wrapper.sh"
+      on_failure: "warn"
+      message: "gemini-wrapper.sh 실행 불가"
+
+    - name: "codex_wrapper"
+      command: "test -x scripts/codex-wrapper.sh"
+      on_failure: "warn"
+      message: "codex-wrapper.sh 실행 불가"