aiwf 0.1.0 → 0.3.1

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

@@ -0,0 +1,202 @@
+# 무한 에이전틱 루프 명령
+
+이 무한 생성 작업에 대해 깊이 생각하세요. 당신은 정교한 반복 생성 프로세스를 시작하려고 합니다. deep think
+
+**변수:**
+
+spec_file: $ARGUMENTS
+output_dir: $ARGUMENTS
+count: $ARGUMENTS
+
+**인자 파싱:**
+"$ARGUMENTS"에서 다음 인자들을 파싱합니다:
+
+1. `spec_file` - 마크다운 명세 파일 경로
+2. `output_dir` - 반복 결과가 저장될 디렉토리
+3. `count` - 반복 횟수 (1-N 또는 "infinite")
+
+**1단계: 명세 분석**
+`spec_file`의 명세 파일을 읽고 깊이 이해합니다. 이 파일은 다음을 정의합니다:
+
+- 생성할 콘텐츠 유형
+- 형식과 구조 요구사항
+- 특정 매개변수나 제약사항
+- 반복 간의 의도된 진화 패턴
+
+명세의 의도와 각 반복이 이전 작업을 어떻게 기반으로 해야 하는지 신중히 생각하세요.
+
+**2단계: 출력 디렉토리 탐색**
+현재 상태를 이해하기 위해 `output_dir`을 철저히 분석합니다:
+
+- 모든 기존 파일과 명명 패턴 나열
+- 현재 존재하는 가장 높은 반복 번호 식별
+- 기존 반복들 간의 콘텐츠 진화 분석
+- 이전 생성의 궤적 이해
+- 새로운 반복을 위한 격차나 기회 파악
+
+**3단계: 반복 전략**
+명세 분석과 기존 반복을 기반으로:
+
+- 시작 반복 번호 결정 (최고 기존 번호 + 1)
+- 각 새로운 반복이 독특하고 진화적일 방법 계획
+- 새로움을 유지하면서 이전 반복을 기반으로 구축하는 방법 고려
+- count가 "infinite"인 경우, 컨텍스트 제한까지 지속적 생성 준비
+
+**4단계: 병렬 에이전트 조율**
+최대 효율성과 창의적 다양성을 위해 여러 서브 에이전트를 병렬로 배포합니다:
+
+**서브 에이전트 배포 전략:**
+
+- count 1-5: 모든 에이전트 동시 실행
+- count 6-20: 5개 에이전트씩 배치로 실행하여 조율 관리
+- "infinite": 3-5개 에이전트의 웨이브를 실행하고, 컨텍스트를 모니터링하며 새로운 웨이브 생성
+
+**에이전트 할당 프로토콜:**
+각 서브 에이전트는 다음을 받습니다:
+
+1. **명세 컨텍스트**: 완전한 명세 파일 분석
+2. **디렉토리 스냅샷**: 실행 시점의 output_dir 현재 상태
+3. **반복 할당**: 특정 반복 번호 (시작*번호 + 에이전트*인덱스)
+4. **독특성 지시**: 기존 반복의 개념을 중복하지 않도록 명시적 지시
+5. **품질 기준**: 명세의 상세 요구사항
+
+**에이전트 작업 명세:**
+
+```
+작업: [OUTPUT_DIR]에 [SPEC_FILE]의 반복 [NUMBER] 생성
+
+당신은 반복 [NUMBER]를 생성하는 서브 에이전트 [X]입니다.
+
+컨텍스트:
+- 명세: [전체 명세 분석]
+- 기존 반복: [현재 output_dir 내용 요약]
+- 당신의 반복 번호: [NUMBER]
+- 할당된 창의적 방향: [탐색할 특정 혁신 차원]
+
+요구사항:
+1. 명세를 완전히 읽고 이해
+2. 기존 반복을 분석하여 출력이 독특한지 확인
+3. 명세 형식을 정확히 따라 콘텐츠 생성
+4. 명세 준수를 유지하면서 [할당된 혁신 차원]에 집중
+5. 지정된 정확한 이름 패턴으로 파일 생성
+6. 반복이 진정한 가치와 새로움을 추가하는지 확인
+
+산출물: 명세에 따른 단일 파일, 독특하고 혁신적인 콘텐츠 포함
+```
+
+**병렬 실행 관리:**
+
+- Task 도구를 사용하여 모든 할당된 서브 에이전트를 동시에 실행
+- 에이전트 진행과 완료 모니터링
+- 에이전트 실패 시 반복 번호 재할당으로 처리
+- 중복 반복 번호가 생성되지 않도록 보장
+- 완료된 모든 반복 수집 및 검증
+
+**5단계: 무한 모드 오케스트레이션**
+무한 생성 모드의 경우, 지속적인 병렬 웨이브를 조율합니다:
+
+**웨이브 기반 생성:**
+
+1. **웨이브 계획**: 컨텍스트 용량에 따라 다음 웨이브 크기(3-5 에이전트) 결정
+2. **에이전트 준비**: 각 새로운 웨이브를 위한 신선한 컨텍스트 스냅샷 준비
+3. **점진적 정교화**: 각 웨이브는 더 발전된 혁신 차원을 탐색해야 함
+4. **컨텍스트 모니터링**: 모든 에이전트와 메인 오케스트레이터의 총 컨텍스트 사용량 추적
+5. **우아한 종료**: 컨텍스트 한계에 접근하면 현재 웨이브를 완료하고 요약
+
+**무한 실행 사이클:**
+
+```
+WHILE 컨텍스트_용량 > 임계값:
+    1. 현재 output_dir 상태 평가
+    2. 다음 에이전트 웨이브 계획 (남은 컨텍스트에 따른 크기)
+    3. 점점 정교한 창의적 방향 할당
+    4. 병렬 서브 에이전트 웨이브 실행
+    5. 웨이브 완료 모니터링
+    6. 디렉토리 상태 스냅샷 업데이트
+    7. 남은 컨텍스트 용량 평가
+    8. 충분한 용량 있으면: 다음 웨이브로 계속
+    9. 한계에 접근하면: 최종 웨이브 완료하고 요약
+```
+
+**점진적 정교화 전략:**
+
+- **웨이브 1**: 단일 혁신 차원의 기본 기능 대체
+- **웨이브 2**: 향상된 상호작용이 있는 다차원 혁신
+- **웨이브 3**: 적응형 행동이 있는 복잡한 패러다임 조합
+- **웨이브 N**: 명세의 경계를 확장하는 혁명적 개념
+
+**컨텍스트 최적화:**
+
+- 각 웨이브는 컨텍스트 누적을 피하기 위해 신선한 에이전트 인스턴스 사용
+- 메인 오케스트레이터는 경량 상태 추적 유지
+- 컨텍스트 관리를 위한 완료된 반복의 점진적 요약
+- 후반 웨이브에서 덜 필수적인 세부사항의 전략적 제거
+
+**실행 원칙:**
+
+**품질 & 독특성:**
+
+- 각 반복은 진정으로 독특하고 가치있어야 함
+- 새로운 요소를 도입하면서 이전 작업을 기반으로 구축
+- 원래 명세와의 일관성 유지
+- 적절한 파일 구성과 명명 보장
+
+**병렬 조율:**
+
+- 창의적 다양성을 극대화하기 위해 서브 에이전트를 전략적으로 배포
+- 중복을 피하기 위해 각 에이전트에 독특한 혁신 차원 할당
+- 파일 명명 충돌을 방지하기 위한 타이밍 조정
+- 성공적인 완료와 품질을 위한 모든 에이전트 모니터링
+
+**확장성 & 효율성:**
+
+- 병렬 스트림 전체의 진화 궤적에 대해 깊이 생각 deep think
+- 무한 모드의 경우, 컨텍스트 소진 전 최대 가치있는 출력 최적화
+- 컨텍스트 한계를 지능적으로 관리하기 위한 웨이브 기반 생성 사용
+- 병렬 속도와 품질 및 조율 오버헤드의 균형
+
+**에이전트 관리:**
+
+- 각 서브 에이전트에 완전한 컨텍스트와 명확한 할당 제공
+- 반복 재할당으로 에이전트 실패를 우아하게 처리
+- 모든 병렬 출력이 전체 진행과 일관되게 통합되도록 보장
+
+**울트라 씽킹 지시:**
+생성을 시작하기 전에, 다음에 대해 확장된 사고를 수행하세요:
+
+**명세 & 진화:**
+
+- 명세의 더 깊은 의미
+- 반복 간 의미있는 진행을 만드는 방법
+- 각 반복을 가치있고 독특하게 만드는 것
+- 일관성과 혁신의 균형을 맞추는 방법
+
+**병렬 전략:**
+
+- 요청된 수에 대한 최적의 서브 에이전트 배포
+- 다양성을 극대화하기 위해 독특한 창의적 방향을 할당하는 방법
+- 무한 모드의 웨이브 크기와 타이밍
+- 여러 병렬 에이전트 간의 컨텍스트 관리
+
+**조율 과제:**
+
+- 병렬 스트림 간 중복 개념 방지 방법
+- 각 에이전트가 진정으로 독특한 출력을 생산하도록 보장하는 전략
+- 동시 쓰기가 있는 파일 명명과 디렉토리 구성 관리
+- 병렬 출력의 품질 관리 메커니즘
+
+**무한 모드 최적화:**
+
+- 지속적인 출력을 위한 웨이브 기반 생성 패턴
+- 여러 웨이브에 걸친 점진적 정교화 전략
+- 컨텍스트 용량 모니터링과 우아한 종료 계획
+- 병렬 생성 속도와 혁신 깊이의 균형
+
+**위험 완화:**
+
+- 에이전트 실패와 반복 재할당 처리
+- 병렬 실행에도 불구하고 일관된 전체 진행 보장
+- 전체 시스템의 컨텍스트 창 한계 관리
+- 모든 병렬 출력의 명세 준수 유지
+
+이러한 병렬 조율 과제에 대한 깊은 분석으로 실행을 시작하고, 최대 창의적 출력과 효율성을 위해 서브 에이전트를 활용하여 각 단계를 체계적으로 진행하세요.

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

@@ -0,0 +1,134 @@
+# AIWF 프레임워크 초기화
+
+적응형, 상호작용적 프로세스를 통해 AIWF 프로젝트 관리 프레임워크를 초기화합니다.
+
+## 정확히 다음 항목들로 TODO 생성
+
+1. 프로젝트 스캔 및 분석
+2. 사용자와 상호작용적 확인
+3. 기존 AIWF 문서 확인
+4. 문서 생성 프로세스 안내
+5. AIWF를 위한 첫 번째 마일스톤 생성
+6. 프로젝트 매니페스트 생성
+7. 다음 단계 제공
+
+## 모든 TODO 항목에 대한 세부사항
+
+### 1. 프로젝트 스캔 및 분석
+
+**프로젝트 특성 탐지:**
+
+- package.json, requirements.txt, composer.json 등 확인
+- 프로젝트 유형 식별 (Node.js, Python, PHP 등)
+- 전체 프로젝트 구조 스캔
+- 새 프로젝트인지 기존 프로젝트인지 확인
+- 기존 문서 찾기 (README, docs/ 등)
+
+**발견사항을 간단히 정리** - 필수 사항만 식별
+
+### 2. 사용자와 상호작용적 확인
+
+**발견사항을 대화형으로 제시:**
+
+```
+이것은 [프로젝트 이름]이라는 [프로젝트 유형] 프로젝트인 것으로 확인됩니다.
+맞습니까? AIWF 설정을 계속 진행해도 될까요?
+```
+
+**계속하기 전에 사용자 확인 받기**
+
+### 3. 기존 AIWF 문서 확인
+
+**.aiwf/ 디렉토리에서 스캔:**
+
+- 01_PROJECT_DOCS/의 모든 문서
+- 02_REQUIREMENTS/의 모든 마일스톤
+- 기존 스프린트나 태스크
+- 현재 매니페스트 상태
+
+**상호작용적 결정:**
+
+- 문서가 발견된 경우: "기존 문서를 발견했습니다: [목록]. 이것들을 사용하거나 확장할까요?"
+- 문서가 없는 경우: "아직 AIWF 문서가 없습니다. 계속하기 전에 복사하고 싶은 기존 프로젝트 문서가 있나요?"
+
+**사용자가 선택할 수 있는 옵션:**
+
+- 기존 문서 사용
+- 새 문서 추가
+- 새로 시작
+- 먼저 수동으로 문서 추가하기 위해 취소
+
+### 4. 문서 생성 프로세스 안내
+
+**사용자 선택에 따라:**
+
+**새로 시작하거나 확장하는 경우:**
+
+- 코드베이스의 심층 분석 수행
+- 주요 구성요소와 아키텍처 패턴 식별
+- 분석을 바탕으로 ARCHITECTURE.md 초안 생성
+- Q&A 스타일로 정제하고 완성:
+  - "이 프로젝트의 주요 목적은 무엇인가요?"
+  - "핵심 기술적 결정사항은 무엇인가요?"
+  - "중요한 제약사항이나 요구사항이 있나요?"
+
+**기존 문서를 사용하는 경우:**
+
+- 기존 문서를 가져와서 적응
+- AIWF 관련 섹션 작성
+- 프레임워크 구조와의 호환성 보장
+
+**대화형이고 적응적으로 유지**
+
+### 5. AIWF를 위한 첫 번째 마일스톤 생성
+
+**적절한 첫 번째 마일스톤 결정:**
+
+- 새 프로젝트인 경우: 설정/기반 마일스톤으로 시작
+- 기존 프로젝트인 경우: 현재 단계를 식별하고 적절한 마일스톤 생성
+
+**상호작용적 마일스톤 생성:**
+
+- "프로젝트 상태를 바탕으로 다음 마일스톤 생성을 제안합니다: [이름]"
+- "이 마일스톤에서 무엇에 집중하고 싶으신가요?"
+- 초기 요구사항이 포함된 마일스톤 구조 생성
+- 범위를 현실적이고 집중적으로 유지
+
+### 6. 프로젝트 매니페스트 생성
+
+**다음을 사용하여 매니페스트 자동 생성:**
+
+- 설정 중에 수집된 정보
+- 생성/가져온 문서
+- 현재 마일스톤 세부사항
+- 프로젝트 메타데이터
+
+**사용자 상호작용 불필요** - 완료될 때 알리기만 하세요
+
+### 7. 다음 단계 제공
+
+**설정을 바탕으로 맞춤형 안내:**
+
+```
+✅ [프로젝트 이름]에 대한 AIWF 초기화 완료!
+
+현재 설정:
+- 프로젝트 유형: [유형]
+- 현재 마일스톤: [마일스톤]
+- 문서: [생성/가져온 항목]
+
+다음 단계:
+- 아키텍처 검토: 01_PROJECT_DOCS/ARCHITECTURE.md
+- 마일스톤 요구사항 확인: 02_REQUIREMENTS/[마일스톤]/
+- 첫 번째 태스크 시작: /project:aiwf:create_general_task
+
+개발을 시작할 준비가 완료되었습니다!
+```
+
+## 적응형 프로세스 노트
+
+- **대화형 유지** - 양식처럼이 아닌 자연스럽게 질문하기
+- **스마트하게** - AI를 사용하여 맥락을 이해하고 지능적인 제안 만들기
+- **유연성 허용** - 사용자가 언제든지 건너뛰기, 취소, 수정 가능
+- **가치에 집중** - 특정 프로젝트에 유용한 것만 생성
+- **단순하게 유지** - 옵션이나 세부사항으로 압도하지 않기

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

@@ -0,0 +1,65 @@
+# 태스크에서 GitHub 이슈 생성
+
+태스크 파일을 기반으로 GitHub 이슈를 자동으로 생성합니다.
+
+## 정확히 다음 5개 항목으로 TODO 생성
+
+1. Parse task file and extract information
+2. Generate issue template
+3. Create issue via GitHub API
+4. Update task file with issue number
+5. Report results
+
+## 1 · Parse Task File
+
+Get task ID from <$ARGUMENTS>:
+- Sprint tasks: Search `.aiwf/03_SPRINTS/`
+- General tasks: Search `.aiwf/04_GENERAL_TASKS/`
+
+Extract from task file:
+- Title
+- Description
+- Acceptance criteria
+- Labels (sprint number, task type)
+
+## 2 · Generate Issue Template
+
+```markdown
+## 📋 Task: {task_title}
+
+### Description
+{task_description}
+
+### Acceptance Criteria
+{acceptance_criteria}
+
+### Related Information
+- Task ID: {task_id}
+- Sprint: {sprint_id}
+- Task file: `.aiwf/.../{task_file}`
+```
+
+## 3 · Create GitHub Issue
+
+```bash
+gh issue create \
+  --title "{task_id}: {task_title}" \
+  --body "{issue_body}" \
+  --label "task,{sprint_label}" \
+  --assignee "@me"
+```
+
+Capture the created issue number
+
+## 4 · Update Task File
+
+Add to task file frontmatter:
+```yaml
+github_issue: #{issue_number}
+```
+
+## 5 · Report Results
+
+✅ **Issue Created**: #{issue_number}
+🔗 **Link**: {issue_url}
+📄 **Task**: {task_id}

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 초기화 (언어 선택 포함)