aiwf 0.3.0 → 0.3.1

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

@@ -1,62 +1,62 @@
 # 프로젝트 리뷰 - 탑 다운 실행
 
-Perform a comprehensive project-level review focusing on architecture, progress, and technical decisions.
+아키텍처, 진행 상황, 기술 결정에 초점을 맞춘 포괄적인 프로젝트 수준 리뷰를 수행합니다.
 
-**IMPORTANT:**
+**중요사항:**
 
-- This is a high-level review of overall project state, not recent changes.
-- Unless clearly mentioned in project documents, there is no timeline and schedule is irrelevant
+- 이는 최근 변경 사항이 아닌 전체 프로젝트 상태에 대한 고수준 리뷰입니다.
+- 프로젝트 문서에 명확히 언급되지 않은 한, 타임라인과 일정은 관련이 없습니다
 
-## Create a TODO with EXACTLY these 9 Items
+## 정확히 다음 9개 항목으로 TODO 생성
 
-1. Analyze review scope and timing
-2. Execute and assess test infrastructure health
-3. Assess project documentation alignment
-4. Review milestone and sprint progress
-5. Analyze codebase architecture and structure
-6. Audit file organization and workflow compliance
-7. Evaluate technical decisions and complexity
-8. Critique implementation quality (John Carmack perspective)
-9. Provide comprehensive assessment with recommendations
+1. 리뷰 범위 및 타이밍 분석
+2. 테스트 인프라 상태 실행 및 평가
+3. 프로젝트 문서 정렬 평가
+4. 마일스톤 및 스프린트 진행 상황 검토
+5. 코드베이스 아키텍처 및 구조 분석
+6. 파일 구성 및 워크플로우 준수 감사
+7. 기술적 결정 및 복잡성 평가
+8. 구현 품질 비평 (John Carmack 관점)
+9. 권장 사항과 함께 포괄적인 평가 제공
 
-Follow step by step and adhere closely to the following instructions for each step.
+단계별로 진행하며 각 단계에 대한 다음 지침을 엄격히 준수하세요.
 
-## DETAILS on every TODO item
+## 모든 TODO 항목에 대한 세부사항
 
-### 1. Analyze review scope and timing
+### 1. 리뷰 범위 및 타이밍 분석
 
-Check: <$ARGUMENTS>
+확인: <$ARGUMENTS>
 
-If empty, perform full project review. Otherwise interpret <$ARGUMENTS> to identify specific focus areas (milestone, sprint, architecture component, etc.). Unless stated in Argument do not compare to previews project reviews in `.aiwf/10_STATE_OF_PROJECT`.
+비어있다면 전체 프로젝트 리뷰를 수행합니다. 그렇지 않으면 <$ARGUMENTS>를 해석하여 특정 초점 영역(마일스톤, 스프린트, 아키텍처 구성 요소 등)을 식별합니다. Argument에 명시되지 않은 한 `.aiwf/10_STATE_OF_PROJECT`의 이전 프로젝트 리뷰와 비교하지 마세요.
 
-**IMPORTANT:** This review looks at overall project state in context of recent changes.
+**중요:** 이 리뷰는 최근 변경사항의 맥락에서 전체 프로젝트 상태를 살펴봅니다.
 
-**CRITICAL:** Read `.aiwf/00_PROJECT_MANIFEST.md` FIRST to understand:
+**핵심:** `.aiwf/00_PROJECT_MANIFEST.md`를 **먼저** 읽어서 다음을 이해하세요:
 
-- Current milestone and sprint status
-- What work is complete vs in-progress vs planned
-- Active sprint objectives and deliverables
+- 현재 마일스톤 및 스프린트 상태
+- 완료된 작업 vs 진행 중인 작업 vs 계획된 작업
+- 활성 스프린트 목표 및 결과물
 
-**CONTEXT CHECK:** Before evaluating functionality:
+**맥락 확인:** 기능 평가 전에:
 
-- Navigate to `.aiwf/03_SPRINTS/` to find the current sprint
-- Read the sprint meta file to understand what's in scope
-- Check completed vs planned tasks within the sprint
-- Understand what future sprints will deliver
+- `.aiwf/03_SPRINTS/`로 이동하여 현재 스프린트 찾기
+- 스프린트 메타 파일을 읽어 범위 내에 있는 것 이해하기
+- 스프린트 내에서 완료된 태스크 vs 계획된 태스크 확인
+- 향후 스프린트가 제공할 내용 이해하기
 
-**REVIEW PRINCIPLE:** Evaluate against CURRENT SPRINT deliverables, not full milestone scope.
+**리뷰 원칙:** 전체 마일스톤 범위가 아닌 현재 스프린트 결과물에 대해 평가합니다.
 
-### 2. Execute and assess test infrastructure health
+### 2. 테스트 인프라 상태 실행 및 평가
 
-**CRITICAL:** Test infrastructure health is a BLOCKING criteria for sprint/milestone progression.
+**핵심:** 테스트 인프라 상태는 스프린트/마일스톤 진행의 차단 기준입니다.
 
-- USE test.md command to execute full test suite (@.claude/commands/aiwf/aiwf_test.md)
-- ANALYZE test results: passed/failed/skipped counts and failure categories
-- CALCULATE test health score (0-10 scale):
-  - 10: 100% pass rate, no infrastructure issues
-  - 8-9: >95% pass rate, minor issues only
-  - 6-7: 80-95% pass rate, some non-critical failures
-  - 4-5: 60-80% pass rate, significant issues
+- 전체 테스트 스위트 실행을 위해 test.md 명령 사용 (@.claude/commands/aiwf/aiwf_test.md)
+- 테스트 결과 분석: 통과/실패/건너뛴 개수 및 실패 카테고리
+- 테스트 상태 점수 계산 (0-10 스케일):
+  - 10: 100% 통과율, 인프라 문제 없음
+  - 8-9: >95% 통과율, 사소한 문제만 있음
+  - 6-7: 80-95% 통과율, 일부 비핵심 실패
+  - 4-5: 60-80% 통과율, 중대한 문제
   - 0-3: <60% pass rate, critical infrastructure problems
 - CATEGORIZE failures:
   - Infrastructure: Import errors, missing modules

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

@@ -0,0 +1,160 @@
+# 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`)**: 해당 언어로 전환
+- **무효한 인수**: 오류 메시지 표시 후 사용법 안내
+
+### 3. 언어 전환 실행
+
+유효한 언어코드가 제공된 경우 언어를 전환합니다:
+
+```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
+```
+
+### 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. 명령어 경로 테스트
+
+새 언어로 명령어 경로가 제대로 해결되는지 테스트합니다:
+
+```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);
+    }
+  }
+});
+"
+```
+
+## 출력 형식
+
+### 성공적인 언어 전환
+```
+✅ 언어 전환 성공!
+이전 언어: 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 (직접)
+```
+
+### 현재 상태 확인만 수행
+```
+=== AIWF 언어 설정 상태 ===
+감지된 언어: ko
+설정된 언어: ko
+현재 사용 언어: ko
+자동 감지: 활성화
+폴백 언어: en
+설정 파일 경로: .aiwf/config/language.json
+```
+
+### 오류 발생 시
+```
+❌ 언어 전환 실패: 지원되지 않는 언어입니다
+메시지: 언어 변경에 실패했습니다
+
+사용법: /project:aiwf:switch_language [ko|en]
+지원 언어: ko (한국어), en (English)
+```
+
+## 주의사항
+
+1. **설정 파일 권한**: `.aiwf/config/` 디렉토리에 쓰기 권한이 필요합니다
+2. **명령어 파일 존재**: 전환하려는 언어의 명령어 파일들이 존재해야 합니다
+3. **프로젝트 루트**: AIWF가 초기화된 프로젝트에서만 사용 가능합니다
+
+## 관련 명령어
+
+- `/project:aiwf:initialize` - AIWF 프로젝트 초기화
+- `/project:aiwf:update_docs` - 문서 업데이트 (언어별)
+- `/project:aiwf:help` - 도움말 (현재 언어로 표시)

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

@@ -1,125 +1,124 @@
 # 테스트 실행 및 일반적인 문제 수정
 
-Follow these instructions from top to bottom.
+다음 지시사항을 위에서 아래로 순서대로 따르세요.
 
-## Create a TODO with EXACTLY these 4 items
+## 정확히 다음 4개 항목으로 TODO 생성
 
-1. Execute test suite
-2. Analyze results and identify issues
-3. Fix common problems if found
-4. Provide test summary
+1. 테스트 스위트 실행
+2. 결과 분석 및 문제 식별
+3. 발견된 일반적인 문제 수정
+4. 테스트 요약 제공
 
 ---
 
-## 1 · Execute test suite
+## 1 · 테스트 스위트 실행
 
-### First, detect the project's test runner:
+### 먼저 프로젝트의 테스트 러너 감지:
 
-1. **Python projects:**
+1. **Python 프로젝트:**
 
-   - If `pyproject.toml` exists with `[tool.poetry]`: Try `poetry run pytest`
-   - If `setup.py` or `requirements.txt`: Try `pytest` or `python -m pytest`
-   - If custom test script exists (e.g., `run_tests.py`, `run_dev.py`): Use that
-   - Add common flags: `--tb=short` for pytest
+   - `[tool.poetry]`가 있는 `pyproject.toml`이 존재하면: `poetry run pytest` 시도
+   - `setup.py` 또는 `requirements.txt`가 있으면: `pytest` 또는 `python -m pytest` 시도
+   - 커스텀 테스트 스크립트 존재시 (예: `run_tests.py`, `run_dev.py`): 해당 스크립트 사용
+   - 일반적인 플래그 추가: pytest용 `--tb=short`
 
-2. **JavaScript/TypeScript projects:**
+2. **JavaScript/TypeScript 프로젝트:**
 
-   - If `package.json` exists: Check "scripts" section for "test" command
-   - Common: `npm test`, `npm run test`, `yarn test`, `pnpm test`
-   - Framework specific: `jest`, `vitest`, `mocha`
+   - `package.json`이 존재하면: "scripts" 섹션에서 "test" 명령어 확인
+   - 일반적인 명령어: `npm test`, `npm run test`, `yarn test`, `pnpm test`
+   - 프레임워크별: `jest`, `vitest`, `mocha`
 
-3. **Other languages:**
+3. **기타 언어:**
    - Rust: `cargo test`
    - Go: `go test ./...`
-   - Java: `mvn test` or `gradle test`
-   - Ruby: `bundle exec rspec` or `rake test`
-   - PHP: `composer test` or `phpunit`
+   - Java: `mvn test` 또는 `gradle test`
+   - Ruby: `bundle exec rspec` 또는 `rake test`
+   - PHP: `composer test` 또는 `phpunit`
 
-### Execute the detected test command:
+### 감지된 테스트 명령어 실행:
 
-- RUN the appropriate test command
-- CAPTURE full output including any errors
-- NOTE execution time and test counts
+- 적절한 테스트 명령어 실행
+- 오류를 포함한 전체 출력 캡처
+- 실행 시간 및 테스트 개수 기록
 
-**If no test runner is found:** Report this to the user and ask for the correct test command.
+**테스트 러너를 찾을 수 없는 경우:** 사용자에게 보고하고 올바른 테스트 명령어 요청
 
-## 2 · Analyze results and identify issues
+## 2 · 결과 분석 및 문제 식별
 
-Check for common issues in this order:
+다음 순서로 일반적인 문제 확인:
 
-### Language-specific issues:
+### 언어별 문제:
 
 **Python:**
 
-- Missing **init**.py files (import errors, tests not discovered)
-- Import path problems
-- Fixture issues (pytest)
-- Virtual environment problems
+- **__init__.py** 파일 누락 (import 오류, 테스트 미발견)
+- Import 경로 문제
+- Fixture 문제 (pytest)
+- 가상 환경 문제
 
 **JavaScript/TypeScript:**
 
-- Module resolution errors
-- Missing dependencies in node_modules
-- Jest/Vitest configuration issues
-- TypeScript compilation errors
+- 모듈 해결 오류
+- node_modules의 의존성 누락
+- Jest/Vitest 구성 문제
+- TypeScript 컴파일 오류
 
-**Common across languages:**
+**모든 언어 공통:**
 
-- Environment variable issues (missing config)
-- Database/external service connection errors
-- File path problems (absolute vs relative)
-- Permission issues
+- 환경 변수 문제 (구성 누락)
+- 데이터베이스/외부 서비스 연결 오류
+- 파일 경로 문제 (절대 경로 vs 상대 경로)
+- 권한 문제
 
-## 3 · Fix common problems if found
+## 3 · 발견된 일반적인 문제 수정
 
-**ONLY** fix these specific issues automatically:\*\*
+**오직** 다음 특정 문제들만 자동으로 수정:**
 
-### Python-specific fixes:
+### Python 전용 수정:
 
-- CREATE empty `__init__.py` files where needed
-- FIX simple import path issues
-- ADD missing test directory to Python path if needed
+- 필요한 곳에 빈 `__init__.py` 파일 생성
+- 간단한 import 경로 문제 수정
+- 필요한 경우 Python 경로에 누락된 테스트 디렉토리 추가
 
-### JavaScript/TypeScript fixes:
+### JavaScript/TypeScript 수정:
 
-- RUN `npm install` if node_modules missing
-- FIX simple module resolution in jest.config.js
-- CREATE missing test setup files
+- node_modules가 누락된 경우 `npm install` 실행
+- jest.config.js의 간단한 모듈 해결 문제 수정
+- 누락된 테스트 설정 파일 생성
 
-### General fixes:
+### 일반 수정:
 
-- CREATE missing test directories
-- FIX file permissions if possible
-- IDENTIFY missing env vars and inform user
+- 누락된 테스트 디렉토리 생성
+- 가능한 경우 파일 권한 수정
+- 누락된 환경 변수 식별 및 사용자에게 알림
 
-**DO NOT** fix:
+**수정하지 않을 것:**
 
-- Actual test logic failures
-- Business logic bugs
-- Complex configuration issues
-- Database schema problems
-- External service dependencies
+- 실제 테스트 로직 실패
+- 비즈니스 로직 버그
+- 복잡한 구성 문제
+- 데이터베이스 스키마 문제
+- 외부 서비스 의존성
 
-## 4 · Provide test summary
+## 4 · 테스트 요약 제공
 
-Create a brief summary:
+간단한 요약 생성:
 
 ```
-Test Results:
-- Total: X tests
-- Passed: Y (Z%)
-- Failed: A
-- Skipped: B
-- Time: C seconds
+테스트 결과:
+- 총 개수: X개 테스트
+- 통과: Y개 (Z%)
+- 실패: A개
+- 건너뜀: B개
+- 시간: C초
 
-Issues Fixed:
-- [List any fixes applied]
+수정된 문제:
+- [적용된 수정사항 목록]
 
-Issues Found (requires manual fix):
-- [List problems that need attention]
+발견된 문제 (수동 수정 필요):
+- [주의가 필요한 문제 목록]
 
-Status: PASSING | FAILING | BLOCKED
+상태: PASSING | FAILING | BLOCKED
 ```
 
-**IMPORTANT:** Keep it concise. This command should be quick and focused on running tests, not detailed analysis.
-EOF < /dev/null
+**중요:** 간결하게 유지하세요. 이 명령어는 빠르고 테스트 실행에 집중해야 하며, 상세한 분석에 집중하지 않아야 합니다.