The taste spec
Paul Elite · v0.8.0 · 34 rules (34 confirmed, 0 unconfirmed, 0 open) · 40 pieces of evidence
Restraint over decoration. Flat surfaces, text-led navigation, few type steps, readable tinted greys, and app layouts built from lanes that only fill in when the user asks. Inferred from Paul's shipped work and confirmed by him (v0.2), extended with interfaces.dev rules (v0.5) and his answers to the open questions on spacing, type, motion, accent, buttons, density and lift (v0.6). Marketing surfaces may turn the volume up; app surfaces keep the restraint (v0.7). Inter is the default typeface over a warmer blue-grey ramp, and the one primary button carries an accent gradient while the rest stay flat (v0.8).
How a rule is written
- id: surfaces.flat-by-default
kind: preference # universal | preference | contextual
priority: should # must | should | may
status: confirmed # confirmed | observed | draft
statement: Lists and content start flat — no cards, no drop shadows…
rationale: Paul repeatedly removed cards and shadows from shipped work…
appliesWhen: [lists of items, settings rows]
avoidWhen: [the element overlays other content]
checks: [{ type: max-shadows, max: 2 }]
evidence: [ev-commit-flat-projects, ev-commit-shadow-reduction]The validator refuses an observed or confirmed preference without evidence. Nothing is applied from draft.
All rules
| Rule | Status | Kind |
|---|---|---|
Flat by default; depth must earn its placesurfaces.flat-by-default | Confirmed | preference |
Labels stay text; icons mark statenavigation.icons-earn-their-place | Confirmed | preference |
Start plain; show detail when the user asks for itlayout.detail-on-selection | Confirmed | preference |
App surfaces are lanes that scroll on their ownlayout.lanes | Confirmed | contextual |
Two weights, few sizestypography.two-weights | Confirmed | preference |
Tinted greys, spaced for contrastcolor.readable-tinted-greys | Confirmed | preference |
Chrome stays neutral; colour is for meaningcolor.calm-neutrals | Confirmed | preference |
Fields use hairlines that change with statecomponents.hairline-fields | Confirmed | preference |
No decorative rings on avatars and close buttonscomponents.no-decorative-rings | Confirmed | contextual |
Real content, no fillercontent.real-content-only | Confirmed | preference |
Margins shrink, content doesn'tresponsive.content-min-width | Confirmed | preference |
Rounded, not pill-everythingsurfaces.soft-radii | Confirmed | preference |
Labels carry their own padding, so icon buttons balancecomponents.balanced-icon-buttons | Confirmed | preference |
Balance headings, keep paragraphs free of orphanstypography.text-wrap | Confirmed | preference |
Numbers that change don't movetypography.tabular-numbers | Confirmed | preference |
Images get a faint neutral edgesurfaces.image-outline | Confirmed | preference |
Buttons give a little on pressmotion.press-feedback | Confirmed | preference |
Interactions use transitions that can change their mindmotion.interruptible-transitions | Confirmed | preference |
Things leave more quietly than they arrivemotion.subtle-exits | Confirmed | preference |
One icon, recoloured; filled means activecomponents.icon-states | Confirmed | preference |
40px hit areas on desktop, never overlappingaccessibility.desktop-hit-area | Confirmed | preference |
Spacing on a 4px gridspacing.base-scale | Confirmed | preference |
A neutral grotesque; Inter by defaulttypography.typefaces | Confirmed | preference |
Minimal motionmotion.signature | Confirmed | preference |
One accent; the primary carries the gradientcolor.accent-usage | Confirmed | preference |
A button set, not one buttoncomponents.buttons | Confirmed | preference |
One default density, with optionslayout.density | Confirmed | preference |
A soft transparent lift, not a faked bordersurfaces.lift-on-controls | Confirmed | preference |
Marketing surfaces may turn the volume uplayout.marketing-surface | Confirmed | contextual |
Text meets contrast minimumsaccessibility.text-contrast | Confirmed | universal |
Touch targets are at least 44pxaccessibility.target-size | Confirmed | universal |
Keyboard focus is always visibleaccessibility.focus-visible | Confirmed | universal |
Respect reduced motionmotion.reduced-motion | Confirmed | universal |
Readable body sizetypography.min-body-size | Confirmed | universal |
Ingesting new evidence
Paul (or an editor) adds screenshots, Figma links, written critiques and commits. Each becomes an evidence entry; with --rule it also scaffolds a draft rule citing it.
npm run ingest -w @elite-taste/taste-spec -- screenshot ./good-table.png --notes "density I like" --rule components.data-table
npm run ingest -w @elite-taste/taste-spec -- figma https://figma.com/design/… --notes "settings rows"
npm run ingest -w @elite-taste/taste-spec -- critique "Too many pills. Status should read as text."
npm run spec:validate # schema, references, honesty checks
npm run compile -w @elite-taste/taste-spec # ships the new versionPromoting a rule: edit the draft, set status: confirmed, bump the version in profile.yaml, compile. Agents get it on their next call.