aiwf 0.3.8 → 0.3.12

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

@@ -1,272 +0,0 @@
-# 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-code/aiwf/ko/.claude/commands/aiwf/aiwf_persona_architect.md

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

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

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

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

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

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

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

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

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

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

@@ -1,50 +0,0 @@
-# 페르소나 상태 확인
-
-현재 활성화된 AI 페르소나의 상태를 확인합니다.
-
-```bash
-aiwf persona 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_pr_create.md

@@ -1,76 +0,0 @@
-# 태스크 완료 후 풀 리퀘스트 생성
-
-태스크 완료 후 GitHub 풀 리퀘스트를 생성하고 관련 이슈와 연결합니다.
-
-## 정확히 다음 6개 항목으로 TODO 생성
-
-1. 현재 브랜치 및 변경사항 확인
-2. PR 본문 템플릿 생성
-3. GitHub PR 생성
-4. 이슈와 PR 연결
-5. 리뷰어 배정
-6. 결과 보고
-
-## 1 · 브랜치 및 변경사항 확인
-
-병렬로 실행:
-- `git branch --show-current`: 현재 브랜치 확인
-- `git log main..HEAD --oneline`: 커밋 히스토리
-- `git diff main...HEAD --stat`: 변경된 파일 통계
-
-Extract GitHub issue number from task file
-
-## 2 · Generate PR Body Template
-
-```markdown
-## 🎯 Overview
-Completed implementation of {task_title}.
-
-## 📝 Changes
-{commit_list}
-
-## 📊 Changed Files
-{file_statistics}
-
-## ✅ Checklist
-- [ ] Tests pass
-- [ ] Code review completed
-- [ ] Documentation updated
-
-## 🔗 Related Information
-- Closes #{issue_number}
-- Task: {task_id}
-```
-
-## 3 · Create GitHub PR
-
-```bash
-gh pr create \
-  --title "{task_id}: {task_title}" \
-  --body "$(cat <<'EOF'
-{pr_body}
-EOF
-)" \
-  --base main \
-  --head {branch_name}
-```
-
-## 4 · Link Issue with PR
-
-Automatically included in PR body:
-- `Closes #{issue_number}`: Auto-close issue
-- `Relates to #{issue_number}`: Show relationship
-
-## 5 · Assign Reviewers
-
-```bash
-gh pr edit {pr_number} \
-  --add-reviewer {reviewer_username}
-```
-
-## 6 · Report Results
-
-✅ **PR Created**: #{pr_number}
-🔗 **Link**: {pr_url}
-🎯 **Linked Issue**: #{issue_number}
-👥 **Reviewers**: {reviewers}

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

@@ -1,9 +0,0 @@
-# 지식 프라임
-
-이 프로젝트의 기본 정보로 자신을 준비시키세요.
-환경을 인식하고 있는지 확인하세요.
-
-## **병렬 에이전트**를 사용하여 다음을 수행하세요
-
-- 기본 프로젝트 정보를 위해 .aiwf/01_PROJECT_DOCS/ARCHITECTURE.md 읽기
-- 프로젝트 상태를 위해 .aiwf/00_PROJECT_MANIFEST.md 읽기