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

package/src/modules/xmc/workflows/testarch/trace/workflow.yaml

@@ -0,0 +1,57 @@
+# Test Architect workflow: trace (enhanced with gate decision)
+name: testarch-trace
+description: "Generate requirements-to-tests traceability matrix, analyze coverage, and make quality gate decision (PASS/CONCERNS/FAIL/WAIVED)"
+author: "XiaoMa"
+
+# Critical variables from config
+config_source: "{project-root}/{xiaoma_folder}/xmc/config.yaml"
+output_folder: "{config_source}:output_folder"
+user_name: "{config_source}:user_name"
+communication_language: "{config_source}:communication_language"
+document_output_language: "{config_source}:document_output_language"
+date: system-generated
+
+# Workflow components
+installed_path: "{project-root}/{xiaoma_folder}/xmc/workflows/testarch/trace"
+instructions: "{installed_path}/instructions.md"
+validation: "{installed_path}/checklist.md"
+template: "{installed_path}/trace-template.md"
+
+# Variables and inputs
+variables:
+  # Directory paths
+  test_dir: "{project-root}/tests" # Root test directory
+  source_dir: "{project-root}/src" # Source code directory
+
+  # Workflow behavior
+  coverage_levels: "e2e,api,component,unit" # Which test levels to trace
+  gate_type: "story" # story | epic | release | hotfix - determines gate scope
+  decision_mode: "deterministic" # deterministic (rule-based) | manual (team decision)
+
+# Output configuration
+default_output_file: "{output_folder}/traceability-matrix.md"
+
+# Required tools
+required_tools:
+  - read_file # Read story, test files, XiaoMa artifacts
+  - write_file # Create traceability matrix, gate YAML
+  - list_files # Discover test files
+  - search_repo # Find tests by test ID, describe blocks
+  - glob # Find test files matching patterns
+
+tags:
+  - qa
+  - traceability
+  - test-architect
+  - coverage
+  - requirements
+  - gate
+  - decision
+  - release
+
+execution_hints:
+  interactive: false # Minimize prompts
+  autonomous: true # Proceed without user input unless blocked
+  iterative: true
+
+web_bundle: false

package/src/modules/xmc/workflows/workflow-status/init/instructions.md

@@ -0,0 +1,331 @@
+# Workflow Init - Project Setup Instructions
+
+<critical>The workflow execution engine is governed by: {project-root}/{xiaoma_folder}/core/tasks/workflow.xml</critical>
+<critical>You MUST have already loaded and processed: workflow-init/workflow.yaml</critical>
+<critical>Communicate in {communication_language} with {user_name}</critical>
+<critical>This workflow handles BOTH new projects AND legacy projects following the XiaoMa Method</critical>
+
+<workflow>
+
+<step n="1" goal="Scan for existing work">
+<output>Welcome to XiaoMa Method, {user_name}!</output>
+
+<action>Perform comprehensive scan for existing work:
+
+- XMC artifacts: PRD, epics, architecture, UX, brief, research, brainstorm
+- Implementation: stories, sprint-status, workflow-status
+- Codebase: source directories, package files, git repo
+- Check both {output_folder} and {sprint_artifacts} locations
+  </action>
+
+<action>Categorize into one of these states:
+
+- CLEAN: No artifacts or code (or scaffold only)
+- PLANNING: Has PRD/spec but no implementation
+- ACTIVE: Has stories or sprint status
+- LEGACY: Has code but no XMC artifacts
+- UNCLEAR: Mixed state needs clarification
+  </action>
+
+<ask>What's your project called? {{#if project_name}}(Config shows: {{project_name}}){{/if}}</ask>
+<action>Store project_name</action>
+<template-output>project_name</template-output>
+</step>
+
+<step n="2" goal="Choose setup path">
+<check if="state == CLEAN">
+  <output>Perfect! Fresh start detected.</output>
+  <action>Continue to step 3</action>
+</check>
+
+<check if="state == ACTIVE AND workflow_status exists">
+  <output>✅ You already have workflow tracking at: {{workflow_status_path}}
+
+To check progress: Load any XMC agent and run /xiaoma:xmc:workflows:workflow-status
+
+Happy building! 🚀</output>
+<action>Exit workflow (already initialized)</action>
+</check>
+
+<check if="state != CLEAN">
+  <output>Found existing work:
+{{summary_of_findings}}</output>
+
+<ask>How would you like to proceed?
+
+1. **Continue** - Work with existing artifacts
+2. **Archive & Start Fresh** - Move old work to archive
+3. **Express Setup** - I know exactly what I need
+4. **Guided Setup** - Walk me through options
+
+Choice [1-4]</ask>
+
+  <check if="choice == 1">
+    <action>Set continuing_existing = true</action>
+    <action>Store found artifacts</action>
+    <action>Continue to step 7 (detect track from artifacts)</action>
+  </check>
+
+  <check if="choice == 2">
+    <ask>Archive existing work? (y/n)</ask>
+    <action if="y">Move artifacts to {output_folder}/archive/</action>
+    <output>Ready for fresh start!</output>
+    <action>Continue to step 3</action>
+  </check>
+
+  <check if="choice == 3">
+    <action>Jump to step 3 (express path)</action>
+  </check>
+
+  <check if="choice == 4">
+    <action>Continue to step 4 (guided path)</action>
+  </check>
+</check>
+
+<check if="state == CLEAN">
+  <ask>Setup approach:
+
+1. **Express** - I know what I need
+2. **Guided** - Show me the options
+
+Choice [1 or 2]:</ask>
+
+  <check if="choice == 1">
+    <action>Continue to step 3 (express)</action>
+  </check>
+
+  <check if="choice == 2">
+    <action>Continue to step 4 (guided)</action>
+  </check>
+</check>
+</step>
+
+<step n="3" goal="Express setup path">
+<ask>Is this for:
+1. **New project** (greenfield)
+2. **Existing codebase** (brownfield)
+
+Choice [1/2]:</ask>
+<action>Set field_type based on choice</action>
+
+<ask>Planning approach:
+
+1. **XiaoMa Method** - Full planning for complex projects
+2. **Enterprise Method** - Extended planning with security/DevOps
+
+Choice [1/2]:</ask>
+<action>Map to selected_track: method/enterprise</action>
+
+<output>🚀 **For Quick Flow (minimal planning, straight to code):**
+Load the **quick-flow-solo-dev** agent instead - use Quick Flow agent for faster development</output>
+
+<template-output>field_type</template-output>
+<template-output>selected_track</template-output>
+<action>Jump to step 6 (discovery options)</action>
+</step>
+
+<step n="4" goal="Guided setup - understand project">
+<ask>Tell me about what you're working on. What's the goal?</ask>
+<action>Store user_description</action>
+
+<action>Analyze for field type indicators:
+
+- Brownfield: "existing", "current", "enhance", "modify"
+- Greenfield: "new", "build", "create", "from scratch"
+- If codebase exists, default to brownfield unless user indicates scaffold
+  </action>
+
+<check if="field_type unclear AND codebase exists">
+  <ask>I see existing code. Are you:
+1. **Modifying** existing codebase (brownfield)
+2. **Starting fresh** - code is just scaffold (greenfield)
+
+Choice [1/2]:</ask>
+<action>Set field_type based on answer</action>
+</check>
+
+<action if="field_type not set">Set based on codebase presence</action>
+
+<template-output>user_description</template-output>
+<template-output>field_type</template-output>
+<action>Continue to step 5</action>
+</step>
+
+<step n="5" goal="Guided setup - select track">
+<output>Based on your project, here are your XiaoMa Method planning options:
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+**1. XiaoMa Method** 🎯 {{#if recommended}}(RECOMMENDED){{/if}}
+
+- Full planning: PRD + UX + Architecture
+- Best for: Products, platforms, complex features
+- Benefit: AI agents have complete context for better results
+
+**2. Enterprise Method** 🏢
+
+- Extended: Method + Security + DevOps + Testing
+- Best for: Enterprise, compliance, mission-critical
+- Benefit: Comprehensive planning for complex systems
+
+**🚀 For Quick Flow (minimal planning, straight to code):**
+Load the **quick-flow-solo-dev** agent instead - use Quick Flow agent for faster development
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+{{#if brownfield}}
+💡 Architecture creates focused solution design from your codebase, keeping AI agents on track.
+{{/if}}</output>
+
+<ask>Which XiaoMa Method approach fits best?
+
+1. XiaoMa Method {{#if recommended}}(recommended){{/if}}
+2. Enterprise Method
+3. Help me decide
+4. Switch to Quick Flow (use quick-flow-solo-dev agent)
+
+Choice [1/2/3/4]:</ask>
+
+<check if="choice == 4">
+  <output>🚀 **Switching to Quick Flow!**
+
+Load the **quick-flow-solo-dev** agent instead:
+
+- Start a new chat
+- Load the quick-flow-solo-dev agent
+- Use Quick Flow for minimal planning and faster development
+
+Quick Flow is perfect for:
+
+- Simple features and bug fixes
+- Rapid prototyping
+- When you want to get straight to code
+
+Happy coding! 🚀</output>
+<action>Exit workflow</action>
+</check>
+
+<check if="choice == 3">
+  <ask>What concerns you about choosing?</ask>
+  <action>Provide tailored guidance based on concerns</action>
+  <action>Loop back to choice</action>
+</check>
+
+<action>Map choice to selected_track</action>
+<template-output>selected_track</template-output>
+</step>
+
+<step n="6" goal="Discovery workflows selection (unified)">
+<action>Determine available discovery workflows based on:
+- field_type (greenfield gets product-brief option)
+- selected_track (method/enterprise options)
+</action>
+
+<check if="field_type == greenfield AND selected_track in [method, enterprise]">
+  <output>Optional discovery workflows can help clarify your vision:</output>
+  <ask>Select any you'd like to include:
+
+1. 🧠 **Brainstorm** - Creative exploration and ideation
+2. 🔍 **Research** - Technical/competitive analysis
+3. 📋 **Product Brief** - Strategic product planning (recommended)
+
+Enter numbers (e.g., "1,3" or "all" or "none"): </ask>
+</check>
+
+<check if="field_type == brownfield AND selected_track in [method, enterprise]">
+  <output>Optional discovery workflows:</output>
+  <ask>Include any of these?
+
+1. 🧠 **Brainstorm** - Creative exploration
+2. 🔍 **Research** - Domain analysis
+
+Enter numbers (e.g., "1,2" or "none"): </ask>
+</check>
+
+<action>Parse selections and set:
+
+- brainstorm_requested
+- research_requested
+- product_brief_requested (if applicable)
+  </action>
+
+<template-output>brainstorm_requested</template-output>
+<template-output>research_requested</template-output>
+<template-output>product_brief_requested</template-output>
+
+<check if="brownfield">
+  <output>💡 **Note:** For brownfield projects, run document-project workflow first to analyze your codebase.</output>
+</check>
+</step>
+
+<step n="7" goal="Detect track from artifacts" if="continuing_existing OR migrating_legacy">
+<action>Analyze artifacts to detect track:
+- Has PRD → XiaoMa Method
+- Has Security/DevOps → Enterprise Method
+- Has tech-spec only → Suggest switching to quick-flow-solo-dev agent
+</action>
+
+<output>Detected: **{{detected_track}}** based on {{found_artifacts}}</output>
+<ask>Correct? (y/n)</ask>
+
+<ask if="n">Which XiaoMa Method track instead?
+
+1. XiaoMa Method
+2. Enterprise Method
+3. Switch to Quick Flow (use quick-flow-solo-dev agent)
+
+Choice:</ask>
+
+<action>Set selected_track</action>
+<template-output>selected_track</template-output>
+</step>
+
+<step n="8" goal="Generate workflow path">
+<action>Load path file: {path_files}/{{selected_track}}-{{field_type}}.yaml</action>
+<action>Build workflow_items from path file</action>
+<action>Scan for existing completed work and update statuses</action>
+<action>Set generated date</action>
+
+<template-output>generated</template-output>
+<template-output>workflow_path_file</template-output>
+<template-output>workflow_items</template-output>
+</step>
+
+<step n="9" goal="Create tracking file">
+<output>Your XiaoMa workflow path:
+
+**Track:** {{selected_track}}
+**Type:** {{field_type}}
+**Project:** {{project_name}}
+
+{{#if brownfield}}Prerequisites: document-project{{/if}}
+{{#if has_discovery}}Discovery: {{list_selected_discovery}}{{/if}}
+
+{{workflow_path_summary}}
+</output>
+
+<ask>Create workflow tracking file? (y/n)</ask>
+
+<check if="y">
+  <action>Generate YAML from template with all variables</action>
+  <action>Save to {output_folder}/xmc-workflow-status.yaml</action>
+  <action>Identify next workflow and agent</action>
+
+<output>✅ **Created:** {output_folder}/xmc-workflow-status.yaml
+
+**Next:** {{next_workflow_name}}
+**Agent:** {{next_agent}}
+**Command:** /xiaoma:xmc:workflows:{{next_workflow_id}}
+
+{{#if next_agent not in [analyst, pm]}}
+💡 Start new chat with **{{next_agent}}** agent first.
+{{/if}}
+
+To check progress: /xiaoma:xmc:workflows:workflow-status
+
+Happy building! 🚀</output>
+</check>
+
+</step>
+
+</workflow>

package/src/modules/xmc/workflows/workflow-status/init/workflow.yaml

@@ -0,0 +1,29 @@
+# Workflow Init - Initial Project Setup
+name: workflow-init
+description: "Initialize a new XMC project by determining level, type, and creating workflow path"
+author: "XiaoMa"
+
+# Critical variables from config
+config_source: "{project-root}/{xiaoma_folder}/xmc/config.yaml"
+output_folder: "{config_source}:output_folder"
+sprint_artifacts: "{config_source}:sprint_artifacts"
+user_name: "{config_source}:user_name"
+project_name: "{config_source}:project_name"
+communication_language: "{config_source}:communication_language"
+document_output_language: "{config_source}:document_output_language"
+user_skill_level: "{config_source}:user_skill_level"
+date: system-generated
+
+# Workflow components
+installed_path: "{project-root}/{xiaoma_folder}/xmc/workflows/workflow-status/init"
+instructions: "{installed_path}/instructions.md"
+template: "{project-root}/{xiaoma_folder}/xmc/workflows/workflow-status/workflow-status-template.yaml"
+
+# Path data files
+path_files: "{project-root}/{xiaoma_folder}/xmc/workflows/workflow-status/paths/"
+
+# Output configuration
+default_output_file: "{output_folder}/xmc-workflow-status.yaml"
+
+standalone: true
+web_bundle: false