Build How Donna Works MVP

[jtcchan]

What changed

• Adds the five-page /donna/ MVP with route-scoped navigation and a restrained visual accent.
• Publishes versioned /donna/agent-card.json and canonical /donna/llms.txt machine contracts.
• Adds visible verification dates, canonical metadata, sitemap generation, validation, and a short maintenance contract.
• Replaces orphaned tests from the removed legacy handbook with checks for the current 27-chapter site and Donna contract.
• Adds the Netlify build contract for this static VitePress site.

Why

Issue #1 calls for a small, public-safe explanation of Donna’s role, operating loop, authority, and collaboration pattern inside the existing VitePress handbook.

Validation

• npm ci
• npm run lint
• npm test — 6 passed
• npm run validate:donna
• npm run build
• unauthenticated HTTP smoke checks for all Donna routes, both machine-readable files, the homepage, and existing chapters
• public-safety literal scan
• original MVP autoreview with gpt-5.6-sol — clean, no accepted/actionable findings

Public Netlify preview

• Preview: https://pr-2--2x-openclaw-handbook.netlify.app
• Netlify deploy: 6a62f1eb40f03be17445e0d9
• Exact PR head: 7550800e2586dd1e13ee25ec0565925c0d227928
• Netlify site is connected to 2xgrowthagency/handbook, production branch main, build command npm run build, publish directory .vitepress/dist.

Separate independent desktop/mobile QA is required before merge. Production merge/publish, DNS, and Cloudflare changes remain out of scope.

Closes #1

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
2x-handbook	Ready	Preview, Comment	Jul 29, 2026 3:26pm
handbook	Ready	Preview, Comment	Jul 29, 2026 3:26pm

[jtcchan]

Independent QA: BLOCKED

• Target tested: 7550800e2586dd1e13ee25ec0565925c0d227928
• Packet: 2026-07-24-014-how-donna-works-mvp-preview
• Criteria: Immutable-target preflight failed before browser QA because neither supplied local checkout was at the PR head.
• Material findings: origin/codex/how-donna-works and live PR Build How Donna Works MVP #2 resolve to the expected SHA, but the QA worktree was at 329616424801bb78265f3cd28c9032bbaf15973a and the declared target checkout was at e0a5589e6c3595bdb2df8caf667ea7309a5325f0. Public Netlify deploy metadata also required authentication, so deploy-to-SHA binding was not independently established.
• Residual risks / unsupported checks: All desktop/mobile route, navigation, accessibility, visual, console, link, metadata, machine-file, regression, and sensitive-data checks were stopped by the mandatory mismatch gate.
• Recommendation: Requeue independent QA in a clean isolated worktree at the exact PR head and provide a safe read surface binding Netlify deploy 6a62f1eb40f03be17445e0d9 to that SHA.
• Full report: full report retained in local Workboard artifacts

This comment reports independent verification only; it does not approve or merge the change.

[jtcchan]

Editorial rework: ready for exact-head preview binding

The five Donna pages now use plain first-person language, concrete workflows, short Explore cards, public receipts, and clear human limits.

• Exact head: 3b4f4ea1e2907788265b6b8e56ce7445560add3a
• Changed: the five /donna/ pages, Donna nav labels, machine-readable copy, and verification date checks
• Validation: lint; 6 tests; Donna contract; VitePress build; 1,498 local links across 35 pages; public GitHub links; public-safety scans
• Final Autoreview: clean, no accepted or actionable findings

Preview/readback contract

• Public URL: https://pr-2--2x-openclaw-handbook.netlify.app/donna/
• Current status: that Netlify URL still serves the previous head 7550800e2586dd1e13ee25ec0565925c0d227928. The new head deployed successfully to both Vercel previews, but they remain login-protected.
• Do not start independent visual QA until the public preview is proven to serve 3b4f4ea1e2907788265b6b8e56ce7445560add3a.
• Read back all five routes at desktop and mobile widths. Check the seven Explore cards and anchor links, Donna-only navigation, the four workflow examples, guardrails, FAQ, verification dates, agent-card.json, llms.txt, console/network errors, keyboard focus, clipping, overflow, and sensitive-data exposure.
• Visual QA must return PASS, FAIL, or BLOCKED against that exact head. This implementation pass does not self-approve the visuals.

No merge or production deploy was performed.