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

package/src/modules/cis/workflows/storytelling/workflow.yaml

@@ -0,0 +1,38 @@
+# Storytelling Workflow Configuration
+name: "storytelling"
+description: "Craft compelling narratives using proven story frameworks and techniques. This workflow guides users through structured narrative development, applying appropriate story frameworks to create emotionally resonant and engaging stories for any purpose."
+author: "XiaoMa"
+
+# Critical variables load from config_source
+config_source: "{project-root}/{xiaoma_folder}/cis/config.yaml"
+output_folder: "{config_source}:output_folder"
+user_name: "{config_source}:user_name"
+communication_language: "{config_source}:communication_language"
+date: system-generated
+
+# Context can be provided via data attribute when invoking
+# Example: data="{path}/brand-info.md" provides brand context
+
+# Module path and component files
+installed_path: "{project-root}/{xiaoma_folder}/cis/workflows/storytelling"
+template: "{installed_path}/template.md"
+instructions: "{installed_path}/instructions.md"
+
+# Required Data Files
+story_frameworks: "{installed_path}/story-types.csv"
+
+# Output configuration
+default_output_file: "{output_folder}/story-{{date}}.md"
+
+standalone: true
+
+web_bundle:
+  name: "storytelling"
+  description: "Craft compelling narratives using proven story frameworks and techniques. This workflow guides users through structured narrative development, applying appropriate story frameworks to create emotionally resonant and engaging stories for any purpose."
+  author: "XiaoMa"
+  instructions: "{xiaoma_folder}/cis/workflows/storytelling/instructions.md"
+  template: "{xiaoma_folder}/cis/workflows/storytelling/template.md"
+  web_bundle_files:
+    - "{xiaoma_folder}/cis/workflows/storytelling/instructions.md"
+    - "{xiaoma_folder}/cis/workflows/storytelling/template.md"
+    - "{xiaoma_folder}/cis/workflows/storytelling/story-types.csv"

package/src/modules/xmb/README.md

@@ -0,0 +1,261 @@
+# XMB - XiaoMa Builder Module
+
+Specialized tools and workflows for creating, customizing, and extending XiaoMa components including agents, workflows, and complete modules.
+
+## Table of Contents
+
+- [Module Structure](#module-structure)
+- [Documentation](#documentation)
+- [Reference Materials](#reference-materials)
+- [Core Workflows](#core-workflows)
+- [Agent Types](#agent-types)
+- [Quick Start](#quick-start)
+- [Best Practices](#best-practices)
+
+## Module Structure
+
+### 🤖 Agents
+
+**XiaoMa Builder** - Master builder agent orchestrating all creation workflows with deep knowledge of XiaoMa architecture and conventions.
+
+- Location: `.xiaoma/xmb/agents/xiaoma-builder.md`
+
+### 📋 Workflows
+
+**Active Workflows** (Step-File Architecture)
+
+- Location: `src/modules/xmb/workflows/`
+- 5 core workflows with 41 step files total
+- Template-based execution with JIT loading
+
+**Legacy Workflows** (Being Migrated)
+
+- Location: `src/modules/xmb/workflows-legacy/`
+- Module-specific workflows pending conversion to step-file architecture
+
+### 📚 Documentation
+
+- Location: `src/modules/xmb/docs/`
+- Comprehensive guides for agents and workflows
+- Architecture patterns and best practices
+
+### 🔍 Reference Materials
+
+- Location: `src/modules/xmb/reference/`
+- Working examples of agents and workflows
+- Template patterns and implementation guides
+
+## Documentation
+
+### 📖 Agent Documentation
+
+- **[Agent Index](docs/agents/index.md)** - Complete agent architecture guide
+- **[Agent Types Guide](docs/agents/understanding-agent-types.md)** - Simple vs Expert vs Module agents
+- **[Menu Patterns](docs/agents/agent-menu-patterns.md)** - YAML menu design and handler types
+- **[Agent Compilation](docs/agents/agent-compilation.md)** - Auto-injection rules and compilation process
+
+### 📋 Workflow Documentation
+
+- **[Workflow Index](docs/workflows/index.md)** - Core workflow system overview
+- **[Architecture Guide](docs/workflows/architecture.md)** - Step-file design and JIT loading
+- **[Template System](docs/workflows/step-template.md)** - Standard step file template
+- **[Intent vs Prescriptive](docs/workflows/intent-vs-prescriptive-spectrum.md)** - Design philosophy
+
+## Reference Materials
+
+### 🤖 Agent Examples
+
+- **[Simple Agent Example](reference/agents/simple-examples/commit-poet.agent.yaml)** - Self-contained agent
+- **[Expert Agent Example](./reference/agents/expert-examples/journal-keeper/)** - Agent with persistent memory
+- **[Module Agent Examples](./reference/agents/module-examples/)** - Integration patterns (XMC, CIS)
+
+### 📋 Workflow Examples
+
+- **[Meal Prep & Nutrition](./reference/workflows/meal-prep-nutrition/)** - Complete step-file workflow demonstration
+- **Template patterns** for document generation and state management
+
+## Core Workflows
+
+### Creation Workflows (Step-File Architecture)
+
+**[create-agent](./workflows/create-agent/)** - Build XiaoMa agents
+
+- 11 guided steps from brainstorming to celebration
+- 18 reference data files with validation checklists
+- Template-based agent generation
+
+**[create-workflow](./workflows/create-workflow/)** - Design workflows
+
+- 12 structured steps from init to review
+- 9 template files for workflow creation
+- Step-file architecture implementation
+
+### Editing Workflows
+
+**[edit-agent](./workflows/edit-agent/)** - Modify existing agents
+
+- 5 steps: discovery → validation
+- Intent-driven analysis and updates
+- Best practice compliance
+
+**[edit-workflow](./workflows/edit-workflow/)** - Update workflows
+
+- 5 steps: analyze → compliance check
+- Structure maintenance and validation
+- Template updates for consistency
+
+### Quality Assurance
+
+**[workflow-compliance-check](./workflows/workflow-compliance-check/)** - Validation
+
+- 8 systematic validation steps
+- Adversarial analysis approach
+- Detailed compliance reporting
+
+### Legacy Migration (Pending)
+
+Workflows in `workflows-legacy/` are being migrated to step-file architecture:
+
+- Module-specific workflows
+- Historical implementations
+- Conversion planning in progress
+
+## Agent Types
+
+XMB creates three agent architectures:
+
+### Simple Agent
+
+- **Self-contained**: All logic in single YAML file
+- **Stateless**: No persistent memory across sessions
+- **Purpose**: Single utilities and specialized tools
+- **Example**: Commit poet, code formatter
+
+### Expert Agent
+
+- **Persistent Memory**: Maintains knowledge across sessions
+- **Sidecar Resources**: External files and data storage
+- **Domain-specific**: Focuses on particular knowledge areas
+- **Example**: Journal keeper, domain consultant
+
+### Module Agent
+
+- **Team Integration**: Orchestrates within specific modules
+- **Workflow Coordination**: Manages complex processes
+- **Professional Infrastructure**: Enterprise-grade capabilities
+- **Examples**: XMC project manager, CIS innovation strategist
+
+## Quick Start
+
+### Using XiaoMa Builder Agent
+
+1. **Load XiaoMa Builder agent** in your IDE:
+   ```
+   /xiaoma:xmb:agents:xiaoma-builder
+   ```
+2. **Choose creation type:**
+   - `[CA]` Create Agent - Build new agents
+   - `[CW]` Create Workflow - Design workflows
+   - `[EA]` Edit Agent - Modify existing agents
+   - `[EW]` Edit Workflow - Update workflows
+   - `[VA]` Validate Agent - Quality check agents
+   - `[VW]` Validate Workflow - Quality check workflows
+
+3. **Follow interactive prompts** for step-by-step guidance
+
+### Example: Creating an Agent
+
+```
+User: I need a code review agent
+Builder: [CA] Create Agent
+
+[11-step guided process]
+Step 1: Brainstorm agent concept
+Step 2: Define persona and role
+Step 3: Design command structure
+...
+Step 11: Celebrate and deploy
+```
+
+### Direct Workflow Execution
+
+Workflows can also be run directly without the agent interface:
+
+```yaml
+# Execute specific workflow steps
+workflow: ./workflows/create-agent/workflow.yaml
+```
+
+## Use Cases
+
+### Custom Development Teams
+
+Build specialized agents for:
+
+- Domain expertise (legal, medical, finance)
+- Company processes
+- Tool integrations
+- Automation tasks
+
+### Workflow Extensions
+
+Create workflows for:
+
+- Compliance requirements
+- Quality gates
+- Deployment pipelines
+- Custom methodologies
+
+### Complete Solutions
+
+Package modules for:
+
+- Industry verticals
+- Technology stacks
+- Business processes
+- Educational frameworks
+
+## Architecture Principles
+
+### Step-File Workflow Design
+
+- **Micro-file Approach**: Each step is self-contained
+- **Just-In-Time Loading**: Only current step in memory
+- **Sequential Enforcement**: No skipping steps allowed
+- **State Tracking**: Progress documented in frontmatter
+- **Append-Only Building**: Documents grow through execution
+
+### Intent vs Prescriptive Spectrum
+
+- **Creative Workflows**: High user agency, AI as facilitator
+- **Structured Workflows**: Clear process, AI as guide
+- **Prescriptive Workflows**: Strict compliance, AI as validator
+
+## Best Practices
+
+1. **Study Reference Materials** - Review docs/ and reference/ examples
+2. **Choose Right Agent Type** - Simple vs Expert vs Module based on needs
+3. **Follow Step-File Patterns** - Use established templates and structures
+4. **Document Thoroughly** - Clear instructions and frontmatter metadata
+5. **Validate Continuously** - Use compliance workflows for quality
+6. **Maintain Consistency** - Follow YAML patterns and naming conventions
+
+## Integration
+
+XMB components integrate with:
+
+- **XiaoMa Core** - Framework foundation and agent compilation
+- **XMC** - Development workflows and project management
+- **CIS** - Creative innovation and strategic workflows
+- **Custom Modules** - Domain-specific solutions
+
+## Getting Help
+
+- **Documentation**: Check `docs/` for comprehensive guides
+- **Reference Materials**: See `reference/` for working examples
+- **Validation**: Use `workflow-compliance-check` for quality assurance
+- **Templates**: Leverage workflow templates for consistent patterns
+
+---
+
+XMB provides a complete toolkit for extending XiaoMa Method with disciplined, systematic approaches to agent and workflow development while maintaining framework consistency and power.

package/src/modules/xmb/_module-installer/install-config.yaml

@@ -0,0 +1,28 @@
+# XIAOMA™ Method Core Configuration
+
+code: xmb
+name: "XMB: XiaoMa Builder - Agent, Workflow and Module Builder"
+default_selected: false # This module will not be selected by default for new installations
+
+header: "XiaoMa Optimized Builder (BoMB) Module Configuration"
+subheader: "Configure the settings for the BoMB Factory!\nThe agent, workflow and module builder for XIAOMA™"
+
+# Variables from Core Config inserted:
+## user_name
+## communication_language
+## output_folder
+## xiaoma_folder
+## install_user_docs
+## kb_install
+
+custom_agent_location:
+  default: ".xiaoma/custom/src/agents"
+  result: "{project-root}/{value}"
+
+custom_workflow_location:
+  default: ".xiaoma/custom/src/workflows"
+  result: "{project-root}/{value}"
+
+custom_module_location:
+  default: ".xiaoma/custom/src/modules"
+  result: "{project-root}/{value}"

package/src/modules/xmb/agents/xiaoma-builder.agent.yaml

@@ -0,0 +1,71 @@
+# XiaoMa Builder Agent Definition
+# Master XiaoMa Module Agent Team and Workflow Builder and Maintainer
+
+agent:
+  webskip: true
+  metadata:
+    id: "{xiaoma_folder}/xmb/agents/xiaoma-builder.md"
+    name: XiaoMa Builder
+    title: XiaoMa Builder
+    icon: 🧙
+    module: xmb
+
+  persona:
+    role: Generalist Builder and XIAOMA System Maintainer
+    identity: A hands-on builder who gets things done efficiently and maintains the entire XIAOMA ecosystem
+    communication_style: Direct, action-oriented, and encouraging with a can-do attitude
+    principles:
+      - Execute resources directly without hesitation
+      - Load resources at runtime never pre-load
+      - Always present numbered lists for clear choices
+      - Focus on practical implementation and results
+      - Maintain system-wide coherence and standards
+      - Balance speed with quality and compliance
+
+  discussion: true
+  conversational_knowledge:
+    - agents: "{project-root}/{xiaoma_folder}/xmb/docs/agents/kb.csv"
+    - workflows: "{project-root}/{xiaoma_folder}/xmb/docs/workflows/kb.csv"
+    - modules: "{project-root}/{xiaoma_folder}/xmb/docs/modules/kb.csv"
+
+  menu:
+    - multi: "[CA] Create, [EA] Edit, or [VA] Validate XIAOMA agents with best practices"
+      triggers:
+        - create-agent:
+            - input: CA or fuzzy match create agent
+            - route: "{project-root}/{xiaoma_folder}/xmb/workflows/create-agent/workflow.md"
+            - data: null
+        - edit-agent:
+            - input: EA or fuzzy match edit agent
+            - route: "{project-root}/{xiaoma_folder}/xmb/workflows/edit-agent/workflow.md"
+            - data: null
+        - run-agent-compliance-check:
+            - input: VA or fuzzy match validate agent
+            - route: "{project-root}/{xiaoma_folder}/xmb/workflows/agent-compliance-check/workflow.md"
+            - data: null
+
+    - multi: "[CW] Create, [EW] Edit, or [VW] Validate XIAOMA workflows with best practices"
+      triggers:
+        - create-workflow:
+            - input: CW or fuzzy match create workflow
+            - route: "{project-root}/{xiaoma_folder}/xmb/workflows/create-workflow/workflow.md"
+            - data: null
+            - type: exec
+        - edit-workflow:
+            - input: EW or fuzzy match edit workflow
+            - route: "{project-root}/{xiaoma_folder}/xmb/workflows/edit-workflow/workflow.md"
+            - data: null
+            - type: exec
+        - run-workflow-compliance-check:
+            - input: VW or fuzzy match validate workflow
+            - route: "{project-root}/{xiaoma_folder}/xmb/workflows/workflow-compliance-check/workflow.md"
+            - data: null
+            - type: exec
+
+    - trigger: create-module
+      workflow: "{project-root}/{xiaoma_folder}/xmb/workflows/create-module/workflow.yaml"
+      description: Create a complete XIAOMA compatible module (custom agents and workflows)
+
+    - trigger: edit-module
+      workflow: "{project-root}/{xiaoma_folder}/xmb/workflows/edit-module/workflow.yaml"
+      description: Edit existing modules (structure, agents, workflows, documentation)