create-ax-project 1.0.0

package/template/stages/10-deployment/templates/github-actions-ci.yaml

@@ -0,0 +1,136 @@
+# GitHub Actions CI Template
+# ax-templates generated
+
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+env:
+  NODE_VERSION: '20'
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run ESLint
+        run: npm run lint
+
+  type-check:
+    name: Type Check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run TypeScript
+        run: npm run type-check
+
+  test:
+    name: Unit Tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests
+        run: npm test -- --coverage
+
+      - name: Upload coverage
+        uses: codecov/codecov-action@v4
+        with:
+          files: ./coverage/lcov.info
+          fail_ci_if_error: false
+
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    needs: [lint, type-check, test]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: build
+          path: .next/
+          retention-days: 1
+
+  e2e:
+    name: E2E Tests
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Install Playwright browsers
+        run: npx playwright install --with-deps
+
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: build
+          path: .next/
+
+      - name: Run E2E tests
+        run: npm run test:e2e
+
+      - name: Upload Playwright report
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: playwright-report
+          path: playwright-report/
+          retention-days: 7

package/template/state/progress.json.template

@@ -0,0 +1,111 @@
+{
+  "pipeline": {
+    "name": "Multi-AI Development Workflow",
+    "version": "1.0.0",
+    "project_name": "{{PROJECT_NAME}}",
+    "started_at": "{{STARTED_AT}}",
+    "updated_at": null,
+    "completed_at": null
+  },
+  "current_stage": null,
+  "stages": {
+    "01-brainstorm": {
+      "status": "pending",
+      "started_at": null,
+      "completed_at": null,
+      "handoff_generated": false,
+      "checkpoint_id": null,
+      "outputs": [],
+      "errors": []
+    },
+    "02-research": {
+      "status": "pending",
+      "started_at": null,
+      "completed_at": null,
+      "handoff_generated": false,
+      "checkpoint_id": null,
+      "outputs": [],
+      "errors": []
+    },
+    "03-planning": {
+      "status": "pending",
+      "started_at": null,
+      "completed_at": null,
+      "handoff_generated": false,
+      "checkpoint_id": null,
+      "outputs": [],
+      "errors": []
+    },
+    "04-ui-ux": {
+      "status": "pending",
+      "started_at": null,
+      "completed_at": null,
+      "handoff_generated": false,
+      "checkpoint_id": null,
+      "outputs": [],
+      "errors": []
+    },
+    "05-task-management": {
+      "status": "pending",
+      "started_at": null,
+      "completed_at": null,
+      "handoff_generated": false,
+      "checkpoint_id": null,
+      "outputs": [],
+      "errors": []
+    },
+    "06-implementation": {
+      "status": "pending",
+      "started_at": null,
+      "completed_at": null,
+      "handoff_generated": false,
+      "checkpoint_id": null,
+      "outputs": [],
+      "errors": []
+    },
+    "07-refactoring": {
+      "status": "pending",
+      "started_at": null,
+      "completed_at": null,
+      "handoff_generated": false,
+      "checkpoint_id": null,
+      "outputs": [],
+      "errors": []
+    },
+    "08-qa": {
+      "status": "pending",
+      "started_at": null,
+      "completed_at": null,
+      "handoff_generated": false,
+      "checkpoint_id": null,
+      "outputs": [],
+      "errors": []
+    },
+    "09-testing": {
+      "status": "pending",
+      "started_at": null,
+      "completed_at": null,
+      "handoff_generated": false,
+      "checkpoint_id": null,
+      "outputs": [],
+      "errors": []
+    },
+    "10-deployment": {
+      "status": "pending",
+      "started_at": null,
+      "completed_at": null,
+      "handoff_generated": false,
+      "checkpoint_id": null,
+      "outputs": [],
+      "errors": []
+    }
+  },
+  "checkpoints": [],
+  "context_snapshots": [],
+  "metadata": {
+    "total_tokens_used": 0,
+    "total_api_calls": 0,
+    "models_used": [],
+    "total_duration_hours": 0
+  }
+}

package/template/state/templates/handoff_base.md.template

@@ -0,0 +1,187 @@
+# Stage Handoff: {{CURRENT_STAGE}} → {{NEXT_STAGE}}
+
+**생성일**: {{TIMESTAMP}}
+**생성자**: {{PRIMARY_AI}}
+**소요 시간**: {{DURATION}}
+
+---
+
+## AI 사용 기록
+
+> 이 섹션은 의도된 AI 설정과 실제 사용을 비교하여 협업 효율성을 추적합니다.
+
+### 의도 vs 실제 비교
+
+| 항목 | 의도 | 실제 | 일치 |
+|------|------|------|------|
+| Primary AI | {{INTENDED_PRIMARY_AI}} | {{ACTUAL_PRIMARY_AI}} | {{PRIMARY_MATCH}} |
+| Secondary AI | {{INTENDED_SECONDARY_AI}} | {{ACTUAL_SECONDARY_AI}} | {{SECONDARY_MATCH}} |
+| 협업 모드 | {{INTENDED_COLLABORATION_MODE}} | {{ACTUAL_COLLABORATION_MODE}} | {{MODE_MATCH}} |
+| 외부 AI 호출 | {{INTENDED_EXTERNAL_CALL}} | {{ACTUAL_EXTERNAL_CALL}} | {{EXTERNAL_MATCH}} |
+
+### 협업 모드 상세
+
+- **설정된 모드**: {{COLLABORATION_MODE}} (parallel/debate/sequential/none)
+- **실제 실행**: {{MODE_EXECUTED}} (예/아니오)
+- **미실행 사유**: {{NON_EXECUTION_REASON}}
+
+### AI 호출 로그
+
+| AI | 호출 시간 | 역할 | 프롬프트 | 결과 | 상태 |
+|----|----------|------|---------|------|------|
+{{#each AI_CALLS}}
+| {{this.model}} | {{this.timestamp}} | {{this.role}} | {{this.prompt_file}} | {{this.output_file}} | {{this.status}} |
+{{/each}}
+
+### 폴백 기록
+
+| 시도한 AI | 실패 시간 | 오류 | 폴백 AI | 결과 |
+|----------|----------|------|---------|------|
+{{#each FALLBACK_EVENTS}}
+| {{this.attempted_model}} | {{this.failure_time}} | {{this.error}} | {{this.fallback_model}} | {{this.result}} |
+{{/each}}
+
+> 설정: `config/ai_collaboration.yaml`, `config/mcp_fallbacks.yaml`
+
+---
+
+## 완료된 작업
+
+{{#each COMPLETED_TASKS}}
+- [x] {{this.name}} {{#if this.ai}}({{this.ai}}){{/if}}
+{{/each}}
+
+---
+
+## 다음 에이전트를 위한 컨텍스트
+
+### 핵심 결정사항
+
+{{#each KEY_DECISIONS}}
+- **{{this.topic}}**: {{this.decision}}
+  - 이유: {{this.rationale}}
+  - 대안: {{this.alternatives}}
+{{/each}}
+
+### 수정된 파일
+
+| 파일 | 변경 유형 | 변경 줄 수 | 담당 AI |
+|------|----------|----------|---------|
+{{#each MODIFIED_FILES}}
+| `{{this.path}}` | {{this.change_type}} | {{this.lines_changed}} | {{this.ai_model}} |
+{{/each}}
+
+### 알려진 이슈 / 기술 부채
+
+{{#each KNOWN_ISSUES}}
+- **{{this.id}}**: {{this.description}}
+  - 심각도: {{this.severity}}
+  - 상태: {{this.status}}
+{{/each}}
+
+---
+
+## 테스트 상태 (Test-First 플로우)
+
+> ⚠️ 이 스테이지에서 테스트가 실행되었는지 확인하세요.
+
+### 실행된 테스트
+
+| 테스트 유형 | 실행 시간 | 결과 | 커버리지 |
+|-----------|----------|------|---------|
+{{#each TESTS_RUN}}
+| {{this.type}} | {{this.timestamp}} | {{this.result}} | {{this.coverage}} |
+{{/each}}
+
+### 스모크 테스트 결과
+
+- **`npm run dev` 실행**: {{DEV_SERVER_STATUS}}
+- **기본 동작 확인**: {{BASIC_FUNCTIONALITY}}
+- **Playwright 스모크 테스트**: {{PLAYWRIGHT_SMOKE}}
+
+### 발견된 버그
+
+{{#each BUGS_FOUND}}
+- **{{this.id}}**: {{this.description}}
+  - 발견 시점: {{this.found_at}}
+  - 상태: {{this.status}}
+  - 수정 파일: {{this.fix_file}}
+{{/each}}
+
+---
+
+## 체크포인트 정보
+
+| ID | 생성일 | 설명 | 자동/수동 |
+|----|--------|------|----------|
+{{#each CHECKPOINTS}}
+| {{this.id}} | {{this.date}} | {{this.description}} | {{this.type}} |
+{{/each}}
+
+복구 명령:
+```bash
+scripts/restore-checkpoint.sh {{LATEST_CP_ID}}
+```
+
+---
+
+## 생성된 산출물
+
+| 파일 | 설명 | 검증 상태 |
+|------|------|----------|
+{{#each OUTPUTS}}
+| {{this.path}} | {{this.description}} | {{this.validation_status}} |
+{{/each}}
+
+---
+
+## {{NEXT_STAGE}} 스테이지 가이드
+
+### 즉시 실행할 작업
+
+{{#each IMMEDIATE_TASKS}}
+{{this.order}}. {{this.task}}
+{{/each}}
+
+### 주의사항
+
+{{#each WARNINGS}}
+- ⚠️ {{this}}
+{{/each}}
+
+### 참조 파일
+
+{{#each REFERENCE_FILES}}
+- `{{this}}`
+{{/each}}
+
+---
+
+## 메타데이터
+
+```yaml
+stage: "{{CURRENT_STAGE}}"
+status: "completed"
+next_stage: "{{NEXT_STAGE}}"
+timestamp: "{{TIMESTAMP}}"
+
+ai_usage:
+  intended:
+    primary: "{{INTENDED_PRIMARY_AI}}"
+    secondary: "{{INTENDED_SECONDARY_AI}}"
+    collaboration_mode: "{{INTENDED_COLLABORATION_MODE}}"
+  actual:
+    primary: "{{ACTUAL_PRIMARY_AI}}"
+    secondary: "{{ACTUAL_SECONDARY_AI}}"
+    collaboration_mode: "{{ACTUAL_COLLABORATION_MODE}}"
+  fallbacks: {{FALLBACK_COUNT}}
+  match_rate: "{{MATCH_RATE}}"
+
+testing:
+  smoke_test_run: {{SMOKE_TEST_RUN}}
+  bugs_found: {{BUGS_FOUND_COUNT}}
+  bugs_fixed: {{BUGS_FIXED_COUNT}}
+
+checkpoint_id: "{{LATEST_CP_ID}}"
+files_modified: {{FILE_COUNT}}
+```

package/template/state/templates/phase_state.md.template

@@ -0,0 +1,97 @@
+# 작업 상태 저장 - {{TIMESTAMP}}
+
+## 컨텍스트 상태
+- **남은 컨텍스트**: {{REMAINING_PERCENT}}%
+- **저장 트리거**: {{TRIGGER_REASON}}
+
+---
+
+## 현재 스테이지
+**{{STAGE_ID}}**: {{STAGE_NAME}}
+
+## 스테이지 진행률
+- 전체 태스크: {{TOTAL_TASKS}}
+- 완료: {{COMPLETED_TASKS}}
+- 진행률: {{PROGRESS_PERCENT}}%
+
+---
+
+## 완료된 태스크
+{{#each COMPLETED_ITEMS}}
+- [x] {{this.name}} ({{this.completed_at}})
+{{/each}}
+
+## 진행 중인 태스크
+{{#each IN_PROGRESS_ITEMS}}
+- [ ] **{{this.name}}**
+  - 시작: {{this.started_at}}
+  - 상태: {{this.status_detail}}
+{{/each}}
+
+## 대기 중인 태스크
+{{#each PENDING_ITEMS}}
+- [ ] {{this.name}}
+{{/each}}
+
+---
+
+## 핵심 컨텍스트
+
+### 주요 결정사항
+{{#each KEY_DECISIONS}}
+- **{{this.topic}}**: {{this.decision}}
+  - 이유: {{this.rationale}}
+{{/each}}
+
+### 수정된 파일
+{{#each MODIFIED_FILES}}
+- `{{this.path}}` - {{this.change_type}} ({{this.lines_changed}} lines)
+{{/each}}
+
+### 활성 이슈/버그
+{{#each ACTIVE_ISSUES}}
+- {{this.description}}
+  - 상태: {{this.status}}
+{{/each}}
+
+---
+
+## AI 호출 기록
+| AI | 시간 | 프롬프트 파일 | 결과 파일 |
+|----|------|--------------|----------|
+{{#each AI_CALLS}}
+| {{this.model}} | {{this.timestamp}} | {{this.prompt_file}} | {{this.output_file}} |
+{{/each}}
+
+---
+
+## 복구 지침
+
+### 즉시 실행 (세션 복구 시)
+1. 이 파일 읽기: `state/context/{{FILENAME}}`
+2. 현재 HANDOFF 참조: `{{HANDOFF_FILE}}`
+3. 다음 태스크부터 재개: **{{NEXT_TASK}}**
+
+### 컨텍스트 복원 우선순위
+1. 현재 스테이지 `CLAUDE.md` 로드
+2. 이전 스테이지 `HANDOFF.md` 참조
+3. 활성 태스크 상태 확인
+4. 수정 중인 파일 열기
+
+### 추가 참조 파일
+{{#each REFERENCE_FILES}}
+- `{{this}}`
+{{/each}}
+
+---
+
+## 메타데이터
+```json
+{
+  "created_at": "{{TIMESTAMP}}",
+  "stage_id": "{{STAGE_ID}}",
+  "remaining_context_percent": {{REMAINING_PERCENT}},
+  "trigger": "{{TRIGGER_REASON}}",
+  "recovery_priority": "{{RECOVERY_PRIORITY}}"
+}
+```