Migrate documentation site from Pandoc to Docusaurus

Replace the single-page Pandoc build with a Docusaurus site in docs-site/.
Each of the 9 markdown chapters is now its own page with sidebar navigation,
prev/next links, and search. The landing page (site/index.html) is converted
to a React component using Docusaurus Layout.

- Scaffold Docusaurus in docs-site/ with isolated package.json
- Migrate 9 chapters with frontmatter, fix cross-chapter links
- Convert landing page to src/pages/index.tsx with CSS modules
- Update GitHub Actions workflow for Docusaurus build
- Update root configs (.gitignore, .dockerignore, .pre-commit-config.yaml)
- Remove old docs/, site/, and root CNAME

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: cadamsdotcom

.dockerignore

@@ -33,7 +33,7 @@ tests/
 
 # Documentation
 *.md
-docs/
+docs-site/
 LICENSE
 
 # IDE

.github/workflows/pages.yml

@@ -2,7 +2,7 @@ name: Deploy GitHub Pages
 on:
   push:
     branches: [main]
-    paths: [site/**, docs/**, .github/workflows/pages.yml]
+    paths: [docs-site/**, .github/workflows/pages.yml]
   workflow_dispatch:
 
 permissions:
@@ -18,19 +18,20 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - name: Install Pandoc
-        run: sudo apt-get install -y pandoc
-      - name: Build docs
-        run: make -C docs html
-      - name: Assemble site
-        run: |
-          mkdir -p _site/docs
-          cp site/index.html _site/
-          cp docs/build/* _site/docs/
-          cp CNAME _site/ 2>/dev/null || true
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+          cache-dependency-path: docs-site/package-lock.json
+      - name: Install dependencies
+        run: npm ci
+        working-directory: docs-site
+      - name: Build
+        run: npm run build
+        working-directory: docs-site
       - uses: actions/upload-pages-artifact@v3
         with:
-          path: _site
+          path: docs-site/build
 
   deploy:
     needs: build

.gitignore

@@ -32,7 +32,3 @@ supabase/config.toml
 # TDD guard logs (session artifacts)
 tdd.log
 tdd-*.log
-
-# Documentation build output
-docs/build/
-_site/

docs-site/.gitignore

@@ -0,0 +1,20 @@
+# Dependencies
+/node_modules
+
+# Production
+/build
+
+# Generated files
+.docusaurus
+.cache-loader
+
+# Misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

docs-site/README.md

@@ -0,0 +1,41 @@
+# Website
+
+This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.
+
+## Installation
+
+```bash
+yarn
+```
+
+## Local Development
+
+```bash
+yarn start
+```
+
+This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
+
+## Build
+
+```bash
+yarn build
+```
+
+This command generates static content into the `build` directory and can be served using any static contents hosting service.
+
+## Deployment
+
+Using SSH:
+
+```bash
+USE_SSH=true yarn deploy
+```
+
+Not using SSH:
+
+```bash
+GIT_USER=<Your GitHub username> yarn deploy
+```
+
+If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.

docs/04-agent-optimizations.md docs-site/docs/agent-optimizations.mddocs/04-agent-optimizations.md renamed to docs-site/docs/agent-optimizations.md

@@ -1,4 +1,7 @@
-# Agent Optimizations
+---
+title: 'Agent Optimizations'
+sidebar_position: 5
+---
 
 CodeLeash configures Claude Code to prevent common agent misbehaviors through deny rules, hooks, and environment settings. These are defined in [`.claude/settings.json`](https://github.com/cadamsdotcom/CodeLeash/blob/main/.claude/settings.json) and enforced automatically.
 

docs/05-code-quality-checks.md docs-site/docs/code-quality-checks.mddocs/05-code-quality-checks.md renamed to docs-site/docs/code-quality-checks.md

@@ -1,4 +1,7 @@
-# Code Quality Checks
+---
+title: 'Code Quality Checks'
+sidebar_position: 6
+---
 
 CodeLeash enforces code quality through custom Python scripts that run as pre-commit hooks. Each script is a focused lint rule implemented with AST walking, regex scanning, or both. This "Python script as lint rule" pattern makes rules easy to write, test, and understand.
 

docs/01-full-stack-monorepo.md docs-site/docs/full-stack-monorepo.mddocs/01-full-stack-monorepo.md renamed to docs-site/docs/full-stack-monorepo.md

@@ -1,4 +1,7 @@
-# Full-Stack Monorepo
+---
+title: 'Full-Stack Monorepo'
+sidebar_position: 2
+---
 
 CodeLeash runs Vite and FastAPI as a single application. In development, two servers run concurrently with hot module replacement. In production, Vite builds static assets and FastAPI serves everything.
 
@@ -17,7 +20,7 @@ concurrently -n vite,uvicorn,worker \
 
 - **Vite** (port 5173) serves JavaScript/CSS with HMR
 - **Uvicorn** (port 8000) serves HTML pages and API routes
-- **Worker** processes background jobs (see [Worker System](06-worker-system.md))
+- **Worker** processes background jobs (see [Worker System](./worker-system.md))
 
 In production (`npm run build` then `uv run uvicorn main:app`), Vite compiles assets into `dist/` and FastAPI serves them directly using the Vite manifest for cache-busted URLs.
 

docs/08-future-and-community.md docs-site/docs/future-and-community.mddocs/08-future-and-community.md renamed to docs-site/docs/future-and-community.md

@@ -1,4 +1,7 @@
-# Future & Community
+---
+title: 'Future & Community'
+sidebar_position: 9
+---
 
 ## Migration Testing Framework
 

docs/03-how-tests-work.md docs-site/docs/how-tests-work.mddocs/03-how-tests-work.md renamed to docs-site/docs/how-tests-work.md

@@ -1,4 +1,7 @@
-# How Tests Work
+---
+title: 'How Tests Work'
+sidebar_position: 4
+---
 
 CodeLeash has three test levels --- unit, integration, and end-to-end --- plus frontend component tests via Vitest. The full suite runs automatically on every git commit via a pre-commit hook installed by [`init.sh`](https://github.com/cadamsdotcom/CodeLeash/blob/main/init.sh).