aiwf 0.3.3 → 0.3.4

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

@@ -0,0 +1,116 @@
+# 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

@@ -0,0 +1,48 @@
+# 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

@@ -0,0 +1,79 @@
+# 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

@@ -0,0 +1,51 @@
+# 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

@@ -0,0 +1,54 @@
+# 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

@@ -0,0 +1,147 @@
+# 일반 태스크 생성
+
+프로젝트 문서화 표준을 따라 `.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

@@ -0,0 +1,194 @@
+# 신규 마일스톤 계획 및 생성
+
+상호작용적이고 적응적인 프로세스를 통해 적절한 구조, 문서화, 프로젝트 통합을 갖춘 새로운 마일스톤을 생성합니다.
+
+## 정확히 다음 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##` 사용
+```
+
+**중요 참고사항**:
+
+- 마일스톤 범위는 집중되고 달성 가능하게 유지
+- 완료 정의는 측정 가능해야 함
+- 지원 문서는 필요에 따라 생성 가능
+- 마일스톤 계획은 반복적 - 더 많이 배우면서 개선