What

Documentation cohesion sweep across the whole docs/ set plus repo-root cleanup.

Docs

• production.md: new Horizontal scaling & affinity section — tells the scaling story (affinity for transport, backplane for state), explains why round-robin breaks a tab, calls out the sticky-cookie + tunnel-timeout essentials, and references the runnable internal/examples/chatcluster deployment. Cross-linked from distributed-state.md.
• nav fix: examples.md and showcase.md both declared nav_order: 3 (undefined menu order) — moved Showcase last.
• tutorial.md: it taught StateAppSlice while claiming the code is internal/examples/chat, which actually uses StateAppEvents. Reframed as the simpler shape with a forward link to Distributed state.
• Datastar framing: dropped the "Alien Signals" jargon across index, why-via, glossary, reactive-state; describe Datastar plainly as the browser runtime that keeps the page reactive and updates it in place.
• README: same Datastar framing; fixed the chat description (slice → field, matching the event-sourced example).

Cleanup

• Deleted critique-council.md, design-council.md, and design/ — multi-agent process transcripts, not part of the published docs site.
• Scrubbed the references they left behind: 6 source/test comments (dropped the (council T*-*) provenance tags, kept the technical rationale) and the HYGIENE.md pointer.

Notes

• Code changes are comment-only; go build ./... and go vet pass.
• The lone remaining state-backplane string is a valid docs-site anchor (production#state-backplane-under-load), not the deleted file.