aiwf 0.3.7 → 0.3.8

package/.aiwf/03_SPRINTS/S03_M02_ecosystem_integration/T98_S03_first_task.md

@@ -0,0 +1,39 @@
+# T98: First Task
+
+**스프린트**: S03
+**생성일**: 2025-07-20 15:24
+**상태**: pending
+**우선순위**: medium
+**예상 시간**: TBD
+
+## 개요
+
+[태스크에 대한 간단한 설명을 작성하세요]
+
+## 요구사항
+
+- [ ] [구체적인 요구사항 1]
+- [ ] [구체적인 요구사항 2]
+- [ ] [구체적인 요구사항 3]
+
+## 승인 기준
+
+- [ ] [완료 조건 1]
+- [ ] [완료 조건 2]
+- [ ] [완료 조건 3]
+
+## 기술 가이드라인
+
+- [관련 아키텍처 결정 참조]
+- [기존 코드베이스 패턴 참조]
+- [사용할 기술 스택]
+
+## 구현 노트
+
+- [구현 시 고려사항]
+- [잠재적 리스크]
+- [테스트 전략]
+
+## 참조
+
+- [관련 문서나 코드 링크]

package/.aiwf/03_SPRINTS/S03_M02_ecosystem_integration/T99_S03_test_task.md

@@ -0,0 +1,39 @@
+# T99: Test Task
+
+**스프린트**: S03
+**생성일**: 2025-07-20 15:24
+**상태**: pending
+**우선순위**: medium
+**예상 시간**: TBD
+
+## 개요
+
+[태스크에 대한 간단한 설명을 작성하세요]
+
+## 요구사항
+
+- [ ] [구체적인 요구사항 1]
+- [ ] [구체적인 요구사항 2]
+- [ ] [구체적인 요구사항 3]
+
+## 승인 기준
+
+- [ ] [완료 조건 1]
+- [ ] [완료 조건 2]
+- [ ] [완료 조건 3]
+
+## 기술 가이드라인
+
+- [관련 아키텍처 결정 참조]
+- [기존 코드베이스 패턴 참조]
+- [사용할 기술 스택]
+
+## 구현 노트
+
+- [구현 시 고려사항]
+- [잠재적 리스크]
+- [테스트 전략]
+
+## 참조
+
+- [관련 문서나 코드 링크]

package/.aiwf/test-results-s02.json

@@ -4,27 +4,27 @@
     {
       "name": "Persona Switching Time",
       "status": "passed",
-      "executionTime": 0.303858287,
+      "executionTime": 0.3037124869999998,
       "criteria": "< 2 seconds"
     },
     {
       "name": "Pre-commit Hook Installation",
       "status": "passed",
-      "executionTime": 0.007028295000000071,
+      "executionTime": 0.02001247400000011,
       "criteria": "Hook installed or installable"
     },
     {
       "name": "Multi-language Support",
       "status": "passed",
-      "executionTime": 0.0037783789999994042,
+      "executionTime": 0.000359030999999959,
       "criteria": "Korean/English commands"
     },
     {
       "name": "Performance Baseline",
       "status": "passed",
-      "executionTime": 0.0728547009999993,
+      "executionTime": 0.05356764800000019,
       "criteria": "< 5 seconds total",
-      "actualValue": "0.07s"
+      "actualValue": "0.05s"
     }
   ],
   "summary": {

package/.claude/commands/aiwf/aiwf_compress_aggressive_persona.md

@@ -4,21 +4,9 @@
 
 ## 실행
 
-```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',
-  'aggressive',
-  '--persona'
-], { cwd, stdio: 'inherit' });
-
-proc.on('error', (err) => {
-  console.error('명령 실행 실패:', err.message);
-});
+```bash
+# AIWF CLI를 사용하여 페르소나 인식 공격적 압축 실행
+aiwf compress aggressive --persona
 ```
 
 ## 설명

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

@@ -4,21 +4,8 @@
 
 ## 실행
 
-```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);
-});
+```bash
+aiwf compress minimal --persona
 ```
 
 ## 설명

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

@@ -4,57 +4,8 @@
 
 ## 실행
 
-```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);
-}
+```bash
+aiwf compress stats
 ```
 
 ## 설명

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

@@ -4,21 +4,8 @@
 
 ## 실행
 
-```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);
-});
+```bash
+aiwf compress balanced --persona
 ```
 
 ## 설명
@@ -37,11 +24,11 @@ proc.on('error', (err) => {
 
 ```bash
 # 기본 모드 (balanced)로 페르소나 인식 압축
-aiwf compress-with-persona
+aiwf compress balanced --persona
 
 # 다른 압축 모드와 함께 사용
-aiwf compress-aggressive-persona  # aggressive 모드
-aiwf compress-minimal-persona     # minimal 모드
+aiwf compress aggressive --persona  # aggressive 모드
+aiwf compress minimal --persona     # minimal 모드
 ```
 
 ## 참고

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

@@ -3,7 +3,7 @@
 새로운 Feature Ledger를 생성하여 기능 개발을 추적합니다.
 
 ```bash
-cd .aiwf && node ../claude-code/aiwf/ko/commands/feature-ledger.js create "$@"
+aiwf feature create "$@"
 ```
 
 ## 설명

package/.claude/commands/aiwf/aiwf_default_mode.md

@@ -3,7 +3,7 @@
 AI를 기본 모드로 복원합니다.
 
 ```bash
-cd .aiwf && node ../claude-code/aiwf/ko/commands/ai-persona.js default
+aiwf persona default
 ```
 
 ## 설명

package/.claude/commands/aiwf/aiwf_evaluate.md

@@ -4,22 +4,9 @@ AI 응답 품질을 간단하게 평가합니다.
 
 ## 실행
 
-```javascript
-const { spawn } = require('child_process');
-const path = require('path');
-
-// .aiwf 디렉토리로 이동하여 명령 실행
-const cwd = path.join(process.cwd(), '.aiwf');
-const args = process.argv.slice(2); // 추가 인자 전달
-
-const proc = spawn('node', [
-  '../claude-code/aiwf/ko/commands/evaluate.js',
-  ...args
-], { cwd, stdio: 'inherit' });
-
-proc.on('error', (err) => {
-  console.error('명령 실행 실패:', err.message);
-});
+```bash
+# AIWF CLI를 사용하여 평가 실행
+aiwf evaluate [options]
 ```
 
 ## 설명

package/.claude/commands/aiwf/aiwf_get_feature_details.md

@@ -3,7 +3,7 @@
 특정 Feature Ledger의 상세 정보를 확인합니다.
 
 ```bash
-cd .aiwf && node ../claude-code/aiwf/ko/commands/feature-ledger.js details "$@"
+aiwf feature details "$@"
 ```
 
 ## 설명

package/.claude/commands/aiwf/aiwf_link_feature_to_milestone.md

@@ -3,7 +3,7 @@
 Feature Ledger를 마일스톤 및 스프린트와 연결합니다.
 
 ```bash
-cd .aiwf && node ../claude-code/aiwf/ko/commands/feature-ledger.js link-milestone "$@"
+aiwf feature link-milestone "$@"
 ```
 
 ## 설명

package/.claude/commands/aiwf/aiwf_list_features.md

@@ -3,7 +3,7 @@
 Feature Ledger 목록을 다양한 필터와 형식으로 조회합니다.
 
 ```bash
-cd .aiwf && node ../claude-code/aiwf/ko/commands/feature-ledger.js list "$@"
+aiwf feature list "$@"
 ```
 
 ## 설명

package/.claude/commands/aiwf/aiwf_switch_language.md

@@ -1,160 +1,88 @@
 # AIWF 언어 전환
 
-사용자가 AIWF 프레임워크의 언어 설정을 변경할 수 있도록 하는 명령어입니다.
+AIWF 프레임워크의 언어 설정을 변경합니다.
 
 ## 사용법
 
-이 명령어는 다음과 같은 경우에 사용됩니다:
-- 현재 언어 설정을 다른 언어로 변경하고 싶은 경우
-- 언어 설정 상태를 확인하고 싶은 경우
-- 언어 감지 문제를 해결하고 싶은 경우
-
-## 파라미터
-
-- `<언어코드>` (선택사항): 변경할 언어 (`ko` 또는 `en`)
-- 파라미터 없이 실행하면 현재 언어 상태를 표시
-
-## 실행 단계
-
-### 1. 현재 언어 상태 확인
-
-먼저 현재 언어 설정 상태를 확인합니다:
-
 ```bash
-node -e "
-import('./language-utils.js').then(async ({ getLanguageStatus }) => {
-  const status = await getLanguageStatus();
-  console.log('=== AIWF 언어 설정 상태 ===');
-  console.log('감지된 언어:', status.detectedLanguage);
-  console.log('설정된 언어:', status.configuredLanguage || '없음');
-  console.log('현재 사용 언어:', status.effectiveLanguage);
-  console.log('자동 감지:', status.autoDetect ? '활성화' : '비활성화');
-  console.log('폴백 언어:', status.fallbackLanguage);
-  console.log('설정 파일 경로:', status.configPath);
-  if (status.error) console.log('오류:', status.error);
-});
-"
-```
-
-### 2. 인수 분석
-
-`<$ARGUMENTS>` 값을 확인하여 다음 중 하나를 수행합니다:
-
-- **인수 없음**: 현재 상태만 표시하고 종료
-- **유효한 언어코드 (`ko` 또는 `en`)**: 해당 언어로 전환
-- **무효한 인수**: 오류 메시지 표시 후 사용법 안내
+# 현재 언어 상태 확인
+aiwf-lang status
 
-### 3. 언어 전환 실행
+# 한국어로 전환
+aiwf-lang set ko
 
-유효한 언어코드가 제공된 경우 언어를 전환합니다:
+# 영어로 전환
+aiwf-lang set en
 
-```bash
-node -e "
-import('./language-utils.js').then(async ({ switchLanguage }) => {
-  const targetLanguage = process.argv[1];
-  const result = await switchLanguage(targetLanguage);
-  
-  if (result.success) {
-    console.log('✅ 언어 전환 성공!');
-    console.log('이전 언어:', result.previousLanguage);
-    console.log('새 언어:', result.newLanguage);
-    console.log('메시지:', result.message);
-  } else {
-    console.error('❌ 언어 전환 실패:', result.error);
-    console.log('메시지:', result.message);
-  }
-});
-" -- $ARGUMENTS
+# 언어 설정 초기화 (자동 감지로 되돌림)
+aiwf-lang reset
 ```
 
-### 4. 전환 후 검증
+## 설명
 
-언어 전환 후 설정이 제대로 적용되었는지 확인합니다:
+이 명령어는 다음과 같은 경우에 사용됩니다:
+- 현재 언어 설정을 다른 언어로 변경하고 싶은 경우
+- 언어 설정 상태를 확인하고 싶은 경우
+- 언어 감지 문제를 해결하고 싶은 경우
 
-```bash
-node -e "
-import('./language-utils.js').then(async ({ getLanguageStatus }) => {
-  const status = await getLanguageStatus();
-  console.log('\n=== 전환 후 언어 설정 상태 ===');
-  console.log('현재 사용 언어:', status.effectiveLanguage);
-  console.log('설정 파일:', status.configuredLanguage ? '저장됨' : '없음');
-});
-"
-```
+## 지원 언어
 
-### 5. 명령어 경로 테스트
+- `ko` - 한국어
+- `en` - 영어
 
-새 언어로 명령어 경로가 제대로 해결되는지 테스트합니다:
+## 사용 예시
 
+### 현재 상태 확인
 ```bash
-node -e "
-import('./language-utils.js').then(async ({ resolveCommandPath, detectLanguage }) => {
-  const currentLang = await detectLanguage();
-  const testCommands = ['aiwf_do_task', 'aiwf_commit', 'aiwf_initialize'];
-  
-  console.log('\n=== 명령어 경로 테스트 ===');
-  console.log('현재 언어:', currentLang);
-  
-  for (const cmd of testCommands) {
-    const result = await resolveCommandPath(cmd);
-    if (result.path) {
-      console.log('✅', cmd, '->', result.path, result.fallback ? '(폴백)' : '(직접)');
-    } else {
-      console.log('❌', cmd, '-> 찾을 수 없음:', result.error);
-    }
-  }
-});
-"
+aiwf-lang status
 ```
 
-## 출력 형식
+### 언어 변경
+```bash
+# 한국어로 변경
+aiwf-lang set ko
 
-### 성공적인 언어 전환
+# 영어로 변경  
+aiwf-lang set en
 ```
-✅ 언어 전환 성공!
-이전 언어: en
-새 언어: ko
-메시지: 언어가 성공적으로 변경되었습니다
-
-=== 전환 후 언어 설정 상태 ===
-현재 사용 언어: ko
-설정 파일: 저장됨
 
-=== 명령어 경로 테스트 ===
-현재 언어: ko
-✅ aiwf_do_task -> claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_do_task.md (직접)
-✅ aiwf_commit -> claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_commit.md (직접)
-✅ aiwf_initialize -> claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_initialize.md (직접)
-```
+## 출력 예시
 
-### 현재 상태 확인만 수행
-```
+### 상태 확인
+```bash
+$ aiwf-lang status
 === AIWF 언어 설정 상태 ===
 감지된 언어: ko
-설정된 언어: ko
+설정된 언어: ko  
 현재 사용 언어: ko
 자동 감지: 활성화
 폴백 언어: en
-설정 파일 경로: .aiwf/config/language.json
 ```
 
-### 오류 발생 시
+### 성공적인 언어 전환
+```bash
+$ aiwf-lang set en
+✅ 언어 전환 성공!
+이전 언어: ko
+새 언어: en
+언어가 성공적으로 변경되었습니다.
 ```
-❌ 언어 전환 실패: 지원되지 않는 언어입니다
-메시지: 언어 변경에 실패했습니다
 
-사용법: /project:aiwf:switch_language [ko|en]
+### 오류 발생 시
+```bash
+$ aiwf-lang set invalid
+❌ 오류: 지원되지 않는 언어입니다
 지원 언어: ko (한국어), en (English)
 ```
 
 ## 주의사항
 
-1. **설정 파일 권한**: `.aiwf/config/` 디렉토리에 쓰기 권한이 필요합니다
-2. **명령어 파일 존재**: 전환하려는 언어의 명령어 파일들이 존재해야 합니다
-3. **프로젝트 루트**: AIWF가 초기화된 프로젝트에서만 사용 가능합니다
+1. **설정 파일 권한**: 설정 파일에 쓰기 권한이 필요합니다
+2. **프로젝트 루트**: AIWF가 설치된 환경에서 사용 가능합니다
+3. **언어 파일**: 전환하려는 언어의 리소스 파일들이 존재해야 합니다
 
 ## 관련 명령어
 
-- `/project:aiwf:initialize` - AIWF 프로젝트 초기화
-- `/project:aiwf:update_docs` - 문서 업데이트 (언어별)
-- `/project:aiwf:help` - 도움말 (현재 언어로 표시)
+- `aiwf --help` - AIWF 도움말 (현재 언어로 표시)
+- `aiwf feature` - Feature 관리 명령어
+- `aiwf compress` - 컨텍스트 압축 명령어

package/.claude/commands/aiwf/aiwf_update_feature_status.md

@@ -3,7 +3,7 @@
 Feature Ledger의 상태를 변경합니다.
 
 ```bash
-cd .aiwf && node ../claude-code/aiwf/ko/commands/feature-ledger.js update-status "$@"
+aiwf feature update-status "$@"
 ```
 
 ## 설명

package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_compress_aggressive_persona.md

@@ -10,8 +10,8 @@ const path = require('path');
 
 // .aiwf 디렉토리로 이동하여 명령 실행
 const cwd = path.join(process.cwd(), '.aiwf');
-const proc = spawn('node', [
-  '../claude-code/aiwf/ko/commands/compress-context.js',
+const proc = spawn('aiwf', [
+  'compress',
   'aggressive',
   '--persona'
 ], { cwd, stdio: 'inherit' });

package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_compress_minimal_persona.md

@@ -10,8 +10,8 @@ const path = require('path');
 
 // .aiwf 디렉토리로 이동하여 명령 실행
 const cwd = path.join(process.cwd(), '.aiwf');
-const proc = spawn('node', [
-  '../claude-code/aiwf/ko/commands/compress-context.js',
+const proc = spawn('aiwf', [
+  'compress',
   'minimal',
   '--persona'
 ], { cwd, stdio: 'inherit' });

package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_compress_stats.md

@@ -5,56 +5,19 @@
 ## 실행
 
 ```javascript
-const fs = require('fs');
+const { spawn } = require('child_process');
 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'
-));
+// .aiwf 디렉토리로 이동하여 명령 실행
+const cwd = path.join(process.cwd(), '.aiwf');
+const proc = spawn('aiwf', [
+  'compress',
+  '--stats'
+], { cwd, stdio: 'inherit' });
 
-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);
-}
+proc.on('error', (err) => {
+  console.error('명령 실행 실패:', err.message);
+});
 ```
 
 ## 설명

package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_compress_with_persona.md

@@ -10,8 +10,8 @@ const path = require('path');
 
 // .aiwf 디렉토리로 이동하여 명령 실행
 const cwd = path.join(process.cwd(), '.aiwf');
-const proc = spawn('node', [
-  '../claude-code/aiwf/ko/commands/compress-context.js',
+const proc = spawn('aiwf', [
+  'compress',
   'balanced',
   '--persona'
 ], { cwd, stdio: 'inherit' });

package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_create_feature_ledger.md

@@ -3,7 +3,7 @@
 새로운 Feature Ledger를 생성하여 기능 개발을 추적합니다.
 
 ```bash
-cd .aiwf && node ../claude-code/aiwf/ko/commands/feature-ledger.js create "$@"
+aiwf feature create "$@"
 ```
 
 ## 설명