aiwf 0.3.1 → 0.3.2

package/docs/COMMANDS_GUIDE.ko.md

@@ -6,11 +6,11 @@
 
 ## 명령어 개요
 
-AIWF 명령어는 `/aiwf_<command_name> [arguments]` 형식을 따릅니다.
+AIWF 명령어는 `/<command_name> [arguments]` 형식을 따릅니다.
 
 > **참고**:
 >
-> - 이전 버전과의 호환성을 위해 `/aiwf_<command_name>` 형식도 계속 지원됩니다.
+> - 이전 버전과의 호환성을 위해 `/project:aiwf:<command_name>` 형식도 계속 지원됩니다.
 > - 한국어 명령어는 `_kr` 접미사를 가질 수 있습니다 (예: `/aiwf_initialize_kr`)
 
 ## 언어 관리 시스템
@@ -31,11 +31,13 @@ AIWF에는 다음과 같은 포괄적인 언어 관리 시스템이 포함되어
 **목적**: 포괄적인 언어 관리 인터페이스
 
 **사용법**:
+
 ```
 /aiwf_language_manager
 ```
 
 **동작**:
+
 - 현재 언어 설정 및 선호도 표시
 - 대화형으로 언어 변경 옵션 제공
 - 언어 감지 및 저장 관리
@@ -46,11 +48,13 @@ AIWF에는 다음과 같은 포괄적인 언어 관리 시스템이 포함되어
 **목적**: 현재 언어 구성 및 상태 확인
 
 **사용법**:
+
 ```
 /aiwf_language_status
 ```
 
 **동작**:
+
 - 현재 활성 언어 표시
 - 감지된 시스템 언어 설정 표시
 - 언어 파일 가용성 및 일관성 보고
@@ -61,6 +65,7 @@ AIWF에는 다음과 같은 포괄적인 언어 관리 시스템이 포함되어
 **목적**: 지원되는 언어 간 전환
 
 **사용법**:
+
 ```
 /aiwf_switch_language
 # 대화형 언어 선택
@@ -73,6 +78,7 @@ AIWF에는 다음과 같은 포괄적인 언어 관리 시스템이 포함되어
 ```
 
 **동작**:
+
 - 언어 설정 업데이트
 - 선택된 언어로 명령어 재설치
 - 프로젝트 설정 및 데이터 유지

package/docs/COMMANDS_GUIDE.md

@@ -9,7 +9,8 @@ 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 Management System
@@ -30,11 +31,13 @@ AIWF includes a comprehensive language management system with:
 **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
@@ -45,11 +48,13 @@ AIWF includes a comprehensive language management system with:
 **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
@@ -60,6 +65,7 @@ AIWF includes a comprehensive language management system with:
 **Purpose**: Switch between supported languages
 
 **Usage**:
+
 ```
 /aiwf_switch_language
 # Interactive language selection
@@ -72,6 +78,7 @@ AIWF includes a comprehensive language management system with:
 ```
 
 **Behavior**:
+
 - Updates language preferences
 - Reinstalls commands in selected language
 - Maintains project settings and data
@@ -647,6 +654,184 @@ AIWF includes a comprehensive language management system with:
 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
@@ -655,6 +840,9 @@ AIWF includes a comprehensive language management system with:
 # Start of day
 /aiwf_prime
 
+# Enable AI persona auto-detection
+/project:aiwf:ai_persona:auto on
+
 # Work on tasks
 /aiwf_do_task
 /aiwf_test
@@ -662,6 +850,7 @@ AIWF includes a comprehensive language management system with:
 
 # End of day
 /aiwf_project_review
+/project:aiwf:ai_persona:report
 ```
 
 ### Sprint Workflow
@@ -697,6 +886,11 @@ AIWF includes a comprehensive language management system with:
 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
 
@@ -723,4 +917,4 @@ If you need help with commands:
 
 **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-03 - Language Management System and Korean Commands Standardization
+**Last Updated**: 2025-07-09 - AI Persona System Integration and Documentation