create-ax-project 1.0.0

package/template/.claude/skills/context-compression/analyze.md

@@ -0,0 +1,114 @@
+# Context Analysis Logic
+
+현재 컨텍스트를 분석하여 압축 대상을 식별합니다.
+
+## 분석 프로세스
+
+### 1. 토큰 추정
+
+대화 내용을 카테고리별로 분류하고 토큰을 추정합니다:
+
+```
+토큰 추정 공식:
+- 영어: 단어 수 × 1.3
+- 한국어: 글자 수 × 0.5
+- 코드: 줄 수 × 10
+```
+
+### 2. 카테고리 분류
+
+| 카테고리 | 중요도 | 처리 |
+|----------|--------|------|
+| 결정사항 | 높음 | 유지 |
+| 요구사항 | 높음 | 유지 |
+| 아키텍처 | 높음 | 유지 |
+| 현재 작업 | 높음 | 유지 |
+| 토론/탐색 | 중간 | 요약 |
+| 코드 리뷰 | 중간 | 요약 |
+| 오류 로그 | 낮음 | 제거 |
+| 시행착오 | 낮음 | 제거 |
+
+### 3. 식별 패턴
+
+#### 결정사항 (유지)
+```
+키워드:
+- "결정", "선택", "확정"
+- "~로 하자", "~가 좋겠다"
+- "A 대신 B"
+
+구조:
+- 결정 내용
+- 선택 이유
+- 대안 (간략히)
+```
+
+#### 토론/탐색 (요약)
+```
+키워드:
+- "살펴보자", "검토", "분석"
+- "옵션 1", "옵션 2"
+- "어떻게 생각해?"
+
+압축:
+- 주요 논점만 유지
+- 최종 결론 강조
+- 중간 과정 생략
+```
+
+#### 오류/시행착오 (제거)
+```
+키워드:
+- "에러", "실패", "수정"
+- "다시 시도"
+- "TypeError", "SyntaxError"
+
+예외 (유지):
+- 최종 해결책
+- 반복 가능한 문제
+```
+
+### 4. 분석 결과 형식
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📊 컨텍스트 분석 결과
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+총 추정 토큰: ~65,000
+
+[카테고리별 분포]
+결정사항      ████░░░░░░░░░░░░   5,000 (유지)
+요구사항      ██░░░░░░░░░░░░░░   2,000 (유지)
+현재 작업     ███░░░░░░░░░░░░░   3,000 (유지)
+토론/탐색     ████████████░░░░  40,000 (→ 8,000 요약)
+오류 로그     █████░░░░░░░░░░░  15,000 (제거)
+
+[압축 예상]
+- 압축 전: 65,000 토큰
+- 압축 후: 18,000 토큰
+- 절감: 72%
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+압축하시겠습니까? [Y/n]
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## 자동 분석 트리거
+
+다음 상황에서 자동 분석 실행:
+
+1. **토큰 경고 임계값 도달** (50,000)
+2. **스테이지 전환 전**
+3. **긴 대화 후** (메시지 20개 이상)
+
+## 분석 우선순위
+
+스테이지에 따른 우선순위 조정:
+
+| 스테이지 | 우선 유지 |
+|----------|----------|
+| 01-03 | 결정사항, 요구사항 |
+| 04-05 | 설계 내용, 태스크 |
+| 06-07 | 구현 결정, 코드 패턴 |
+| 08-10 | 이슈, 해결책 |

package/template/.claude/skills/context-compression/compress.md

@@ -0,0 +1,175 @@
+# Context Compression Logic
+
+분석 결과를 바탕으로 컨텍스트를 압축합니다.
+
+## 압축 프로세스
+
+### 1. 유지할 내용 추출
+
+```markdown
+# 유지 항목
+
+## 결정사항
+- [결정 1]: [내용] - [이유]
+- [결정 2]: [내용] - [이유]
+
+## 요구사항
+- [요구사항 목록]
+
+## 아키텍처
+- [주요 아키텍처 선택]
+
+## 현재 작업 상태
+- 스테이지: [현재 스테이지]
+- 진행: [완료/진행중/대기]
+- 다음: [다음 작업]
+```
+
+### 2. 요약할 내용 처리
+
+#### 토론 요약 전략
+
+```
+원본:
+사용자: React와 Vue 중 어떤 게 좋을까?
+AI: React의 장점은... Vue의 장점은... 비교하면...
+사용자: 팀이 React 경험이 많아
+AI: 그렇다면 React가 좋겠습니다. 이유는...
+사용자: React로 하자
+
+압축:
+기술 스택 토론 → React 선택 (팀 경험 기반)
+```
+
+#### 코드 리뷰 요약
+
+```
+원본:
+[긴 코드 diff]
+AI: 이 부분은 최적화가 필요합니다... [상세 설명]
+[수정된 코드]
+
+압축:
+코드 리뷰 완료: [파일명] 최적화 적용
+- 변경: [핵심 변경사항]
+```
+
+### 3. 제거할 내용
+
+완전히 제거되는 항목:
+
+- 오류 메시지 전문 (해결책만 유지)
+- 실패한 시도 과정
+- 임시 디버깅 출력
+- 중복된 코드 표시
+
+### 4. state.md 생성
+
+```markdown
+# 작업 상태 저장 - {{TIMESTAMP}}
+
+## 현재 스테이지
+{{STAGE_ID}}: {{STAGE_NAME}}
+
+## 진행 상황
+- 완료: {{COMPLETED_ITEMS}}
+- 진행 중: {{CURRENT_ITEM}}
+- 대기: {{PENDING_ITEMS}}
+
+## 핵심 결정사항
+
+### 기술 스택
+- 프론트엔드: React + TypeScript
+- 스타일링: Tailwind CSS
+- 상태관리: Zustand
+
+### 아키텍처
+- 컴포넌트 기반 구조
+- 기능별 폴더 구성
+
+## 주요 컨텍스트
+
+### 요구사항 요약
+[핵심 요구사항 3-5개]
+
+### 토론 결과 요약
+[주요 토론 결과]
+
+## 복구 지침
+1. 이 파일 읽기
+2. stages/{{STAGE_ID}}/CLAUDE.md 참조
+3. {{CURRENT_TASK}}부터 재개
+
+## 참조 파일
+- progress.json
+- stages/{{STAGE_ID}}/outputs/
+- 최근 HANDOFF.md
+```
+
+## 압축 실행
+
+### 자동 압축 (80k 도달 시)
+
+```
+⚠️ 토큰 한도 도달 (80,000)
+
+자동 압축 실행 중...
+
+[저장 중]
+✓ 결정사항 추출
+✓ 현재 상태 저장
+✓ state.md 생성
+
+저장 완료: state/context/state.md
+
+/clear 후 복구하려면:
+1. state/context/state.md 읽기
+2. 작업 재개
+```
+
+### 수동 압축
+
+```
+/context --compress
+
+[분석]
+...
+
+[압축 실행]
+✓ 유지 항목 추출: 10,000 토큰
+✓ 요약 생성: 5,000 토큰
+✓ 불필요 항목 제거: 50,000 토큰
+
+[결과]
+- 압축 전: 65,000 토큰
+- 압축 후: 15,000 토큰
+
+state/context/state.md에 저장됨
+```
+
+## 복구 프로세스
+
+### /clear 후 복구
+
+```
+새 세션입니다.
+
+이전 컨텍스트를 복구하시겠습니까?
+저장된 상태: state/context/state.md
+
+[Y] 복구 / [N] 새로 시작
+```
+
+### 복구 시 로드
+
+```
+컨텍스트 복구 중...
+
+[로드된 정보]
+- 스테이지: 06-implementation
+- 진행: 스프린트 1 (3/5 태스크 완료)
+- 결정사항: 5개
+- 다음 작업: T004 사용자 인증 구현
+
+복구 완료. 작업을 계속하시겠습니까?
+```

package/template/.claude/skills/context-compression/prompts/compression.md

@@ -0,0 +1,172 @@
+# Context Compression Prompts
+
+컨텍스트 압축 및 복구 시 사용되는 프롬프트 템플릿입니다.
+
+## 토큰 경고 프롬프트
+
+### 50,000 토큰 (경고)
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+⚠️ 컨텍스트 사용량 경고
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+현재 토큰: ~{{CURRENT_TOKENS}} / 80,000
+상태: {{PERCENTAGE}}% 사용
+
+권장 조치:
+1. /context --compress 로 압축
+2. 또는 /context --save 로 저장 후 /clear
+
+현재 스테이지: {{CURRENT_STAGE}}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### 80,000 토큰 (한도)
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🔴 컨텍스트 한도 도달
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+토큰 한도(80,000)에 도달했습니다.
+
+자동 저장 실행 중...
+
+[저장 내용]
+• 현재 스테이지: {{CURRENT_STAGE}}
+• 진행 상황: {{PROGRESS}}
+• 결정사항: {{DECISION_COUNT}}개
+
+저장 위치: state/context/state.md
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+/clear 후 작업을 계속하려면 state.md를 참조하세요.
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## 압축 결과 프롬프트
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ 컨텍스트 압축 완료
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+[압축 요약]
+• 압축 전: {{BEFORE_TOKENS}} 토큰
+• 압축 후: {{AFTER_TOKENS}} 토큰
+• 절감: {{SAVED_PERCENTAGE}}%
+
+[유지된 항목]
+• 결정사항: {{DECISION_COUNT}}개
+• 요구사항: {{REQUIREMENT_COUNT}}개
+• 현재 작업: {{CURRENT_TASK}}
+
+[요약된 항목]
+• 토론: {{DISCUSSION_COUNT}}개 → {{SUMMARY_COUNT}}개
+• 코드 리뷰: {{REVIEW_COUNT}}개
+
+[제거된 항목]
+• 오류 로그: {{ERROR_COUNT}}개
+• 시행착오: {{RETRY_COUNT}}개
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+저장: state/context/state.md
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## 복구 프롬프트
+
+### 복구 제안
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📂 저장된 컨텍스트 발견
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+저장 시점: {{SAVED_AT}}
+스테이지: {{STAGE}}
+진행 상황: {{PROGRESS_SUMMARY}}
+
+복구하시겠습니까?
+
+[Y] 복구하고 계속
+[N] 새로 시작
+[V] 내용 미리보기
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### 복구 완료
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ 컨텍스트 복구 완료
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+[복구된 상태]
+• 스테이지: {{CURRENT_STAGE}}
+• 진행: {{COMPLETED}}/{{TOTAL}} 완료
+• 다음 작업: {{NEXT_TASK}}
+
+[핵심 결정사항]
+{{#each DECISIONS}}
+• {{this.title}}: {{this.choice}}
+{{/each}}
+
+[참조 파일]
+• stages/{{STAGE}}/CLAUDE.md
+• stages/{{STAGE}}/outputs/
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+{{NEXT_TASK}}부터 계속하시겠습니까?
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## state.md 미리보기 프롬프트
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📄 state.md 미리보기
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+# 작업 상태 저장 - {{TIMESTAMP}}
+
+## 현재 스테이지
+{{STAGE_ID}}: {{STAGE_NAME}}
+
+## 진행 상황
+- 완료: {{COMPLETED_LIST}}
+- 진행 중: {{CURRENT}}
+- 대기: {{PENDING_LIST}}
+
+## 핵심 결정사항
+{{#each DECISIONS}}
+- {{this.title}}: {{this.choice}} ({{this.reason}})
+{{/each}}
+
+...
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+[R] 복구 / [E] 편집 후 복구 / [C] 취소
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## 스테이지 전환 시 압축 제안
+
+```
+스테이지 전환 감지: {{PREV}} → {{NEXT}}
+
+이전 스테이지 컨텍스트를 정리하시겠습니까?
+
+[정리 대상]
+• {{PREV}} 관련 토론: ~{{TOKENS}} 토큰
+• 시행착오 기록: ~{{ERROR_TOKENS}} 토큰
+
+[유지 항목]
+• HANDOFF.md 내용
+• 핵심 결정사항
+
+[Y] 정리 후 전환
+[N] 그대로 전환
+[S] 전체 저장 후 전환
+```

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

@@ -0,0 +1,86 @@
+# Output Validator Skill
+
+스테이지별 산출물 검증 스킬
+
+## 개요
+
+각 스테이지의 산출물이 요구사항을 충족하는지 자동으로 검증합니다:
+- 필수 파일 존재 확인
+- 파일 내용 검증
+- 검증 명령어 실행 (lint, test 등)
+- 품질 점수 계산
+
+## 트리거
+
+- 스테이지 완료 시 자동 실행
+- `/validate` 명령어
+- `/next` 명령어 전 자동 체크
+
+## 기능
+
+### 1. 파일 존재 확인
+```yaml
+required_outputs:
+  ideas.md:
+    exists: true
+    min_size_bytes: 500
+```
+
+### 2. 내용 검증
+```yaml
+content_checks:
+  min_ideas: 5
+  has_sections: ["기능", "비기능"]
+```
+
+### 3. 명령어 검증
+```yaml
+validation_commands:
+  - name: "lint"
+    command: "npm run lint"
+    required: true
+```
+
+### 4. 품질 점수
+```yaml
+quality_metrics:
+  lint_score: 0.9
+  test_coverage: 0.8
+```
+
+## 파일 구조
+
+```
+output-validator/
+├── README.md          # 이 파일
+├── validate.md        # 검증 프로세스 가이드
+└── prompts/
+    └── CLAUDE.md      # AI 지침
+```
+
+## 설정
+
+`config/output_validation.yaml` 참조
+
+## 사용 예시
+
+```bash
+# 현재 스테이지 검증
+/validate
+
+# 특정 스테이지 검증
+/validate --stage 06
+
+# 상세 리포트
+/validate --verbose
+
+# 자동 수정 제안
+/validate --fix
+```
+
+## 출력
+
+- 검증 결과 리포트
+- 품질 점수
+- 수정 제안 (실패 시)
+- `state/validations/` 저장

package/template/.claude/skills/output-validator/prompts/CLAUDE.md

@@ -0,0 +1,119 @@
+# Output Validator Skill - AI Instructions
+
+## 역할
+
+당신은 산출물 검증 전문가입니다. 각 스테이지의 산출물이 품질 기준을 충족하는지 확인하고, 문제 발견 시 구체적인 수정 방안을 제시합니다.
+
+## 검증 원칙
+
+### 1. 완전성 (Completeness)
+- 모든 필수 산출물 존재 확인
+- 필수 섹션/내용 포함 여부
+- 최소 요건 충족 여부
+
+### 2. 정확성 (Correctness)
+- 내용의 기술적 정확성
+- 요구사항과의 일치성
+- 문법/형식 오류 없음
+
+### 3. 실행 가능성 (Executability)
+- 코드 빌드 가능
+- 테스트 통과
+- 린트/타입체크 통과
+
+## 검증 프로세스
+
+### 스테이지 전환 전 검증
+```
+1. 현재 스테이지 규칙 로드
+2. 필수 파일 존재 확인
+3. 파일 내용 검증
+4. 검증 명령어 실행
+5. 품질 점수 계산
+6. 결과 리포트 생성
+```
+
+### 결과에 따른 동작
+```
+통과 (점수 ≥ 0.9): 스테이지 전환 허용
+경고 (0.7 ≤ 점수 < 0.9): 경고 표시 후 허용
+실패 (점수 < 0.7): 전환 차단, 수정 필요
+```
+
+## 리포트 형식
+
+### 간단 요약
+```
+✅ 검증 통과: 06-implementation
+   점수: 0.95 | 통과: 12/12
+```
+
+### 상세 리포트
+```markdown
+# 산출물 검증 리포트
+
+## 요약
+- 스테이지: {{stage_id}}
+- 상태: {{status}}
+- 점수: {{score}}
+
+## 파일 검증
+| 파일 | 상태 | 상세 |
+|------|------|------|
+
+## 명령어 검증
+| 명령 | 결과 | 상세 |
+|------|------|------|
+
+## 수정 필요 사항
+- [ ] 수정 사항 1
+- [ ] 수정 사항 2
+```
+
+## 실패 처리
+
+### 수정 제안
+실패 항목에 대해 구체적인 수정 방안 제시:
+```markdown
+### 실패: 테스트 미통과
+**위치**: tests/auth.test.ts:45
+**원인**: loginUser 함수 반환값 타입 불일치
+**수정 방안**:
+1. UserService.login 반환 타입 확인
+2. 테스트 기대값 수정
+```
+
+### 오버라이드 처리
+사용자가 강제 진행 요청 시:
+```
+1. 이유 입력 요청
+2. 이유 기록 (HANDOFF에 포함)
+3. 경고와 함께 진행 허용
+```
+
+## 스테이지별 검증 초점
+
+### 01-brainstorm
+- 아이디어 다양성
+- 요구사항 구조화
+
+### 06-implementation
+- 코드 빌드 성공
+- 린트/타입체크 통과
+- 기본 테스트 통과
+
+### 09-testing
+- 테스트 커버리지 80% 이상
+- 모든 테스트 통과
+- E2E 테스트 성공
+
+## 금지 사항
+
+- 검증 없이 스테이지 전환 허용
+- 실패 원인 없이 결과만 보고
+- 수정 방안 없이 실패 보고
+- 품질 점수 계산 누락
+
+
+
+