@zeyue0329/xiaoma-cli 1.0.49 → 6.0.0-alpha.13

package/src/modules/xmb/workflows/create-workflow/steps/step-11-build.md

@@ -0,0 +1,262 @@
+---
+name: 'step-11-build'
+description: 'Generate all workflow files based on the approved plan'
+
+# Path Definitions
+workflow_path: '{project-root}/{xiaoma_folder}/xmb/workflows/create-workflow'
+
+# File References
+thisStepFile: '{workflow_path}/steps/step-11-build.md'
+nextStepFile: '{workflow_path}/steps/step-12-review.md'
+workflowFile: '{workflow_path}/workflow.md'
+# Output files for workflow creation process
+workflowPlanFile: '{output_folder}/workflow-plan-{new_workflow_name}.md'
+targetWorkflowPath: '{custom_workflow_location}/{new_workflow_name}'
+
+# Task References
+advancedElicitationTask: '{project-root}/{xiaoma_folder}/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/{xiaoma_folder}/core/workflows/party-mode/workflow.md'
+
+# Template References
+workflowTemplate: '{project-root}/{xiaoma_folder}/xmb/docs/workflows/workflow-template.md'
+stepTemplate: '{project-root}/{xiaoma_folder}/xmb/docs/workflows/step-template.md'
+contentTemplate: '{workflow_path}/templates/content-template.md'
+buildSummaryTemplate: '{workflow_path}/templates/build-summary.md'
+---
+
+# Step 5: Workflow File Generation
+
+## STEP GOAL:
+
+To generate all the workflow files (workflow.md, step files, templates, and supporting files) based on the approved plan from the previous review step.
+
+## MANDATORY EXECUTION RULES (READ FIRST):
+
+### Universal Rules:
+
+- 🛑 NEVER generate content without user input
+- 📖 CRITICAL: Read the complete step file before taking any action
+- 🔄 CRITICAL: When loading next step with 'C', ensure entire file is read
+- 📋 YOU ARE A FACILITATOR, not a content generator
+
+### Role Reinforcement:
+
+- ✅ You are a workflow architect and systems designer
+- ✅ If you already have been given communication or persona patterns, continue to use those while playing this new role
+- ✅ We engage in collaborative dialogue, not command-response
+- ✅ You bring implementation expertise and best practices
+- ✅ User brings their specific requirements and design approvals
+
+### Step-Specific Rules:
+
+- 🎯 Focus ONLY on generating files based on approved design
+- 🚫 FORBIDDEN to modify the design without user consent
+- 💬 Generate files collaboratively, getting approval at each stage
+- 🚪 CREATE files in the correct target location
+
+## EXECUTION PROTOCOLS:
+
+- 🎯 Generate files systematically from design
+- 💾 Document all generated files and their locations
+- 📖 Update frontmatter `stepsCompleted: [1, 2, 3, 4]` before loading next step
+- 🚫 FORBIDDEN to load next step until user selects 'C' and build is complete
+
+## CONTEXT BOUNDARIES:
+
+- Approved plan from step 10 guides implementation
+- Generate files in target workflow location
+- Load templates and documentation as needed during build
+- Follow step-file architecture principles
+
+## BUILD REFERENCE MATERIALS:
+
+- When building each step file, you must follow template `{project-root}/{xiaoma_folder}/xmb/docs/workflows/step-template.md`
+- When building the main workflow.md file, you must follow template `{project-root}/{xiaoma_folder}/xmb/docs/workflows/workflow-template.md`
+- Example step files from {project-root}/{xiaoma_folder}/xmb/reference/workflows/meal-prep-nutrition/workflow.md for patterns
+
+## FILE GENERATION SEQUENCE:
+
+### 1. Confirm Build Readiness
+
+Based on the approved plan, confirm:
+"I have your approved plan and I'm ready to generate the workflow files. The plan specifies creating:
+
+- Main workflow.md file
+- [Number] step files
+- [Number] templates
+- Supporting files
+
+All in: {targetWorkflowPath}
+
+Ready to proceed?"
+
+### 2. Create Directory Structure
+
+Create the workflow folder structure in the target location:
+
+```
+{custom_workflow_location}/{workflow_name}/
+├── workflow.md
+├── steps/
+│   ├── step-01-init.md
+│   ├── step-02-[name].md
+│   └── ...
+├── templates/
+│   └── [as needed]
+└── data/
+    └── [as needed]
+```
+
+For xmb module, this will be: `{xiaoma_folder}/custom/src/workflows/{workflow_name}/`
+For other modules, check their install-config.yaml for custom_workflow_location
+
+### 3. Generate workflow.md
+
+Load and follow {workflowTemplate}:
+
+- Create workflow.md using template structure
+- Insert workflow name and description
+- Configure all path variables ({project-root}, {xiaoma_folder}, {workflow_path})
+- Set web_bundle flag to true unless user has indicated otherwise
+- Define role and goal
+- Include initialization path to step-01
+
+### 4. Generate Step Files
+
+For each step in the design:
+
+- Load and follow {stepTemplate}
+- Create step file using template structure
+- Customize with step-specific content
+- Ensure proper frontmatter with path references
+- Include appropriate menu handling and universal rules
+- Follow all mandatory rules and protocols from template
+
+### 5. Generate Templates (If Needed)
+
+For document workflows:
+
+- Load {contentTemplate}
+- Create template.md with proper structure
+- Include all variables from design
+- Ensure variable naming consistency
+
+### 6. Generate Supporting Files
+
+Based on design requirements:
+
+- Create data files (csv)
+- Generate README.md with usage instructions
+- Create any configuration files
+- Add validation checklists if designed
+
+### 7. Verify File Generation
+
+After creating all files:
+
+- Check all file paths are correct
+- Validate frontmatter syntax
+- Ensure variable consistency across files
+- Confirm sequential step numbering
+- Verify menu handling logic
+
+### 8. Document Generated Files
+
+Create a summary of what was generated:
+
+- List all files created with full paths
+- Note any customizations from templates
+- Identify any manual steps needed
+- Provide next steps for testing
+
+## QUALITY CHECKS DURING BUILD:
+
+### Frontmatter Validation
+
+- All YAML syntax is correct
+- Required fields are present
+- Path variables use correct format
+- No hardcoded paths exist
+
+### Step File Compliance
+
+- Each step follows the template structure
+- All mandatory rules are included
+- Menu handling is properly implemented
+- Step numbering is sequential
+
+### Cross-File Consistency
+
+- Variable names match across files
+- Path references are consistent
+- Dependencies are correctly defined
+- No orphaned references exist
+
+## BUILD PRINCIPLES:
+
+### Follow Design Exactly
+
+- Implement the design as approved
+- Don't add or remove steps without consultation
+- Maintain the interaction patterns designed
+- Preserve the data flow architecture
+
+### Maintain Best Practices
+
+- Keep step files focused and reasonably sized (typically 5-10KB)
+- Use collaborative dialogue patterns
+- Include proper error handling
+- Follow naming conventions
+
+### Ensure Extensibility
+
+- Design for future modifications
+- Include clear documentation
+- Make code readable and maintainable
+- Provide examples where helpful
+
+## CONTENT TO APPEND TO PLAN:
+
+After generating all files, append to {workflowPlanFile}:
+
+Load and append the content from {buildSummaryTemplate}
+
+### 9. Present MENU OPTIONS
+
+Display: **Build Complete - Select an Option:** [C] Continue to Review
+
+#### EXECUTION RULES:
+
+- Build complete - all files generated
+- Present simple completion status
+- User selects [C] to continue to review step
+
+#### Menu Handling Logic:
+
+- IF C: Save build summary to {workflowPlanFile}, update frontmatter, then load, read entire file, then execute {nextStepFile}
+- IF Any other comments or queries: respond and redisplay menu
+
+## CRITICAL STEP COMPLETION NOTE
+
+ONLY WHEN C is selected and content is saved to plan and frontmatter is updated, will you then load, read entire file, then execute {nextStepFile} to execute and begin workflow review step.
+
+---
+
+## 🚨 SYSTEM SUCCESS/FAILURE METRICS
+
+### ✅ SUCCESS:
+
+- All workflow files generated in correct locations
+- Files follow step-file architecture principles
+- Plan implemented exactly as approved
+- Build documented in {workflowPlanFile}
+- Frontmatter updated with step completion
+
+### ❌ SYSTEM FAILURE:
+
+- Generating files without user approval
+- Deviating from approved plan
+- Creating files with incorrect paths
+- Not updating plan frontmatter
+
+**Master Rule:** Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.

package/src/modules/xmb/workflows/create-workflow/steps/step-12-review.md

@@ -0,0 +1,270 @@
+---
+name: 'step-12-review'
+description: 'Review the generated workflow and provide final validation and next steps'
+
+# Path Definitions
+workflow_path: '{project-root}/{xiaoma_folder}/xmb/workflows/create-workflow'
+
+# File References
+thisStepFile: '{workflow_path}/steps/step-12-review.md'
+workflowFile: '{workflow_path}/workflow.md'
+# Output files for workflow creation process
+workflowPlanFile: '{output_folder}/workflow-plan-{new_workflow_name}.md'
+targetWorkflowPath: '{custom_workflow_location}/{new_workflow_name}'
+
+# Task References
+advancedElicitationTask: '{project-root}/{xiaoma_folder}/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/{xiaoma_folder}/core/workflows/party-mode/workflow.md'
+
+# Template References
+reviewTemplate: '{workflow_path}/templates/review-section.md'
+completionTemplate: '{workflow_path}/templates/completion-section.md'
+---
+
+# Step 6: Workflow Review and Completion
+
+## STEP GOAL:
+
+To review the generated workflow for completeness, accuracy, and adherence to best practices, then provide next steps for deployment and usage.
+
+## MANDATORY EXECUTION RULES (READ FIRST):
+
+### Universal Rules:
+
+- 🛑 NEVER generate content without user input
+- 📖 CRITICAL: Read the complete step file before taking any action
+- 🔄 CRITICAL: Always read the complete step file before taking any action
+- 📋 YOU ARE A FACILITATOR, not a content generator
+
+### Role Reinforcement:
+
+- ✅ You are a workflow architect and systems designer
+- ✅ If you already have been given communication or persona patterns, continue to use those while playing this new role
+- ✅ We engage in collaborative dialogue, not command-response
+- ✅ You bring quality assurance expertise and validation knowledge
+- ✅ User provides final approval and feedback
+
+### Step-Specific Rules:
+
+- 🎯 Focus ONLY on reviewing and validating generated workflow
+- 🚫 FORBIDDEN to make changes without user approval
+- 💬 Guide review process collaboratively
+- 🚪 COMPLETE the workflow creation process
+
+## EXECUTION PROTOCOLS:
+
+- 🎯 Conduct thorough review of generated workflow
+- 💾 Document review findings and completion status
+- 📖 Update frontmatter `stepsCompleted: [1, 2, 3, 4, 5]` and mark complete
+- 🚫 This is the final step - no next step to load
+
+## CONTEXT BOUNDARIES:
+
+- Generated workflow files are available for review
+- Focus on validation and quality assurance
+- This step completes the workflow creation process
+- No file modifications without explicit user approval
+
+## WORKFLOW REVIEW PROCESS:
+
+### 1. File Structure Review
+
+Verify the workflow organization:
+
+- Are all required files present?
+- Is the directory structure correct?
+- Are file names following conventions?
+- Are paths properly configured?
+
+### 2. Configuration Validation
+
+Check workflow.yaml:
+
+- Is all metadata correctly filled?
+- Are path variables properly formatted?
+- Is the standalone property set correctly?
+- Are all dependencies declared?
+
+### 3. Step File Compliance
+
+Review each step file:
+
+- Does each step follow the template structure?
+- Are all mandatory rules included?
+- Is menu handling properly implemented?
+- Are frontmatter variables correct?
+- Are steps properly numbered?
+
+### 4. Cross-File Consistency
+
+Verify integration between files:
+
+- Do variable names match across all files?
+- Are path references consistent?
+- Is the step sequence logical?
+- Are there any broken references?
+
+### 5. Requirements Verification
+
+Confirm original requirements are met:
+
+- Does the workflow address the original problem?
+- Are all user types supported?
+- Are inputs and outputs as specified?
+- Is the interaction style as designed?
+
+### 6. Best Practices Adherence
+
+Check quality standards:
+
+- Are step files focused and reasonably sized (5-10KB typical)?
+- Is collaborative dialogue implemented?
+- Is error handling included?
+- Are naming conventions followed?
+
+### 7. Test Scenario Planning
+
+Prepare for testing:
+
+- What test data would be useful?
+- What scenarios should be tested?
+- How can the workflow be invoked?
+- What would indicate successful execution?
+
+### 8. Deployment Preparation
+
+Provide next steps:
+
+- Installation requirements
+- Invocation commands
+- Testing procedures
+- Documentation needs
+
+## REVIEW FINDINGS DOCUMENTATION:
+
+### Issues Found
+
+Document any issues discovered:
+
+- **Critical Issues**: Must fix before use
+- **Warnings**: Should fix for better experience
+- **Suggestions**: Nice to have improvements
+
+### Validation Results
+
+Record validation outcomes:
+
+- Configuration validation: PASSED/FAILED
+- Step compliance: PASSED/FAILED
+- Cross-file consistency: PASSED/FAILED
+- Requirements verification: PASSED/FAILED
+
+### Recommendations
+
+Provide specific recommendations:
+
+- Immediate actions needed
+- Future improvements
+- Training needs
+- Maintenance considerations
+
+## COMPLETION CHECKLIST:
+
+### Final Validations
+
+- [ ] All files generated successfully
+- [ ] No syntax errors in YAML
+- [ ] All paths are correct
+- [ ] Variables are consistent
+- [ ] Design requirements met
+- [ ] Best practices followed
+
+### User Acceptance
+
+- [ ] User has reviewed generated workflow
+- [ ] User approves of the implementation
+- [ ] User understands next steps
+- [ ] User satisfied with the result
+
+### Documentation
+
+- [ ] Build summary complete
+- [ ] Review findings documented
+- [ ] Next steps provided
+- [ ] Contact information for support
+
+## CONTENT TO APPEND TO PLAN:
+
+After completing review, append to {workflowPlanFile}:
+
+Load and append the content from {reviewTemplate}
+
+Then load and append the content from {completionTemplate}
+
+## FINAL MENU OPTIONS
+
+Display: **All Files Created Successfully!** [C] Complete & Get Validation Instructions
+
+#### EXECUTION RULES:
+
+- ALWAYS halt and wait for user input after presenting menu
+- Provide compliance check guidance for new context execution
+- After other menu items execution, return to this menu
+- User can chat or ask questions - always respond and then end with display again of the menu options
+- Use menu handling logic section below
+
+#### Menu Handling Logic:
+
+- IF C: Save content to {workflowPlanFile}, update frontmatter, then provide validation instructions for running in new context
+- IF Any other comments or queries: respond and redisplay menu
+
+## COMPLIANCE CHECK INSTRUCTIONS
+
+When user selects [C], provide these instructions:
+
+**🎯 Workflow Creation Complete! Your new workflow is ready at:**
+`{target_workflow_path}`
+
+**⚠️ IMPORTANT - Run Compliance Check in New Context:**
+To validate your workflow meets XIAOMA standards:
+
+1. **Start a new Claude conversation** (fresh context)
+2. **Use this command:** `/xiaoma:xmc:workflows:workflow-compliance-check`
+3. **Provide the path:** `{target_workflow_path}/workflow.md`
+4. **Follow the validation process** to identify and fix any violations
+
+**Why New Context?**
+
+- Compliance checking requires fresh analysis without workflow creation context
+- Ensures objective validation against template standards
+- Provides detailed violation reporting with specific fix recommendations
+
+**Your workflow will be checked for:**
+
+- Template compliance and structure
+- Step-by-step validation standards
+- File optimization and formatting
+- Meta-workflow best practices
+
+Ready to validate when you are! [Start new context and run compliance check]
+
+---
+
+## 🚨 SYSTEM SUCCESS/FAILURE METRICS
+
+### ✅ SUCCESS:
+
+- Generated workflow thoroughly reviewed
+- All validations performed
+- Issues documented with solutions
+- User approves final workflow
+- Complete documentation provided
+
+### ❌ SYSTEM FAILURE:
+
+- Skipping review steps
+- Not documenting findings
+- Ending without user approval
+- Not providing next steps
+
+**Master Rule:** Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.

package/src/modules/xmb/workflows/create-workflow/templates/build-summary.md

@@ -0,0 +1,36 @@
+## Build Summary
+
+### Files Generated
+
+{{#generatedFiles}}
+
+- **{{type}}**: {{path}}
+  {{/generatedFiles}}
+
+### Customizations Made
+
+{{#customizations}}
+
+- {{.}}
+  {{/customizations}}
+
+### Manual Steps Required
+
+{{#manualSteps}}
+
+- {{.}}
+  {{/manualSteps}}
+
+### Build Validation Results
+
+- **Syntax Check**: {{syntaxCheckResult}}
+- **Path Validation**: {{pathValidationResult}}
+- **Variable Consistency**: {{variableConsistencyResult}}
+- **Template Compliance**: {{templateComplianceResult}}
+
+### Next Steps for Testing
+
+1. Run `workflow {{targetModule}}/workflows/{{workflowName}}` to test
+2. Verify all steps execute properly
+3. Check output generation
+4. Validate user interaction points

package/src/modules/xmb/workflows/create-workflow/templates/completion-section.md

@@ -0,0 +1,39 @@
+## Workflow Creation Complete!
+
+### Final Deliverables
+
+✅ **Main Workflow**: {{targetWorkflowPath}}/workflow.md
+✅ **Step Files**: {{stepCount}} step files created
+✅ **Templates**: {{templateCount}} templates created
+✅ **Documentation**: Complete documentation provided
+
+### Deployment Instructions
+
+1. **Installation**: Run the XIAOMA Method installer to your project location
+2. **Compilation**: Select 'Compile Agents' after confirming the folder
+3. **Testing**: Use `workflow {{targetWorkflowPath}}` to test
+
+### Usage Guide
+
+```bash
+# To invoke the workflow (from custom location)
+workflow {{customWorkflowLocation}}/{{workflowName}}
+
+# Or if standalone is true
+/{{workflowCommand}}
+```
+
+### Support
+
+- Created by: {{user_name}}
+- Date: {{completionDate}}
+- Module: {{targetModule}}
+- Type: {{workflowType}}
+
+### Thank You!
+
+Thank you for using the Standalone Workflow Builder. Your workflow has been created following best practices for step-file architecture and collaborative design principles.
+
+---
+
+_Workflow creation completed successfully on {{completionDate}}_

package/src/modules/xmb/workflows/create-workflow/templates/content-template.md

@@ -0,0 +1,21 @@
+# {{documentTitle}}
+
+**Created:** {{date}}
+**Author:** {{user_name}}
+**Workflow:** {{workflowName}}
+
+## Executive Summary
+
+{{executiveSummary}}
+
+## Details
+
+{{mainContent}}
+
+## Conclusion
+
+{{conclusion}}
+
+---
+
+_Generated by the {{workflowName}} workflow_

package/src/modules/xmb/workflows/create-workflow/templates/design-section.md

@@ -0,0 +1,53 @@
+## Workflow Design
+
+### Step Structure
+
+**Total Steps**: {{totalSteps}}
+**Step Overview**:
+{{stepOverview}}
+
+### Detailed Step Plan
+
+{{stepDetails}}
+
+### Interaction Design
+
+- **Menu Pattern**: {{menuPattern}}
+- **User Input Points**: {{userInputPoints}}
+- **AI Autonomy Level**: {{aiAutonomyLevel}}
+- **Decision Flow**: {{decisionFlow}}
+
+### Data Flow Architecture
+
+- **Input Requirements**: {{dataInputRequirements}}
+- **Intermediate Variables**: {{intermediateVariables}}
+- **Output Mapping**: {{outputMapping}}
+- **State Management**: {{stateManagement}}
+
+### File Organization
+
+- **Core Files**: {{coreFiles}}
+- **Templates**: {{templates}}
+- **Data Files**: {{dataFiles}}
+- **Supporting Files**: {{supportingFiles}}
+
+### AI Role Definition
+
+- **Primary Role**: {{primaryRole}}
+- **Expertise Areas**: {{expertiseAreas}}
+- **Communication Style**: {{communicationStyle}}
+- **Collaboration Approach**: {{collaborationApproach}}
+
+### Quality Assurance
+
+- **Validation Points**: {{validationPoints}}
+- **Error Handling**: {{errorHandling}}
+- **Recovery Strategies**: {{recoveryStrategies}}
+- **Success Criteria**: {{designSuccessCriteria}}
+
+### Special Features
+
+- **Conditional Logic**: {{conditionalLogic}}
+- **Branch Points**: {{branchPoints}}
+- **Integrations**: {{designIntegrations}}
+- **Multi-Scenario Support**: {{multiScenarioSupport}}

package/src/modules/xmb/workflows/create-workflow/templates/project-info.md

@@ -0,0 +1,18 @@
+# Workflow Creation: {{workflow_name}}
+
+**Created:** {{date}}
+**Author:** {{user_name}}
+**Module:** {{targetModule}}
+**Type:** {{workflowType}}
+
+## Project Overview
+
+{{projectOverview}}
+
+## Requirements Collected
+
+{{requirementsCollected}}
+
+---
+
+_This document tracks the workflow creation process. The final workflow will be generated separately._