Merge 1d1a73b5a3 into c3b7e98241

CHANGELOG.md

@@ -1,158 +1,5 @@
 # Changelog
 
-## [6.0.0-alpha.23]
-
-**Release: January 11, 2026**
-
-### 🌟 Key Highlights
-
-1. **Astro/Starlight Documentation Platform**: Complete migration from Docusaurus to modern Astro+Starlight for superior performance and customization
-2. **Diataxis Framework Implementation**: Professional documentation restructuring with tutorials, how-to guides, explanations, and references
-3. **Workflow Creator & Validator**: Powerful new tools for workflow creation with subprocess support and PRD validation
-4. **TEA Documentation Expansion**: Comprehensive testing documentation with cheat sheets, MCP enhancements, and API testing patterns
-5. **Brainstorming Revolution**: Research-backed procedural rigor with 100+ idea goal and anti-bias protocols
-6. **Cursor IDE Modernization**: Refactored from rules-based to command-based architecture for better IDE integration
-
-### 📚 Documentation Platform Revolution
-
-**Astro/Starlight Migration:**
-
-- **From Docusaurus to Astro**: Complete platform migration for improved performance, better customization, and modern tooling
-- **Starlight Theme**: Professional documentation theme with dark mode default and responsive design
-- **Build Pipeline Overhaul**: New build-docs.js orchestrates link checking, artifact generation, and Astro build
-- **LLM-Friendly Documentation**: Generated llms.txt and llms-full.txt for AI agent discoverability
-- **Downloadable Source Bundles**: bmad-sources.zip and bmad-prompts.zip for offline use
-
-**Diataxis Framework Implementation:**
-
-- **Four Content Types**: Professional separation into tutorials, how-to guides, explanations, and references
-- **21 Files Migrated**: Phase 1 migration of core documentation to Diataxis structure
-- **42+ Focused Documents**: Phase 2 split of large legacy files into manageable pieces
-- **FAQ Restructuring**: 7 topic-specific FAQ files with standardized format
-- **Tutorial Style Guide**: Comprehensive documentation standards for consistent content creation
-
-**Link Management & Quality:**
-
-- **Site-Relative Links**: Converted 217 links to repo-relative format (/docs/path/file.md)
-- **Link Validation Tools**: New validate-doc-links.js and fix-doc-links.js for maintaining link integrity
-- **Broken Link Fixes**: Resolved ~50 broken internal links across documentation
-- **BMad Acronym Standardization**: Consistent use of "BMad" (Breakthrough Method of Agile AI Driven Development)
-- **SEO Optimization**: Absolute URLs in AI meta tags for better web crawler discoverability
-
-### 🔧 Workflow Creator & Validator (Major Feature)
-
-**Workflow Creation Tool:**
-
-- **Subprocess Support**: Advanced workflows can now spawn subprocesses for complex operations
-- **PRD Validation Step**: New validation step ensures PRD quality before workflow execution
-- **Trimodal Workflow Creation**: Three-mode workflow generation system
-- **Quadrivariate Module Workflow**: Four-variable workflow architecture for enhanced flexibility
-- **Path Violation Checks**: Validator ensures workflows don't violate path constraints
-- **Max Parallel Mode POC**: Proof-of-concept for parallel workflow validation
-
-**Workflow Quality Improvements:**
-
-- **PRD Trimodal Compliance**: PRD workflow now follows trimodal standards
-- **Standardized Step Formatting**: Consistent markdown formatting across workflow and PRD steps
-- **Better Suggested Next Steps**: Improved workflow completion guidance
-- **Variable Naming Standardization**: {project_root} → {project-root} across all workflows
-
-### 🧪 TEA Documentation Expansion
-
-**Comprehensive Testing Guides:**
-
-- **Cheat Sheets**: Quick reference guides for common testing scenarios
-- **MCP Enhancements**: Model Context Protocol improvements for testing workflows
-- **API Testing Patterns**: Best practices for API testing documentation
-- **Design Philosophy Callout**: Clear explanation of TEA's design principles
-- **Context Engineering Glossary**: New glossary entry defining context engineering concepts
-- **Fragment Count Updates**: Accurate documentation of TEA workflow components
-- **Playwright Utils Examples**: Updated code examples for playwright-utils integration
-
-### 💡 Brainstorming Workflow Overhaul
-
-**Research-Backed Procedural Rigor:**
-
-- **100+ Idea Goal**: Emphasis on quantity-first approach to unlock better quality ideas
-- **Anti-Bias Protocol**: Domain pivot every 10 ideas to reduce cognitive biases
-- **Chain-of-Thought Requirements**: Reasoning before idea generation
-- **Simulated Temperature**: Prompts for higher divergence in ideation
-- **Standardized Idea Format**: Quality control template for consistent output
-- **Energy Checkpoints**: Multiple continuation options to maintain creative flow
-
-**Exploration Menu Improvements:**
-
-- **Letter-Based Navigation**: [K/T/A/B/C] options instead of numbers for clarity
-- **Keep/Try/Advanced/Break/Continue**: Clear action options for idea refinement
-- **Universal Facilitation Rules**: Consistent guidelines across all brainstorming steps
-- **Quality Growth Enforcement**: Balance between quantity and quality metrics
-
-### 🖥️ Cursor IDE Modernization
-
-**Command-Based Architecture:**
-
-- **From Rules to Commands**: Complete refactor from rules-based to command-based system
-- **Command Generation**: Automatic generation of task and tool commands
-- **Commands Directory**: New `.cursor/commands/bmad/` structure for generated commands
-- **Cleanup Integration**: Automatic cleanup of old BMAD commands alongside rules
-- **Enhanced Logging**: Better feedback on agents, tasks, tools, and workflow commands generated
-
-### 🤖 Agent System Improvements
-
-**Agent Builder & Validation:**
-
-- **hasSidecar Field**: All agents now indicate sidecar support (true/false)
-- **Validation Enforcement**: hasSidecar now required in agent validation
-- **Better Brownfield Documentation**: Improved brownfield project documentation
-- **Agent Builder Updates**: Agent builder now uses hasSidecar field
-- **Agent Editor Integration**: Editor workflow respects hasSidecar configuration
-
-### 🐛 Bug Fixes & Quality Improvements
-
-**Critical Fixes:**
-
-- **Windows Line Endings**: Resolved CRLF issues causing cross-platform problems
-- **Code-Review File Filtering**: Fixed code-review picking up non-application files
-- **ERR_REQUIRE_ESM Resolution**: Dynamic import for inquirer v9+ compatibility
-- **Project-Context Conflicts**: Allow full project-context usage with conflict precedence
-- **Workflow Paths**: Fixed paths for workflow and sprint status files
-- **Missing Scripts**: Fixed missing scripts from installation
-
-**Workflow & Variable Fixes:**
-
-- **Variable Naming**: Standardized from {project_root} to {project-root} across CIS, BMGD, and BMM modules
-- **Workflow References**: Fixed broken .yaml → .md workflow references
-- **Advanced Elicitation Variables**: Fixed undefined variables in brainstorming
-- **Dependency Format**: Corrected dependency format and added missing frontmatter
-
-**Code Quality:**
-
-- **Dependency Updates**: Bumped qs from 6.14.0 to 6.14.1
-- **CodeRabbit Integration**: Enabled auto-review on new PRs
-- **TEA Fragment Counts**: Updated fragment counts for accuracy
-- **Documentation Links**: Fixed Discord channel references (#general-dev → #bmad-development)
-
-### 🚀 Installation & CLI Improvements
-
-**Installation Enhancements:**
-
-- **Workflow Exclusion**: Ability to exclude workflows from being added as commands
-- **Example Workflow Protection**: Example workflow in workflow builder now excluded from tools
-- **CNAME Configuration**: Added CNAME file for custom domain support
-- **Script Fixes**: All scripts now properly included in installation
-
-### 📊 Statistics
-
-- **27 commits** since alpha.22
-- **217 documentation links** converted to site-relative format
-- **42+ focused documents** created from large legacy files
-- **7 topic-specific FAQ files** with standardized formatting
-- **Complete documentation platform** migrated from Docusaurus to Astro/Starlight
-- **Major workflow tools** added: Creator, Validator with subprocess support
-- **Brainstorming workflow** overhauled with research-backed rigor
-
----
-
 ## [6.0.0-alpha.22]
 
 **Release: December 31, 2025**

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "bmad-method",
-  "version": "6.0.0-alpha.23",
+  "version": "6.0.0-alpha.22",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "bmad-method",
-      "version": "6.0.0-alpha.23",
+      "version": "6.0.0-alpha.22",
       "license": "MIT",
       "dependencies": {
         "@kayvan/markdown-tree-parser": "^1.6.1",
@@ -47,7 +47,7 @@
         "jest": "^30.0.4",
         "lint-staged": "^16.1.1",
         "markdownlint-cli2": "^0.19.1",
-        "prettier": "^3.7.4",
+        "prettier": "^3.5.3",
         "prettier-plugin-packagejson": "^2.5.19",
         "sharp": "^0.33.5",
         "yaml-eslint-parser": "^1.2.3",

package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "bmad-method",
-  "version": "6.0.0-alpha.23",
+  "version": "6.0.0-alpha.22",
   "description": "Breakthrough Method of Agile AI-driven Development",
   "keywords": [
     "agile",
@@ -101,7 +101,7 @@
     "jest": "^30.0.4",
     "lint-staged": "^16.1.1",
     "markdownlint-cli2": "^0.19.1",
-    "prettier": "^3.7.4",
+    "prettier": "^3.5.3",
     "prettier-plugin-packagejson": "^2.5.19",
     "sharp": "^0.33.5",
     "yaml-eslint-parser": "^1.2.3",

src/modules/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-04-review.md

@@ -39,27 +39,9 @@ wipFile: '{implementation_artifacts}/tech-spec-wip.md'
 
 - {task_count} tasks to implement
 - {ac_count} acceptance criteria to verify
-- {files_count} files to modify"
+- {files_count} files to modify
 
-**Present review menu:**
+Does this capture your intent? Any changes needed?"
-
-```
-[y] Approve - finalize the spec
-[c] Changes - request modifications
-[q] Questions - ask about any section
-[a] Advanced Elicitation - dig deeper before approving
-[p] Party Mode - get expert feedback before approving
-```
-
-**HALT and wait for user selection.**
-
-#### Menu Handling:
-
-- **[y]**: Proceed to Section 3 (Finalize the Spec)
-- **[c]**: Proceed to Section 2 (Handle Review Feedback), then return here and redisplay menu
-- **[q]**: Answer questions, then redisplay this menu
-- **[a]**: Load and execute `{advanced_elicitation}`, then return here and redisplay menu
-- **[p]**: Load and execute `{party_mode_exec}`, then return here and redisplay menu
 
 ### 2. Handle Review Feedback
 

src/modules/cis/module.yaml

@@ -4,7 +4,6 @@ header: "Creative Innovation Suite (CIS) Module"
 subheader: "No custom configuration required - uses Core settings only"
 default_selected: false # This module will not be selected by default for new installations
 
-
 # Variables from Core Config inserted:
 ## user_name
 ## communication_language

tools/cli/installers/install-messages.yaml

@@ -6,24 +6,28 @@
 startMessage: |
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-  ⭐ IMPORTANT: Version Alpha.23 Changes
+  If you are looking for Version 4 of BMad Method, please note that you can
+  still install it by using the command `npx bmad-method@latest install`, until v6 reaches beta.
 
-  If your current version is older than Alpha.21, you'll need a fresh install:
+  IMPORTANT Changes with Version Alpha.22 - PLEASE READ THIS if upgrading from earlier Alpha Versions:
-    - Remove .bmad folder and reinstall
-    - Only needed during final push to beta (ETA January 18th)
 
-  📚 New Docs Site: http://docs.bmad-method.org/
+  1. The BMad Core default output folder has changed from `docs` to `_bmad-output`. `docs`
-    - Tons of guides and articles coming soon!
+  is meant for long-term artifacts, which you can always decide to move content to.
-    - Everything is free. No paywalls. No gated content.
-    - Knowledge should be shared, not sold.
 
-  📺 YouTube Master Class & Podcast launching February 1st!
+  2. If utilizing the BMad Method Module (BMM) please be aware of the following important recent changes:
 
-  💡 Love BMad? Please star us on GitHub & subscribe on YouTube!
+  - Phases 1-3 (Analysis, Planning, Solutioning) will now default output to _bmad-output/planning-artifacts
-    - GitHub: https://github.com/bmad-code-org/BMAD-METHOD/
+  - Phase 4 (Implementation) will now default output to _bmad-output/implementation-artifacts
-    - YouTube: https://www.youtube.com/@BMadCode
+  - Long term project knowledge (research, docs, references, document-project output) will now default to docs/
 
-  Latest updates: https://github.com/bmad-code-org/BMAD-METHOD/blob/main/CHANGELOG.md
+  IT IS STRONGLY SUGGESTED to align with these folder conventions instead of dumping all to docs/ - if you are upgrading from a prior
+  version where all output was going to docs or docs/sprint-artifacts, it is suggested to reset configs to these new values.
+
+  If you have anything in progress, you can move what was in sprint-artifacts to _bmad-output/implementation-artifacts,
+  and if you had brainstorming content, a PRD, UX or Architecture, you can move the content to _bmad-output/planning-artifacts.
+
+  Read the latest updates before continuing:
+  https://github.com/bmad-code-org/BMAD-METHOD/blob/main/CHANGELOG.md
 
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
@@ -31,28 +35,24 @@ startMessage: |
 endMessage: |
   ════════════════════════════════════════════════════════════════════════════════
 
-  ✨ BMAD IS READY! Beta is just days away! Thank you for your support!
+  ✨ BMAD IS READY TO USE!
 
-  🌟 BMad is 100% free and open source.
+  ONE FINAL NOTE WITH VERSION Alpha.22: Phase 4 (Implementation) is still in the process of
-    - No gated Discord. No paywalls.
+  being migrated to the improved workflow progressive disclosure system.
-    - We believe in empowering everyone, not just those who can pay.
+  Along with this, the full conversion to the new path locations for content being searched
+  may possibly be incomplete. If you run a workflow that relies on finding input documents
+  automatically, and you notice they are not being found / looking in the wrong location, either:
+  1. Manually specify the correct input location when prompted
+  2. Open an issue on GitHub so we can address the problem quickly if you think its a bug.
+  3. Ensure your content is in the new locations for best results:
+     - Planning Artifacts (Phases 1-3): _bmad-output/planning-artifacts
+     - Implementation Artifacts (Phase 4): _bmad-output/implementation-artifacts
+     - Long Term Project Knowledge (docs, research, references): docs/
 
-  🙏 SUPPORT BMAD DEVELOPMENT:
+  Thank you for helping test the early release version of the new BMad Core and BMad Method!
-    - Donate: https://buymeacoffee.com/bmad
+  Stable Beta coming soon - please read the full README.md and linked documentation to get started.
-    - Corporate Sponsorship available - DM on Discord
 
-  🎤 SPEAKING & MEDIA:
+  And again, here is the Change Log with all the details of recent updates:
-    - Available for conferences, podcasts, and media appearances
+  https://github.com/bmad-code-org/BMAD-METHOD/blob/main/CHANGELOG.md
-    - Topics: AI-Native Transformation, Spec and Context Engineering, BMad Method
-    - For speaking inquiries or interviews, reach out to BMad on Discord!
-
-  📚 RESOURCES:
-    - Docs: http://docs.bmad-method.org/ (bookmark it!)
-    - Changelog: https://github.com/bmad-code-org/BMAD-METHOD/blob/main/CHANGELOG.md
-
-  ⭐⭐⭐ HELP US GROW:
-    - Star us on GitHub: https://github.com/bmad-code-org/BMAD-METHOD/
-    - Subscribe on YouTube: https://www.youtube.com/@BMadCode
-    - Every star & sub helps us reach more developers!
 
   ════════════════════════════════════════════════════════════════════════════════