moai-adk 0.8.0__py3-none-any.whl → 0.34.0__py3-none-any.whl

moai_adk/templates/.claude/skills/moai-workflow-project/README.md

@@ -0,0 +1,190 @@
+# MoAI Menu Project Configuration Management
+
+Unified configuration management system for MoAI menu project operations, integrating 5 specialized modules into a single cohesive system.
+
+## Overview
+
+This skill replaces 5 separate configuration management skills with a unified system that provides:
+
+- Centralized Configuration: Single source of truth for all menu project settings
+- Legacy Migration: Automatic detection and migration from existing configurations
+- Module Specialization: Dedicated managers for each functional area
+- Validation Framework: JSON Schema validation and business rule checking
+- Performance Optimization: Caching and efficient file handling
+
+## Quick Start
+
+```python
+from moai_menu_project import create_config_manager, ConfigurationMigrator
+
+# Initialize configuration manager
+config_manager = create_config_manager("/path/to/config")
+
+# Migrate legacy configurations
+migrator = ConfigurationMigrator(config_manager)
+result = migrator.detect_and_migrate(backup=True)
+
+# Access module-specific configuration
+from moai_menu_project import BatchQuestionsConfigManager
+batch_manager = BatchQuestionsConfigManager(config_manager)
+settings = batch_manager.get_config()
+```
+
+## Architecture
+
+### Core Components
+
+1. UnifiedConfigManager: Centralized configuration with JSON Schema validation
+2. ConfigurationMigrator: Legacy configuration detection and migration
+3. Module Managers: Specialized access for each functional area
+4. Validation Framework: Schema and business rule validation
+5. Backup/Recovery: Automatic backup creation and rollback
+
+### Supported Modules
+
+- Batch Questions: Batch processing configuration
+- Documentation: Documentation generation settings 
+- Language Config: Internationalization and localization
+- Template Optimizer: Template processing optimization
+- Project Initializer: Project setup and initialization
+
+## Migration Guide
+
+### From Legacy Configurations
+
+The system automatically detects and migrates legacy configuration files:
+
+1. Detection: Scans for legacy configuration patterns
+2. Transformation: Converts to unified format with version-specific rules
+3. Validation: Ensures migrated data meets schema requirements
+4. Backup: Creates backup before applying changes
+5. History: Records migration for audit and rollback
+
+### Example Migration
+
+```python
+# Preview migration changes
+preview = migrator.preview_migration()
+print(f"Will migrate {preview['migrated']} files")
+
+# Execute migration
+result = migrator.detect_and_migrate(backup=True)
+print(f"Successfully migrated {result['migrated']} configurations")
+```
+
+## Configuration Schema
+
+The unified configuration follows this structure:
+
+```json
+{
+ "version": "1.0.0",
+ "metadata": {
+ "created_at": "timestamp",
+ "updated_at": "timestamp",
+ "migration_history": [...]
+ },
+ "project_settings": {...},
+ "batch_questions": {...},
+ "documentation": {...},
+ "language_config": {...},
+ "template_optimizer": {...},
+ "project_initializer": {...}
+}
+```
+
+See `schemas/config-schema.json` for complete schema definition.
+
+## File Structure
+
+```
+moai-menu-project/
+ SKILL.md # Main skill documentation
+ README.md # This file
+ __init__.py # Package initialization
+ modules/
+ config_manager.py # Core configuration management
+ migration_manager.py # Legacy migration system
+ schemas/
+ config-schema.json # JSON Schema for validation
+ examples/
+ config-migration-example.json # Migration example
+```
+
+## Integration
+
+### With MoAI Ecosystem
+
+- moai-cc-configuration: Claude Code configuration patterns
+- moai-core-workflow: Workflow-based configuration management
+- moai-quality-security: Security validation and compliance
+
+### External Systems
+
+- Environment variable overrides
+- CLI argument integration
+- API endpoint for dynamic updates
+- Monitoring and observability integration
+
+## Validation
+
+The system provides comprehensive validation:
+
+- JSON Schema: Structural validation with type checking
+- Business Rules: Custom validation logic for consistency
+- Security: Compliance checking and constraint enforcement
+- Performance: Resource limit and efficiency validation
+
+## Performance
+
+Optimizations include:
+
+- Caching: In-memory caching with file modification monitoring
+- Lazy Loading: Load only required configuration sections
+- Concurrent Access: Thread-safe operations with locking
+- Resource Management: Efficient file handling and memory usage
+
+## Security
+
+Features for secure configuration management:
+
+- Access Control: Role-based permissions for configuration access
+- Encryption: Sensitive field encryption and secure key management
+- Audit Logging: Comprehensive change tracking and audit trails
+- Data Protection: Secure backup storage and transmission
+
+## Troubleshooting
+
+Common issues and solutions:
+
+### Schema Validation Errors
+- Check JSON structure against schema
+- Verify required fields are present
+- Ensure data types match schema definitions
+
+### Migration Issues
+- Review legacy file detection patterns
+- Check transformation rules for specific versions
+- Verify file permissions and access rights
+
+### Performance Problems
+- Enable caching for frequently accessed configurations
+- Use lazy loading for large configuration files
+- Monitor resource usage and optimize file access patterns
+
+## Support
+
+For issues and questions:
+
+1. Check the troubleshooting section above
+2. Review migration examples and schema documentation
+3. Examine error messages for specific guidance
+4. Validate configuration against schema
+
+## Version History
+
+- 1.0.0: Initial release with unified configuration management
+- Automatic migration from 5 legacy skill configurations
+- JSON Schema validation and business rule checking
+- Performance optimization with caching and lazy loading
+- Security features with access control and audit logging

moai_adk/templates/.claude/skills/moai-workflow-project/SKILL.md

@@ -0,0 +1,390 @@
+---
+name: moai-workflow-project
+description: Integrated project management system with documentation, language initialization, and template optimization modules
+version: 2.0.0
+modularized: true
+updated: 2025-11-27
+status: active
+aliases: [moai-workflow-project]
+category: workflow
+allowed-tools: Read, Write, Edit, Bash, Grep, Glob
+---
+
+# MoAI Command Project - Integrated Project Management System
+
+Purpose: Comprehensive project management system that integrates documentation generation, multilingual support, and template optimization into unified architecture with intelligent automation and Claude Code integration.
+
+Scope: Consolidates documentation management, language initialization, and template optimization into single cohesive system supporting complete project lifecycle from initialization to maintenance.
+
+Target: Claude Code agents for project setup, documentation generation, multilingual support, and performance optimization.
+
+---
+
+## Quick Reference (30 seconds)
+
+Core Modules:
+- DocumentationManager: Template-based documentation generation with multilingual support
+- LanguageInitializer: Language detection, configuration, and localization management 
+- TemplateOptimizer: Advanced template analysis and performance optimization
+- MoaiMenuProject: Unified interface integrating all modules
+
+Quick Start:
+```python
+# Complete project initialization
+from moai_menu_project import MoaiMenuProject
+
+project = MoaiMenuProject("./my-project")
+result = project.initialize_complete_project(
+ language="en",
+ user_name="Developer Name", 
+ domains=["backend", "frontend"],
+ project_type="web_application"
+)
+```
+
+Key Features:
+- Automatic project type detection and template selection
+- Multilingual documentation generation (en, ko, ja, zh)
+- Intelligent template optimization with performance benchmarking
+- SPEC-driven documentation updates
+- Multi-format export (markdown, HTML, PDF)
+
+---
+
+## Implementation Guide
+
+### Module Architecture
+
+DocumentationManager:
+- Template-based documentation generation
+- Project type detection (web, mobile, CLI, library, ML)
+- Multilingual support with localized content
+- SPEC data integration for automatic updates
+- Multi-format export capabilities
+
+LanguageInitializer: 
+- Automatic language detection from project content
+- Comprehensive language configuration management
+- Agent prompt localization with cost optimization
+- Domain-specific language support
+- Locale management and cultural adaptation
+
+TemplateOptimizer:
+- Advanced template analysis with complexity metrics
+- Performance optimization with size reduction
+- Intelligent backup and recovery system
+- Benchmarking and performance tracking
+- Automated optimization recommendations
+
+### Core Workflows
+
+Complete Project Initialization:
+```python
+# Step 1: Initialize integrated system
+project = MoaiMenuProject("/path/to/project")
+
+# Step 2: Complete setup with all modules
+result = project.initialize_complete_project(
+ language="ko", # Korean language support
+ user_name="",
+ domains=["backend", "frontend", "mobile"],
+ project_type="web_application",
+ optimization_enabled=True
+)
+
+# Result includes:
+# - Language configuration with token cost analysis
+# - Documentation structure creation
+# - Template analysis and optimization
+# - Multilingual documentation setup
+```
+
+Documentation Generation from SPEC:
+```python
+# SPEC data for feature documentation
+spec_data = {
+ "id": "SPEC-001",
+ "title": "User Authentication System",
+ "description": "Implement secure authentication with JWT",
+ "requirements": [
+ "User registration with email verification",
+ "JWT token generation and validation",
+ "Password reset functionality"
+ ],
+ "status": "Planned",
+ "priority": "High",
+ "api_endpoints": [
+ {
+ "path": "/api/auth/login",
+ "method": "POST",
+ "description": "User login endpoint"
+ }
+ ]
+}
+
+# Generate comprehensive documentation
+docs_result = project.generate_documentation_from_spec(spec_data)
+
+# Results include:
+# - Feature documentation with requirements
+# - API documentation with endpoint details
+# - Updated project documentation files
+# - Multilingual versions if configured
+```
+
+Template Performance Optimization:
+```python
+# Analyze current templates
+analysis = project.template_optimizer.analyze_project_templates()
+
+# Apply optimizations with backup
+optimization_options = {
+ "backup_first": True,
+ "apply_size_optimizations": True,
+ "apply_performance_optimizations": True,
+ "apply_complexity_optimizations": True,
+ "preserve_functionality": True
+}
+
+optimization_result = project.optimize_project_templates(optimization_options)
+
+# Results include:
+# - Size reduction percentage
+# - Performance improvement metrics
+# - Backup creation confirmation
+# - Detailed optimization report
+```
+
+### Language and Localization
+
+Automatic Language Detection:
+```python
+# System analyzes project for language indicators
+language = project.language_initializer.detect_project_language()
+
+# Detection methods:
+# - File content analysis (comments, strings)
+# - Configuration file examination
+# - System locale detection
+# - Directory structure patterns
+```
+
+Multilingual Documentation:
+```python
+# Create documentation structure for multiple languages
+multilingual_result = project.language_initializer.create_multilingual_documentation_structure("ko")
+
+# Creates:
+# - /docs/ko/ - Korean documentation
+# - /docs/en/ - English fallback 
+# - Language negotiation configuration
+# - Automatic redirection setup
+```
+
+Agent Prompt Localization:
+```python
+# Localize agent prompts with cost consideration
+localized_prompt = project.language_initializer.localize_agent_prompts(
+ base_prompt="Generate user authentication system",
+ language="ko"
+)
+
+# Result includes:
+# - Korean language instructions
+# - Cultural context adaptations
+# - Token cost optimization recommendations
+```
+
+### Template Optimization
+
+Performance Analysis:
+```python
+# Comprehensive template analysis
+analysis = project.template_optimizer.analyze_project_templates()
+
+# Analysis includes:
+# - File size and complexity metrics
+# - Performance bottleneck identification
+# - Optimization opportunity scoring
+# - Resource usage patterns
+# - Backup recommendations
+```
+
+Intelligent Optimization:
+```python
+# Create optimized versions with backup
+optimization_result = project.template_optimizer.create_optimized_templates({
+ "backup_first": True,
+ "apply_size_optimizations": True,
+ "apply_performance_optimizations": True,
+ "apply_complexity_optimizations": True
+})
+
+# Optimizations applied:
+# - Whitespace and redundancy reduction
+# - Template structure optimization
+# - Complexity reduction techniques
+# - Performance caching improvements
+```
+
+### Configuration Management
+
+Integrated Configuration:
+```python
+# Get comprehensive project status
+status = project.get_project_status()
+
+# Status includes:
+# - Project metadata and type
+# - Language configuration and costs
+# - Documentation completion status
+# - Template optimization results
+# - Module initialization states
+```
+
+Language Settings Updates:
+```python
+# Update language configuration
+update_result = project.update_language_settings({
+ "language.conversation_language": "ja",
+ "language.agent_prompt_language": "english", # Cost optimization
+ "language.documentation_language": "ja"
+})
+
+# Automatic updates:
+# - Configuration file changes
+# - Documentation structure updates
+# - Template localization adjustments
+```
+
+---
+
+## Advanced Implementation (10+ minutes)
+
+For advanced patterns including custom template development, performance optimization strategies, and integration workflows, see:
+
+- [Advanced Patterns](modules/advanced-patterns.md): Custom templates, caching, batch processing
+- Integration Workflows: Complete project lifecycle and multilingual management
+- Performance Optimization: Template caching and batch optimization strategies
+
+## Resources
+
+### Module Files
+
+Core Implementation:
+- `modules/documentation_manager.py` - Documentation generation and management
+- `modules/language_initializer.py` - Language detection and configuration
+- `modules/template_optimizer.py` - Template analysis and optimization
+- `__init__.py` - Unified interface and integration logic
+
+Templates and Examples:
+- `templates/doc-templates/` - Documentation template collection
+- `examples/complete_project_setup.py` - Comprehensive usage examples
+- `examples/quick_start.py` - Quick start guide
+
+### Configuration Files
+
+Project Configuration:
+```json
+{
+ "project": {
+ "name": "My Project",
+ "type": "web_application",
+ "initialized_at": "2025-11-25T..."
+ },
+ "language": {
+ "conversation_language": "en",
+ "agent_prompt_language": "english",
+ "documentation_language": "en"
+ },
+ "menu_system": {
+ "version": "1.0.0",
+ "fully_initialized": true
+ }
+}
+```
+
+Language Configuration:
+```json
+{
+ "en": {
+ "name": "English",
+ "native_name": "English",
+ "code": "en",
+ "locale": "en_US.UTF-8",
+ "agent_prompt_language": "english",
+ "token_cost_impact": 0
+ },
+ "ko": {
+ "name": "Korean",
+ "native_name": "", 
+ "code": "ko",
+ "locale": "ko_KR.UTF-8",
+ "agent_prompt_language": "localized",
+ "token_cost_impact": 20
+ }
+}
+```
+
+### Works Well With
+
+- moai-foundation-core - For core execution patterns and SPEC-driven development workflows
+- moai-foundation-claude - For Claude Code integration and configuration
+- moai-workflow-docs - For unified documentation management
+- moai-workflow-templates - For template optimization strategies
+- moai-library-nextra - For advanced documentation architecture
+
+### Integration Examples
+
+Command Line Usage:
+```python
+# CLI interface for project management
+python -m moai_menu_project.cli init --language ko --domains backend,frontend
+python -m moai_menu_project.cli generate-docs --spec-file SPEC-001.json
+python -m moai_menu_project.cli optimize-templates --backup
+python -m moai_menu_project.cli export-docs --format html --language ko
+```
+
+API Integration:
+```python
+# REST API integration example
+from moai_menu_project import MoaiMenuProject
+
+app = FastAPI()
+
+@app.post("/projects/{project_id}/initialize")
+async def initialize_project(project_id: str, config: ProjectConfig):
+ project = MoaiMenuProject(f"./projects/{project_id}")
+ result = project.initialize_complete_project(config.dict())
+ return result
+
+@app.post("/projects/{project_id}/docs")
+async def generate_docs(project_id: str, spec_data: SpecData):
+ project = MoaiMenuProject(f"./projects/{project_id}")
+ result = project.generate_documentation_from_spec(spec_data.dict())
+ return result
+```
+
+### Performance Metrics
+
+Module Performance:
+- Documentation Generation: ~2-5 seconds for complete documentation
+- Language Detection: ~500ms for average project analysis 
+- Template Optimization: ~10-30 seconds depending on project size
+- Configuration Updates: ~100ms for language setting changes
+
+Memory Usage:
+- Base System: ~50MB RAM usage
+- Large Projects: Additional ~10-50MB depending on template count
+- Optimization Cache: ~5-20MB for performance improvements
+
+File Size Impact:
+- Documentation: ~50-200KB per project
+- Optimization Backups: Size of original templates
+- Configuration: ~5-10KB for complete project setup
+
+---
+
+Version: 1.0.0 
+Last Updated: 2025-11-25 
+Integration Status: Complete - All modules implemented and tested