create-ax-project 1.0.0

package/template/.claude/skills/output-validator/validate.md

@@ -0,0 +1,182 @@
+# Output Validator - Validation Process
+
+## 검증 프로세스
+
+```mermaid
+graph TD
+    A[검증 시작] --> B[스테이지 규칙 로드]
+    B --> C[필수 파일 확인]
+    C --> D{모든 파일 존재?}
+    D -->|No| E[누락 파일 리포트]
+    D -->|Yes| F[내용 검증]
+    F --> G{내용 요구사항 충족?}
+    G -->|No| H[내용 오류 리포트]
+    G -->|Yes| I[명령어 검증]
+    I --> J{모든 명령 통과?}
+    J -->|No| K[명령 실패 리포트]
+    J -->|Yes| L[품질 점수 계산]
+    L --> M[최종 리포트 생성]
+```
+
+## 단계별 검증
+
+### 1. 필수 파일 확인
+
+```yaml
+# 검증 규칙 예시
+required_outputs:
+  ideas.md:
+    exists: true
+    min_size_bytes: 500
+
+  "source_code/":
+    exists: true
+    is_directory: true
+```
+
+**검증 결과**:
+```markdown
+## 파일 존재 확인
+✅ ideas.md (1,234 bytes)
+✅ source_code/ (directory)
+❌ requirements_analysis.md (누락)
+```
+
+### 2. 내용 검증
+
+```yaml
+content_checks:
+  min_ideas: 5
+  sections:
+    - "기능 요구사항"
+    - "비기능 요구사항"
+  has_priorities: true
+```
+
+**검증 방법**:
+- 마크다운 파싱으로 섹션 확인
+- 패턴 매칭으로 필수 요소 확인
+- 카운팅으로 최소 요건 확인
+
+**검증 결과**:
+```markdown
+## 내용 검증
+✅ ideas.md: 8개 아이디어 (최소 5개)
+⚠️ requirements_analysis.md: "비기능 요구사항" 섹션 누락
+✅ project_plan.md: 모든 필수 섹션 포함
+```
+
+### 3. 명령어 검증
+
+```yaml
+validation_commands:
+  - name: "lint"
+    command: "npm run lint"
+    required: true
+    allow_warnings: true
+
+  - name: "typecheck"
+    command: "npm run typecheck"
+    required: true
+
+  - name: "test"
+    command: "npm run test"
+    required: true
+```
+
+**실행 및 결과**:
+```markdown
+## 명령어 검증
+✅ lint: 통과 (경고 2개)
+✅ typecheck: 통과
+❌ test: 실패 (3개 테스트 실패)
+   - tests/auth.test.ts: loginUser should return token
+   - tests/auth.test.ts: logout should clear session
+   - tests/user.test.ts: createUser validation
+```
+
+### 4. 품질 점수 계산
+
+```yaml
+quality_metrics:
+  lint_score:
+    weight: 0.3
+    target: 0.9
+  test_coverage:
+    weight: 0.4
+    target: 0.8
+  type_coverage:
+    weight: 0.3
+    target: 0.95
+```
+
+**계산 결과**:
+```markdown
+## 품질 점수
+| 메트릭 | 현재 | 목표 | 점수 |
+|--------|------|------|------|
+| Lint | 0.95 | 0.90 | ✅ 1.0 |
+| Coverage | 0.75 | 0.80 | ⚠️ 0.94 |
+| Types | 0.98 | 0.95 | ✅ 1.0 |
+
+**종합 점수**: 0.97 (가중 평균)
+**상태**: 통과 (최소 0.7)
+```
+
+## 최종 리포트 형식
+
+```markdown
+# 산출물 검증 리포트
+
+## 스테이지: 06-implementation
+## 검증 시간: 2024-01-20 14:30:00
+
+## 요약
+- **상태**: ⚠️ 부분 통과
+- **종합 점수**: 0.85
+- **통과 항목**: 8/10
+- **실패 항목**: 2
+
+## 상세 결과
+
+### ✅ 통과 항목
+1. 필수 파일 존재
+2. Lint 검사
+3. Type 검사
+...
+
+### ❌ 실패 항목
+1. 테스트 실패 (3개)
+2. 커버리지 미달 (75% < 80%)
+
+## 수정 필요 사항
+1. [ ] tests/auth.test.ts 수정
+2. [ ] 테스트 커버리지 5% 향상
+
+## 권장 조치
+- 실패한 테스트 케이스 확인 및 수정
+- 누락된 테스트 추가
+```
+
+## 실패 시 동작
+
+### 스테이지 전환 차단
+```yaml
+on_failure:
+  action: "block_transition"
+  allow_override: true
+  require_justification: true
+```
+
+### 오버라이드 프롬프트
+```markdown
+⚠️ 검증 실패로 스테이지 전환이 차단되었습니다.
+
+**실패 사항**:
+- 테스트 실패: 3개
+- 커버리지 미달: 75%
+
+강제로 진행하시겠습니까?
+(이유를 입력하세요, 또는 'cancel'로 취소)
+> _
+```

package/template/.claude/skills/smart-handoff/README.md

@@ -0,0 +1,59 @@
+# Smart HANDOFF Skill
+
+스마트 컨텍스트 추출 및 지능형 HANDOFF 생성 스킬
+
+## 개요
+
+이 스킬은 HANDOFF.md 생성 과정을 자동화하고 최적화합니다:
+- 자동 컨텍스트 추출
+- 의미 기반 압축
+- 스테이지별 맞춤 요약
+- 메모리 시스템 통합
+
+## 트리거
+
+- 스테이지 완료 시 자동 활성화
+- `/handoff --smart` 명령어
+- 컨텍스트 임계값 도달 시
+
+## 기능
+
+### 1. 자동 컨텍스트 추출 (extract.md)
+- 완료된 태스크 수집
+- 핵심 결정사항 추출
+- 수정된 파일 목록화
+- 대기 중인 이슈 식별
+- AI 호출 기록 정리
+
+### 2. 컨텍스트 요약 (summarize.md)
+- 완료 작업 → 핵심 성과 압축
+- 파일 변경 → 영향도 분석
+- 결정 사항 → 이유와 대안 포함
+- 다음 단계 → 즉시 실행 가능 형태
+
+### 3. 메모리 통합
+- claude-mem에 핵심 정보 저장
+- 이전 세션 컨텍스트 로드
+- 크로스 스테이지 학습 지원
+
+## 설정
+
+`config/handoff_intelligence.yaml` 참조
+
+## 사용 예시
+
+```bash
+# 스마트 HANDOFF 생성
+/handoff --smart
+
+# 압축된 HANDOFF 생성
+/handoff --smart --compact
+
+# 복구용 상세 HANDOFF 생성
+/handoff --smart --recovery
+```
+
+## 출력
+
+- `stages/{current_stage}/HANDOFF.md`
+- 메모리 저장 (claude-mem 연동 시)

package/template/.claude/skills/smart-handoff/extract.md

@@ -0,0 +1,76 @@
+# Smart HANDOFF - Context Extraction
+
+## 자동 컨텍스트 추출 프로세스
+
+### 1. 완료된 태스크 수집
+
+```markdown
+## 추출 대상
+- TodoWrite 완료 항목
+- 커밋된 변경사항
+- 생성된 산출물
+
+## 형식
+- [ ] 완료된 태스크 (timestamp)
+```
+
+### 2. 핵심 결정사항 추출
+
+대화에서 다음 패턴 감지:
+- "결정했습니다", "선택했습니다", "채택했습니다"
+- "A 대신 B를 사용", "이유는..."
+- 아키텍처/기술 스택 선택
+
+```markdown
+## 결정 형식
+**결정**: [결정 내용]
+**이유**: [선택 이유]
+**대안**: [고려한 대안]
+```
+
+### 3. 수정된 파일 목록화
+
+```bash
+# Git 기반 변경 파일 추출
+git diff --name-only HEAD~10
+```
+
+```markdown
+## 파일 형식
+| 파일 | 변경 유형 | 주요 변경 |
+|------|----------|----------|
+```
+
+### 4. 대기 중인 이슈 식별
+
+감지 패턴:
+- "TODO:", "FIXME:", "HACK:"
+- "나중에", "다음에", "추후"
+- 미해결 에러/경고
+
+```markdown
+## 이슈 형식
+- [ ] 이슈 설명 (우선순위: 높음/중간/낮음)
+```
+
+### 5. AI 호출 기록 정리
+
+```markdown
+## AI 호출 기록
+| AI | 시간 | 목적 | 결과 요약 |
+|----|------|------|----------|
+```
+
+## 추출 우선순위
+
+1. **Critical (100)**: 차단 이슈
+2. **Key Decisions (90)**: 핵심 결정사항
+3. **Pending Issues (80)**: 대기 이슈
+4. **File Changes (70)**: 파일 변경
+5. **Completed Tasks (60)**: 완료 태스크
+6. **AI History (50)**: AI 호출 기록
+
+## 구현
+
+스크립트: `scripts/smart-handoff.sh`
+설정: `config/handoff_intelligence.yaml`

package/template/.claude/skills/smart-handoff/prompts/CLAUDE.md

@@ -0,0 +1,86 @@
+# Smart HANDOFF Skill - AI Instructions
+
+## 역할
+
+당신은 Smart HANDOFF 생성 전문가입니다. 현재 스테이지의 작업을 분석하고, 다음 세션이나 스테이지를 위한 최적화된 HANDOFF를 생성합니다.
+
+## 핵심 원칙
+
+1. **압축성**: 불필요한 정보 제거, 핵심만 유지
+2. **실행 가능성**: 다음 단계가 즉시 실행 가능해야 함
+3. **컨텍스트 보존**: 중요한 결정과 그 이유는 반드시 포함
+4. **연속성**: 이전 작업과 다음 작업의 연결 명확화
+
+## HANDOFF 생성 프로세스
+
+### 1단계: 컨텍스트 수집
+```
+- 완료된 태스크 목록 확인
+- 핵심 결정사항 식별
+- 수정된 파일 파악
+- 대기 중인 이슈 수집
+```
+
+### 2단계: 우선순위 지정
+```
+1. 차단 이슈 (Critical)
+2. 핵심 결정 (High)
+3. 대기 이슈 (Medium)
+4. 파일 변경 (Low)
+5. 완료 태스크 (Context)
+```
+
+### 3단계: 압축 및 요약
+```
+- 원본 토큰의 30% 이내로 압축
+- 중복 정보 제거
+- 핵심 성과로 그룹화
+```
+
+### 4단계: 실행 가능한 다음 단계 작성
+```
+- 구체적인 명령어/파일 경로 포함
+- 의존성/전제 조건 명시
+- 예상 결과물 언급
+```
+
+## 출력 형식
+
+```markdown
+# HANDOFF - {{stage_name}}
+
+## 요약
+[1-2문장으로 스테이지 완료 상태 요약]
+
+## 완료된 작업
+- ✅ [주요 성과 1]
+- ✅ [주요 성과 2]
+
+## 핵심 결정사항
+### [결정 1]
+- **선택**: [선택한 옵션]
+- **이유**: [핵심 근거]
+
+## 수정된 파일
+| 파일 | 변경 |
+|------|------|
+
+## 대기 이슈
+- [ ] [이슈 1] (우선순위)
+
+## 다음 단계
+1. [즉시 실행 가능한 첫 번째 액션]
+2. [두 번째 액션]
+
+## 참조
+- [관련 문서 링크]
+```
+
+## 금지 사항
+
+- 불필요한 세부사항 포함
+- 모호한 다음 단계 (예: "계속 작업")
+- 결정 이유 누락
+- 중복 정보
+
+

package/template/.claude/skills/smart-handoff/summarize.md

@@ -0,0 +1,94 @@
+# Smart HANDOFF - Contextual Summarization
+
+## 자동 요약 생성
+
+### 1. 완료된 작업 → 핵심 성과
+
+**입력**: 상세한 태스크 목록
+**출력**: 압축된 성과 요약
+
+```markdown
+## 변환 예시
+
+### Before (상세)
+- [x] UserService 클래스 생성
+- [x] 로그인 메서드 구현
+- [x] 회원가입 메서드 구현
+- [x] 비밀번호 해시 처리 추가
+- [x] 에러 핸들링 추가
+
+### After (압축)
+✅ **사용자 인증 시스템 구현 완료**
+- UserService: 로그인/회원가입/비밀번호 해시
+```
+
+### 2. 파일 변경 → 영향도 분석
+
+```markdown
+## 영향도 분석 템플릿
+
+### 고영향 변경
+| 파일 | 변경 | 영향 범위 |
+|------|------|----------|
+| src/auth/UserService.ts | 신규 | 인증 전체 |
+
+### 저영향 변경
+- config 파일 업데이트 (3개)
+- 테스트 파일 추가 (2개)
+```
+
+### 3. 결정 사항 → 구조화된 기록
+
+```markdown
+## 결정 기록 형식
+
+### 🔷 [결정 제목]
+- **결정**: [최종 선택]
+- **이유**: [핵심 근거 1-2문장]
+- **영향**: [영향받는 영역]
+```
+
+### 4. 다음 단계 → 즉시 실행 가능 형태
+
+```markdown
+## 다음 단계 형식
+
+### 즉시 실행 (다음 세션 시작 시)
+1. `npm install` - 의존성 설치
+2. `src/components/` 디렉토리에서 작업 재개
+3. UserProfile 컴포넌트 구현
+
+### 참조 필요
+- 아키텍처: `stages/03-planning/outputs/architecture.md`
+- 디자인: `stages/04-ui-ux/outputs/design_system.md`
+```
+
+## 스테이지별 요약 초점
+
+### 01-brainstorm
+- **강조**: 아이디어, 요구사항
+- **약화**: 기술적 세부사항
+
+### 06-implementation
+- **강조**: 코드 변경, 기술 결정
+- **약화**: 아이디어/기획
+
+### 08-qa
+- **강조**: 버그, 테스트 결과
+- **약화**: 계획 세부사항
+
+## 압축 비율
+
+| 원본 토큰 | 목표 압축 | 최대 토큰 |
+|----------|----------|----------|
+| < 2000 | 100% | 2000 |
+| 2000-5000 | 50% | 2500 |
+| 5000-10000 | 30% | 3000 |
+| > 10000 | 25% | 4000 |
+
+## 품질 검증
+
+생성된 요약 검증 기준:
+- **명확성**: 모호한 표현 없음
+- **완전성**: 핵심 정보 누락 없음
+- **실행 가능성**: 다음 단계가 구체적

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

@@ -0,0 +1,84 @@
+# Stage Transition Skill
+
+스테이지 완료 감지 및 전환을 자동화하는 스킬입니다.
+
+## 트리거 조건
+
+이 스킬은 다음 조건에서 자동 활성화됩니다:
+
+1. **완료 표현 감지**
+   - "끝났어", "완료", "done", "finished" 등
+   - 스테이지 관련 작업 종료 시
+
+2. **완료 조건 충족**
+   - outputs 파일 모두 생성됨
+   - config.yaml의 completion_criteria 충족
+
+3. **명시적 호출**
+   - `/handoff` 명령 후
+   - `/next` 명령 전
+
+## 기능
+
+### 1. 완료 조건 검증 (validate.md)
+- 현재 스테이지의 필수 outputs 확인
+- 체크포인트 필수 여부 확인
+- 완료 체크리스트 자동 검증
+
+### 2. HANDOFF.md 생성 (handoff-gen.md)
+- 완료된 작업 요약
+- 핵심 결정사항 추출
+- 다음 단계 안내 생성
+
+### 3. 전환 안내 (prompts/transition.md)
+- 다음 스테이지 정보 제공
+- 입력 파일 위치 안내
+- 단축 명령어 제안
+
+## 스킬 파일 구조
+
+```
+stage-transition/
+├── README.md           # 이 파일
+├── validate.md         # 완료 조건 검증 로직
+├── handoff-gen.md      # 핸드오프 자동 생성
+└── prompts/
+    └── transition.md   # 전환 프롬프트
+```
+
+## 사용 예시
+
+### 자동 트리거
+
+```
+사용자: "브레인스토밍 끝났어"
+
+[stage-transition 스킬 활성화]
+→ 01-brainstorm 완료 조건 검증
+→ HANDOFF.md 생성 제안
+→ 다음 단계 안내
+```
+
+### 검증 결과 예시
+
+```
+✅ 스테이지 완료 조건 확인
+
+현재: 04-ui-ux
+
+[필수 outputs]
+✓ wireframes/ 존재
+✓ component-spec.md 생성됨
+✓ design-system.md 생성됨
+
+[HANDOFF.md]
+⚠️ 아직 생성되지 않음
+
+제안: /handoff 실행 후 /next로 전환하세요.
+```
+
+## 관련 명령어
+
+- `/handoff` - HANDOFF.md 생성
+- `/next` - 다음 스테이지 전환
+- `/status` - 현재 상태 확인