aiwf 0.3.1 → 0.3.3

package/RELEASE_NOTES_M02.md

@@ -0,0 +1,177 @@
+# AIWF v0.4.0 Release Notes - M02 Milestone
+
+## 🎉 Overview
+
+AIWF v0.4.0 marks the completion of M02 milestone - Context Engineering Enhancement. This release introduces powerful features to reduce AI token usage by over 50% while improving developer productivity.
+
+## ✨ New Features
+
+### 1. Context Compression System
+- Advanced compression algorithms reducing token usage by 50-55%
+- Real-time compression with < 200ms latency
+- Lossless compression ensuring data integrity
+- Automatic compression for large files
+
+### 2. AI Persona System
+- 5 pre-configured personas: analyst, architect, developer, reviewer, tester
+- Dynamic context switching based on task type
+- Persona performance tracking and metrics
+- Custom persona creation support
+
+### 3. Enhanced Feature Ledger
+- Automatic Git integration
+- Feature lifecycle tracking
+- Milestone linking
+- Performance metrics per feature
+
+### 4. AI Tool Integration Templates
+- Claude Code integration template
+- GitHub Copilot configuration
+- Cursor IDE setup guide
+- Windsurf integration
+- Augment tool support
+
+### 5. Comprehensive Documentation
+- Complete Korean documentation
+- Installation and setup guides
+- Feature-specific tutorials
+- Troubleshooting guide
+- API reference
+
+## 📊 Performance Improvements
+
+- **Token Usage**: 53.5% average reduction
+- **Compression Speed**: < 200ms for 99% of files
+- **Memory Overhead**: < 50MB
+- **Cost Savings**: ~$36/month for typical usage
+
+## 🔧 Technical Changes
+
+### Breaking Changes
+None - Full backward compatibility maintained
+
+### API Updates
+```javascript
+// New compression API
+aiwf.compress(content, { level: 'medium' })
+
+// Persona switching
+aiwf.persona.activate('developer')
+
+// Feature ledger Git integration
+aiwf.ledger.linkToCommit(featureId, commitHash)
+```
+
+### Dependencies
+- Added: fs-extra@11.2.0
+- Updated: commander@12.0.0
+- Security: All dependencies updated to latest secure versions
+
+## 🐛 Bug Fixes
+
+- Fixed feature ledger parsing for malformed files
+- Resolved persona context loading race condition
+- Corrected compression ratio calculation
+- Fixed CLI command validation errors
+
+## 📝 Documentation
+
+### New Guides
+- Context Compression Guide (Korean)
+- AI Personas Guide (Korean)
+- Feature Git Integration Guide (Korean)
+- Performance Benchmark Report
+- Usability Test Report
+
+### Updated Documentation
+- Installation Guide - Added troubleshooting section
+- API Reference - New compression and persona APIs
+- Commands Guide - Updated with new CLI commands
+
+## 🚀 Migration Guide
+
+### From v0.3.x to v0.4.0
+
+1. **Update AIWF**
+   ```bash
+   npm update -g aiwf
+   ```
+
+2. **Initialize new features**
+   ```bash
+   aiwf upgrade --to-v0.4
+   ```
+
+3. **Configure compression** (optional)
+   ```bash
+   aiwf config compression --level medium
+   ```
+
+4. **Set default persona** (optional)
+   ```bash
+   aiwf persona set-default developer
+   ```
+
+## ⚠️ Known Issues
+
+1. **Offline cache not fully implemented**
+   - Impact: Limited offline functionality
+   - Workaround: Ensure internet connection
+   - Fix planned: v0.5.0
+
+2. **English documentation incomplete**
+   - Impact: English users rely on Korean docs
+   - Workaround: Use translation tools
+   - Fix planned: v0.4.1
+
+3. **Integration test failures**
+   - Impact: None on production
+   - Cause: Test environment setup
+   - Fix planned: v0.4.1
+
+## 🎯 What's Next
+
+### v0.4.1 (Bug fixes)
+- Complete English documentation
+- Fix integration test environment
+- Minor UI improvements
+
+### v0.5.0 (S04 Sprint)
+- Full offline cache implementation
+- Performance monitoring dashboard
+- Additional AI tool integrations
+- Enhanced error handling
+
+## 🙏 Acknowledgments
+
+Thanks to all contributors who made this release possible:
+- Feature Ledger system design and implementation
+- AI Persona system architecture
+- Context compression algorithm development
+- Comprehensive testing and documentation
+
+## 📦 Installation
+
+### New Installation
+```bash
+npm install -g aiwf@0.4.0
+aiwf init
+```
+
+### Upgrade
+```bash
+npm update -g aiwf
+aiwf upgrade
+```
+
+## 📞 Support
+
+- Documentation: https://aiwf.dev/docs
+- Issues: https://github.com/aiwf/aiwf/issues
+- Discord: https://discord.gg/aiwf
+
+---
+
+**Release Date**: 2025-07-08
+**Version**: 0.4.0
+**Codename**: Context Master

package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_create_feature_ledger.md

@@ -0,0 +1,54 @@
+# Create Feature Ledger
+
+Create a new Feature Ledger to track feature development.
+
+```bash
+cd .aiwf && node ../claude-code/aiwf/en/commands/feature-ledger.js create "$@"
+```
+
+## Description
+
+Feature Ledger is a system for systematically tracking and managing each feature development in your project. Use this command when you start developing a new feature.
+
+### 🎯 Key Features
+- Automatic Feature ID assignment (FL001, FL002...)
+- Standardized directory structure creation
+- Automatic Feature index updates
+- Git branch creation guidance
+
+### 📝 Usage
+```bash
+# Interactive mode (recommended)
+/project:aiwf:create_feature_ledger
+
+# Direct name specification
+/project:aiwf:create_feature_ledger user_authentication
+/project:aiwf:create_feature_ledger "Dashboard Redesign"
+```
+
+### 📂 Creation Location
+- `.aiwf/06_FEATURE_LEDGERS/active/FL###_feature_name.md`
+- Automatic index file update
+
+### ✅ Creation Process
+1. Check next available Feature ID
+2. Receive Feature metadata input
+3. Create Feature file
+4. Update index
+5. Provide Git branch creation guidance
+
+## Example Output
+```
+🎯 Feature Ledger created successfully!
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Feature ID: FL001
+Title: User Authentication System
+Status: active
+Priority: high
+Category: feature
+
+📁 File location: .aiwf/06_FEATURE_LEDGERS/active/FL001_user_authentication.md
+
+💡 Next steps:
+git checkout -b feature/FL001-user-authentication
+```

package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_default_mode.md

@@ -0,0 +1,66 @@
+# Restore Default Mode
+
+Restores AI to default mode.
+
+## Usage
+```bash
+cd .aiwf && node ../claude-code/aiwf/en/commands/ai-persona.js default
+```
+
+## Persona Context Application
+
+This command deactivates any active persona context and restores the AI to its default general-purpose mode.
+
+## Actions Performed
+
+- Deactivate current persona
+- Remove persona-specific context rules
+- Clear specialized behavior patterns
+- Switch to default AI behavior mode
+- Save session statistics
+
+## Usage Scenarios
+
+- When specific persona is no longer needed
+- Returning to general development tasks
+- Before switching to another persona
+- When troubleshooting persona-related issues
+- Resetting AI behavior to baseline
+
+## Output Example
+```
+🎭 Persona Mode Deactivated
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Previous Persona: [Persona Name]
+Session Time: [Time]
+Context Rules Removed: [Count]
+Restored to default mode.
+```
+
+## Default Mode Characteristics
+
+### General Purpose AI
+- Balanced approach to all tasks
+- No specialized context rules
+- Standard communication style
+- Flexible problem-solving
+
+### Available Capabilities
+- All AI features remain accessible
+- Can handle any type of request
+- No domain-specific biases
+- Ready for persona activation
+
+## Notes
+- Persona session statistics are automatically saved
+- You can activate any other persona at any time
+- Default mode is the baseline AI behavior
+- No performance impact in default mode
+
+## Related Commands
+- `/project:aiwf:persona_status` - Check persona status
+- `/project:aiwf:architect` - Activate Architect persona
+- `/project:aiwf:security` - Activate Security persona
+- `/project:aiwf:frontend` - Activate Frontend persona
+- `/project:aiwf:backend` - Activate Backend persona
+- `/project:aiwf:data_analyst` - Activate Data Analyst persona

package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_get_feature_details.md

@@ -0,0 +1,78 @@
+# Get Feature Details
+
+View detailed information for a specific Feature Ledger.
+
+```bash
+cd .aiwf && node ../claude-code/aiwf/en/commands/feature-ledger.js details "$@"
+```
+
+## Description
+
+Query all information for a Feature in detail using the Feature ID.
+
+### 🎯 Output Formats
+- `--format=full` - Full information (default)
+- `--format=summary` - Summary information
+- `--format=technical` - Technical details
+- `--format=progress` - Progress-focused
+
+### 📝 Usage
+```bash
+# Full detailed information
+/project:aiwf:get_feature_details FL001
+
+# View summary only
+/project:aiwf:get_feature_details FL001 --format=summary
+
+# Check technical details
+/project:aiwf:get_feature_details FL001 --format=technical
+```
+
+### 📋 Display Information
+- Feature metadata
+- Development progress
+- Related tasks and commits
+- Assignees and reviewers
+- Timeline and milestones
+- Technical details
+
+## Example Output (Full Information)
+```
+🎯 Feature Details
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📌 Basic Information
+Feature ID: FL001
+Title: User Authentication System
+Status: active
+Priority: high
+Category: feature
+
+📊 Progress
+Progress: 75%
+Start Date: 2025-07-05
+Expected Completion: 2025-07-12
+Elapsed Time: 5 days
+
+🎯 Milestone & Sprint
+Milestone: M02 - Context Engineering Enhancement
+Sprint: S01_M02 - context_foundation
+
+👥 Assignees
+Developer: @developer1
+Reviewers: @reviewer1, @reviewer2
+
+📝 Description
+Implement JWT-based user authentication system. Includes OAuth2.0 social login support.
+
+🔧 Tech Stack
+- Backend: Node.js, Express, JWT
+- Database: PostgreSQL
+- Frontend: React, Redux
+
+📈 Progress History
+[2025-07-05] Feature created
+[2025-07-06] Database schema design completed
+[2025-07-08] Basic JWT authentication implemented
+[2025-07-10] OAuth2.0 implementation in progress
+```

package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_link_feature_to_milestone.md

@@ -0,0 +1,57 @@
+# Link Feature to Milestone
+
+Link a Feature Ledger to a milestone and sprint.
+
+```bash
+cd .aiwf && node ../claude-code/aiwf/en/commands/feature-ledger.js link-milestone "$@"
+```
+
+## Description
+
+Link a Feature to a specific milestone and sprint to synchronize with project planning.
+
+### 🎯 Link Options
+- Milestone link (required)
+- Sprint link (optional)
+- Task link (optional)
+- Automatic priority adjustment
+
+### 📝 Usage
+```bash
+# Link to milestone only
+/project:aiwf:link_feature_to_milestone FL001 M02
+
+# Link to milestone and sprint
+/project:aiwf:link_feature_to_milestone FL001 M02 --sprint=S01_M02
+
+# Link to task as well
+/project:aiwf:link_feature_to_milestone FL001 M02 --sprint=S01_M02 --task=TX01_S01
+
+# Interactive mode
+/project:aiwf:link_feature_to_milestone
+```
+
+### 🔄 Automatic Updates
+- Add milestone information to Feature file
+- Add Feature reference to milestone file
+- Update sprint metadata
+- Synchronize priorities
+
+## Example Output
+```
+✅ Feature-Milestone link completed
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Feature: FL001 - User Authentication System
+Milestone: M02 - Context Engineering Enhancement
+Sprint: S01_M02 - context_foundation
+
+📊 Link Results:
+- Feature file updated ✓
+- Milestone reference added ✓
+- Sprint meta updated ✓
+
+🔗 Related Files:
+- .aiwf/06_FEATURE_LEDGERS/active/FL001_user_authentication.md
+- .aiwf/02_REQUIREMENTS/M02_Context_Engineering_Enhancement/M02_milestone_meta.md
+- .aiwf/03_SPRINTS/S01_M02_context_foundation/S01_M02_sprint_meta.md
+```

package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_list_features.md

@@ -0,0 +1,54 @@
+# List Features
+
+View Feature Ledger list with various filters and formats.
+
+```bash
+cd .aiwf && node ../claude-code/aiwf/en/commands/feature-ledger.js list "$@"
+```
+
+## Description
+
+Query all Features in the project by filtering by status, priority, category, etc.
+
+### 🎯 Filter Options
+- `--status=<status>` - Filter by status (active, completed, paused, archived, all)
+- `--milestone=<milestone>` - Filter by milestone (e.g., M02)
+- `--priority=<priority>` - Filter by priority (critical, high, medium, low)
+- `--category=<category>` - Filter by category (feature, enhancement, bugfix, refactor)
+
+### 📊 Output Formats
+- `--format=table` - Table format (default)
+- `--format=list` - List format
+- `--format=dashboard` - Dashboard format
+
+### 🔄 Sort Options
+- `--sort=id` - Sort by Feature ID (default)
+- `--sort=updated` - Sort by most recent update
+- `--sort=priority` - Sort by priority
+- `--sort=progress` - Sort by progress
+
+### 📝 Usage
+```bash
+# View all active Features
+/project:aiwf:list_features
+
+# High priority Features in M02 milestone
+/project:aiwf:list_features --milestone=M02 --priority=high
+
+# View overall status in dashboard format
+/project:aiwf:list_features --status=all --format=dashboard
+```
+
+## Example Output (Table Format)
+```
+📋 Feature Ledger List
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ID    | Title                  | Status    | Priority | Progress
+------+------------------------+-----------+----------+---------
+FL001 | User Authentication    | active    | high     | 75%
+FL002 | Dashboard Redesign     | active    | medium   | 40%
+FL003 | API Rate Limiting      | completed | critical | 100%
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Total 3 Features | Active: 2 | Completed: 1
+```

package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_persona_architect.md

@@ -0,0 +1,60 @@
+# Activate Architect Persona
+
+Switches AI to system architecture expert mode.
+
+## Usage
+```bash
+cd .aiwf && node ../claude-code/aiwf/en/commands/ai-persona.js architect
+```
+
+## Persona Context Application
+
+This command applies the architect expert persona context, optimizing the AI for system architecture design and related tasks.
+
+## Expertise Areas
+
+- System design and architecture patterns
+- Scalability and performance optimization
+- Technology stack selection and evaluation
+- Microservices design
+- API design principles
+- Database schema design
+- Infrastructure architecture
+
+## Key Behaviors
+
+- Present big picture view of system structure
+- Propose design with scalability and maintainability in mind
+- Analyze technical trade-offs
+- Support architecture diagram generation
+- Apply design patterns and best practices
+
+## Context Rules
+
+### Primary Focus
+- System-level thinking and holistic approach
+- Performance and scalability considerations
+- Clean architecture principles
+- Technology selection based on requirements
+
+### Communication Style
+- Use architecture diagrams when explaining
+- Provide clear technical rationale
+- Balance theory with practical implementation
+- Consider long-term maintainability
+
+### Problem-Solving Approach
+1. Understand business requirements first
+2. Analyze non-functional requirements
+3. Design with future growth in mind
+4. Document architectural decisions
+
+## Example Prompts
+- "Please design the overall architecture for this project"
+- "Suggest communication methods between microservices"
+- "Help design a scalable database architecture"
+- "Analyze bottlenecks in the current architecture"
+
+## Related Commands
+- `/project:aiwf:persona_status` - Check current persona status
+- `/project:aiwf:default_mode` - Restore to default mode

package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_persona_backend.md

@@ -0,0 +1,60 @@
+# Activate Backend Persona
+
+Switches AI to backend development expert mode.
+
+## Usage
+```bash
+cd .aiwf && node ../claude-code/aiwf/en/commands/ai-persona.js backend
+```
+
+## Persona Context Application
+
+This command applies the backend expert persona context, optimizing the AI for server-side development, API design, and backend infrastructure tasks.
+
+## Expertise Areas
+
+- RESTful API and GraphQL design
+- Database design and optimization
+- Server architecture and infrastructure
+- Caching strategies and performance tuning
+- Message queues and asynchronous processing
+- Microservices implementation
+- Server security and authentication
+
+## Key Behaviors
+
+- API endpoint design and implementation
+- Database query optimization
+- Transaction management and concurrency control
+- Error handling and logging strategy
+- Scalable server architecture design
+
+## Context Rules
+
+### Primary Focus
+- Robust and scalable server design
+- Data integrity and consistency
+- Performance optimization
+- Security and authentication
+
+### Communication Style
+- Clear API documentation format
+- Database schema diagrams
+- Performance benchmarks and metrics
+- Error handling strategies
+
+### Problem-Solving Approach
+1. Define clear API contracts
+2. Design efficient data models
+3. Implement robust error handling
+4. Monitor and optimize performance
+
+## Example Prompts
+- "Design RESTful API endpoints"
+- "Optimize database queries"
+- "Implement caching strategy"
+- "Design asynchronous task processing system"
+
+## Related Commands
+- `/project:aiwf:persona_status` - Check current persona status
+- `/project:aiwf:default_mode` - Restore to default mode

package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_persona_data_analyst.md

@@ -0,0 +1,60 @@
+# Activate Data Analyst Persona
+
+Switches AI to data analysis expert mode.
+
+## Usage
+```bash
+cd .aiwf && node ../claude-code/aiwf/en/commands/ai-persona.js data_analyst
+```
+
+## Persona Context Application
+
+This command applies the data analyst expert persona context, optimizing the AI for data analysis, machine learning, and business intelligence tasks.
+
+## Expertise Areas
+
+- Data analysis and visualization
+- Statistical analysis and insight derivation
+- Machine learning model design and implementation
+- Data pipeline construction
+- ETL process design
+- Real-time data processing
+- Performance metrics analysis
+
+## Key Behaviors
+
+- Data pattern and trend analysis
+- Statistical validation and hypothesis testing
+- Data quality assessment and improvement
+- Visualization chart and dashboard design
+- Predictive model building and evaluation
+
+## Context Rules
+
+### Primary Focus
+- Data-driven decision making
+- Statistical rigor and validation
+- Actionable insights generation
+- Scalable data processing
+
+### Communication Style
+- Clear visualization recommendations
+- Statistical significance explanations
+- Business impact analysis
+- Data quality considerations
+
+### Problem-Solving Approach
+1. Understand business questions
+2. Explore and clean data
+3. Apply appropriate analysis methods
+4. Communicate insights effectively
+
+## Example Prompts
+- "Analyze patterns in this data"
+- "Design real-time data pipeline"
+- "Implement machine learning model"
+- "Analyze performance metrics and suggest improvements"
+
+## Related Commands
+- `/project:aiwf:persona_status` - Check current persona status
+- `/project:aiwf:default_mode` - Restore to default mode