aiwf 0.3.7 → 0.3.12

package/.claude/commands/aiwf/aiwf_compress_context.md

@@ -1,116 +0,0 @@
-# Context 압축 - 토큰 절약 실행
-
-토큰 사용량을 줄이기 위해 프로젝트 컨텍스트를 압축합니다. 3단계 압축 모드와 실시간 토큰 모니터링을 제공합니다.
-
-**중요사항:**
-- 기본 모드는 'balanced'로 30-50% 토큰 절약을 목표로 합니다
-- 압축 전후 토큰 사용량과 절약률을 실시간으로 표시합니다
-- 중요한 정보는 모든 모드에서 보존됩니다
-
-## 사용법
-
-```
-/project:aiwf:compress_context [mode] [target]
-```
-
-### 파라미터
-
-- `mode` (선택적): 압축 모드
-  - `aggressive`: 50-70% 토큰 절약 (critical/high 정보만 유지)
-  - `balanced`: 30-50% 토큰 절약 (기본값, medium 이상 정보 유지)
-  - `minimal`: 10-30% 토큰 절약 (모든 정보 유지, 포맷팅만 최적화)
-
-- `target` (선택적): 압축 대상
-  - 파일 경로: 특정 파일 압축
-  - 디렉토리 경로: 디렉토리 내 모든 마크다운 파일 압축
-  - 생략 시: 현재 프로젝트의 주요 문서 압축
-
-## 압축 전략
-
-### Aggressive 모드 (50-70% 압축)
-- Critical/High 중요도 섹션만 유지
-- 코드 예제 대폭 축소
-- 중복 정보 완전 제거
-- Output Log, 히스토리 등 제거
-
-### Balanced 모드 (30-50% 압축)
-- Critical/High/Medium 중요도 섹션 유지
-- 코드 예제 선택적 유지
-- 중복 정보 부분 제거
-- 오래된 로그만 제거
-
-### Minimal 모드 (10-30% 압축)
-- 모든 중요도 유지
-- 공백 및 형식 정리
-- 명백한 중복만 제거
-- 안전한 압축
-
-## 실행 단계
-
-1. **압축 대상 파악**
-   - 대상 파일/디렉토리 확인
-   - 원본 토큰 수 계산
-
-2. **압축 모드 적용**
-   - 선택된 모드에 따라 압축 전략 실행
-   - 중요도 기반 섹션 필터링
-   - 압축 알고리즘 적용
-
-3. **압축 결과 검증**
-   - 압축 후 토큰 수 계산
-   - 절약률 및 품질 점수 표시
-   - Critical 정보 보존 검증
-
-4. **압축 파일 생성**
-   - 압축된 컨텐츠를 새 파일로 저장
-   - 원본 파일은 보존
-   - 압축 메타데이터 기록
-
-## 출력 형식
-
-```
-🗜️ Context 압축 시작
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-압축 모드: balanced
-대상: /workspace/project/.aiwf/
-
-📊 압축 전 통계:
-- 총 파일 수: 15
-- 원본 토큰: 45,320
-- 원본 크기: 125.4 KB
-
-⚙️ 압축 진행 중...
-✓ PROJECT_MANIFEST.md (5,320 → 2,890 토큰, -45.6%)
-✓ ARCHITECTURE.md (8,210 → 4,105 토큰, -50.0%)
-✓ M02_milestone_meta.md (3,450 → 2,070 토큰, -40.0%)
-... [추가 파일들]
-
-📊 압축 후 통계:
-- 압축된 토큰: 27,192
-- 절약된 토큰: 18,128
-- 토큰 절약률: 40.0%
-- 압축 시간: 2.3초
-- 품질 점수: 92/100
-
-✅ 압축 완료!
-압축된 파일 위치: /workspace/project/.aiwf_compressed/
-```
-
-## 품질 보증
-
-- **Critical 정보 보존**: 목표, 요구사항, 승인 기준은 항상 유지
-- **구조 보존**: 문서의 논리적 구조와 계층 유지
-- **가독성 유지**: 압축 후에도 읽기 쉬운 형태 유지
-- **복원 가능**: 압축 메타데이터로 필요시 복원 지원
-
-## 권장 사용 시나리오
-
-1. **대규모 프로젝트 리뷰 시**: aggressive 모드로 핵심만 빠르게 파악
-2. **일반 개발 작업**: balanced 모드로 효율적인 컨텍스트 관리
-3. **디버깅/상세 분석**: minimal 모드로 모든 정보 유지하며 최적화
-
-## 주의사항
-
-- 압축된 파일은 별도 디렉토리에 저장되며 원본은 보존됩니다
-- 압축 시 일부 형식이나 세부 정보가 손실될 수 있습니다
-- Critical로 표시된 정보는 모든 모드에서 보존됩니다

package/.claude/commands/aiwf/aiwf_compress_minimal_persona.md

@@ -1,48 +0,0 @@
-# aiwf compress-minimal-persona
-
-활성화된 페르소나를 고려하여 최소 모드로 컨텍스트를 압축합니다.
-
-## 실행
-
-```javascript
-const { spawn } = require('child_process');
-const path = require('path');
-
-// .aiwf 디렉토리로 이동하여 명령 실행
-const cwd = path.join(process.cwd(), '.aiwf');
-const proc = spawn('node', [
-  '../claude-code/aiwf/ko/commands/compress-context.js',
-  'minimal',
-  '--persona'
-], { cwd, stdio: 'inherit' });
-
-proc.on('error', (err) => {
-  console.error('명령 실행 실패:', err.message);
-});
-```
-
-## 설명
-
-페르소나 특성을 고려하면서도 최소한의 압축만 수행합니다. 10-30%의 낮은 압축률로 원본 내용을 최대한 보존합니다.
-
-### 압축 전략
-
-- 페르소나 관련 패턴은 100% 보존
-- 중복 내용만 제거
-- 불필요한 공백과 포맷팅 정리
-- 페르소나별 중요도 점수가 평균 이상인 섹션은 그대로 유지
-
-## 적합한 사용 사례
-
-- 중요한 기술 문서
-- 상세한 API 문서
-- 보안 관련 문서
-- 데이터 분석 리포트
-
-## 결과
-
-압축 후에도 다음이 보장됩니다:
-- 모든 페르소나 관련 키워드 보존
-- 문서 구조 완전 유지
-- 코드 블록과 예제 보존
-- 테이블과 다이어그램 유지

package/.claude/commands/aiwf/aiwf_compress_stats.md

@@ -1,79 +0,0 @@
-# aiwf compress-stats
-
-페르소나별 압축 통계를 확인합니다.
-
-## 실행
-
-```javascript
-const fs = require('fs');
-const path = require('path');
-const chalk = require('chalk');
-
-// PersonaAwareCompressor import
-const { PersonaAwareCompressor } = require(path.join(
-  process.cwd(), 
-  'claude-code/aiwf/ko/utils/persona-aware-compressor.js'
-));
-
-try {
-  const compressor = new PersonaAwareCompressor();
-  const stats = compressor.getPersonaCompressionStats();
-  
-  console.log(chalk.cyan('📊 페르소나별 압축 통계'));
-  console.log(chalk.gray('━'.repeat(50)));
-  
-  if (stats.currentPersona) {
-    console.log(`현재 페르소나: ${chalk.yellow(stats.currentPersona)}`);
-    
-    if (stats.strategy) {
-      console.log('\n📋 현재 페르소나 압축 전략:');
-      console.log(`- 포커스 영역: ${stats.strategy.focusAreas.join(', ')}`);
-      console.log(`- 요약 초점: ${stats.strategy.summarizationFocus}`);
-      console.log(`- 보존 패턴: ${stats.strategy.preservePatterns.slice(0, 5).join(', ')}...`);
-    }
-  } else {
-    console.log(chalk.yellow('⚠️  활성화된 페르소나가 없습니다.'));
-  }
-  
-  const avgRatios = stats.averageRatioByPersona;
-  if (Object.keys(avgRatios).length > 0) {
-    console.log('\n📈 페르소나별 평균 압축률:');
-    Object.entries(avgRatios).forEach(([persona, ratio]) => {
-      const personaNames = {
-        architect: 'Architect',
-        security: 'Security Expert',
-        frontend: 'Frontend Developer',
-        backend: 'Backend Developer',
-        data_analyst: 'Data Analyst'
-      };
-      console.log(`- ${personaNames[persona] || persona}: ${chalk.green(ratio + '%')}`);
-    });
-  } else {
-    console.log('\n압축 히스토리가 없습니다.');
-  }
-  
-} catch (error) {
-  console.error(chalk.red('오류:'), error.message);
-}
-```
-
-## 설명
-
-페르소나별 압축 통계와 현재 활성화된 페르소나의 압축 전략을 확인합니다.
-
-### 제공 정보
-
-1. **현재 페르소나 정보**
-   - 활성 페르소나 이름
-   - 압축 전략 상세
-   - 보존 패턴 목록
-
-2. **압축 히스토리 통계**
-   - 페르소나별 평균 압축률
-   - 압축 성능 비교
-
-## 활용 방법
-
-- 페르소나별 압축 효율성 비교
-- 최적의 압축 모드 선택
-- 압축 전략 개선점 파악

package/.claude/commands/aiwf/aiwf_compress_with_persona.md

@@ -1,51 +0,0 @@
-# aiwf compress-with-persona
-
-활성화된 페르소나를 고려하여 컨텍스트를 압축합니다.
-
-## 실행
-
-```javascript
-const { spawn } = require('child_process');
-const path = require('path');
-
-// .aiwf 디렉토리로 이동하여 명령 실행
-const cwd = path.join(process.cwd(), '.aiwf');
-const proc = spawn('node', [
-  '../claude-code/aiwf/ko/commands/compress-context.js',
-  'balanced',
-  '--persona'
-], { cwd, stdio: 'inherit' });
-
-proc.on('error', (err) => {
-  console.error('명령 실행 실패:', err.message);
-});
-```
-
-## 설명
-
-현재 활성화된 페르소나의 특성을 고려하여 컨텍스트를 압축합니다. 페르소나별로 중요한 패턴과 키워드를 보존하며, 관련성이 낮은 내용은 더 적극적으로 압축합니다.
-
-### 페르소나별 압축 전략
-
-- **Architect**: 시스템 설계, 아키텍처 패턴 중심 보존
-- **Security**: 보안 경고, 취약점 정보 완전 보존
-- **Frontend**: UI/UX 설명, 시각적 요소 중심 보존
-- **Backend**: API 명세, 데이터베이스 스키마 보존
-- **Data Analyst**: 데이터 설명, 인사이트 완전 보존
-
-## 사용 예시
-
-```bash
-# 기본 모드 (balanced)로 페르소나 인식 압축
-aiwf compress-with-persona
-
-# 다른 압축 모드와 함께 사용
-aiwf compress-aggressive-persona  # aggressive 모드
-aiwf compress-minimal-persona     # minimal 모드
-```
-
-## 참고
-
-- 페르소나가 활성화되지 않은 경우 일반 압축이 수행됩니다
-- 압축된 파일은 `.aiwf_compressed/` 디렉토리에 저장됩니다
-- 페르소나별 중요 패턴 보존율이 리포트에 포함됩니다

package/.claude/commands/aiwf/aiwf_create_feature_ledger.md

@@ -1,54 +0,0 @@
-# Feature Ledger 생성
-
-새로운 Feature Ledger를 생성하여 기능 개발을 추적합니다.
-
-```bash
-cd .aiwf && node ../claude-code/aiwf/ko/commands/feature-ledger.js create "$@"
-```
-
-## 설명
-
-Feature Ledger는 프로젝트의 각 기능 개발을 체계적으로 추적하고 관리하는 시스템입니다. 새로운 기능을 개발하기 시작할 때 이 명령어로 Feature를 생성합니다.
-
-### 🎯 주요 기능
-- 자동 Feature ID 할당 (FL001, FL002...)
-- 표준화된 디렉토리 구조 생성
-- Feature 인덱스 자동 업데이트
-- Git 브랜치 생성 가이드 제공
-
-### 📝 사용법
-```bash
-# 대화형 모드 (권장)
-/project:aiwf:create_feature_ledger
-
-# 직접 이름 지정
-/project:aiwf:create_feature_ledger user_authentication
-/project:aiwf:create_feature_ledger "Dashboard Redesign"
-```
-
-### 📂 생성 위치
-- `.aiwf/06_FEATURE_LEDGERS/active/FL###_feature_name.md`
-- 인덱스 파일 자동 업데이트
-
-### ✅ 생성 과정
-1. 다음 사용 가능한 Feature ID 확인
-2. Feature 메타데이터 입력 받기
-3. Feature 파일 생성
-4. 인덱스 업데이트
-5. Git 브랜치 생성 안내
-
-## 예시 출력
-```
-🎯 Feature Ledger 생성 완료!
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-Feature ID: FL001
-제목: User Authentication System
-상태: active
-우선순위: high
-카테고리: feature
-
-📁 파일 위치: .aiwf/06_FEATURE_LEDGERS/active/FL001_user_authentication.md
-
-💡 다음 단계:
-git checkout -b feature/FL001-user-authentication
-```

package/.claude/commands/aiwf/aiwf_create_general_task.md

@@ -1,147 +0,0 @@
-# 일반 태스크 생성
-
-프로젝트 문서화 표준을 따라 `.aiwf/04_GENERAL_TASKS/`에 새로운 일반 태스크를 생성합니다.
-
-## 정확히 다음 10개 항목으로 할 일 목록을 생성하세요
-
-1. 태스크 인수 분석 및 태스크 ID 결정
-2. 프로젝트 컨텍스트 및 문서화 요구사항 로드
-3. 중복 작업이 없는지 확인
-4. 구현 컨텍스트를 위한 코드베이스 연구
-5. 표준 템플릿을 사용하여 태스크 파일 생성
-6. 적절한 컨텍스트로 태스크 세부사항 작성
-7. 기술 가이드라인 및 코드베이스 참조 추가
-8. 새 태스크로 프로젝트 매니페스트 업데이트
-9. 아키텍처와의 태스크 정렬 검증
-10. 최종 품질 검사 및 보고 수행
-
-## 모든 할 일 항목에 대한 세부사항
-
-### 1. 태스크 인수 분석 및 태스크 ID 결정
-
-인수 형식: `<태스크 제목 또는 설명>`
-
-- 인수가 비어있는 경우, 사용자에게 태스크 세부사항을 요청합니다
-- `.aiwf/04_GENERAL_TASKS/`의 기존 태스크를 확인하여 순차적 태스크 ID를 생성합니다
-- 가장 높은 태스크 번호(T###)를 찾아 1을 증가시킵니다
-- 형식: `T###_<태스크_제목_스네이크_케이스>.md`
-- **중요**: 태스크 ID는 빈 공간 없이 순차적이어야 합니다
-
-### 2. 프로젝트 컨텍스트 및 문서화 요구사항 로드
-
-**병렬 서브에이전트**를 사용하여 프로젝트 컨텍스트를 읽고 이해하세요:
-
-- `.aiwf/00_PROJECT_MANIFEST.md` 읽기 - 현재 프로젝트 상태 파악
-- `.aiwf/01_PROJECT_DOCS/ARCHITECTURE.md` 읽기 - 시스템 제약사항 이해
-- `.aiwf/01_PROJECT_DOCS/LONG_TERM_VISION.md` 읽기 - 미래 방향성 이해
-- `.aiwf/10_STATE_OF_PROJECT/`의 최신 파일들 읽기 - 현재 상태 검토
-- `.aiwf/05_ARCHITECTURE_DECISIONS/`에서 관련 ADR 스캔
-- **중요**: 일반 태스크는 문서화된 아키텍처와 일치해야 합니다
-
-### 3. 중복 작업이 없는지 확인
-
-**포괄적으로 검색**하여 중복 가능성을 찾으세요:
-
-- `.aiwf/04_GENERAL_TASKS/`의 모든 파일 확인
-- `.aiwf/03_SPRINTS/*/T*.md`의 스프린트 태스크 검색
-- 완료된 마일스톤에서 유사한 기능 찾기
-- **중요**: 중복이 발견되면 중단하고 파일 참조와 함께 사용자에게 보고
-
-### 4. 구현 컨텍스트를 위한 코드베이스 연구
-
-태스크 설명을 바탕으로 **병렬 서브에이전트**를 사용하여:
-
-- 태스크가 요구하는 것과 유사한 기존 패턴 검색
-- 영향을 받을 주요 인터페이스, 클래스 또는 모듈 식별
-- 코드베이스에서 유사한 구현 예제 찾기
-- 관련 테스트 패턴 및 기존 테스트 파일 위치 파악
-- 사용되는 오류 처리 및 로깅 패턴 발견
-- 기존 코드와의 통합 지점 매핑
-- **문서화**: 태스크에 포함할 모든 발견사항 기록
-
-### 5. 표준 템플릿을 사용하여 태스크 파일 생성
-
-`.aiwf/99_TEMPLATES/task_template.md`의 태스크 템플릿을 기본 구조로 **사용**하세요:
-
-- 템플릿 구조를 정확히 복사
-- 파일을 `.aiwf/04_GENERAL_TASKS/T###_<제목>.md`에 배치
-- 타임스탬프 포함: 생성 시간을 위해 `date '+%Y-%m-%d %H:%M:%S'` 실행
-- **중요**: 템플릿 구조를 정확히 따르세요 - 변경 없음
-
-### 6. 적절한 컨텍스트로 태스크 세부사항 작성
-
-태스크 파일을 다음 내용으로 채우세요:
-
-- **제목**: 명확하고 실행 가능한 태스크 이름
-- **컨텍스트**: 아키텍처 문서 및 프로젝트 상태에 연결
-- **요구사항**: 구체적이고 측정 가능한 결과
-- **승인 기준**: 완료에 대한 명확한 정의
-- **종속성**: 관련 스프린트/마일스톤 참조
-- **구현 노트**: 아키텍처와 일치하는 기술적 접근법
-- **중요**: 모든 내용은 기존 문서를 참조해야 합니다
-
-### 7. 기술 가이드라인 및 코드베이스 참조 추가
-
-**기술 가이드라인 섹션:**
-
-- 4단계에서 발견한 주요 인터페이스 및 통합 지점
-- 코드베이스의 구체적인 import 및 모듈 참조
-- 따라야 할 기존 패턴 (파일 참조 포함)
-- 작업할 데이터베이스 모델 또는 API 계약
-- 유사한 코드에서 사용되는 오류 처리 접근법
-- 코드베이스에서 발견된 테스트 패턴
-
-**구현 노트 섹션:**
-
-- 연구를 바탕으로 한 단계별 구현 접근법
-- 존중해야 할 주요 아키텍처 결정사항 (ADR 참조)
-- 수정하거나 확장할 구체적인 파일 및 함수
-- 기존 테스트 패턴을 바탕으로 한 테스트 접근법
-- 관련성이 있는 경우 성능 고려사항
-
-**중요**: 코드 예제를 포함하지 마세요. 구조적 가이드라인과 파일 참조만 제공하세요.
-
-### 8. 새 태스크로 프로젝트 매니페스트 업데이트
-
-`.aiwf/00_PROJECT_MANIFEST.md` **업데이트**:
-
-- "## 일반 태스크" 섹션에 태스크 추가
-- 형식: `- [ ] T###: [태스크 제목] - 상태: 시작되지 않음`
-- 알파벳/숫자 순서 유지
-- 태스크 파일에 링크: `[T###](04_GENERAL_TASKS/T###_제목.md)`
-- **중요**: 기존 내용을 모두 보존하세요
-
-### 9. 아키텍처와의 태스크 정렬 검증
-
-태스크 준수사항 **확인**:
-
-- 태스크가 아키텍처 원칙과 모순되지 않는지 확인
-- 구현 접근법이 확립된 패턴을 사용하는지 보장
-- 종속성이 존재하고 올바른지 검증
-- 태스크 범위가 적절한지 확인 (너무 광범위하거나 좁지 않게)
-- 기술 가이드라인이 기존 코드베이스 패턴과 일치하는지 확인
-- **중요**: 문서가 진실의 원천입니다 - 어떤 편차든 정당화가 필요합니다
-
-### 10. 최종 품질 검사 및 보고 수행
-
-**품질 검사**:
-
-- 태스크 파일이 템플릿을 완전히 따르는지 확인
-- 새로운 기술 가이드라인을 포함한 모든 섹션이 적절히 작성되었는지 확인
-- 문서 및 코드베이스에 대한 참조가 유효한지 확인
-- 태스크 ID가 순차적이고 고유한지 확인
-- 매니페스트가 올바르게 업데이트되었는지 확인
-- 기술 가이드라인이 실제 파일과 패턴을 참조하는지 확인
-- 범위 확장이나 아키텍처 위반이 없는지 확인
-
-**출력 형식**:
-
-```markdown
-✅ **생성**: T###\_<제목>.md
-📋 **유형**: 일반 태스크
-🎯 **목적**: [한 줄 요약]
-📚 **참조**: [주요 문서 링크]
-🔧 **주요 통합 지점**: [수정할 주요 파일/모듈]
-🧪 **테스트 접근법**: [따를 테스트 패턴]
-⏭️ **다음 단계**: 태스크 세부사항을 검토하고 `/do_task T###`를 실행하여 시작하세요
-```

package/.claude/commands/aiwf/aiwf_create_milestone_plan.md

@@ -1,194 +0,0 @@
-# 신규 마일스톤 계획 및 생성
-
-상호작용적이고 적응적인 프로세스를 통해 적절한 구조, 문서화, 프로젝트 통합을 갖춘 새로운 마일스톤을 생성합니다.
-
-## 정확히 다음 8개 항목으로 할 일 목록을 생성하세요
-
-1. 인수 분석 및 프로젝트 컨텍스트 파악
-2. 상호작용적 마일스톤 범위 및 정의
-3. 마일스톤 구조 및 명명 결정
-4. 마일스톤 디렉토리 및 메타 파일 생성
-5. 지원 문서 생성 가이드
-6. 마일스톤으로 프로젝트 매니페스트 업데이트
-7. 마일스톤 일관성 및 정렬 검증
-8. 마일스톤 생성 및 다음 단계 보고
-
----
-
-## 1. 인수 분석 및 프로젝트 컨텍스트 파악
-
-**중요**: 추가 인수가 제공됩니다: <$ARGUMENTS>
-
-**병렬 서브에이전트**를 사용하여 다음 작업을 수행하세요:
-
-- 제안된 마일스톤 이름/초점에 대한 인수 분석 (기본값은 대화형 생성)
-- `.aiwf/00_PROJECT_MANIFEST.md`를 읽어 현재 프로젝트 상태 파악
-- `.aiwf/02_REQUIREMENTS/`를 스캔하여 기존 마일스톤과 번호 체계 식별
-- `.aiwf/01_PROJECT_DOCS/ARCHITECTURE.md`를 읽어 프로젝트 범위 이해
-- `.aiwf/10_STATE_OF_PROJECT/`의 최신 프로젝트 리뷰를 확인하여 현재 상태 파악
-- **중요**: 프로젝트 단계를 이해하고 논리적으로 다음에 와야 할 마일스톤 파악
-
-## 2. 상호작용적 마일스톤 범위 및 정의
-
-**대화형 마일스톤 정의:**
-
-인수가 제공된 경우:
-
-- "다음을 위한 마일스톤을 생성하고자 하시는군요: [인수]"
-- "범위를 더 잘 이해해보겠습니다..."
-
-인수가 없는 경우:
-
-- "현재 프로젝트 상태를 바탕으로 다음 마일스톤을 정의해보겠습니다"
-- "현재 [현재 마일스톤]에 있는 것으로 보입니다 - 다음에는 무엇에 집중해야 할까요?"
-
-**상호작용 질문 (컨텍스트에 따라 조정):**
-
-- "이 마일스톤의 주요 목표는 무엇인가요?"
-- "완료되어야 할 핵심 결과물은 무엇인가요?"
-- "특정한 기술적 도전이나 요구사항이 있나요?"
-- "이 마일스톤이 프로젝트를 장기 비전으로 어떻게 발전시킬까요?"
-- "이 마일스톤의 '완료'는 어떤 모습일까요?"
-
-**대화형이고 적응적으로 유지** - 심문하지 말고 필요한 것만 수집하세요
-
-## 3. 마일스톤 구조 및 명명 결정
-
-**마일스톤 세부사항 생성:**
-
-- 기존 마일스톤을 스캔하여 다음 마일스톤 번호 (M##) 결정
-- 사용자 입력에서 설명적 마일스톤 이름 생성
-- 형식: `M##_마일스톤_이름_스네이크_케이스`
-- **중요**: 중복된 마일스톤 번호가 없도록 보장
-- AIWF 규칙을 따르는 명명 검증 (밑줄, 공백 없음)
-
-**사용자와 확인:**
-
-- "마일스톤을 생성하겠습니다: M##\_[이름] - 괜찮으신가요?"
-- 필요시 사용자가 이름이나 번호를 조정할 수 있도록 허용
-
-## 4. 마일스톤 디렉토리 및 메타 파일 생성
-
-**마일스톤 구조 생성:**
-
-- 디렉토리 생성: `.aiwf/02_REQUIREMENTS/M##_마일스톤_이름/`
-- `.aiwf/99_TEMPLATES/milestone_meta_template.md`에서 템플릿 복사
-- 마일스톤 메타 파일 생성: `M##_milestone_meta.md`
-
-**마일스톤 메타 파일 채우기:**
-
-- YAML 프론트매터 작성:
-  - `milestone_id: M##`
-  - `title: [마일스톤 이름]`
-  - `status: pending`
-  - `last_updated: [현재 타임스탬프 YYYY-MM-DD HH:MM]`
-- 사용자 입력을 구조화된 섹션으로 변환:
-  - **목표**: 사용자 논의에서 명확한 목적
-  - **핵심 문서**: PRD 및 SPECS 파일 플레이스홀더
-  - **완료 정의**: 사용자 입력에서 구체적이고 측정 가능한 기준
-  - **노트/컨텍스트**: 사용자 논의에서 추가 컨텍스트
-
-## 5. 지원 문서 생성 가이드
-
-**상호작용적 문서 계획:**
-
-마일스톤 범위를 기반으로 필요한 문서 제안:
-
-- "이 마일스톤에는 다음이 필요할 것 같습니다:"
-- "□ PRD\_[마일스톤_이름].md - 제품 요구사항"
-- "□ SPECS\_[기술_영역].md - 기술 사양"
-- "□ 도메인별 문서"
-
-**사용자에게 문의:**
-
-- "지금 이 문서들의 시작 템플릿을 만들어드릴까요?"
-- "아니면 필요에 따라 수동으로 만드시겠어요?"
-
-**사용자가 템플릿 생성을 원하는 경우:**
-
-- 마일스톤별 섹션이 포함된 기본 PRD 템플릿 생성
-- 기술 마일스톤인 경우 SPECS 템플릿 생성
-- 문서 간 적절한 상호참조 포함
-- **중요**: 과도하게 엔지니어링하지 말고 유용한 시작점 생성
-
-**사용자가 수동을 선호하는 경우:**
-
-- 마일스톤 메타에 예상되는 문서 기록
-- 언제/어떻게 생성할지에 대한 가이드 제공
-
-## 6. 마일스톤으로 프로젝트 매니페스트 업데이트
-
-`.aiwf/00_PROJECT_MANIFEST.md` **업데이트**:
-
-- 마일스톤 섹션에 마일스톤 추가:
-  - 형식: `- [ ] M##: [마일스톤 이름] - 상태: 계획 중`
-  - 링크: `[M##](02_REQUIREMENTS/M##_마일스톤_이름/M##_milestone_meta.md)`
-- 프로젝트 메타데이터 업데이트:
-  - 활성 마일스톤인 경우 `current_milestone` 설정
-  - `highest_milestone` 번호 업데이트
-  - `last_updated` 타임스탬프 업데이트
-- **중요**: 모든 기존 내용과 형식 보존
-
-## 7. 마일스톤 일관성 및 정렬 검증
-
-마일스톤 품질 **확인**:
-
-- 마일스톤이 프로젝트 아키텍처 및 비전과 일치하는지 확인
-- 완료 정의가 구체적이고 측정 가능한지 보장
-- 마일스톤 범위가 적절한지 검증 (너무 광범위하거나 좁지 않게)
-- 마일스톤이 명시된 목표를 향해 프로젝트를 발전시키는지 확인
-- 마일스톤 번호 및 명명이 규칙을 따르는지 확인
-- 생성된 모든 파일이 템플릿 구조를 따르는지 검증
-- **중요**: 마일스톤은 독립적으로 가치 있고 달성 가능해야 함
-
-**고려사항**:
-
-- 현재 프로젝트 상태를 고려할 때 이 마일스톤이 의미가 있는가?
-- 목표가 현실적이고 잘 범위가 정해져 있는가?
-- 완료 정의가 언제 완료되었는지 알 수 있을 만큼 명확한가?
-- 이 마일스톤이 향후 마일스톤을 논리적으로 설정하는가?
-
-## 8. 마일스톤 생성 및 다음 단계 보고
-
-**출력 형식**:
-
-```markdown
-✅ **마일스톤 생성됨**: M##\_[마일스톤_이름]
-
-📋 **마일스톤 세부사항**:
-
-- ID: M##
-- 제목: [마일스톤 이름]
-- 상태: 계획 중
-- 초점: [주요 목표의 한 줄 요약]
-
-📚 **생성된 문서**:
-
-- 마일스톤 메타: `02_REQUIREMENTS/M##_[이름]/M##_milestone_meta.md`
-- [생성된 추가 문서들]
-
-🎯 **완료 정의**:
-
-- [마일스톤의 핵심 DoD 기준]
-
-📈 **프로젝트 영향**:
-
-- 프로젝트를 M[이전]에서 M##로 업데이트
-- 다음을 향한 발전: [프로젝트 비전 정렬]
-
-⏭️ **권장 다음 단계**:
-
-- 마일스톤 세부사항 검토: `02_REQUIREMENTS/M##_[이름]/M##_milestone_meta.md`
-- 계획된 대로 지원 문서 생성
-- 스프린트로 분해: `/project:aiwf:create_sprints_from_milestone M##`
-- 명확해지는 대로 구체적인 요구사항으로 업데이트
-
-🎯 **개발 준비**: 구현 계획을 시작할 준비가 되면 `/project:aiwf:create_sprints_from_milestone M##` 사용
-```
-
-**중요 참고사항**:
-
-- 마일스톤 범위는 집중되고 달성 가능하게 유지
-- 완료 정의는 측정 가능해야 함
-- 지원 문서는 필요에 따라 생성 가능
-- 마일스톤 계획은 반복적 - 더 많이 배우면서 개선