Anti-AI-slop design skill for Claude Code, Cursor, and Codex.
CSS
Polish + 2+1 fonts + input-state discipline (45-gate slop test)
Youssef4eff622a8ae4
diff --git a/README.md b/README.mdindex 923b705..8812301 100644--- a/README.md+++ b/README.md@@ -112,7 +112,7 @@ Each page is its own self-contained HTML + CSS — no shared theme, no shared la- **Macrostructures over axes.** Pick one of 21 named whole-page shapes wholesale; the macrostructure stamp lives in the CSS comment, so the next Hallmark run picks something different.- **Within-archetype variation.** Two Bento Grids should not be twins; each archetype has 2–3 picked-per-output knobs.- **Microinteractions as discipline.** Silent success over celebratory toasts. Optimistic update + Undo over confirm dialogs. Hover delay 800 ms, focus delay 0 ms.-- **A 38-gate slop test** runs before every output. One yes fails the build. Recent additions: no horizontal scroll between 320–1920 px (gate 36), decorative effects on text must be visually verified to sit at x-height not baseline (gate 37), interactive bars must declare `align-items: center` (gate 38).+- **A 45-gate slop test** runs before every output. One yes fails the build. Recent additions: typography discipline gates (39–40: max three font families per page, outlier face used in ≤ 2 slots) and input-state gates (41–45: no border-width layout shift, focus ring via outline not border, input height matches button height, helper-text slot reserves height, disabled state needs three independent signals).- **Project memory.** A per-project `.hallmark/log.json` records each run's macrostructure + theme + enrichment + brief summary. The skill reads the last 3–5 entries before picking and writes a new entry after each build, so consecutive Hallmark outputs in the same project don't repeat shapes or themes.- **Theme-diversification rule.** Two consecutive themes must differ on at least one of three axes: paper band (dark / mid / light), display style (italic-serif / roman-serif / geometric-sans / mono / display-heavy / system-native), accent hue (warm / cool / neutral / chromatic-other).- **Voice fixtures over LLM defaults.** Each of the 21 macrostructures ships with 2–3 example opening lines tuned to its tone. "Built for the modern team" is in the banned-phrases list.diff --git a/site/index.html b/site/index.htmlindex 12dc6fa..f4c0917 100644--- a/site/index.html+++ b/site/index.html@@ -893,7 +893,7 @@<li>17 themes</li><li>21 macrostructures</li><li>32 archetypes</li>- <li>38 slop-test gates</li>+ <li>45 slop-test gates</li></ul></div><div class="foot__col">diff --git a/site/js/main.js b/site/js/main.jsindex b5425a6..031bcf2 100644--- a/site/js/main.js+++ b/site/js/main.js@@ -116,7 +116,7 @@ const COPY = {proofLabel: "Proof",proofA: "21 macrostructures",proofB: "32 component archetypes",- proofC: "29-question slop test",+ proofC: "45-gate slop test",cta: "Read the rules",stat: "21",qualifier: "macrostructures",@@ -131,7 +131,7 @@ const COPY = {newsprint: {eyebrow: "Volume I · Issue 02 · 28 April 2026",title: HERO_TITLE,- lede: "Twelve themes. Twenty-one named page shapes. Thirty-two component archetypes. A 29-question slop test that gates every output before it ships. Hallmark is the rulebook the LLM never read.",+ lede: "Twelve themes. Twenty-one named page shapes. Thirty-two component archetypes. A 45-gate slop test that gates every output before it ships. Hallmark is the rulebook the LLM never read.",ctaLabel: "Distribution",proofLabel: "From the rule sheet",proofA: "Multi-column body, justified",@@ -492,7 +492,7 @@ function buildDenseColophon(themeName) {`# hallmark · v0.8.0 · ${themeName.toLowerCase()}`,`# build: ${today} · MIT · powered by together ai`,`#`,- `# stats: 21 macrostructures · 32 archetypes · 17 themes · 38 gates`,+ `# stats: 21 macrostructures · 32 archetypes · 17 themes · 45 gates`,`# catalog (16 named) + custom (per-brand, opt-in)`,`#`,`# repo: github.com/Luffixos/hallmark`,diff --git a/skill/SKILL.md b/skill/SKILL.mdindex fa18798..6d3284e 100644--- a/skill/SKILL.md+++ b/skill/SKILL.md@@ -206,7 +206,7 @@ By the time you reach this step, one of three things is true:**Custom is a quiet branch, not a default question.** Most briefs route to catalog and the user never sees the words "catalog" or "custom." The 17 named themes plus the rotation rule already deliver structural variety; the fork is reserved for when the brief specifically asks for a tuned look the catalog can't carry.-A custom theme is a **complete** OKLCH palette + font pairing tuned to the brief — not a one-off colour swap, not an excuse to bypass the rules. Every constraint in [`color.md`](references/color.md), [`typography.md`](references/typography.md), and [`anti-patterns.md`](references/anti-patterns.md) still applies. The 38 slop-test gates fire unchanged. The Step 5 preview block surfaces the palette + pairing in plain text **before** any code is emitted, so the user can redirect.+A custom theme is a **complete** OKLCH palette + font pairing tuned to the brief — not a one-off colour swap, not an excuse to bypass the rules. Every constraint in [`color.md`](references/color.md), [`typography.md`](references/typography.md), and [`anti-patterns.md`](references/anti-patterns.md) still applies. The 45 slop-test gates fire unchanged. The Step 5 preview block surfaces the palette + pairing in plain text **before** any code is emitted, so the user can redirect.The diversification rule is theme-route-blind: a custom run that follows another custom (or a catalog) must differ on at least one of the three axes from the previous entry, same as catalog-vs-catalog. Custom entries record their three axes explicitly into `.hallmark/log.json` (see [`custom-theme.md`](references/custom-theme.md) § F).@@ -273,7 +273,7 @@ Before emitting any code, output a tight summary of what you're about to ship. T- **Enrichment** · none (typography only)- **Sections** · Hero · Logos · Stats · Features · Testimonials · Pricing · FAQ · CTA · Footer- **Motion** · counter · pricing-lift · pulse-once-- **Slop test** · 38 / 38 ✓ (run after Build)+- **Slop test** · 45 / 45 ✓ (run after Build)- **Diversification** · differs from Pastel on display style + accent hue```@@ -284,7 +284,7 @@ Before emitting any code, output a tight summary of what you're about to ship. T3. **Enrichment** — the chosen archetype + tier, or *none (typography only)*.4. **Sections** — section names separated by ` · `, in DOM order.5. **Motion** — microinteraction primitives separated by ` · `, or *none — typography only*. Always under three primitives per the [`microinteractions.md`](references/microinteractions.md) hard rules.-6. **Slop test** — `38 / 38 ✓` if all gates pass, or `N / 38 — fails: <gate numbers>` if any are open. Run the slop test BEFORE writing this row; the slop test is Step 7.+6. **Slop test** — `45 / 45 ✓` if all gates pass, or `N / 45 — fails: <gate numbers>` if any are open. Run the slop test BEFORE writing this row; the slop test is Step 7.7. **Diversification** *(optional, only when `.hallmark/log.json` has prior entries)* — what axes differ vs the previous run.**Three more sample preview blocks** for the model to imitate, varied across macrostructure types:@@ -297,7 +297,7 @@ Before emitting any code, output a tight summary of what you're about to ship. T> - **Enrichment** · Tier-B hand-built SVG (a 60-line coffee bean with `@property --rise` 6 s breathing-loop)> - **Sections** · Masthead · Letter · Three Notes · Visit · Colophon> - **Motion** · breathing-loop on bean only (respects `prefers-reduced-motion`)-> - **Slop test** · 38 / 38 ✓+> - **Slop test** · 45 / 45 ✓> - **Diversification** · first run for this project*Bento Grid (SaaS, motion-on):*@@ -308,7 +308,7 @@ Before emitting any code, output a tight summary of what you're about to ship. T> - **Enrichment** · E1 Clipped-Edge Demo Video, Tier-A CSS-art trace waterfall> - **Sections** · Hero · 6-tile Bento (stat · sparkline · quote · code · integrations · spotlight) · Index Footer> - **Motion** · counter · pricing-lift · CSS marquee on integrations strip-> - **Slop test** · 38 / 38 ✓+> - **Slop test** · 45 / 45 ✓> - **Diversification** · differs from Plain on paper hue (light-cool vs pure-white) + accent (indigo vs ink-blue)*Manifesto (declarative, no enrichment):*@@ -319,7 +319,7 @@ Before emitting any code, output a tight summary of what you're about to ship. T> - **Enrichment** · none (typography only — voice carries the brand)> - **Sections** · Masthead · Title · Five Declarations · Bleed Band · What We Refuse · Working Rules · Practice · Reading · Colophon> - **Motion** · none — typography only-> - **Slop test** · 38 / 38 ✓+> - **Slop test** · 45 / 45 ✓> - **Diversification** · differs from Linen on paper band (dark vs light) + display style (display-heavy vs geometric-sans)*Custom (Coffeebox archival café):*@@ -330,7 +330,7 @@ Before emitting any code, output a tight summary of what you're about to ship. T> - **Enrichment** · Tier-A pure-CSS coffee bean (60-line SVG, breathing-loop optional)> - **Sections** · Masthead · Letter · Three Notes · Visit · Colophon> - **Motion** · breathing-loop on bean (with reduced-motion fallback)-> - **Slop test** · 38 / 38 ✓+> - **Slop test** · 45 / 45 ✓> - **Diversification** · custom axes: light / italic-serif / chromatic-terracotta — differs from previous catalog Linen on accent hue + display styleIf any slop-test gate fails when you reach Step 7, return to the relevant Build step, fix it, and **re-emit the preview block** with the corrected slop-test row. The preview is the durable summary; it's wrong to ship if it lies.@@ -356,7 +356,7 @@ Always:### 7. The slop test-Before handing back, run the output through the 38-gate slop test in [`references/slop-test.md`](references/slop-test.md). Every answer must be **no**. Load that file at this step (not earlier — it isn't needed until handoff). The active genre matters: some gates are universal, some are genre-scoped (atmospheric loosens the radial-bloom gate; modern-minimal loosens the zero-chroma neutral gate; etc.). The full per-genre overrides are listed inline in `slop-test.md`.+Before handing back, run the output through the 45-gate slop test in [`references/slop-test.md`](references/slop-test.md). Every answer must be **no**. Load that file at this step (not earlier — it isn't needed until handoff). The active genre matters: some gates are universal, some are genre-scoped (atmospheric loosens the radial-bloom gate; modern-minimal loosens the zero-chroma neutral gate; etc.). The full per-genre overrides are listed inline in `slop-test.md`.Run the slop test BEFORE writing the Slop test row in the Step 5 preview block — that row reflects the actual outcome of this step.diff --git a/skill/references/custom-theme.md b/skill/references/custom-theme.mdindex c7254ff..553c977 100644--- a/skill/references/custom-theme.md+++ b/skill/references/custom-theme.md@@ -2,7 +2,7 @@Loaded only when the user has opted into the **custom** theme route in Step 1 of the Design flow. Custom produces a **complete OKLCH palette + free-font pairing tuned to this brief** — a one-off theme written inline into the page's `:root`, not a permanent catalog entry.-**The freedom is the combination, not the rules.** Every constraint in [`color.md`](color.md), [`typography.md`](typography.md), and [`anti-patterns.md`](anti-patterns.md) still applies. The 38 slop-test gates fire unchanged. The Step 5 preview block surfaces the palette + pairing in plain text *before* any code is emitted, so the user can redirect.+**The freedom is the combination, not the rules.** Every constraint in [`color.md`](color.md), [`typography.md`](typography.md), and [`anti-patterns.md`](anti-patterns.md) still applies. The 45 slop-test gates fire unchanged. The Step 5 preview block surfaces the palette + pairing in plain text *before* any code is emitted, so the user can redirect.## Two words, plain Englishdiff --git a/skill/references/interaction-and-states.md b/skill/references/interaction-and-states.mdindex 29dc21f..9d1649b 100644--- a/skill/references/interaction-and-states.md+++ b/skill/references/interaction-and-states.md@@ -63,6 +63,70 @@ Minimum 44×44 CSS px for any touch-reachable element. Use padding or an `::befo- Required fields marked with `aria-required`, never with colour alone.- Disable the submit button only when the form is in a known-invalid or in-flight state. Never on idle.+## Input field states — the exhaustive checklist++This is where the most "almost right" UIs lose. An input field with two states (default + hover) and a different border-width on focus reads as a default settings page — the geometry shifts, the eye notices, the page feels untuned. Every text input, textarea, select, and combobox must satisfy every rule below.++### The no-layout-shift rule++**Border thickness is constant across every state.** Default · hover · focus · error · disabled — the `border-width` value never changes. Layout shift on focus is a tell. State changes go to `background-color`, `outline`, or `box-shadow`, never to `border-width`.++```css+.input {+ border: 1px solid var(--color-rule-2); /* 1px, always — every state */+ outline: 2px solid transparent; /* reserved slot for focus ring; no shift on activate */+ outline-offset: 1px;+}+```++The outline starts transparent at 2 px so when the focus ring appears, the box geometry is already correct. No layout shift. No paint thrash.++### State-by-state recipe++| State | Treatment | Why |+| --- | --- | --- |+| **Default** | `border: 1px solid var(--color-rule-2)` · `background: var(--color-paper)` · placeholder in `var(--color-muted)` | Visible field, readable empty signal |+| **Hover** | `background: var(--color-paper-2)` (4–6 % darker than paper) · border unchanged | Subtle background shift, no border flash. Border colour changing alone is missable. |+| **Focus** | `outline: 2px solid var(--color-focus)` · `outline-offset: 1px` · border may deepen to `var(--color-ink-2)` but width stays 1 px | Outline is the focus signal; never animated; ≥ 3:1 contrast against page AND field. |+| **Active / typing** | Same as focus. Don't add a separate "typing" state. | Focus already says "active here". A second signal is noise. |+| **Filled** | Same as default — the value carries the state. Optionally a subtle ink-2 border to visually distinguish from empty. | Don't fight the user's content with a styled chrome change. |+| **Disabled** | `opacity: 0.55` · `cursor: not-allowed` · placeholder `var(--color-rule-2)` · `aria-disabled="true"` · `tabindex="-1"` | Three independent signals (opacity + cursor + colour) so no single channel carries the whole load. |+| **Error** | `border-color: var(--color-error, oklch(58% 0.20 25))` · helper-text replaced by error message · `aria-invalid="true"` · small ⚠ glyph at right edge | Border colour flip is OK *because* helper-text and aria signal it too. Never colour alone. |+| **Success** | Subtle accent-coloured border (3 % chroma above default) · small ✓ glyph · auto-clear if user re-edits | Quiet; success doesn't deserve celebration unless it was hard. |+| **Loading** (validating, async) | Inline spinner at the right edge replacing the standard glyph slot · field stays editable but submit disabled | Don't lock the user out of the field. They may want to fix what they typed. |++### Heights and rhythm++- **Input height = button height.** A page with 44 px buttons and 38 px inputs feels untuned. Pick one base height (44 px is the touch-target floor) and apply it to every text input AND every adjacent button.+- **Vertical padding = `(height − line-height-px) / 2`.** No magic numbers.+- **Right-edge slot reserved.** Every input reserves a ~24 px right-edge slot for an optional clear button, error glyph, or loading spinner. If unused, the slot sits empty — never reflow on icon appearance.++### Labels, helper, error++- **Label above** the input, 4–8 px gap. Never inline (placeholder-as-label is a tell).+- **Helper text below**, ~4 px gap. Same `font-size` as the label, lower visual weight.+- **Error replaces helper** — same position, same size, error colour. Never both at once (causes vertical jump on validation).+- **Helper has stable height.** Reserve a 1-line height even when empty, so adding an error doesn't push the page down. CSS: `min-height: 1lh` on the helper container.++### Don't, list++- Don't transition `border-width`, `padding`, or `height` on any state. Always layout-shift.+- Don't transition the focus ring's `opacity` or `transform`. Focus must be instant.+- Don't put hover effects inside `@media (hover: hover)` — wait, *do* put them inside `@media (hover: hover)` so touch users don't get stuck states.+- Don't disable the field as a way to indicate "wait, loading" — use a loading state with the field still editable.+- Don't change `cursor` on `:focus`. The pointer is already a beam; don't fight it.+- Don't use `outline: none` on focus without an explicit replacement.++### Specific control overrides++- **Textarea.** Same rules as input, plus `resize: vertical` (never `none`, never `both` on a small textarea), `min-height: 6rem` for multi-line UX.+- **Select.** Custom-styled `<select>` only if you can replicate native a11y (keyboard, screen-reader). Otherwise leave it native and style the wrapper.+- **Checkbox / radio.** Use `accent-color: var(--color-accent)` for cheap correct styling on modern browsers; only build a custom one when the design requires it. If custom: still a 1 px outline-offset focus ring.+- **Toggle / switch.** It IS a checkbox. Same a11y rules. The visual design doesn't change the contract.+- **Range / slider.** The thumb gets focus state, not the track. Thumb hit-target ≥ 44 px even if visual size is smaller (use a transparent expansion).+- **File input.** Always wrap in a styled label. Native `<input type="file">` is unstyleable; the label is the surface.+- **Combobox / search.** Listbox sits below, `aria-expanded` mirrors visibility, arrow-keys cycle, Enter selects, Escape closes — and the listbox doesn't push page content (use `position: absolute` + a parent `position: relative`).+## Modals and overlays- Use the native `<dialog>` element. It handles focus trap, escape to close, and `::backdrop` styling for free.diff --git a/skill/references/slop-test.md b/skill/references/slop-test.mdindex 8c215e4..9261881 100644--- a/skill/references/slop-test.md+++ b/skill/references/slop-test.md@@ -1,4 +1,4 @@-# Slop test — 38 gates+# Slop test — 45 gatesRun this list before handing back any output. Every answer must be **no**. Update the Step 5 preview block's `Slop test` row to reflect the actual outcome of this run.@@ -74,6 +74,23 @@ Some gates are **universal** (apply to every genre); some are **genre-scoped** (37. For every decorative effect on text — highlighter `<mark>` / `<em>` band / accent stroke / underline — did I visually confirm the position and size? A highlighter band must sit behind the x-height (`linear-gradient(180deg, transparent ~38%, accent ~38%, accent ~92%, transparent ~92%)`), **not** at the baseline (which reads as a fat underline). Underlines must be 1–2 px and offset 1–2 px from the baseline, never 5+ px. Decorative strokes must not exceed 5 % of the viewport (gate 25). The check is *visual*: imagine the rendered output and confirm the band lands in the right vertical zone.38. Are interactive bars (nav, toolbar, command bar, hero CTA row, footer link strip) explicitly vertically centered? Default flex layouts inherit `align-items: stretch`, which makes a button taller than its sibling text and breaks the visual baseline. Every flex row mixing height-different elements (button + text, icon + text, mark + body) must declare `align-items: center` and `line-height: 1` on the items with intrinsic height. Inheriting `line-height: 1.55` from `html` fights the row's vertical rhythm.+## Typography discipline gates++(Three faces is the ceiling. See [`typography.md` § The 2+1 rule](typography.md).)++39. Does the page use **more than three** distinct `font-family` families? Count: `--font-display`, `--font-body`, and at most one outlier (`--font-outlier` for wordmark / hero stat / pull quote). A fourth family on the page — e.g. body + display + mono in code blocks + a separate display for the hero — is slop. Same family at different weights counts as one family. Mono counts as a family if used in any non-code context (captions, labels, numerals). If you find four, drop one back to the body or display face.+40. Is the **outlier face used in more than two slots** on the page? The outlier is a register, not a third surface — wordmark + hero stat is the canonical pair, or wordmark + masthead, or hero stat + pull quote. Three slots = the outlier is now a third body font; collapse it back to the body face.++## Input-state gates++(Inputs are where almost-right UIs lose. See [`interaction-and-states.md` § Input field states](interaction-and-states.md).)++41. Does any input, textarea, or select field change `border-width` between states (default → hover → focus → error)? Default is 1 px; hover, focus, and error must keep `border-width: 1px`. Border-width changes cause layout shift. State changes go to `background-color`, `outline`, `box-shadow`, or `border-color` — never `border-width`.+42. Does the input focus ring use `border` instead of `outline`? The focus ring must be `outline: 2px solid var(--color-focus)` with `outline-offset: 1px`. Reserving `outline: 2px solid transparent` in the default state prevents geometry shift on activate. A focus ring built from a `border` change is a tell.+43. Is the input height different from the height of an adjacent button on the same form? Form inputs and the form's submit button share a single base height (44 px floor). 38 px input + 44 px button is the most common form-tuning slop and reads as un-designed.+44. Is the helper-text container collapsed when no helper or error is shown? The helper slot must reserve `min-height: 1lh` even when empty so that an error appearing doesn't push the page down. Vertical jump on validation is a tell.+45. Is the disabled input state signalled by *only* `opacity: 0.5`? Disabled needs three independent signals: `opacity: 0.55` AND `cursor: not-allowed` AND `aria-disabled="true"` (or the native `disabled` attribute). One channel is missable; three are not.+---If any answer is **yes**, fix it. Do not ship slop.diff --git a/skill/references/typography.md b/skill/references/typography.mdindex b93673b..1a0aca1 100644--- a/skill/references/typography.md+++ b/skill/references/typography.md@@ -10,6 +10,29 @@ Type carries the design. If the type is wrong, nothing else matters.- Line-height changes with size. Tight for display (1.05–1.2), comfortable for body (1.5–1.65).- Measure — line length — lives between 45 and 75 characters. Use `max-width: 65ch` as the default.+## The 2+1 rule — three faces is the ceiling++**A page may use at most three distinct font families.** One **display**, one **body**, and an optional **outlier** for a single typographic moment — wordmark, hero stat, pull quote, masthead — where the page wants exactly one note that doesn't sound like the rest. Four families is slop. Two is canonical. Three is the ceiling, used sparingly.++The pattern:++```css+:root {+ --font-display: "Fraunces", ui-serif, Georgia, serif; /* headings, hero */+ --font-body: "Geist", ui-sans-serif, system-ui, sans; /* prose, UI */+ --font-outlier: "Geist Mono", ui-monospace, monospace; /* wordmark + hero stat ONLY */+}+```++The outlier is a *register*, not a third surface. Rules:++- **Outlier appears in ≤ 2 places** on the whole page. Wordmark + hero stat. Or pull quote + masthead. Two slots, not five. If you find yourself reaching for it a third time, you don't have an outlier — you have a third body font, which is slop.+- **The outlier carries one role.** It tags a specific kind of content (the brand, the headline figure, the manifesto line). Once you know what it tags, every instance of that role uses it. Don't apply it to one button label and not another.+- **Mono counts as a face.** A page with Fraunces display, Geist body, and Geist Mono in code blocks is using three families. That's fine — code is the outlier role. Don't sneak in a fourth.+- **Same family at different weights is one family**, not two. Geist 400 + Geist 700 is one font; pairing it with Fraunces is two. Adding Geist Mono on top is three.++Two families is still the right answer for most pages. Three is for SaaS / brand-heavy / editorial-rich pages where the wordmark needs a different register than the body.+## Banned defaultsThese fonts are on-distribution for every LLM. Do not reach for them without a deliberate reason:@@ -20,30 +43,97 @@ These fonts are on-distribution for every LLM. Do not reach for them without a dIf the user insists on one, do it. Otherwise pick from the allowlist below.-## Pairing patterns that work--Each tone gets two rows: a **free baseline** (everything Google-Fonts-or-similar; works out of the box) and a **paid upgrade** (foundry licences required; only when the user has confirmed the budget and the licence). The free row is the default. **Never name a paid font in code without confirming the user is licensed** — the demo will fall back to system-default and look broken to the user.--| Tone | Tier | Display | Body | Mono |+## The font catalog++Three sources, in priority order:++- **Google Fonts** — free, served via CDN, works everywhere. The default source.+- **Fontshare** (Indian Type Foundry) — free for commercial use, foundry-grade. The "you didn't know these were free" tier. Drop-in via `<link href="https://api.fontshare.com/v2/css?f=...">`.+- **Foundry-licensed** — Klim, Pangram Pangram, Production Type, Lineto, Colophon. Only when the user has confirmed they're licensed.++### Free display faces++| Family | Source | Voice | Best for |+| --- | --- | --- | --- |+| **Fraunces** | Google | Variable serif, deeply expressive italic, optical-size axis | Editorial, Salon, Atelier, brand-heavy |+| **Newsreader** | Google | Roman serif with optical-size + italic | Editorial, magazine, long-form |+| **Instrument Serif** | Google | Tight contrast, italic available, smart for short heads | Brand, atelier, intimate editorial |+| **Cormorant Garamond** | Google | Classical, high contrast, luxury register | Luxury, fashion, fine arts |+| **EB Garamond** | Google | Honest classical Garamond, body-grade | Editorial body, longform reading |+| **Cardo** | Google | Scholarly serif, generous x-height | Reference, academic, slow reading |+| **Source Serif 4** | Google | Modern transitional, big OT family | SaaS marketing with serif tone |+| **DM Serif Display** | Google | Bracketed serif, high-contrast display | Headlines that need to feel printed |+| **Bodoni Moda** | Google | Modern Bodoni revival, dramatic | Fashion, editorial, luxury display |+| **Playfair Display** | Google | Use only as display; banned as body | Marketing display moments — sparingly |+| **Geist** | Google | Modern grotesque, geometric, 7 weights | Modern minimal, SaaS, dev tools |+| **Inter Tight** | Google | Tighter Inter — allowed *only* as a body fallback in technical themes; never as display | UI body in restrained themes |+| **Bricolage Grotesque** | Google | Variable display sans, bold weights, condensable | Brutal, playful, riso-bold |+| **Space Grotesk** | Google | Geometric grotesque, slightly quirky | Brutalist, technical |+| **Anton** | Google | Heavy condensed grotesque | Posters, manifestos |+| **Big Shoulders Display** | Google | Industrial condensed | Sports, manifestos, declarative |+| **Tomorrow** | Google | Variable optical condensed | Tech, atmospheric, near-future |+| **Outfit** | Google | Modern geometric (banned as default; use only when *picked* deliberately) | Restrained tech — sparingly |+| **General Sans** | Fontshare | Modern grotesque, Geist-adjacent | Modern minimal alternative to Geist |+| **Switzer** | Fontshare | Neutral sans, broad weight range | SaaS body, restrained |+| **Cabinet Grotesk** | Fontshare | Display grotesque, 9 weights | Editorial display, magazine |+| **Clash Display** | Fontshare | Ultra-condensed display | Posters, brand moments |+| **Satoshi** | Fontshare | Playful geometric sans | Playful, consumer |+| **Sentient** | Fontshare | Variable serif, soft contrast | Soft editorial, atmospheric |+| **Erode** | Fontshare | Distressed serif, hand-set feel | Riso, tactile-rebellion, brand-y |+| **Tanker** | Fontshare | Heavy condensed grotesque, pure display | One-word posters, mastheads |++### Free body faces++| Family | Source | Voice | Best for |+| --- | --- | --- | --- |+| **Geist** | Google | The default modern body sans | Modern minimal, SaaS, atmospheric |+| **The Future** | (in repo) | Hallmark's own body workhorse | Default Hallmark tone |+| **Newsreader** | Google | Reading serif, optical-size aware | Editorial body, longform |+| **Source Serif 4** | Google | Body-grade serif | Editorial mid-weight |+| **EB Garamond** | Google | Classical body | Editorial slow reading |+| **Spectral** | Google | Slab-ish serif, screen-tuned | Long-form on screen |+| **Lora** | Google | Calligraphic serif, body-grade | Body — sparingly (over-used) |+| **Crimson Pro** | Google | Old-style body, generous | Editorial slow body |+| **IBM Plex Sans** | Google | Engineering sans, broad family | Technical body |+| **Switzer** | Fontshare | Neutral sans body | SaaS body, restrained |+| **General Sans** | Fontshare | Geist-adjacent body | Modern minimal body |++### Free mono / outlier faces++| Family | Source | Voice | Best for |+| --- | --- | --- | --- |+| **Geist Mono** | Google | Geist's mono companion | Default Hallmark mono, code, captions |+| **JetBrains Mono** | Google | Engineering mono, ligatures | Code, terminal, technical |+| **IBM Plex Mono** | Google | Engineering mono, broad family | Technical body-grade |+| **Commit Mono** | Google | Tighter mono, modern | Code, modern terminal |+| **Space Mono** | Google | Quirky, slightly retro | Playful tech, riso |++### Tone-based pairing patterns++Each tone gets two rows: a **free baseline** (Google Fonts / Fontshare; works out of the box) and a **paid upgrade** (foundry licences required; only when the user has confirmed the budget and the licence). The free row is the default. **Never name a paid font in code without confirming the user is licensed** — the demo will fall back to system-default and look broken to the user.++| Tone | Tier | Display | Body | Outlier || --- | --- | --- | --- | --- |-| **Editorial** | Free | Fraunces · Newsreader · EB Garamond | IBM Plex Sans · Inter Tight | JetBrains Mono · Geist Mono |-| | *Paid* | *Tiempos Headline · Söhne Breit · Reckless Display* | *Söhne · Haffer · Untitled Sans* | *Söhne Mono · GT America Mono* |-| **Technical** | Free | JetBrains Mono · Geist Mono · Geist (700) | Geist · IBM Plex Sans | Geist Mono · JetBrains Mono |-| | *Paid* | *Berkeley Mono · Söhne Mono · GT Pressura* | *Söhne · Untitled Sans* | *Berkeley Mono · GT Pressura Mono* |-| **Brutalist** | Free | Inter Tight (heavy) · Anton · Bricolage Grotesque (800) | Inter · Geist | Geist Mono |-| | *Paid* | *Druk · Monument Extended · NaN Jaune · Migra* | *Söhne Breit · GT America* | *GT America Mono* |-| **Soft** | Free | Geist · Bricolage Grotesque (500) · Newsreader | Geist · Crimson Pro | Geist Mono |-| | *Paid* | *Söhne · GT Pressura · Pangaia* | *Söhne · Halyard Text* | *Söhne Mono* |-| **Luxury** | Free | Cormorant Garamond · Fraunces · Cardo | EB Garamond · Crimson Pro | (rare; if needed: JetBrains Mono) |-| | *Paid* | *Canela · Tiempos Headline · GT Super · Domaine Display* | *Tiempos Text · Suisse Int'l · Domaine Text* | *(rarely used at this tier)* |-| **Playful** | Free | Bricolage Grotesque · Fraunces (italic) · Newsreader (italic) | Geist · Newsreader | Geist Mono |-| | *Paid* | *Clash Display · Cabinet Grotesk · Migra · Tobias* | *Satoshi · Plus Jakarta Sans · GT Maru* | *Space Mono · GT Maru Mono* |-| **Austere** | Free | system-ui · Inter Tight (regular) · Geist (400) | system-ui · Geist | system-ui · Geist Mono |+| **Editorial** | Free | Fraunces · Newsreader · EB Garamond · Instrument Serif · Cabinet Grotesk | IBM Plex Sans · Switzer · Source Serif 4 | JetBrains Mono · Geist Mono · Erode (display moment) |+| | *Paid* | *Tiempos Headline · Söhne Breit · Reckless Display · Migra · Tobias* | *Söhne · Haffer · Untitled Sans* | *Söhne Mono · GT America Mono* |+| **Technical** | Free | JetBrains Mono · Geist Mono · Geist (700) · Commit Mono | Geist · IBM Plex Sans · Switzer | Tomorrow · Cabinet Grotesk (wordmark) |+| | *Paid* | *Berkeley Mono · Söhne Mono · GT Pressura · ABC Diatype Mono* | *Söhne · Untitled Sans · ABC Diatype* | *Berkeley Mono · GT Pressura Mono* |+| **Brutalist** | Free | Bricolage Grotesque (800) · Anton · Tanker · Big Shoulders Display | Geist · Switzer | Space Grotesk (numerals) · Geist Mono |+| | *Paid* | *Druk · Monument Extended · NaN Jaune · Migra · ABC Pressura* | *Söhne Breit · GT America* | *GT America Mono* |+| **Soft** | Free | Geist · Bricolage Grotesque (500) · Sentient · Newsreader | Geist · Crimson Pro · Switzer | Geist Mono · Satoshi (label) |+| | *Paid* | *Söhne · GT Pressura · Pangaia · Tobias* | *Söhne · Halyard Text · Satoshi* | *Söhne Mono · GT Maru Mono* |+| **Luxury** | Free | Cormorant Garamond · Fraunces · Cardo · DM Serif Display · Bodoni Moda | EB Garamond · Crimson Pro · Source Serif 4 | (rare; small caps from display family) |+| | *Paid* | *Canela · Tiempos Headline · GT Super · Domaine Display · Migra* | *Tiempos Text · Suisse Int'l · Domaine Text* | *(rarely used at this tier)* |+| **Playful** | Free | Bricolage Grotesque · Fraunces (italic) · Satoshi · Newsreader (italic) · Sentient | Geist · Newsreader · Satoshi | Geist Mono · Space Mono |+| | *Paid* | *Clash Display · Cabinet Grotesk · Migra · Tobias · Pangaia* | *Satoshi · Plus Jakarta Sans · GT Maru* | *Space Mono · GT Maru Mono* |+| **Austere** | Free | system-ui · Inter Tight (regular) · Geist (400) · Switzer (regular) | system-ui · Geist · Switzer | system-ui mono · Geist Mono || | *Paid* | *ABC Diatype · ABC Monument Grotesk · Söhne (regular) · ABC Pressura* | *ABC Diatype · Söhne* | *ABC Diatype Mono · Söhne Mono* |-| **Workshop** *(Hallmark's own theme)* | Free | The Future · Geist · Inter Tight | The Future · Söhne | The Future Mono · Geist Mono |+| **Atmospheric** | Free | Geist (600) · Sentient · Tomorrow · Bricolage Grotesque | Geist (400) · Switzer | Geist Mono · JetBrains Mono |+| | *Paid* | *Söhne · GT Pressura · ABC Diatype* | *Söhne · ABC Diatype* | *Berkeley Mono · Söhne Mono* |+| **Workshop** *(Hallmark's own theme)* | Free | The Future · Geist · Cabinet Grotesk | The Future · Switzer | The Future Mono · Geist Mono || | *Paid* | *Avenir Next · GT Walsheim* | *Söhne · GT Walsheim* | *Berkeley Mono* |-**The discipline.** Default to the free pairings. They're not consolation prizes; Fraunces, Geist, Bricolage Grotesque, and JetBrains Mono are first-rate faces in 2026. The paid upgrades exist for two cases: (a) the user has explicitly confirmed they're licensed, or (b) the user is asking for a specific named foundry voice (e.g., "make it look like Klim", "I want Söhne"). Reach for Tier 2 only then; otherwise the free row is the right answer. Treat the free row as canon, the paid row as a *cited* alternative.+**The discipline.** Default to the free pairings. They're not consolation prizes; Fraunces, Geist, Bricolage Grotesque, Cabinet Grotesk, Sentient, and JetBrains Mono are first-rate faces in 2026. The paid upgrades exist for two cases: (a) the user has explicitly confirmed they're licensed, or (b) the user is asking for a specific named foundry voice (e.g., "make it look like Klim", "I want Söhne"). Reach for Tier 2 only then; otherwise the free row is the right answer. Treat the free row as canon, the paid row as a *cited* alternative.## Wordmark / logo typography@@ -134,3 +224,5 @@ Use no more than five sizes on a single page. If you need more hierarchy, use we- No all-caps paragraphs.- No font-size below 14px for body copy, below 10px anywhere.- No hard-synthesised bold or italic.+- **No more than three font families on a single page.** Display + body + one outlier is the ceiling. Four families = slop. Audit gate.+- No outlier face used in more than two slots. Wordmark + hero stat is the canonical pair; if you reach for a third slot, drop it back to the body face.diff --git a/skill/references/verbs/redesign.md b/skill/references/verbs/redesign.mdindex fa86397..dd18d7a 100644--- a/skill/references/verbs/redesign.md+++ b/skill/references/verbs/redesign.md@@ -126,7 +126,7 @@ For each target page:### 4. Diversification rule — INVERTED for multi-page-Across pages of the same app, the diversification rule is *inverted*: consecutive pages MUST share theme, accent, type pairing. They may differ on macrostructure within the family. The 38 slop-test gates that check "differs from previous Hallmark run" are skipped for `designed-as-app` outputs — the system overrides the catalog rotation here.+Across pages of the same app, the diversification rule is *inverted*: consecutive pages MUST share theme, accent, type pairing. They may differ on macrostructure within the family. The 45 slop-test gates that check "differs from previous Hallmark run" are skipped for `designed-as-app` outputs — the system overrides the catalog rotation here.Pages that drift from `design.md` are slop. The audit verb flags `design.md` drift as a critical structural finding (`stamp-vs-design.md disagreement`).