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

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

@@ -0,0 +1,260 @@
+---
+name: "moai-workflow-project"
+description: "Integrated project management system with documentation, language initialization, and template optimization modules. Use when setting up projects, generating documentation, configuring multilingual support, or optimizing templates."
+version: 2.0.0
+category: "workflow"
+modularized: true
+updated: 2026-01-08
+status: "active"
+aliases: ['moai-workflow-project']
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash
+  - Grep
+  - Glob
+  - mcp__context7__resolve-library-id
+  - mcp__context7__get-library-docs
+---
+
+# MoAI Workflow 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
+
+Core Capabilities:
+- Documentation Management: Template-based documentation generation with multilingual support
+- Language Initialization: Language detection, configuration, and localization management
+- Template Optimization: Advanced template analysis and performance optimization
+- Unified Interface: Single entry point integrating all capabilities
+
+Key Features:
+- Automatic project type detection and template selection
+- Multilingual documentation generation supporting English, Korean, Japanese, and Chinese
+- Intelligent template optimization with performance benchmarking
+- SPEC-driven documentation updates
+- Multi-format export including Markdown, HTML, and PDF
+
+Supported Project Types:
+- Web applications
+- Mobile applications
+- Command-line interface tools
+- Libraries and packages
+- Machine learning projects
+
+---
+
+## Implementation Guide
+
+### Module Architecture
+
+Documentation Management Capabilities:
+- Template-based documentation generation
+- Project type detection for web, mobile, CLI, library, and ML projects
+- Multilingual support with localized content
+- SPEC data integration for automatic updates
+- Multi-format export capabilities
+
+Language Initialization Capabilities:
+- 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
+
+Template Optimization Capabilities:
+- 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 Workflow:
+
+Step 1: Initialize the project management system by specifying the project directory path
+
+Step 2: Execute complete setup with the following configuration parameters:
+- Language setting: Specify the primary language code such as "en" for English or "ko" for Korean
+- User name: Provide the developer or team name for personalization
+- Domains: List the project domains such as backend, frontend, and mobile
+- Project type: Specify the project type such as web_application
+- Optimization enabled: Set to true to enable template optimization during initialization
+
+Step 3: Review initialization results which include:
+- Language configuration with token cost analysis
+- Documentation structure creation status
+- Template analysis and optimization report
+- Multilingual documentation setup confirmation
+
+Documentation Generation from SPEC Workflow:
+
+Step 1: Prepare SPEC data with the following structure:
+- Identifier: Unique SPEC ID such as SPEC-001
+- Title: Feature or component title
+- Description: Brief description of the implementation
+- Requirements: List of specific requirements
+- Status: Current status such as Planned, In Progress, or Complete
+- Priority: Priority level such as High, Medium, or Low
+- API Endpoints: List of endpoint definitions including path, method, and description
+
+Step 2: Generate comprehensive documentation from the SPEC data
+
+Step 3: Review generated documentation which includes:
+- Feature documentation with requirements
+- API documentation with endpoint details
+- Updated project documentation files
+- Multilingual versions if configured
+
+Template Performance Optimization Workflow:
+
+Step 1: Analyze current templates to gather metrics
+
+Step 2: Configure optimization options:
+- Backup first: Set to true to create backup before optimization
+- Apply size optimizations: Enable to reduce file sizes
+- Apply performance optimizations: Enable to improve loading times
+- Apply complexity optimizations: Enable to simplify template structures
+- Preserve functionality: Ensure all features remain intact
+
+Step 3: Execute optimization and review results:
+- Size reduction percentage achieved
+- Performance improvement metrics
+- Backup creation confirmation
+- Detailed optimization report
+
+### Language and Localization
+
+Automatic Language Detection Process:
+
+The system analyzes the project for language indicators using the following methods:
+- File content analysis examining comments and strings
+- Configuration file examination for locale settings
+- System locale detection
+- Directory structure patterns
+
+Multilingual Documentation Structure:
+
+When creating documentation for multiple languages, the system generates:
+- Language-specific documentation directories such as docs/ko for Korean and docs/en for English
+- Language negotiation configuration
+- Automatic redirection setup between language versions
+
+Agent Prompt Localization:
+
+The localization system provides:
+- Language-specific instructions for agents
+- Cultural context adaptations
+- Token cost optimization recommendations for multilingual prompts
+
+### Template Optimization
+
+Performance Analysis Process:
+
+Template analysis provides the following metrics:
+- File size and complexity measurements
+- Performance bottleneck identification
+- Optimization opportunity scoring
+- Resource usage patterns
+- Backup recommendations
+
+Intelligent Optimization Process:
+
+The optimization system applies the following techniques:
+- Whitespace and redundancy reduction
+- Template structure optimization
+- Complexity reduction techniques
+- Performance caching improvements
+
+### Configuration Management
+
+Integrated Configuration Status:
+
+The project status includes:
+- Project metadata and type classification
+- Language configuration and associated costs
+- Documentation completion status
+- Template optimization results
+- Module initialization states
+
+Language Settings Update Process:
+
+When updating language settings, configure the following parameters:
+- Conversation language: The language for user-facing responses
+- Agent prompt language: The language for internal agent instructions, often kept as English for cost optimization
+- Documentation language: The language for generated documentation
+
+Updates trigger the following automatic changes:
+- Configuration file modifications
+- Documentation structure updates
+- Template localization adjustments
+
+---
+
+## Advanced Implementation
+
+For advanced patterns including custom template development, performance optimization strategies, and integration workflows, see reference.md which covers:
+
+- Custom Templates: Creating project-type-specific documentation templates
+- Performance Caching: Implementing template caching for improved performance
+- Batch Processing: Efficiently processing multiple templates simultaneously
+- Integration Workflows: Complete project lifecycle and multilingual management
+
+---
+
+## Resources
+
+### Configuration Structure
+
+Project Configuration Fields:
+- Project name: The display name for the project
+- Project type: Classification such as web_application, mobile_application, or cli_tool
+- Initialization timestamp: When the project was initialized
+- Language configuration: Conversation, agent prompt, and documentation language settings
+- System version: The project management system version
+- Initialization status: Whether all modules are fully initialized
+
+Language Configuration Fields for Each Supported Language:
+- Name: Display name in English
+- Native name: Display name in the native language
+- Code: Language code such as en, ko, ja, or zh
+- Locale: System locale string
+- Agent prompt language: Whether to use English or localized prompts
+- Token cost impact: Percentage increase in token usage for non-English prompts
+
+### Performance Metrics
+
+Documentation Generation Performance:
+- Complete documentation generation typically completes within 2 to 5 seconds
+- Language detection analysis completes within approximately 500 milliseconds
+- Template optimization duration varies from 10 to 30 seconds depending on project size
+- Configuration updates complete within approximately 100 milliseconds
+
+Memory Usage Characteristics:
+- Base system requires approximately 50MB RAM
+- Large projects may require an additional 10 to 50MB depending on template count
+- Optimization cache uses approximately 5 to 20MB for performance improvements
+
+File Size Impact:
+- Documentation files range from 50 to 200KB per project
+- Optimization backups match the size of original templates
+- Configuration files range from 5 to 10KB for complete project setup
+
+---
+
+## Works Well With
+
+- moai-foundation-core: Core execution patterns and SPEC-driven development workflows
+- moai-foundation-claude: Claude Code integration and configuration
+- moai-workflow-docs: Unified documentation management
+- moai-workflow-templates: Template optimization strategies
+- moai-library-nextra: Advanced documentation architecture