From cd11414a93b7f3a09c585767398e334e8dd2acde Mon Sep 17 00:00:00 2001 From: forcetrainer Date: Fri, 2 Jan 2026 23:22:33 -0500 Subject: [PATCH 1/3] fix(docs): align sidebar with actual docs structure and fix image path MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Sidebar referenced non-existent paths (modules/bmm/, getting-started/, etc.) while actual docs live in different locations (modules/bmm-bmad-method/, bmad-core-concepts/, etc.). Updated sidebar to match reality so Docusaurus can build successfully. Also fixed broken image reference in workflows-guide.md that used an incorrect relative path. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 --- .../bmgd-bmad-game-dev/workflows-guide.md | 2 +- website/sidebars.js | 125 +++++++++--------- 2 files changed, 61 insertions(+), 66 deletions(-) diff --git a/docs/modules/bmgd-bmad-game-dev/workflows-guide.md b/docs/modules/bmgd-bmad-game-dev/workflows-guide.md index 3b839499d3..d649bc097c 100644 --- a/docs/modules/bmgd-bmad-game-dev/workflows-guide.md +++ b/docs/modules/bmgd-bmad-game-dev/workflows-guide.md @@ -8,7 +8,7 @@ Complete reference for all BMGD workflows organized by development phase. BMGD workflows are organized into four phases: -![BMGD Workflow Overview](../../../../docs/modules/bmgd-bmad-game-dev/workflow-overview.jpg) +![BMGD Workflow Overview](./workflow-overview.jpg) --- diff --git a/website/sidebars.js b/website/sidebars.js index 827fa13167..aa6b183a1c 100644 --- a/website/sidebars.js +++ b/website/sidebars.js @@ -4,40 +4,56 @@ const sidebars = { 'index', { type: 'category', - label: 'Getting Started', + label: 'Core Concepts', items: [ - 'getting-started/installation', + 'bmad-core-concepts/index', + 'bmad-core-concepts/agents', + 'bmad-core-concepts/workflows', + 'bmad-core-concepts/modules', { type: 'category', - label: 'IDE Guides', + label: 'Installing', collapsed: true, - items: [], + items: ['bmad-core-concepts/installing/index', 'bmad-core-concepts/installing/upgrading'], }, - 'v4-to-v6-upgrade', + { + type: 'category', + label: 'Customization', + collapsed: true, + items: [ + 'bmad-core-concepts/bmad-customization/index', + 'bmad-core-concepts/bmad-customization/agents', + 'bmad-core-concepts/bmad-customization/workflows', + ], + }, + 'bmad-core-concepts/web-bundles/index', ], }, { type: 'category', label: 'BMM - Method', items: [ - 'modules/bmm/index', - 'modules/bmm/quick-start', - 'modules/bmm/scale-adaptive-system', + 'modules/bmm-bmad-method/index', + 'modules/bmm-bmad-method/quick-start', { type: 'category', label: 'Quick Flows', collapsed: true, - items: ['modules/bmm/bmad-quick-flow', 'modules/bmm/quick-flow-solo-dev', 'modules/bmm/quick-spec-flow'], + items: [ + 'modules/bmm-bmad-method/bmad-quick-flow', + 'modules/bmm-bmad-method/quick-flow-solo-dev', + 'modules/bmm-bmad-method/quick-spec-flow', + ], }, { type: 'category', label: 'Workflows', collapsed: true, items: [ - 'modules/bmm/workflows-planning', - 'modules/bmm/workflows-solutioning', - 'modules/bmm/workflows-analysis', - 'modules/bmm/workflows-implementation', + 'modules/bmm-bmad-method/workflows-planning', + 'modules/bmm-bmad-method/workflows-solutioning', + 'modules/bmm-bmad-method/workflows-analysis', + 'modules/bmm-bmad-method/workflows-implementation', ], }, { @@ -45,11 +61,10 @@ const sidebars = { label: 'Advanced Topics', collapsed: true, items: [ - 'modules/bmm/party-mode', - 'modules/bmm/agents-guide', - 'modules/bmm/brownfield-guide', - 'modules/bmm/enterprise-agentic-development', - 'modules/bmm/test-architecture', + 'modules/bmm-bmad-method/party-mode', + 'modules/bmm-bmad-method/agents-guide', + 'modules/bmm-bmad-method/brownfield-guide', + 'modules/bmm-bmad-method/test-architecture', ], }, { @@ -57,11 +72,10 @@ const sidebars = { label: 'Reference', collapsed: true, items: [ - 'modules/bmm/workflow-architecture-reference', - 'modules/bmm/workflow-document-project-reference', - 'modules/bmm/troubleshooting', - 'modules/bmm/faq', - 'modules/bmm/glossary', + 'modules/bmm-bmad-method/workflow-document-project-reference', + 'modules/bmm-bmad-method/troubleshooting', + 'modules/bmm-bmad-method/faq', + 'modules/bmm-bmad-method/glossary', ], }, ], @@ -71,32 +85,11 @@ const sidebars = { label: 'BMB - Builder', collapsed: true, items: [ - 'modules/bmb/index', - { - type: 'category', - label: 'Building Agents', - collapsed: true, - items: [ - 'modules/bmb/agents/index', - 'modules/bmb/agents/understanding-agent-types', - 'modules/bmb/agents/simple-agent-architecture', - 'modules/bmb/agents/expert-agent-architecture', - 'modules/bmb/agents/agent-compilation', - 'modules/bmb/agents/agent-menu-patterns', - ], - }, - { - type: 'category', - label: 'Building Workflows', - collapsed: true, - items: [ - 'modules/bmb/workflows/index', - 'modules/bmb/workflows/architecture', - 'modules/bmb/workflows/terms', - 'modules/bmb/workflows/intent-vs-prescriptive-spectrum', - 'modules/bmb/workflows/csv-data-file-standards', - ], - }, + 'modules/bmb-bmad-builder/index', + 'modules/bmb-bmad-builder/agent-creation-guide', + 'modules/bmb-bmad-builder/workflow-vendoring-customization-inheritance', + 'modules/bmb-bmad-builder/custom-content', + 'modules/bmb-bmad-builder/custom-content-installation', ], }, { @@ -104,33 +97,35 @@ const sidebars = { label: 'BMGD - Game Dev', collapsed: true, items: [ - 'modules/bmgd/index', - 'modules/bmgd/quick-start', - 'modules/bmgd/quick-flow-guide', - 'modules/bmgd/agents-guide', - 'modules/bmgd/workflows-guide', - 'modules/bmgd/game-types-guide', - 'modules/bmgd/troubleshooting', - 'modules/bmgd/glossary', + 'modules/bmgd-bmad-game-dev/index', + 'modules/bmgd-bmad-game-dev/quick-start', + 'modules/bmgd-bmad-game-dev/quick-flow-guide', + 'modules/bmgd-bmad-game-dev/agents-guide', + 'modules/bmgd-bmad-game-dev/workflows-guide', + 'modules/bmgd-bmad-game-dev/game-types-guide', + 'modules/bmgd-bmad-game-dev/troubleshooting', + 'modules/bmgd-bmad-game-dev/glossary', ], }, { type: 'category', label: 'CIS - Creative Intelligence', collapsed: true, - items: ['modules/cis/index'], + items: ['modules/cis-creative-intelligence-suite/index'], }, { type: 'category', - label: 'Reference', + label: 'Core Module', collapsed: true, items: [ - 'document-sharding-guide', - 'custom-content', - 'custom-content-installation', - 'agent-customization-guide', - 'web-bundles-gemini-gpt-guide', - 'BUNDLE_DISTRIBUTION_SETUP', + 'modules/core/index', + 'modules/core/party-mode', + 'modules/core/core-tasks', + 'modules/core/core-workflows', + 'modules/core/advanced-elicitation', + 'modules/core/brainstorming', + 'modules/core/document-sharding-guide', + 'modules/core/global-core-config', ], }, ], From 33566b8ad0cbc8d25f2eb3eb1149207c39c10d79 Mon Sep 17 00:00:00 2001 From: forcetrainer Date: Fri, 2 Jan 2026 23:42:12 -0500 Subject: [PATCH 2/3] fix(docs): update build script to include docs/modules directory MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The build script was excluding the modules folder when copying from docs/, but module docs now live in docs/modules/ instead of src/modules/*/docs/. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 --- tools/build-docs.js | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/tools/build-docs.js b/tools/build-docs.js index fbab38aa63..bfeda390dc 100644 --- a/tools/build-docs.js +++ b/tools/build-docs.js @@ -129,7 +129,8 @@ function buildDocusaurusSite(artifactsDir) { function copyMainDocs(destDir) { console.log(' → Copying main docs...'); const docsDir = path.join(PROJECT_ROOT, 'docs'); - copyDirectory(docsDir, destDir, ['modules', 'llms.txt', 'llms-full.txt'], true); + // Include modules folder - docs now live in docs/modules/ instead of src/modules/*/docs/ + copyDirectory(docsDir, destDir, ['llms.txt', 'llms-full.txt'], true); } function copyRootDocs(destDir) { From 22ccc20972cc62b5dbd639c09a184c77e70011ba Mon Sep 17 00:00:00 2001 From: forcetrainer Date: Fri, 2 Jan 2026 23:46:35 -0500 Subject: [PATCH 3/3] fix(docs): correct broken internal links MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Fixed relative paths that were pointing to non-existent locations: - bmgd index: ../../bmm/docs/index.md → ../bmm/index.md - cis index: ../../bmm/docs/index.md → ../bmm/index.md - bmm faq: ./README.md → GitHub URL 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 --- docs/modules/bmgd-bmad-game-dev/index.md | 2 +- docs/modules/bmm-bmad-method/faq.md | 2 +- docs/modules/cis-creative-intelligence-suite/index.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/modules/bmgd-bmad-game-dev/index.md b/docs/modules/bmgd-bmad-game-dev/index.md index 510cf8993d..9d53e29526 100644 --- a/docs/modules/bmgd-bmad-game-dev/index.md +++ b/docs/modules/bmgd-bmad-game-dev/index.md @@ -161,7 +161,7 @@ BMGD Documentation ### Related Documentation -- **[BMM Documentation](../../bmm/docs/index.md)** - Core BMad Method documentation +- **[BMM Documentation](../bmm/index.md)** - Core BMad Method documentation ## Tips for Using This Documentation diff --git a/docs/modules/bmm-bmad-method/faq.md b/docs/modules/bmm-bmad-method/faq.md index 628d265e77..1849f6b956 100644 --- a/docs/modules/bmm-bmad-method/faq.md +++ b/docs/modules/bmm-bmad-method/faq.md @@ -510,7 +510,7 @@ Trust your expertise - BMM supports your decisions. **A:** -1. Search [Complete Documentation](./README.md) for related topics +1. Search [Complete Documentation](https://github.com/bmad-code-org/BMAD-METHOD/blob/main/README.md) for related topics 2. Ask in [Discord Community](https://discord.gg/gk8jAdXWmj) (#general-dev) 3. Open a [GitHub Issue](https://github.com/bmad-code-org/BMAD-METHOD/issues) 4. Watch [YouTube Tutorials](https://www.youtube.com/@BMadCode) diff --git a/docs/modules/cis-creative-intelligence-suite/index.md b/docs/modules/cis-creative-intelligence-suite/index.md index 46fb6e0a4a..05b567f3b8 100644 --- a/docs/modules/cis-creative-intelligence-suite/index.md +++ b/docs/modules/cis-creative-intelligence-suite/index.md @@ -142,7 +142,7 @@ CIS workflows integrate with: ## Related Documentation -- **[BMM Documentation](../../bmm/docs/index.md)** - Core BMad Method documentation +- **[BMM Documentation](../bmm/index.md)** - Core BMad Method documentation ---