docs(design): the redesign brief, D1 to D73 written for the build (#361, #659) #722

Merged
claude-bot merged 1 commit from docs/redesign-brief into main 2026-09-21 19:26:18 +00:00
Collaborator

Adds docs/design/v4.5.0-brief.md: the one document a builder reads first.

  • §1 the product in one strip; §2 the six journeys as the acceptance bar (J1–J6, keyboard and touch, both roles).
  • §3 thirteen constraints — checkpoint A's nine plus the hosted service, standing consent, any game system via packs, and no toasts.
  • §4 what must survive; §5 the vocabulary, with today's names mapped to the redesign's and D66's tone rule.
  • §6 Book & Table, the shell (#656's six decisions), Lapis Table, devices.
  • §7 every decision D1 to D73 by area, plus the lane-level calls the owner accepted on review (lanes 1b to 8), each in a line or two with its surfaces.
  • §8 what the design system must provide (#364): tokens, shell, pages, controls, feedback, content, icons, and the rules written into the library.
  • §9 the build lanes in order (#366), each with its prototype page, surfaces and the server changes it needs.
  • §10 open, deferred and hosted-only; §11 how to work with the catalogue, the prototype and the coverage scripts.

The catalogue's decisions table (redesign-surfaces/sources/intro.md) stays the authority; the brief is its synthesis. The catalogue README now points at the brief first. Docs only; no code.

🤖 Generated with Claude Code

Adds `docs/design/v4.5.0-brief.md`: the one document a builder reads first. - §1 the product in one strip; §2 the six journeys as the acceptance bar (J1–J6, keyboard and touch, both roles). - §3 thirteen constraints — checkpoint A's nine plus the hosted service, standing consent, any game system via packs, and no toasts. - §4 what must survive; §5 the vocabulary, with today's names mapped to the redesign's and D66's tone rule. - §6 Book & Table, the shell (#656's six decisions), Lapis Table, devices. - §7 every decision D1 to D73 by area, plus the lane-level calls the owner accepted on review (lanes 1b to 8), each in a line or two with its surfaces. - §8 what the design system must provide (#364): tokens, shell, pages, controls, feedback, content, icons, and the rules written into the library. - §9 the build lanes in order (#366), each with its prototype page, surfaces and the server changes it needs. - §10 open, deferred and hosted-only; §11 how to work with the catalogue, the prototype and the coverage scripts. The catalogue's decisions table (`redesign-surfaces/sources/intro.md`) stays the authority; the brief is its synthesis. The catalogue README now points at the brief first. Docs only; no code. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
docs(design): the redesign brief, D1 to D73 written for the build (#361, #659)
All checks were successful
CI / Backend lint (ruff) (pull_request) Successful in 1m0s
CI / Feedback site tests (pull_request) Successful in 1m21s
CI / Bot/backend version sync (pull_request) Successful in 25s
CI / Summarisation accuracy eval harness (stub provider) (pull_request) Successful in 1m35s
CI / Bot tests and audit (pull_request) Successful in 2m41s
CI / Frontend tests, audit, and build (pull_request) Successful in 2m45s
CI / Docker image build (pull_request) Successful in 4m51s
CI / Backend migration, tests, and audit (pull_request) Successful in 13m46s
CI / Synthetic session harness (no GPU, no LLM) (pull_request) Successful in 13m35s
4daf53b80c
The one document a builder reads first: the lifecycle, the six journeys as
the acceptance bar, the constraints (now thirteen, with hosted-and-self-hosted,
standing consent, any game system, no toasts), what must survive, the settled
vocabulary with today's names mapped, Book & Table in Lapis Table and the
shell, every decision D1 to D73 by area with the lane-level calls the owner
accepted, what the design system must provide (#364), the build lanes in
order with the server changes each needs (#366), and what is open or
hosted-only. The catalogue's decisions table remains the authority.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
claude-bot deleted branch docs/redesign-brief 2026-09-21 19:26:18 +00:00
Sign in to join this conversation.
No description provided.