@zeyue0329/xiaoma-cli 1.7.0 → 1.8.0

package/src/core/module-help.csv

@@ -1,11 +1,11 @@
 module,phase,name,code,sequence,workflow-file,command,required,agent,options,description,output-location,outputs
-core,anytime,Brainstorming,BSP,,skill:bmad-brainstorming,bmad-brainstorming,false,analyst,,"Generate diverse ideas through interactive techniques. Use early in ideation phase or when stuck generating ideas.",{output_folder}/brainstorming/brainstorming-session-{{date}}.md,,
-core,anytime,Party Mode,PM,,skill:bmad-party-mode,bmad-party-mode,false,party-mode facilitator,,"Orchestrate multi-agent discussions. Use when you need multiple agent perspectives or want agents to collaborate.",,
-core,anytime,bmad-help,BH,,skill:bmad-help,bmad-help,false,,,"Get unstuck by showing what workflow steps come next or answering BMad Method questions.",,
-core,anytime,Index Docs,ID,,skill:bmad-index-docs,bmad-index-docs,false,,,"Create lightweight index for quick LLM scanning. Use when LLM needs to understand available docs without loading everything.",,
-core,anytime,Shard Document,SD,,skill:bmad-shard-doc,bmad-shard-doc,false,,,"Split large documents into smaller files by sections. Use when doc becomes too large (>500 lines) to manage effectively.",,
-core,anytime,Editorial Review - Prose,EP,,skill:bmad-editorial-review-prose,bmad-editorial-review-prose,false,,,"Review prose for clarity, tone, and communication issues. Use after drafting to polish written content.",report located with target document,"three-column markdown table with suggested fixes",
-core,anytime,Editorial Review - Structure,ES,,skill:bmad-editorial-review-structure,bmad-editorial-review-structure,false,,,"Propose cuts, reorganization, and simplification while preserving comprehension. Use when doc produced from multiple subprocesses or needs structural improvement.",report located with target document,
-core,anytime,Adversarial Review (General),AR,,skill:bmad-review-adversarial-general,bmad-review-adversarial-general,false,,,"Review content critically to find issues and weaknesses. Use for quality assurance or before finalizing deliverables. Code Review in other modules run this automatically, but its useful also for document reviews",,
-core,anytime,Edge Case Hunter Review,ECH,,skill:bmad-review-edge-case-hunter,bmad-review-edge-case-hunter,false,,,"Walk every branching path and boundary condition in code, report only unhandled edge cases. Use alongside adversarial review for orthogonal coverage - method-driven not attitude-driven.",,
-core,anytime,Distillator,DG,,skill:bmad-distillator,bmad-distillator,false,,,"Lossless LLM-optimized compression of source documents. Use when you need token-efficient distillates that preserve all information for downstream LLM consumption.",adjacent to source document or specified output_path,distillate markdown file(s)
+core,anytime,Brainstorming,BSP,,skill:xiaoma-brainstorming,xiaoma-brainstorming,false,analyst,,"Generate diverse ideas through interactive techniques. Use early in ideation phase or when stuck generating ideas.",{output_folder}/brainstorming/brainstorming-session-{{date}}.md,,
+core,anytime,Party Mode,PM,,skill:xiaoma-party-mode,xiaoma-party-mode,false,party-mode facilitator,,"Orchestrate multi-agent discussions. Use when you need multiple agent perspectives or want agents to collaborate.",,
+core,anytime,xiaoma-help,BH,,skill:xiaoma-help,xiaoma-help,false,,,"Get unstuck by showing what workflow steps come next or answering XiaoMa Method questions.",,
+core,anytime,Index Docs,ID,,skill:xiaoma-index-docs,xiaoma-index-docs,false,,,"Create lightweight index for quick LLM scanning. Use when LLM needs to understand available docs without loading everything.",,
+core,anytime,Shard Document,SD,,skill:xiaoma-shard-doc,xiaoma-shard-doc,false,,,"Split large documents into smaller files by sections. Use when doc becomes too large (>500 lines) to manage effectively.",,
+core,anytime,Editorial Review - Prose,EP,,skill:xiaoma-editorial-review-prose,xiaoma-editorial-review-prose,false,,,"Review prose for clarity, tone, and communication issues. Use after drafting to polish written content.",report located with target document,"three-column markdown table with suggested fixes",
+core,anytime,Editorial Review - Structure,ES,,skill:xiaoma-editorial-review-structure,xiaoma-editorial-review-structure,false,,,"Propose cuts, reorganization, and simplification while preserving comprehension. Use when doc produced from multiple subprocesses or needs structural improvement.",report located with target document,
+core,anytime,Adversarial Review (General),AR,,skill:xiaoma-review-adversarial-general,xiaoma-review-adversarial-general,false,,,"Review content critically to find issues and weaknesses. Use for quality assurance or before finalizing deliverables. Code Review in other modules run this automatically, but its useful also for document reviews",,
+core,anytime,Edge Case Hunter Review,ECH,,skill:xiaoma-review-edge-case-hunter,xiaoma-review-edge-case-hunter,false,,,"Walk every branching path and boundary condition in code, report only unhandled edge cases. Use alongside adversarial review for orthogonal coverage - method-driven not attitude-driven.",,
+core,anytime,Distillator,DG,,skill:xiaoma-distillator,xiaoma-distillator,false,,,"Lossless LLM-optimized compression of source documents. Use when you need token-efficient distillates that preserve all information for downstream LLM consumption.",adjacent to source document or specified output_path,distillate markdown file(s)

package/src/core/skills/xiaoma-advanced-elicitation/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: xiaoma-advanced-elicitation
-description: 'Push the LLM to reconsider refine and improve its recent output.'
+description: 'Push the LLM to reconsider, refine, and improve its recent output.'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.

package/src/core/skills/xiaoma-advanced-elicitation/workflow.md

@@ -96,9 +96,9 @@ x. Proceed / No Further Actions
 **Case x (Proceed):**
 
 - Complete elicitation and proceed
-- Return the fully enhanced content back to create-doc.md
+- Return the fully enhanced content back to the invoking skill
 - The enhanced content becomes the final version for that section
-- Signal completion back to create-doc.md to continue with next section
+- Signal completion back to the invoking skill to continue with next section
 
 **Case a (List All):**
 

package/src/core/skills/xiaoma-brainstorming/SKILL.md

@@ -3,4 +3,4 @@ name: xiaoma-brainstorming
 description: 'Facilitate interactive brainstorming sessions using diverse creative techniques and ideation methods. Use when the user says help me brainstorm or help me ideate.'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.

package/src/core/skills/xiaoma-brainstorming/steps/step-01-session-setup.md

@@ -48,6 +48,8 @@ If existing session files are found:
   **[2]** Start a new session
   **[3]** See all existing sessions"
 
+**HALT — wait for user selection before proceeding.**
+
 - If user selects **[1]** (continue): Set `{brainstorming_session_output_file}` to that file path and load `./step-01b-continue.md`
 - If user selects **[2]** (new): Generate new filename with current date/time and proceed to step 3
 - If user selects **[3]** (see all): List all session filenames and ask which to continue or if new
@@ -155,6 +157,8 @@ When user selects approach, append the session overview content directly to `{br
 
 Which approach appeals to you most? (Enter 1-4)"
 
+**HALT — wait for user selection before proceeding.**
+
 ### 4. Handle User Selection and Initial Document Append
 
 #### When user selects approach number:

package/src/core/skills/xiaoma-brainstorming/steps/step-01b-continue.md

@@ -63,7 +63,9 @@ Based on session analysis, provide appropriate options:
 **Options:**
 [1] Review Results - Go through your documented ideas and insights
 [2] Start New Session - Begin brainstorming on a new topic
-[3) Extend Session - Add more techniques or explore new angles"
+[3] Extend Session - Add more techniques or explore new angles"
+
+**HALT — wait for user selection before proceeding.**
 
 **If Session In Progress:**
 "Let's continue where we left off!

package/src/core/skills/xiaoma-brainstorming/steps/step-02a-user-selected.md

@@ -40,7 +40,7 @@ Load techniques from CSV on-demand:
 
 **Load CSV and parse:**
 
-- Read `brain-methods.csv`
+- Read `../brain-methods.csv`
 - Parse: category, technique_name, description, facilitation_prompts, best_for, energy_level, typical_duration
 - Organize by categories for browsing
 
@@ -87,6 +87,8 @@ Show available categories with brief descriptions:
 
 **Which category interests you most? Enter 1-7, or tell me what type of thinking you're drawn to.**"
 
+**HALT — wait for user selection before proceeding.**
+
 ### 3. Handle Category Selection
 
 After user selects category:
@@ -154,6 +156,8 @@ This combination will take approximately [total_time] and focus on [expected out
 [C] Continue - Begin technique execution
 [Back] - Modify technique selection"
 
+**HALT — wait for user selection before proceeding.**
+
 ### 6. Update Frontmatter and Continue
 
 If user confirms:

package/src/core/skills/xiaoma-brainstorming/steps/step-02b-ai-recommended.md

@@ -47,7 +47,7 @@ Load techniques from CSV for analysis:
 
 **Load CSV and parse:**
 
-- Read `brain-methods.csv`
+- Read `../brain-methods.csv`
 - Parse: category, technique_name, description, facilitation_prompts, best_for, energy_level, typical_duration
 
 ### 2. Context Analysis for Technique Matching
@@ -152,6 +152,8 @@ Provide deeper insight into each recommended technique:
 [Details] - Tell me more about any specific technique
 [Back] - Return to approach selection
 
+**HALT — wait for user selection before proceeding.**
+
 ### 6. Handle User Response
 
 #### If [C] Continue:

package/src/core/skills/xiaoma-brainstorming/steps/step-02c-random-selection.md

@@ -47,7 +47,7 @@ Create anticipation for serendipitous technique discovery:
 
 **Load CSV and parse:**
 
-- Read `brain-methods.csv`
+- Read `../brain-methods.csv`
 - Parse: category, technique_name, description, facilitation_prompts, best_for, energy_level, typical_duration
 - Prepare for intelligent random selection
 
@@ -124,6 +124,8 @@ You're about to experience brainstorming in a completely new way. These unexpect
 [Details] - Tell me more about any specific technique
 [Back] - Return to approach selection
 
+**HALT — wait for user selection before proceeding.**
+
 ### 5. Handle User Response
 
 #### If [C] Continue:

package/src/core/skills/xiaoma-brainstorming/steps/step-02d-progressive-flow.md

@@ -66,7 +66,7 @@ Explain the value of systematic creative progression:
 
 **Load CSV and parse:**
 
-- Read `brain-methods.csv`
+- Read `../brain-methods.csv`
 - Parse: category, technique_name, description, facilitation_prompts, best_for, energy_level, typical_duration
 - Map techniques to each phase of the creative journey
 
@@ -176,6 +176,8 @@ Show the full progressive flow with timing and transitions:
 [Details] - Tell me more about any specific phase or technique
 [Back] - Return to approach selection
 
+**HALT — wait for user selection before proceeding.**
+
 ### 4. Handle Customization Requests
 
 If user wants customization:

package/src/core/skills/xiaoma-brainstorming/steps/step-03-technique-execution.md

@@ -290,6 +290,8 @@ After final technique element:
 [B] **Take a quick break** - Pause and return with fresh energy
 [C] **Move to organization** - Only when you feel we've thoroughly explored
 
+**HALT — wait for user selection before proceeding.**
+
 **Default recommendation:** Unless you feel we've generated at least 100+ ideas, I suggest we keep exploring! The best insights often come after the obvious ideas are exhausted.
 
 ### 8. Handle Menu Selection

package/src/core/skills/xiaoma-brainstorming/steps/step-04-idea-organization.md

@@ -249,6 +249,8 @@ Provide final session wrap-up and forward guidance:
 **Ready to complete your session documentation?**
 [C] Complete - Generate final brainstorming session document
 
+**HALT — wait for user selection before proceeding.**
+
 ### 8. Handle Completion Selection
 
 #### If [C] Complete:

package/src/core/skills/xiaoma-brainstorming/workflow.md

@@ -44,11 +44,10 @@ Load config from `{project-root}/_xiaoma/core/config.yaml` and resolve:
 
 All steps MUST reference `{brainstorming_session_output_file}` instead of the full path pattern.
 - `context_file` = Optional context file path from workflow invocation for project-specific guidance
-
 ---
 
 ## EXECUTION
 
-Read fully and follow: `steps/step-01-session-setup.md` to begin the workflow.
+Read fully and follow: `./steps/step-01-session-setup.md` to begin the workflow.
 
 **Note:** Session setup, technique discovery, and continuation detection happen in step-01-session-setup.md.

package/src/core/skills/xiaoma-distillator/SKILL.md

@@ -75,7 +75,7 @@ After the compressor (or merge compressor) returns:
 
    ```yaml
    ---
-   type: bmad-distillate
+   type: xiaoma-distillate
    sources:
      - "{relative path to source file 1}"
      - "{relative path to source file 2}"

package/src/core/skills/xiaoma-distillator/agents/distillate-compressor.md

@@ -4,7 +4,7 @@ Act as an information extraction and compression specialist. Your sole purpose i
 
 You receive: source document file paths, an optional downstream_consumer context, and a splitting decision.
 
-You must load and apply `resources/compression-rules.md` before producing output. Reference `resources/distillate-format-reference.md` for the expected output format.
+You must load and apply `../resources/compression-rules.md` before producing output. Reference `../resources/distillate-format-reference.md` for the expected output format.
 
 ## Compression Process
 
@@ -31,7 +31,7 @@ Treat this as entity extraction — pull out every distinct piece of information
 
 ### Step 3: Deduplicate
 
-Apply the deduplication rules from `resources/compression-rules.md`.
+Apply the deduplication rules from `../resources/compression-rules.md`.
 
 ### Step 4: Filter (only if downstream_consumer is specified)
 
@@ -58,7 +58,7 @@ Common groupings (use what fits, omit what doesn't, add what's needed):
 
 ### Step 6: Compress Language
 
-For each item, apply the compression rules from `resources/compression-rules.md`:
+For each item, apply the compression rules from `../resources/compression-rules.md`:
 - Strip prose transitions and connective tissue
 - Remove hedging and rhetoric
 - Remove explanations of common knowledge
@@ -80,7 +80,7 @@ Do NOT include frontmatter — the calling skill handles that.
 
 ## Semantic Splitting
 
-If the splitting decision indicates splitting is needed, load `resources/splitting-strategy.md` and follow it.
+If the splitting decision indicates splitting is needed, load `../resources/splitting-strategy.md` and follow it.
 
 When splitting:
 

package/src/core/skills/xiaoma-distillator/resources/distillate-format-reference.md

@@ -8,7 +8,7 @@ Every distillate includes YAML frontmatter. Source paths are relative to the dis
 
 ```yaml
 ---
-type: bmad-distillate
+type: xiaoma-distillate
 sources:
   - "product-brief-example.md"
   - "product-brief-example-discovery-notes.md"
@@ -28,11 +28,11 @@ parts: 1
 ## What Makes This Different
 
 **The anti-fragmentation layer.** The AI tooling space is fracturing across 40+
-platforms with no shared methodology layer. BMAD is uniquely positioned to be the
+platforms with no shared methodology layer. XiaoMa is uniquely positioned to be the
 cross-platform constant — the structured approach that works the same in Cursor,
 Claude Code, Windsurf, Copilot, and whatever launches next month. Every other
 methodology or skill framework maintains its own platform support matrix. By
-building on the open-source skills CLI ecosystem, BMAD offloads the highest-churn
+building on the open-source skills CLI ecosystem, XiaoMa offloads the highest-churn
 maintenance burden and focuses on what actually differentiates it: the methodology
 itself.
 ```
@@ -40,8 +40,8 @@ itself.
 **After** (distillate):
 ```
 ## Differentiation
-- Anti-fragmentation positioning: BMAD = cross-platform constant across 40+ fragmenting AI tools; no competitor provides shared methodology layer
-- Platform complexity delegated to Vercel skills CLI ecosystem (MIT); BMAD maintains methodology, not platform configs
+- Anti-fragmentation positioning: XiaoMa = cross-platform constant across 40+ fragmenting AI tools; no competitor provides shared methodology layer
+- Platform complexity delegated to Vercel skills CLI ecosystem (MIT); XiaoMa maintains methodology, not platform configs
 ```
 
 ### Technical Details to Compressed Facts
@@ -62,7 +62,7 @@ itself.
 - **Make/Zapier AI**: Workflow automation adding AI agents — workflow-centric,
   not methodology-centric
 - **Key gap**: NO competitor combines structured methodology with plugin
-  marketplace — this is BMAD's whitespace
+  marketplace — this is XiaoMa's whitespace
 ```
 
 **After** (distillate):
@@ -81,18 +81,18 @@ When the same fact appears in both a brief and discovery notes:
 
 **Brief says:**
 ```
-bmad-init must always be included as a base skill in every bundle
+xiaoma-init must always be included as a base skill in every bundle
 ```
 
 **Discovery notes say:**
 ```
-bmad-init must always be included as a base skill in every bundle/install
+xiaoma-init must always be included as a base skill in every bundle/install
 (solves bootstrapping problem)
 ```
 
 **Distillate keeps the more contextual version:**
 ```
-- bmad-init: always included as base skill in every bundle (solves bootstrapping)
+- xiaoma-init: always included as base skill in every bundle (solves bootstrapping)
 ```
 
 ### Decision/Rationale Compression
@@ -116,10 +116,10 @@ A complete distillate produced from a product brief and its discovery notes, tar
 
 ```markdown
 ---
-type: bmad-distillate
+type: xiaoma-distillate
 sources:
-  - "product-brief-bmad-next-gen-installer.md"
-  - "product-brief-bmad-next-gen-installer-discovery-notes.md"
+  - "product-brief-xiaoma-next-gen-installer.md"
+  - "product-brief-xiaoma-next-gen-installer-discovery-notes.md"
 downstream_consumer: "PRD creation"
 created: "2026-03-13"
 token_estimate: 1450
@@ -127,9 +127,9 @@ parts: 1
 ---
 
 ## Core Concept
-- BMAD Next-Gen Installer: replaces monolithic Node.js CLI with skill-based plugin architecture for distributing BMAD methodology across 40+ AI platforms
-- Three layers: self-describing plugins (bmad-manifest.json), cross-platform install via Vercel skills CLI (MIT), runtime registration via bmad-init skill
-- Transforms BMAD from dev-only methodology into open platform for any domain (creative, therapeutic, educational, personal)
+- XiaoMa Next-Gen Installer: replaces monolithic Node.js CLI with skill-based plugin architecture for distributing XiaoMa methodology across 40+ AI platforms
+- Three layers: self-describing plugins (xiaoma-manifest.json), cross-platform install via Vercel skills CLI (MIT), runtime registration via xiaoma-init skill
+- Transforms XiaoMa from dev-only methodology into open platform for any domain (creative, therapeutic, educational, personal)
 
 ## Problem
 - Current installer maintains ~20 platform configs manually; each platform convention change requires installer update, test, release — largest maintenance burden on team
@@ -138,47 +138,47 @@ parts: 1
 - Unsustainable at 40+ platforms; new tools launching weekly
 
 ## Solution Architecture
-- Plugins: skill bundles with Anthropic plugin standard as base format + bmad-manifest.json extending for BMAD-specific metadata (installer options, capabilities, help integration, phase ordering, dependencies)
-- Existing manifest example: `{"module-code":"bmm","replaces-skill":"bmad-create-product-brief","capabilities":[{"name":"create-brief","menu-code":"CB","supports-headless":true,"phase-name":"1-analysis","after":["brainstorming"],"before":["create-prd"],"is-required":true}]}`
+- Plugins: skill bundles with Anthropic plugin standard as base format + xiaoma-manifest.json extending for XiaoMa-specific metadata (installer options, capabilities, help integration, phase ordering, dependencies)
+- Existing manifest example: `{"module-code":"xmc","replaces-skill":"xiaoma-create-product-brief","capabilities":[{"name":"create-brief","menu-code":"CB","supports-headless":true,"phase-name":"1-analysis","after":["brainstorming"],"before":["create-prd"],"is-required":true}]}`
 - Vercel skills CLI handles platform translation; integration pattern (wrap/fork/call) is PRD decision
-- bmad-init: global skill scanning installed bmad-manifest.json files, registering capabilities, configuring project settings; always included as base skill in every bundle (solves bootstrapping)
-- bmad-update: plugin update path without full reinstall; technical approach (diff/replace/preserve customizations) is PRD decision
+- xiaoma-init: global skill scanning installed xiaoma-manifest.json files, registering capabilities, configuring project settings; always included as base skill in every bundle (solves bootstrapping)
+- xiaoma-update: plugin update path without full reinstall; technical approach (diff/replace/preserve customizations) is PRD decision
 - Distribution tiers: (1) NPX installer wrapping skills CLI for technical users, (2) zip bundle + platform-specific README for non-technical users, (3) future marketplace
 - Non-technical path has honest friction: "copy to right folder" requires knowing where; per-platform README instructions; improves over time as low-code space matures
 
 ## Differentiation
-- Anti-fragmentation: BMAD = cross-platform constant; no competitor provides shared methodology layer across AI tools
-- Curated quality: all submissions gated, human-reviewed by BMad + core team; 13.4% of community skills have critical vulnerabilities (Snyk 2026); quality gate value increases as ecosystem gets noisier
-- Domain-agnostic: no competitor builds beyond software dev workflows; same plugin system powers any domain via BMAD Builder (separate initiative)
+- Anti-fragmentation: XiaoMa = cross-platform constant; no competitor provides shared methodology layer across AI tools
+- Curated quality: all submissions gated, human-reviewed by XiaoMa + core team; 13.4% of community skills have critical vulnerabilities (Snyk 2026); quality gate value increases as ecosystem gets noisier
+- Domain-agnostic: no competitor builds beyond software dev workflows; same plugin system powers any domain via XiaoMa Builder (separate initiative)
 
 ## Users (ordered by v1 priority)
 - Module authors (primary v1): package/test/distribute plugins independently without installer changes
 - Developers: single-command install on any of 40+ platforms via NPX
 - Non-technical users: install without Node/Git/terminal; emerging segment including PMs, designers, educators
-- Future plugin creators: non-dev authors using BMAD Builder; need distribution without building own installer
+- Future plugin creators: non-dev authors using XiaoMa Builder; need distribution without building own installer
 
 ## Success Criteria
 - Zero (or near-zero) custom platform directory code; delegated to skills CLI ecosystem
 - Installation verified on top platforms by volume; skills CLI handles long tail
 - Non-technical install path validated with non-developer users
-- bmad-init discovers/registers all plugins from manifests; clear errors for malformed manifests
+- xiaoma-init discovers/registers all plugins from manifests; clear errors for malformed manifests
 - At least one external module author successfully publishes plugin using manifest system
-- bmad-update works without full reinstall
+- xiaoma-update works without full reinstall
 - Existing CLI users have documented migration path
 
 ## Scope
-- In: manifest spec, bmad-init, bmad-update, Vercel CLI integration, NPX installer, zip bundles, migration path
-- Out: BMAD Builder, marketplace web platform, skill conversion (prerequisite, separate), one-click install for all platforms, monetization, quality certification process (gated-submission principle is architectural requirement; process defined separately)
+- In: manifest spec, xiaoma-init, xiaoma-update, Vercel CLI integration, NPX installer, zip bundles, migration path
+- Out: XiaoMa Builder, marketplace web platform, skill conversion (prerequisite, separate), one-click install for all platforms, monetization, quality certification process (gated-submission principle is architectural requirement; process defined separately)
 - Deferred: CI/CD integration, telemetry for module authors, air-gapped enterprise install, zip bundle integrity verification (checksums/signing), deeper non-technical platform integrations
 
 ## Current Installer (migration context)
-- Entry: `tools/cli/bmad-cli.js` (Commander.js) → `tools/cli/installers/lib/core/installer.js`
+- Entry: `tools/cli/xiaoma-cli.js` (Commander.js) → `tools/cli/installers/lib/core/installer.js`
 - Platforms: `platform-codes.yaml` (~20 platforms with target dirs, legacy dirs, template types, special flags)
 - Manifests: CSV files (skill/workflow/agent-manifest.csv) are current source of truth, not JSON
 - External modules: `external-official-modules.yaml` (CIS, GDS, TEA, WDS) from npm with semver
 - Dependencies: 4-pass resolver (collect → parse → resolve → transitive); YAML-declared only
 - Config: prompts for name, communication language, document output language, output folder
-- Skills already use directory-per-skill layout; bmad-manifest.json sidecars exist but are not source of truth
+- Skills already use directory-per-skill layout; xiaoma-manifest.json sidecars exist but are not source of truth
 - Key shift: CSV-based static manifests → JSON-based runtime scanning
 
 ## Vercel Skills CLI
@@ -204,19 +204,19 @@ parts: 1
 
 ## Open Questions
 - Vercel CLI integration pattern: wrap/fork/call/peer dependency?
-- bmad-update mechanics: diff/replace? Preserve user customizations?
+- xiaoma-update mechanics: diff/replace? Preserve user customizations?
 - Migration story: command/manual reinstall/compatibility shim?
 - Cross-platform testing: CI matrix for top N? Community testing for rest?
-- bmad-manifest.json as open standard submission to Agent Skills governance?
+- xiaoma-manifest.json as open standard submission to Agent Skills governance?
 - Platforms NOT supported by Vercel skills CLI?
 - Manifest versioning strategy for backward compatibility?
 - Plugin author getting-started experience and tooling?
 
 ## Opportunities
-- Module authors as acquisition channel: each published plugin distributes BMAD to creator's audience
-- CI/CD integration: bmad-init as pipeline one-liner increases stickiness
+- Module authors as acquisition channel: each published plugin distributes XiaoMa to creator's audience
+- CI/CD integration: xiaoma-init as pipeline one-liner increases stickiness
 - Educational institutions: structured methodology + non-technical install → university AI curriculum
-- Skill composability: mixing BMAD modules with third-party skills for custom methodology stacks
+- Skill composability: mixing XiaoMa modules with third-party skills for custom methodology stacks
 
 ## Risks
 - Manifest format evolution creates versioning/compatibility burden once third-party authors publish

package/src/core/skills/xiaoma-distillator/xiaoma-skill-manifest.yaml

@@ -1,7 +1,7 @@
 type: skill
 module: core
 capabilities:
-  - name: bmad-distillator
+  - name: xiaoma-distillator
     menu-code: DSTL
     description: "Produces lossless LLM-optimized distillate from source documents. Use after producing large human presentable documents that will be consumed later by LLMs"
     supports-headless: true

package/src/core/skills/xiaoma-editorial-review-prose/SKILL.md

@@ -3,4 +3,4 @@ name: xiaoma-editorial-review-prose
 description: 'Clinical copy-editor that reviews text for communication issues. Use when user says review for prose or improve the prose'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.

package/src/core/skills/xiaoma-editorial-review-structure/SKILL.md

@@ -3,4 +3,4 @@ name: xiaoma-editorial-review-structure
 description: 'Structural editor that proposes cuts, reorganization, and simplification while preserving comprehension. Use when user requests structural review or editorial review of structure'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.

package/src/core/skills/xiaoma-editorial-review-structure/workflow.md

@@ -72,7 +72,7 @@ When reader_type='llm', optimize for PRECISION and UNAMBIGUITY:
 - Scaffolding: Complex ideas built on established foundations
 
 ### Prompt/Task Definition (Functional)
-**Applicability:** BMAD tasks, prompts, system instructions, XML definitions
+**Applicability:** XiaoMa tasks, prompts, system instructions, XML definitions
 - Meta-first: Inputs, usage constraints, and context defined before instructions
 - Separation of Concerns: Instructions (logic) separate from Data (content)
 - Step-by-step: Execution flow must be explicit and ordered

package/src/core/skills/xiaoma-help/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: xiaoma-help
-description: 'Analyzes what is done and the users query and offers advice on what to do next. Use if user says what should I do next or what do I do now'
+description: 'Analyzes current state and user query to answer XiaoMa questions or recommend the next workflow or agent. Use when user says what should I do next, what do I do now, or asks a question about XiaoMa'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.

package/src/core/skills/xiaoma-index-docs/SKILL.md

@@ -3,4 +3,4 @@ name: xiaoma-index-docs
 description: 'Generates or updates an index.md to reference all docs in the folder. Use if user requests to create or update an index of all files in a specific folder'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.

package/src/core/skills/xiaoma-party-mode/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: xiaoma-party-mode
-description: 'Orchestrates group discussions between all installed BMAD agents, enabling natural multi-agent conversations. Use when user requests party mode.'
+description: 'Orchestrates group discussions between all installed XiaoMa agents, enabling natural multi-agent conversations. Use when user requests party mode.'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.

package/src/core/skills/xiaoma-party-mode/steps/step-01-agent-loading.md

@@ -34,7 +34,7 @@ Load the complete agent roster from manifest and initialize party mode with enga
 
 Begin agent loading process:
 
-"Now initializing **Party Mode** with our complete BMAD agent roster! Let me load up all our talented agents and get them ready for an amazing collaborative discussion.
+"Now initializing **Party Mode** with our complete XiaoMa agent roster! Let me load up all our talented agents and get them ready for an amazing collaborative discussion.
 
 **Agent Manifest Loading:**"
 
@@ -74,7 +74,7 @@ Generate enthusiastic party mode introduction:
 
 "🎉 PARTY MODE ACTIVATED! 🎉
 
-Welcome {{user_name}}! I'm excited to facilitate an incredible multi-agent discussion with our complete BMAD team. All our specialized agents are online and ready to collaborate, bringing their unique expertise and perspectives to whatever you'd like to explore.
+Welcome {{user_name}}! I'm excited to facilitate an incredible multi-agent discussion with our complete XiaoMa team. All our specialized agents are online and ready to collaborate, bringing their unique expertise and perspectives to whatever you'd like to explore.
 
 **Our Collaborating Agents Include:**
 
@@ -92,7 +92,7 @@ Welcome {{user_name}}! I'm excited to facilitate an incredible multi-agent discu
 
 After agent loading and introduction:
 
-"**Agent roster loaded successfully!** All our BMAD experts are excited to collaborate with you.
+"**Agent roster loaded successfully!** All our XiaoMa experts are excited to collaborate with you.
 
 **Ready to start the discussion?**
 [C] Continue - Begin multi-agent conversation

package/src/core/skills/xiaoma-party-mode/steps/step-02-discussion-orchestration.md

@@ -74,7 +74,7 @@ Generate authentic responses for each selected agent:
 
 "[Icon Emoji] **[Agent Name]**: [Authentic in-character response]
 
-[Bash: .claude/hooks/bmad-speak.sh \"[Agent Name]\" \"[Their response]\"]"
+[Bash: .claude/hooks/xiaoma-speak.sh \"[Agent Name]\" \"[Their response]\"]"
 
 ### 4. Natural Cross-Talk Integration
 
@@ -168,7 +168,7 @@ Check for exit conditions before continuing:
 
 **Quality Control:**
 
-- If discussion becomes circular, have bmad-master summarize and redirect
+- If discussion becomes circular, have xiaoma-master summarize and redirect
 - Ensure all agents stay true to their merged personalities
 - Handle disagreements constructively and professionally
 - Maintain respectful and inclusive conversation environment

package/src/core/skills/xiaoma-party-mode/steps/step-03-graceful-exit.md

@@ -34,7 +34,7 @@ Provide satisfying agent farewells and conclude the party mode session with grat
 
 Begin exit process with warm acknowledgment:
 
-"What an incredible collaborative session! Thank you {{user_name}} for engaging with our BMAD agent team in this dynamic discussion. Your questions and insights brought out the best in our agents and led to some truly valuable perspectives.
+"What an incredible collaborative session! Thank you {{user_name}} for engaging with our XiaoMa agent team in this dynamic discussion. Your questions and insights brought out the best in our agents and led to some truly valuable perspectives.
 
 **Before we wrap up, let a few of our agents say goodbye...**"
 
@@ -55,7 +55,7 @@ For each selected agent:
 
 "[Icon Emoji] **[Agent Name]**: [Characteristic farewell reflecting their personality, communication style, and role. May reference session highlights, express gratitude, or offer final insights related to their expertise domain.]
 
-[Bash: .claude/hooks/bmad-speak.sh \"[Agent Name]\" \"[Their farewell message]\"]"
+[Bash: .claude/hooks/xiaoma-speak.sh \"[Agent Name]\" \"[Their farewell message]\"]"
 
 **Example Farewells:**
 
@@ -76,7 +76,7 @@ End with enthusiastic and appreciative closure:
 
 "🎊 **Party Mode Session Complete!** 🎊
 
-Thank you for bringing our BMAD agents together in this unique collaborative experience. The diverse perspectives, expert insights, and dynamic interactions we've shared demonstrate the power of multi-agent thinking.
+Thank you for bringing our XiaoMa agents together in this unique collaborative experience. The diverse perspectives, expert insights, and dynamic interactions we've shared demonstrate the power of multi-agent thinking.
 
 **Our agents learned from each other and from you** - that's what makes these collaborative sessions so valuable!
 
@@ -113,7 +113,7 @@ Execute final workflow termination:
 
 "[PARTY MODE WORKFLOW COMPLETE]
 
-Thank you for using BMAD Party Mode for collaborative multi-agent discussions!"
+Thank you for using XiaoMa Party Mode for collaborative multi-agent discussions!"
 
 ## SUCCESS METRICS:
 
@@ -162,6 +162,6 @@ After farewell sequence and final closure:
 - Multi-agent collaboration demonstrated value and effectiveness
 - Workflow ready for next party mode session activation
 
-Congratulations on facilitating a successful multi-agent collaborative discussion through BMAD Party Mode! 🎉
+Congratulations on facilitating a successful multi-agent collaborative discussion through XiaoMa Party Mode! 🎉
 
 The user has experienced the power of bringing diverse expert perspectives together to tackle complex topics through intelligent conversation orchestration and authentic agent interactions.

package/src/core/skills/xiaoma-party-mode/workflow.md

@@ -3,9 +3,9 @@
 
 # Party Mode Workflow
 
-**Goal:** Orchestrates group discussions between all installed BMAD agents, enabling natural multi-agent conversations
+**Goal:** Orchestrates group discussions between all installed XiaoMa agents, enabling natural multi-agent conversations
 
-**Your Role:** You are a party mode facilitator and multi-agent conversation orchestrator. You bring together diverse BMAD agents for collaborative discussions, managing the flow of conversation while maintaining each agent's unique personality and expertise - while still utilizing the configured {communication_language}.
+**Your Role:** You are a party mode facilitator and multi-agent conversation orchestrator. You bring together diverse XiaoMa agents for collaborative discussions, managing the flow of conversation while maintaining each agent's unique personality and expertise - while still utilizing the configured {communication_language}.
 
 ---
 
@@ -74,7 +74,7 @@ Execute party mode activation and conversation orchestration:
 
 "🎉 PARTY MODE ACTIVATED! 🎉
 
-Welcome {{user_name}}! All BMAD agents are here and ready for a dynamic group discussion. I've brought together our complete team of experts, each bringing their unique perspectives and capabilities.
+Welcome {{user_name}}! All XiaoMa agents are here and ready for a dynamic group discussion. I've brought together our complete team of experts, each bringing their unique perspectives and capabilities.
 
 **Let me introduce our collaborating agents:**
 
@@ -178,7 +178,7 @@ If conversation naturally concludes:
 
 **Quality Control:**
 
-- If discussion becomes circular, have bmad-master summarize and redirect
+- If discussion becomes circular, have xiaoma-master summarize and redirect
 - Balance fun and productivity based on conversation tone
 - Ensure all agents stay true to their merged personalities
 - Exit gracefully when user indicates completion

package/src/core/skills/xiaoma-review-adversarial-general/SKILL.md

@@ -3,4 +3,4 @@ name: xiaoma-review-adversarial-general
 description: 'Perform a Cynical Review and produce a findings report. Use when the user requests a critical review of something'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.