aiwf 0.3.1 → 0.3.3

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

@@ -0,0 +1,50 @@
+# 페르소나 상태 확인
+
+현재 활성화된 AI 페르소나의 상태를 확인합니다.
+
+```bash
+cd .aiwf && node ../claude-code/aiwf/ko/commands/ai-persona.js status
+```
+
+## 설명
+이 명령어는 현재 활성화된 페르소나의 정보와 통계를 표시합니다:
+
+- 현재 활성 페르소나 이름
+- 페르소나 설명 및 전문 분야
+- 활성화 시간
+- 사용 통계 (사용 횟수, 평균 세션 시간)
+- 주요 동작 특성
+
+## 표시 정보
+```
+🎭 AI 페르소나 상태
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+현재 페르소나: [페르소나명]
+설명: [페르소나 설명]
+활성화 시간: [시간]
+
+주요 동작:
+• [동작 특성 1]
+• [동작 특성 2]
+• [동작 특성 3]
+
+사용 통계:
+• 총 사용 횟수: [횟수]
+• 평균 세션 시간: [시간]
+• 마지막 사용: [날짜/시간]
+```
+
+## 사용 가능한 페르소나
+- `architect` - 시스템 아키텍처 전문가
+- `security` - 보안 전문가
+- `frontend` - 프론트엔드 개발 전문가
+- `backend` - 백엔드 개발 전문가
+- `data_analyst` - 데이터 분석 전문가
+
+## 관련 명령어
+- `/project:aiwf:architect` - Architect 페르소나 활성화
+- `/project:aiwf:security` - Security 페르소나 활성화
+- `/project:aiwf:frontend` - Frontend 페르소나 활성화
+- `/project:aiwf:backend` - Backend 페르소나 활성화
+- `/project:aiwf:data_analyst` - Data Analyst 페르소나 활성화
+- `/project:aiwf:default_mode` - 기본 모드로 복원

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

@@ -0,0 +1,25 @@
+# aiwf_update_docs_kr
+
+이 명령은 한국어 AIWF 문서를 업데이트합니다.
+
+## 사용법
+
+이 명령을 사용하여 한국어 프로젝트 문서를 최신 상태로 유지합니다.
+
+## 주요 기능
+
+1. README.md 업데이트
+2. 프로젝트 구조 문서 업데이트
+3. API 문서 업데이트
+4. 사용자 가이드 업데이트
+
+## 실행 방법
+
+```bash
+aiwf update-docs-kr
+```
+
+## 주의사항
+
+- 이 명령은 한국어 프로젝트에서만 사용 가능합니다
+- 문서 업데이트 전 현재 작업을 커밋하는 것을 권장합니다

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

@@ -0,0 +1,53 @@
+# Feature 상태 업데이트
+
+Feature Ledger의 상태를 변경합니다.
+
+```bash
+cd .aiwf && node ../claude-code/aiwf/ko/commands/feature-ledger.js update-status "$@"
+```
+
+## 설명
+
+Feature의 개발 진행 상태를 업데이트합니다. 상태 전이 규칙에 따라 올바른 상태로만 변경 가능합니다.
+
+### 🎯 지원 상태
+- `active` - 현재 개발 중
+- `completed` - 개발 완료
+- `paused` - 일시 중지
+- `archived` - 보관됨
+
+### 📝 사용법
+```bash
+# 상태 변경
+/project:aiwf:update_feature_status FL001 completed
+/project:aiwf:update_feature_status FL002 paused
+
+# 대화형 모드
+/project:aiwf:update_feature_status
+```
+
+### ⚡ 상태 전이 규칙
+- active → completed, paused, archived
+- paused → active, archived
+- completed → archived
+- archived → (전이 불가)
+
+### 📋 업데이트 내용
+- 상태 변경 기록
+- 타임스탬프 자동 추가
+- 변경 사유 입력 (선택)
+- 인덱스 파일 자동 업데이트
+
+## 예시 출력
+```
+✅ Feature 상태 업데이트 완료
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Feature ID: FL001
+이전 상태: active → 새 상태: completed
+업데이트 시간: 2025-07-10 11:30:00
+
+📊 완료 통계:
+- 소요 시간: 5일
+- 커밋 수: 23개
+- 관련 PR: #45, #47
+```

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

@@ -2,7 +2,7 @@
 
 이 모드는 사용자 상호작용 없이 실행되도록 설계되었습니다.
 사용자에게 질문하거나 확인을 요청하지 **마세요**
-의심스러울 때는 최선의 해결책에 대해 **조사**하고 **초월적으로 생각**하세요.
+의심스러울 때는 최선의 해결책에 대해 **RESEARCH**하고 **ULTRATHINK**하세요.
 
 **중요** 특정 지점에서 멈추지 않으려고 노력하되, 신중한 고려 후 필요하다면 그렇게 하세요.
 
@@ -297,4 +297,4 @@ S05: ⏳ 계획됨 (0/0 태스크)
 - 프로젝트 상태 개요
 - 권장 다음 단계
 
-작업이 완료되었습니다. 감사합니다.
+작업이 완료되었습니다. 감사합니다.

package/claude-code/aiwf/ko/CLAUDE.md

@@ -0,0 +1,76 @@
+# CLAUDE.md - AIWF Framework Structure Guide
+
+Always communicate in Korean
+
+## Overview
+
+This is the root directory of the AIWF framework structure. It contains all project documentation, requirements, sprints, and organizational files.
+
+## Critical Files
+
+### Project Manifest
+
+**IMPORTANT**: The project manifest file MUST be named:
+
+```
+00_PROJECT_MANIFEST.md
+```
+
+**NOT**:
+
+- ❌ `MANIFEST.md`
+- ❌ `PROJECT_MANIFEST.md`
+- ❌ `project_manifest.md`
+
+The manifest is the central reference file that tracks:
+
+- Project name and status
+- Current milestone and sprint
+- Project metadata
+- Last updated timestamp
+
+## Directory Structure
+
+```
+.AIWF/
+├── 00_PROJECT_MANIFEST.md          # Central project reference (CORRECT NAME)
+├── 01_PROJECT_DOCS/                # General project documentation
+├── 02_REQUIREMENTS/                # Milestone-based requirements
+├── 03_SPRINTS/                     # Sprint execution folders
+├── 04_GENERAL_TASKS/               # Non-sprint tasks
+├── 05_ARCHITECTURAL_DECISIONS/     # ADR documentation
+├── 10_STATE_OF_PROJECT/            # Project review snapshots
+└── 99_TEMPLATES/                   # Document templates
+```
+
+## Naming Conventions Summary
+
+### Files
+
+- **Project Manifest**: `00_PROJECT_MANIFEST.md`
+- **Milestone Meta**: `M##_milestone_meta.md`
+- **Sprint Meta**: `S##_M##_sprint_meta.md`
+- **Task Files**: `TASK_##_*.md`
+- **ADR Files**: `ADR_###_*.md`
+
+### Folders
+
+- **Milestones**: `M##_Milestone_Name/`
+- **Sprints**: `S##_M##_Sprint_Name/`
+- **State Snapshots**: `YYYY-MM-DD_HH-MM_snapshot/`
+
+## Important Notes for Claude Code
+
+1. **Always create `00_PROJECT_MANIFEST.md`** when initializing a project
+2. **Use the templates** from `99_TEMPLATES/` for consistency
+3. **Follow the naming conventions exactly** - they enable proper sorting and navigation
+4. **Update the manifest** when creating milestones or sprints
+5. **Use underscores** for spaces in folder and file names
+
+## Common Initialization Mistakes
+
+- Creating `MANIFEST.md` instead of `00_PROJECT_MANIFEST.md`
+- Missing the leading zeros in numbered prefixes
+- Using hyphens instead of underscores
+- Creating files without using templates
+- Not updating the manifest after structural changes

package/claude-code/aiwf/ko/ai-tools/README.md

@@ -0,0 +1,105 @@
+# AIWF AI Tool Integration Templates
+
+This directory contains integration templates for various AI development tools to work seamlessly with the AI Workflow Framework (AIWF).
+
+## Available Tools
+
+### 1. Claude Code (`claude-code`)
+- **Description**: Official Anthropic Claude Code integration
+- **Features**: Deep AIWF integration, feature ledger sync, AI personas
+- **Installation**: `aiwf ai-tool install claude-code`
+
+### 2. GitHub Copilot (`github-copilot`)
+- **Description**: GitHub Copilot configuration for AIWF projects
+- **Features**: Feature-aware suggestions, sprint task integration
+- **Installation**: `aiwf ai-tool install github-copilot`
+
+### 3. Cursor (`cursor`)
+- **Description**: Cursor IDE integration with AIWF
+- **Features**: Multi-file context, composer enhancement, task tracking
+- **Installation**: `aiwf ai-tool install cursor`
+
+### 4. Windsurf (`windsurf`)
+- **Description**: Windsurf IDE with Cascade AI integration
+- **Features**: Flow-based development, multi-agent support, visual progress
+- **Installation**: `aiwf ai-tool install windsurf`
+
+### 5. Augment (`augment`)
+- **Description**: Augment Code with deep codebase understanding
+- **Features**: Team collaboration, knowledge queries, smart refactoring
+- **Installation**: `aiwf ai-tool install augment`
+
+## Quick Start
+
+1. **List available tools**:
+   ```bash
+   aiwf ai-tool list
+   ```
+
+2. **Install a tool**:
+   ```bash
+   aiwf ai-tool install <tool-name>
+   ```
+
+3. **Update installed tools**:
+   ```bash
+   aiwf ai-tool update <tool-name>
+   ```
+
+4. **Verify installation**:
+   ```bash
+   aiwf ai-tool verify <tool-name>
+   ```
+
+## Integration Features
+
+All templates provide:
+- ✅ Feature Ledger integration
+- ✅ AI Persona support
+- ✅ Sprint task management
+- ✅ Context optimization
+- ✅ Offline cache support
+
+## Directory Structure
+
+```
+ai-tools/
+├── claude-code/
+│   ├── template/
+│   ├── config.json
+│   └── README.md
+├── github-copilot/
+│   ├── template/
+│   ├── config.json
+│   └── README.md
+├── cursor/
+│   ├── template/
+│   ├── config.json
+│   └── README.md
+├── windsurf/
+│   ├── template/
+│   ├── config.json
+│   └── README.md
+└── augment/
+    ├── template/
+    ├── config.json
+    └── README.md
+```
+
+## Customization
+
+Each tool template can be customized:
+1. Edit the template files in the tool directory
+2. Modify config.json for tool-specific settings
+3. Add project-specific rules to the template files
+
+## Support
+
+For issues or questions:
+- Check individual tool README files
+- Visit [AIWF Documentation](https://aiwf.dev)
+- Submit issues on GitHub
+
+---
+
+*AIWF AI Tool Integration System v1.0.0*

package/claude-code/aiwf/ko/ai-tools/augment/README.md

@@ -0,0 +1,371 @@
+# Augment AIWF Integration Template
+
+## Overview
+
+This template integrates Augment Code's deep codebase understanding and team collaboration features with AIWF's structured development framework. It creates a powerful combination for AI-assisted team development.
+
+## Features
+
+- **Deep Codebase Understanding**: Augment comprehends your entire AIWF structure
+- **Team Collaboration**: Shared feature knowledge and task coordination
+- **Intelligent Code Completion**: Context-aware suggestions based on features
+- **Automated Documentation**: Generate docs aligned with AIWF standards
+- **Smart Refactoring**: Feature-aware code improvements
+- **Knowledge Queries**: Ask questions about your AIWF project
+
+## Installation
+
+```bash
+# Install Augment template
+aiwf ai-tool install augment
+
+# Or manually copy template files
+cp -r .aiwf/ai-tools/augment/template/* .
+```
+
+## Configuration
+
+The template includes:
+
+1. **augment.config.json**: Main configuration
+   - AIWF integration settings
+   - Team collaboration options
+   - AI model preferences
+   - Automation rules
+
+2. **.augment/aiwf-integration.md**: Integration guide
+   - Usage patterns
+   - Team features
+   - Best practices
+   - Command reference
+
+## Core Capabilities
+
+### 1. Feature-Aware Development
+
+Augment understands your Feature Ledger:
+
+```javascript
+// Start typing code
+function createUser() {
+  // Augment suggests:
+  // This relates to Feature FL-002 - User Management
+  // Dependencies: FL-001 (Authentication)
+  // Current status: in_progress
+}
+```
+
+### 2. Team Knowledge Sharing
+
+Share understanding across your team:
+
+```
+@augment who implemented authentication?
+// Alice implemented FL-001 last week
+
+@augment show alice's patterns for error handling
+// Shows consistent patterns from Alice's code
+```
+
+### 3. Sprint Task Management
+
+Stay aligned with sprints:
+
+```
+@augment my current tasks
+// T13_S03 - AI Tool Integration (in_progress)
+// T14_S03 - Performance Optimization (pending)
+
+@augment suggest next task
+// Based on your expertise and dependencies
+```
+
+### 4. Intelligent Documentation
+
+Auto-generate AIWF-compliant docs:
+
+```javascript
+// @augment document this class
+/**
+ * UserService handles user management operations
+ * 
+ * @feature FL-002 - User Management
+ * @sprint S03
+ * @implements Requirements from FL-002 specification
+ * @dependencies FL-001 (Authentication)
+ * 
+ * @example
+ * const userService = new UserService();
+ * const user = await userService.createUser(data);
+ */
+class UserService {
+  // Implementation
+}
+```
+
+## Usage Examples
+
+### 1. Feature Development
+
+```javascript
+// @augment implement FL-003 payment processing
+
+// Augment provides:
+// - Feature specification summary
+// - Required methods from spec
+// - Integration points with other features
+// - Test requirements
+// - Documentation template
+```
+
+### 2. Code Review
+
+```javascript
+// @augment review this PR for FL-001 compliance
+
+// Augment checks:
+// ✓ Implements all required features
+// ✓ Follows team patterns
+// ✓ Has appropriate tests
+// ⚠ Missing error handling for edge case X
+// ⚠ Consider using established pattern from auth.js
+```
+
+### 3. Refactoring
+
+```javascript
+// @augment refactor payment module for better feature separation
+
+// Augment suggests:
+// 1. Extract FL-003 logic to PaymentService
+// 2. Move FL-001 auth checks to middleware
+// 3. Create feature flags for gradual rollout
+// 4. Add monitoring for new architecture
+```
+
+### 4. Knowledge Queries
+
+```
+@augment how does our authentication flow work?
+// Augment explains FL-001 implementation with code examples
+
+@augment what depends on the user service?
+// Features: FL-003 (payments), FL-004 (notifications)
+// Files: 15 controllers, 8 services, 23 tests
+
+@augment show architecture diagram
+// Generates visual representation of feature dependencies
+```
+
+## Team Collaboration Features
+
+### 1. Expertise Mapping
+
+```
+@augment team expertise
+// Alice: FL-001 (auth), FL-002 (users) - Senior
+// Bob: FL-003 (payments), FL-005 (analytics) - Expert
+// Carol: FL-004 (notifications) - Intermediate
+```
+
+### 2. Task Assignment
+
+```
+@augment assign T14_S03
+// Recommends: Bob (payment expertise, available capacity)
+// Alternative: Alice (general expertise, higher load)
+```
+
+### 3. Code Patterns
+
+```
+@augment show team patterns for error handling
+// Consistent patterns across team:
+// - Custom error classes per feature
+// - Centralized error logging
+// - User-friendly error messages
+```
+
+### 4. Onboarding
+
+```
+@augment create onboarding guide for new developer
+// Generates comprehensive guide:
+// - Project structure
+// - Feature overview
+// - Team patterns
+// - Development workflow
+// - Key architecture decisions
+```
+
+## Advanced Features
+
+### 1. Codebase Analysis
+
+```
+@augment analyze feature coverage
+// FL-001: 95% implemented, 90% tested
+// FL-002: 80% implemented, 85% tested
+// FL-003: 60% implemented, 70% tested
+
+@augment find technical debt
+// - Duplicated auth logic in 3 files
+// - Missing tests for edge cases in FL-002
+// - Outdated dependencies in payment module
+```
+
+### 2. Architecture Insights
+
+```
+@augment analyze architecture
+// - Clean separation between features
+// - Some circular dependencies detected
+// - Opportunity to extract shared utilities
+// - Consider implementing event system
+```
+
+### 3. Performance Analysis
+
+```
+@augment analyze performance bottlenecks
+// - Database queries in user service (N+1)
+// - Synchronous payment processing
+// - Large bundle size from unused imports
+```
+
+### 4. Test Generation
+
+```javascript
+// @augment generate tests for UserService
+
+describe('UserService (FL-002)', () => {
+  // Generates comprehensive test suite
+  // based on feature specifications
+});
+```
+
+## Best Practices
+
+### 1. Feature-First Approach
+
+Always start with feature context:
+- Check Feature Ledger before coding
+- Reference features in all code
+- Update feature status regularly
+
+### 2. Team Alignment
+
+Leverage team features:
+- Share knowledge through Augment
+- Follow team patterns
+- Document decisions
+
+### 3. Sprint Discipline
+
+Stay focused on current work:
+- Check sprint tasks daily
+- Update progress regularly
+- Complete tasks fully
+
+### 4. Continuous Learning
+
+Let Augment teach:
+- Ask about unfamiliar code
+- Learn team patterns
+- Understand architecture
+
+## Configuration Options
+
+### 1. Model Selection
+
+```json
+{
+  "models": {
+    "completion": "augment-fast",      // Quick suggestions
+    "understanding": "augment-deep",   // Complex analysis
+    "documentation": "augment-doc",    // Doc generation
+    "review": "augment-review"         // Code review
+  }
+}
+```
+
+### 2. Team Settings
+
+```json
+{
+  "team": {
+    "sync_interval": "5m",
+    "share_patterns": true,
+    "expertise_tracking": true,
+    "automated_assignment": false
+  }
+}
+```
+
+### 3. Automation
+
+```json
+{
+  "automation": {
+    "auto_document": true,
+    "suggest_refactoring": true,
+    "update_feature_status": true,
+    "generate_tests": false
+  }
+}
+```
+
+## Troubleshooting
+
+### Common Issues
+
+1. **Slow indexing**
+   ```
+   @augment config set indexing.incremental true
+   @augment reindex --fast
+   ```
+
+2. **Team sync problems**
+   ```
+   @augment team sync --reset
+   @augment team verify
+   ```
+
+3. **Feature recognition**
+   ```
+   @augment feature reindex
+   @augment feature validate
+   ```
+
+### Performance Tips
+
+1. Enable caching for faster responses
+2. Use incremental indexing
+3. Compress large contexts
+4. Limit analysis scope when needed
+
+## Updates
+
+Keep Augment template current:
+
+```bash
+# Check version
+aiwf ai-tool version augment
+
+# Update template
+aiwf ai-tool update augment
+
+# Verify installation
+aiwf ai-tool verify augment
+```
+
+## Resources
+
+- [Augment Documentation](https://augmentcode.com/docs)
+- [AIWF Documentation](https://aiwf.dev/docs)
+- [Integration Examples](https://github.com/aiwf/augment-examples)
+- [Team Playbook](https://aiwf.dev/guides/team-collaboration)
+
+---
+
+*Augment Integration Template v1.0.0*