aiwf 0.3.0 → 0.3.2

package/docs/COMMANDS_GUIDE.ko.md

@@ -6,19 +6,89 @@
 
 ## 명령어 개요
 
-AIWF 명령어는 `/aiwf_<command_name> [arguments]` 형식을 따릅니다.
+AIWF 명령어는 `/<command_name> [arguments]` 형식을 따릅니다.
 
 > **참고**:
 >
-> - 이전 버전과의 호환성을 위해 `/aiwf_<command_name>` 형식도 계속 지원됩니다.
+> - 이전 버전과의 호환성을 위해 `/project:aiwf:<command_name>` 형식도 계속 지원됩니다.
 > - 한국어 명령어는 `_kr` 접미사를 가질 수 있습니다 (예: `/aiwf_initialize_kr`)
 
-## 언어별 명령어
+## 언어 관리 시스템
+
+### 언어 지원 기능
+
+AIWF에는 다음과 같은 포괄적인 언어 관리 시스템이 포함되어 있습니다:
+
+- **지능형 언어 감지**: 시스템 언어 설정을 자동으로 감지
+- **영구 언어 저장**: 향후 설치를 위한 언어 설정 저장
+- **대화형 언어 전환**: 간단한 명령어로 언어 간 전환
+- **명령줄 언어 도구**: 언어 관리 전용 CLI 도구
+
+### 언어 관리 명령어
+
+#### 🌐 `/aiwf_language_manager`
+
+**목적**: 포괄적인 언어 관리 인터페이스
+
+**사용법**:
+
+```
+/aiwf_language_manager
+```
+
+**동작**:
+
+- 현재 언어 설정 및 선호도 표시
+- 대화형으로 언어 변경 옵션 제공
+- 언어 감지 및 저장 관리
+- 시스템 전체의 언어 설정 검증
+
+#### 🔍 `/aiwf_language_status`
+
+**목적**: 현재 언어 구성 및 상태 확인
+
+**사용법**:
+
+```
+/aiwf_language_status
+```
+
+**동작**:
+
+- 현재 활성 언어 표시
+- 감지된 시스템 언어 설정 표시
+- 언어 파일 가용성 및 일관성 보고
+- 언어별 설치 상태 제공
+
+#### 🔄 `/aiwf_switch_language`
+
+**목적**: 지원되는 언어 간 전환
+
+**사용법**:
+
+```
+/aiwf_switch_language
+# 대화형 언어 선택
+
+/aiwf_switch_language ko
+# 한국어로 전환
+
+/aiwf_switch_language en
+# 영어로 전환
+```
+
+**동작**:
+
+- 언어 설정 업데이트
+- 선택된 언어로 명령어 재설치
+- 프로젝트 설정 및 데이터 유지
+- 성공적인 언어 전환 확인 제공
 
 ### 명령어 버전
 
-- **기본 명령어**: 영어 또는 다국어 혼용
-- **한국어 명령어**: `_kr` 접미사가 있는 완전한 한국어 버전
+- **기본 명령어**: 영어 또는 표준화된 다국어
+- **한국어 명령어**: 완전한 기능 동등성을 갖춘 한국어 버전
+- **언어 관리**: 동일한 기능을 갖춘 양방향 언어 지원
 
 ## 설정 및 컨텍스트 명령어
 
@@ -548,6 +618,24 @@ AIWF 명령어는 `/aiwf_<command_name> [arguments]` 형식을 따릅니다.
 
 ---
 
+### ⚙️ `/aiwf_update_docs`
+
+**목적**: 프로젝트 문서 업데이트 및 동기화
+
+**사용법**:
+
+```
+/aiwf_update_docs
+```
+
+**동작**:
+
+1. 프로젝트 문서 구조 스캔
+2. 오래되거나 누락된 문서 식별
+3. 현재 프로젝트 상태를 반영하여 문서 업데이트
+4. 다양한 형식의 문서 간 동기화
+5. 문서 일관성 및 완성도 검증
+
 ### ⚙️ `/aiwf_prime_context`
 
 **목적**: 프로젝트 컨텍스트를 빠르게 불러와 프라임
@@ -635,3 +723,11 @@ AIWF 명령어에는 다음과 같은 안전 기능이 포함되어 있습니다
 2. 이 가이드 확인
 3. `.aiwf/`의 작업 예시 확인
 4. `.claude/commands/`의 명령어 소스 검토
+
+## 문서 업데이트
+
+**📝 중요**: 이 문서는 새로운 기능이 추가되거나 기존 명령어가 수정될 때 자동으로 업데이트됩니다. 정확한 명령어 정보를 위해 항상 최신 버전을 참조하세요.
+
+**언어 버전**: 이 가이드의 영어 및 한국어 버전은 언어 설치 간 일관성을 보장하기 위해 동시에 유지되고 업데이트됩니다.
+
+**최종 업데이트**: 2025-07-03 - 언어 관리 시스템 및 한국어 명령어 표준화

package/docs/COMMANDS_GUIDE.md

@@ -9,15 +9,86 @@ This guide explains the available AIWF commands and how to use them effectively
 AIWF commands follow the format `/aiwf_<command_name> [arguments]`.
 
 > **Note**:
-> - The `/aiwf_<command_name>` format is still supported for backward compatibility.
+>
+> - The `/project:aiwf:<command_name>` format is still supported for backward compatibility.
 > - Korean commands may have a `_kr` suffix (e.g., `/aiwf_initialize_kr`)
 
-## Language-Specific Commands
+## Language Management System
+
+### Language Support Features
+
+AIWF includes a comprehensive language management system with:
+
+- **Intelligent Language Detection**: Automatically detects system language preferences
+- **Persistent Language Storage**: Saves your language preference for future installations
+- **Interactive Language Switching**: Switch between languages with simple commands
+- **Command-Line Language Tools**: Dedicated CLI tools for language management
+
+### Language Commands
+
+#### 🌐 `/aiwf_language_manager`
+
+**Purpose**: Comprehensive language management interface
+
+**Usage**:
+
+```
+/aiwf_language_manager
+```
+
+**Behavior**:
+
+- Shows current language settings and preferences
+- Provides options to change language interactively
+- Manages language detection and storage
+- Validates language settings across the system
+
+#### 🔍 `/aiwf_language_status`
+
+**Purpose**: Check current language configuration and status
+
+**Usage**:
+
+```
+/aiwf_language_status
+```
+
+**Behavior**:
+
+- Displays current active language
+- Shows detected system language preferences
+- Reports language file availability and consistency
+- Provides language-specific installation status
+
+#### 🔄 `/aiwf_switch_language`
+
+**Purpose**: Switch between supported languages
+
+**Usage**:
+
+```
+/aiwf_switch_language
+# Interactive language selection
+
+/aiwf_switch_language ko
+# Switch to Korean
+
+/aiwf_switch_language en
+# Switch to English
+```
+
+**Behavior**:
+
+- Updates language preferences
+- Reinstalls commands in selected language
+- Maintains project settings and data
+- Provides confirmation of successful language switch
 
 ### Command Versions
 
-- **Default Commands**: English or mixed multilingual
-- **Korean Commands**: Complete Korean versions with `_kr` suffix
+- **Default Commands**: English or standardized multilingual
+- **Korean Commands**: Complete Korean versions with full feature parity
+- **Language Management**: Available in both languages with identical functionality
 
 ## Setup & Context Commands
 
@@ -547,6 +618,24 @@ AIWF commands follow the format `/aiwf_<command_name> [arguments]`.
 
 ---
 
+### ⚙️ `/aiwf_update_docs`
+
+**Purpose**: Update and synchronize project documentation
+
+**Usage**:
+
+```
+/aiwf_update_docs
+```
+
+**Behavior**:
+
+1. Scan project documentation structure
+2. Identify outdated or missing documentation
+3. Update documentation to reflect current project state
+4. Synchronize documentation across different formats
+5. Validate documentation consistency and completeness
+
 ### ⚙️ `/aiwf_prime_context`
 
 **Purpose**: Quickly load and prime project context
@@ -565,6 +654,184 @@ AIWF commands follow the format `/aiwf_<command_name> [arguments]`.
 4. Load context information
 5. Set task-ready state
 
+## AI Persona Commands
+
+### 🎭 `/project:aiwf:ai_persona:switch`
+
+**Purpose**: Switch to a specific AI persona for focused development tasks
+
+**Usage**:
+
+```
+/project:aiwf:ai_persona:switch architect
+# Switch to architect persona
+
+/project:aiwf:ai_persona:switch debugger
+# Switch to debugger persona
+```
+
+**Available Personas**:
+- `architect` - System design and architecture
+- `debugger` - Bug detection and troubleshooting
+- `reviewer` - Code quality and standards
+- `documenter` - Documentation and guides
+- `optimizer` - Performance optimization
+- `developer` - General development (default)
+
+### 🎭 `/project:aiwf:ai_persona:architect`
+
+**Purpose**: Shortcut to switch to architect persona
+
+**Usage**:
+
+```
+/project:aiwf:ai_persona:architect
+```
+
+**When to Use**: When designing system architecture, planning modules, creating technical designs
+
+### 🎭 `/project:aiwf:ai_persona:debugger`
+
+**Purpose**: Shortcut to switch to debugger persona
+
+**Usage**:
+
+```
+/project:aiwf:ai_persona:debugger
+```
+
+**When to Use**: When fixing bugs, tracing errors, investigating issues
+
+### 🎭 `/project:aiwf:ai_persona:reviewer`
+
+**Purpose**: Shortcut to switch to reviewer persona
+
+**Usage**:
+
+```
+/project:aiwf:ai_persona:reviewer
+```
+
+**When to Use**: When reviewing code, checking security, ensuring standards
+
+### 🎭 `/project:aiwf:ai_persona:documenter`
+
+**Purpose**: Shortcut to switch to documenter persona
+
+**Usage**:
+
+```
+/project:aiwf:ai_persona:documenter
+```
+
+**When to Use**: When writing documentation, creating guides, explaining features
+
+### 🎭 `/project:aiwf:ai_persona:optimizer`
+
+**Purpose**: Shortcut to switch to optimizer persona
+
+**Usage**:
+
+```
+/project:aiwf:ai_persona:optimizer
+```
+
+**When to Use**: When optimizing performance, reducing resource usage, improving efficiency
+
+### 🔄 `/project:aiwf:ai_persona:auto`
+
+**Purpose**: Enable or disable automatic persona detection
+
+**Usage**:
+
+```
+/project:aiwf:ai_persona:auto on
+# Enable auto-detection
+
+/project:aiwf:ai_persona:auto off
+# Disable auto-detection
+```
+
+**Behavior**: When enabled, Claude automatically switches personas based on task context
+
+### 📊 `/project:aiwf:ai_persona:status`
+
+**Purpose**: Display current persona and session metrics
+
+**Usage**:
+
+```
+/project:aiwf:ai_persona:status
+```
+
+**Output**: Shows current persona, behaviors, session duration, interactions, and token usage
+
+### 📋 `/project:aiwf:ai_persona:list`
+
+**Purpose**: List all available AI personas
+
+**Usage**:
+
+```
+/project:aiwf:ai_persona:list
+```
+
+**Output**: Shows all personas with descriptions and focus areas
+
+### 🔍 `/project:aiwf:ai_persona:detect`
+
+**Purpose**: Detect optimal persona for a specific task
+
+**Usage**:
+
+```
+/project:aiwf:ai_persona:detect "fix the authentication bug"
+# Detects debugger persona
+
+/project:aiwf:ai_persona:detect "design the API structure"
+# Detects architect persona
+```
+
+### 📈 `/project:aiwf:ai_persona:report`
+
+**Purpose**: Generate performance report for persona usage
+
+**Usage**:
+
+```
+/project:aiwf:ai_persona:report
+# Generate report for all time
+
+/project:aiwf:ai_persona:report week
+# Generate report for past week
+```
+
+**Output**: Performance metrics, persona usage statistics, recommendations
+
+### 📊 `/project:aiwf:ai_persona:stats`
+
+**Purpose**: View detailed statistics for a specific persona
+
+**Usage**:
+
+```
+/project:aiwf:ai_persona:stats debugger
+# View debugger persona stats
+
+/project:aiwf:ai_persona:stats
+# View current persona stats
+```
+
+### 🔄 `/project:aiwf:ai_persona:reset`
+
+**Purpose**: Reset persona system to default (developer)
+
+**Usage**:
+
+```
+/project:aiwf:ai_persona:reset
+```
+
 ## Best Practices
 
 ### Daily Workflow
@@ -573,6 +840,9 @@ AIWF commands follow the format `/aiwf_<command_name> [arguments]`.
 # Start of day
 /aiwf_prime
 
+# Enable AI persona auto-detection
+/project:aiwf:ai_persona:auto on
+
 # Work on tasks
 /aiwf_do_task
 /aiwf_test
@@ -580,6 +850,7 @@ AIWF commands follow the format `/aiwf_<command_name> [arguments]`.
 
 # End of day
 /aiwf_project_review
+/project:aiwf:ai_persona:report
 ```
 
 ### Sprint Workflow
@@ -615,6 +886,11 @@ AIWF commands follow the format `/aiwf_<command_name> [arguments]`.
 3. **Review before major commits**: Catch issues early
 4. **Create bugs as general tasks**: Keep them trackable
 5. **Use task-specific commits**: Better traceability
+6. **Enable AI persona auto-detection**: Let Claude automatically switch to the right mode
+7. **Use architect persona for planning**: Better system design decisions
+8. **Switch to debugger for bug fixing**: More systematic error analysis
+9. **Use optimizer persona sparingly**: Focus on actual bottlenecks
+10. **Check persona reports weekly**: Understand your development patterns
 
 ## Command Safety Features
 
@@ -633,4 +909,12 @@ If you need help with commands:
 1. Run commands without arguments to see usage info
 2. Check this guide
 3. Look at task examples in `.aiwf/`
-4. Review command sources in `.claude/commands/`
+4. Review command sources in `.claude/commands/`
+
+## Document Updates
+
+**📝 Important**: This document is automatically updated when new features are added or existing commands are modified. Always refer to the latest version for accurate command information.
+
+**Language Versions**: Both English and Korean versions of this guide are maintained and updated simultaneously to ensure consistency across language installations.
+
+**Last Updated**: 2025-07-09 - AI Persona System Integration and Documentation