docs: full documentation audit + remediation

[intendednull]

Summary

A full audit of docs/ (564 files) + CLAUDE.md/README.md for accuracy, quality, and spec alignment, with every finding fixed. Documentation-only — no code changed.

Headline: the docs lagged the code. An adversarial code-verification pass over every flagged spec↔code mismatch confirmed zero code defects — the implementation matches/exceeds the specs; the docs simply weren't flipped when work landed. The dominant failure was stale "deferred/draft" status left in place after subsystems shipped (the most dangerous class, since it invites re-implementing landed work).

110 raw findings → ~50 distinct issues, all resolved. Full detail: docs/reports/2026-06-18-docs-audit.md; ordered fix: docs/plans/2026-06-18-docs-audit-remediation.md.

What changed

• Catalog — new ### Render area; 11 missing plan entries added (render r1/r2/r6, the GPU-verify campaign, editing e1–e6, follow-ups.md); dead reference-designs/ link + stray list break removed; "Where to start" expanded to 5; broken prior-art cross-refs repointed.
• Statuses flipped to reality — render-pipeline spec [draft]→[active], docs-org [draft]→[landed], R8 [partial]→[superseded], R8b/R9 →[landed], T9 proposed→landed, editing e1–e6, the 5 render sub-designs, open-questions, text README; the non-standard [partial] is gone everywhere.
• Misleading "deferred/future" claims rewritten to landed reality across the layout/render/text/verification specs and follow-ups.md (pipeline now lists steps 0–9 + text; TaffyTree<Entity>; the Transform bridge; node_skip_reason; the GPU-orchestration framing; matrix_goldens).
• Structure — authored the 2 missing prior-art READMEs (bevy-a11y, bevy-feathers); swept 51 files of fictional /home/user/buiy paths to repo-relative; converted drifted :NNNN citations to symbol-only.
• 3 new audit docs — findings report, this remediation plan (executed), and a code-side findings report (stale in-code comments + a dead-legacy extract path — open for a separate session; no functional code defects).

Decision recorded

The 5 dated render-pipeline children were not renamed — renaming would break path references in 5 code files — so they're blessed as a documented exception in the docs-organization spec + organizing-buiy-docs skill, keeping this change documentation-only.

Verification

119 files changed, 5 new. Mechanical gates clean: catalog↔filesystem 0 missing entries, internal-link scan 0 broken links, doc-header statuses all standard, no code file touched. Per-subsystem prose rewrites were independently re-reviewed against the code.

🤖 Generated with Claude Code