aiwf 0.3.2 → 0.3.4

package/.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/commands/aiwf/aiwf_link_feature_to_milestone.md

@@ -0,0 +1,57 @@
+# Feature를 마일스톤에 연결
+
+Feature Ledger를 마일스톤 및 스프린트와 연결합니다.
+
+```bash
+cd .aiwf && node ../claude-code/aiwf/ko/commands/feature-ledger.js link-milestone "$@"
+```
+
+## 설명
+
+Feature를 특정 마일스톤과 스프린트에 연결하여 프로젝트 계획과 동기화합니다.
+
+### 🎯 연결 옵션
+- 마일스톤 연결 (필수)
+- 스프린트 연결 (선택)
+- 태스크 연결 (선택)
+- 우선순위 자동 조정
+
+### 📝 사용법
+```bash
+# 마일스톤에만 연결
+/project:aiwf:link_feature_to_milestone FL001 M02
+
+# 마일스톤과 스프린트에 연결
+/project:aiwf:link_feature_to_milestone FL001 M02 --sprint=S01_M02
+
+# 태스크까지 연결
+/project:aiwf:link_feature_to_milestone FL001 M02 --sprint=S01_M02 --task=TX01_S01
+
+# 대화형 모드
+/project:aiwf:link_feature_to_milestone
+```
+
+### 🔄 자동 업데이트
+- Feature 파일에 마일스톤 정보 추가
+- 마일스톤 파일에 Feature 참조 추가
+- 스프린트 메타데이터 업데이트
+- 우선순위 동기화
+
+## 예시 출력
+```
+✅ Feature-마일스톤 연결 완료
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Feature: FL001 - User Authentication System
+마일스톤: M02 - Context Engineering Enhancement
+스프린트: S01_M02 - context_foundation
+
+📊 연결 결과:
+- Feature 파일 업데이트 ✓
+- 마일스톤 참조 추가 ✓
+- 스프린트 메타 업데이트 ✓
+
+🔗 관련 파일:
+- .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/commands/aiwf/aiwf_list_features.md

@@ -0,0 +1,54 @@
+# Feature 목록 조회
+
+Feature Ledger 목록을 다양한 필터와 형식으로 조회합니다.
+
+```bash
+cd .aiwf && node ../claude-code/aiwf/ko/commands/feature-ledger.js list "$@"
+```
+
+## 설명
+
+프로젝트의 모든 Feature를 상태, 우선순위, 카테고리 등으로 필터링하여 조회합니다.
+
+### 🎯 필터 옵션
+- `--status=<status>` - 상태별 필터 (active, completed, paused, archived, all)
+- `--milestone=<milestone>` - 마일스톤별 필터 (예: M02)
+- `--priority=<priority>` - 우선순위별 필터 (critical, high, medium, low)
+- `--category=<category>` - 카테고리별 필터 (feature, enhancement, bugfix, refactor)
+
+### 📊 출력 형식
+- `--format=table` - 테이블 형식 (기본값)
+- `--format=list` - 리스트 형식
+- `--format=dashboard` - 대시보드 형식
+
+### 🔄 정렬 옵션
+- `--sort=id` - Feature ID 순 (기본값)
+- `--sort=updated` - 최근 업데이트 순
+- `--sort=priority` - 우선순위 순
+- `--sort=progress` - 진행률 순
+
+### 📝 사용법
+```bash
+# 모든 active Feature 조회
+/project:aiwf:list_features
+
+# M02 마일스톤의 high 우선순위 Feature
+/project:aiwf:list_features --milestone=M02 --priority=high
+
+# 대시보드 형식으로 전체 현황 보기
+/project:aiwf:list_features --status=all --format=dashboard
+```
+
+## 예시 출력 (테이블 형식)
+```
+📋 Feature Ledger 목록
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ID    | Title                  | Status    | Priority | Progress
+------+------------------------+-----------+----------+---------
+FL001 | User Authentication    | active    | high     | 75%
+FL002 | Dashboard Redesign     | active    | medium   | 40%
+FL003 | API Rate Limiting      | completed | critical | 100%
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+총 3개 Feature | Active: 2 | Completed: 1
+```

package/.claude/commands/aiwf/aiwf_mermaid.md

@@ -0,0 +1,272 @@
+# Mermaid 다이어그램 유지 관리
+
+Instructions for generating, maintaining and updating the mermaid diagrams in the current project's architecture documentation.
+
+## 📋 Overview
+
+The architecture documentation should include comprehensive mermaid diagrams that illustrate:
+
+- System context and component relationships
+- Module dependencies and data flows (150+ modules)
+- Class hierarchies and interactions
+- Service layer patterns and UI architecture
+
+## 📂 Diagram Locations
+
+All architecture diagrams are to be stored in `/docs/architecture/`:
+
+```
+docs/architecture/
+├── README.md                           # Main architecture overview
+├── context_diagram.md                  # System context & data flow
+├── module_overview.md                  # Module relationships (150+ modules)
+└── class_diagrams/
+    ├── core_classes.md                 # Database, DAOs, data processing
+    ├── data_models.md                  # Domain models & database schema
+    └── service_layer.md                # UI architecture & service coordination
+```
+
+## 🛠️ Update Process
+
+### Step 1: Identify Affected Diagrams
+
+Determine which diagrams need updates based on your changes:
+
+| Change Type            | Primary Diagram    | Secondary Diagrams |
+| ---------------------- | ------------------ | ------------------ |
+| New analytics module   | module_overview.md | context_diagram.md |
+| Database schema change | data_models.md     | core_classes.md    |
+| New UI component       | service_layer.md   | module_overview.md |
+| New service/manager    | service_layer.md   | module_overview.md |
+| Architecture refactor  | context_diagram.md | All others         |
+
+### Step 2: Update Mermaid Code
+
+Edit the relevant `.md` files to update mermaid diagram code:
+
+```mermaid
+# Example: Adding a new class to core_classes.md
+class NewAnalyticsService {
+    -CacheManager cache_manager
+    -Logger logger
+    +calculate_advanced_metrics() Dict
+    +generate_insights() List[str]
+}
+
+# Add relationships
+NewAnalyticsService --> CacheManager : uses
+NewAnalyticsService --> DatabaseManager : queries
+```
+
+### Step 3: Validate Diagrams
+
+Test diagram syntax and rendering:
+
+1. **Online validation**: Copy mermaid code to [Mermaid Live Editor](https://mermaid.live/)
+2. **Local preview**: Use VS Code Mermaid extensions
+3. **Check syntax**: Ensure proper mermaid formatting
+
+### Step 4: Update Cross-References
+
+Update any cross-references in documentation:
+
+- Update `docs/architecture/README.md` if adding new diagrams
+- Update navigation links between diagram files
+- Update main project README if architecture changes significantly
+
+## 📝 Mermaid Syntax Guidelines
+
+### Class Diagrams
+
+```mermaid
+classDiagram
+    class ClassName {
+        -private_field: Type
+        +public_method() ReturnType
+        #protected_method(param: Type) void
+    }
+
+    %% Relationships
+    ClassA <|-- ClassB : inherits
+    ClassA *-- ClassC : composition
+    ClassA --> ClassD : uses
+    ClassA ..> ClassE : depends on
+
+    %% Notes
+    note for ClassName "Important implementation details"
+```
+
+### Flowcharts
+
+```mermaid
+flowchart TD
+    A[Start] --> B{Decision}
+    B -->|Yes| C[Action 1]
+    B -->|No| D[Action 2]
+    C --> E[End]
+    D --> E
+
+    %% Styling
+    style A fill:#e1f5fe
+    style E fill:#e8f5e8
+```
+
+### Sequence Diagrams
+
+```mermaid
+sequenceDiagram
+    participant A as Actor
+    participant B as System
+
+    A->>B: Request
+    B->>B: Process
+    B-->>A: Response
+
+    Note over A,B: Important interaction
+```
+
+## 🎨 Styling Guidelines
+
+### Color Scheme
+
+Use consistent colors across all diagrams:
+
+```mermaid
+%% Standard color palette
+style MainComponents fill:#4ecdc4,color:#fff
+style DataLayer fill:#f3e5f5
+style CacheLayer fill:#fff8e1
+style UILayer fill:#e8f5e8
+style ExternalSystems fill:#e1f5fe
+```
+
+### Component Categories
+
+- **🏗️ Core Infrastructure**: `#4ecdc4` (teal)
+- **📊 Analytics/Data**: `#f3e5f5` (light purple)
+- **⚡ Caching/Performance**: `#fff8e1` (light yellow)
+- **🎨 UI Components**: `#e8f5e8` (light green)
+- **🔗 External Systems**: `#e1f5fe` (light blue)
+
+## 📋 Common Update Scenarios
+
+### Adding a New Analytics Module
+
+1. **Update module_overview.md**: Add to Analytics Engine section
+2. **Update class diagrams**: Add detailed class structure if significant
+3. **Update context_diagram.md**: Add if it's a major new capability
+
+```mermaid
+# Example: New trend analysis module
+TREND_ANALYZER[trend_analyzer.py<br/>📈 Advanced Trends]
+TREND_ANALYZER --> DAILY_CALC
+TREND_ANALYZER --> CACHE
+```
+
+### New UI Component or Widget
+
+1. **Update service_layer.md**: Add class definition and relationships
+2. **Update module_overview.md**: Add to UI Layer section
+3. **Consider component factory updates**
+
+```mermaid
+# Example: New dashboard widget
+class NewDashboardWidget {
+    -MetricsCalculator calculator
+    -ComponentFactory factory
+    +setup_ui() void
+    +refresh_data() void
+}
+QWidget <|-- NewDashboardWidget : inherits
+```
+
+### Database Schema Changes
+
+1. **Update data_models.md**: Modify ER diagram and class definitions
+2. **Update core_classes.md**: Update DAO methods if needed
+3. **Document migration requirements**
+
+### New Service or Manager Class
+
+1. **Update service_layer.md**: Add to appropriate service category
+2. **Update relationships**: Show dependencies and usage patterns
+3. **Update module_overview.md**: Add service layer connections
+
+## 🔍 Validation Checklist
+
+Before committing diagram updates:
+
+- [ ] **Syntax Valid**: Diagram renders without errors
+- [ ] **Consistent Styling**: Uses standard color scheme
+- [ ] **Accurate Relationships**: Reflects actual code relationships
+- [ ] **Clear Labels**: All components clearly labeled
+- [ ] **Cross-References Updated**: Navigation links work
+- [ ] **README Updated**: Main architecture README reflects changes
+
+## 🤖 Automation & Maintenance Scripts
+
+### Useful Commands for Analysis
+
+```bash
+# Find all Python classes in the codebase
+find src/ -name "*.py" -exec grep -l "^class " {} \; | sort
+
+# Check module imports to understand dependencies
+grep -r "^from src\." src/ | cut -d: -f2 | sort | uniq
+
+# Find new files since last commit
+git diff --name-only HEAD~1 | grep "\.py$"
+
+# Count modules by package
+find src/ -name "*.py" | cut -d/ -f2 | sort | uniq -c
+```
+
+### Maintenance Tasks
+
+1. **Quarterly Review**: Compare diagrams against actual codebase structure
+2. **Release Preparation**: Ensure all diagrams reflect release state
+3. **Refactoring Support**: Update diagrams during major refactors
+4. **New Developer Onboarding**: Keep diagrams current for documentation
+
+## 🚨 Best Practices
+
+### Do's
+
+- ✅ **Keep diagrams focused**: One primary concept per diagram
+- ✅ **Use consistent naming**: Match actual class/module names
+- ✅ **Add explanatory notes**: Include important design decisions
+- ✅ **Regular updates**: Keep diagrams current with code changes
+- ✅ **Validate syntax**: Always test before committing
+
+### Don'ts
+
+- ❌ **Avoid over-complexity**: Don't include every minor detail
+- ❌ **Don't duplicate**: Each relationship should appear in most appropriate diagram
+- ❌ **Avoid generic names**: Use specific, meaningful component names
+- ❌ **Don't ignore styling**: Consistent colors improve readability
+- ❌ **Don't skip validation**: Always check diagram rendering
+
+## 📞 Support & Resources
+
+### Documentation Resources
+
+- [Mermaid Documentation](https://mermaid-js.github.io/mermaid/)
+- [Mermaid Live Editor](https://mermaid.live/) - For testing diagrams
+- [VS Code Mermaid Extension](https://marketplace.visualstudio.com/items?itemName=bierner.markdown-mermaid)
+
+### Quick Reference
+
+- **Architecture overview**: `/docs/architecture/README.md`
+- **System context**: `/docs/architecture/context_diagram.md`
+- **Module relationships**: `/docs/architecture/module_overview.md`
+- **Class details**: `/docs/architecture/class_diagrams/`
+
+### Getting Help
+
+1. **Reference existing patterns**: Look at similar components in current diagrams
+2. **Check diagram history**: Use git to see how similar changes were handled
+3. **Ask in code review**: Get feedback on architectural accuracy
+
+---
+
+_Keep architecture diagrams accurate, useful, and maintainable as the project evolves. Focus on clarity and consistency to support both current development and future maintenance._

package/.claude/commands/aiwf/aiwf_persona_architect.md

@@ -0,0 +1,48 @@
+# Architect 페르소나 활성화
+
+AI를 시스템 아키텍처 전문가 모드로 전환합니다.
+
+```bash
+cd .aiwf && node ../claude-code/aiwf/ko/commands/ai-persona.js architect
+```
+
+## 페르소나 컨텍스트 적용
+
+이 명령어는 AI를 아키텍처 전문가 페르소나로 전환하여 다음과 같은 작업에 최적화된 지원을 제공합니다:
+
+### 🎯 전문 분야
+- 시스템 설계 및 아키텍처 패턴
+- 확장성 및 성능 최적화
+- 기술 스택 선정 및 평가
+- 마이크로서비스 설계
+- API 설계 원칙
+- 데이터베이스 스키마 설계
+- 인프라 아키텍처
+
+### 🔧 주요 동작
+- 큰 그림과 전체 시스템 구조에 집중
+- 확장성과 유지보수성 우선시
+- 디자인 패턴과 아키텍처 원칙 적용
+- 통합 지점과 인터페이스 고려
+
+### 📝 컨텍스트 규칙
+다음 규칙에 따라 AI 동작이 최적화됩니다:
+- 시스템 전체 관점에서 접근
+- 확장 가능한 설계 우선
+- 트레이드오프 분석 필수
+- 기술 중립적 평가
+
+---
+
+**💡 활성화 완료 후 이 메시지가 표시됩니다:**
+```
+🎭 AI 페르소나 활성화 완료
+현재 페르소나: 아키텍트
+전문 분야: 시스템 설계 및 아키텍처
+```
+
+## 예시 프롬프트
+- "이 프로젝트의 전체 아키텍처를 설계해주세요"
+- "마이크로서비스 간 통신 방식을 제안해주세요"
+- "확장 가능한 데이터베이스 설계를 도와주세요"
+- "현재 아키텍처의 병목 지점을 분석해주세요"

package/.claude/commands/aiwf/aiwf_persona_backend.md

@@ -0,0 +1,37 @@
+# Backend 페르소나 활성화
+
+AI를 백엔드 개발 전문가 모드로 전환합니다.
+
+```bash
+cd .aiwf && node ../claude-code/aiwf/ko/commands/ai-persona.js backend
+```
+
+## 페르소나 컨텍스트 적용
+
+## 설명
+이 명령어는 AI를 백엔드 전문가 페르소나로 전환하여 다음과 같은 작업에 최적화된 지원을 제공합니다:
+
+- RESTful API 및 GraphQL 설계
+- 데이터베이스 설계 및 최적화
+- 서버 아키텍처 및 인프라
+- 캐싱 전략 및 성능 튜닝
+- 메시지 큐 및 비동기 처리
+- 마이크로서비스 구현
+- 서버 보안 및 인증
+
+## 주요 동작
+- API 엔드포인트 설계 및 구현
+- 데이터베이스 쿼리 최적화
+- 트랜잭션 관리 및 동시성 제어
+- 에러 처리 및 로깅 전략
+- 확장 가능한 서버 구조 설계
+
+## 예시 프롬프트
+- "RESTful API를 설계해주세요"
+- "데이터베이스 쿼리를 최적화해주세요"
+- "캐싱 전략을 구현해주세요"
+- "비동기 작업 처리 시스템을 설계해주세요"
+
+## 관련 명령어
+- `/project:aiwf:persona_status` - 현재 페르소나 상태 확인
+- `/project:aiwf:default_mode` - 기본 모드로 복원

package/.claude/commands/aiwf/aiwf_persona_data_analyst.md

@@ -0,0 +1,37 @@
+# Data Analyst 페르소나 활성화
+
+AI를 데이터 분석 전문가 모드로 전환합니다.
+
+```bash
+cd .aiwf && node ../claude-code/aiwf/ko/commands/ai-persona.js data_analyst
+```
+
+## 페르소나 컨텍스트 적용
+
+## 설명
+이 명령어는 AI를 데이터 분석가 페르소나로 전환하여 다음과 같은 작업에 최적화된 지원을 제공합니다:
+
+- 데이터 분석 및 시각화
+- 통계 분석 및 인사이트 도출
+- 머신러닝 모델 설계 및 구현
+- 데이터 파이프라인 구축
+- ETL 프로세스 설계
+- 실시간 데이터 처리
+- 성능 메트릭 분석
+
+## 주요 동작
+- 데이터 패턴 및 트렌드 분석
+- 통계적 검증 및 가설 검정
+- 데이터 품질 평가 및 개선
+- 시각화 차트 및 대시보드 설계
+- 예측 모델 구축 및 평가
+
+## 예시 프롬프트
+- "이 데이터의 패턴을 분석해주세요"
+- "실시간 데이터 파이프라인을 설계해주세요"
+- "머신러닝 모델을 구현해주세요"
+- "성능 메트릭을 분석하고 개선점을 제안해주세요"
+
+## 관련 명령어
+- `/project:aiwf:persona_status` - 현재 페르소나 상태 확인
+- `/project:aiwf:default_mode` - 기본 모드로 복원

package/.claude/commands/aiwf/aiwf_persona_frontend.md

@@ -0,0 +1,37 @@
+# Frontend 페르소나 활성화
+
+AI를 프론트엔드 개발 전문가 모드로 전환합니다.
+
+```bash
+cd .aiwf && node ../claude-code/aiwf/ko/commands/ai-persona.js frontend
+```
+
+## 페르소나 컨텍스트 적용
+
+## 설명
+이 명령어는 AI를 프론트엔드 전문가 페르소나로 전환하여 다음과 같은 작업에 최적화된 지원을 제공합니다:
+
+- React, Vue, Angular 등 프레임워크 개발
+- UI/UX 최적화 및 개선
+- 반응형 디자인 구현
+- 성능 최적화 (번들 크기, 렌더링)
+- 접근성(A11y) 개선
+- 상태 관리 솔루션
+- CSS 및 스타일링 시스템
+
+## 주요 동작
+- 컴포넌트 설계 및 구조화
+- 사용자 경험 최적화 제안
+- 브라우저 호환성 검토
+- 프론트엔드 테스트 전략
+- 모던 JavaScript/TypeScript 패턴 적용
+
+## 예시 프롬프트
+- "React 컴포넌트를 최적화해주세요"
+- "이 UI의 접근성을 개선해주세요"
+- "모바일 반응형 디자인을 구현해주세요"
+- "프론트엔드 성능을 개선하는 방법을 제안해주세요"
+
+## 관련 명령어
+- `/project:aiwf:persona_status` - 현재 페르소나 상태 확인
+- `/project:aiwf:default_mode` - 기본 모드로 복원

package/.claude/commands/aiwf/aiwf_persona_security.md

@@ -0,0 +1,48 @@
+# Security 페르소나 활성화
+
+AI를 보안 전문가 모드로 전환합니다.
+
+```bash
+cd .aiwf && node ../claude-code/aiwf/ko/commands/ai-persona.js security
+```
+
+## 페르소나 컨텍스트 적용
+
+이 명령어는 AI를 보안 전문가 페르소나로 전환하여 다음과 같은 작업에 최적화된 지원을 제공합니다:
+
+### 🎯 전문 분야
+- 보안 취약점 분석 및 진단
+- OWASP Top 10 대응
+- 인증 및 인가 시스템 설계
+- 암호화 및 데이터 보호
+- 보안 감사 및 컴플라이언스
+- 침투 테스트 가이드
+- 보안 베스트 프랙티스
+
+### 🔧 주요 동작
+- OWASP Top 10 기준 보안 취약점 분석
+- 위험 기반 접근으로 우선순위 설정
+- 공격 시나리오 구성 및 방어 전략 수립
+- 최소 권한 원칙과 다층 보안 적용
+
+### 📝 컨텍스트 규칙
+다음 규칙에 따라 AI 동작이 최적화됩니다:
+- Zero Trust 접근 방식
+- Defense in Depth 전략
+- Secure by Design 원칙
+- 위험 기반 우선순위 설정
+
+---
+
+**💡 활성화 완료 후 이 메시지가 표시됩니다:**
+```
+🎭 AI 페르소나 활성화 완료
+현재 페르소나: 보안 전문가
+전문 분야: 보안 취약점 분석 및 방어
+```
+
+## 예시 프롬프트
+- "이 코드의 보안 취약점을 분석해주세요"
+- "JWT 인증 시스템을 안전하게 구현해주세요"
+- "SQL 인젝션 방어 코드를 작성해주세요"
+- "API 보안을 강화하는 방법을 제안해주세요"