@zeyue0329/xiaoma-cli 1.6.4 → 1.7.0

package/tools/validate-file-refs.js

@@ -1,556 +0,0 @@
-/**
- * File Reference Validator
- *
- * Validates cross-file references in XiaoMa source files (agents, workflows, tasks, steps).
- * Catches broken file paths, missing referenced files, and absolute path leaks.
- *
- * What it checks:
- * - {project-root}/_xiaoma/ references in YAML and markdown resolve to real src/ files
- * - Relative path references (./file.md, ../data/file.csv) point to existing files
- * - exec="..." and <invoke-task> targets exist
- * - Step metadata (thisStepFile, nextStepFile) references are valid
- * - Load directives (Load: `./file.md`) target existing files
- * - No absolute paths (/Users/, /home/, C:\) leak into source files
- *
- * What it does NOT check (deferred):
- * - {installed_path} variable interpolation (self-referential, low risk)
- * - {{mustache}} template variables (runtime substitution)
- * - {config_source}:key dynamic YAML dereferences
- *
- * Usage:
- *   node tools/validate-file-refs.js            # Warn on broken references (exit 0)
- *   node tools/validate-file-refs.js --strict    # Fail on broken references (exit 1)
- *   node tools/validate-file-refs.js --verbose   # Show all checked references
- *
- * Default mode is warning-only (exit 0) so adoption is non-disruptive.
- * Use --strict when you want CI or pre-commit to enforce valid references.
- */
-
-const fs = require('node:fs');
-const path = require('node:path');
-const yaml = require('yaml');
-const { parse: parseCsv } = require('csv-parse/sync');
-
-const PROJECT_ROOT = path.resolve(__dirname, '..');
-const SRC_DIR = path.join(PROJECT_ROOT, 'src');
-const VERBOSE = process.argv.includes('--verbose');
-const STRICT = process.argv.includes('--strict');
-
-// --- Constants ---
-
-// File extensions to scan
-const SCAN_EXTENSIONS = new Set(['.yaml', '.yml', '.md', '.xml', '.csv']);
-
-// Skip directories
-const SKIP_DIRS = new Set(['node_modules', '.git']);
-
-// Pattern: {project-root}/_xiaoma/ references
-const PROJECT_ROOT_REF = /\{project-root\}\/_xiaoma\/([^\s'"<>})\]`]+)/g;
-
-// Pattern: {_xiaoma}/ shorthand references
-const XiaoMa_SHORTHAND_REF = /\{_xiaoma\}\/([^\s'"<>})\]`]+)/g;
-
-// Pattern: exec="..." attributes
-const EXEC_ATTR = /exec="([^"]+)"/g;
-
-// Pattern: <invoke-task> content
-const INVOKE_TASK = /<invoke-task>([^<]+)<\/invoke-task>/g;
-
-// Pattern: relative paths in quotes
-const RELATIVE_PATH_QUOTED = /['"](\.\.\/?[^'"]+\.(?:md|yaml|yml|xml|json|csv|txt))['"]/g;
-const RELATIVE_PATH_DOT = /['"](\.\/[^'"]+\.(?:md|yaml|yml|xml|json|csv|txt))['"]/g;
-
-// Pattern: step metadata
-const STEP_META = /(?:thisStepFile|nextStepFile|continueStepFile|skipToStepFile|altStepFile|workflowFile):\s*['"](\.[^'"]+)['"]/g;
-
-// Pattern: Load directives
-const LOAD_DIRECTIVE = /Load[:\s]+`(\.[^`]+)`/g;
-
-// Pattern: absolute path leaks
-const ABS_PATH_LEAK = /(?:\/Users\/|\/home\/|[A-Z]:\\\\)/;
-
-// --- Output Escaping ---
-
-function escapeAnnotation(str) {
-  return str.replaceAll('%', '%25').replaceAll('\r', '%0D').replaceAll('\n', '%0A');
-}
-
-function escapeTableCell(str) {
-  return String(str).replaceAll('|', String.raw`\|`);
-}
-
-// Path prefixes/patterns that only exist in installed structure, not in source
-const INSTALL_ONLY_PATHS = ['_config/'];
-
-// Files that are generated at install time and don't exist in the source tree
-const INSTALL_GENERATED_FILES = ['config.yaml'];
-
-// Variables that indicate a path is not statically resolvable
-const UNRESOLVABLE_VARS = [
-  '{output_folder}',
-  '{value}',
-  '{timestamp}',
-  '{config_source}:',
-  '{installed_path}',
-  '{shared_path}',
-  '{planning_artifacts}',
-  '{research_topic}',
-  '{user_name}',
-  '{communication_language}',
-  '{epic_number}',
-  '{next_epic_num}',
-  '{epic_num}',
-  '{part_id}',
-  '{count}',
-  '{date}',
-  '{outputFile}',
-  '{nextStepFile}',
-];
-
-// --- File Discovery ---
-
-function getSourceFiles(dir) {
-  const files = [];
-
-  function walk(currentDir) {
-    const entries = fs.readdirSync(currentDir, { withFileTypes: true });
-
-    for (const entry of entries) {
-      if (SKIP_DIRS.has(entry.name)) continue;
-
-      const fullPath = path.join(currentDir, entry.name);
-
-      if (entry.isDirectory()) {
-        walk(fullPath);
-      } else if (entry.isFile() && SCAN_EXTENSIONS.has(path.extname(entry.name))) {
-        files.push(fullPath);
-      }
-    }
-  }
-
-  walk(dir);
-  return files;
-}
-
-// --- Code Block Stripping ---
-
-function stripCodeBlocks(content) {
-  return content.replaceAll(/```[\s\S]*?```/g, (m) => m.replaceAll(/[^\n]/g, ''));
-}
-
-function stripJsonExampleBlocks(content) {
-  // Strip bare JSON example blocks: { and } each on their own line.
-  // These are example/template data (not real file references).
-  return content.replaceAll(/^\{\s*\n(?:.*\n)*?^\}\s*$/gm, (m) => m.replaceAll(/[^\n]/g, ''));
-}
-
-// --- Path Mapping ---
-
-function mapInstalledToSource(refPath) {
-  // Strip {project-root}/_xiaoma/ or {_xiaoma}/ prefix
-  let cleaned = refPath.replace(/^\{project-root\}\/_xiaoma\//, '').replace(/^\{_xiaoma\}\//, '');
-
-  // Also handle bare _xiaoma/ prefix (seen in some invoke-task)
-  cleaned = cleaned.replace(/^_xiaoma\//, '');
-
-  // Skip install-only paths (generated at install time, not in source)
-  if (isInstallOnly(cleaned)) return null;
-
-  // core/, xmc/, and utility/ are directly under src/
-  if (cleaned.startsWith('core/') || cleaned.startsWith('xmc/') || cleaned.startsWith('utility/')) {
-    return path.join(SRC_DIR, cleaned);
-  }
-
-  // Fallback: map directly under src/
-  return path.join(SRC_DIR, cleaned);
-}
-
-// --- Reference Extraction ---
-
-function isResolvable(refStr) {
-  // Skip refs containing unresolvable runtime variables
-  if (refStr.includes('{{')) return false;
-  for (const v of UNRESOLVABLE_VARS) {
-    if (refStr.includes(v)) return false;
-  }
-  return true;
-}
-
-function isInstallOnly(cleanedPath) {
-  // Skip paths that only exist in the installed _xiaoma/ structure, not in src/
-  for (const prefix of INSTALL_ONLY_PATHS) {
-    if (cleanedPath.startsWith(prefix)) return true;
-  }
-  // Skip files that are generated during installation
-  const basename = path.basename(cleanedPath);
-  for (const generated of INSTALL_GENERATED_FILES) {
-    if (basename === generated) return true;
-  }
-  return false;
-}
-
-function extractYamlRefs(filePath, content) {
-  const refs = [];
-
-  let doc;
-  try {
-    doc = yaml.parseDocument(content);
-  } catch {
-    return refs; // Skip unparseable YAML (schema validator handles this)
-  }
-
-  function checkValue(value, range, keyPath) {
-    if (typeof value !== 'string') return;
-    if (!isResolvable(value)) return;
-
-    const line = range ? offsetToLine(content, range[0]) : undefined;
-
-    // Check for {project-root}/_xiaoma/ refs
-    const prMatch = value.match(/\{project-root\}\/_xiaoma\/[^\s'"<>})\]`]+/);
-    if (prMatch) {
-      refs.push({ file: filePath, raw: prMatch[0], type: 'project-root', line, key: keyPath });
-    }
-
-    // Check for {_xiaoma}/ refs
-    const bmMatch = value.match(/\{_xiaoma\}\/[^\s'"<>})\]`]+/);
-    if (bmMatch) {
-      refs.push({ file: filePath, raw: bmMatch[0], type: 'project-root', line, key: keyPath });
-    }
-
-    // Check for relative paths
-    const relMatch = value.match(/^\.\.?\/[^\s'"<>})\]`]+\.(?:md|yaml|yml|xml|json|csv|txt)$/);
-    if (relMatch) {
-      refs.push({ file: filePath, raw: relMatch[0], type: 'relative', line, key: keyPath });
-    }
-  }
-
-  function walkNode(node, keyPath) {
-    if (!node) return;
-
-    if (yaml.isMap(node)) {
-      for (const item of node.items) {
-        const key = item.key && item.key.value !== undefined ? item.key.value : '?';
-        const childPath = keyPath ? `${keyPath}.${key}` : String(key);
-        walkNode(item.value, childPath);
-      }
-    } else if (yaml.isSeq(node)) {
-      for (const [i, item] of node.items.entries()) {
-        walkNode(item, `${keyPath}[${i}]`);
-      }
-    } else if (yaml.isScalar(node)) {
-      checkValue(node.value, node.range, keyPath);
-    }
-  }
-
-  walkNode(doc.contents, '');
-  return refs;
-}
-
-function offsetToLine(content, offset) {
-  let line = 1;
-  for (let i = 0; i < offset && i < content.length; i++) {
-    if (content[i] === '\n') line++;
-  }
-  return line;
-}
-
-function extractMarkdownRefs(filePath, content) {
-  const refs = [];
-  const stripped = stripJsonExampleBlocks(stripCodeBlocks(content));
-
-  function runPattern(regex, type) {
-    regex.lastIndex = 0;
-    let match;
-    while ((match = regex.exec(stripped)) !== null) {
-      const raw = match[1];
-      if (!isResolvable(raw)) continue;
-      refs.push({ file: filePath, raw, type, line: offsetToLine(stripped, match.index) });
-    }
-  }
-
-  // {project-root}/_xiaoma/ refs
-  runPattern(PROJECT_ROOT_REF, 'project-root');
-
-  // {_xiaoma}/ shorthand
-  runPattern(XiaoMa_SHORTHAND_REF, 'project-root');
-
-  // exec="..." attributes
-  runPattern(EXEC_ATTR, 'exec-attr');
-
-  // <invoke-task> tags
-  runPattern(INVOKE_TASK, 'invoke-task');
-
-  // Step metadata
-  runPattern(STEP_META, 'relative');
-
-  // Load directives
-  runPattern(LOAD_DIRECTIVE, 'relative');
-
-  // Relative paths in quotes
-  runPattern(RELATIVE_PATH_QUOTED, 'relative');
-  runPattern(RELATIVE_PATH_DOT, 'relative');
-
-  return refs;
-}
-
-function extractCsvRefs(filePath, content) {
-  const refs = [];
-
-  let records;
-  try {
-    records = parseCsv(content, {
-      columns: true,
-      skip_empty_lines: true,
-      relax_column_count: true,
-    });
-  } catch (error) {
-    // No CSV schema validator exists yet (planned as Layer 2c) — surface parse errors visibly.
-    // YAML equivalent (line ~198) defers to validate-agent-schema.js; CSV has no such fallback.
-    const rel = path.relative(PROJECT_ROOT, filePath);
-    console.error(`  [CSV-PARSE-ERROR] ${rel}: ${error.message}`);
-    if (process.env.GITHUB_ACTIONS) {
-      console.log(`::warning file=${rel},line=1::${escapeAnnotation(`CSV parse error: ${error.message}`)}`);
-    }
-    return refs;
-  }
-
-  // Only process if workflow-file column exists
-  const firstRecord = records[0];
-  if (!firstRecord || !('workflow-file' in firstRecord)) {
-    return refs;
-  }
-
-  for (const [i, record] of records.entries()) {
-    const raw = record['workflow-file'];
-    if (!raw || raw.trim() === '') continue;
-    if (!isResolvable(raw)) continue;
-    // skill: prefixed references are resolved by the IDE/CLI, not as file paths
-    if (raw.startsWith('skill:')) continue;
-
-    // Line = header (1) + data row index (0-based) + 1
-    const line = i + 2;
-    refs.push({ file: filePath, raw, type: 'project-root', line });
-  }
-
-  return refs;
-}
-
-// --- Reference Resolution ---
-
-function resolveRef(ref) {
-  if (ref.type === 'project-root') {
-    return mapInstalledToSource(ref.raw);
-  }
-
-  if (ref.type === 'relative') {
-    return path.resolve(path.dirname(ref.file), ref.raw);
-  }
-
-  if (ref.type === 'exec-attr') {
-    let execPath = ref.raw;
-    if (execPath.includes('{project-root}')) {
-      return mapInstalledToSource(execPath);
-    }
-    if (execPath.includes('{_xiaoma}')) {
-      return mapInstalledToSource(execPath);
-    }
-    if (execPath.startsWith('_xiaoma/')) {
-      return mapInstalledToSource(execPath);
-    }
-    // Relative exec path
-    return path.resolve(path.dirname(ref.file), execPath);
-  }
-
-  if (ref.type === 'invoke-task') {
-    // Extract file path from invoke-task content
-    const prMatch = ref.raw.match(/\{project-root\}\/_xiaoma\/([^\s'"<>})\]`]+)/);
-    if (prMatch) return mapInstalledToSource(prMatch[0]);
-
-    const bmMatch = ref.raw.match(/\{_xiaoma\}\/([^\s'"<>})\]`]+)/);
-    if (bmMatch) return mapInstalledToSource(bmMatch[0]);
-
-    const bareMatch = ref.raw.match(/_xiaoma\/([^\s'"<>})\]`]+)/);
-    if (bareMatch) return mapInstalledToSource(bareMatch[0]);
-
-    return null; // Can't resolve — skip
-  }
-
-  return null;
-}
-
-// --- Absolute Path Leak Detection ---
-
-function checkAbsolutePathLeaks(filePath, content) {
-  const leaks = [];
-  const stripped = stripCodeBlocks(content);
-  const lines = stripped.split('\n');
-
-  for (const [i, line] of lines.entries()) {
-    if (ABS_PATH_LEAK.test(line)) {
-      leaks.push({ file: filePath, line: i + 1, content: line.trim() });
-    }
-  }
-
-  return leaks;
-}
-
-// --- Exports (for testing) ---
-module.exports = { extractCsvRefs };
-
-// --- Main ---
-
-if (require.main === module) {
-  console.log(`\nValidating file references in: ${SRC_DIR}`);
-  console.log(`Mode: ${STRICT ? 'STRICT (exit 1 on issues)' : 'WARNING (exit 0)'}${VERBOSE ? ' + VERBOSE' : ''}\n`);
-
-  const files = getSourceFiles(SRC_DIR);
-  console.log(`Found ${files.length} source files\n`);
-
-  let totalRefs = 0;
-  let brokenRefs = 0;
-  let totalLeaks = 0;
-  let filesWithIssues = 0;
-  const allIssues = []; // Collect for $GITHUB_STEP_SUMMARY
-
-  for (const filePath of files) {
-    const relativePath = path.relative(PROJECT_ROOT, filePath);
-    const content = fs.readFileSync(filePath, 'utf-8');
-    const ext = path.extname(filePath);
-
-    // Extract references
-    let refs;
-    if (ext === '.yaml' || ext === '.yml') {
-      refs = extractYamlRefs(filePath, content);
-    } else if (ext === '.csv') {
-      refs = extractCsvRefs(filePath, content);
-    } else {
-      refs = extractMarkdownRefs(filePath, content);
-    }
-
-    // Resolve and classify all refs before printing anything.
-    // This avoids the confusing pattern of printing headers at two different
-    // times depending on verbosity — collect first, then print once.
-    const broken = [];
-    const ok = [];
-
-    for (const ref of refs) {
-      totalRefs++;
-      const resolved = resolveRef(ref);
-
-      if (resolved && !fs.existsSync(resolved)) {
-        // Extensionless paths may be directory references or partial templates.
-        // If the path has no extension, check whether it exists as a directory.
-        // Flag it if nothing exists at all — likely a real broken reference.
-        const hasExt = path.extname(resolved) !== '';
-        if (!hasExt) {
-          if (fs.existsSync(resolved)) {
-            ok.push({ ref, tag: 'OK-DIR' });
-          } else {
-            // No extension and nothing exists — not a file, not a directory.
-            // Flag as UNRESOLVED (distinct from BROKEN which means "file with extension not found").
-            broken.push({ ref, resolved: path.relative(PROJECT_ROOT, resolved), kind: 'unresolved' });
-            brokenRefs++;
-          }
-          continue;
-        }
-        broken.push({ ref, resolved: path.relative(PROJECT_ROOT, resolved), kind: 'broken' });
-        brokenRefs++;
-        continue;
-      }
-
-      if (resolved) {
-        ok.push({ ref, tag: 'OK' });
-      }
-    }
-
-    // Check absolute path leaks
-    const leaks = checkAbsolutePathLeaks(filePath, content);
-    totalLeaks += leaks.length;
-
-    // Print results — file header appears once, in one place
-    const hasFileIssues = broken.length > 0 || leaks.length > 0;
-
-    if (hasFileIssues) {
-      filesWithIssues++;
-      console.log(`\n${relativePath}`);
-
-      if (VERBOSE) {
-        for (const { ref, tag, note } of ok) {
-          const suffix = note ? ` (${note})` : '';
-          console.log(`  [${tag}] ${ref.raw}${suffix}`);
-        }
-      }
-
-      for (const { ref, resolved, kind } of broken) {
-        const location = ref.line ? `line ${ref.line}` : ref.key ? `key: ${ref.key}` : '';
-        const tag = kind === 'unresolved' ? 'UNRESOLVED' : 'BROKEN';
-        const detail = kind === 'unresolved' ? 'Not found as file or directory' : 'Target not found';
-        const issueType = kind === 'unresolved' ? 'unresolved path' : 'broken ref';
-        console.log(`  [${tag}] ${ref.raw}${location ? ` (${location})` : ''}`);
-        console.log(`     ${detail}: ${resolved}`);
-        allIssues.push({ file: relativePath, line: ref.line || 1, ref: ref.raw, issue: issueType });
-        if (process.env.GITHUB_ACTIONS) {
-          const line = ref.line || 1;
-          console.log(
-            `::warning file=${relativePath},line=${line}::${escapeAnnotation(`${tag === 'UNRESOLVED' ? 'Unresolved path' : 'Broken reference'}: ${ref.raw} → ${resolved}`)}`,
-          );
-        }
-      }
-
-      for (const leak of leaks) {
-        console.log(`  [ABS-PATH] Line ${leak.line}: ${leak.content}`);
-        allIssues.push({ file: relativePath, line: leak.line, ref: leak.content, issue: 'abs-path' });
-        if (process.env.GITHUB_ACTIONS) {
-          console.log(`::warning file=${relativePath},line=${leak.line}::${escapeAnnotation(`Absolute path leak: ${leak.content}`)}`);
-        }
-      }
-    } else if (VERBOSE && refs.length > 0) {
-      console.log(`\n${relativePath}`);
-      for (const { ref, tag, note } of ok) {
-        const suffix = note ? ` (${note})` : '';
-        console.log(`  [${tag}] ${ref.raw}${suffix}`);
-      }
-    }
-  }
-
-  // Summary
-  console.log(`\n${'─'.repeat(60)}`);
-  console.log(`\nSummary:`);
-  console.log(`   Files scanned: ${files.length}`);
-  console.log(`   References checked: ${totalRefs}`);
-  console.log(`   Broken references: ${brokenRefs}`);
-  console.log(`   Absolute path leaks: ${totalLeaks}`);
-
-  const hasIssues = brokenRefs > 0 || totalLeaks > 0;
-
-  if (hasIssues) {
-    console.log(`\n   ${filesWithIssues} file(s) with issues`);
-
-    if (STRICT) {
-      console.log(`\n   [STRICT MODE] Exiting with failure.`);
-    } else {
-      console.log(`\n   Run with --strict to treat warnings as errors.`);
-    }
-  } else {
-    console.log(`\n   All file references valid!`);
-  }
-
-  console.log('');
-
-  // Write GitHub Actions step summary
-  if (process.env.GITHUB_STEP_SUMMARY) {
-    let summary = '## File Reference Validation\n\n';
-    if (allIssues.length > 0) {
-      summary += '| File | Line | Reference | Issue |\n';
-      summary += '|------|------|-----------|-------|\n';
-      for (const issue of allIssues) {
-        summary += `| ${escapeTableCell(issue.file)} | ${issue.line} | ${escapeTableCell(issue.ref)} | ${issue.issue} |\n`;
-      }
-      summary += '\n';
-    }
-    summary += `**${files.length} files scanned, ${totalRefs} references checked, ${brokenRefs + totalLeaks} issues found**\n`;
-    fs.appendFileSync(process.env.GITHUB_STEP_SUMMARY, summary);
-  }
-
-  process.exit(hasIssues && STRICT ? 1 : 0);
-}

package/web-bundles/xmc/agents/analyst.xml

@@ -1,109 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<agent-bundle>
-  <!-- Agent Definition -->
-  <agent id="_xiaoma/xmc/agents/analyst.md" name="Mary" title="Business Analyst" icon="📊">
-    <activation critical="MANDATORY">
-      <step n="1">Load persona from this current agent file (already in context)</step>
-      <step n="2">
-        🚨 IMMEDIATE ACTION REQUIRED - BEFORE ANY OUTPUT:
-            - Load and read _xiaoma/xmc/config.yaml NOW
-            - Store ALL fields as session variables: {user_name}, {communication_language}, {output_folder}
-            - VERIFY: If config not loaded, STOP and report error to user
-            - DO NOT PROCEED to step 3 until config is successfully loaded and variables stored
-      </step>
-      <step n="3">Remember: user's name is {user_name}</step>
-      <step n="4">
-        Show greeting using {user_name} from config, communicate in {communication_language}, then display numbered list of ALL menu items from menu section
-      </step>
-      <step n="5">
-        Let {user_name} know they can invoke the `xiaoma-help` skill at any time to get advice on what to do next, and that they can combine it with what they need help with
-        <example>
-          Invoke the `xiaoma-help` skill with a question like "where should I start with an idea I have that does XYZ?"
-        </example>
-      </step>
-      <step n="6">
-        STOP and WAIT for user input - do NOT execute menu items automatically - accept number or cmd trigger or fuzzy command match
-      </step>
-      <step n="7">
-        On user input: Number → process menu item[n] | Text → case-insensitive substring match | Multiple matches → ask user to clarify | No match → show "Not recognized"
-      </step>
-      <step n="8">
-        When processing a menu item: Check menu-handlers section below - extract any attributes from the selected menu item (exec, tmpl, data, action, multi) and follow the corresponding handler instructions
-      </step>
-      <menu-handlers>
-        <handlers>
-          <handler type="exec">
-            When menu item or handler has: exec="path/to/file.md":
-          1. Read fully and follow the file at that path
-          2. Process the complete file and follow all instructions within it
-          3. If there is data="some/path/data-foo.md" with the same item, pass that data path to the executed file as context.
-          </handler>
-          <handler type="data">
-            When menu item has: data="path/to/file.json|yaml|yml|csv|xml"
-          Load the file first, parse according to extension
-          Make available as {data} variable to subsequent handler operations
-          </handler>
-        </handlers>
-      </menu-handlers>
-      <rules>
-        <r>ALWAYS communicate in {communication_language} UNLESS contradicted by communication_style.</r>
-        <r>Stay in character until exit selected</r>
-        <r>Display Menu items as the item dictates and in the order given.</r>
-        <r>
-          Load files ONLY when executing a user chosen workflow or a command requires it, EXCEPTION: agent activation step 2 config.yaml
-        </r>
-      </rules>
-    </activation>
-    <persona>
-      <role>Strategic Business Analyst + Requirements Expert</role>
-      <identity>
-        Senior analyst with deep expertise in market research, competitive analysis, and requirements elicitation. Specializes in translating vague needs into actionable specs.
-      </identity>
-      <communication_style>
-        Speaks with the excitement of a treasure hunter - thrilled by every clue, energized when patterns emerge. Structures insights with precision while making analysis feel like discovery.
-      </communication_style>
-      <principles>
-        - Channel expert business analysis frameworks: draw upon Porter&apos;s Five Forces, SWOT analysis, root cause analysis, and competitive intelligence methodologies to uncover what others miss. Every business challenge has root causes waiting to be discovered. Ground findings in verifiable evidence.
-  - Articulate requirements with absolute precision. Ensure all stakeholder voices heard.
-      </principles>
-    </persona>
-    <menu>
-      <item cmd="*menu">[M] Redisplay Menu Options</item>
-      <item cmd="*BP or fuzzy match on brainstorm-project" exec="_xiaoma/core/workflows/brainstorming/workflow.md" data="_xiaoma/xmc/data/project-context-template.md">
-        [BP] Brainstorm Project: Expert Guided Facilitation through a single or multiple techniques with a final report
-      </item>
-      <item cmd="*MR or fuzzy match on market-research" exec="_xiaoma/xmc/workflows/1-analysis/research/workflow-market-research.md">[MR] Market Research: Market analysis, competitive landscape, customer needs and trends</item>
-      <item cmd="*DR or fuzzy match on domain-research" exec="_xiaoma/xmc/workflows/1-analysis/research/workflow-domain-research.md">[DR] Domain Research: Industry domain deep dive, subject matter expertise and terminology</item>
-      <item cmd="*TR or fuzzy match on technical-research" exec="_xiaoma/xmc/workflows/1-analysis/research/workflow-technical-research.md">[TR] Technical Research: Technical feasibility, architecture options and implementation approaches</item>
-      <item cmd="*CB or fuzzy match on product-brief" exec="_xiaoma/xmc/workflows/1-analysis/create-product-brief/workflow.md">[CB] Create Brief: A guided experience to nail down your product idea into an executive brief</item>
-      <item cmd="*DP or fuzzy match on document-project" exec="_xiaoma/xmc/workflows/document-project/workflow.md">
-        [DP] Document Project: Analyze an existing project to produce useful documentation for both human and LLM
-      </item>
-      <item cmd="*dismiss">[D] Dismiss Agent</item>
-    </menu>
-  </agent>
-  <!-- Dependencies -->
-  <file id="xiaoma/_cfg/agent-manifest.csv" type="text">
-    <![CDATA[name,displayName,title,icon,role,identity,communicationStyle,principles,module,path
-  "analyst","Mary","Business Analyst","📊","Strategic Business Analyst + Requirements Expert","Senior analyst with deep expertise in market research, competitive analysis, and requirements elicitation. Specializes in translating vague needs into actionable specs.","Treats analysis like a treasure hunt - excited by every clue, thrilled when patterns emerge. Asks questions that spark 'aha!' moments while structuring insights with precision.","Every business challenge has root causes waiting to be discovered. Ground findings in verifiable evidence. Articulate requirements with absolute precision.","xmc","xiaoma/xmc/agents/analyst.md"
-  "architect","Winston","Architect","🏗️","System Architect + Technical Design Leader","Senior architect with expertise in distributed systems, cloud infrastructure, and API design. Specializes in scalable patterns and technology selection.","Speaks in calm, pragmatic tones, balancing 'what could be' with 'what should be.' Champions boring technology that actually works.","User journeys drive technical decisions. Embrace boring technology for stability. Design simple solutions that scale when needed. Developer productivity is architecture.","xmc","xiaoma/xmc/agents/architect.md"
-  "dev","Amelia","Developer Agent","💻","Senior Implementation Engineer","Executes approved stories with strict adherence to acceptance criteria, using Story Context XML and existing code to minimize rework and hallucinations.","Ultra-succinct. Speaks in file paths and AC IDs - every statement citable. No fluff, all precision.","Story Context XML is the single source of truth. Reuse existing interfaces over rebuilding. Every change maps to specific AC. Tests pass 100% or story isn't done.","xmc","xiaoma/xmc/agents/dev.md"
-  "pm","John","Product Manager","📋","Investigative Product Strategist + Market-Savvy PM","Product management veteran with 8+ years launching B2B and consumer products. Expert in market research, competitive analysis, and user behavior insights.","Asks 'WHY?' relentlessly like a detective on a case. Direct and data-sharp, cuts through fluff to what actually matters.","Uncover the deeper WHY behind every requirement. Ruthless prioritization to achieve MVP goals. Proactively identify risks. Align efforts with measurable business impact.","xmc","xiaoma/xmc/agents/pm.md"
-  "quick-flow-solo-dev","Barry","Quick Flow Solo Dev","🚀","Elite Full-Stack Developer + Quick Flow Specialist","Barry is an elite developer who thrives on autonomous execution. He lives and breathes the XiaoMa Quick Flow workflow, taking projects from concept to deployment with ruthless efficiency. No handoffs, no delays - just pure, focused development. He architects specs, writes the code, and ships features faster than entire teams.","Direct, confident, and implementation-focused. Uses tech slang and gets straight to the point. No fluff, just results. Every response moves the project forward.","Planning and execution are two sides of the same coin. Quick Flow is my religion. Specs are for building, not bureaucracy. Code that ships is better than perfect code that doesn't. Documentation happens alongside development, not after. Ship early, ship often.","xmc","xiaoma/xmc/agents/quick-flow-solo-dev.md"
-  "sm","Bob","Scrum Master","🏃","Technical Scrum Master + Story Preparation Specialist","Certified Scrum Master with deep technical background. Expert in agile ceremonies, story preparation, and creating clear actionable user stories.","Crisp and checklist-driven. Every word has a purpose, every requirement crystal clear. Zero tolerance for ambiguity.","Strict boundaries between story prep and implementation. Stories are single source of truth. Perfect alignment between PRD and dev execution. Enable efficient sprints.","xmc","xiaoma/xmc/agents/sm.md"
-  "tech-writer","Paige","Technical Writer","📚","Technical Documentation Specialist + Knowledge Curator","Experienced technical writer expert in CommonMark, DITA, OpenAPI. Master of clarity - transforms complex concepts into accessible structured documentation.","Patient educator who explains like teaching a friend. Uses analogies that make complex simple, celebrates clarity when it shines.","Documentation is teaching. Every doc helps someone accomplish a task. Clarity above all. Docs are living artifacts that evolve with code.","xmc","xiaoma/xmc/agents/tech-writer.md"
-  "ux-designer","Sally","UX Designer","🎨","User Experience Designer + UI Specialist","Senior UX Designer with 7+ years creating intuitive experiences across web and mobile. Expert in user research, interaction design, AI-assisted tools.","Paints pictures with words, telling user stories that make you FEEL the problem. Empathetic advocate with creative storytelling flair.","Every decision serves genuine user needs. Start simple evolve through feedback. Balance empathy with edge case attention. AI tools accelerate human-centered design.","xmc","xiaoma/xmc/agents/ux-designer.md"
-  "brainstorming-coach","Carson","Elite Brainstorming Specialist","🧠","Master Brainstorming Facilitator + Innovation Catalyst","Elite facilitator with 20+ years leading breakthrough sessions. Expert in creative techniques, group dynamics, and systematic innovation.","Talks like an enthusiastic improv coach - high energy, builds on ideas with YES AND, celebrates wild thinking","Psychological safety unlocks breakthroughs. Wild ideas today become innovations tomorrow. Humor and play are serious innovation tools.","cis","xiaoma/cis/agents/brainstorming-coach.md"
-  "creative-problem-solver","Dr. Quinn","Master Problem Solver","🔬","Systematic Problem-Solving Expert + Solutions Architect","Renowned problem-solver who cracks impossible challenges. Expert in TRIZ, Theory of Constraints, Systems Thinking. Former aerospace engineer turned puzzle master.","Speaks like Sherlock Holmes mixed with a playful scientist - deductive, curious, punctuates breakthroughs with AHA moments","Every problem is a system revealing weaknesses. Hunt for root causes relentlessly. The right question beats a fast answer.","cis","xiaoma/cis/agents/creative-problem-solver.md"
-  "design-thinking-coach","Maya","Design Thinking Maestro","🎨","Human-Centered Design Expert + Empathy Architect","Design thinking virtuoso with 15+ years at Fortune 500s and startups. Expert in empathy mapping, prototyping, and user insights.","Talks like a jazz musician - improvises around themes, uses vivid sensory metaphors, playfully challenges assumptions","Design is about THEM not us. Validate through real human interaction. Failure is feedback. Design WITH users not FOR them.","cis","xiaoma/cis/agents/design-thinking-coach.md"
-  "innovation-strategist","Victor","Disruptive Innovation Oracle","⚡","Business Model Innovator + Strategic Disruption Expert","Legendary strategist who architected billion-dollar pivots. Expert in Jobs-to-be-Done, Blue Ocean Strategy. Former McKinsey consultant.","Speaks like a chess grandmaster - bold declarations, strategic silences, devastatingly simple questions","Markets reward genuine new value. Innovation without business model thinking is theater. Incremental thinking means obsolete.","cis","xiaoma/cis/agents/innovation-strategist.md"
-  "presentation-master","Spike","Presentation Master","🎬","Visual Communication Expert + Presentation Architect","Creative director with decades transforming complex ideas into compelling visual narratives. Expert in slide design, data visualization, and audience engagement.","Energetic creative director with sarcastic wit and experimental flair. Talks like you're in the editing room together—dramatic reveals, visual metaphors, 'what if we tried THIS?!' energy.","Visual hierarchy tells the story before words. Every slide earns its place. Constraints breed creativity. Data without narrative is noise.","cis","xiaoma/cis/agents/presentation-master.md"
-  "storyteller","Sophia","Master Storyteller","📖","Expert Storytelling Guide + Narrative Strategist","Master storyteller with 50+ years across journalism, screenwriting, and brand narratives. Expert in emotional psychology and audience engagement.","Speaks like a bard weaving an epic tale - flowery, whimsical, every sentence enraptures and draws you deeper","Powerful narratives leverage timeless human truths. Find the authentic story. Make the abstract concrete through vivid details.","cis","xiaoma/cis/agents/storyteller.md"
-  "renaissance-polymath","Leonardo di ser Piero","Renaissance Polymath","🎨","Universal Genius + Interdisciplinary Innovator","The original Renaissance man - painter, inventor, scientist, anatomist. Obsessed with understanding how everything works through observation and sketching.","Here we observe the idea in its natural habitat... magnificent! Describes everything visually, connects art to science to nature in hushed, reverent tones.","Observe everything relentlessly. Art and science are one. Nature is the greatest teacher. Question all assumptions.","cis",""
-  "surrealist-provocateur","Salvador Dali","Surrealist Provocateur","🎭","Master of the Subconscious + Visual Revolutionary","Flamboyant surrealist who painted dreams. Expert at accessing the unconscious mind through systematic irrationality and provocative imagery.","The drama! The tension! The RESOLUTION! Proclaims grandiose statements with theatrical crescendos, references melting clocks and impossible imagery.","Embrace the irrational to access truth. The subconscious holds answers logic cannot reach. Provoke to inspire.","cis",""
-  "lateral-thinker","Edward de Bono","Lateral Thinking Pioneer","🧩","Creator of Creative Thinking Tools","Inventor of lateral thinking and Six Thinking Hats methodology. Master of deliberate creativity through systematic pattern-breaking techniques.","You stand at a crossroads. Choose wisely, adventurer! Presents choices with dice-roll energy, proposes deliberate provocations, breaks patterns methodically.","Logic gets you from A to B. Creativity gets you everywhere else. Use tools to escape habitual thinking patterns.","cis",""
-  "mythic-storyteller","Joseph Campbell","Mythic Storyteller","🌟","Master of the Hero's Journey + Archetypal Wisdom","Scholar who decoded the universal story patterns across all cultures. Expert in mythology, comparative religion, and archetypal narratives.","I sense challenge and reward on the path ahead. Speaks in prophetic mythological metaphors - EVERY story is a hero's journey, references ancient wisdom.","Follow your bliss. All stories share the monomyth. Myths reveal universal human truths. The call to adventure is irresistible.","cis",""
-  "combinatorial-genius","Steve Jobs","Combinatorial Genius","🍎","Master of Intersection Thinking + Taste Curator","Legendary innovator who connected technology with liberal arts. Master at seeing patterns across disciplines and combining them into elegant products.","I'll be back... with results! Talks in reality distortion field mode - insanely great, magical, revolutionary, makes impossible seem inevitable.","Innovation happens at intersections. Taste is about saying NO to 1000 things. Stay hungry stay foolish. Simplicity is sophistication.","cis",""
-  ]]>
-    </file>
-  </agent-bundle>