moai-adk 0.4.4__py3-none-any.whl → 0.4.7__py3-none-any.whl

moai_adk/templates/.claude/skills/moai-alfred-performance-optimizer/SKILL.md

@@ -1,105 +1,113 @@
 ---
-
 name: moai-alfred-performance-optimizer
-description: Performance analysis and optimization suggestions with profiling, bottleneck detection, and language-specific optimizations. Use when planning performance improvements or regressions checks.
+version: 2.0.0
+created: 2025-10-22
+updated: 2025-10-22
+status: active
+description: Performance analysis and optimization with profiling, bottleneck detection, and language-specific tuning.
+keywords: ['performance', 'profiling', 'optimization', 'bottleneck']
 allowed-tools:
   - Read
-  - Write
-  - Edit
   - Bash
-  - TodoWrite
 ---
 
-# Alfred Performance Optimizer
+# Alfred Performance Optimizer Skill
 
 ## Skill Metadata
+
 | Field | Value |
 | ----- | ----- |
-| Allowed tools | Read (read_file), Write (write_file), Edit (edit_file), Bash (terminal), TodoWrite (todo_write) |
-| Auto-load | /alfred:2-run performance lane |
-| Trigger cues | Performance regressions surfaced in Alfred workflows, profiling or tuning requests. |
-
-## What it does
-
-Performance analysis and optimization with profiling tools, bottleneck detection, and language-specific optimization techniques.
-
-## When to use
-
-- Activates when Alfred must diagnose or remediate performance bottlenecks.
-- “Improve performance”, “Find slow parts”, “How to optimize?”
-- “Profiling”, “Bottleneck”, “Memory leak”
-
-## 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%
+| **Skill Name** | moai-alfred-performance-optimizer |
+| **Version** | 2.0.0 (2025-10-22) |
+| **Allowed tools** | Read (read_file), Bash (terminal) |
+| **Auto-load** | On demand when keywords detected |
+| **Tier** | Alfred |
 
-## Best Practices
-- The text shown to the user is written using TUI/report expressions.
-- When running the tool, a summary of commands and results are recorded.
+---
 
-## Examples
-```markdown
-- Call this skill inside the /alfred command to generate a report.
-- Add summary to Completion Report.
-```
+## What It Does
+
+Performance analysis and optimization with profiling, bottleneck detection, and language-specific tuning.
+
+**Key capabilities**:
+- ✅ Best practices enforcement for alfred domain
+- ✅ TRUST 5 principles integration
+- ✅ Latest tool versions (2025-10-22)
+- ✅ TDD workflow support
+
+---
+
+## When to Use
+
+**Automatic triggers**:
+- Related code discussions and file patterns
+- SPEC implementation (`/alfred:2-run`)
+- Code review requests
+
+**Manual invocation**:
+- Review code for TRUST 5 compliance
+- Design new features
+- Troubleshoot issues
+
+---
 
 ## Inputs
-- MoAI-ADK project context (`.moai/project/`, `.claude/` templates, etc.).
-- Parameters passed from user commands or higher commands.
+
+- Language-specific source directories
+- Configuration files
+- Test suites and sample data
 
 ## Outputs
-- Reports, checklists or recommendations for your Alfred workflow.
-- Structured data for subsequent subagent calls.
+
+- Test/lint execution plan
+- TRUST 5 review checkpoints
+- Migration guidance
 
 ## Failure Modes
-- When required input documents are missing or permissions are limited.
-- When disruptive changes are required without user approval.
+
+- When required tools are not installed
+- When dependencies are missing
+- When test coverage falls below 85%
 
 ## Dependencies
-- Cooperation with higher-level agents such as cc-manager and project-manager is required.
 
-## References
-- Google SRE. "The Four Golden Signals." https://sre.google/sre-book/monitoring-distributed-systems/ (accessed 2025-03-29).
-- Dynatrace. "Application Performance Monitoring Best Practices." https://www.dynatrace.com/resources/ebooks/ (accessed 2025-03-29).
+- Access to project files via Read/Bash tools
+- Integration with `moai-foundation-langs` for language detection
+- Integration with `moai-foundation-trust` for quality gates
+
+---
+
+## References (Latest Documentation)
+
+_Documentation links updated 2025-10-22_
+
+---
 
 ## Changelog
-- 2025-03-29: Added input/output/failure response to Alfred-specific skills.
 
-## Works well with
+- **v2.0.0** (2025-10-22): Major update with latest tool versions, comprehensive best practices, TRUST 5 integration
+- **v1.0.0** (2025-03-29): Initial Skill release
+
+---
+
+## Works Well With
+
+- `moai-foundation-trust` (quality gates)
+- `moai-alfred-code-reviewer` (code review)
+- `moai-essentials-debug` (debugging support)
+
+---
+
+## Best Practices
 
-- alfred-code-reviewer
-- alfred-debugger-pro
+✅ **DO**:
+- Follow alfred best practices
+- Use latest stable tool versions
+- Maintain test coverage ≥85%
+- Document all public APIs
+
+❌ **DON'T**:
+- Skip quality gates
+- Use deprecated tools
+- Ignore security warnings
+- Mix testing frameworks

moai_adk/templates/.claude/skills/moai-alfred-performance-optimizer/examples.md

@@ -0,0 +1,29 @@
+# moai-alfred-performance-optimizer - Working Examples
+
+_Last updated: 2025-10-22_
+
+## Example 1: Basic Setup
+
+```bash
+# Setup commands
+# ...
+```
+
+## Example 2: TDD Workflow
+
+```bash
+# RED: Write failing test
+# GREEN: Implement feature
+# REFACTOR: Improve code
+```
+
+## Example 3: Quality Gate
+
+```bash
+# Run quality checks
+# Verify coverage ≥85%
+```
+
+---
+
+_For more examples, see SKILL.md reference section_

moai_adk/templates/.claude/skills/moai-alfred-performance-optimizer/reference.md

@@ -0,0 +1,28 @@
+# moai-alfred-performance-optimizer - CLI Reference
+
+_Last updated: 2025-10-22_
+
+## Quick Reference
+
+### Installation
+
+```bash
+# Installation commands
+```
+
+### Common Commands
+
+```bash
+# Test
+# Lint
+# Format
+# Build
+```
+
+## Tool Versions (2025-10-22)
+
+_No specific tool versions (workflow/process Skill)_
+
+---
+
+_For detailed usage, see SKILL.md_

moai_adk/templates/.claude/skills/moai-alfred-refactoring-coach/SKILL.md

@@ -1,97 +1,113 @@
 ---
-
 name: moai-alfred-refactoring-coach
-description: Refactoring guidance with design patterns, code smells detection, and step-by-step improvement plans. Use when outlining refactor steps that preserve functionality.
+version: 2.0.0
+created: 2025-10-22
+updated: 2025-10-22
+status: active
+description: Refactoring guidance with design patterns, code smells detection, and step-by-step improvement plans.
+keywords: ['refactoring', 'patterns', 'code-smells', 'improvement']
 allowed-tools:
   - Read
-  - Write
-  - Edit
   - Bash
-  - TodoWrite
 ---
 
-# Alfred Refactoring Coach
+# Alfred Refactoring Coach Skill
 
 ## Skill Metadata
+
 | Field | Value |
 | ----- | ----- |
-| Allowed tools | Read (read_file), Write (write_file), Edit (edit_file), Bash (terminal), TodoWrite (todo_write) |
-| Auto-load | /alfred:2-run refactor lane |
-| Trigger cues | Refactoring retros, duplication cleanup, code health follow-ups inside Alfred. |
-
-## What it does
-
-Refactoring guidance with design pattern recommendations, code smell detection, and step-by-step improvement plans.
-
-## When to use
-
-- Activates when Alfred is asked to plan or stage refactoring work.
-- “Help with refactoring”, “How can I improve this code?”, “Apply design patterns” 
-- “Code organization”, “Remove duplication”, “Separate functions”
-
-## How it works
-
-**Refactoring Techniques**:
-- **Extract Method**: Separate long methods
-- **Replace Conditional with Polymorphism**: Remove conditional statements
-- **Introduce Parameter Object**: Group parameters
-- **Extract Class**: Massive class separation
-
-**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
+| **Skill Name** | moai-alfred-refactoring-coach |
+| **Version** | 2.0.0 (2025-10-22) |
+| **Allowed tools** | Read (read_file), Bash (terminal) |
+| **Auto-load** | On demand when keywords detected |
+| **Tier** | Alfred |
 
-## Best Practices
-- The text shown to the user is written using TUI/report expressions.
-- When running the tool, a summary of commands and results are recorded.
+---
 
-## Examples
-```markdown
-- Call this skill inside the /alfred command to generate a report.
-- Add summary to Completion Report.
-```
+## What It Does
+
+Refactoring guidance with design patterns, code smells detection, and step-by-step improvement plans.
+
+**Key capabilities**:
+- ✅ Best practices enforcement for alfred domain
+- ✅ TRUST 5 principles integration
+- ✅ Latest tool versions (2025-10-22)
+- ✅ TDD workflow support
+
+---
+
+## When to Use
+
+**Automatic triggers**:
+- Related code discussions and file patterns
+- SPEC implementation (`/alfred:2-run`)
+- Code review requests
+
+**Manual invocation**:
+- Review code for TRUST 5 compliance
+- Design new features
+- Troubleshoot issues
+
+---
 
 ## Inputs
-- MoAI-ADK project context (`.moai/project/`, `.claude/` templates, etc.).
-- Parameters passed from user commands or higher commands.
+
+- Language-specific source directories
+- Configuration files
+- Test suites and sample data
 
 ## Outputs
-- Reports, checklists or recommendations for your Alfred workflow.
-- Structured data for subsequent subagent calls.
+
+- Test/lint execution plan
+- TRUST 5 review checkpoints
+- Migration guidance
 
 ## Failure Modes
-- When required input documents are missing or permissions are limited.
-- When disruptive changes are required without user approval.
+
+- When required tools are not installed
+- When dependencies are missing
+- When test coverage falls below 85%
 
 ## Dependencies
-- Cooperation with higher-level agents such as cc-manager and project-manager is required.
 
-## References
-- Fowler, Martin. "Refactoring: Improving the Design of Existing Code." Addison-Wesley, 2018.
-- IEEE Software. "Managing Technical Debt." IEEE Software, 2021.
+- Access to project files via Read/Bash tools
+- Integration with `moai-foundation-langs` for language detection
+- Integration with `moai-foundation-trust` for quality gates
+
+---
+
+## References (Latest Documentation)
+
+_Documentation links updated 2025-10-22_
+
+---
 
 ## Changelog
-- 2025-03-29: Added input/output/failure response to Alfred-specific skills.
 
-## Works well with
+- **v2.0.0** (2025-10-22): Major update with latest tool versions, comprehensive best practices, TRUST 5 integration
+- **v1.0.0** (2025-03-29): Initial Skill release
+
+---
+
+## Works Well With
+
+- `moai-foundation-trust` (quality gates)
+- `moai-alfred-code-reviewer` (code review)
+- `moai-essentials-debug` (debugging support)
+
+---
+
+## Best Practices
 
-- alfred-code-reviewer
-- alfred-trust-validation
+✅ **DO**:
+- Follow alfred best practices
+- Use latest stable tool versions
+- Maintain test coverage ≥85%
+- Document all public APIs
+
+❌ **DON'T**:
+- Skip quality gates
+- Use deprecated tools
+- Ignore security warnings
+- Mix testing frameworks

moai_adk/templates/.claude/skills/moai-alfred-refactoring-coach/examples.md

@@ -0,0 +1,29 @@
+# moai-alfred-refactoring-coach - Working Examples
+
+_Last updated: 2025-10-22_
+
+## Example 1: Basic Setup
+
+```bash
+# Setup commands
+# ...
+```
+
+## Example 2: TDD Workflow
+
+```bash
+# RED: Write failing test
+# GREEN: Implement feature
+# REFACTOR: Improve code
+```
+
+## Example 3: Quality Gate
+
+```bash
+# Run quality checks
+# Verify coverage ≥85%
+```
+
+---
+
+_For more examples, see SKILL.md reference section_

moai_adk/templates/.claude/skills/moai-alfred-refactoring-coach/reference.md

@@ -0,0 +1,28 @@
+# moai-alfred-refactoring-coach - CLI Reference
+
+_Last updated: 2025-10-22_
+
+## Quick Reference
+
+### Installation
+
+```bash
+# Installation commands
+```
+
+### Common Commands
+
+```bash
+# Test
+# Lint
+# Format
+# Build
+```
+
+## Tool Versions (2025-10-22)
+
+_No specific tool versions (workflow/process Skill)_
+
+---
+
+_For detailed usage, see SKILL.md_

moai_adk/templates/.claude/skills/moai-alfred-spec-metadata-validation/SKILL.md

@@ -1,97 +1,113 @@
 ---
-
 name: moai-alfred-spec-metadata-validation
-description: Validates SPEC YAML frontmatter (7 required fields) and HISTORY section compliance. Use when validating SPEC metadata for consistency.
+version: 2.0.0
+created: 2025-10-22
+updated: 2025-10-22
+status: active
+description: SPEC YAML frontmatter validation with 7 required fields and HISTORY section compliance.
+keywords: ['spec', 'validation', 'metadata', 'yaml']
 allowed-tools:
   - Read
-  - Write
-  - Edit
   - Bash
-  - TodoWrite
 ---
 
-# Alfred SPEC Metadata Validation
+# Alfred Spec Metadata Validation Skill
 
 ## Skill Metadata
+
 | Field | Value |
 | ----- | ----- |
-| Allowed tools | Read (read_file), Write (write_file), Edit (edit_file), Bash (terminal), TodoWrite (todo_write) |
-| Auto-load | /alfred:1-plan spec validation |
-| Trigger cues | SPEC frontmatter checks, history table enforcement, metadata guardrails. |
-
-## What it does
+| **Skill Name** | moai-alfred-spec-metadata-validation |
+| **Version** | 2.0.0 (2025-10-22) |
+| **Allowed tools** | Read (read_file), Bash (terminal) |
+| **Auto-load** | On demand when keywords detected |
+| **Tier** | Alfred |
 
-Validates SPEC document structure including YAML frontmatter (7 required fields) and HISTORY section compliance.
-
-## When to use
+---
 
-- Activates when Alfred validates SPEC templates or enforces metadata standards.
-- "SPEC verification", "Metadata check", "SPEC structure check"
-- Automatically invoked by `/alfred:1-plan`
-- Before creating SPEC document
+## What It Does
 
-## How it works
+SPEC YAML frontmatter validation with 7 required fields and HISTORY section compliance.
 
-**YAML Frontmatter Validation (7 required fields)**:
-- `id`: SPEC ID (e.g., AUTH-001)
-- `version`: Semantic Version (e.g., 0.0.1)
-- `status`: draft|active|completed|deprecated
-- `created`: YYYY-MM-DD format
-- `updated`: YYYY-MM-DD format
-- `author`: @{GitHub ID} format
-- `priority`: low|medium|high|critical
+**Key capabilities**:
+- ✅ Best practices enforcement for alfred domain
+- ✅ TRUST 5 principles integration
+- ✅ Latest tool versions (2025-10-22)
+- ✅ TDD workflow support
 
-**HISTORY Section Validation**:
-- Checks existence of HISTORY section
-- Verifies version history (INITIAL/ADDED/CHANGED/FIXED tags)
-- Validates author and date consistency
+---
 
-**Format Validation**:
-```bash
-# Check required fields
-rg "^(id|version|status|created|updated|author|priority):" .moai/specs/SPEC-*/spec.md
+## When to Use
 
-# Verify HISTORY section
-rg "^## HISTORY" .moai/specs/SPEC-*/spec.md
-```
+**Automatic triggers**:
+- Related code discussions and file patterns
+- SPEC implementation (`/alfred:2-run`)
+- Code review requests
 
-## Best Practices
-- The text shown to the user is written using TUI/report expressions.
-- When running the tool, a summary of commands and results are recorded.
+**Manual invocation**:
+- Review code for TRUST 5 compliance
+- Design new features
+- Troubleshoot issues
 
-## Examples
-```markdown
-- Call this skill inside the /alfred command to generate a report.
-- Add summary to Completion Report.
-```
+---
 
 ## Inputs
-- MoAI-ADK project context (`.moai/project/`, `.claude/` templates, etc.).
-- Parameters passed from user commands or higher commands.
+
+- Language-specific source directories
+- Configuration files
+- Test suites and sample data
 
 ## Outputs
-- Reports, checklists or recommendations for your Alfred workflow.
-- Structured data for subsequent subagent calls.
+
+- Test/lint execution plan
+- TRUST 5 review checkpoints
+- Migration guidance
 
 ## Failure Modes
-- When required input documents are missing or permissions are limited.
-- When disruptive changes are required without user approval.
+
+- When required tools are not installed
+- When dependencies are missing
+- When test coverage falls below 85%
 
 ## Dependencies
-- Cooperation with higher-level agents such as cc-manager and project-manager is required.
 
-## References
-- IEEE. "Software Requirements Specification Standard." IEEE 830-1998.
-- NASA. "Systems Engineering Handbook." https://www.nasa.gov/seh/ (accessed 2025-03-29).
+- Access to project files via Read/Bash tools
+- Integration with `moai-foundation-langs` for language detection
+- Integration with `moai-foundation-trust` for quality gates
+
+---
+
+## References (Latest Documentation)
+
+_Documentation links updated 2025-10-22_
+
+---
 
 ## Changelog
-- 2025-03-29: Added input/output/failure response to Alfred-specific skills.
 
-## Works well with
+- **v2.0.0** (2025-10-22): Major update with latest tool versions, comprehensive best practices, TRUST 5 integration
+- **v1.0.0** (2025-03-29): Initial Skill release
 
-- alfred-ears-authoring (SPEC writing guide)
-- alfred-tag-scanning (SPEC ID duplication check)
+---
 
-## Reference
+## Works Well With
+
+- `moai-foundation-trust` (quality gates)
+- `moai-alfred-code-reviewer` (code review)
+- `moai-essentials-debug` (debugging support)
+
+---
+
+## Best Practices
 
-SSOT (Single Source of Truth): `.moai/memory/spec-metadata.md`
+✅ **DO**:
+- Follow alfred best practices
+- Use latest stable tool versions
+- Maintain test coverage ≥85%
+- Document all public APIs
+
+❌ **DON'T**:
+- Skip quality gates
+- Use deprecated tools
+- Ignore security warnings
+- Mix testing frameworks