create-ax-project 1.0.0

package/template/.claude/skills/stage-transition/handoff-gen.md

@@ -0,0 +1,160 @@
+# HANDOFF.md 자동 생성
+
+스테이지 완료 시 HANDOFF.md를 자동 생성합니다.
+
+## 생성 로직
+
+### 1. 컨텍스트 수집
+
+```
+수집 항목:
+- 현재 스테이지 정보
+- 생성된 outputs 목록
+- 대화에서 추출한 결정사항
+- 다음 스테이지 요구사항
+```
+
+### 2. HANDOFF.md 구조
+
+```markdown
+# Handoff: [현재 스테이지] → [다음 스테이지]
+
+생성일: {{TIMESTAMP}}
+
+## 완료된 작업
+
+- [x] 작업 1
+- [x] 작업 2
+- [x] 작업 3
+
+## 핵심 결정사항
+
+### 결정 1: [제목]
+- **선택**: [선택한 옵션]
+- **이유**: [선택 이유]
+- **영향**: [다음 단계에 미치는 영향]
+
+## 산출물
+
+| 파일 | 설명 |
+|------|------|
+| file1.md | 설명 |
+| file2.json | 설명 |
+
+## 시도했으나 실패한 접근법
+
+(해당 시)
+- 접근법 1: [실패 이유]
+
+## 다음 단계
+
+### 즉시 실행 작업
+1. [작업 1]
+2. [작업 2]
+
+### 참고 파일
+- stages/[current]/outputs/[file]
+
+## 체크포인트
+
+(해당 시)
+- ID: CP-XX-YYYYMMDD-HHMM
+- 설명: [설명]
+```
+
+### 3. 결정사항 추출
+
+대화에서 결정사항을 추출하는 패턴:
+
+```
+키워드:
+- "결정", "선택", "~로 하자", "~가 좋겠다"
+- "A 대신 B", "A보다 B"
+- "최종적으로", "확정"
+
+구조화:
+- 결정 제목
+- 선택한 옵션
+- 선택 이유
+- 대안 (있는 경우)
+```
+
+### 4. 산출물 자동 탐지
+
+```bash
+# outputs 디렉토리 스캔
+find stages/$CURRENT_STAGE/outputs -type f \
+    -name "*.md" -o -name "*.json" -o -name "*.yaml" |
+while read file; do
+    echo "| $(basename $file) | $(head -1 $file | sed 's/^#\s*//') |"
+done
+```
+
+## 생성 예시
+
+### 입력 (대화 컨텍스트)
+
+```
+사용자: React와 Vue 중에 React를 선택했어
+AI: React 기반으로 컴포넌트 명세를 작성했습니다.
+사용자: Tailwind CSS도 추가하자
+AI: design-system.md에 Tailwind 설정을 추가했습니다.
+```
+
+### 출력 (HANDOFF.md)
+
+```markdown
+# Handoff: 04-ui-ux → 05-task-management
+
+생성일: 2024-01-20 15:30
+
+## 완료된 작업
+
+- [x] 와이어프레임 설계
+- [x] 컴포넌트 명세 작성
+- [x] 디자인 시스템 정의
+
+## 핵심 결정사항
+
+### 결정 1: 프론트엔드 프레임워크
+- **선택**: React
+- **이유**: 팀 경험, 생태계 성숙도
+- **영향**: 컴포넌트 기반 아키텍처 적용
+
+### 결정 2: CSS 프레임워크
+- **선택**: Tailwind CSS
+- **이유**: 빠른 프로토타이핑, 일관된 디자인
+- **영향**: utility-first 스타일링
+
+## 산출물
+
+| 파일 | 설명 |
+|------|------|
+| wireframes/home.md | 홈 화면 와이어프레임 |
+| component-spec.md | React 컴포넌트 명세 |
+| design-system.md | Tailwind 기반 디자인 시스템 |
+
+## 다음 단계
+
+### 즉시 실행 작업
+1. tasks.json에 컴포넌트별 태스크 생성
+2. 스프린트 계획 수립
+
+### 참고 파일
+- stages/04-ui-ux/outputs/component-spec.md
+- stages/04-ui-ux/outputs/design-system.md
+```
+
+## 사용자 확인
+
+생성 후 사용자에게 확인 요청:
+
+```
+HANDOFF.md가 생성되었습니다.
+
+[미리보기]
+...
+
+수정이 필요하면 말씀해 주세요.
+확인되면 /next로 다음 스테이지로 전환합니다.
+```

package/template/.claude/skills/stage-transition/prompts/transition.md

@@ -0,0 +1,145 @@
+# Stage Transition Prompt
+
+스테이지 전환 시 사용되는 프롬프트 템플릿입니다.
+
+## 완료 감지 프롬프트
+
+사용자가 완료를 표현했을 때:
+
+```
+스테이지 완료를 감지했습니다.
+
+현재 스테이지: {{CURRENT_STAGE}}
+상태: {{STATUS}}
+
+[완료 조건 검증]
+{{VALIDATION_RESULTS}}
+
+{{#if ALL_PASSED}}
+✅ 모든 조건이 충족되었습니다.
+
+다음 단계:
+1. HANDOFF.md를 생성하시겠습니까? [Y/n]
+2. 또는 /next로 바로 전환
+
+{{else}}
+⚠️ 일부 조건이 충족되지 않았습니다.
+
+필요 작업:
+{{REQUIRED_ACTIONS}}
+
+강제 전환: /next --force (비권장)
+{{/if}}
+```
+
+## 전환 안내 프롬프트
+
+다음 스테이지로 전환할 때:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🔄 스테이지 전환 완료
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+{{PREV_STAGE}} ✅ → {{NEXT_STAGE}} 🔄
+
+[{{NEXT_STAGE}} 스테이지 정보]
+• AI 모델: {{AI_MODEL}}
+• 실행 모드: {{MODE}}
+• 예상 시간: {{ESTIMATED_TIME}}
+
+[입력 파일]
+{{INPUT_FILES}}
+
+[주요 작업]
+{{MAIN_TASKS}}
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+시작 명령어: /{{SHORTCUT}} 또는 /run-stage {{STAGE_NUM}}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## 스테이지별 전환 메시지
+
+### 01 → 02 (brainstorm → research)
+
+```
+🧠 브레인스토밍 완료!
+
+아이디어가 정리되었습니다. 이제 리서치 단계입니다.
+
+다음 작업:
+• ideas.md 기반 기술 조사
+• 경쟁 제품 분석
+• MCP 도구로 최신 정보 수집
+
+시작: /research
+```
+
+### 05 → 06 (task-management → implementation)
+
+```
+📋 태스크 분해 완료!
+
+{{TASK_COUNT}}개 태스크가 {{SPRINT_COUNT}}개 스프린트로 계획되었습니다.
+
+⚠️ 중요: 06-implementation은 체크포인트 필수 스테이지입니다.
+주요 마일스톤마다 /checkpoint를 실행하세요.
+
+다음 작업:
+• 스프린트 1 태스크부터 구현
+• 단위 테스트 함께 작성
+• 마일스톤마다 체크포인트
+
+시작: /implement
+```
+
+### 09 → 10 (testing → deployment)
+
+```
+✅ 테스팅 완료!
+
+테스트 결과:
+• 단위 테스트: {{UNIT_PASS}}/{{UNIT_TOTAL}} 통과
+• E2E 테스트: {{E2E_PASS}}/{{E2E_TOTAL}} 통과
+• 커버리지: {{COVERAGE}}%
+
+🚀 마지막 단계입니다!
+
+다음 작업:
+• CI/CD 파이프라인 설정
+• 환경별 배포 설정
+• 모니터링 구성
+
+시작: /deploy
+```
+
+## 완료 축하 프롬프트
+
+```
+🎉 파이프라인 완료!
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+프로젝트: {{PROJECT_NAME}}
+총 소요 기간: {{DURATION}}
+체크포인트: {{CHECKPOINT_COUNT}}개
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+[스테이지 요약]
+01 ✅ brainstorm     - 아이디어 정립
+02 ✅ research       - 기술 조사
+03 ✅ planning       - PRD 작성
+04 ✅ ui-ux          - 디자인
+05 ✅ task-mgmt      - 태스크 분해
+06 ✅ implementation - 구현
+07 ✅ refactoring    - 리팩토링
+08 ✅ qa             - 품질 검증
+09 ✅ testing        - 테스팅
+10 ✅ deployment     - 배포
+
+[문서]
+• state/handoffs/ - 모든 핸드오프 문서
+• state/checkpoints/ - 체크포인트
+
+수고하셨습니다! 🎊
+```

package/template/.claude/skills/stage-transition/validate.md

@@ -0,0 +1,108 @@
+# Stage Validation Logic
+
+현재 스테이지의 완료 조건을 검증합니다.
+
+## 검증 프로세스
+
+### 1. 현재 스테이지 식별
+
+```bash
+# progress.json에서 현재 스테이지 확인
+CURRENT_STAGE=$(jq -r '.current_stage' state/progress.json)
+```
+
+### 2. 완료 조건 로드
+
+각 스테이지별 필수 outputs:
+
+| 스테이지 | 필수 파일 | 체크포인트 |
+|----------|----------|------------|
+| 01-brainstorm | ideas.md, decisions.md | - |
+| 02-research | research.md, tech-stack.md | - |
+| 03-planning | PRD.md, architecture.md | - |
+| 04-ui-ux | wireframes/, component-spec.md | - |
+| 05-task-management | tasks.json, sprints.md | - |
+| 06-implementation | src/, tests/ | ✅ 필수 |
+| 07-refactoring | src/ (수정됨) | ✅ 필수 |
+| 08-qa | qa-report.md | - |
+| 09-testing | test-results.md | - |
+| 10-deployment | CI/CD 파일 | - |
+
+### 3. 파일 존재 확인
+
+```bash
+STAGE_DIR="stages/$CURRENT_STAGE/outputs"
+
+# 필수 파일 체크
+check_required_files() {
+    local files=("$@")
+    local missing=()
+
+    for file in "${files[@]}"; do
+        if [ ! -e "$STAGE_DIR/$file" ]; then
+            missing+=("$file")
+        fi
+    done
+
+    echo "${missing[@]}"
+}
+```
+
+### 4. 체크포인트 확인 (해당 시)
+
+```bash
+# 06, 07 스테이지는 체크포인트 필수
+if [[ "$CURRENT_STAGE" == "06-"* ]] || [[ "$CURRENT_STAGE" == "07-"* ]]; then
+    STAGE_NUM=$(echo "$CURRENT_STAGE" | cut -d'-' -f1)
+    CP_EXISTS=$(ls -d state/checkpoints/CP-$STAGE_NUM-* 2>/dev/null | head -1)
+
+    if [ -z "$CP_EXISTS" ]; then
+        echo "⚠️ 체크포인트 필수: /checkpoint 실행 필요"
+    fi
+fi
+```
+
+## 검증 결과 형식
+
+### 성공
+
+```
+✅ 스테이지 완료 조건 충족
+
+[04-ui-ux]
+✓ wireframes/ 존재 (3개 파일)
+✓ component-spec.md 생성됨
+✓ design-system.md 생성됨
+
+다음 단계: /next 또는 /tasks
+```
+
+### 실패
+
+```
+⚠️ 스테이지 완료 조건 미충족
+
+[06-implementation]
+✓ src/ 존재
+✓ tests/ 존재
+✗ 체크포인트 없음
+
+필요 작업:
+1. /checkpoint "구현 완료" 실행
+2. /next로 전환
+```
+
+## 자동 액션
+
+검증 결과에 따른 자동 제안:
+
+1. **모든 조건 충족**
+   → HANDOFF.md 생성 제안
+   → `/next` 명령어 안내
+
+2. **일부 조건 미충족**
+   → 누락된 항목 안내
+   → 해결 방법 제안
+
+3. **체크포인트 필요**
+   → `/checkpoint` 명령어 안내