@zeyue0329/xiaoma-cli 1.7.0 → 1.8.1

package/.idea/XiaoMa-Cli.iml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="JAVA_MODULE" version="4">
+  <component name="NewModuleRootManager" inherit-compiler-output="true">
+    <exclude-output />
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

package/.idea/misc.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectRootManager" version="2" languageLevel="JDK_24" default="true" project-jdk-name="24" project-jdk-type="JavaSDK">
+    <output url="file://$PROJECT_DIR$/out" />
+  </component>
+</project>

package/.idea/modules.xml

@@ -2,7 +2,7 @@
 <project version="4">
   <component name="ProjectModuleManager">
     <modules>
-      <module fileurl="file://$PROJECT_DIR$/XiaoMa-Cli.iml" filepath="$PROJECT_DIR$/XiaoMa-Cli.iml" />
+      <module fileurl="file://$PROJECT_DIR$/.idea/XiaoMa-Cli.iml" filepath="$PROJECT_DIR$/.idea/XiaoMa-Cli.iml" />
     </modules>
   </component>
 </project>

package/CLAUDE.md

@@ -0,0 +1,93 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+XiaoMa-CLI (`@zeyue0329/xiaoma-cli`) is an AI-driven agile development framework/CLI tool. It installs specialized AI agent personas, workflows, and skills into a user's project directory for use with AI IDEs (Claude Code, Cursor, etc.). Node.js v20+ required.
+
+## Common Commands
+
+```bash
+# Quality gate (run before commits)
+npm run quality
+
+# Individual checks
+npm run test:schemas        # Agent YAML schema validation (Zod-based)
+npm run test:install        # Installation component tests
+npm run test:refs           # Cross-file reference validation
+npm run validate:schemas    # Schema validation (separate from test)
+npm run validate:refs       # File reference validation (strict mode)
+npm run lint                # ESLint (JS + YAML), zero warnings allowed
+npm run lint:md             # Markdown linting
+npm run format:check        # Prettier check
+npm run format:fix          # Prettier auto-fix
+
+# Test coverage
+npm run test:coverage       # c8 coverage report for schema tests
+
+# Run the CLI locally
+npm run install:xiaoma      # Run install command
+npm run xiaoma:uninstall    # Run uninstall command
+```
+
+The full `npm test` runs: test:schemas → test:refs → test:install → validate:schemas → lint → lint:md → format:check.
+
+## Architecture
+
+### Two-Layer Structure
+
+1. **`src/`** — Content modules (YAML agents, Markdown workflows, skills)
+2. **`tools/`** — CLI implementation (Node.js/CommonJS, installer, validators)
+
+### Module System
+
+Modules are defined by `module.yaml` files with configuration variables, prompts, and directory declarations:
+- **`src/core/`** — Shared skills and tasks (module code: `core`)
+- **`src/xmc/`** — XiaoMa Method module, the primary agile framework (module code: `xmc`)
+
+### Agent System (`src/xmc/agents/`)
+
+Agents are YAML files validated against a Zod schema (`tools/schema/`). Each agent defines:
+- `metadata` — id, name, title, icon, module, capabilities
+- `persona` — role, identity, communication_style, principles
+- `menu` — trigger commands pointing to workflow exec targets
+- `prompts` / `critical_actions` — optional
+
+### Workflow System (`src/xmc/workflows/`)
+
+Organized by development phase:
+- `1-analysis/` — Brainstorming, research, product brief
+- `2-plan-workflows/` — PRD creation/validation, UX design
+- `3-solutioning/` — Architecture, epics/stories, implementation readiness
+- `4-implementation/` — Sprint planning, story execution, code review, retros
+
+Each workflow has: `workflow.md` (entry point with metadata), `steps/` or `steps-{variant}/` directories, and optional `templates/` and `data/` directories.
+
+### CLI (`tools/cli/`)
+
+- **Entry**: `xiaoma-cli.js` (Commander.js) → wrapped by `xiaoma-npx-wrapper.js`
+- **Commands**: `install`, `status`, `uninstall`
+- **Installer** (`tools/cli/installers/`): Core orchestration class (~8K LOC), module manager, IDE config manager, manifest generator
+- **UI**: `@clack/prompts` for interactive terminal prompts
+
+### Skills (`src/core/skills/`)
+
+Reusable capabilities: `xiaoma-help`, `xiaoma-brainstorming`, `xiaoma-distillator`, `xiaoma-party-mode`, editorial review skills, etc.
+
+## Code Conventions
+
+- **JS**: CommonJS (`require`/`module.exports`) for all CLI/tool code
+- **YAML**: `.yaml` extension enforced by ESLint (not `.yml`); double quotes preferred
+- **Formatting**: Prettier with 140 char print width, 2-space indent, double quotes in YAML, single quotes in JS
+- **Linting**: ESLint flat config with unicorn, node, yml plugins; `--max-warnings=0`
+- **Schema validation**: Zod for agent YAML validation at `tools/schema/`
+- **Git hooks**: Husky + lint-staged (runs lint:fix and format:fix on staged files)
+
+## Testing
+
+Tests are plain Node.js scripts (no test framework), located in `test/`:
+- `test-agent-schema.js` — Validates all agent YAML against Zod schema; 50 fixtures (18 valid, 32 invalid); targets 100% coverage
+- `test-installation-components.js` — Installation flow verification
+- `test-file-refs-csv.js` — Validates cross-file references in CSV data files
+- Fixtures in `test/fixtures/agent-schema/{valid,invalid}/`

package/README.md

@@ -1,34 +1,34 @@
-![BMad Method](banner-bmad-method.png)
+![XiaoMa Method](banner-xiaoma-cli.png)
 
-[![Version](https://img.shields.io/npm/v/bmad-method?color=blue&label=version)](https://www.npmjs.com/package/bmad-method)
+[![Version](https://img.shields.io/npm/v/xiaoma-cli?color=blue&label=version)](https://www.npmjs.com/package/xiaoma-cli)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![Node.js Version](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen)](https://nodejs.org)
 [![Discord](https://img.shields.io/badge/Discord-Join%20Community-7289da?logo=discord&logoColor=white)](https://discord.gg/gk8jAdXWmj)
 
-**Build More Architect Dreams** — An AI-driven agile development module for the BMad Method Module Ecosystem, the best and most comprehensive Agile AI Driven Development framework that has true scale-adaptive intelligence that adjusts from bug fixes to enterprise systems.
+**Build More Architect Dreams** — An AI-driven agile development module for the XiaoMa Method Module Ecosystem, the best and most comprehensive Agile AI Driven Development framework that has true scale-adaptive intelligence that adjusts from bug fixes to enterprise systems.
 
 **100% free and open source.** No paywalls. No gated content. No gated Discord. We believe in empowering everyone, not just those who can pay for a gated community or courses.
 
-## Why the BMad Method?
+## Why the XiaoMa Method?
 
-Traditional AI tools do the thinking for you, producing average results. BMad agents and facilitated workflows act as expert collaborators who guide you through a structured process to bring out your best thinking in partnership with the AI.
+Traditional AI tools do the thinking for you, producing average results. XiaoMa agents and facilitated workflows act as expert collaborators who guide you through a structured process to bring out your best thinking in partnership with the AI.
 
-- **AI Intelligent Help** — Invoke the `bmad-help` skill anytime for guidance on what's next
+- **AI Intelligent Help** — Invoke the `xiaoma-help` skill anytime for guidance on what's next
 - **Scale-Domain-Adaptive** — Automatically adjusts planning depth based on project complexity
 - **Structured Workflows** — Grounded in agile best practices across analysis, planning, architecture, and implementation
 - **Specialized Agents** — 12+ domain experts (PM, Architect, Developer, UX, Scrum Master, and more)
 - **Party Mode** — Bring multiple agent personas into one session to collaborate and discuss
 - **Complete Lifecycle** — From brainstorming to deployment
 
-[Learn more at **docs.bmad-method.org**](https://docs.bmad-method.org)
+[Learn more at **docs.xiaoma-cli.org**](https://docs.xiaoma-cli.org)
 
 ---
 
-## 🚀 What's Next for BMad?
+## 🚀 What's Next for XiaoMa?
 
-**V6 is here and we're just getting started!** The BMad Method is evolving rapidly with optimizations including Cross Platform Agent Team and Sub Agent inclusion, Skills Architecture, BMad Builder v1, Dev Loop Automation, and so much more in the works.
+**V6 is here and we're just getting started!** The XiaoMa Method is evolving rapidly with optimizations including Cross Platform Agent Team and Sub Agent inclusion, Skills Architecture, XiaoMa Builder v1, Dev Loop Automation, and so much more in the works.
 
-**[📍 Check out the complete Roadmap →](https://docs.bmad-method.org/roadmap/)**
+**[📍 Check out the complete Roadmap →](https://docs.xiaoma-cli.org/roadmap/)**
 
 ---
 
@@ -37,58 +37,58 @@ Traditional AI tools do the thinking for you, producing average results. BMad ag
 **Prerequisites**: [Node.js](https://nodejs.org) v20+
 
 ```bash
-npx bmad-method install
+npx xiaoma-cli install
 ```
 
-> Want the newest prerelease build? Use `npx bmad-method@next install`. Expect higher churn than the default install.
+> Want the newest prerelease build? Use `npx xiaoma-cli@next install`. Expect higher churn than the default install.
 
 Follow the installer prompts, then open your AI IDE (Claude Code, Cursor, etc.) in your project folder.
 
 **Non-Interactive Installation** (for CI/CD):
 
 ```bash
-npx bmad-method install --directory /path/to/project --modules bmm --tools claude-code --yes
+npx xiaoma-cli install --directory /path/to/project --modules xmc --tools claude-code --yes
 ```
 
-[See all installation options](https://docs.bmad-method.org/how-to/non-interactive-installation/)
+[See all installation options](https://docs.xiaoma-cli.org/how-to/non-interactive-installation/)
 
-> **Not sure what to do?** Ask `bmad-help` — it tells you exactly what's next and what's optional. You can also ask questions like `bmad-help I just finished the architecture, what do I do next?`
+> **Not sure what to do?** Ask `xiaoma-help` — it tells you exactly what's next and what's optional. You can also ask questions like `xiaoma-help I just finished the architecture, what do I do next?`
 
 ## Modules
 
-BMad Method extends with official modules for specialized domains. Available during installation or anytime after.
+XiaoMa Method extends with official modules for specialized domains. Available during installation or anytime after.
 
 | Module                                                                                                            | Purpose                                           |
 | ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- |
-| **[BMad Method (BMM)](https://github.com/bmad-code-org/BMAD-METHOD)**                                             | Core framework with 34+ workflows                 |
-| **[BMad Builder (BMB)](https://github.com/bmad-code-org/bmad-builder)**                                           | Create custom BMad agents and workflows           |
-| **[Test Architect (TEA)](https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise)**             | Risk-based test strategy and automation           |
-| **[Game Dev Studio (BMGD)](https://github.com/bmad-code-org/bmad-module-game-dev-studio)**                        | Game development workflows (Unity, Unreal, Godot) |
-| **[Creative Intelligence Suite (CIS)](https://github.com/bmad-code-org/bmad-module-creative-intelligence-suite)** | Innovation, brainstorming, design thinking        |
+| **[XiaoMa Method (BMM)](https://github.com/zqyl-xiaoma/XiaoMa-CLI)**                                             | Core framework with 34+ workflows                 |
+| **[XiaoMa Builder (BMB)](https://github.com/zqyl-xiaoma/xiaoma-builder)**                                           | Create custom XiaoMa agents and workflows           |
+| **[Test Architect (TEA)](https://github.com/zqyl-xiaoma/xiaoma-cli-test-architecture-enterprise)**             | Risk-based test strategy and automation           |
+| **[Game Dev Studio (BMGD)](https://github.com/zqyl-xiaoma/xiaoma-module-game-dev-studio)**                        | Game development workflows (Unity, Unreal, Godot) |
+| **[Creative Intelligence Suite (CIS)](https://github.com/zqyl-xiaoma/xiaoma-module-creative-intelligence-suite)** | Innovation, brainstorming, design thinking        |
 
 ## Documentation
 
-[BMad Method Docs Site](https://docs.bmad-method.org) — Tutorials, guides, concepts, and reference
+[XiaoMa Method Docs Site](https://docs.xiaoma-cli.org) — Tutorials, guides, concepts, and reference
 
 **Quick links:**
-- [Getting Started Tutorial](https://docs.bmad-method.org/tutorials/getting-started/)
-- [Upgrading from Previous Versions](https://docs.bmad-method.org/how-to/upgrade-to-v6/)
-- [Test Architect Documentation](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/)
+- [Getting Started Tutorial](https://docs.xiaoma-cli.org/tutorials/getting-started/)
+- [Upgrading from Previous Versions](https://docs.xiaoma-cli.org/how-to/upgrade-to-v6/)
+- [Test Architect Documentation](https://zqyl-xiaoma.github.io/xiaoma-cli-test-architecture-enterprise/)
 
 
 ## Community
 
 - [Discord](https://discord.gg/gk8jAdXWmj) — Get help, share ideas, collaborate
-- [Subscribe on YouTube](https://www.youtube.com/@BMadCode) — Tutorials, master class, and podcast (launching Feb 2025)
-- [GitHub Issues](https://github.com/bmad-code-org/BMAD-METHOD/issues) — Bug reports and feature requests
-- [Discussions](https://github.com/bmad-code-org/BMAD-METHOD/discussions) — Community conversations
+- [Subscribe on YouTube](https://www.youtube.com/@XiaoMaCode) — Tutorials, master class, and podcast (launching Feb 2025)
+- [GitHub Issues](https://github.com/zqyl-xiaoma/XiaoMa-CLI/issues) — Bug reports and feature requests
+- [Discussions](https://github.com/zqyl-xiaoma/XiaoMa-CLI/discussions) — Community conversations
 
-## Support BMad
+## Support XiaoMa
 
-BMad is free for everyone — and always will be. If you'd like to support development:
+XiaoMa is free for everyone — and always will be. If you'd like to support development:
 
 - ⭐ Please click the star project icon near the top right of this page
-- ☕ [Buy Me a Coffee](https://buymeacoffee.com/bmad) — Fuel the development
+- ☕ [Buy Me a Coffee](https://buymeacoffee.com/xiaoma) — Fuel the development
 - 🏢 Corporate sponsorship — DM on Discord
 - 🎤 Speaking & Media — Available for conferences, podcasts, interviews (BM on Discord)
 
@@ -102,8 +102,8 @@ MIT License — see [LICENSE](LICENSE) for details.
 
 ---
 
-**BMad** and **BMAD-METHOD** are trademarks of BMad Code, LLC. See [TRADEMARK.md](TRADEMARK.md) for details.
+**XiaoMa** and **XiaoMa-CLI** are trademarks of XiaoMa Code, LLC. See [TRADEMARK.md](TRADEMARK.md) for details.
 
-[![Contributors](https://contrib.rocks/image?repo=bmad-code-org/BMAD-METHOD)](https://github.com/bmad-code-org/BMAD-METHOD/graphs/contributors)
+[![Contributors](https://contrib.rocks/image?repo=zqyl-xiaoma/XiaoMa-CLI)](https://github.com/zqyl-xiaoma/XiaoMa-CLI/graphs/contributors)
 
 See [CONTRIBUTORS.md](CONTRIBUTORS.md) for contributor information.

package/TECH-STACK.md

@@ -0,0 +1,62 @@
+# XiaoMa-CLI 技术栈清单
+
+## 运行环境
+
+| 技术 | 版本 | 用途 |
+|---|---|---|
+| Node.js | >= 20.0.0 | 运行环境 |
+| npm | - | 包管理 |
+
+## 运行时依赖
+
+| 库 | 用途 |
+|---|---|
+| **commander** | CLI 命令行参数解析 |
+| **@clack/prompts** + **@clack/core** | 交互式终端提示 UI |
+| **chalk** | 终端颜色输出 |
+| **picocolors** | 轻量终端颜色（配合 clack） |
+| **ora** | 终端 loading 动画 |
+| **zod** | YAML schema 运行时校验 |
+| **yaml** + **js-yaml** | YAML 解析（两个库并存） |
+| **csv-parse** | CSV 文件解析 |
+| **xml2js** | XML 解析 |
+| **glob** | 文件路径模式匹配 |
+| **fs-extra** | 增强的文件系统操作 |
+| **semver** | 语义化版本号比较 |
+| **ignore** | .gitignore 风格的文件过滤 |
+| **@kayvan/markdown-tree-parser** | Markdown 结构解析 |
+
+## 开发依赖
+
+| 库 | 用途 |
+|---|---|
+| **eslint** (v9, flat config) | JS/YAML 代码检查 |
+| **eslint-plugin-n** | Node.js 规则 |
+| **eslint-plugin-unicorn** | 现代 JS 最佳实践 |
+| **eslint-plugin-yml** | YAML 文件检查 |
+| **yaml-eslint-parser** | YAML ESLint 解析器 |
+| **prettier** | 代码格式化 |
+| **prettier-plugin-packagejson** | package.json 排序格式化 |
+| **eslint-config-prettier** | ESLint/Prettier 冲突处理 |
+| **markdownlint-cli2** | Markdown 检查 |
+| **yaml-lint** | YAML 语法检查 |
+| **jest** (v30) | 测试框架（已引入，当前测试为纯 Node 脚本） |
+| **c8** | 代码覆盖率（Istanbul 兼容） |
+| **husky** | Git hooks 管理 |
+| **lint-staged** | 暂存文件自动检查 |
+
+## 内容/配置格式
+
+| 格式 | 用途 |
+|---|---|
+| **YAML** | Agent 定义、模块配置、CI/CD |
+| **Markdown** | 工作流步骤、模板、文档 |
+| **CSV** | 数据文件、交叉引用 |
+| **JSON** | 包配置、IDE 配置输出 |
+
+## CI/CD
+
+| 技术 | 用途 |
+|---|---|
+| **GitHub Actions** | 质量门禁 + 发布自动化 |
+| **npm publish** | 包发布（public scope） |

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@zeyue0329/xiaoma-cli",
-  "version": "1.7.0",
+  "version": "1.8.1",
   "description": "XiaoMa Universal AI Agent Framework",
   "keywords": [
     "agile",
@@ -24,11 +24,6 @@
     "xiaoma-cli": "tools/xiaoma-npx-wrapper.js"
   },
   "scripts": {
-    "docs:build": "node tools/build-docs.mjs",
-    "docs:dev": "astro dev --root website",
-    "docs:fix-links": "node tools/fix-doc-links.js",
-    "docs:preview": "astro preview --root website",
-    "docs:validate-links": "node tools/validate-doc-links.js",
     "flatten": "node tools/flattener/main.js",
     "format:check": "prettier --check \"**/*.{js,cjs,mjs,json,yaml}\"",
     "format:fix": "prettier --write \"**/*.{js,cjs,mjs,json,yaml}\"",
@@ -38,7 +33,7 @@
     "lint:fix": "eslint . --ext .js,.cjs,.mjs,.yaml --fix",
     "lint:md": "markdownlint-cli2 \"**/*.md\"",
     "prepare": "command -v husky >/dev/null 2>&1 && husky || exit 0",
-    "quality": "npm run format:check && npm run lint && npm run lint:md && npm run docs:build && npm run validate:schemas && npm run test:schemas && npm run test:install && npm run validate:refs",
+    "quality": "npm run format:check && npm run lint && npm run lint:md && npm run validate:schemas && npm run test:schemas && npm run test:install && npm run validate:refs",
     "rebundle": "node tools/cli/bundlers/bundle-web.js rebundle",
     "test": "npm run test:schemas && npm run test:refs && npm run test:install && npm run validate:schemas && npm run lint && npm run lint:md && npm run format:check",
     "test:coverage": "c8 --reporter=text --reporter=html npm run test:schemas",
@@ -82,7 +77,7 @@
     "semver": "^7.6.3",
     "xml2js": "^0.6.2",
     "yaml": "^2.7.0",
-    "zod": "^4.3.6"
+    "zod": "^3.23.0"
   },
   "devDependencies": {
     "@eslint/js": "^9.33.0",