System

What holds Poesía together: its health, its taste, and the twin an agent reads.

All green · 2 off in CI

@rrios-forge/ui 0.16.1 · gates ran on 21 Oct 2026 on main

8 passing2 off in CI5 not run here

Components

106

26 atoms · 65 molecules · 15 organisms

Stories

616

607 with a visual baseline

Decisions

Each one cited where it applies

Needs

Each answered by a component

What every change is checked against, by what it guards.

Types, lint and the forbidden-class rules, and that it all builds.

1 of 5

Types
Not run here
bun run check-types
Lint
Not run here
bun run lint
R02 / R04 / atoms-only
16.1 s
bash .claude/hooks/poesia-lint-forbidden.sh --tree
Generated output in sync
Not run here
bun run ds:build && git diff --exit-code -- packages/design-system-tokens/generated packages/design-system-themes/generated
Storybook builds
Not run here
bun run storybook:build

Every value is a token, and every theme only changes values.

4 of 4

Token tiers, references, cycles
0.1 s
bun run tokens:validate
Contrast per theme
0.1 s
bun run tokens:contrast
Themes override existing semantics only
0.0 s
bun run themes:validate
Theme tests (density order, OS reduce-motion last)
0.1 s
bun --filter @rrios-forge/design-system-themes test

Every component documented, pictured and tested.

2 of 3

Inventory, story metadata, server boundary, ADR citations
0.2 s
cd tooling/storybook && bun run check:inventory && bun run check:story-meta && bun run check:server-boundary && bun run check:citations
Axis vocabulary, focus ring
0.1 s
cd tooling/storybook && bun run check:axes -- --strict && bun run check:focus-ring
Visual snapshots + axe + play tests
Off in CI
bun run storybook:test (needs Playwright's Chromium)

What a reader sees: no generic tells, glass that stays legible.

1 of 3

Taste: generic-AI tells in source (taste.yaml, J-13)
0.2 s
cd tooling/storybook && bun run check:taste
Glass gate
Off in CI
cd tooling/storybook && bun run test:glass (headed)
Legibility, gutters
Not run here
cd tooling/storybook && bun run check:legibility && bun run check:gutters (headed)

46 in all; the newest first.

Each one is adopted or retired before it ages (R15).

ChatBubble
One message in a conversation, sent or received.
CommentItem
One comment: who wrote it, what they said, and the reactions to it.
FilterBar
Narrows a list by a few filters and shows which ones are on.
Markdown
Model or editorial Markdown painted with atoms; app pieces through render slots.
ReactionBar
Quick emoji reactions with their counts; the reader's own stands out.

9 of 616 stories: a visual change here would pass unnoticed.

Set by attribute on any ancestor; layers combine (ADR-032).

light
Base
data-color-scheme="light"
dark
Appearance
data-color-scheme="dark"
desktop-density
Density
data-density="desktop"
full-transparency-dark
Accessibility
data-color-scheme="dark"data-transparency="full"
full-transparency
Accessibility
data-transparency="full"
high-contrast-dark
Accessibility
data-color-scheme="dark"data-contrast="more"
high-contrast
Accessibility
data-contrast="more"
less-transparency-dark
Accessibility
data-color-scheme="dark"data-transparency="less"
less-transparency
Accessibility
data-transparency="less"
reduced-motion
Accessibility
data-motion="reduce"
reduced-transparency-dark
Accessibility
data-color-scheme="dark"data-transparency="reduce"
reduced-transparency
Accessibility
data-transparency="reduce"