docs: four verified corrections, and Discover's second mention

[edspencer]

Single-point corrections from the 0.67–0.69 site audit, each verified against source. Independent of #820 (no shared files).

reference/self-mcp.md — a page contradicting itself

create_project's return shape and its caveat said keeperRegistered. There has never been a field by that name: it is agentRegistered (self-mcp-types.ts, built in management-ops.ts), which the same page already gets right for promote_project. Both occurrences fixed; nothing else on the page changes.

architecture/overview.md — a localStorage key that does not exist

The client-state table listed paddock:pane:*. There is no such key. The pane key is the prefix paddock:panewidth: (paneWidth.ts), and it already covers both panes it names — the side-nav and the per-project chat list. paddock:itemHeight is likewise a prefix, not a bare key (itemHeight.ts). The row now reads paddock:itemHeight:*, paddock:panewidth:* and says what they hold.

contributing/testing.md — counts, and advice #793 retired

• 20 specs → 22, 19 journeys → 20, with fleet readout added to the coverage list. journey-fleet-readout.spec.ts (feat: the fleet readout — a live strip of in-flight chats above every route #787) and orphan-watchdog.spec.ts (fix(e2e): self-terminate the fixture launcher when its run is aborted (#788 class A) #793) both landed in this range.
• The PADDOCK_E2E_PORT paragraph still told contributors the override is how you dodge an orphaned server from an earlier run. fix(e2e): self-terminate the fixture launcher when its run is aborted (#788 class A) #793 fixed that: the launcher watches its ancestry and self-terminates on an aborted run. The port advice stays; the orphan clause is replaced with what actually holds the fix up — watching process.ppid alone never fires (Playwright runs the launcher under /bin/sh -c, which does not exec it, so the death to detect is the grandparent's), and the server spawn must not be detached: true or it escapes Playwright's own process-group kill on every clean run. Both are things a contributor otherwise re-derives the hard way.
• A short paragraph on orphan-watchdog.spec.ts: it runs under chromium but needs no port, no build and no browser, and reads liveness from /proc/<pid>/stat's State: rather than kill(pid, 0) — a zombie accepts signals, so that probe would fail against a watchdog that works perfectly.

using/creating-and-organizing-projects.md — Discover

The page opened "Click New Project" and never mentioned Discover, now the primary route for turning directories you already have into projects and a permanent sidebar entry rather than a first-run screen. A short section before "Create a new project" covers what it is, that each imported row becomes an unmanaged project with a path: — verified in discoverImport.ts, which passes managed: false explicitly — so the rest of the page applies to a discovered project unchanged, and disambiguates the three colliding words (Discover / Import / Adopt N native chats) using the labels the UI actually renders. The filter rules are linked to getting-started, not duplicated. "Click New Project" stays as the route for a project that does not exist yet, and is now the explicit answer for anything needing a clone.

Checks

• cd website && npm install && npm run build → exit 0, 52 pages. Every anchor added here was checked against the built HTML (question-2--where-does-the-content-live, discover-start-from-the-history-you-already-have, adopt-your-terminal-claude-history).
• Orphans/dangling: both []. No new pages, no renames.
• Leak check: nothing in the diff; the 46 127.0.0.1 hits across the docs + README are unchanged.
• Docs-only: no changeset, no version bump.

The retired-word ("keeper") style sweep is deliberately not here — it would triple the diff and hide these edits.

🤖 Generated with Claude Code

[cloudflare-workers-and-pages]

Deploying paddock with    Cloudflare Pages

Latest commit:	41bb2c6
Status:	✅  Deploy successful!
Preview URL:	https://05f23839.paddock-7u2.pages.dev
Branch Preview URL:	https://docs-mechanical-corrections.paddock-7u2.pages.dev

View logs