aiwf 0.3.0 → 0.3.1

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

@@ -1,8 +1,8 @@
-# Create GitHub Issue from Task
+# 태스크에서 GitHub 이슈 생성
 
-Automatically create a GitHub issue based on a task file.
+태스크 파일을 기반으로 GitHub 이슈를 자동으로 생성합니다.
 
-## Create TODO with EXACTLY these 5 items
+## 정확히 다음 5개 항목으로 TODO 생성
 
 1. Parse task file and extract information
 2. Generate issue template

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

@@ -0,0 +1,287 @@
+# AIWF 언어 관리자
+
+AIWF 프레임워크의 언어 관련 기능을 통합적으로 관리하는 명령어입니다.
+
+## 사용법
+
+```
+/project:aiwf:language_manager [action] [arguments]
+```
+
+### 액션 종류
+
+- `status` - 현재 언어 상태 확인
+- `switch <언어코드>` - 언어 전환  
+- `detect` - 시스템 언어 자동 감지
+- `reset` - 언어 설정 초기화
+- `test` - 언어 시스템 테스트
+- `config` - 설정 파일 관리
+
+## 실행 단계
+
+### 1. 인수 분석 및 액션 라우팅
+
+```bash
+# 인수 파싱
+ACTION="${1:-status}"
+ARGUMENT="${2:-}"
+
+echo "=== AIWF 언어 관리자 ==="
+echo "액션: $ACTION"
+echo "인수: $ARGUMENT"
+echo ""
+```
+
+### 2. 액션별 실행
+
+#### 2.1 상태 확인 (status)
+
+```bash
+if [ "$ACTION" = "status" ]; then
+  echo "📊 언어 상태 확인 중..."
+  node -e "
+  import('./language-utils.js').then(async ({ getLanguageStatus }) => {
+    const status = await getLanguageStatus();
+    
+    console.log('=== 언어 설정 상태 ===');
+    console.log('감지된 언어:', status.detectedLanguage);
+    console.log('설정된 언어:', status.configuredLanguage || '없음');
+    console.log('현재 사용 언어:', status.effectiveLanguage);
+    console.log('자동 감지:', status.autoDetect ? '활성화' : '비활성화');
+    console.log('폴백 언어:', status.fallbackLanguage);
+    console.log('지원 언어:', status.supportedLanguages.join(', '));
+    
+    if (status.error) {
+      console.log('⚠️ 오류:', status.error);
+    }
+  });
+  "
+fi
+```
+
+#### 2.2 언어 전환 (switch)
+
+```bash
+if [ "$ACTION" = "switch" ]; then
+  if [ -z "$ARGUMENT" ]; then
+    echo "❌ 오류: 언어 코드를 지정해주세요"
+    echo "사용법: /project:aiwf:language_manager switch [ko|en]"
+    exit 1
+  fi
+  
+  echo "🔄 언어 전환 중: $ARGUMENT"
+  node -e "
+  import('./language-utils.js').then(async ({ switchLanguage }) => {
+    const result = await switchLanguage(process.argv[1]);
+    
+    if (result.success) {
+      console.log('✅ 언어 전환 성공!');
+      console.log('이전 언어:', result.previousLanguage);
+      console.log('새 언어:', result.newLanguage);
+    } else {
+      console.error('❌ 언어 전환 실패:', result.error);
+      process.exit(1);
+    }
+  });
+  " -- "$ARGUMENT"
+fi
+```
+
+#### 2.3 언어 감지 (detect)
+
+```bash
+if [ "$ACTION" = "detect" ]; then
+  echo "🔍 시스템 언어 감지 중..."
+  node -e "
+  import('./language-utils.js').then(async ({ detectLanguage }) => {
+    const detected = await detectLanguage();
+    
+    console.log('=== 언어 감지 결과 ===');
+    console.log('감지된 언어:', detected);
+    console.log('');
+    console.log('환경 변수:');
+    console.log('  LANG:', process.env.LANG || '설정되지 않음');
+    console.log('  LC_ALL:', process.env.LC_ALL || '설정되지 않음');
+    console.log('  LANGUAGE:', process.env.LANGUAGE || '설정되지 않음');
+  });
+  "
+fi
+```
+
+#### 2.4 설정 초기화 (reset)
+
+```bash
+if [ "$ACTION" = "reset" ]; then
+  echo "🗑️ 언어 설정 초기화 중..."
+  
+  # 설정 파일 삭제
+  if [ -f ".aiwf/config/language.json" ]; then
+    rm ".aiwf/config/language.json"
+    echo "✅ 언어 설정 파일이 삭제되었습니다"
+  else
+    echo "ℹ️ 언어 설정 파일이 존재하지 않습니다"
+  fi
+  
+  # 재감지 수행
+  echo "🔄 언어 재감지 중..."
+  node -e "
+  import('./language-utils.js').then(async ({ detectLanguage }) => {
+    const detected = await detectLanguage();
+    console.log('재감지된 언어:', detected);
+  });
+  "
+fi
+```
+
+#### 2.5 시스템 테스트 (test)
+
+```bash
+if [ "$ACTION" = "test" ]; then
+  echo "🧪 언어 시스템 테스트 중..."
+  node -e "
+  import('./language-utils.js').then(async (utils) => {
+    const { resolveCommandPath, detectLanguage, getLocalizedMessage } = utils;
+    
+    console.log('=== 언어 시스템 테스트 ===');
+    
+    // 1. 언어 감지 테스트
+    const detected = await detectLanguage();
+    console.log('✅ 언어 감지:', detected);
+    
+    // 2. 명령어 경로 해결 테스트
+    const testCommands = ['aiwf_do_task', 'aiwf_commit'];
+    console.log('\n📁 명령어 경로 테스트:');
+    
+    for (const cmd of testCommands) {
+      const result = await resolveCommandPath(cmd);
+      if (result.path) {
+        console.log('  ✅', cmd, result.fallback ? '(폴백)' : '(직접)');
+      } else {
+        console.log('  ❌', cmd, '실패');
+      }
+    }
+    
+    // 3. 메시지 시스템 테스트
+    console.log('\n💬 메시지 시스템 테스트:');
+    const testMsg = getLocalizedMessage('LANGUAGE_NOT_SUPPORTED', detected);
+    console.log('  메시지:', testMsg);
+    
+    console.log('\n✅ 모든 테스트 완료');
+  });
+  "
+fi
+```
+
+#### 2.6 설정 관리 (config)
+
+```bash
+if [ "$ACTION" = "config" ]; then
+  echo "⚙️ 언어 설정 파일 관리"
+  
+  CONFIG_FILE=".aiwf/config/language.json"
+  
+  if [ -f "$CONFIG_FILE" ]; then
+    echo "📄 현재 설정 파일 내용:"
+    cat "$CONFIG_FILE" | jq . 2>/dev/null || cat "$CONFIG_FILE"
+    echo ""
+    
+    echo "📊 설정 파일 정보:"
+    echo "  위치: $CONFIG_FILE"
+    echo "  크기: $(stat -f%z "$CONFIG_FILE" 2>/dev/null || stat -c%s "$CONFIG_FILE" 2>/dev/null) bytes"
+    echo "  수정일: $(stat -f%Sm "$CONFIG_FILE" 2>/dev/null || stat -c%y "$CONFIG_FILE" 2>/dev/null)"
+  else
+    echo "❌ 설정 파일이 존재하지 않습니다: $CONFIG_FILE"
+    echo ""
+    echo "💡 설정 파일을 생성하려면 언어를 설정하세요:"
+    echo "   /project:aiwf:language_manager switch ko"
+    echo "   /project:aiwf:language_manager switch en"
+  fi
+fi
+```
+
+### 3. 도움말 (기본값)
+
+```bash
+if [ "$ACTION" = "help" ] || [ "$ACTION" = "--help" ]; then
+  echo "📖 AIWF 언어 관리자 도움말"
+  echo ""
+  echo "사용법:"
+  echo "  /project:aiwf:language_manager [action] [arguments]"
+  echo ""
+  echo "액션:"
+  echo "  status          현재 언어 상태 확인"
+  echo "  switch <lang>   언어 전환 (ko|en)"
+  echo "  detect          시스템 언어 자동 감지"
+  echo "  reset           언어 설정 초기화"
+  echo "  test            언어 시스템 테스트"
+  echo "  config          설정 파일 관리"
+  echo "  help            이 도움말 표시"
+  echo ""
+  echo "예시:"
+  echo "  /project:aiwf:language_manager status"
+  echo "  /project:aiwf:language_manager switch ko"
+  echo "  /project:aiwf:language_manager test"
+fi
+```
+
+### 4. 결과 요약
+
+```bash
+echo ""
+echo "=== 실행 완료 ==="
+echo "액션: $ACTION"
+echo "시각: $(date '+%Y-%m-%d %H:%M:%S')"
+
+# 현재 언어 상태 간단 표시
+node -e "
+import('./language-utils.js').then(async ({ detectLanguage }) => {
+  const lang = await detectLanguage();
+  console.log('현재 언어:', lang);
+});
+" 2>/dev/null || echo "현재 언어: 감지 불가"
+```
+
+## 출력 예시
+
+### 상태 확인
+```
+=== AIWF 언어 관리자 ===
+액션: status
+
+📊 언어 상태 확인 중...
+=== 언어 설정 상태 ===
+감지된 언어: ko
+설정된 언어: ko  
+현재 사용 언어: ko
+자동 감지: 활성화
+폴백 언어: en
+지원 언어: ko, en
+
+=== 실행 완료 ===
+액션: status
+시각: 2025-07-03 06:25:30
+현재 언어: ko
+```
+
+### 언어 전환
+```
+=== AIWF 언어 관리자 ===
+액션: switch
+인수: en
+
+🔄 언어 전환 중: en
+✅ 언어 전환 성공!
+이전 언어: ko
+새 언어: en
+
+=== 실행 완료 ===
+액션: switch
+시각: 2025-07-03 06:25:35
+현재 언어: en
+```
+
+## 관련 명령어
+
+- `/project:aiwf:switch_language` - 간단한 언어 전환
+- `/project:aiwf:language_status` - 상세한 상태 확인
+- `/project:aiwf:initialize` - AIWF 초기화 (언어 선택 포함)

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

@@ -0,0 +1,246 @@
+# AIWF 언어 상태 확인
+
+AIWF 프레임워크의 현재 언어 설정 상태를 자세히 확인하는 명령어입니다.
+
+## 사용법
+
+이 명령어는 다음과 같은 정보를 제공합니다:
+- 현재 감지된 시스템 언어
+- 사용자가 설정한 언어 (있는 경우)
+- 실제로 사용되는 언어
+- 언어 설정 파일 상태
+- 명령어 경로 해결 상태
+
+## 실행 과정
+
+### 1. 언어 상태 종합 분석
+
+```bash
+node -e "
+import('./language-utils.js').then(async (utils) => {
+  const { getLanguageStatus, resolveCommandPath, getLocalizedMessage } = utils;
+  
+  console.log('=== AIWF 언어 시스템 상태 분석 ===\n');
+  
+  // 기본 상태 정보
+  const status = await getLanguageStatus();
+  
+  console.log('📍 기본 정보:');
+  console.log('  감지된 언어:', status.detectedLanguage);
+  console.log('  설정된 언어:', status.configuredLanguage || '없음');
+  console.log('  현재 사용 언어:', status.effectiveLanguage);
+  console.log('  자동 감지:', status.autoDetect ? '활성화' : '비활성화');
+  console.log('  폴백 언어:', status.fallbackLanguage);
+  console.log('  지원 언어:', status.supportedLanguages.join(', '));
+  console.log('  설정 파일:', status.configPath);
+  
+  if (status.error) {
+    console.log('  ⚠️ 오류:', status.error);
+  }
+  
+  console.log('\n📂 설정 파일 상태:');
+  try {
+    const fs = await import('fs/promises');
+    const configExists = await fs.access(status.configPath).then(() => true).catch(() => false);
+    
+    if (configExists) {
+      const configContent = await fs.readFile(status.configPath, 'utf8');
+      const config = JSON.parse(configContent);
+      console.log('  ✅ 설정 파일 존재');
+      console.log('  📄 내용:', JSON.stringify(config, null, 4));
+    } else {
+      console.log('  ❌ 설정 파일 없음');
+    }
+  } catch (error) {
+    console.log('  ⚠️ 설정 파일 읽기 오류:', error.message);
+  }
+});
+"
+```
+
+### 2. 환경 변수 분석
+
+```bash
+node -e "
+console.log('\n🌍 시스템 환경 변수:');
+console.log('  LANG:', process.env.LANG || '설정되지 않음');
+console.log('  LC_ALL:', process.env.LC_ALL || '설정되지 않음');
+console.log('  LANGUAGE:', process.env.LANGUAGE || '설정되지 않음');
+console.log('  NODE_ENV:', process.env.NODE_ENV || '설정되지 않음');
+"
+```
+
+### 3. 명령어 경로 테스트
+
+```bash
+node -e "
+import('./language-utils.js').then(async ({ resolveCommandPath, detectLanguage }) => {
+  console.log('\n🔍 명령어 경로 해결 테스트:');
+  
+  const currentLang = await detectLanguage();
+  console.log('  현재 언어:', currentLang);
+  
+  const testCommands = [
+    'aiwf_do_task',
+    'aiwf_commit', 
+    'aiwf_initialize',
+    'aiwf_switch_language',
+    'aiwf_test',
+    'aiwf_code_review',
+    'aiwf_project_review'
+  ];
+  
+  for (const cmd of testCommands) {
+    const result = await resolveCommandPath(cmd);
+    if (result.path) {
+      const status = result.fallback ? '🔄 폴백' : '✅ 직접';
+      console.log('  ' + status, cmd + ':', result.language);
+    } else {
+      console.log('  ❌ 없음', cmd + ':', result.error);
+    }
+  }
+});
+"
+```
+
+### 4. 메시지 시스템 테스트
+
+```bash
+node -e "
+import('./language-utils.js').then(async ({ getLocalizedMessage, detectLanguage }) => {
+  console.log('\n💬 다국어 메시지 시스템 테스트:');
+  
+  const currentLang = await detectLanguage();
+  console.log('  현재 언어:', currentLang);
+  
+  const testMessages = [
+    'LANGUAGE_NOT_SUPPORTED',
+    'CONFIG_LOAD_FAILED', 
+    'CONFIG_SAVE_FAILED',
+    'COMMAND_NOT_FOUND',
+    'LANGUAGE_SWITCH_SUCCESS'
+  ];
+  
+  for (const msgKey of testMessages) {
+    const koMsg = getLocalizedMessage(msgKey, 'ko');
+    const enMsg = getLocalizedMessage(msgKey, 'en');
+    console.log('  ' + msgKey + ':');
+    console.log('    한국어: ' + koMsg);
+    console.log('    English: ' + enMsg);
+  }
+});
+"
+```
+
+### 5. 디렉토리 구조 확인
+
+```bash
+node -e "
+const fs = await import('fs/promises');
+const path = await import('path');
+
+console.log('\n📁 AIWF 디렉토리 구조:');
+
+const checkDirs = [
+  '.aiwf',
+  '.aiwf/config',
+  '.claude',
+  '.claude/commands',
+  '.claude/commands/aiwf',
+  'claude-code/aiwf/ko/.claude/commands/aiwf',
+  'claude-code/aiwf/en/.claude/commands/aiwf'
+];
+
+for (const dir of checkDirs) {
+  try {
+    const exists = await fs.access(dir).then(() => true).catch(() => false);
+    if (exists) {
+      const files = await fs.readdir(dir);
+      console.log('  ✅', dir + ':', files.length + '개 파일');
+    } else {
+      console.log('  ❌', dir + ':', '디렉토리 없음');
+    }
+  } catch (error) {
+    console.log('  ⚠️', dir + ':', '접근 오류');
+  }
+}
+"
+```
+
+## 진단 및 권장사항
+
+### 언어 감지 문제 해결
+
+명령어가 다음과 같은 권장사항을 제공합니다:
+
+1. **설정 파일이 없는 경우**:
+   ```
+   💡 권장사항: 언어를 명시적으로 설정하세요
+   /project:aiwf:switch_language ko
+   ```
+
+2. **환경 변수 문제**:
+   ```
+   💡 권장사항: 환경 변수를 확인하세요
+   export LANG=ko_KR.UTF-8
+   ```
+
+3. **명령어 파일 누락**:
+   ```
+   💡 권장사항: AIWF를 다시 설치하세요
+   npx aiwf --force
+   ```
+
+## 출력 예시
+
+```
+=== AIWF 언어 시스템 상태 분석 ===
+
+📍 기본 정보:
+  감지된 언어: ko
+  설정된 언어: ko
+  현재 사용 언어: ko
+  자동 감지: 활성화
+  폴백 언어: en
+  지원 언어: ko, en
+  설정 파일: .aiwf/config/language.json
+
+📂 설정 파일 상태:
+  ✅ 설정 파일 존재
+  📄 내용: {
+      "language": "ko",
+      "auto_detect": true,
+      "last_updated": "2025-07-03T06:25:00.000Z",
+      "fallback": "en"
+  }
+
+🌍 시스템 환경 변수:
+  LANG: ko_KR.UTF-8
+  LC_ALL: 설정되지 않음
+  LANGUAGE: 설정되지 않음
+  NODE_ENV: 설정되지 않음
+
+🔍 명령어 경로 해결 테스트:
+  현재 언어: ko
+  ✅ 직접 aiwf_do_task: ko
+  ✅ 직접 aiwf_commit: ko
+  ✅ 직접 aiwf_initialize: ko
+  ✅ 직접 aiwf_switch_language: ko
+  🔄 폴백 aiwf_test: en
+  ❌ 없음 aiwf_unknown: 명령어 파일을 찾을 수 없습니다
+
+💬 다국어 메시지 시스템 테스트:
+  현재 언어: ko
+  LANGUAGE_NOT_SUPPORTED:
+    한국어: 지원되지 않는 언어입니다
+    English: Language not supported
+  
+📁 AIWF 디렉토리 구조:
+  ✅ .aiwf: 8개 파일
+  ✅ .aiwf/config: 1개 파일
+  ✅ .claude: 2개 파일
+  ✅ .claude/commands: 1개 파일
+  ❌ .claude/commands/aiwf: 디렉토리 없음
+  ✅ claude-code/aiwf/ko/.claude/commands/aiwf: 15개 파일
+  ✅ claude-code/aiwf/en/.claude/commands/aiwf: 14개 파일
+```

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

@@ -1,22 +1,22 @@
-# Create Pull Request After Task Completion
+# 태스크 완료 후 풀 리퀘스트 생성
 
-Create a GitHub Pull Request after task completion and link it with related issues.
+태스크 완료 후 GitHub 풀 리퀘스트를 생성하고 관련 이슈와 연결합니다.
 
-## Create TODO with EXACTLY these 6 items
+## 정확히 다음 6개 항목으로 TODO 생성
 
-1. Check current branch and changes
-2. Generate PR body template
-3. Create GitHub PR
-4. Link issue with PR
-5. Assign reviewers
-6. Report results
+1. 현재 브랜치 및 변경사항 확인
+2. PR 본문 템플릿 생성
+3. GitHub PR 생성
+4. 이슈와 PR 연결
+5. 리뷰어 배정
+6. 결과 보고
 
-## 1 · Check Branch and Changes
+## 1 · 브랜치 및 변경사항 확인
 
-Run in parallel:
-- `git branch --show-current`: Check current branch
-- `git log main..HEAD --oneline`: Commit history
-- `git diff main...HEAD --stat`: Changed files statistics
+병렬로 실행:
+- `git branch --show-current`: 현재 브랜치 확인
+- `git log main..HEAD --oneline`: 커밋 히스토리
+- `git diff main...HEAD --stat`: 변경된 파일 통계
 
 Extract GitHub issue number from task file
 

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

@@ -1,9 +1,9 @@
 # 지식 프라임
 
-Prime yourself with basic information about this project.
-Make sure you are aware of the environment.
+이 프로젝트의 기본 정보로 자신을 준비시키세요.
+환경을 인식하고 있는지 확인하세요.
 
-## USE **PARALLEL AGENTS** to
+## **병렬 에이전트**를 사용하여 다음을 수행하세요
 
-- READ .aiwf/01_PROJECT_DOCS/ARCHITECTURE.md for basic Project Information
-- READ .aiwf/00_PROJECT_MANIFEST.md for the Project status
+- 기본 프로젝트 정보를 위해 .aiwf/01_PROJECT_DOCS/ARCHITECTURE.md 읽기
+- 프로젝트 상태를 위해 .aiwf/00_PROJECT_MANIFEST.md 읽기