moai-adk 0.25.4__py3-none-any.whl → 0.41.0__py3-none-any.whl

moai_adk/templates/.claude/skills/moai-workflow-testing/modules/README.md

@@ -0,0 +1,269 @@
+# Development Workflow Testing Modules
+
+> Purpose: Advanced implementation modules for comprehensive development workflow management
+> Structure: Modular architecture with focused, in-depth implementations
+> Compliance: Progressive disclosure with main SKILL.md under 500 lines
+
+## Module Overview
+
+This modules directory contains detailed implementation modules for the moai-workflow-testing skill. Each module provides comprehensive code examples, advanced features, and integration patterns that extend the core functionality described in the main SKILL.md file.
+
+## Available Modules
+
+### Root Level Modules
+
+#### [AI-Powered Debugging](./ai-debugging.md)
+Complexity: Advanced | Time: 20+ minutes | Dependencies: Python 3.8+, Context7 MCP
+
+- Intelligent error classification with Context7 patterns
+- AI-driven solution generation with confidence scoring
+- Learning debugger that improves from previous fixes
+- Real-time error pattern recognition and prevention strategies
+
+Key Features:
+- Context7 integration for latest debugging patterns
+- Error frequency tracking and analysis
+- Automated solution generation with multiple approaches
+- Performance-aware debugging with minimal overhead
+
+### [Smart Refactoring](./smart-refactoring.md)
+Complexity: Advanced | Time: 25+ minutes | Dependencies: Python 3.8+, Rope, AST, Context7 MCP
+
+- Technical debt analysis with comprehensive code scanning
+- Safe automated refactoring with risk assessment
+- AI-driven refactoring suggestions with Context7 patterns
+- Dependency-aware refactoring with impact analysis
+
+Key Features:
+- Context7 refactoring patterns integration
+- Safe transformation planning with rollback strategies
+- Technical debt prioritization and quantification
+- Project-aware refactoring with convention detection
+
+### [Performance Optimization](./performance-optimization.md)
+Complexity: Advanced | Time: 30+ minutes | Dependencies: Python 3.8+, cProfile, memory_profiler, psutil
+
+- Real-time performance monitoring with configurable sampling
+- Bottleneck detection with AI-powered analysis
+- Automated optimization plan generation
+- Memory leak detection and optimization strategies
+
+Key Features:
+- Multi-dimensional performance analysis
+- Intelligent optimization suggestions with Context7 patterns
+- Continuous monitoring with alerting capabilities
+- Performance regression detection and prevention
+
+### [TDD with Context7](./tdd-context7.md)
+Complexity: Advanced | Time: 25+ minutes | Dependencies: Python 3.8+, pytest, Context7 MCP
+
+- RED-GREEN-REFACTOR cycle automation with AI assistance
+- Context7-enhanced test generation and pattern matching
+- Intelligent test case generation from specifications
+- Automated test suite optimization and maintenance
+
+Key Features:
+- Context7 testing patterns and best practices
+- AI-powered test case generation with coverage optimization
+- Comprehensive test specification management
+- Automated test execution with quality validation
+
+### [Automated Code Review](./automated-code-review.md)
+Complexity: Advanced | Time: 35+ minutes | Dependencies: Python 3.8+, pylint, flake8, bandit, mypy
+
+- TRUST 5 framework validation with AI analysis
+- Multi-tool static analysis integration and aggregation
+- Context7 security patterns and vulnerability detection
+- Automated fix suggestions with diff generation
+
+Key Features:
+- Comprehensive TRUST 5 category scoring
+- Context7 security and quality pattern integration
+- Automated issue detection with prioritization
+- Integration with CI/CD pipelines and quality gates
+
+### Thematic Subdirectories
+
+#### [Automated Code Review](./automated-code-review/)
+Comprehensive code review workflows with TRUST 5 framework integration.
+- `context7-integration.md` - Context7 integration for code review
+- `review-workflows.md` - Code review workflow patterns
+- `trust5-framework.md` - TRUST 5 framework overview
+- `trust5-framework/` - TRUST 5 sub-components directory
+  - `relevance-analysis.md` - Relevance dimension analysis
+  - `safety-analysis.md` - Safety dimension analysis
+  - `scoring-algorithms.md` - Scoring algorithm details
+  - `timeliness-analysis.md` - Timeliness dimension analysis
+  - `truthfulness-analysis.md` - Truthfulness dimension analysis
+  - `usability-analysis.md` - Usability dimension analysis
+
+#### [Code Review Patterns](./code-review/)
+Code review patterns and methodologies.
+- `analysis-patterns.md` - Code analysis patterns
+- `core-classes.md` - Core code review classes
+- `tool-integration.md` - Tool integration patterns
+
+#### [Debugging Workflows](./debugging/)
+AI-powered debugging workflows.
+- `debugging-workflows.md` - Debugging workflow processes
+- `error-analysis.md` - Error analysis techniques
+
+#### [Performance Optimization](./performance/)
+Performance optimization strategies.
+- `optimization-patterns.md` - Performance optimization patterns
+- `profiling-techniques.md` - Profiling and measurement techniques
+
+#### [Refactoring Patterns](./refactoring/)
+AI-powered refactoring workflows.
+- `ai-workflows.md` - AI refactoring workflows
+- `patterns.md` - Refactoring patterns
+
+#### [TDD with Context7](./tdd-context7/)
+Test-driven development with Context7 integration.
+- `advanced-features.md` - Advanced TDD features
+- `red-green-refactor.md` - RED-GREEN-REFACTOR cycle
+- `test-generation.md` - Automated test generation
+- `test-patterns.md` - TDD testing patterns
+
+#### [Core TDD](./tdd/)
+Core TDD documentation.
+- `core-classes.md` - Core TDD classes and patterns
+
+## Module Integration
+
+### Using Individual Modules
+
+Each module can be used independently or as part of the unified workflow system:
+
+```python
+# Import specific module components
+from moai_workflow_testing.modules.ai_debugging import AIDebugger
+from moai_workflow_testing.modules.performance_optimization import PerformanceProfiler
+
+# Use modules independently
+debugger = AIDebugger(context7_client=context7)
+profiler = PerformanceProfiler(context7_client=context7)
+```
+
+### Unified Workflow Integration
+
+All modules are designed to work together seamlessly:
+
+```python
+from moai_workflow_testing import DevelopmentWorkflow
+
+# Complete workflow with all modules
+workflow = DevelopmentWorkflow(
+ project_path="/project/src",
+ context7_client=context7,
+ enable_all_modules=True
+)
+
+results = await workflow.execute_complete_workflow()
+```
+
+## Module Dependencies
+
+### Core Dependencies
+- Python 3.8+: Base runtime environment
+- Context7 MCP: For pattern integration and AI assistance
+- asyncio: Asynchronous execution support
+
+### Module-Specific Dependencies
+- Performance Optimization: cProfile, memory_profiler, psutil, line_profiler
+- Smart Refactoring: Rope, AST, Context7 patterns
+- Automated Code Review: pylint, flake8, bandit, mypy
+- TDD: pytest, unittest, coverage, Context7 testing patterns
+
+## Best Practices
+
+### Module Selection
+1. Start with main SKILL.md: Use the overview to understand capabilities
+2. Progress to modules: Dive into specific modules as needed
+3. Combine selectively: Use only the modules relevant to your workflow
+
+### Integration Guidelines
+1. Context7 Integration: Enable Context7 for enhanced AI capabilities
+2. Performance Considerations: Monitor overhead of analysis tools
+3. Quality Gates: Configure appropriate thresholds for your project
+
+### Maintenance
+1. Regular Updates: Keep Context7 patterns current
+2. Tool Versions: Maintain compatible static analysis tool versions
+3. Pattern Evolution: Update patterns as best practices evolve
+
+## Module Development
+
+### Adding New Modules
+
+To add a new module to this skill:
+
+1. Create Module File: Use the established template pattern
+2. Follow Structure: Include core implementation, advanced features, and best practices
+3. Update References: Add module reference to main SKILL.md
+4. Test Integration: Ensure compatibility with existing modules
+
+### Module Template
+
+```markdown
+# Module Title
+
+> Module: Brief module description
+> Complexity: Basic|Intermediate|Advanced
+> Time: X+ minutes
+> Dependencies: List of required libraries
+
+## Core Implementation
+
+[Complete implementation with comprehensive examples]
+
+## Advanced Features
+
+[Extended functionality and integration patterns]
+
+## Best Practices
+
+[Guidelines for production use]
+
+---
+
+Module: `modules/module-name.md`
+Related: [Other Module](./other-module.md) | [Related Module](./related-module.md)
+```
+
+## Quality Assurance
+
+### Module Standards
+- Comprehensive documentation with examples
+- Error handling and edge case coverage
+- Performance considerations and optimizations
+- Context7 integration where appropriate
+- Cross-module compatibility testing
+
+### Validation Checklist
+- [ ] Module compiles and runs without errors
+- [ ] Examples are functional and tested
+- [ ] Documentation is complete and accurate
+- [ ] Integration with other modules works
+- [ ] Performance meets acceptable standards
+
+## Support and Contributing
+
+### Module Support
+- Documentation: Each module includes comprehensive usage examples
+- Integration: See main SKILL.md for integration patterns
+- Dependencies: Check individual modules for specific requirements
+
+### Contributing
+When contributing to modules:
+
+1. Follow Templates: Use established module structure
+2. Test Thoroughly: Ensure compatibility with existing modules
+3. Document Completely: Include comprehensive examples and use cases
+4. Update References: Keep main SKILL.md and README current
+
+---
+
+Last Updated: 2026-01-06
+Module Count: 12 root-level modules + 7 thematic subdirectories
+Maintained by: MoAI-ADK Development Workflow Team