@@ -4,11 +4,13 @@
 
 ## What this repo is
 
-A Bun-workspaces monorepo containing the Abstract Data Starlight documentation theme, a local playground that consumes it, and (eventually) a GitHub template repo for client project scaffolding.
+A Bun-workspaces monorepo containing the Abstract Data Starlight documentation theme, the CLI scaffolder, and the template client projects are scaffolded from.
 
-- `packages/starlight-theme/` — the `@abstractdata/starlight-theme` npm package. **This is the deliverable.**
+- `packages/starlight-theme/` — the `@abstractdata/starlight-theme` npm package. **This is the primary deliverable.**
+- `packages/create-docs/` — the `@abstractdata/create-docs` CLI scaffolder (`bun create @abstractdata/docs`).
+- `packages/template/` — the template `create-docs` bundles and scaffolds from.
 - `apps/playground/` — private dev site, never published. Consumes the theme via `workspace:*`.
-- `mockup.html` — round-two static HTML mockup. Source of truth for visual decisions until Round 3 lands. Don't delete.
+- `docs/round-2-mockup.html` — archived static HTML mockup. Visual reference — don't delete.
 
 ## Package manager
 
@@ -49,7 +51,7 @@ Lockfile is `bun.lock` (text-based). Commit it.
 - ✅ **Round 3c:** branded Shiki/expressive-code themes (cyan/gold/burgundy), custom `<Hero>` component using Astro's `<Image>`, gold ghost button polish, light-mode hex visibility bumped, branded TOC right sidebar, `packages/template/` template package with GitHub Pages workflow.
 - ✅ **Round 3.5 (QA):** branded `404.astro` with Glitch headline, search modal styling (`site-search dialog` + `::backdrop`), expanded `prefers-reduced-motion` block, mobile/light/calm walkthrough confirmed.
 - ✅ **Round 4:** self-hosted variable fonts via `@fontsource-variable/*` (no Google Fonts CDN), Vercel + Cloudflare Pages workflow variants in template, kitchen-sink showcase page, migration guide for existing Starlight users, `mockup.html` archived to `docs/`.
-- ⏳ **Future:** `bun create @abstractdata/docs` CLI scaffolder (separate `create-abstractdata-docs` package).
+- ✅ **Round 5:** `bun create @abstractdata/docs` CLI scaffolder (`packages/create-docs/`), Python + TypeScript autodoc pipelines (`scripts/build-python-docs.mjs` / `build-ts-docs.mjs`), `<VersionPicker>` component for versioned API reference, `abstract-data-setup` skill with full Python + TS detection and config-write workflow, multi-tool skill compilation (Cursor MDC + Copilot), release-please automation.
 
 ## Non-obvious gotchas — read before adding features
 
@@ -78,13 +80,15 @@ Releases are automated via [release-please](https://github.com/googleapis/releas
 
 This repo ships a Claude Code skill at `.claude/skills/abstract-data-setup/SKILL.md` — when invoked inside a project that depends on `@abstractdata/starlight-theme`, it walks the user through:
 
-1. **Detection** — Python signals via `pyproject.toml`, source tree shape, package + submodule discovery.
-2. **Docstring coverage audit** — runs `interrogate` (or AST walk fallback) on candidate modules, classifies as green/yellow/red, surfaces gaps before they become empty API pages.
-3. **Docstring style detection** — Google / NumPy / Sphinx sniffer; warns on mixed style.
-4. **Interactive questions** — modules to document, motion / credit / version.
-5. **Config writes** — `scripts/python-autodoc.json`, `astro.config.mjs` sidebar + plugin call, `package.json` `docs:python` script.
-6. **Optional generation** — runs `bun run docs:python` on consent.
-7. **Optional pre-commit hook** — if any module is below 80% coverage, offers to install an `interrogate` hook in the *source* project's `.pre-commit-config.yaml` plus dev deps. Edits the source repo, not the docs repo.
+1. **Stack detection** — Python (`pyproject.toml`, source tree), TypeScript (entry points, `package.json` exports), Next.js, TanStack Router, OpenAPI, Prisma, Drizzle, and logo assets.
+2. **Python docstring audit** — runs `interrogate` (or AST walk fallback), classifies green/yellow/red per module.
+3. **Python style detection** — Google / NumPy / Sphinx sniffer; warns on mixed style.
+4. **TypeScript TSDoc audit** — runs TypeDoc in validation-only mode to count undocumented exports, same traffic-light thresholds as Python.
+5. **Interactive questions** — modules/entry points to document, motion / credit / version, logo, last-updated timestamps, Edit-on-GitHub link.
+6. **Config writes** — `scripts/python-autodoc.json`, `scripts/ts-autodoc.json`, `astro.config.mjs` sidebar + plugin call, `package.json` `docs:python` / `docs:ts` scripts.
+7. **Optional generation** — runs `bun run docs:python` / `bun run docs:ts` on consent.
+8. **Thin-page dispatch** — detects sparse auto-generated pages and offers to hand off to the `abstract-data-docs-author` companion skill.
+9. **Optional pre-commit hook** — per-stack: `interrogate` for Python, TypeDoc validation for TypeScript. Edits the *source* repo, not the docs repo.
 
 **Source of truth:** `.claude/skills/abstract-data-setup/SKILL.md` at the monorepo root. Everything else is generated from it.
 
@@ -122,7 +126,7 @@ node scripts/compile-skill.mjs
 
 ### Future skills
 
-TypeScript autodoc, OpenAPI, Next.js detection, etc. should follow the same pattern: hand-author a `SKILL.md`, let the compiler emit Cursor and Copilot variants. Add new entries to the `TARGETS` array in `scripts/compile-skill.mjs`.
+OpenAPI, Next.js route-map, Prisma schema-doc, Drizzle schema-doc, and `abstract-data-docs-author` (prose enrichment) should follow the same pattern when implemented: hand-author a `SKILL.md`, let the compiler emit Cursor and Copilot variants. Add new entries to the `TARGETS` array in `scripts/compile-skill.mjs`.
 
 ## Loop closure
 
 
@@ -3,7 +3,7 @@ title: Kitchen Sink
 description: Every component, callout, code language, and styling primitive the theme ships, in one page. Doubles as visual regression bait.
 ---
 
-import { Card, CardGrid, LinkCard, Tabs, TabItem, Steps, Aside } from '@astrojs/starlight/components';
+import { Badge, Card, CardGrid, FileTree, Icon, LinkButton, LinkCard, Tabs, TabItem, Steps, Aside } from '@astrojs/starlight/components';
 import Glitch from '@abstractdata/starlight-theme/components/Glitch.astro';
 
 Every component, callout, code language, and styling primitive the theme ships — visible at once. Use this page to spot regressions after any visual change.
@@ -256,6 +256,120 @@ def apply(config: ThemeConfig) -> None:
   href="/migrating/"
 />
 
+## Expressive code features
+
+These meta-features are part of Astro's expressive-code integration and are worth verifying in both dark and light modes.
+
+### File title + line highlight
+
+```ts title="src/plugin/index.ts" {3,7-9}
+import type { StarlightPlugin } from '@astrojs/starlight/types';
+
+export interface Config {
+  motion: 'full' | 'calm';
+  credit: 'auto' | 'hide';
+  version?: string;
+}
+
+export default function plugin(opts: Config): StarlightPlugin {
+  return { name: '@abstractdata/starlight-theme', hooks: {} };
+}
+```
+
+### Diff markers
+
+```ts del={2} ins={3}
+const motion = opts.motion ?? 'full';
+const motion = opts.motion ?? 'calm';
+```
+
+### Line numbers
+
+```bash showLineNumbers
+bun install
+bun dev
+bun run build
+bun run preview
+```
+
+### Terminal frame
+
+```bash frame="terminal"
+$ bun create @abstractdata/docs my-project
+┌─[ ABSTRACT DATA · DOCS ]─────────────────┐
+│ Scaffolding a branded Starlight site      │
+└──────────────────────────────────────────┘
+
+✓ my-project scaffolded.
+```
+
+### Code + title together
+
+```json title="scripts/ts-autodoc.json"
+{
+  "entryPoints": ["../../my-lib/src/index.ts"],
+  "tsconfig": "../../my-lib/tsconfig.json",
+  "outputDir": "src/content/docs/api/ts"
+}
+```
+
+## Badge
+
+All five variants Starlight ships:
+
+<Badge text="New" variant="tip" />
+<Badge text="Caution" variant="caution" />
+<Badge text="Danger" variant="danger" />
+<Badge text="Note" variant="note" />
+<Badge text="Success" variant="success" />
+
+Badges inline with a heading:
+
+### Feature <Badge text="Beta" variant="caution" /> <Badge text="v0.4+" variant="tip" />
+
+## FileTree
+
+```
+<FileTree>
+```
+
+<FileTree>
+- packages/
+  - starlight-theme/
+    - src/
+      - components/
+        - Footer.astro
+        - Glitch.astro
+        - Hero.astro
+        - SocialIcons.astro
+        - **VersionPicker.astro** New in v0.4
+      - styles/
+        - theme.css
+        - hud.css
+      - index.ts The plugin entry
+  - create-docs/
+    - bin/
+      - cli.js
+- apps/
+  - playground/
+</FileTree>
+
+## Icon
+
+A sample of Starlight's built-in icon set (Heroicons + Phosphor subset):
+
+<Icon name="rocket" /> <Icon name="star" /> <Icon name="approve-check" /> <Icon name="warning" /> <Icon name="information" /> <Icon name="github" /> <Icon name="external" />
+
+Icon sizes:
+
+<Icon name="rocket" size="1rem" /> <Icon name="rocket" size="1.5rem" /> <Icon name="rocket" size="2rem" />
+
+## LinkButton
+
+<LinkButton href="/quickstart/">Get started</LinkButton>
+<LinkButton href="/quickstart/" variant="secondary">Read the docs</LinkButton>
+<LinkButton href="https://github.com/Abstract-Data/abstract-data-doc-theme" variant="minimal" icon="github" target="_blank">View on GitHub</LinkButton>
+
 ## Blockquote
 
 > "Documentation, engineered."
 
@@ -159,8 +159,16 @@ try {
     cwd: targetDir,
     stdio: 'ignore',
   });
-} catch {
+} catch (err) {
   // Non-fatal — user can `git init` manually.
+  const isNotFound =
+    err?.code === 'ENOENT' ||
+    /not found|no such file|command not found/i.test(err?.message ?? '');
+  if (isNotFound) {
+    log(`${c.dim}  (git not found in PATH — run ${c.reset}${c.bold}git init${c.reset}${c.dim} inside ${c.reset}${c.bold}${projectName}/${c.reset}${c.dim} to start version-tracking your project)${c.reset}`);
+  } else {
+    log(`${c.dim}  (git skipped: ${(err?.message ?? 'unknown error').split('\n')[0]} — run git init manually)${c.reset}`);
+  }
 }
 
 // ─── Done ─────────────────────────────────────────────────────────────
 
@@ -126,6 +126,16 @@ if (!propVersions || propVersions.length === 0) {
     // No `docs` collection or no version frontmatter — render nothing.
     versions = [];
   }
+
+  // Warn at build time so developers know why the picker is absent.
+  // Fires only in auto-discovery mode (no `versions` prop passed).
+  if (versions.length === 0) {
+    console.warn(
+      '[VersionPicker] Auto-discovery found no pages with `version:` frontmatter. ' +
+      'The picker will not render until at least one page has `version: "<tag>"` in its frontmatter. ' +
+      'See the versioned-docs recipe or pass a `versions` prop manually to suppress this warning.',
+    );
+  }
 }
 
 // ─── Detect current version from URL ──────────────────────────────────
 
@@ -8,7 +8,9 @@
     "dev": "astro dev",
     "build": "astro check && astro build",
     "preview": "astro preview",
-    "typecheck": "astro check"
+    "typecheck": "astro check",
+    "docs:python": "node scripts/build-python-docs.mjs",
+    "docs:ts": "node scripts/build-ts-docs.mjs"
   },
   "dependencies": {
     "@abstractdata/starlight-theme": "workspace:*",
 
@@ -72,6 +72,20 @@ const updated = cli.replace(
 
 writeFileSync(CLI_FILE, updated);
 
+// ─── Verify write ─────────────────────────────────────────────────────
+// Read back the file to confirm the regex replacement landed correctly.
+// Catches edge cases like filesystem write failures or a second THEME_VERSION
+// declaration shadowing the first.
+const readBack = readFileSync(CLI_FILE, 'utf8');
+const readBackMatch = readBack.match(/^const THEME_VERSION = '(\^?[\d.]+)';/m);
+if (!readBackMatch || readBackMatch[1] !== wantedRange) {
+  die(
+    `Post-write verification failed: expected THEME_VERSION = '${wantedRange}' ` +
+    `but found '${readBackMatch?.[1] ?? '<no match>'}' in ${CLI_FILE}.\n` +
+    `  The file may have been written incorrectly — inspect it before publishing.`,
+  );
+}
+
 console.log(
   `${c.green}✓${c.reset} ${c.dim}Synced${c.reset} ${c.cyan}THEME_VERSION${c.reset}: ${beforeMatch[1]} ${c.dim}→${c.reset} ${c.gold}${wantedRange}${c.reset}`,
 );