Stand up the product-docs register

The first move of the visibility floor (DEC-0073), executing the register topology locked in DEC-0072 (refined 2026-06-22 — two renderers): REPURPOSE the existing Astro/Starlight @dossier/docs surface — which today renders the dogfood KB — into the official, polished product-docs surface at /docs/* — official product docs about Dossier, not OKF atoms and not a second DOSSIER_KB KB. This is not "a second collection alongside the dogfood KB on the same renderer": the dogfood KB moves off Starlight to app-native rendering first (Render the dogfood OKF KB app-native in @dossier/app near /graph (the prerequisite that frees Starlight for product docs) — the prerequisite that frees this surface).

Scope

A Diátaxis skeleton + a /docs index + four real, non-stub pages:

• Tutorial — "Run your first loop in 15 minutes"
• How-to — "Install the Claude Code plugin"
• Reference — "dossier-runtime verb set" (verified against the actual --help, not invented)
• Explanation — "What is Dossier"

Plus: wire the app header's "Docs" link to open this product-docs surface in a new tab, via the docsUrl() seam (packages/app/src/lib/docs.ts) retargeted from /knowledge/ to the product-docs root.

Why a task, not a fix-in-place

This is genuine authored long-form content requiring the Documentation Engineer & Information Architect's and Astro Starlight Engineer's judgment (information architecture, page authoring, route wiring). The log-auditor files it so the P0 keystone is durable and owned. confidence: inferred (agent-derived from DEC-0073's named "Now" roadmap, refined per the founder's DEC-0072 two-renderer direction).

Prerequisite

Depends on Render the dogfood OKF KB app-native in @dossier/app near /graph (the prerequisite that frees Starlight for product docs) landing first — the dogfood KB must move to app-native rendering before the Starlight surface is free to become product docs. (Listed in dependencies; an ordering hint, not an automatic hold.)

Guardrails

ZERO marketing prose into knowledge/** (DEC-0072 purity invariant); README stays the canonical TL;DR, docs are the canonical long-form (link-don't-duplicate). (Note: the /docs/* ↔ /knowledge/* disjointness + DEC-0058 no-root-index concern now lives with the app-native KB move in Render the dogfood OKF KB app-native in @dossier/app near /graph (the prerequisite that frees Starlight for product docs), since /knowledge/* no longer renders on this Starlight surface post-refinement.)

Board globbed before filing/updating — no open task covered standing up a product-docs surface.

Done (2026-06-22)

IMPLEMENTED + locally browser-verified — NOT yet deployed to production. The Astro/Starlight @dossier/docs surface (packages/site) is repurposed to render official product docs at /docs/* (Astro base: '/docs'), the default mode when DOSSIER_KB is unset. The KB-agnostic rendering (KB-agnostic @dossier/site (renders any tenant's OKF KB) + runtime-driven site rendering + the Node-26 Windows build fix) is preserved behind a DOSSIER_KB env branch (regression-verified at 161 pages). Five authored pages shipped under packages/site/src/content/docs/ — index + the Diátaxis spine: tutorial "Run your first loop in 15 minutes" (start/first-loop), how-to "Install the Claude Code plugin" (guides/install-plugin), reference "The dossier-runtime verb set" (reference/runtime-verbs), explanation "What is Dossier" (concepts/what-is-dossier). Every command was verified against real --help/CLI (the documentation-engineer ran provision/list/serve, drove a live MCP query, ran the offline self-loop with --no-emit); honest-status discipline held — the one non-offline step (extraction needs a transport) is documented, not hidden. The app header/footer "Docs" link was retargeted to /docs/ (new tab; docsUrl() default now /docs/, packages/app/src/lib/docs.ts), and an explicit /docs/* apex rewrite added to packages/app/vercel.json. ZERO knowledge/** authoring (Three content registers — the OKF KB stays a pristine sovereign showcase; product docs and blog are SEPARATE authored collections (REFINED 2026-06-22 — TWO renderers split by register, not one) invariant held). Verified locally: pnpm --filter "@dossier/docs..." build green (product-docs mode), KB-mode build green (161 pages), app svelte-check 0 errors, on-brand in-browser (/docs index + tutorial render, Starlight chrome themed to @dossier/design). Remaining for the DEC-0072 promotion gate: the production Vercel deploy reflecting the new topology.