[codex] add SpecGov README and GitHub Pages site

.github/workflows/pages.yml

@@ -0,0 +1,34 @@
+name: GitHub Pages
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - docs/**
+      - .github/workflows/pages.yml
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/configure-pages@v5
+      - uses: actions/upload-pages-artifact@v4
+        with:
+          path: docs
+      - id: deployment
+        uses: actions/deploy-pages@v4

.specgov.yml

@@ -6,6 +6,10 @@ artifacts:
     kind: documentation
     owner: maintainers
     status: active
+  - path: "docs/**/*"
+    kind: documentation
+    owner: maintainers
+    status: active
   - path: ".specs/**/*.md"
     kind: specification
     owner: maintainers

.specs/features/specgov-core/spec.md

@@ -87,3 +87,4 @@ Spec-driven development creates useful artifacts, but those artifacts drift when
 - [x] `npm run lint` passes.
 - [x] `npm run typecheck` passes.
 - [x] README quickstart commands are locally verified.
+- [x] GitHub Pages documentation site is available from `docs/`.

.specs/features/specgov-core/tasks.md

@@ -99,10 +99,11 @@ T4 + T5 + T6 -> T7 -> T8
 
 ### T8: Validate and Publish
 
-**What**: Run release checks, commit atomically, create public GitHub repo, push, and verify remote.
+**What**: Run release checks, commit atomically, create public GitHub repo, add
+README and GitHub Pages adoption docs, push, and verify remote.
 **Where**: repository
 **Depends on**: T7
 **Requirement**: SGOV-05
 **Tests**: full
 **Gate**: `npm test`, `npm run build`, `npm run lint`, `npm run typecheck`
-**Status**: In Progress
+**Status**: Done

.specs/project/ROADMAP.md

@@ -18,6 +18,7 @@
 
 - Example manifests for docs-only, ADR-heavy, and spec-framework repos.
 - README quickstart.
+- GitHub Pages product site for global project adoption.
 - Contribution and security docs.
 
 ## Later

.specs/project/STATE.md

@@ -18,6 +18,8 @@
 - The v1 smoke test should include both advisory warnings and strict failures so users can trust the opt-in enforcement mode before adopting it.
 - GitHub Actions now warns that Node 20 actions are forced to Node 24, so SpecGov's own Action and CI target Node 24 while the CLI package can still support Node 20+.
 - GitHub's official checkout and setup-node v5 tags exist and avoid the Node 20 runtime warning emitted by v4.
+- Public project education lives in the README and the static GitHub Pages site
+  under `docs/`. The Pages workflow deploys the `docs` directory from `main`.
 
 ## Deferred Ideas