Merge 54deddd2a1 into 9ebc4ce9c0

- Transition BMad Method from Alpha to Beta
- Beta versions now publish to npm 'latest' tag (default for npx)
- Updated manual release workflow to prioritize beta releases
- Updated CHANGELOG with Beta.0 release notes

.github/workflows/manual-release.yaml

@@ -6,11 +6,11 @@ on:
       version_bump:
         description: Version bump type
         required: true
-        default: alpha
+        default: beta
         type: choice
         options:
-          - alpha
           - beta
+          - alpha
           - patch
           - minor
           - major
@@ -158,9 +158,12 @@ jobs:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
         run: |
           VERSION="${{ steps.version.outputs.new_version }}"
-          if [[ "$VERSION" == *"alpha"* ]] || [[ "$VERSION" == *"beta"* ]]; then
+          if [[ "$VERSION" == *"alpha"* ]]; then
-            echo "Publishing prerelease version with --tag alpha"
+            echo "Publishing alpha prerelease version with --tag alpha"
             npm publish --tag alpha
+          elif [[ "$VERSION" == *"beta"* ]]; then
+            echo "Publishing beta prerelease version with --tag latest"
+            npm publish --tag latest
           else
             echo "Publishing stable version with --tag latest"
             npm publish --tag latest

CHANGELOG.md

@@ -1,5 +1,92 @@
 # Changelog
 
+## [6.0.0-Beta.0]
+
+**Release: January 2026 - Alpha to Beta Transition**
+
+### 🎉 Beta Release
+
+- **Transition from Alpha to Beta**: BMad Method is now in Beta! This marks a significant milestone in the framework's development
+- **NPM Default Tag**: Beta versions are now published with the `latest` tag, making `npx bmad-method` serve the beta version by default
+
+### 🌟 Key Highlights
+
+1. **bmad-help**: Revolutionary AI-powered guidance system replaces the alpha workflow-init and workflow tracking — introduces full AI intelligence to guide users through workflows, commands, and project context
+2. **Module Ecosystem Expansion**: bmad-builder, CIS (Creative Intelligence Suite), and Game Dev Studio moved to separate repositories for focused development
+3. **Installer Consolidation**: Unified installer architecture with standardized command naming (`bmad-dash-case.md` or `bmad-*-agent-*.md`)
+4. **Windows Compatibility**: Complete migration from Inquirer.js to @clack/prompts for reliable cross-platform support
+
+### 🚀 Major Features
+
+**bmad-help - Intelligent Guidance System:**
+
+- **Replaces**: workflow-init and legacy workflow tracking
+- **AI-Powered**: Full context awareness of installed modules, workflows, agents, and commands
+- **Dynamic Discovery**: Automatically catalogs all available workflows from installed modules
+- **Intelligent Routing**: Guides users to the right workflow or agent based on their goal
+- **IDE Integration**: Generates proper IDE command files for all discovered workflows
+
+**Module Restructuring:**
+
+| Module                                | Status                                            | New Location                                            |
+| ------------------------------------- | ------------------------------------------------- | ------------------------------------------------------- |
+| **bmad-builder**                      | Near beta, with docs and walkthroughs coming soon | `bmad-code-org/bmad-builder`                            |
+| **CIS** (Creative Intelligence Suite) | Published as npm package                          | `bmad-code-org/bmad-module-creative-intelligence-suite` |
+| **Game Dev Studio**                   | Published as npm package                          | `bmad-code-org/bmad-module-game-dev-studio`             |
+
+### 🔧 Installer & CLI Improvements
+
+**UnifiedInstaller Architecture:**
+
+- All IDE installers now use a common `UnifiedInstaller` class
+- Standardized command naming conventions:
+  - Workflows: `bmad-module-workflow-name.md`
+  - Agents: `bmad-module-agent-name.md`
+  - Tasks: `bmad-task-name.md`
+  - Tools: `bmad-tool-name.md`
+- External module installation from npm with progress indicators
+- Module removal on unselect with confirmation
+
+**Windows Compatibility Fix:**
+
+- Replaced Inquirer.js with @clack/prompts to fix arrow key navigation issues on Windows
+- All 91 installer workflows migrated to new prompt system
+
+### 📚 Documentation Updates
+
+**Significant docsite improvements:**
+
+- Interactive workflow guide page (`/workflow-guide`) with track selector
+- TEA documentation restructured using Diátaxis framework (25 docs)
+- Style guide optimized for LLM readers (367 lines, down from 767)
+- Glossary rewritten using table format (123 lines, down from 373)
+- README overhaul with numbered command flows and prominent `/bmad-help` callout
+- New workflow map diagram with interactive HTML
+- New editorial review tasks for document quality
+- E2E testing methodology for Game Dev Studio
+
+More documentation updates coming soon.
+
+### 🐛 Bug Fixes
+
+- Fixed TodoMVC URL references to include `/dist/` path
+- Fixed glob pattern normalization for Windows compatibility
+- Fixed YAML indentation in kilo.js customInstructions field
+- Fixed stale path references in check-implementation-readiness workflow
+- Fixed sprint-status.yaml sync in correct-course workflow
+- Fixed web bundler entry point reference
+- Fixed mergeModuleHelpCatalogs ordering after generateManifests
+
+### 📊 Statistics
+
+- **91 commits** since alpha.23
+- **969 files changed** (+23,716 / -91,509 lines)
+- **Net reduction of ~67,793 lines** through cleanup and consolidation
+- **3 major modules** moved to separate repositories
+- **Complete installer refactor** for standardization
+
+---
+
 ## [6.0.0-alpha.23]
 
 **Release: January 11, 2026**

docs/reference/workflow-map.md

@@ -11,7 +11,7 @@ If at anytime you are unsure what to do, the `/bmad-help` command will help you
 
 Final important note: Every workflow below can be run directly with your tool of choice via slash command or by loading an agent first and using the entry from the agents menu.
 
-<iframe src="/workflow-map-diagram.html" width="100%" height="700" frameborder="0" style="border-radius: 0; border: none;"></iframe>
+<iframe src="/workflow-map-diagram.html" width="100%" height="100%" frameborder="0" style="border-radius: 8px; border: 1px solid #334155; min-height: 900px;"></iframe>
 
 *[Interactive diagram - hover over outputs to see artifact flows]*
 

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "bmad-method",
-  "version": "6.0.0-alpha.23",
+  "version": "6.0.0-Beta.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "bmad-method",
-      "version": "6.0.0-alpha.23",
+      "version": "6.0.0-Beta.1",
       "license": "MIT",
       "dependencies": {
         "@clack/prompts": "^0.11.0",

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-Beta.1",
   "description": "Breakthrough Method of Agile AI-driven Development",
   "keywords": [
     "agile",

src/core/tasks/workflow.xml

@@ -19,7 +19,8 @@
   <flow>
     <step n="1" title="Load and Initialize Workflow">
       <substep n="1a" title="Load Configuration and Resolve Variables">
-        <action>Read workflow.yaml from provided path</action>
+        <action>Locate workflow config file from provided path: check for workflow.md first (preferred), then workflow.yaml (legacy). If neither exists, halt with error. Store resolved path in variable: {workflow_config_file}</action>
+        <action>Read {workflow_config_file}</action>
         <mandate>Load config_source (REQUIRED for all modules)</mandate>
         <phase n="1">Load external config from config_source path</phase>
         <phase n="2">Resolve all {config_source}: references with values from config</phase>
@@ -81,7 +82,7 @@
               <action>Continue to next step</action>
             </if>
             <if response="p">
-              <action>Start the party-mode workflow {project-root}/_bmad/core/workflows/party-mode/workflow.yaml</action>
+              <action>Start the party-mode workflow {project-root}/_bmad/core/workflows/party-mode/workflow.md</action>
             </if>
             <if
               response="y">
@@ -138,11 +139,11 @@
     <protocol name="discover_inputs" desc="Smart file discovery and loading based on input_file_patterns">
       <objective>Intelligently load project files (whole or sharded) based on workflow's input_file_patterns configuration</objective>
 
-      <critical>Only execute if workflow.yaml contains input_file_patterns section</critical>
+      <critical>Only execute if {workflow_config_file} contains input_file_patterns section</critical>
 
       <flow>
         <step n="1" title="Parse Input File Patterns">
-          <action>Read input_file_patterns from loaded workflow.yaml</action>
+          <action>Read input_file_patterns from {workflow_config_file}</action>
           <action>For each pattern group (prd, architecture, epics, etc.), note the load_strategy if present</action>
         </step>
 
@@ -226,7 +227,7 @@
       • This is the complete workflow execution engine
       • You MUST Follow instructions exactly as written
       • The workflow execution engine is governed by: {project-root}/_bmad/core/tasks/workflow.xml
-      • You MUST have already loaded and processed: {installed_path}/workflow.yaml
+      • You MUST have already loaded and processed {workflow_config_file}
       • This workflow uses INTENT-DRIVEN PLANNING - adapt organically to product type and context
       • YOU ARE FACILITATING A CONVERSATION With a user to produce a final document step by step. The whole process is meant to be
       collaborative helping the user flesh out their ideas. Do not rush or optimize and skip any section.

tools/cli/installers/install-messages.yaml

@@ -6,24 +6,24 @@
 startMessage: |
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-  ⭐ IMPORTANT: Version Alpha.23 Changes
+  🎉 BETA IS HERE! Welcome to BMad Method V6 Beta!
 
-  If your current version is older than Alpha.21, you'll need a fresh install:
+  We've officially graduated from Alpha! This milestone represents:
-    - Remove .bmad folder and reinstall
+    - 50+ workflows covering the full development lifecycle
-    - Only needed during final push to beta (ETA January 18th)
+    - Stability - we will still be adding and evolving and optimizing, 
+      but anticipate no massive breaking changes
+    - Groundwork in place for customization and community modules
 
   📚 New Docs Site: http://docs.bmad-method.org/
-    - Tons of guides and articles coming soon!
+    - High quality tutorials, guided walkthrough, and articles coming soon!
     - Everything is free. No paywalls. No gated content.
     - Knowledge should be shared, not sold.
 
-  📺 YouTube Master Class & Podcast launching February 1st!
-
   💡 Love BMad? Please star us on GitHub & subscribe on YouTube!
     - GitHub: https://github.com/bmad-code-org/BMAD-METHOD/
     - YouTube: https://www.youtube.com/@BMadCode
 
-  Latest updates: https://github.com/bmad-code-org/BMAD-METHOD/blob/main/CHANGELOG.md
+  Latest updates: https://github.com/bmad-code-org/BMAD-METHOD/CHANGELOG.md
 
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
@@ -31,13 +31,14 @@ startMessage: |
 endMessage: |
   ════════════════════════════════════════════════════════════════════════════════
 
-  ✨ BMAD IS READY! Beta is just days away! Thank you for your support!
+  ✨ BMAD V6 BETA IS INSTALLED! Thank you for being part of this journey!
 
   🌟 BMad is 100% free and open source.
     - No gated Discord. No paywalls.
     - We believe in empowering everyone, not just those who can pay.
 
   🙏 SUPPORT BMAD DEVELOPMENT:
+    - During the Beta, please give us feedback and raise issues on GitHub!
     - Donate: https://buymeacoffee.com/bmad
     - Corporate Sponsorship available - DM on Discord
 
@@ -48,7 +49,7 @@ endMessage: |
 
   📚 RESOURCES:
     - Docs: http://docs.bmad-method.org/ (bookmark it!)
-    - Changelog: https://github.com/bmad-code-org/BMAD-METHOD/blob/main/CHANGELOG.md
+    - Changelog: https://github.com/bmad-code-org/BMAD-METHOD/CHANGELOG.md
 
   ⭐⭐⭐ HELP US GROW:
     - Star us on GitHub: https://github.com/bmad-code-org/BMAD-METHOD/

website/src/styles/custom.css

@@ -16,6 +16,9 @@
   --ai-banner-height: 2.75rem;
   --sl-nav-height: 6.25rem; /* Base nav height (~3.5rem) + banner height (2.75rem) */
 
+  /* Full-width content - override Starlight's default 45rem/67.5rem */
+  --sl-content-width: 100%;
+
   /* Primary accent colors - purple to match Docusaurus */
   --sl-color-accent-low: #e0e0ff;
   --sl-color-accent: #8C8CFF;
@@ -45,6 +48,9 @@
    COLOR PALETTE - Dark Mode (Primary Focus)
    ============================================ */
 :root[data-theme='dark'] {
+  /* Full-width content - override Starlight's default */
+  --sl-content-width: 100%;
+
   /* Primary accent colors - purple to match Docusaurus */
   --sl-color-accent-low: #2a2a5a;
   --sl-color-accent: #8C8CFF;
@@ -174,10 +180,10 @@
 }
 
 /* ============================================
-   LAYOUT - Fixed width at large viewport
+   LAYOUT - Full width content
    ============================================ */
 .content-panel {
-  max-width: 1400px;
+  width: 100%;
   margin: 0 auto;
 }