Docusaurus build fix - Sidebar and missing image issues (#1243)

* fix(docs): align sidebar with actual docs structure and fix image path

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 <noreply@anthropic.com>

* fix(docs): update build script to include docs/modules directory

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 <noreply@anthropic.com>

* fix(docs): correct broken internal links

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 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

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
 

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)
 
 ---
 

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)

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
 
 ---
 

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) {

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-bmad-method/index',
-        'modules/bmm/quick-start',
+        'modules/bmm-bmad-method/quick-start',
-        'modules/bmm/scale-adaptive-system',
         {
           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-bmad-method/workflows-planning',
-            'modules/bmm/workflows-solutioning',
+            'modules/bmm-bmad-method/workflows-solutioning',
-            'modules/bmm/workflows-analysis',
+            'modules/bmm-bmad-method/workflows-analysis',
-            'modules/bmm/workflows-implementation',
+            'modules/bmm-bmad-method/workflows-implementation',
           ],
         },
         {
@@ -45,11 +61,10 @@ const sidebars = {
           label: 'Advanced Topics',
           collapsed: true,
           items: [
-            'modules/bmm/party-mode',
+            'modules/bmm-bmad-method/party-mode',
-            'modules/bmm/agents-guide',
+            'modules/bmm-bmad-method/agents-guide',
-            'modules/bmm/brownfield-guide',
+            'modules/bmm-bmad-method/brownfield-guide',
-            'modules/bmm/enterprise-agentic-development',
+            'modules/bmm-bmad-method/test-architecture',
-            'modules/bmm/test-architecture',
           ],
         },
         {
@@ -57,11 +72,10 @@ const sidebars = {
           label: 'Reference',
           collapsed: true,
           items: [
-            'modules/bmm/workflow-architecture-reference',
+            'modules/bmm-bmad-method/workflow-document-project-reference',
-            'modules/bmm/workflow-document-project-reference',
+            'modules/bmm-bmad-method/troubleshooting',
-            'modules/bmm/troubleshooting',
+            'modules/bmm-bmad-method/faq',
-            'modules/bmm/faq',
+            'modules/bmm-bmad-method/glossary',
-            'modules/bmm/glossary',
           ],
         },
       ],
@@ -71,32 +85,11 @@ const sidebars = {
       label: 'BMB - Builder',
       collapsed: true,
       items: [
-        'modules/bmb/index',
+        'modules/bmb-bmad-builder/index',
-        {
+        'modules/bmb-bmad-builder/agent-creation-guide',
-          type: 'category',
+        'modules/bmb-bmad-builder/workflow-vendoring-customization-inheritance',
-          label: 'Building Agents',
+        'modules/bmb-bmad-builder/custom-content',
-          collapsed: true,
+        'modules/bmb-bmad-builder/custom-content-installation',
-          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',
-          ],
-        },
       ],
     },
     {
@@ -104,33 +97,35 @@ const sidebars = {
       label: 'BMGD - Game Dev',
       collapsed: true,
       items: [
-        'modules/bmgd/index',
+        'modules/bmgd-bmad-game-dev/index',
-        'modules/bmgd/quick-start',
+        'modules/bmgd-bmad-game-dev/quick-start',
-        'modules/bmgd/quick-flow-guide',
+        'modules/bmgd-bmad-game-dev/quick-flow-guide',
-        'modules/bmgd/agents-guide',
+        'modules/bmgd-bmad-game-dev/agents-guide',
-        'modules/bmgd/workflows-guide',
+        'modules/bmgd-bmad-game-dev/workflows-guide',
-        'modules/bmgd/game-types-guide',
+        'modules/bmgd-bmad-game-dev/game-types-guide',
-        'modules/bmgd/troubleshooting',
+        'modules/bmgd-bmad-game-dev/troubleshooting',
-        'modules/bmgd/glossary',
+        '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',
+        'modules/core/index',
-        'custom-content',
+        'modules/core/party-mode',
-        'custom-content-installation',
+        'modules/core/core-tasks',
-        'agent-customization-guide',
+        'modules/core/core-workflows',
-        'web-bundles-gemini-gpt-guide',
+        'modules/core/advanced-elicitation',
-        'BUNDLE_DISTRIBUTION_SETUP',
+        'modules/core/brainstorming',
+        'modules/core/document-sharding-guide',
+        'modules/core/global-core-config',
       ],
     },
   ],