moai-adk 0.3.12__py3-none-any.whl → 0.4.0__py3-none-any.whl

moai_adk/templates/.claude/skills/moai-domain-database/SKILL.md

@@ -0,0 +1,69 @@
+---
+name: moai-domain-database
+description: Database design, schema optimization, indexing strategies, and migration
+  management
+allowed-tools:
+- Read
+- Bash
+---
+
+# Database Expert
+
+## What it does
+
+Provides expertise in database design, schema normalization, indexing strategies, query optimization, and safe migration management for SQL and NoSQL databases.
+
+## When to use
+
+- "데이터베이스 설계", "스키마 최적화", "인덱스 전략", "마이그레이션"
+- Automatically invoked when working with database projects
+- Database SPEC implementation (`/alfred:2-build`)
+
+## How it works
+
+**Schema Design**:
+- **Normalization**: 1NF, 2NF, 3NF, BCNF
+- **Denormalization**: Performance trade-offs
+- **Constraints**: Primary keys, foreign keys, unique, check
+- **Data types**: Choosing appropriate types
+
+**Indexing Strategies**:
+- **B-tree indices**: General-purpose indexing
+- **Hash indices**: Exact match queries
+- **Full-text indices**: Text search
+- **Composite indices**: Multi-column indexing
+- **Index maintenance**: REINDEX, VACUUM
+
+**Query Optimization**:
+- **EXPLAIN/EXPLAIN ANALYZE**: Query plan analysis
+- **JOIN optimization**: INNER, LEFT, RIGHT, FULL
+- **Subquery vs JOIN**: Performance comparison
+- **N+1 query problem**: Eager loading
+- **Query caching**: Redis, Memcached
+
+**Migration Management**:
+- **Version control**: Flyway, Liquibase, Alembic
+- **Rollback strategies**: Backward compatibility
+- **Zero-downtime migrations**: Expand-contract pattern
+- **Data migrations**: Safe data transformations
+
+**Database Types**:
+- **SQL**: PostgreSQL, MySQL, SQLite
+- **NoSQL**: MongoDB, Redis, Cassandra
+- **NewSQL**: CockroachDB, Vitess
+
+## Examples
+
+### Example 1: Schema design with normalization
+User: "/alfred:2-build DB-SCHEMA-001"
+Claude: (creates RED schema test, GREEN implementation with constraints, REFACTOR with indices)
+
+### Example 2: Query optimization
+User: "쿼리 성능 개선"
+Claude: (analyzes EXPLAIN output and suggests index creation)
+
+## Works well with
+
+- alfred-trust-validation (migration testing)
+- sql-expert (SQL implementation)
+- backend-expert (ORM integration)

moai_adk/templates/.claude/skills/moai-domain-devops/SKILL.md

@@ -0,0 +1,69 @@
+---
+name: moai-domain-devops
+description: CI/CD pipelines, Docker containerization, Kubernetes orchestration, and
+  infrastructure as code
+allowed-tools:
+- Read
+- Bash
+---
+
+# DevOps Expert
+
+## What it does
+
+Provides expertise in continuous integration/deployment (CI/CD), Docker containerization, Kubernetes orchestration, and infrastructure as code (IaC) for automated deployment workflows.
+
+## When to use
+
+- "CI/CD 파이프라인", "Docker 컨테이너화", "Kubernetes 배포", "인프라 코드"
+- Automatically invoked when working with DevOps projects
+- DevOps SPEC implementation (`/alfred:2-build`)
+
+## How it works
+
+**CI/CD Pipelines**:
+- **GitHub Actions**: Workflow automation (.github/workflows)
+- **GitLab CI**: .gitlab-ci.yml configuration
+- **Jenkins**: Pipeline as code (Jenkinsfile)
+- **CircleCI**: .circleci/config.yml
+- **Pipeline stages**: Build → Test → Deploy
+
+**Docker Containerization**:
+- **Dockerfile**: Multi-stage builds for optimization
+- **docker-compose**: Local development environments
+- **Image optimization**: Layer caching, alpine base images
+- **Container registries**: Docker Hub, GitHub Container Registry
+
+**Kubernetes Orchestration**:
+- **Deployments**: Rolling updates, rollbacks
+- **Services**: LoadBalancer, ClusterIP, NodePort
+- **ConfigMaps/Secrets**: Configuration management
+- **Helm charts**: Package management
+- **Ingress**: Traffic routing
+
+**Infrastructure as Code (IaC)**:
+- **Terraform**: Cloud-agnostic provisioning
+- **Ansible**: Configuration management
+- **CloudFormation**: AWS-specific IaC
+- **Pulumi**: Programmatic infrastructure
+
+**Monitoring & Logging**:
+- **Prometheus**: Metrics collection
+- **Grafana**: Visualization
+- **ELK Stack**: Logging (Elasticsearch, Logstash, Kibana)
+
+## Examples
+
+### Example 1: GitHub Actions CI/CD
+User: "/alfred:2-build CICD-001"
+Claude: (creates RED workflow test, GREEN GitHub Actions workflow, REFACTOR)
+
+### Example 2: Kubernetes deployment
+User: "Kubernetes 배포 설정"
+Claude: (creates deployment.yaml, service.yaml, ingress.yaml)
+
+## Works well with
+
+- alfred-trust-validation (deployment validation)
+- shell-expert (shell scripting for automation)
+- security-expert (secure deployments)

moai_adk/templates/.claude/skills/moai-domain-frontend/SKILL.md

@@ -0,0 +1,68 @@
+---
+name: moai-domain-frontend
+description: React/Vue/Angular development with state management, performance optimization,
+  and accessibility
+allowed-tools:
+- Read
+- Bash
+---
+
+# Frontend Expert
+
+## What it does
+
+Provides expertise in modern frontend development using React, Vue, or Angular, including state management patterns, performance optimization techniques, and accessibility (a11y) best practices.
+
+## When to use
+
+- "프론트엔드 개발", "React 컴포넌트", "상태 관리", "성능 최적화"
+- Automatically invoked when working with frontend projects
+- Frontend SPEC implementation (`/alfred:2-build`)
+
+## How it works
+
+**React Development**:
+- **Functional components**: Hooks (useState, useEffect, useMemo)
+- **State management**: Redux, Zustand, Jotai
+- **Performance**: React.memo, useCallback, code splitting
+- **Testing**: React Testing Library
+
+**Vue Development**:
+- **Composition API**: setup(), reactive(), computed()
+- **State management**: Pinia, Vuex
+- **Performance**: Virtual scrolling, lazy loading
+- **Testing**: Vue Test Utils
+
+**Angular Development**:
+- **Components**: TypeScript classes with decorators
+- **State management**: NgRx, Akita
+- **Performance**: OnPush change detection, lazy loading
+- **Testing**: Jasmine, Karma
+
+**Performance Optimization**:
+- **Code splitting**: Dynamic imports, route-based splitting
+- **Lazy loading**: Images, components
+- **Bundle optimization**: Tree shaking, minification
+- **Web Vitals**: LCP, FID, CLS optimization
+
+**Accessibility (a11y)**:
+- **Semantic HTML**: Proper use of HTML5 elements
+- **ARIA attributes**: Roles, labels, descriptions
+- **Keyboard navigation**: Focus management
+- **Screen reader support**: Alt text, aria-live
+
+## Examples
+
+### Example 1: React component with performance optimization
+User: "/alfred:2-build UI-001"
+Claude: (creates RED component test, GREEN implementation with React.memo, REFACTOR)
+
+### Example 2: Accessibility audit
+User: "접근성 검사"
+Claude: (runs axe-core or Lighthouse and reports issues)
+
+## Works well with
+
+- alfred-trust-validation (frontend testing)
+- typescript-expert (type-safe React/Vue)
+- alfred-performance-optimizer (performance profiling)

moai_adk/templates/.claude/skills/moai-domain-ml/SKILL.md

@@ -0,0 +1,67 @@
+---
+name: moai-domain-ml
+description: Machine learning model training, evaluation, deployment, and MLOps workflows
+allowed-tools:
+- Read
+- Bash
+---
+
+# ML Expert
+
+## What it does
+
+Provides expertise in machine learning model development, training, evaluation, hyperparameter tuning, deployment, and MLOps workflows for production ML systems.
+
+## When to use
+
+- "머신러닝 모델 개발", "모델 학습", "모델 배포", "MLOps"
+- Automatically invoked when working with ML projects
+- ML SPEC implementation (`/alfred:2-build`)
+
+## How it works
+
+**Model Training**:
+- **scikit-learn**: Classical ML (RandomForest, SVM, KNN)
+- **TensorFlow/Keras**: Deep learning (CNN, RNN, Transformers)
+- **PyTorch**: Research-oriented deep learning
+- **XGBoost/LightGBM**: Gradient boosting
+
+**Model Evaluation**:
+- **Classification**: Accuracy, precision, recall, F1, ROC-AUC
+- **Regression**: RMSE, MAE, R²
+- **Cross-validation**: k-fold, stratified k-fold
+- **Confusion matrix**: Error analysis
+
+**Hyperparameter Tuning**:
+- **Grid search**: Exhaustive search
+- **Random search**: Stochastic search
+- **Bayesian optimization**: Optuna, Hyperopt
+- **AutoML**: Auto-sklearn, TPOT
+
+**Model Deployment**:
+- **Serialization**: pickle, joblib, ONNX
+- **Serving**: FastAPI, TensorFlow Serving, TorchServe
+- **Containerization**: Docker for reproducibility
+- **Versioning**: MLflow, DVC
+
+**MLOps Workflows**:
+- **Experiment tracking**: MLflow, Weights & Biases
+- **Feature store**: Feast, Tecton
+- **Model registry**: Centralized model management
+- **Monitoring**: Data drift detection, model performance
+
+## Examples
+
+### Example 1: Model training with scikit-learn
+User: "/alfred:2-build ML-001"
+Claude: (creates RED model test, GREEN training pipeline, REFACTOR with cross-validation)
+
+### Example 2: Model deployment
+User: "모델 API 배포"
+Claude: (creates FastAPI endpoint with model serving)
+
+## Works well with
+
+- alfred-trust-validation (model testing)
+- python-expert (ML implementation)
+- data-science-expert (data preparation)

moai_adk/templates/.claude/skills/moai-domain-mobile-app/SKILL.md

@@ -0,0 +1,62 @@
+---
+name: moai-domain-mobile-app
+description: Mobile app development with Flutter and React Native, state management,
+  and native integration
+allowed-tools:
+- Read
+- Bash
+---
+
+# Mobile App Expert
+
+## What it does
+
+Provides expertise in cross-platform mobile app development using Flutter (Dart) and React Native (TypeScript), including state management patterns and native module integration.
+
+## When to use
+
+- "모바일 앱 개발", "Flutter 위젯", "React Native 컴포넌트", "상태 관리"
+- Automatically invoked when working with mobile app projects
+- Mobile app SPEC implementation (`/alfred:2-build`)
+
+## How it works
+
+**Flutter Development**:
+- **Widget tree**: StatelessWidget, StatefulWidget
+- **State management**: Provider, Riverpod, BLoC
+- **Navigation**: Navigator 2.0, go_router
+- **Platform-specific code**: MethodChannel
+
+**React Native Development**:
+- **Components**: Functional components with hooks
+- **State management**: Redux, MobX, Zustand
+- **Navigation**: React Navigation
+- **Native modules**: Turbo modules, JSI
+
+**Cross-Platform Patterns**:
+- **Responsive design**: Adaptive layouts for phone/tablet
+- **Performance optimization**: Lazy loading, memoization
+- **Offline support**: Local storage, sync strategies
+- **Testing**: Widget tests (Flutter), component tests (RN)
+
+**Native Integration**:
+- **Plugins**: Platform channels, native modules
+- **Permissions**: Camera, location, notifications
+- **Deep linking**: Universal links, app links
+- **Push notifications**: FCM, APNs
+
+## Examples
+
+### Example 1: Flutter app with BLoC
+User: "/alfred:2-build MOBILE-001"
+Claude: (creates RED widget test, GREEN implementation with BLoC, REFACTOR)
+
+### Example 2: React Native state management
+User: "React Native Redux 설정"
+Claude: (sets up Redux with TypeScript and async actions)
+
+## Works well with
+
+- alfred-trust-validation (mobile testing)
+- dart-expert (Flutter development)
+- typescript-expert (React Native development)

moai_adk/templates/.claude/skills/moai-domain-security/SKILL.md

@@ -0,0 +1,74 @@
+---
+name: moai-domain-security
+description: OWASP Top 10, static analysis (SAST), dependency security, and secrets
+  management
+allowed-tools:
+- Read
+- Bash
+---
+
+# Security Expert
+
+## What it does
+
+Provides expertise in application security, including OWASP Top 10 vulnerabilities, static application security testing (SAST), dependency vulnerability scanning, and secrets management.
+
+## When to use
+
+- "보안 취약점 분석", "OWASP 검증", "시크릿 관리", "의존성 보안"
+- Automatically invoked when security concerns arise
+- Security SPEC implementation (`/alfred:2-build`)
+
+## How it works
+
+**OWASP Top 10 (2021)**:
+1. **Broken Access Control**: Authorization checks
+2. **Cryptographic Failures**: Encryption at rest/transit
+3. **Injection**: SQL injection, XSS prevention
+4. **Insecure Design**: Threat modeling
+5. **Security Misconfiguration**: Secure defaults
+6. **Vulnerable Components**: Dependency scanning
+7. **Identification/Authentication Failures**: MFA, password policies
+8. **Software/Data Integrity Failures**: Code signing
+9. **Security Logging/Monitoring Failures**: Audit logs
+10. **Server-Side Request Forgery (SSRF)**: Input validation
+
+**Static Analysis (SAST)**:
+- **Semgrep**: Multi-language static analysis
+- **SonarQube**: Code quality + security
+- **Bandit**: Python security linter
+- **ESLint security plugins**: JavaScript security
+
+**Dependency Security**:
+- **Snyk**: Vulnerability scanning
+- **Dependabot**: Automated dependency updates
+- **npm audit**: Node.js vulnerabilities
+- **safety**: Python dependency checker
+
+**Secrets Management**:
+- **Never commit secrets**: .gitignore for .env files
+- **Vault**: Secrets storage (HashiCorp Vault)
+- **Environment variables**: Runtime configuration
+- **Secret scanning**: git-secrets, trufflehog
+
+**Secure Coding Practices**:
+- Input validation and sanitization
+- Parameterized queries (SQL injection prevention)
+- CSP (Content Security Policy) headers
+- HTTPS enforcement
+
+## Examples
+
+### Example 1: OWASP compliance check
+User: "/alfred:2-build SEC-001"
+Claude: (creates RED security test, GREEN implementation with input validation, REFACTOR)
+
+### Example 2: Dependency vulnerability scan
+User: "의존성 보안 스캔"
+Claude: (runs npm audit or snyk test and reports vulnerabilities)
+
+## Works well with
+
+- alfred-trust-validation (security validation)
+- web-api-expert (API security)
+- devops-expert (secure deployments)

moai_adk/templates/.claude/skills/moai-domain-web-api/SKILL.md

@@ -0,0 +1,66 @@
+---
+name: moai-domain-web-api
+description: REST API and GraphQL design patterns with authentication, versioning,
+  and OpenAPI documentation
+allowed-tools:
+- Read
+- Bash
+---
+
+# Web API Expert
+
+## What it does
+
+Provides expertise in designing and implementing RESTful APIs and GraphQL services, including authentication mechanisms (JWT, OAuth2), API versioning strategies, and OpenAPI documentation.
+
+## When to use
+
+- "API 설계", "REST API 패턴", "GraphQL 스키마", "JWT 인증"
+- Automatically invoked when working with API projects
+- Web API SPEC implementation (`/alfred:2-build`)
+
+## How it works
+
+**REST API Design**:
+- **RESTful principles**: Resource-based URLs, HTTP verbs (GET, POST, PUT, DELETE)
+- **Status codes**: Proper use of 2xx, 4xx, 5xx codes
+- **HATEOAS**: Hypermedia links in responses
+- **Pagination**: Cursor-based or offset-based
+
+**GraphQL Design**:
+- **Schema definition**: Types, queries, mutations, subscriptions
+- **Resolver implementation**: Data fetching logic
+- **N+1 problem**: DataLoader for batching
+- **Schema stitching**: Federated GraphQL
+
+**Authentication & Authorization**:
+- **JWT (JSON Web Token)**: Stateless authentication
+- **OAuth2**: Authorization framework (flows: authorization code, client credentials)
+- **API keys**: Simple authentication
+- **RBAC/ABAC**: Role/Attribute-based access control
+
+**API Versioning**:
+- **URL versioning**: /v1/users, /v2/users
+- **Header versioning**: Accept: application/vnd.api.v2+json
+- **Deprecation strategy**: Sunset header
+
+**Documentation**:
+- **OpenAPI (Swagger)**: API specification
+- **API documentation**: Auto-generated docs
+- **Postman collections**: Request examples
+
+## Examples
+
+### Example 1: REST API with JWT
+User: "/alfred:2-build API-AUTH-001"
+Claude: (creates RED API test, GREEN implementation with JWT middleware, REFACTOR)
+
+### Example 2: GraphQL schema design
+User: "GraphQL 스키마 설계"
+Claude: (designs schema with proper types and resolvers)
+
+## Works well with
+
+- alfred-trust-validation (API security validation)
+- backend-expert (server implementation)
+- security-expert (authentication patterns)

moai_adk/templates/.claude/skills/moai-essentials-debug/SKILL.md

@@ -0,0 +1,66 @@
+---
+name: moai-essentials-debug
+description: Advanced debugging with stack trace analysis, error pattern detection,
+  and fix suggestions
+allowed-tools:
+- Read
+- Bash
+- Write
+- Edit
+- TodoWrite
+---
+
+# Alfred Debugger Pro
+
+## What it does
+
+Advanced debugging support with stack trace analysis, common error pattern detection, and actionable fix suggestions.
+
+## When to use
+
+- "에러 해결해줘", "이 오류 원인은?", "스택 트레이스 분석"
+- Automatically invoked on runtime errors (via debug-helper sub-agent)
+- "왜 안 돼?", "NullPointerException 해결"
+
+## How it works
+
+**Stack Trace Analysis**:
+```python
+# Error example
+jwt.exceptions.ExpiredSignatureError: Signature has expired
+
+# Alfred Analysis
+📍 Error Location: src/auth/service.py:142
+🔍 Root Cause: JWT token has expired
+💡 Fix Suggestion:
+   1. Implement token refresh logic
+   2. Check expiration before validation
+   3. Handle ExpiredSignatureError gracefully
+```
+
+**Common Error Patterns**:
+- `NullPointerException` → Optional usage, guard clauses
+- `IndexError` → Boundary checks
+- `KeyError` → `.get()` with defaults
+- `TypeError` → Type hints, input validation
+- `ConnectionError` → Retry logic, timeouts
+
+**Debugging Checklist**:
+- [ ] Reproducible?
+- [ ] Log messages?
+- [ ] Input data?
+- [ ] Recent changes?
+- [ ] Dependency versions?
+
+**Language-specific Tips**:
+- **Python**: Logging, type guards
+- **TypeScript**: Type guards, null checks
+- **Java**: Optional, try-with-resources
+
+## Examples
+
+User: "JWT ExpiredSignatureError 해결해줘"
+Claude: (analyzes stack trace, identifies root cause, suggests fix)
+## Works well with
+
+- moai-essentials-refactor

moai_adk/templates/.claude/skills/moai-essentials-perf/SKILL.md

@@ -0,0 +1,68 @@
+---
+name: moai-essentials-perf
+description: Performance optimization with profiling, bottleneck detection, and tuning
+  strategies
+allowed-tools:
+- Read
+- Bash
+- Write
+- Edit
+- TodoWrite
+---
+
+# Alfred Performance Optimizer
+
+## What it does
+
+Performance analysis and optimization with profiling tools, bottleneck detection, and language-specific optimization techniques.
+
+## When to use
+
+- "성능 개선해줘", "느린 부분 찾아줘", "최적화 방법은?"
+- "프로파일링", "병목 지점", "메모리 누수"
+
+## How it works
+
+**Profiling Tools**:
+- **Python**: cProfile, memory_profiler
+- **TypeScript**: Chrome DevTools, clinic.js
+- **Java**: JProfiler, VisualVM
+- **Go**: pprof
+- **Rust**: flamegraph, criterion
+
+**Common Performance Issues**:
+- **N+1 Query Problem**: Use eager loading/joins
+- **Inefficient Loop**: O(n²) → O(n) with Set/Map
+- **Memory Leak**: Remove event listeners, close connections
+
+**Optimization Checklist**:
+- [ ] Current performance benchmark
+- [ ] Bottleneck identification
+- [ ] Profiling data collected
+- [ ] Algorithm complexity improved (O(n²) → O(n))
+- [ ] Unnecessary operations removed
+- [ ] Caching applied
+- [ ] Async processing introduced
+- [ ] Post-optimization benchmark
+- [ ] Side effects checked
+
+**Language-specific Optimizations**:
+- **Python**: List comprehension, generators, @lru_cache
+- **TypeScript**: Memoization, lazy loading, code splitting
+- **Java**: Stream API, parallel processing
+- **Go**: Goroutines, buffered channels
+- **Rust**: Zero-cost abstractions, borrowing
+
+**Performance Targets**:
+- API response time: <200ms (P95)
+- Page load time: <2s
+- Memory usage: <512MB
+- CPU usage: <70%
+
+## Examples
+
+User: "N+1 query 문제 해결해줘"
+Claude: (identifies N+1 queries, suggests eager loading, provides optimized code)
+## Works well with
+
+- moai-essentials-refactor

moai_adk/templates/.claude/skills/moai-essentials-refactor/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: moai-essentials-refactor
+description: Refactoring guidance with design patterns and code improvement strategies
+allowed-tools:
+- Read
+- Bash
+- Write
+- Edit
+- TodoWrite
+---
+
+# Alfred Refactoring Coach
+
+## What it does
+
+Refactoring guidance with design pattern recommendations, code smell detection, and step-by-step improvement plans.
+
+## When to use
+
+- "리팩토링 도와줘", "이 코드 개선 방법은?", "디자인 패턴 적용"
+- "코드 정리", "중복 제거", "함수 분리"
+
+## How it works
+
+**Refactoring Techniques**:
+- **Extract Method**: 긴 메서드 분리
+- **Replace Conditional with Polymorphism**: 조건문 제거
+- **Introduce Parameter Object**: 매개변수 그룹화
+- **Extract Class**: 거대한 클래스 분리
+
+**Design Pattern Recommendations**:
+- Complex object creation → **Builder Pattern**
+- Type-specific behavior → **Strategy Pattern**
+- Global state → **Singleton Pattern**
+- Incompatible interfaces → **Adapter Pattern**
+- Delayed object creation → **Factory Pattern**
+
+**3-Strike Rule**:
+```
+1st occurrence: Just implement
+2nd occurrence: Notice similarity (leave as-is)
+3rd occurrence: Pattern confirmed → Refactor! 🔧
+```
+
+**Refactoring Checklist**:
+- [ ] All tests passing before refactoring
+- [ ] Code smells identified
+- [ ] Refactoring goal clear
+- [ ] Change one thing at a time
+- [ ] Run tests after each change
+- [ ] Commit frequently
+
+## Examples
+
+User: "중복 코드 제거해줘"
+Claude: (identifies duplicates, suggests Extract Method, provides step-by-step plan)
+## Works well with
+
+- moai-essentials-review