aiwf 0.3.22 → 0.4.0

package/docs/PERFORMANCE_GUIDELINES.md

@@ -1,553 +0,0 @@
-# AIWF 성능 가이드라인
-
-## 개요
-
-이 문서는 AIWF 프로젝트에서 최적의 성능을 얻기 위한 가이드라인과 모범 사례를 제공합니다. 개발자들이 성능을 고려한 코드를 작성하고 시스템을 효율적으로 운영할 수 있도록 돕습니다.
-
-## 1. GitHub API 사용 최적화
-
-### 1.1 캐싱 전략
-
-#### 기본 캐싱 사용법
-
-```javascript
-import { GitHubAPICache, OptimizedGitHubClient } from './lib/cache-system.js';
-
-// 캐시 시스템 초기화
-const githubClient = new OptimizedGitHubClient();
-await githubClient.init();
-
-// 자동 캐싱과 함께 API 호출
-const repoData = await githubClient.cachedFetch('https://api.github.com/repos/user/repo');
-```
-
-#### 캐시 설정 최적화
-
-```javascript
-// 환경별 캐시 설정
-const cacheOptions = {
-    cacheDir: process.env.NODE_ENV === 'production' ? '.aiwf/cache' : '.aiwf/cache-dev',
-    ttl: process.env.NODE_ENV === 'production' ? 300000 : 60000 // 프로덕션: 5분, 개발: 1분
-};
-
-const client = new OptimizedGitHubClient('https://api.github.com', cacheOptions);
-```
-
-### 1.2 배치 처리
-
-#### 여러 API 호출 최적화
-
-```javascript
-// 순차 호출 (비효율적)
-const repos = [];
-for (const repoName of repoNames) {
-    repos.push(await client.cachedFetch(`/repos/user/${repoName}`));
-}
-
-// 배치 처리 (효율적)
-const urls = repoNames.map(name => `/repos/user/${name}`);
-const results = await client.batchRequest(urls, { batchSize: 10 });
-```
-
-### 1.3 Rate Limiting 대응
-
-```javascript
-// Rate Limiter 커스터마이징
-class CustomRateLimiter extends RateLimiter {
-    constructor() {
-        super(60, 60000); // 분당 60개 요청
-    }
-    
-    async waitForNext() {
-        // GitHub API 헤더에서 남은 요청 수 확인
-        const remaining = this.getRemainingRequests();
-        if (remaining < 10) {
-            // 남은 요청이 적으면 더 오래 대기
-            await new Promise(resolve => setTimeout(resolve, 2000));
-        }
-        
-        return super.waitForNext();
-    }
-}
-```
-
-## 2. 파일 시스템 작업 최적화
-
-### 2.1 배치 처리 활용
-
-#### 단일 파일 작업 (비효율적)
-
-```javascript
-// 비효율적인 방법
-for (const filePath of filePaths) {
-    const content = await fs.readFile(filePath, 'utf8');
-    await processFile(content);
-}
-```
-
-#### 배치 처리 (효율적)
-
-```javascript
-import { FileBatchProcessor, FileUtils } from './lib/file-batch-processor.js';
-
-// 효율적인 방법
-const processor = new FileBatchProcessor({
-    maxConcurrency: 5,
-    batchSize: 20
-});
-
-const results = await FileUtils.readMultipleFiles(filePaths, processor);
-```
-
-### 2.2 큰 파일 처리
-
-#### 스트리밍 처리
-
-```javascript
-// 큰 파일은 자동으로 스트리밍 처리됨 (10MB 이상)
-const processor = new FileBatchProcessor();
-
-// 큰 파일 읽기 - 자동으로 스트리밍 사용
-const content = await processor.addReadOperation('/path/to/large/file.txt');
-
-// 큰 파일 쓰기 - 자동으로 스트리밍 사용
-await processor.addWriteOperation('/path/to/output.txt', largeContent);
-```
-
-### 2.3 메모리 효율적인 파일 복사
-
-```javascript
-// 메모리 효율적인 파일 복사
-const fileMappings = {
-    '/source/file1.txt': '/dest/file1.txt',
-    '/source/file2.txt': '/dest/file2.txt'
-};
-
-const results = await FileUtils.copyMultipleFiles(fileMappings, processor);
-```
-
-## 3. 메모리 사용량 최적화
-
-### 3.1 메모리 프로파일링
-
-#### 기본 프로파일링
-
-```javascript
-import { MemoryProfiler } from './lib/memory-profiler.js';
-
-const profiler = new MemoryProfiler({
-    samplingInterval: 1000, // 1초마다 샘플링
-    heapThreshold: 100 * 1024 * 1024 // 100MB 임계값
-});
-
-// 프로파일링 시작
-profiler.startProfiling();
-
-// 작업 실행
-await performWorkload();
-
-// 프로파일링 중지 및 보고서 생성
-profiler.stopProfiling();
-const report = profiler.generateReport();
-console.log('메모리 사용량 보고서:', report);
-```
-
-#### 스냅샷 비교
-
-```javascript
-// 작업 전후 메모리 사용량 비교
-profiler.createSnapshot('before-operation');
-
-// 메모리 집약적인 작업
-await processLargeDataset();
-
-profiler.createSnapshot('after-operation');
-
-// 메모리 변화 분석
-const comparison = profiler.compareSnapshots('before-operation', 'after-operation');
-console.log('메모리 변화:', comparison.memoryDiff);
-```
-
-### 3.2 메모리 누수 방지
-
-#### 객체 추적
-
-```javascript
-// 객체 생성/소멸 추적
-const leakDetector = profiler.objectLeakDetector;
-leakDetector.startTracking();
-
-// 객체 생성 추적
-leakDetector.trackObject('MyClass', 'create');
-
-// 객체 소멸 추적
-leakDetector.trackObject('MyClass', 'destroy');
-
-// 누수 의심 객체 확인
-const leaking = leakDetector.findLeakingObjects(1000);
-if (leaking.length > 0) {
-    console.warn('메모리 누수 의심 객체:', leaking);
-}
-```
-
-#### 가비지 컬렉션 최적화
-
-```javascript
-// 메모리 정리 필요 시 강제 GC 실행
-const gcResult = profiler.forceGarbageCollection();
-if (gcResult) {
-    console.log('GC로 해제된 메모리:', gcResult.freed);
-}
-```
-
-### 3.3 메모리 최적화 제안 활용
-
-```javascript
-import { MemoryOptimizer } from './lib/memory-profiler.js';
-
-// 대용량 파일 처리 최적화
-const fileOptimization = await MemoryOptimizer.optimizeForLargeFiles('/path/to/large/file');
-if (fileOptimization.recommendation === 'streaming') {
-    // 스트리밍 처리 사용
-    console.log('스트리밍 처리 권장:', fileOptimization.reason);
-}
-
-// 데이터 구조 최적화
-const dataOptimization = MemoryOptimizer.optimizeDataStructures(largeArray);
-if (dataOptimization.recommendation !== 'Current data structure is optimal') {
-    console.log('데이터 구조 최적화 제안:', dataOptimization);
-}
-```
-
-## 4. 성능 벤치마킹
-
-### 4.1 기본 벤치마크 실행
-
-```javascript
-import { PerformanceBenchmark, BenchmarkSuites } from './lib/performance-benchmark.js';
-
-const benchmark = new PerformanceBenchmark({
-    iterations: 100,
-    warmupIterations: 10,
-    memoryProfiling: true
-});
-
-// 사전 정의된 테스트 스위트 실행
-const fileOpsSuite = BenchmarkSuites.fileOperations();
-const results = await benchmark.run(fileOpsSuite);
-
-console.log('벤치마크 결과:', results.summary);
-```
-
-### 4.2 커스텀 벤치마크 작성
-
-```javascript
-// 커스텀 테스트 스위트 정의
-const customSuite = {
-    name: 'Custom Performance Tests',
-    tests: [
-        {
-            name: 'Data Processing Performance',
-            fn: async () => {
-                const startTime = performance.now();
-                await processData(testData);
-                const endTime = performance.now();
-                return { duration: endTime - startTime };
-            }
-        },
-        {
-            name: 'Cache Hit Performance',
-            fn: async () => {
-                const cache = new GitHubAPICache();
-                await cache.init();
-                
-                // 캐시에 데이터 저장
-                await cache.set('test-key', testData);
-                
-                const startTime = performance.now();
-                const result = await cache.get('test-key');
-                const endTime = performance.now();
-                
-                return { duration: endTime - startTime, throughput: 1 };
-            }
-        }
-    ]
-};
-
-const customResults = await benchmark.run(customSuite);
-```
-
-### 4.3 부하 테스트
-
-```javascript
-// API 엔드포인트 부하 테스트
-const loadTestResult = await benchmark.runLoadTest({
-    name: 'GitHub API Load Test',
-    target: 'https://api.github.com/repos/user/repo',
-    duration: 60000, // 1분
-    concurrency: 10, // 동시 10개 요청
-    rampUp: 5000 // 5초에 걸쳐 점진적 증가
-});
-
-console.log('부하 테스트 결과:', loadTestResult.metrics);
-```
-
-### 4.4 성능 회귀 감지
-
-```javascript
-// 이전 결과와 비교하여 성능 회귀 감지
-const currentResult = await benchmark.run(testSuite);
-const baselineResult = loadBaselineResults(); // 기준 결과 로드
-
-const regression = benchmark.detectPerformanceRegression(currentResult, baselineResult);
-if (regression.detected) {
-    console.error('성능 회귀 감지:', regression.issues);
-} else {
-    console.log('성능 개선:', regression.improvements);
-}
-```
-
-## 5. 통합 성능 최적화 워크플로우
-
-### 5.1 전체 최적화 프로세스
-
-```javascript
-async function optimizeApplicationPerformance() {
-    // 1. 메모리 프로파일링 시작
-    const profiler = new MemoryProfiler();
-    profiler.startProfiling();
-    
-    // 2. GitHub API 캐싱 설정
-    const githubClient = new OptimizedGitHubClient();
-    await githubClient.init();
-    
-    // 3. 파일 배치 처리 설정
-    const fileProcessor = new FileBatchProcessor({
-        maxConcurrency: 5,
-        batchSize: 20
-    });
-    
-    // 4. 성능 벤치마크 실행
-    const benchmark = new PerformanceBenchmark({
-        iterations: 50,
-        memoryProfiling: true
-    });
-    
-    const suites = [
-        BenchmarkSuites.fileOperations(),
-        BenchmarkSuites.memoryOperations(),
-        BenchmarkSuites.githubAPICache()
-    ];
-    
-    const results = await Promise.all(
-        suites.map(suite => benchmark.run(suite))
-    );
-    
-    // 5. 결과 분석 및 보고서 생성
-    profiler.stopProfiling();
-    const memoryReport = profiler.generateReport();
-    const suggestions = profiler.getOptimizationSuggestions();
-    
-    // 6. 보고서 저장
-    await benchmark.saveReport('./performance-report.json');
-    await benchmark.generateHTMLReport('./performance-report.html');
-    await profiler.saveReport('./memory-report.json');
-    
-    return {
-        performanceResults: results,
-        memoryReport,
-        suggestions,
-        githubStats: githubClient.getStats(),
-        fileProcessorStats: fileProcessor.getStats()
-    };
-}
-```
-
-### 5.2 CI/CD 통합
-
-```javascript
-// CI/CD 파이프라인에서 성능 테스트 실행
-async function runPerformanceTests() {
-    const benchmark = new PerformanceBenchmark();
-    const results = await benchmark.run(BenchmarkSuites.fileOperations());
-    
-    // 성능 기준 확인
-    const avgDuration = results.summary.averageDuration;
-    const threshold = 1000; // 1초
-    
-    if (avgDuration > threshold) {
-        throw new Error(`Performance regression detected: ${avgDuration}ms > ${threshold}ms`);
-    }
-    
-    console.log('✅ Performance tests passed');
-    return results;
-}
-```
-
-## 6. 모니터링 및 경고
-
-### 6.1 실시간 모니터링 설정
-
-```javascript
-// 프로덕션 환경에서 실시간 모니터링
-const productionProfiler = new MemoryProfiler({
-    samplingInterval: 5000, // 5초마다
-    heapThreshold: 500 * 1024 * 1024, // 500MB
-    alertCallback: (alerts) => {
-        // 알림 시스템으로 경고 전송
-        alerts.forEach(alert => {
-            sendAlert(`Memory Alert: ${alert.type}`, alert);
-        });
-    }
-});
-
-productionProfiler.startProfiling();
-```
-
-### 6.2 성능 대시보드
-
-```javascript
-// 성능 메트릭 대시보드용 데이터 생성
-function generateDashboardData() {
-    return {
-        timestamp: Date.now(),
-        memory: process.memoryUsage(),
-        cache: githubClient.getStats(),
-        fileProcessor: fileProcessor.getStats(),
-        uptime: process.uptime()
-    };
-}
-
-// 주기적으로 대시보드 데이터 업데이트
-setInterval(() => {
-    const dashboardData = generateDashboardData();
-    updateDashboard(dashboardData);
-}, 30000); // 30초마다
-```
-
-## 7. 환경별 설정 가이드
-
-### 7.1 개발 환경
-
-```javascript
-const developmentConfig = {
-    github: {
-        cacheDir: '.aiwf/cache-dev',
-        ttl: 60000, // 1분
-        rateLimitPerMinute: 30
-    },
-    fileProcessor: {
-        maxConcurrency: 2,
-        batchSize: 10
-    },
-    memoryProfiler: {
-        samplingInterval: 2000, // 2초
-        alertThreshold: 100 * 1024 * 1024 // 100MB
-    }
-};
-```
-
-### 7.2 프로덕션 환경
-
-```javascript
-const productionConfig = {
-    github: {
-        cacheDir: '.aiwf/cache',
-        ttl: 300000, // 5분
-        rateLimitPerMinute: 60
-    },
-    fileProcessor: {
-        maxConcurrency: 10,
-        batchSize: 50
-    },
-    memoryProfiler: {
-        samplingInterval: 5000, // 5초
-        alertThreshold: 500 * 1024 * 1024 // 500MB
-    }
-};
-```
-
-## 8. 문제 해결 가이드
-
-### 8.1 메모리 사용량 급증
-
-```javascript
-// 메모리 사용량이 급증하는 경우
-if (currentMemoryUsage > threshold) {
-    // 1. 강제 가비지 컬렉션
-    const gcResult = profiler.forceGarbageCollection();
-    
-    // 2. 캐시 정리
-    await githubClient.cleanup();
-    
-    // 3. 임시 파일 정리
-    await MemoryOptimizer.cleanupTemporaryFiles();
-    
-    // 4. 배치 처리 큐 정리
-    fileProcessor.clearQueue();
-}
-```
-
-### 8.2 GitHub API Rate Limit 초과
-
-```javascript
-// Rate limit 초과 시 대응
-client.on('rateLimit', async (resetTime) => {
-    console.log(`Rate limit exceeded. Waiting until ${new Date(resetTime)}`);
-    
-    // 캐시된 데이터 우선 사용
-    const cachedData = await cache.get(url);
-    if (cachedData) {
-        return cachedData;
-    }
-    
-    // Reset 시간까지 대기
-    const waitTime = resetTime - Date.now();
-    await new Promise(resolve => setTimeout(resolve, waitTime));
-});
-```
-
-### 8.3 파일 시스템 성능 저하
-
-```javascript
-// 파일 시스템 성능 저하 시
-if (fileProcessor.getStats().averageProcessingTime > 5000) { // 5초 이상
-    // 1. 동시성 감소
-    fileProcessor.maxConcurrency = Math.max(1, fileProcessor.maxConcurrency / 2);
-    
-    // 2. 배치 크기 감소
-    fileProcessor.batchSize = Math.max(5, fileProcessor.batchSize / 2);
-    
-    // 3. 임시 파일 정리
-    await MemoryOptimizer.cleanupTemporaryFiles();
-}
-```
-
-## 9. 베스트 프랙티스
-
-### 9.1 코드 레벨 최적화
-
-1. **비동기 처리 활용**: Promise.all() 대신 Promise.allSettled() 사용
-2. **메모리 효율적인 데이터 구조**: 큰 데이터셋에는 Map/Set 사용
-3. **스트리밍 처리**: 큰 파일은 항상 스트림으로 처리
-4. **캐시 우선 사용**: API 호출 전 항상 캐시 확인
-
-### 9.2 아키텍처 레벨 최적화
-
-1. **배치 처리 우선**: 개별 작업보다 배치 처리 사용
-2. **적절한 캐시 TTL**: 데이터 성격에 맞는 TTL 설정
-3. **동시성 제어**: 시스템 리소스에 맞는 동시성 수준 설정
-4. **모니터링 필수**: 프로덕션에서 항상 성능 모니터링
-
-### 9.3 운영 레벨 최적화
-
-1. **정기적인 정리**: 캐시, 로그, 임시 파일 정기 정리
-2. **성능 기준 설정**: 명확한 성능 SLA 정의
-3. **알림 시스템**: 성능 저하 시 즉시 알림
-4. **지속적인 개선**: 정기적인 성능 벤치마크 실행
-
-## 결론
-
-AIWF의 성능 최적화는 GitHub API 캐싱, 파일 배치 처리, 메모리 관리, 성능 벤치마킹의 4가지 핵심 영역에서 이루어집니다. 이 가이드라인을 따라 구현하면 대규모 프로젝트에서도 안정적이고 효율적인 성능을 유지할 수 있습니다.
-
-성능 최적화는 지속적인 과정이므로, 정기적인 모니터링과 벤치마킹을 통해 시스템을 개선해 나가는 것이 중요합니다.

package/docs/PRD.ko.md

@@ -1,148 +0,0 @@
-# AIWF - AI 워크플로우 프레임워크
-
-_버전: 0.3.0_
-
-## 개요
-
-모든 프로젝트에 AIWF (AI 워크플로우 프레임워크)를 설치하기 위한 포괄적인 `npx` 실행 가능 커맨드 라인 도구입니다. AI 지원 프로젝트 관리를 위한 구조화된 디렉토리 레이아웃과 커맨드 라인 도구를 제공하며, 다국어(영어 및 한국어)를 완벽하게 지원합니다.
-
-## 핵심 기능
-
-### 설치 명령어
-
-이 도구는 `npx`를 통해 실행됩니다:
-
-```bash
-npx aiwf          # 대화형 언어 선택
-npx aiwf --force  # 프롬프트 건너뛰기 (기본값: 한국어)
-```
-
-### 주요 특징
-
-1.  **다국어 지원**:
-    - 대화형 언어 선택 (영어/한국어)
-    - 언어별 명령어 파일 및 문서
-    - 현지화된 사용자 인터페이스 및 메시지
-
-2.  **디렉토리 구조 생성**:
-    - 문서, 요구사항, 스프린트 등을 위한 표준화된 하위 디렉토리를 포함하는 `.aiwf/` 디렉토리를 초기화합니다
-    - 사용자 지정 Claude 명령어를 위한 `.claude/commands/aiwf/` 디렉토리를 설정합니다
-    - Cursor 및 Windsurf용 IDE별 규칙을 구성합니다
-
-3.  **GitHub에서 파일 가져오기**:
-    - GitHub의 `aiwf/aiwf` 리포지토리에서 최신 프레임워크 파일을 다운로드합니다
-    - `claude-code/aiwf/ko/` 또는 `claude-code/aiwf/en/`에서 언어별 파일을 가져옵니다
-    - 명령어, 문서 템플릿, 프로젝트 매니페스트를 설치합니다
-
-4.  **기존 설치 처리**:
-    - AIWF 프레임워크가 이미 존재하는지 감지합니다
-    - 사용자에게 **업데이트**, **건너뛰기**, 또는 **취소**를 요청합니다
-    - 업데이트 프로세스는 사용자가 생성한 파일(작업, 스프린트)을 보존하면서 명령어 스크립트와 `CLAUDE.md` 문서를 업데이트합니다
-    - 덮어쓴 파일은 타임스탬프가 포함된 `.bak` 확장자로 자동 백업합니다
-
-5.  **IDE 통합**:
-    - Cursor IDE용 규칙을 자동으로 변환하고 설치합니다 (`.mdc` 형식)
-    - 일반 마크다운 규칙으로 Windsurf IDE를 지원합니다
-    - Claude Code와의 원활한 통합
-
-## 기술적 접근 방식
-
-- **Node.js 스크립트**: Node.js로 구축된 단일 실행 스크립트입니다.
-- **의존성**: 커맨드 라인 인터페이스를 향상시키기 위해 외부 라이브러리를 사용합니다:
-  - `commander`: 커맨드 라인 인수 구문 분석용.
-  - `ora`: 로딩 스피너 표시용.
-  - `prompts`: 대화형 사용자 프롬프트용.
-  - `chalk`: 콘솔 출력에 색상 추가용.
-- **GitHub Fetching**: GitHub API를 사용하여 디렉토리 내용을 나열하고, `raw.githubusercontent.com` 소스에서 직접 파일을 다운로드합니다.
-
-## 설치 흐름
-
-1.  환영 메시지가 표시됩니다
-2.  언어 선택 프롬프트 (영어/한국어) - `--force` 플래그 사용 시 제외
-3.  스크립트가 기존 설치를 확인합니다
-4.  설치가 존재하면 사용자에게 작업(업데이트, 건너뛰기, 취소)을 선택하라는 메시지를 표시합니다
-5.  진행 시, 스피너가 GitHub에서 파일을 가져오는 중임을 나타냅니다
-6.  선택한 언어에 따라 필요한 디렉토리 구조가 생성됩니다
-7.  언어별 디렉토리에서 프레임워크 파일(매니페스트, 템플릿, 문서, 명령어)이 다운로드됩니다
-8.  IDE 규칙이 처리되고 설치됩니다 (Cursor/Windsurf)
-9.  시작을 위한 다음 단계와 함께 성공 메시지가 표시됩니다
-10. 단계가 실패하면 오류 메시지가 표시되고 가능한 경우 백업에서 기존 파일이 복원됩니다
-
-## 생성되는 파일 구조
-
-설치 프로그램은 프로젝트에 다음 구조를 생성합니다:
-
-```
-your_project/
-├── .aiwf/                              # AIWF 프로젝트 관리 구조
-│   ├── 00_PROJECT_MANIFEST.md          # 중앙 프로젝트 추적
-│   ├── 01_PROJECT_DOCS/                # 프로젝트 문서
-│   │   └── ARCHITECTURE.md             # 시스템 아키텍처 문서
-│   ├── 02_REQUIREMENTS/                # 마일스톤 기반 요구사항
-│   │   └── M01_*/                      # 마일스톤 폴더
-│   ├── 03_SPRINTS/                     # 스프린트 실행 폴더
-│   │   └── S01_*/                      # 태스크가 포함된 스프린트 폴더
-│   ├── 04_GENERAL_TASKS/               # 스프린트 외 태스크
-│   ├── 98_PROMPTS/                     # 유용한 프롬프트
-│   └── 99_TEMPLATES/                   # 문서 템플릿
-├── .claude/commands/aiwf/              # Claude Code 사용자 정의 명령어
-│   ├── initialize.md                   # 프로젝트 초기화
-│   ├── prime_context.md                # 컨텍스트 로딩
-│   ├── aiwf_create_milestone_plan.md   # 마일스톤 계획
-│   ├── create_sprints_from_milestone.md # 스프린트 생성
-│   ├── do_task.md                      # 태스크 실행
-│   ├── commit.md                       # Git 커밋 워크플로우
-│   ├── yolo.md                         # 자율 실행
-│   └── ... (20개 이상의 추가 명령어)
-├── .cursor/rules/                      # Cursor IDE 통합 (감지된 경우)
-│   ├── code-style-guide.mdc
-│   ├── coding-principles.mdc
-│   └── ... (변환된 규칙)
-└── .windsurf/rules/                    # Windsurf IDE 통합 (감지된 경우)
-    ├── code-style-guide.md
-    ├── coding-principles.md
-    └── ... (일반 마크다운 규칙)
-```
-
-## 상세 기능
-
-### 다국어 지원
-- **언어 선택**: 설치 중 대화형 프롬프트
-- **지원 언어**: 영어 및 한국어
-- **언어별 파일**: 선택한 언어에 따라 명령어와 문서가 설치됨
-- **기본값**: `--force` 플래그 사용 시 한국어로 기본 설정
-
-### 명령어 시스템
-이 프레임워크는 AI 지원 개발을 위한 25개 이상의 전문 명령어를 포함합니다:
-- **설정**: `initialize`, `prime`, `prime_context`
-- **계획**: `aiwf_create_milestone_plan`, `aiwf_create_sprints_from_milestone`, `aiwf_create_sprint_tasks`
-- **개발**: `do_task`, `commit`, `test`, `code_review`
-- **자동화**: `yolo` (자율 태스크 실행)
-- **GitHub 통합**: `issue_create`, `pr_create`
-- **분석**: `ultrathink_*`, `mermaid`, `project_review`
-
-### IDE 통합
-- **Cursor IDE**: 프론트매터가 포함된 `.mdc` 형식으로 규칙 변환
-- **Windsurf IDE**: 일반 마크다운 형식 사용
-- **Claude Code**: 사용자 정의 명령어와의 네이티브 통합
-
-## 현재 상태 (v0.3.0)
-
-### 완료된 기능
-- ✅ NPM 패키지 배포 (`npx aiwf`)
-- ✅ 다국어 지원 (한국어/영어)
-- ✅ IDE 통합 (Cursor, Windsurf)
-- ✅ 25개 이상의 Claude Code 명령어
-- ✅ 백업/복원 메커니즘
-- ✅ GitHub API 통합
-
-### 알려진 이슈
-- `update_docs` 명령어 파일 누락 (`aiwf_docs.md`만 존재)
-- GitHub 저장소 URL이 `aiwf/aiwf`로 통일됨
-
-### 로드맵
-- [ ] 오프라인 설치 옵션
-- [ ] 추가 언어 지원
-- [ ] VS Code 확장
-- [ ] 향상된 프로젝트 템플릿
-- [ ] 사용자 정의 명령어를 위한 커뮤니티 마켓플레이스