Add Astro + Starlight documentation site

- Set up website/ with Astro, Starlight, and custom styling
- Add tools/build-docs.mjs for LLM-friendly doc generation
- Add docs:build, docs:dev, docs:preview npm scripts
- Configure GitHub Pages deployment via workflow
- Add CNAME for game-dev-studio-docs.bmad-method.org
- Update README with documentation link
- Restructure docs into Diataxis format (tutorials, how-to, explanation, reference)

Author: Brian Madison

.github/workflows/docs.yaml

@@ -6,9 +6,8 @@ on:
       - main
     paths:
       - "docs/**"
-      - "src/modules/*/docs/**"
       - "website/**"
-      - "tools/build-docs.js"
+      - "tools/build-docs.mjs"
       - ".github/workflows/docs.yaml"
   workflow_dispatch:
 

CNAME

@@ -0,0 +1 @@
+game-dev-studio-docs.bmad-method.org

README.md

@@ -96,8 +96,10 @@ BMGD: Great choice! Here's what I recommend...
 
 ## Documentation
 
-- [BMad Method Docs](http://docs.bmad-method.org)
-- [BMGD Guide](http://docs.bmad-method.org/bmgd/)
+**[BMad Game Dev Studio Documentation](http://game-dev-studio-docs.bmad-method.org)** — Tutorials, how-to guides, and reference
+
+- [Getting Started](http://game-dev-studio-docs.bmad-method.org/tutorials/)
+- [BMad Method Docs](http://docs.bmad-method.org) — Core framework documentation
 
 ## Community
 

docs/game-dev/bmgd-vs-bmm.md docs/explanation/bmgd-vs-bmm.mddocs/game-dev/bmgd-vs-bmm.md renamed to docs/explanation/bmgd-vs-bmm.md

@@ -0,0 +1,11 @@
+---
+title: Explanation
+description: Learn how BMGD works
+---
+
+# Explanation
+
+Learn how BMad Game Dev Studio works under the hood.
+
+- **[Game Types](game-types.md)** - Selecting and using game type templates
+- **[BMGD vs BMM](bmgd-vs-bmm.md)** - Understanding the differences

docs/game-dev/game-types.md docs/explanation/game-types.mddocs/game-dev/game-types.md renamed to docs/explanation/game-types.md

@@ -0,0 +1,14 @@
+---
+title: How-To Guides
+description: Practical guides for game development tasks
+---
+
+# How-To Guides
+
+Step-by-step guides for completing specific game development tasks.
+
+## Quick Guides
+
+- **[Coming Soon]** - Quick prototyping
+- **[Coming Soon]** - Sprint planning
+- **[Coming Soon]** - Code review for games

docs/explanation/index.md

@@ -1,3 +1,26 @@
-# CIS Documentation Index
+---
+title: Welcome
+description: BMad Game Dev Studio - Game development module for Unity, Unreal, and Godot
+template: splash
+hero:
+  title: BMad Game Dev Studio
+  subtitle: Game development (Unity, Unreal, Godot) module
+  tagline: Build games faster with AI-powered workflows for Unity, Unreal Engine, and Godot.
+  actions:
+    - text: Get Started
+      link: /tutorials/
+      variant: primary
+    - text: View on GitHub
+      link: https://github.com/bmad-code-org/bmad-module-game-dev-studio
+      variant: minimal
+---
 
-TODO: do more than todo
+## Quick Start
+
+[**Tutorials**](/tutorials/) - Step-by-step guides to build games with AI assistance.
+
+[**How-To Guides**](/how-to/) - Practical guides for specific game development tasks.
+
+[**Explanation**](/explanation/) - Learn how BMGD works under the hood.
+
+[**Reference**](/reference/) - Technical reference for configuration and options.