docs: add Astro + Tailwind website with GitHub Pages deploy

Static docs site under website/ that auto-generates pages from the
marketing/ template tree (one page per bank-template.json) and a page
per harness (claude, openclaw, nemoclaw). Deployed to GitHub Pages
on push to main via .github/workflows/pages.yml.

Author: nicoloboschi

.github/workflows/pages.yml

@@ -0,0 +1,57 @@
+name: Deploy docs site
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'website/**'
+      - 'marketing/**'
+      - '.github/workflows/pages.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'npm'
+          cache-dependency-path: website/package-lock.json
+
+      - name: Install
+        working-directory: website
+        run: npm ci
+
+      - name: Build
+        working-directory: website
+        env:
+          SITE_URL: https://vectorize-io.github.io
+          SITE_BASE: /self-driving-agents
+        run: npm run build
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: website/dist
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -1,3 +1,4 @@
 node_modules/
 dist/
 *.tgz
+website/.astro/

README.md

@@ -4,6 +4,8 @@ Agents that learn from every conversation and get better over time.
 
 No retraining, no manual updates — just use them and they improve. Powered by [Hindsight](https://github.com/vectorize-io/hindsight), so agent memory is portable across harnesses.
 
+📖 **Docs:** <https://vectorize-io.github.io/self-driving-agents/>
+
 ## Quick start
 
 ### Claude Chat / Cowork

website/.gitignore

@@ -0,0 +1,6 @@
+node_modules/
+dist/
+.astro/
+.env
+.env.*
+!.env.example

website/README.md

@@ -0,0 +1,56 @@
+# Self-Driving Agents — docs site
+
+Static documentation site for [self-driving-agents](https://github.com/vectorize-io/self-driving-agents). Built with [Astro](https://astro.build) and [Tailwind CSS](https://tailwindcss.com), deployed to GitHub Pages.
+
+## Local development
+
+```bash
+cd website
+npm install
+npm run dev
+```
+
+Site is served at <http://localhost:4321>. The `marketing/` folder is read at build time, so any change to a `bank-template.json` or `.md` file under it shows up on a refresh.
+
+## Build
+
+```bash
+npm run build
+npm run preview
+```
+
+The output goes to `website/dist`.
+
+## Deployment
+
+Pushed automatically to GitHub Pages on every push to `main` that touches `website/**` or `marketing/**` (see [.github/workflows/pages.yml](../.github/workflows/pages.yml)).
+
+The base path is `/self-driving-agents` to match the GitHub Pages URL `https://vectorize-io.github.io/self-driving-agents/`. Override via `SITE_URL` and `SITE_BASE` env vars when building locally.
+
+## Structure
+
+```
+website/
+  src/
+    components/      # Header, Footer, AgentCard, CodeBlock
+    layouts/         # Layout.astro
+    lib/             # agents.ts (reads ../marketing), harnesses.ts
+    pages/
+      index.astro                  # landing
+      quickstart.astro             # /quickstart
+      agents/index.astro           # /agents
+      agents/[...slug].astro       # /agents/marketing, /agents/marketing/seo, ...
+      harnesses/index.astro        # /harnesses
+      harnesses/[slug].astro       # /harnesses/claude, ...
+    styles/global.css              # Tailwind + theme tokens
+  public/favicon.svg
+  astro.config.mjs
+```
+
+## Adding a new harness
+
+Edit `src/lib/harnesses.ts` and add a new entry to `HARNESSES`. The page at `/harnesses/<slug>` is generated automatically.
+
+## Adding new agents
+
+Drop a new directory under `marketing/` (or any sibling templates dir you wire up in `src/lib/agents.ts`). Each directory with a `bank-template.json` becomes an agent page; `.md` files in that directory are listed as its knowledge files.

website/astro.config.mjs

@@ -0,0 +1,15 @@
+import { defineConfig } from 'astro/config';
+import tailwindcss from '@tailwindcss/vite';
+
+// GitHub Pages: served at https://vectorize-io.github.io/self-driving-agents/
+const SITE = process.env.SITE_URL ?? 'https://vectorize-io.github.io';
+const BASE = process.env.SITE_BASE ?? '/self-driving-agents';
+
+export default defineConfig({
+  site: SITE,
+  base: BASE,
+  trailingSlash: 'ignore',
+  vite: {
+    plugins: [tailwindcss()],
+  },
+});