Files

T

ehoandClaude Opus 5 12f17d9d73 docs: archive the finished backlogs (RD-30)

Two backlog trees are complete: `docs/project/backlog/` (75 files, every
WP done) and `docs/project/refactor-backlog-setup/` (the arc before it).
Move both under `docs/project/archive/` with `git mv`, so history stays
intact through `git log --follow`. `SHOWCASE-ROADMAP.md` moves with them,
because it points at the now-archived backlog README.

Add `docs/project/archive/README.md`. It states that these trees are
historical and names the two directories that are still live.

Repoint every inbound reference named in RD-30's Files table: CLAUDE.md,
the root README, both backend READMEs, `LetterHtml.cs`, `a11y.mdx`, the
`document-feature` and `new-ssp` skills, and the readable-codebase PLAN,
README, and RD-19 ticket. Fix two upward-relative links inside the moved
WP files (WP-68, WP-69) that gained a directory level and would otherwise
break. Repoint `.prettierignore`'s two agent-prompt exclusions to their
new path, so prettier keeps leaving those files' exact wording alone.

Mark RD-30 done and check off its acceptance criteria; flip its README
row to done.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

2026-09-08 23:00:38 +02:00

3.6 KiB

Raw Permalink Blame History

WP-14 — Storybook taxonomy reorg + Layers MDX

Status: done (8b19fad) Phase: 3 — Storybook as curriculum

Deviation: the "Layout/" bucket (breadcrumb, site-footer, site-header) wasn't in the Decisions block's explicit scheme, so each got folded into Atoms/Molecules/Organisms by its own doc-comment classification (breadcrumb → Molecules, site-footer/site-header → Organisms, both already documented as such in their component header comments) rather than kept as a separate bucket. Fixing atomic-design.mdx's "status banner" reference (stale since WP-13 deleted upload-status-banner) was caught as a side effect of reviewing every MDX page for broken references — not itself a retitle issue, but the same "unbroken MDX" acceptance criterion covers it.

Why

49 stories sit in a flat Atoms/Molecules/Organisms/Templates/Layout scheme with domain outliers (Registratie/… wizards, one stray Shared UI/Status Badge). The sidebar should tell the repo's actual story: a reusable design system on one side, domain contexts on the other — the DDD seam made visible. The sidebar becomes the curriculum's table of contents.

Read first

.storybook/preview.ts, .storybook/main.ts
src/docs/*.mdx (three existing Foundations pages)
CLAUDE.md naming rule (shared = English, domain = Dutch)

Decisions (pre-made, don't relitigate)

Sidebar scheme (respects the English/Dutch seam):

Foundations/            ← MDX curriculum (all concept pages)
Design System/
  Atoms/… Molecules/… Organisms/… Templates/…   ← everything in shared/ui + shared/layout
Domein/
  Registratie/… Herregistratie/… Brief/… Auth/… ← everything in a context's ui/

Rule: a component in a context folder gets a Domein/<Context>/ title, full stop (context organisms like aanvraag-block move from Organisms/ to Domein/Registratie/). Component display names stay as authored (the folder tells the context).
Devtools/ (debug-state) files under Design System/Devtools/.
Order pinned via parameters.options.storySort: ['Foundations', 'Design System', ['Atoms','Molecules','Organisms','Templates','Devtools'], 'Domein'].

Files

All *.stories.ts title: fields (~49, mechanical)
.storybook/preview.ts (storySort)
Existing src/docs/*.mdx (fix any story references broken by retitling)
New src/docs/layers.mdx — title Foundations/Layers & Contexts
CLAUDE.md — the story-title convention (one paragraph in §2 or Conventions)

Steps

Retitle all stories per the scheme (fix Shared UI/Status Badge).
Add storySort; build Storybook and check the sidebar.
layers.mdx: 6 contexts, 5 layers, the inward dependency rule, "this is enforced" (link the eslint rules from WP-03/04), the English/Dutch seam — i.e. the sidebar's own rationale, with links into real stories on both sides.
Check every MDX <Canvas of={…}>/story import still resolves (build-storybook catches broken refs — do an explicit pass anyway).
Convention into CLAUDE.md.

Acceptance criteria

Sidebar shows exactly Foundations → Design System → Domein with the sub-order pinned.
Zero story titles outside the scheme (grep title: and eyeball).
layers.mdx renders; existing MDX pages unbroken.
Convention in CLAUDE.md.

Verification

GREEN + npm run test-storybook:ci (the axe run also re-visits every retitled story).

Out of scope

New component stories (WP-15); the remaining curriculum pages (they ship with their invariant-WPs: 05, 07, 08, 13, 17).

Risks

MDX story references breaking on retitle — build-storybook is the catch; fix-forward in the same session.

3.6 KiB Raw Permalink Blame History