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 cis-docs.bmad-method.org
- Update README with documentation link

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 @@
+cis-docs.bmad-method.org

README.md

@@ -82,8 +82,10 @@ CIS includes team configurations for collaborative creativity:
 
 ## Documentation
 
-- [BMad Method Docs](http://docs.bmad-method.org)
-- [Creative Workflows Guide](http://docs.bmad-method.org/how-to/creative-workflows/)
+**[Creative Intelligence Suite Documentation](http://cis-docs.bmad-method.org)** — Tutorials, how-to guides, and reference
+
+- [Getting Started](http://cis-docs.bmad-method.org/tutorials/)
+- [BMad Method Docs](http://docs.bmad-method.org) — Core framework documentation
 
 ## Community
 

docs/explanation/index.md

@@ -0,0 +1,14 @@
+---
+title: Explanation
+description: Learn how CIS works
+---
+
+# Explanation
+
+Learn how the Creative Intelligence Suite works under the hood.
+
+## Key Concepts
+
+- **[Coming Soon]** - Understanding creative workflows
+- **[Coming Soon]** - Brainstorming techniques
+- **[Coming Soon]** - Problem-solving approaches

docs/how-to/index.md

@@ -0,0 +1,8 @@
+---
+title: How-To Guides
+description: Practical guides for CIS tasks
+---
+
+# How-To Guides
+
+Step-by-step guides for completing specific tasks with the Creative Intelligence Suite.

docs/index.md

@@ -1,3 +1,26 @@
-# CIS Documentation Index
+---
+title: Welcome
+description: Creative Intelligence Suite - Innovation, brainstorming, and problem-solving agents
+template: splash
+hero:
+  title: Creative Intelligence Suite
+  subtitle: Innovation, brainstorming, and problem-solving agents
+  tagline: Unlock your creative potential with AI-powered ideation and problem-solving workflows.
+  actions:
+    - text: Get Started
+      link: /tutorials/
+      variant: primary
+    - text: View on GitHub
+      link: https://github.com/bmad-code-org/bmad-module-creative-intelligence-suite
+      variant: minimal
+---
 
-TODO: do more than todo
+## Quick Start
+
+[**Tutorials**](/tutorials/) - Step-by-step guides to explore creative workflows.
+
+[**How-To Guides**](/how-to/) - Practical guides for specific tasks.
+
+[**Explanation**](/explanation/) - Learn how CIS works under the hood.
+
+[**Reference**](/reference/) - Technical reference for configuration and options.

docs/reference/index.md

@@ -0,0 +1,8 @@
+---
+title: Reference
+description: Technical reference for CIS
+---
+
+# Reference
+
+Technical documentation for Creative Intelligence Suite configuration and options.

docs/tutorials/index.md

@@ -0,0 +1,12 @@
+---
+title: Tutorials
+description: Step-by-step tutorials for Creative Intelligence Suite
+---
+
+# Tutorials
+
+Learn the Creative Intelligence Suite through step-by-step tutorials.
+
+## Quick Start
+
+- **[Coming Soon]** - Your first creative workflow

package.json

@@ -1,6 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "bmad-creative-intelligence-suite",
+  "type": "module",
   "version": "0.1.4",
   "description": "A BMad MEthod Core Module that offers a suite of very creative agents and workflows",
   "keywords": [
@@ -16,6 +17,9 @@
   "main": "",
   "bin": {},
   "scripts": {
+    "docs:build": "node tools/build-docs.mjs",
+    "docs:dev": "astro dev --root website",
+    "docs:preview": "astro preview --root website",
     "format:check": "prettier --check \"**/*.{js,cjs,mjs,json,yaml}\"",
     "format:fix": "prettier --write \"**/*.{js,cjs,mjs,json,yaml}\"",
     "lint": "eslint . --ext .js,.cjs,.mjs,.yaml --max-warnings=0",