Merge cf12697dfb into 9df5720ab3

readme instructions to installer older v4 if necessary
Merge pull request #1476 from jheyworth/fix/installer-peer-deps-comprehensive
2026-01-31 10:21:25 +07:00 · 2026-01-30 14:28:49 -08:00 · 2026-01-30 12:05:34 -06:00 · 2026-01-30 15:37:42 +00:00 · 2026-01-29 01:11:48 -07:00
6 changed files with 683 additions and 677 deletions
--- a/.npmrc
+++ b/.npmrc
@ -1 +1,5 @@
-registry=https://registry.npmjs.org
+# Prevent peer dependency warnings during installation
+legacy-peer-deps=true
+
+# Improve install performance
+prefer-offline=true
--- a/README.md
+++ b/README.md
@ -65,13 +65,13 @@ Every step tells you what's next. Optional phases (brainstorming, research, UX d

 BMad Method extends with official modules for specialized domains. Modules are available during installation and can be added to your project at any time. After the V6 beta period these will also be available as Plugins and Granular Skills.

-| Module                                | GitHub                                                                                                                            | NPM                                                                                                                | Purpose                                                           |
-| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------- |
-| **BMad Method (BMM)**                 | [bmad-code-org/BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD)                                                         | [bmad-method](https://www.npmjs.com/package/bmad-method)                                           | Core framework with 34+ workflows across 4 development phases     |
-| **BMad Builder (BMB)**                | [bmad-code-org/bmad-builder](https://github.com/bmad-code-org/bmad-builder)                                                       | [bmad-builder](https://www.npmjs.com/package/bmad-builder)                                         | Create custom BMad agents, workflows, and domain-specific modules |
-| **Test Architect (TEA)** 🆕           | [bmad-code-org/tea](https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise)                                    | [tea](https://www.npmjs.com/package/bmad-method-test-architecture-enterprise)                      | Risk-based test strategy, automation, and release gates (8 workflows) |
-| **Game Dev Studio (BMGD)**            | [bmad-code-org/bmad-module-game-dev-studio](https://github.com/bmad-code-org/bmad-module-game-dev-studio)                         | [bmad-game-dev-studio](https://www.npmjs.com/package/bmad-game-dev-studio)                         | Game development workflows for Unity, Unreal, and Godot           |
-| **Creative Intelligence Suite (CIS)** | [bmad-code-org/bmad-module-creative-intelligence-suite](https://github.com/bmad-code-org/bmad-module-creative-intelligence-suite) | [bmad-creative-intelligence-suite](https://www.npmjs.com/package/bmad-creative-intelligence-suite) | Innovation, brainstorming, design thinking, and problem-solving   |
+| Module                                | GitHub                                                                                                                            | NPM                                                                                                | Purpose                                                               |
+| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
+| **BMad Method (BMM)**                 | [bmad-code-org/BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD)                                                         | [bmad-method](https://www.npmjs.com/package/bmad-method)                                           | Core framework with 34+ workflows across 4 development phases         |
+| **BMad Builder (BMB)**                | [bmad-code-org/bmad-builder](https://github.com/bmad-code-org/bmad-builder)                                                       | [bmad-builder](https://www.npmjs.com/package/bmad-builder)                                         | Create custom BMad agents, workflows, and domain-specific modules     |
+| **Test Architect (TEA)** 🆕            | [bmad-code-org/tea](https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise)                                    | [tea](https://www.npmjs.com/package/bmad-method-test-architecture-enterprise)                      | Risk-based test strategy, automation, and release gates (8 workflows) |
+| **Game Dev Studio (BMGD)**            | [bmad-code-org/bmad-module-game-dev-studio](https://github.com/bmad-code-org/bmad-module-game-dev-studio)                         | [bmad-game-dev-studio](https://www.npmjs.com/package/bmad-game-dev-studio)                         | Game development workflows for Unity, Unreal, and Godot               |
+| **Creative Intelligence Suite (CIS)** | [bmad-code-org/bmad-module-creative-intelligence-suite](https://github.com/bmad-code-org/bmad-module-creative-intelligence-suite) | [bmad-creative-intelligence-suite](https://www.npmjs.com/package/bmad-creative-intelligence-suite) | Innovation, brainstorming, design thinking, and problem-solving       |

 * More modules are coming in the next 2 weeks from BMad Official, and a community marketplace for the installer also will be coming with the final V6 release!

@ -116,6 +116,7 @@ BMad provides two testing options to fit your needs:
 ### For v4 Users

 - **[v4 Documentation](https://github.com/bmad-code-org/BMAD-METHOD/tree/V4/docs)**
+- If you need to install V4, you can do this with  `npx bmad-method@4.44.3 install` - similar for any past version.

 ## Community

--- a/package-lock.json
+++ b/package-lock.json
--- a/package.json
+++ b/package.json
@ -88,7 +88,7 @@
  },
  "devDependencies": {
    "@astrojs/sitemap": "^3.6.0",
-    "@astrojs/starlight": "^0.37.0",
+    "@astrojs/starlight": "^0.37.5",
    "@eslint/js": "^9.33.0",
    "archiver": "^7.0.1",
    "astro": "^5.16.0",
@ -99,7 +99,7 @@
    "eslint-plugin-unicorn": "^60.0.0",
    "eslint-plugin-yml": "^1.18.0",
    "husky": "^9.1.7",
-    "jest": "^30.0.4",
+    "jest": "^30.2.0",
    "lint-staged": "^16.1.1",
    "markdownlint-cli2": "^0.19.1",
    "prettier": "^3.7.4",
--- a/src/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-04-review.md
+++ b/src/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-04-review.md
@ -31,19 +31,25 @@ wipFile: '{implementation_artifacts}/tech-spec-wip.md'

 **Present to user:**

-"Here's your complete tech-spec. Please review:"
+<output-block>
+Here's your complete tech-spec. Please review:
+</output-block>

 [Display the complete spec content - all sections]

-"**Quick Summary:**
+<output-block>
+**Quick Summary:**

 - {task_count} tasks to implement
 - {ac_count} acceptance criteria to verify
- {files_count} files to modify"
+- {files_count} files to modify
+</output-block>

 **Present review menu:**

-Display: "**Select:** [C] Continue [E] Edit [Q] Questions [A] Advanced Elicitation [P] Party Mode"
+<output-block>
+**Select:** [C] Continue [E] Edit [Q] Questions [A] Advanced Elicitation [P] Party Mode
+</output-block>

 **HALT and wait for user selection.**

@ -173,7 +179,8 @@ b) **HALT and wait for user selection.**

 **When user selects [D]:**

-"**All done!** Your tech-spec is ready at:
+<output-block>
+**All done!** Your tech-spec is ready at:

 `{finalFile}`

@ -183,7 +190,8 @@ When you're ready to implement, run:
 quick-dev {finalFile}
 ```

-Ship it!"
+Ship it!
+</output-block>

 ---

--- a/tools/cli/installers/lib/modules/manager.js
+++ b/tools/cli/installers/lib/modules/manager.js
@ -416,7 +416,7 @@ class ModuleManager {
      if (needsDependencyInstall || wasNewClone || nodeModulesMissing) {
        const installSpinner = ora(`Installing dependencies for ${moduleInfo.name}...`).start();
        try {
-          execSync('npm install --production --no-audit --no-fund --prefer-offline --no-progress', {
+          execSync('npm install --production --no-audit --no-fund --prefer-offline --no-progress --legacy-peer-deps', {
            cwd: moduleCacheDir,
            stdio: 'pipe',
            timeout: 120_000, // 2 minute timeout
@ -441,7 +441,7 @@ class ModuleManager {
        if (packageJsonNewer) {
          const installSpinner = ora(`Installing dependencies for ${moduleInfo.name}...`).start();
          try {
-            execSync('npm install --production --no-audit --no-fund --prefer-offline --no-progress', {
+            execSync('npm install --production --no-audit --no-fund --prefer-offline --no-progress --legacy-peer-deps', {
              cwd: moduleCacheDir,
              stdio: 'pipe',
              timeout: 120_000, // 2 minute timeout
Author	SHA1	Message	Date
Alex Verkhovsky	1e85bfeded	Merge `cf12697dfb` into `9df5720ab3`	2026-01-31 10:21:25 +07:00
Brian Madison	9df5720ab3	readme instructions to installer older v4 if necessary	2026-01-30 14:28:49 -08:00
Murat K Ozcan	1c13305f9f	Merge pull request #1476 from jheyworth/fix/installer-peer-deps-comprehensive fix: resolve npm install peer dependency issues	2026-01-30 12:05:34 -06:00
jheyworth	6198add5bd	fix: resolve npm install peer dependency issues Comprehensive fix for installer failures related to Astro/Starlight peer dependencies: 1. Update @astrojs/starlight from 0.37.0 to 0.37.5 (latest stable) 2. Add .npmrc with legacy-peer-deps to prevent peer dependency warnings 3. Update module installer to use --legacy-peer-deps flag for external modules This resolves issues where: - npm shows peer dependency warnings that users interpret as failures - External module installations fail due to strict peer dependency checking - Different npm versions handle peer dependencies inconsistently Technical note: Starlight 0.37.x requires astro@^5.5.0, which is compatible with astro@5.16.0 (^5.5.0 means >=5.5.0 <6.0.0). The issue was npm's warning display, not actual incompatibility. Fixes: Installation errors reported in v6.0.0-Beta.2 Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>	2026-01-30 15:37:42 +00:00
Alex Verkhovsky	cf12697dfb	fix: replace quote delimiters with output-block tags in step-04-review Double-quote delimiters around multi-line output template blocks are visually ambiguous to humans (opening quote on one line, closing quote many lines later) and confuse linters and LLM code reviewers into filing false issues (see #1434). A/B tested across 5 models (Opus, Sonnet, Haiku, Codex 5.2, Gemini): removing quotes entirely causes Haiku to refuse instructions in 1/3 runs, but any explicit block delimiter works equally well. XML-style output-block tags are the best fit: visually obvious boundaries, self-documenting, linter-clean, and consistent with existing BMAD XML tag conventions (step, action, check, template-output). Relates to #1433	2026-01-29 01:11:48 -07:00