Skip to content

Anti-AI-slop design skill for Claude Code, Cursor, and Codex.

CSS

The floor holds the mechanics; it never picks the direction

Youssef869d6be23ee6
diff --git a/README.md b/README.md
index ff60c36..5ef1d65 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,11 @@ Made by Together AI.
<img src="site/OG-hallmark.png" alt="Hallmark, a design skill that refuses to look AI-generated" />
</p>
-Hallmark picks a macrostructure for the brief, dresses it in one of twenty-four themes, runs fifty-eight slop-test gates plus a pre-emit self-critique, and refuses the on-distribution defaults every LLM was trained into. Two pages by Hallmark for two different briefs feel like different sites, not colour-swaps of the same template.
+Hallmark holds a hard floor and then gets out of the way. It dresses the brief in one of twenty-four themes, runs a fifty-eight-gate slop test plus a pre-emit self-critique, and refuses the on-distribution defaults every LLM was trained into.
+
+Thirty-four of those gates are a **floor**: contrast, focus order, reduced motion, invented metrics, layout that breaks on a phone, and the eyebrow above the heading. Nothing ships through them. Eighteen are **reflex** gates, the defaults a language model falls into rather than laws, and a build with an argument can waive one on the record: three at most, reason named in the CSS stamp, guard checked mechanically. The last six are polish and bookkeeping and never block a ship.
+
+Two pages by Hallmark for two different briefs feel like different sites, not colour-swaps of the same template. The skill is built to stop a model looking generic, not to stop it being good.
---
@@ -75,7 +79,7 @@ Each page is self-contained HTML + CSS, stamped with its macrostructure in the C
## Custom
-When a brief carries creative intent that no catalog theme fits, Hallmark switches to **Custom** and designs the page from scratch: a made-to-measure palette, type, and layout. Same 58 slop-test gates, no template underneath.
+When a brief carries creative intent that no catalog theme fits, Hallmark switches to **Custom** and designs the page from scratch: a made-to-measure palette, type, and layout. Same fifty-eight gates at the same tiers, no template underneath.
In v1.2 the custom route runs a full art-direction ritual: it names and rejects the category's reflex aesthetics, writes a slate of seven grounded directions, and a deterministic **draw** (`scripts/seed.mjs`) picks which one gets built, sometimes dealing wildcards from a design-history atlas. A scene sentence sets the light, a colour posture (Restrained · Committed · Full palette · Drenched) sets how far the palette commits, and a five-block direction contract written into the artifact gets audited promise by promise before shipping.
diff --git a/ROADMAP.md b/ROADMAP.md
index 5d5a61b..e1e2cf2 100644
--- a/ROADMAP.md
+++ b/ROADMAP.md
@@ -2,10 +2,22 @@
What's next. (v1.2 shipped: four new themes with the image hook, spec files for all 24 themes, the edit-time lint hook, the Tier A conformance harness, variants v2 with progressive reveal + grafts + thumbnails + scoped injection and the corner dock, and the harness pivot - one core with per-harness adapters for Claude Code / Codex / OpenCode plus the multi-harness installer.)
+**Since v1.2: the floor / library split.** The eyebrow is banned outright, in every geometry, with a DOM-shape detector behind it and twelve replacement openings in `section-entry.md`. The 58 gates gained tiers: 34 carry a Floor clause that nothing ships through, 18 are Reflex gates a build can waive on the record (three per artifact, guard re-derived mechanically), 6 never block. Themes were cut to a written contract and are material rather than page plans, which took them from 4,070 lines to 2,861. The catalogs stopped being a mandatory pick and became a place to look.
+
---
## Now
+**Regenerate the marketing screenshots.** The 18 hero captures in `docs/screenshots/` and the gallery thumbnails under `site/_tests/_thumbs/` still show the eyebrows that were removed from the example pages. They are stale evidence on the README and the homepage until they are recaptured.
+
+**Give the Finish tier a stamp form.** A Reflex gate can be waived on the record and the linter reads it. A Finish finding is supposed to be "read and answered", but there is no syntax for an answered-and-dismissed one, so a build that reasons its way past gate 38 writes freeform prose the linter cannot see and the next run cannot parse. Either an `answered` stamp line with the same three-field shape, or an explicit statement that Finish findings need no record.
+
+**Decide how many times a build restates its own decisions.** The Picks block, the Step 5 preview, the CSS stamp and the log entry carry substantially the same content. None of it is design work, and it is the largest remaining ceremony cost. The preview block is the likeliest cut: the Picks block already carries everything except the enrichment answer.
+
+**`copy.md` still mandates em and en dashes** (§ Punctuation) while the repo's own house rule bans them, so a build that follows the skill faithfully reintroduces them into page copy. Worth resolving in one direction or the other rather than leaving the skill arguing with its owner.
+
+**Two more index-then-pick candidates.** `copy.md` is ~184 lines of which most are voice samples for tones a given build is not using, and `typography.md`'s font catalog is dead weight whenever a catalog theme has already named its three faces. Both are on the every-build list; scoping them would save roughly 200 lines per run.
+
**Conformance on all three harnesses.** Tier A (`gen-cli.mjs`) drives Claude Code today; run it in a logged-in terminal. Next: the same conformance pass through `codex exec` and OpenCode's non-interactive run, asserting each harness loads its adapter (`harnesses/codex.md` / `harnesses/opencode.md`), holds the load-order discipline, and lands 0-FAIL sloplint. (The old Tier B bare-API open-model matrix is retired from the roadmap; the tooling stays in `eval/` as an archive.)
**Measure the variants speedup.** `eval/variants-bench.md` documents the four-config protocol; run it on a real authenticated machine and publish the wall-clock + token table (parallel + sketch + progressive vs the v1 baseline).
diff --git a/docs/recipes.md b/docs/recipes.md
index 5cca1cc..6cf0fcf 100644
--- a/docs/recipes.md
+++ b/docs/recipes.md
@@ -162,7 +162,7 @@ The first recipe is the **canonical try-it prompt** — paste it into a fresh pr
**Excerpt:**
-> Centred eyebrow: *"Built for educators · not LMS sales teams."* Hero stat at 22 rem: **"30 — 500"** (with the dash in warm-amber). Headline: *"Live courses, the size your roster actually is."* Sub: *"Cohort runs courses with thirty to five hundred students at once — the size of a real classroom, the size of a real lecture, and a few sizes between. With a date, a roster, and a room."* Below: three supporting stats (186 cohorts run · 93 % finish-rate · 4.7/5 operator NPS). Two operator testimonials side-by-side. Two-tier pricing (First cohort free · Operator $199/mo). Single CTA strip and colophon. No marquee, no card-stack — the brief carried by the typography.
+> Opens on a rule, no label. Hero stat at 22 rem: **"30 — 500"** (with the dash in warm-amber). Headline: *"Live courses, the size your roster actually is."* Sub: *"Cohort runs courses with thirty to five hundred students at once — the size of a real classroom, the size of a real lecture, and a few sizes between. With a date, a roster, and a room."* Below: three supporting stats (186 cohorts run · 93 % finish-rate · 4.7/5 operator NPS). Two operator testimonials side-by-side. Two-tier pricing (First cohort free · Operator $199/mo). Single CTA strip and colophon. No marquee, no card-stack — the brief carried by the typography.
**Live:** [`_tests/08-cohort-courses/`](../../site/_tests/08-cohort-courses/index.html)
diff --git a/site/_tests/04-meridian-manifesto/index.html b/site/_tests/04-meridian-manifesto/index.html
index f855c9c..083b9b8 100644
--- a/site/_tests/04-meridian-manifesto/index.html
+++ b/site/_tests/04-meridian-manifesto/index.html
@@ -25,10 +25,9 @@
</section>
<section class="principles" aria-labelledby="principles-h">
- <h2 class="principles__head" id="principles-h">§ Four principles</h2>
+ <h2 class="principles__head" id="principles-h">Four principles. We turn work down over them.</h2>
<ol class="principles__list">
<li class="principle">
- <span class="principle__num">01.</span>
<h3 class="principle__head">Fewer things, made well</h3>
<p class="principle__body">
We don't pitch ranges. We don't pitch families. The studio works on one product at a
@@ -37,7 +36,6 @@
</p>
</li>
<li class="principle">
- <span class="principle__num">02.</span>
<h3 class="principle__head">Material is the brief</h3>
<p class="principle__body">
Every project starts with the material accounting — what it's made of, where it comes
@@ -46,7 +44,6 @@
</p>
</li>
<li class="principle">
- <span class="principle__num">03.</span>
<h3 class="principle__head">Repair before replace</h3>
<p class="principle__body">
Every product ships with a service manual, an exploded BOM, and the tools to take it
@@ -55,7 +52,6 @@
</p>
</li>
<li class="principle">
- <span class="principle__num">04.</span>
<h3 class="principle__head">Slow is the deliverable</h3>
<p class="principle__body">
We work with three clients a year. We turn the rest down. <strong>Slow is a craft
@@ -67,13 +63,13 @@
</section>
<section class="rules" aria-labelledby="rules-h">
- <h2 class="rules__head" id="rules-h">§ Working rules</h2>
+ <h2 class="rules__head" id="rules-h">Five working rules, and we do not bend them.</h2>
<ol class="rules__list">
- <li class="rules__item"><span class="rules__num">i.</span><span>The shop runs on a four-day week. Friday is for the workshop.</span></li>
- <li class="rules__item"><span class="rules__num">ii.</span><span>We answer the email ourselves. There is no account manager.</span></li>
- <li class="rules__item"><span class="rules__num">iii.</span><span>The first thing we send is the spec. The render comes after.</span></li>
- <li class="rules__item"><span class="rules__num">iv.</span><span>We don't sign NDAs that prevent us from naming the material.</span></li>
- <li class="rules__item"><span class="rules__num">v.</span><span>We publish what we learn. The notes are the practice.</span></li>
+ <li class="rules__item">The shop runs on a four-day week. Friday is for the workshop.</li>
+ <li class="rules__item">We answer the email ourselves. There is no account manager.</li>
+ <li class="rules__item">The first thing we send is the spec. The render comes after.</li>
+ <li class="rules__item">We don't sign NDAs that prevent us from naming the material.</li>
+ <li class="rules__item">We publish what we learn. The notes are the practice.</li>
</ol>
</section>
diff --git a/site/_tests/04-meridian-manifesto/style.css b/site/_tests/04-meridian-manifesto/style.css
index 7154898..0c12cd7 100644
--- a/site/_tests/04-meridian-manifesto/style.css
+++ b/site/_tests/04-meridian-manifesto/style.css
@@ -128,15 +128,22 @@ body {
border-block-end: 1px solid var(--color-rule);
}
-.principles__head {
- font-family: var(--font-mono);
- font-size: 0.75rem;
- letter-spacing: 0.16em;
+/* Section heads are headings, not labels: display scale, above the h3s they
+ govern, so the hierarchy runs the right way down the page. */
+.principles__head,
+.rules__head {
+ font-family: var(--font-display);
+ font-size: clamp(2.25rem, 4.5vw, 3.5rem);
+ font-weight: 700;
+ line-height: 1.02;
+ letter-spacing: -0.005em;
text-transform: uppercase;
- color: var(--color-ink-soft);
- margin: 0 0 var(--space-2xl);
+ color: var(--color-ink);
+ max-width: 22ch;
}
+.principles__head { margin: 0 0 var(--space-2xl); }
+
.principles__list {
display: grid;
grid-template-columns: repeat(2, 1fr);
@@ -144,14 +151,19 @@ body {
list-style: none;
padding: 0;
margin: 0;
+ counter-reset: principle;
}
+/* The sequence is real, so the list element says so and counter() draws every
+ figure. No hand-typed 01 left in the markup. */
.principle {
+ counter-increment: principle;
border-block-start: 1px solid var(--color-rule);
padding-block-start: var(--space-md);
}
-.principle__num {
+.principle::before {
+ content: counter(principle, decimal-leading-zero) ".";
font-family: var(--font-mono);
font-size: 0.75rem;
letter-spacing: 0.16em;
@@ -189,14 +201,7 @@ body {
border-block-end: 1px solid var(--color-rule);
}
-.rules__head {
- font-family: var(--font-mono);
- font-size: 0.75rem;
- letter-spacing: 0.16em;
- text-transform: uppercase;
- color: var(--color-ink-soft);
- margin: 0 0 var(--space-lg);
-}
+.rules__head { margin: 0 0 var(--space-lg); }
.rules__list {
display: grid;
@@ -204,9 +209,11 @@ body {
list-style: none;
padding: 0;
margin: 0;
+ counter-reset: rule;
}
.rules__item {
+ counter-increment: rule;
display: grid;
grid-template-columns: 4ch 1fr;
gap: var(--space-md);
@@ -218,15 +225,16 @@ body {
color: var(--color-ink);
}
-.rules__item:last-child { border-block-end: none; }
-
-.rules__num {
+.rules__item::before {
+ content: counter(rule, lower-roman) ".";
font-family: var(--font-mono);
font-size: 0.875rem;
letter-spacing: 0.06em;
color: var(--color-accent);
}
+.rules__item:last-child { border-block-end: none; }
+
/* Colophon */
.colophon {
padding: var(--space-md) var(--space-lg);
diff --git a/site/_tests/05-tracejam-saas/index.html b/site/_tests/05-tracejam-saas/index.html
index 59e35b0..800f782 100644
--- a/site/_tests/05-tracejam-saas/index.html
+++ b/site/_tests/05-tracejam-saas/index.html
@@ -24,11 +24,11 @@
<section class="hero">
<div class="hero__copy">
- <p class="hero__eyebrow">For SREs &amp; platform engineers</p>
<h1 class="hero__head">Distributed tracing that <em>explains itself.</em></h1>
<p class="hero__sub">
- Open the trace. Find the span that regressed. Read why — in plain text — without a glossary,
- a YAML diff, or a status-page hunt. The post-mortem starts in the trace, not in a doc.
+ Tracejam is built for SREs and platform engineers. Open the trace, find the span that
+ regressed, and read why in plain text, without a glossary, a YAML diff, or a status-page
+ hunt. The post-mortem starts in the trace, not in a doc.
</p>
<div class="hero__cta">
<a class="btn btn--primary" href="#">Try it free <span aria-hidden="true">→</span></a>
@@ -104,7 +104,7 @@
</section>
<section class="integrations" id="integrations">
- <h2 class="integrations__head">Reads from</h2>
+ <h2 class="integrations__head">Reads from the tracing you already run.</h2>
<ul class="integrations__grid">
<li>OpenTelemetry</li>
<li>Jaeger</li>
@@ -118,7 +118,7 @@
</section>
<section class="pricing" id="pricing">
- <h2 class="pricing__head">Pricing</h2>
+ <h2 class="pricing__head">Priced on ingest, with a free tier teams actually stay on.</h2>
<div class="tiers">
<article class="tier">
<h3 class="tier__name">Free</h3>
diff --git a/site/_tests/05-tracejam-saas/style.css b/site/_tests/05-tracejam-saas/style.css
index 7c9cfe4..dcdce79 100644
--- a/site/_tests/05-tracejam-saas/style.css
+++ b/site/_tests/05-tracejam-saas/style.css
@@ -95,15 +95,6 @@ body {
.hero__copy { max-width: 36rem; }
-.hero__eyebrow {
- font-family: var(--font-display);
- font-size: 0.75rem;
- letter-spacing: 0.12em;
- text-transform: uppercase;
- color: var(--color-accent);
- margin: 0 0 var(--space-md);
-}
-
.hero__head {
font-family: var(--font-display);
font-size: clamp(2rem, 4.5vw, 3.75rem);
@@ -336,10 +327,12 @@ body {
.integrations__head {
font-family: var(--font-display);
- font-size: 0.75rem;
- letter-spacing: 0.12em;
- text-transform: uppercase;
- color: var(--color-ink-soft);
+ font-size: clamp(1.5rem, 2.5vw, 2rem);
+ font-weight: 500;
+ letter-spacing: -0.015em;
+ line-height: 1.1;
+ color: var(--color-ink);
+ max-width: 26ch;
margin: 0 0 var(--space-lg);
}
@@ -368,12 +361,16 @@ body {
border-block-end: 1px solid var(--color-rule);
}
+/* A section head is a head. "Pricing" in 12px caps was a label wearing an h2,
+ and the tier names below it were doing the heading's job. */
.pricing__head {
font-family: var(--font-display);
- font-size: 0.75rem;
- letter-spacing: 0.12em;
- text-transform: uppercase;
- color: var(--color-ink-soft);
+ font-size: clamp(1.5rem, 2.5vw, 2rem);
+ font-weight: 500;
+ letter-spacing: -0.015em;
+ line-height: 1.1;
+ color: var(--color-ink);
+ max-width: 26ch;
margin: 0 0 var(--space-2xl);
}
diff --git a/site/_tests/06-anya-portfolio/index.html b/site/_tests/06-anya-portfolio/index.html
index 16f9091..d9bcd78 100644
--- a/site/_tests/06-anya-portfolio/index.html
+++ b/site/_tests/06-anya-portfolio/index.html
@@ -33,7 +33,6 @@
<article class="main">
<section class="section" id="index">
- <p class="section__num">00 · Index</p>
<h1 class="section__head section__head--lede">A small, scannable index of who I am and what I do.</h1>
<div class="section__body">
<p>
@@ -50,7 +49,6 @@
</section>
<section class="section" id="now">
- <p class="section__num">01 · Now</p>
<h2 class="section__head">Consulting, two clients at a time.</h2>
<div class="section__body">
<p>
@@ -68,7 +66,6 @@
</section>
<section class="section" id="years">
- <p class="section__num">02 · Years</p>
<h2 class="section__head">Where I've worked, in tabular form.</h2>
<div class="section__body">
<table class="years" aria-label="Work history">
@@ -86,7 +83,6 @@
</section>
<section class="section" id="writing">
- <p class="section__num">03 · Writing</p>
<h2 class="section__head">Five pieces I'd point at first.</h2>
<div class="section__body">
<ul class="writing">
@@ -130,7 +126,6 @@
</section>
<section class="section" id="reach">
- <p class="section__num">04 · Reach</p>
<h2 class="section__head">The four places I read mail.</h2>
<div class="section__body">
<div class="contact">
diff --git a/site/_tests/06-anya-portfolio/style.css b/site/_tests/06-anya-portfolio/style.css
index 5eccc21..7ba1863 100644
--- a/site/_tests/06-anya-portfolio/style.css
+++ b/site/_tests/06-anya-portfolio/style.css
@@ -123,20 +123,19 @@ body {
/* Main content column */
.main { min-width: 0; max-width: 56rem; }
+/* The sticky index on the left is this page's running folio: it holds 00 to 04
+ and stays in view the whole way down. So a section needs no line introducing
+ itself, only a break. One hairline, repeated, is the break. */
.section {
- margin-block-end: var(--space-3xl);
+ margin-block-end: var(--space-2xl);
scroll-margin-top: var(--space-2xl);
}
.section:first-of-type { margin-block-start: 0; }
-.section__num {
- font-family: var(--font-mono);
- font-size: 0.75rem;
- letter-spacing: 0.12em;
- text-transform: uppercase;
- color: var(--color-accent);
- margin: 0 0 var(--space-md);
+.section + .section {
+ border-block-start: 1px solid var(--color-rule);
+ padding-block-start: var(--space-2xl);
}
.section__head {
diff --git a/site/_tests/07-foundry-compliance/index.html b/site/_tests/07-foundry-compliance/index.html
index 80f6f89..7fc0199 100644
--- a/site/_tests/07-foundry-compliance/index.html
+++ b/site/_tests/07-foundry-compliance/index.html
@@ -25,7 +25,7 @@
<section class="hero">
<div class="hero__copy">
- <p class="hero__eyebrow">SOC 2 · ISO 27001 · automated</p>
+ <p class="hero__standards">SOC 2 · ISO 27001 · automated</p>
<h1 class="hero__head">Compliance, ground out in <em>days</em>, not in months.</h1>
<p class="hero__sub">
Foundry runs the controls, the evidence collection, and the audit timeline for B2B SaaS
@@ -49,17 +49,16 @@
<section class="bento" id="bento">
<article class="tile tile--stat" aria-labelledby="stat-h">
<span class="tile__corner" aria-hidden="true"></span>
- <p class="tile__label" id="stat-h">Companies audited</p>
- <p class="tile__stat">847<span class="tile__stat-dot">.</span></p>
+ <h3 class="tile__stat" id="stat-h">847<span class="tile__stat-dot">.</span><span class="tile__stat-unit">companies audited</span></h3>
<p class="tile__stat-cap">
- companies passed audit using Foundry. Average time to compliant: thirty-one days, against
+ Every one of them passed using Foundry. Average time to compliant: thirty-one days, against
an industry average of nine months.
</p>
</article>
<article class="tile tile--logos" aria-labelledby="logos-h">
- <p class="tile__label" id="logos-h">In production at</p>
- <p class="tile__body">Eight wordmarks. Logos shown with consent. Full customer list in the trust report.</p>
+ <h3 class="tile__head" id="logos-h">In production at eight companies.</h3>
+ <p class="tile__body">Logos shown with consent. Full customer list in the trust report.</p>
<ul class="logos" role="list">
<li class="logos__item">Tracejam<span class="dot">.</span></li>
<li class="logos__item">Maple <span class="dot">·</span></li>
@@ -73,18 +72,18 @@
</article>
<article class="tile tile--pricing" aria-labelledby="price-h">
- <p class="tile__label" id="price-h">Three plans, one price each</p>
+ <h3 class="tile__head" id="price-h">Three plans, one price each.</h3>
<div class="tiers">
<div class="tier-card">
- <p class="tier-card__name">Starter</p>
+ <h4 class="tier-card__name">Starter</h4>
<p class="tier-card__price">$299 <span class="tier-card__per">/ mo</span></p>
</div>
<div class="tier-card tier-card--feature">
- <p class="tier-card__name">Team</p>
+ <h4 class="tier-card__name">Team</h4>
<p class="tier-card__price">$899 <span class="tier-card__per">/ mo</span></p>
</div>
<div class="tier-card">
- <p class="tier-card__name">Scale</p>
+ <h4 class="tier-card__name">Scale</h4>
<p class="tier-card__price">Custom</p>
</div>
</div>
@@ -94,7 +93,6 @@
</article>
<article class="tile tile--testimonial">
- <p class="tile__label">From a customer</p>
<p class="tile__quote">
"We told the auditor 'use Foundry, the evidence is in there.' She did. The audit closed
on schedule. That has never happened to me before."
@@ -103,8 +101,7 @@
</article>
<article class="tile tile--features">
- <p class="tile__label">What's automated</p>
- <h3 class="tile__head">Eighty-six controls, evidenced on a schedule.</h3>
+ <h3 class="tile__head">Eighty-six controls, automated and evidenced on a schedule.</h3>
<ul class="feat-list">
<li><span class="num">01.</span><span>Access reviews quarterly. Slack-prompted. One-click sign-off.</span></li>
<li><span class="num">02.</span><span>Vulnerability scans on every deploy. Severity-routed.</span></li>
@@ -116,7 +113,6 @@
</article>
<article class="tile tile--faq">
- <p class="tile__label">FAQ</p>
<h3 class="tile__head">The eight questions everyone asks first.</h3>
<ul class="faq-list">
<li><a href="#">Do we need to switch auditor?</a></li>
diff --git a/site/_tests/07-foundry-compliance/style.css b/site/_tests/07-foundry-compliance/style.css
index fa7c395..b375e7c 100644
--- a/site/_tests/07-foundry-compliance/style.css
+++ b/site/_tests/07-foundry-compliance/style.css
@@ -99,7 +99,9 @@ body {
.hero__copy { max-width: 36rem; }
-.hero__eyebrow {
+/* Not an opening line: the two standards Foundry automates, which is a fact the
+ heading below does not carry. */
+.hero__standards {
font-family: var(--font-mono);
font-size: 0.75rem;
letter-spacing: 0.12em;
@@ -211,14 +213,9 @@ body {
clip-path: polygon(100% 0, 0 0, 100% 100%);
}
-.tile__label {
- font-family: var(--font-mono);
- font-size: 0.75rem;
- letter-spacing: 0.12em;
- text-transform: uppercase;
- color: var(--color-ink-soft);
-}
-
+/* Every tile used to open with a mono caps line naming itself. Each of those is
+ now the tile's heading, and the stat tile's label sits after its figure,
+ where a unit belongs. */
.tile__head {
font-family: var(--font-display);
font-size: 1.5rem;
@@ -255,6 +252,17 @@ body {
.tile__stat-dot { color: var(--color-accent); }
+.tile__stat-unit {
+ display: block;
+ font-family: var(--font-mono);
+ font-size: 0.75rem;
+ font-weight: 400;
+ letter-spacing: 0.12em;
+ text-transform: uppercase;
+ color: var(--color-ink-soft);
+ margin-top: var(--space-sm);
+}
+
.tile__stat-cap {
font-family: var(--font-display);
font-size: 1.125rem;
diff --git a/site/_tests/08-cohort-courses/index.html b/site/_tests/08-cohort-courses/index.html
index c8bd3d4..6f601b5 100644
--- a/site/_tests/08-cohort-courses/index.html
+++ b/site/_tests/08-cohort-courses/index.html
@@ -23,13 +23,13 @@
</header>
<section class="hero">
- <p class="hero__eyebrow">Built for educators · not LMS sales teams</p>
<p class="hero__stat">30 <span class="hero__stat-em">—</span> 500</p>
+ <p class="hero__stat-cap">students in one live cohort, and every size in between</p>
<h1 class="hero__head">Live courses, sized for the <em>class</em> you actually have.</h1>
<p class="hero__sub">
- Cohort runs courses with thirty to five hundred students at once — the size of a real
+ Cohort runs courses with thirty to five hundred students at once: the size of a real
classroom, the size of a real lecture, and a few sizes between. With a date, a roster, and
- a room.
+ a room. Built for the educator teaching it, not for an LMS sales team.
</p>
<div class="hero__cta">
<a class="btn btn--primary" href="#">Run your first cohort →</a>
diff --git a/site/_tests/08-cohort-courses/style.css b/site/_tests/08-cohort-courses/style.css
index baeb9d7..ebbe849 100644
--- a/site/_tests/08-cohort-courses/style.css
+++ b/site/_tests/08-cohort-courses/style.css
@@ -87,15 +87,6 @@ body {
border-block-end: 1px solid var(--color-rule);
}
-.hero__eyebrow {
- font-family: var(--font-mono);
- font-size: 0.75rem;
- letter-spacing: 0.16em;
- text-transform: uppercase;
- color: var(--color-accent);
- margin: 0 0 var(--space-md);
-}
-
.hero__stat {
font-family: var(--font-display);
font-size: clamp(5rem, 14vw, 13rem);
@@ -109,6 +100,17 @@ body {
.hero__stat-em { color: var(--color-accent); font-weight: 400; }
+/* The numeral opens the page on its own. What it counts is set beneath it, the
+ same way the proof stats downpage label their figures. */
+.hero__stat-cap {
+ font-family: var(--font-mono);
+ font-size: 0.75rem;
+ letter-spacing: 0.08em;
+ text-transform: uppercase;
+ color: var(--color-ink-soft);
+ margin: 0 0 var(--space-lg);
+}
+
.hero__head {
font-family: var(--font-display);
font-size: clamp(1.5rem, 3vw, 2.25rem);
diff --git a/site/_tests/09-slow-pour/index.html b/site/_tests/09-slow-pour/index.html
index fe1b21e..c3fd320 100644
--- a/site/_tests/09-slow-pour/index.html
+++ b/site/_tests/09-slow-pour/index.html
@@ -162,18 +162,6 @@ h1, h2, h3, p { margin: 0; }
}
}
-.hero__eyebrow {
- display: inline-flex;
- align-items: center;
- gap: 0.6rem;
- font-family: var(--font-label);
- font-size: var(--text-xs);
- letter-spacing: var(--tracking-label);
- text-transform: uppercase;
- color: var(--color-accent);
- margin-block-end: var(--space-md);
-}
-
.hero__display {
font-family: var(--font-display);
font-style: italic;
@@ -240,12 +228,17 @@ h1, h2, h3, p { margin: 0; }
min-height: 24rem;
}
-.hero__plate-label {
+/* The plate is named by its name. What the bag actually is gets set underneath,
+ as a catalogue caption on the same hairline the meta rows use. */
+.hero__plate-cap {
font-family: var(--font-label);
font-size: var(--text-xs);
letter-spacing: var(--tracking-label);
text-transform: uppercase;
color: var(--color-muted);
+ border-block-start: 1px solid var(--color-rule);
+ padding-block-start: var(--space-2xs);
+ margin-block-start: var(--space-2xs);
}
.hero__plate-name {
@@ -301,14 +294,6 @@ h1, h2, h3, p { margin: 0; }
margin-block-end: var(--space-2xl);
}
-.notes__label {
- font-family: var(--font-label);
- font-size: var(--text-xs);
- letter-spacing: var(--tracking-label);
- text-transform: uppercase;
- color: var(--color-muted);
-}
-
.notes__title {
font-family: var(--font-display);
font-style: italic;
@@ -386,12 +371,16 @@ h1, h2, h3, p { margin: 0; }
}
}
-.letter__label {
- font-family: var(--font-label);
- font-size: var(--text-xs);
- letter-spacing: var(--tracking-label);
- text-transform: uppercase;
+/* No title over the letter: it opens on its drop cap, the way a letter does.
+ The margin column carries the dateline instead, beside the prose. */
+.letter__dateline {
+ align-self: start;
+ font-family: var(--font-body);
+ font-size: var(--text-sm);
+ line-height: var(--lh-relaxed);
+ font-style: italic;
color: var(--color-muted);
+ max-width: 24ch;
}
.letter__body {
@@ -527,8 +516,7 @@ h1, h2, h3, p { margin: 0; }
<section class="hero" aria-labelledby="hero-title">
<div class="hero__copy">
- <p class="hero__eyebrow">A small-batch dispatch</p>
- <h2 class="hero__display" id="hero-title">One bag, every other Tuesday.</h2>
+ <h2 class="hero__display" id="hero-title">One small-batch bag, every other Tuesday.</h2>
<p class="hero__lede">
We roast on Sunday, ship Monday, and arrange for the bag to be on your kitchen counter by Tuesday morning. One curated bag, every two weeks. No flights of cup-tasting flutes. No subscription tier with adjectives.
</p>
@@ -539,7 +527,6 @@ h1, h2, h3, p { margin: 0; }
</div>
<aside class="hero__plate" aria-label="This week's bag">
- <p class="hero__plate-label">No. 03 · This week's bag</p>
<p class="hero__plate-name">Estancia el&nbsp;Pino, Tolima</p>
<svg class="bean" viewBox="0 0 220 220" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linecap="round" aria-hidden="true">
@@ -568,13 +555,13 @@ h1, h2, h3, p { margin: 0; }
<dd>Sunday, 17 May</dd>
</div>
</dl>
+ <p class="hero__plate-cap">Bag No. 03 of the rotation, 250 g</p>
</aside>
</section>
<section class="notes" aria-labelledby="notes-title">
<header class="notes__head">
- <p class="notes__label">03 / The week, ordered</p>
- <h2 class="notes__title" id="notes-title">Three days. One bag. Done by Wednesday.</h2>
+ <h2 class="notes__title" id="notes-title">Three days, in order. One bag. Done by Wednesday.</h2>
</header>
<ol class="notes__list">
@@ -596,10 +583,9 @@ h1, h2, h3, p { margin: 0; }
</ol>
</section>
- <section class="letter" id="letter" aria-labelledby="letter-title">
- <p class="letter__label">A letter from the roaster</p>
+ <section class="letter" id="letter" aria-label="A letter from the roaster">
+ <p class="letter__dateline">Written at the roastery on <time datetime="2026-05-17">Sunday, 17 May</time>, over the cooling tray, while No. 03 came off the drum.</p>
<div class="letter__body">
- <h2 class="visually-hidden" id="letter-title" style="position: absolute; left: -9999px;">A letter from the roaster</h2>
<p>We are not the cheapest subscription, and we are not interested in being one. The bag we send is the bag we drank that morning — the same roast, the same date, the same notes on the page. Two weeks is not arbitrary; it's how long a 250 g bag holds at its best, and how long we want you to live with one coffee before the next arrives.</p>
<p>If a week is wrong for you, you can pause. If two weeks is too often, you can stretch to four. If you change your mind on the bean, the next dispatch is yours to redirect. The point is not the volume; the point is that the coffee that arrives is the coffee we'd brew for ourselves.</p>
<p class="letter__sign">— J. &amp; M., the roastery</p>
diff --git a/site/_tests/10-owl-hours/index.html b/site/_tests/10-owl-hours/index.html
index 101ee3b..ae92dfe 100644
--- a/site/_tests/10-owl-hours/index.html
+++ b/site/_tests/10-owl-hours/index.html
@@ -150,15 +150,6 @@ h1, h2, h3, p, ul, ol, dl { margin: 0; }
gap: var(--space-md);
}
-.title-block__eyebrow {
- font-family: var(--font-label);
- font-size: var(--text-xs);
- letter-spacing: var(--tracking-label);
- text-transform: uppercase;
- color: var(--color-accent);
- margin-block-end: var(--space-md);
-}
-
.title-block__display {
font-family: var(--font-display);
font-weight: 600;
@@ -234,13 +225,18 @@ h1, h2, h3, p, ul, ol, dl { margin: 0; }
}
}
-.declarations__label {
- font-family: var(--font-label);
- font-size: var(--text-xs);
- letter-spacing: var(--tracking-label);
- text-transform: uppercase;
- color: var(--color-muted);
+/* The left column was holding a label while the real heading hid off-screen at
+ -9999px. Now it holds the heading itself, hung beside the list it governs. */
+.declarations__head {
align-self: start;
+ margin: 0;
+ font-family: var(--font-display);
+ font-weight: 600;
+ font-size: clamp(1.5rem, 2.5vw + 0.5rem, 2.125rem);
+ line-height: var(--lh-snug);
+ letter-spacing: var(--tracking-tight);
+ color: var(--color-ink);
+ text-wrap: balance;
}
.declarations__list {
@@ -318,18 +314,14 @@ h1, h2, h3, p, ul, ol, dl { margin: 0; }
padding-block: var(--space-3xl) var(--space-2xl);
}
+/* The section opens on the same hairline every other section opens on. That
+ rule is the break; nothing needs to say so in words. */
.practice__head {
display: grid;
gap: var(--space-2xs);
margin-block-end: var(--space-2xl);
-}
-
-.practice__label {
- font-family: var(--font-label);
- font-size: var(--text-xs);
- letter-spacing: var(--tracking-label);
- text-transform: uppercase;
- color: var(--color-muted);
+ border-block-start: var(--rule-hair) solid var(--color-rule);
+ padding-block-start: var(--space-lg);
}
.practice__title {
@@ -434,8 +426,7 @@ h1, h2, h3, p, ul, ol, dl { margin: 0; }
</header>
<section class="title-block" aria-labelledby="t-title">
- <p class="title-block__eyebrow">A drafting space, after dark</p>
- <h1 class="title-block__display" id="t-title">A page that <em>holds</em> the chapter — and nothing else.</h1>
+ <h1 class="title-block__display" id="t-title">A page that <em>holds</em> the chapter after dark, and nothing else.</h1>
<p class="title-block__lede">
Owl Hours is a single-screen drafting space for fiction writers who work between 10pm and 2am. No tabs. No streak counters. No "you're on a roll" toasts at midnight. Just the chapter, the cursor, and the kind of dark that doesn't fight your eyes.
</p>
@@ -446,8 +437,7 @@ h1, h2, h3, p, ul, ol, dl { margin: 0; }
</section>
<section class="declarations" id="declarations" aria-labelledby="d-title">
- <p class="declarations__label">02 / What it refuses</p>
- <h2 class="declarations__label" id="d-title" style="position: absolute; left: -9999px;">Five things Owl Hours refuses to do</h2>
+ <h2 class="declarations__head" id="d-title">Five things Owl Hours refuses to do</h2>
<ol class="declarations__list">
<li class="declaration">
<span class="declaration__num">01.</span>
@@ -478,7 +468,6 @@ h1, h2, h3, p, ul, ol, dl { margin: 0; }
<section class="practice" id="practice" aria-labelledby="p-title">
<header class="practice__head">
- <p class="practice__label">04 / Practice</p>
<h2 class="practice__title" id="p-title">Three working rules — <em>nothing else fits on the screen.</em></h2>
</header>
diff --git a/site/_tests/11-soroe-ceramics/index.html b/site/_tests/11-soroe-ceramics/index.html
index ff65543..4a08bd0 100644
--- a/site/_tests/11-soroe-ceramics/index.html
+++ b/site/_tests/11-soroe-ceramics/index.html
@@ -131,15 +131,6 @@ h1, h2, h3, p, ul, ol, dl { margin: 0; }
gap: var(--space-md);
}
-.opening__eyebrow {
- font-family: var(--font-label);
- font-size: var(--text-xs);
- letter-spacing: var(--tracking-label);
- text-transform: uppercase;
- color: var(--color-accent);
- margin-block-end: var(--space-md);
-}
-
.opening__title {
font-family: var(--font-display);
font-style: italic;
@@ -162,6 +153,20 @@ h1, h2, h3, p, ul, ol, dl { margin: 0; }
margin-block-start: var(--space-md);
}
+/* The letter opens on a change of scale rather than a line saying it is a
+ letter. One drop cap, first paragraph, and the signoff closes it. */
+.opening__sub::first-letter {
+ font-family: var(--font-display);
+ font-style: italic;
+ font-weight: 400;
+ font-size: 3.6rem;
+ line-height: 0.78;
+ color: var(--color-ink);
+ float: inline-start;
+ padding-inline-end: 0.09em;
+ padding-block-start: 0.08em;
+}
+
.opening__signoff {
margin-block-start: var(--space-md);
font-family: var(--font-display);
@@ -308,11 +313,16 @@ h1, h2, h3, p, ul, ol, dl { margin: 0; }
.visit { grid-template-columns: 1fr; gap: var(--space-md); }
}
-.visit__label {
+/* The margin column names a place that exists rather than announcing the
+ section. The hours moved into the heading, where they were always headed. */
+.visit__where {
+ align-self: start;
font-family: var(--font-label);
+ font-style: normal;
font-size: var(--text-xs);
letter-spacing: var(--tracking-label);
text-transform: uppercase;
+ line-height: 1.9;
color: var(--color-muted);
}
@@ -373,7 +383,6 @@ h1, h2, h3, p, ul, ol, dl { margin: 0; }
</header>
<section class="opening" aria-labelledby="o-title">
- <p class="opening__eyebrow">A letter to collectors</p>
<h2 class="opening__title" id="o-title">Six vessels, this spring — then the kiln rests until July.</h2>
<p class="opening__sub">
Each piece is hand-thrown in our studio outside Nara, fired once at 1,260 °C, signed on the foot, and dated. We send the kiln-log with the box. When a piece is reserved, it leaves the index — there are no waitlists.
@@ -490,11 +499,14 @@ h1, h2, h3, p, ul, ol, dl { margin: 0; }
</section>
<section class="visit" aria-labelledby="v-title">
- <p class="visit__label">Visit the studio</p>
+ <address class="visit__where">
+ Soroe Studio<br />
+ 1-14 Higashi-Hokke, Nara<br />
+ <a style="color: var(--color-ink); border-bottom: 1px solid var(--color-rule-2);" href="mailto:[email protected]">[email protected]</a>
+ </address>
<div class="visit__body">
- <h2 class="visit__address" id="v-title">Tuesday &amp; Saturday, 14:00–17:00.</h2>
+ <h2 class="visit__address" id="v-title">Visit the studio Tuesday &amp; Saturday, 14:00 to 17:00.</h2>
<p>The studio is a converted carpenter's workshop ten minutes north of Nara station. Walk up the lane until the persimmon tree, then left. Tea is offered. Pieces marked <em style="color: var(--color-accent);">available</em> can be reserved with a 30% deposit; the balance settles when the piece ships.</p>
- <p>Soroe Studio · 1-14 Higashi-Hokke, Nara · <a style="color: var(--color-ink); border-bottom: 1px solid var(--color-rule-2);" href="mailto:[email protected]">[email protected]</a></p>
</div>
</section>
diff --git a/site/_tests/12-loafer/index.html b/site/_tests/12-loafer/index.html
index c554cc2..93deb9c 100644
--- a/site/_tests/12-loafer/index.html
+++ b/site/_tests/12-loafer/index.html
@@ -185,12 +185,18 @@ h1, h2, h3, p, ul, ol, dl { margin: 0; }
min-width: 0;
}
-.tile__label {
+/* No tile opens with a line naming itself. Where a tile has something to say
+ that its heading cannot, it says it underneath, as a plate caption on a
+ hairline: the card is the thing, the caption identifies it. */
+.tile__cap {
font-family: var(--font-label);
font-size: var(--text-xs);
letter-spacing: var(--tracking-label);
text-transform: uppercase;
color: var(--color-muted);
+ margin: 0;
+ padding-block-start: var(--space-sm);
+ border-block-start: 1px solid var(--color-rule-2);
}
/* HERO TILE — spans 4 columns × 2 rows */
@@ -225,7 +231,14 @@ h1, h2, h3, p, ul, ol, dl { margin: 0; }
font-size: var(--text-md);
line-height: var(--lh-relaxed);
color: var(--color-ink-2);
- max-width: 36ch;
+ max-width: 52ch;
+}
+
+/* The orienting words open the sentence and stay in it. Pulled onto their own
+ line they would just be the label again. */
+.tile__lede-in {
+ font-weight: 600;
+ color: var(--color-ink);
}
.tile__cta-row {
@@ -441,8 +454,6 @@ h1, h2, h3, p, ul, ol, dl { margin: 0; }
align-content: space-between;
}
-.tile--cta .tile__label { color: color-mix(in oklch, var(--color-paper) 70%, transparent); }
-
.tile--cta .tile__cta-pill {
padding: 0.6rem 1.1rem;
font-family: var(--font-label);
@@ -508,10 +519,9 @@ h1, h2, h3, p, ul, ol, dl { margin: 0; }
<section class="bento" aria-label="Loafer overview">
<article class="tile tile--hero" id="hero">
- <p class="tile__label">A plant app for low-key plant people</p>
<h1 class="tile__display">Reminders for the plants you <em>actually</em> own.</h1>
<p class="tile__lede">
- Add a plant with a photo. Loafer figures out roughly how often it likes water and nudges you on the right day. There are no streaks, no badges, and no leaderboards. We don't grade your gardening.
+ <b class="tile__lede-in">For low-key plant people.</b> Add a plant with a photo. Loafer figures out roughly how often it likes water and nudges you on the right day. There are no streaks, no badges, and no leaderboards. We don't grade your gardening.
</p>
<div class="tile__cta-row">
<a class="tile__cta" href="#install">Get Loafer for iOS &rarr;</a>
@@ -520,7 +530,6 @@ h1, h2, h3, p, ul, ol, dl { margin: 0; }
</article>
<article class="tile tile--plant" aria-labelledby="p-name">
- <p class="tile__label">Today on your shelf</p>
<svg class="plant-leaf" viewBox="0 0 100 130" fill="currentColor" aria-hidden="true">
<path d="M 50 8 C 22 22 14 60 22 96 C 28 116 50 124 50 124 C 50 124 72 116 78 96 C 86 60 78 22 50 8 Z" opacity="0.85"/>
<path d="M 50 16 L 50 122" stroke="oklch(40% 0.12 145)" stroke-width="1.4" fill="none"/>
@@ -546,11 +555,11 @@ h1, h2, h3, p, ul, ol, dl { margin: 0; }
<dd>5 days ago</dd>
</div>
</dl>
+ <p class="tile__cap">Today's card, drawn from Mira's shelf of four</p>
</article>
<article class="tile tile--schedule" id="how" aria-labelledby="s-title">
- <p class="tile__label">This week, on your shelf</p>
- <h3 class="tile__plant-name" id="s-title" style="font-size: var(--text-lg);">Two days that matter, five that don't.</h3>
+ <h3 class="tile__plant-name" id="s-title" style="font-size: var(--text-lg);">Two days this week that matter, five that don't.</h3>
<div class="schedule" aria-hidden="true">
<div class="day"><span class="day__name">Mon</span><span class="day__num">12</span><span class="day__dot"></span></div>
<div class="day"><span class="day__name">Tue</span><span class="day__num">13</span><span class="day__dot"></span></div>
@@ -564,8 +573,7 @@ h1, h2, h3, p, ul, ol, dl { margin: 0; }
</article>
<article class="tile tile--refusal" aria-labelledby="r-title">
- <p class="tile__label">Things Loafer refuses to do</p>
- <h3 class="tile__plant-name" id="r-title" style="font-size: var(--text-lg);">No streaks. No grading. No fertiliser ads.</h3>
+ <h3 class="tile__plant-name" id="r-title" style="font-size: var(--text-lg);">Three things Loafer refuses to do: streaks, grading, fertiliser ads.</h3>
<ul class="refusal__list">
<li class="refusal__item"><span class="refusal__item-mark">·</span><span><strong>No streaks.</strong> If you forget for a week the plants forgive you. The app does too.</span></li>
<li class="refusal__item"><span class="refusal__item-mark">·</span><span><strong>No notifications</strong> on the days nothing needs doing. Most days, that's most plants.</span></li>
@@ -574,7 +582,6 @@ h1, h2, h3, p, ul, ol, dl { margin: 0; }
</article>
<article class="tile tile--pricing" id="pricing" aria-labelledby="pr-title">
- <p class="tile__label">Pricing</p>
<h3 class="tile__plant-name" id="pr-title" style="font-size: var(--text-lg);">One plant, free. More than one, $14 a year.</h3>
<div class="pricing__row">
<span class="pricing__amount">$14</span>
@@ -584,8 +591,7 @@ h1, h2, h3, p, ul, ol, dl { margin: 0; }
</article>
<article class="tile tile--cta" id="install">
- <p class="tile__label">Get it</p>
- <p class="cta-tile-display">Loafer is on iOS today. Android in autumn.</p>
+ <h2 class="cta-tile-display">Loafer is on iOS today. Android in autumn.</h2>
<a class="tile__cta-pill" href="#">Open in App Store &rarr;</a>
</article>
diff --git a/site/_tests/13-alma/index.html b/site/_tests/13-alma/index.html
index 2163049..6231131 100644
--- a/site/_tests/13-alma/index.html
+++ b/site/_tests/13-alma/index.html
@@ -172,15 +172,6 @@ h1, h2, h3, p, ul, ol, dl { margin: 0; }
gap: var(--space-md);
}
-.hero__eyebrow {
- font-family: var(--font-label);
- font-size: var(--text-xs);
- letter-spacing: var(--tracking-label);
- text-transform: uppercase;
- color: var(--color-accent);
- margin-block-end: var(--space-sm);
-}
-
.hero__quote {
margin: 0;
padding: 0;
@@ -205,13 +196,19 @@ h1, h2, h3, p, ul, ol, dl { margin: 0; }
color: var(--color-accent);
}
-.hero__attrib {
- margin-block-start: var(--space-md);
- font-family: var(--font-label);
- font-size: var(--text-xs);
- letter-spacing: var(--tracking-label);
- text-transform: uppercase;
- color: var(--color-muted);
+/* The page's real heading sits under the quote, on a hairline, the way a plate
+ is identified under the plate. Nothing announces the quote before it. */
+.hero__title {
+ margin: 0;
+ padding-block-start: var(--space-md);
+ border-block-start: var(--rule-hair) solid var(--color-rule);
+ font-family: var(--font-display);
+ font-weight: 500;
+ font-size: var(--text-lg);
+ line-height: var(--lh-snug);
+ letter-spacing: var(--tracking-tight);
+ color: var(--color-ink);
+ max-width: 30ch;
}
.hero__lede {
@@ -303,12 +300,16 @@ h1, h2, h3, p, ul, ol, dl { margin: 0; }
.two-min { grid-template-columns: 1fr; gap: var(--space-md); }
}
-.two-min__label {
- font-family: var(--font-label);
- font-size: var(--text-xs);
- letter-spacing: var(--tracking-label);
- text-transform: uppercase;
+/* Marginalia: it sits in the outer column beside the body, not above the
+ heading, and it carries a fact the heading does not. */
+.two-min__aside {
+ margin: 0;
+ font-family: var(--font-body);
+ font-size: var(--text-sm);
+ line-height: var(--lh-relaxed);
color: var(--color-muted);
+ border-block-start: var(--rule-hair) solid var(--color-rule);
+ padding-block-start: var(--space-sm);
}
.two-min__body {
@@ -411,14 +412,6 @@ h1, h2, h3, p, ul, ol, dl { margin: 0; }
align-content: start;
}
-.privacy__label {
- font-family: var(--font-label);
- font-size: var(--text-xs);
- letter-spacing: var(--tracking-label);
- text-transform: uppercase;
- color: var(--color-muted);
-}
-
.privacy__title {
font-family: var(--font-display);
font-weight: 500;
@@ -503,13 +496,12 @@ h1, h2, h3, p, ul, ol, dl { margin: 0; }
</nav>
</header>
- <section class="hero" aria-labelledby="h-quote">
+ <section class="hero" aria-labelledby="h-title">
<div class="hero__copy">
- <p class="hero__eyebrow">A voice journal</p>
<blockquote class="hero__quote">
- <p id="h-quote">"Two minutes a day. The <em>dark</em> holds the rest."</p>
+ <p>"Two minutes a day. The <em>dark</em> holds the rest."</p>
</blockquote>
- <p class="hero__attrib">— What Alma is</p>
+ <h1 class="hero__title" id="h-title">Alma is a voice journal that forgets by default.</h1>
<p class="hero__lede">
Speak for two minutes on the way home. Alma transcribes the audio, leaves the file in your private library, and forgets the entry after a year — unless you say keep it. There is no feed. No share button. No coach.
</p>
@@ -532,7 +524,7 @@ h1, h2, h3, p, ul, ol, dl { margin: 0; }
</section>
<section class="two-min" id="how" aria-labelledby="t-title">
- <p class="two-min__label">02 / The two minutes</p>
+ <p class="two-min__aside">The session is two minutes long and it ends by itself. There is no countdown ring, no way to extend it, and no reminder if you skip a day.</p>
<div class="two-min__body">
<h2 class="two-min__title" id="t-title">Speak. Alma <em>writes it down</em>. The session ends on its own.</h2>
<ol class="two-min__steps">
@@ -558,8 +550,7 @@ h1, h2, h3, p, ul, ol, dl { margin: 0; }
<section class="privacy" id="privacy" aria-labelledby="p-title">
<header class="privacy__head">
- <p class="privacy__label">04 / The ledger</p>
- <h2 class="privacy__title" id="p-title">What stays on your <em>phone</em>. What never leaves.</h2>
+ <h2 class="privacy__title" id="p-title">The ledger: what stays on your <em>phone</em>, and what never leaves.</h2>
</header>
<ul class="privacy__list">
<li class="privacy__row"><span class="privacy__row-key">Audio recording</span><span class="privacy__row-value">on device only</span></li>
diff --git a/site/_tests/custom/02-loop/index.html b/site/_tests/custom/02-loop/index.html
index 7305712..7d0471c 100644
--- a/site/_tests/custom/02-loop/index.html
+++ b/site/_tests/custom/02-loop/index.html
@@ -24,7 +24,7 @@
<section class="hero">
<div class="hero__copy">
- <p class="hero__eyebrow">For payment platform engineers</p>
+ <hr class="hero__mark" />
<h1 class="hero__head">Real-time payment-rail observability that <em>tells you why.</em></h1>
<p class="hero__sub">
Watch every leg of a cross-rail payment in flight. Find the regressed
diff --git a/site/_tests/custom/02-loop/style.css b/site/_tests/custom/02-loop/style.css
index b3b04ed..a117593 100644
--- a/site/_tests/custom/02-loop/style.css
+++ b/site/_tests/custom/02-loop/style.css
@@ -100,13 +100,29 @@ body {
.hero__copy { max-width: 36rem; }
-.hero__eyebrow {
- font-family: var(--font-display);
- font-size: 0.75rem;
- letter-spacing: 0.12em;
- text-transform: uppercase;
- color: var(--color-accent);
+/* The page opens on a mark, not on a line of type: an accent square running
+ into a hairline. It costs no words and the reader learns it in one look.
+ Who Loop is for is said in the sub, in prose, where it reads. */
+.hero__mark {
+ border: 0;
margin: 0 0 var(--space-md);
+ display: flex;
+ align-items: center;
+ gap: 0.6rem;
+}
+
+.hero__mark::before {
+ content: "";
+ width: 8px;
+ height: 8px;
+ background: var(--color-accent);
+}
+
+.hero__mark::after {
+ content: "";
+ flex: 1;
+ height: 1px;
+ background: var(--color-rule);
}
.hero__head {
diff --git a/site/_tests/verbs/redesign/output.html b/site/_tests/verbs/redesign/output.html
index 7ad4933..d67a5fd 100644
--- a/site/_tests/verbs/redesign/output.html
+++ b/site/_tests/verbs/redesign/output.html
@@ -79,7 +79,7 @@
.hero__copy { max-width: 32rem; }
- .hero__eyebrow {
+ .hero__meta {
font-family: var(--font-mono);
font-size: 0.75rem;
letter-spacing: 0.12em;
@@ -214,14 +214,6 @@
padding: var(--space-lg);
}
- .pinned__label {
- font-family: var(--font-mono);
- font-size: 0.6875rem;
- letter-spacing: 0.12em;
- text-transform: uppercase;
- color: var(--color-ink-soft);
- margin-block-end: var(--space-sm);
- }
.pinned__head {
font-family: var(--font-display);
@@ -306,7 +298,7 @@
<!-- Hero — same words as input, different shape -->
<section class="hero">
<div class="hero__copy">
- <p class="hero__eyebrow">v0.4 · for product teams</p>
+ <p class="hero__meta">v0.4 · for product teams</p>
<h1 class="hero__head">The AI-powered platform <em>for modern teams.</em></h1>
<p class="hero__sub">
Nexus helps you ship faster, collaborate smarter, and scale seamlessly with AI-native
@@ -346,8 +338,7 @@
</div>
<aside class="pinned" aria-label="Pinned demo">
- <p class="pinned__label">Try it in your terminal</p>
- <h3 class="pinned__head">A 4-line getting-started.</h3>
+ <h3 class="pinned__head">Four lines, in your terminal.</h3>
<pre class="pinned__body"><span class="c"># install</span>
<span class="k">$</span> npx nexus init my-team
diff --git a/site/css/components.css b/site/css/components.css
index bce53dd..cc9c9e1 100644
--- a/site/css/components.css
+++ b/site/css/components.css
@@ -639,50 +639,8 @@
}
/* — Section label (01 / FOUNDATIONS) —————————————————— */
-.section-label {
- font-family: var(--font-label);
- font-size: var(--text-xs);
- font-weight: 400;
- letter-spacing: var(--tracking-label);
- text-transform: uppercase;
- color: var(--color-muted);
- display: flex;
- align-items: baseline;
- gap: var(--space-sm);
-}
-
-.section-label .num { color: var(--color-ink); font-weight: 500; }
-.section-label .divider { color: var(--color-rule-2); font-weight: 300; }
-
/* Terminal — vary the prompt prefix per section so the "//" gag doesn't get old.
Cycles through > , //, # , -- across the run of sections. */
-[data-theme="terminal"] .section-label::before {
- content: "> ";
- color: var(--color-accent);
-}
-[data-theme="terminal"] .section:nth-of-type(4n+2) .section-label::before { content: "// "; }
-[data-theme="terminal"] .section:nth-of-type(4n+3) .section-label::before { content: "# "; }
-[data-theme="terminal"] .section:nth-of-type(4n+4) .section-label::before { content: "-- "; }
-
-[data-theme="manifesto"] .section-label .num {
- color: var(--color-accent);
- font-family: var(--font-display);
- font-weight: 800;
- font-size: var(--text-md);
-}
-
-[data-theme="sport"] .section-label .num {
- color: var(--color-accent);
- font-weight: 700;
- font-family: var(--font-display);
- font-size: var(--text-md);
- font-style: italic;
-}
-
-[data-theme="almanac"] .section-label {
- font-family: var(--font-mono);
-}
-
/* — Button (outlined default) ————————————————————————— */
.btn {
display: inline-flex;
@@ -1172,7 +1130,7 @@
}
/* — Without / With panels (parity demo) —————————————————
- Both panels render the same eyebrow + H1 + sub + CTA structure.
+ Both panels render the same mark + H1 + sub + CTA structure.
The `data-variant` attribute drives every visual difference. */
.vs__panel {
display: grid;
@@ -1184,7 +1142,7 @@
align-content: start;
}
-.vs__panel-eyebrow {
+.vs__panel-mark {
font-size: 0.75rem;
margin: 0;
}
@@ -1223,7 +1181,7 @@
font-family: "Inter", system-ui, sans-serif;
}
-.vs__panel[data-variant="slop"] .vs__panel-eyebrow {
+.vs__panel[data-variant="slop"] .vs__panel-mark {
color: var(--color-muted);
font-family: inherit;
font-weight: 500;
@@ -1267,7 +1225,7 @@
padding-left: calc(var(--space-xl) - 2px);
}
-.vs__panel[data-variant="hallmark"] .vs__panel-eyebrow {
+.vs__panel[data-variant="hallmark"] .vs__panel-mark {
display: inline-flex;
align-items: center;
gap: 0.55em;
@@ -1477,7 +1435,7 @@
white-space: nowrap;
}
-.vs__panel--pricing[data-variant="slop"] .vs__panel-eyebrow {
+.vs__panel--pricing[data-variant="slop"] .vs__panel-mark {
font-family: inherit;
font-weight: 600;
font-size: 0.75rem;
@@ -2253,12 +2211,8 @@ body:not(.easter-open) > footer {
font-style: normal;
}
-[data-theme="studio"] .hero__eyebrow,
+[data-theme="studio"] .hero__colophon,
[data-theme="studio"] .label,
-[data-theme="studio"] .section-label {
- font-feature-settings: "ss01";
-}
-
/* Portfolio / gallery rhythm — Studio's editorial-magazine register. */
[data-theme="studio"] .ex-card {
@@ -2281,24 +2235,6 @@ body:not(.easter-open) > footer {
Earns the workshop name without slipping into a formal-salon
register. */
-[data-theme="atelier"] .section-label .num {
- font-family: var(--font-display);
- font-style: italic;
- font-weight: 400;
- font-size: var(--text-md);
- font-variation-settings: "opsz" 96;
- color: var(--color-ink);
-}
-
-[data-theme="atelier"] .section-label::after {
- content: " · plate";
- color: var(--color-muted);
- font-style: italic;
- text-transform: lowercase;
- letter-spacing: 0;
- margin-inline-start: 0.4em;
-}
-
[data-theme="atelier"] .section__title {
font-variation-settings: "opsz" 144, "SOFT" 60;
}
@@ -2382,12 +2318,6 @@ body:not(.easter-open) > footer {
[data-theme="riso"] .hero__attrib,
[data-theme="riso"] .label,
-[data-theme="riso"] .section-label,
-[data-theme="riso"] .banner__center {
- text-transform: lowercase;
- letter-spacing: 0.02em;
-}
-
[data-theme="riso"] .banner__center {
font-family: var(--font-display);
font-weight: 700;
@@ -2651,7 +2581,7 @@ body:not(.easter-open) > footer {
[data-theme="lumen"] .hero__moment::after { animation: none; }
}
-.hero__eyebrow {
+.hero__colophon {
display: inline-flex;
align-items: center;
gap: 0.6rem;
@@ -2663,7 +2593,7 @@ body:not(.easter-open) > footer {
margin-bottom: var(--space-lg);
}
-.hero__eyebrow .mark {
+.hero__colophon .mark {
width: 6px; height: 6px;
background: var(--color-accent);
display: inline-block;
@@ -3529,7 +3459,7 @@ html[data-theme="bloom"] body {
max-width: 52ch;
}
-[data-theme="bloom"] .hero__eyebrow {
+[data-theme="bloom"] .hero__colophon {
margin-inline: auto;
justify-content: center;
}
@@ -3549,9 +3479,6 @@ html[data-theme="bloom"] body {
border-bottom: 0;
padding-bottom: var(--space-md);
}
-[data-theme="bloom"] .section-label {
- justify-content: flex-start;
-}
[data-theme="bloom"] .section__title {
margin-inline: 0;
max-width: 26ch;
@@ -4492,15 +4419,6 @@ html[data-theme="aurora"] body {
}
/* Section numeral as a leaderboard-style cell with a thin top rule */
-[data-theme="sport"] .section-label .num {
- display: inline-block;
- padding: 0.15em 0.45em 0.05em;
- border-block-start: 2px solid var(--color-accent);
- background: color-mix(in oklch, var(--color-accent) 6%, transparent);
- font-variant-numeric: tabular-nums;
- font-feature-settings: "tnum";
-}
-
/* Sharper sweep easing on Sport reveals — sportier */
[data-theme="sport"] .reveal.is-in {
animation-timing-function: cubic-bezier(0.86, 0, 0.07, 1);
@@ -4557,16 +4475,6 @@ html[data-theme="aurora"] body {
}
/* Roman-numeral section heads — replaces the leading number */
-[data-theme="editorial"] .section-label .num {
- font-family: var(--font-serif);
- font-style: italic;
- font-weight: 500;
- letter-spacing: 0;
-}
-[data-theme="editorial"] .section-label .divider {
- opacity: 0.55;
-}
-
/* Quieter rules and accents */
[data-theme="editorial"] .section__head {
border-bottom-color: var(--color-rule);
@@ -4644,8 +4552,6 @@ html[data-theme="aurora"] body {
padding-block: var(--space-2xl);
}
.section--invert .section__title,
-.section--invert .section-label,
-.section--invert .section__head { color: var(--color-paper); }
.section--invert .section__head { border-bottom-color: oklch(50% 0.02 60 / 0.4); }
/* — Asymmetric hero ratio knob ——————————————————————————————
@@ -4655,15 +4561,6 @@ html[data-theme="aurora"] body {
grid-template-columns: 0.78fr 1.22fr;
}
-/* — Roman-numeral section-label variant —————————————————————
- `<span class="num num--roman">XII</span>` rendered in italic serif. */
-.section-label .num--roman {
- font-family: var(--font-serif);
- font-style: italic;
- font-weight: 500;
- letter-spacing: 0;
-}
-
/* — Smart sticky nav (reveal on scroll-up) ———————————————————
Apply to .banner with class `banner--smart`. Hidden when scrolling
down, slid back in when scrolling up. JS toggles the class on scroll. */
diff --git a/site/css/sections.css b/site/css/sections.css
index a9717c5..0227d2e 100644
--- a/site/css/sections.css
+++ b/site/css/sections.css
@@ -47,11 +47,6 @@
Hard rule: never wrap. White-space: nowrap forces single-line at
every viewport. The label is short ("05 / Foundations") so this
is safe. */
-.section-label,
-.section__head .section-label {
- white-space: nowrap;
-}
-
.section__title {
font-family: var(--font-display);
font-weight: var(--display-weight, 400);
@@ -102,7 +97,7 @@
.opening { grid-template-columns: 1fr; gap: var(--space-xl); align-items: start; }
}
-.opening__eyebrow {
+.opening__colophon {
font-family: var(--font-label);
font-size: var(--text-xs);
letter-spacing: var(--tracking-label);
@@ -1516,11 +1511,6 @@ html[data-theme="almanac"] body {
}
[data-theme="almanac"] .section__title { font-size: var(--text-xl); }
/* Almanac calls itself indexed — push the §-number into every section label. */
-[data-theme="almanac"] .section-label::before {
- content: "§ ";
- color: var(--color-accent);
- font-feature-settings: "tnum";
-}
[data-theme="almanac"] .foundations {
grid-template-columns: repeat(3, 1fr);
gap: 0;
@@ -1692,9 +1682,6 @@ html[data-theme="almanac"] body {
}
/* ── MIDNIGHT existing — numbered display style ─────────────── */
-[data-theme="midnight"] .section-label .num {
- color: var(--color-accent);
-}
[data-theme="midnight"] .opening__title em {
font-family: var(--font-serif);
font-style: italic;
@@ -1742,6 +1729,7 @@ html[data-theme="almanac"] body {
padding: 0;
display: grid;
gap: 0;
+ counter-reset: anti;
}
.anti-row {
@@ -1751,6 +1739,18 @@ html[data-theme="almanac"] body {
padding-block: var(--space-xl);
border-block-start: var(--rule-hair) solid var(--color-rule);
align-items: start;
+ counter-increment: anti;
+}
+
+/* The ordinal comes from the list, not from a number typed above each row. */
+.anti-row::before {
+ content: counter(anti, decimal-leading-zero);
+ font-family: var(--font-mono);
+ font-size: var(--text-xs);
+ letter-spacing: var(--tracking-label);
+ color: var(--color-muted);
+ padding-block-start: 0.45em;
+ font-feature-settings: "tnum" 1;
}
.anti-row:first-child {
@@ -1765,17 +1765,6 @@ html[data-theme="almanac"] body {
}
}
-.anti-row__num {
- margin: 0;
- font-family: var(--font-mono);
- font-size: var(--text-xs);
- letter-spacing: var(--tracking-label);
- text-transform: uppercase;
- color: var(--color-muted);
- padding-block-start: 0.45em;
- font-feature-settings: "tnum" 1;
-}
-
.anti-row__name {
margin: 0 0 var(--space-sm) 0;
font-family: var(--font-display);
diff --git a/site/examples/arcade-01/index.html b/site/examples/arcade-01/index.html
index db331ed..2ccf096 100644
--- a/site/examples/arcade-01/index.html
+++ b/site/examples/arcade-01/index.html
@@ -124,10 +124,6 @@ body::after {
min-height: 82svh;
padding-top: var(--space-10); padding-bottom: var(--space-20);
}
-.hero__kicker {
- font-family: var(--font-display); font-size: 0.78rem; line-height: 1.2;
- color: var(--cyan); letter-spacing: 0.04em; margin-bottom: var(--space-5);
-}
.hero__display {
font-family: var(--font-display); font-weight: 700;
font-size: clamp(2.25rem, 8.5vw, 5.25rem); line-height: 1.05;
@@ -177,25 +173,24 @@ body::after {
/* ---------- generic section head ---------- */
.section { position: relative; z-index: 1; padding-top: clamp(var(--space-16), 9vw, var(--space-20)); padding-bottom: clamp(var(--space-16), 9vw, var(--space-20)); border-top: 2px solid var(--line); }
-.sec__kicker { font-family: var(--font-display); font-size: 0.74rem; line-height: 1.2; color: var(--cyan); letter-spacing: 0.03em; margin-bottom: var(--space-3); }
-.sec__kicker--mag { color: var(--magenta); }
.sec__title { font-family: var(--font-body); font-weight: 800; font-size: clamp(1.6rem, 3.4vw, 2.5rem); line-height: 1.1; letter-spacing: -0.01em; color: var(--ink); max-width: 20ch; overflow-wrap: anywhere; min-width: 0; }
.sec__lede { margin-top: var(--space-4); font-size: 1.05rem; color: var(--ink-dim); max-width: 58ch; }
.sec__gap { margin-top: clamp(var(--space-12), 6vw, var(--space-16)); }
/* ---------- how it works (three beats) ---------- */
-.beats { list-style: none; display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: var(--space-6); margin-top: var(--space-10); }
-.beat { padding-top: var(--space-5); border-top: 2px solid var(--line-lit); }
-.beat__num { font-family: var(--font-display); font-size: 1.6rem; line-height: 1; color: var(--magenta); }
-.beat:nth-child(2) .beat__num { color: var(--cyan); }
-.beat:nth-child(3) .beat__num { color: var(--magenta); }
+/* The three beats are a real sequence, so the list element says so and counter()
+ draws the figures in the display face. Nothing is typed above a beat name. */
+.beats { list-style: none; display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: var(--space-6); margin-top: var(--space-10); counter-reset: beat; }
+.beat { counter-increment: beat; padding-top: var(--space-5); border-top: 2px solid var(--line-lit); }
+.beat__name::before { content: counter(beat, decimal-leading-zero); display: block; font-family: var(--font-display); font-weight: 400; font-size: 1.6rem; line-height: 1; color: var(--magenta); margin-bottom: var(--space-3); }
+.beat:nth-child(2) .beat__name::before { color: var(--cyan); }
.beat__name { font-family: var(--font-body); font-weight: 700; font-size: 1.15rem; line-height: 1.2; color: var(--ink); margin-top: var(--space-3); }
.beat__body { margin-top: var(--space-3); color: var(--ink-dim); font-size: 0.98rem; }
/* ---------- schedule ---------- */
.table-wrap { margin-top: var(--space-10); overflow-x: auto; border: 2px solid var(--line); }
.timetable { width: 100%; border-collapse: collapse; min-width: 34rem; }
-.timetable caption { text-align: left; }
+.timetable__caption { font-family: var(--font-display); font-size: 0.74rem; line-height: 1.5; color: var(--cyan); letter-spacing: 0.03em; text-align: left; padding: var(--space-4); border-bottom: 2px solid var(--line-lit); }
.timetable th {
font-family: var(--font-display); font-size: 0.7rem; line-height: 1.3; font-weight: 700;
color: var(--cyan); text-align: left; letter-spacing: 0.03em;
@@ -210,16 +205,16 @@ body::after {
/* ---------- tracks + prizes ---------- */
.track-grid { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: var(--space-4); margin-top: var(--space-10); }
.track { padding: var(--space-6); background: var(--paper-2); color: var(--ink); border: 2px solid var(--line); }
-.track__tag { display: inline-block; font-family: var(--font-display); font-size: 0.72rem; line-height: 1.2; padding: var(--space-2) var(--space-3); color: var(--paper); background: var(--cyan); }
+.track__tag { display: inline-block; font-family: var(--font-display); font-weight: 400; font-size: 0.72rem; line-height: 1.2; padding: var(--space-2) var(--space-3); color: var(--paper); background: var(--cyan); }
.track:nth-child(even) .track__tag { background: var(--magenta); }
.track__body { margin-top: var(--space-4); color: var(--ink-dim); font-size: 0.98rem; }
.prize-grid { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: var(--space-4); margin-top: var(--space-8); }
.prize { padding: var(--space-6); border: 2px solid var(--line-lit); border-top-width: 6px; }
-.prize__rank { font-family: var(--font-display); font-size: 1.1rem; line-height: 1; color: var(--cyan); }
+.prize__rank { display: block; font-family: var(--font-display); font-weight: 400; font-size: 1.1rem; line-height: 1; color: var(--cyan); margin-bottom: var(--space-3); }
.prize:nth-child(2) { border-top-color: var(--magenta); }
.prize:nth-child(2) .prize__rank { color: var(--magenta); }
-.prize__name { font-family: var(--font-body); font-weight: 800; font-size: 1.1rem; line-height: 1.15; color: var(--ink); margin-top: var(--space-3); }
+.prize__name { font-family: var(--font-body); font-weight: 800; font-size: 1.1rem; line-height: 1.15; color: var(--ink); }
.prize__body { margin-top: var(--space-2); color: var(--ink-dim); font-size: 0.94rem; }
/* ---------- register call-out ---------- */
@@ -244,6 +239,7 @@ body::after {
/* ---------- footer high-score board ---------- */
.foot { position: relative; z-index: 1; padding-top: clamp(var(--space-16), 9vw, var(--space-20)); padding-bottom: var(--space-16); background: var(--paper-2); color: var(--ink); border-top: 2px solid var(--line-lit); }
.scores { width: 100%; border-collapse: collapse; margin-top: var(--space-6); max-width: 40rem; }
+.scores__caption { font-family: var(--font-display); font-size: 0.74rem; line-height: 1.5; color: var(--cyan); letter-spacing: 0.03em; text-align: left; padding-bottom: var(--space-3); }
.scores td { padding: var(--space-3) var(--space-4); border-bottom: 1px solid var(--line); font-size: 0.98rem; color: var(--ink-dim); }
.scores tr:last-child td { border-bottom: 0; }
.rank { font-family: var(--font-display); font-size: 0.72rem; line-height: 1.4; color: var(--cyan); white-space: nowrap; width: 1%; }
@@ -288,7 +284,6 @@ body::after {
<section class="hero">
<div class="wrap hero__inner">
- <p class="hero__kicker">NOW ACCEPTING PLAYERS</p>
<h1 class="hero__display">
<span class="hero__line">SUMMER</span>
<span class="hero__line">JAM 26<span class="cursor" aria-hidden="true"></span></span>
@@ -298,7 +293,7 @@ body::after {
<a class="score__slot score__slot--p1" href="#register">
<span class="score__player">P1</span>
<span class="score__action">REGISTER</span>
- <span class="score__meta">Free entry, grab a slot</span>
+ <span class="score__meta">Free entry, slots open now</span>
</a>
<a class="score__slot score__slot--p2" href="#sponsor">
<span class="score__player">P2</span>
@@ -311,22 +306,18 @@ body::after {
<section class="section" aria-labelledby="how-title">
<div class="wrap">
- <p class="sec__kicker">HOW THE WEEKEND RUNS</p>
- <h2 class="sec__title" id="how-title">Three moves, one weekend</h2>
+ <h2 class="sec__title" id="how-title">How the weekend runs, in three moves</h2>
<p class="sec__lede">No pre-built engines, no head start. Everybody opens the same blank screen at the same minute and figures it out from there.</p>
<ol class="beats">
<li class="beat">
- <span class="beat__num">01</span>
<h3 class="beat__name">Theme drops</h3>
<p class="beat__body">Friday at 6pm the theme goes live. You find out what you are making at the exact moment everyone else does.</p>
</li>
<li class="beat">
- <span class="beat__num">02</span>
<h3 class="beat__name">Build all weekend</h3>
<p class="beat__body">48 hours to make something playable. Sleep is optional, snacks are not, and the help pit stays open the whole time.</p>
</li>
<li class="beat">
- <span class="beat__num">03</span>
<h3 class="beat__name">Ship and play</h3>
<p class="beat__body">Sunday at 6pm hands come off the keyboard. Every team demos, everyone plays everyone, and the room picks its favorites.</p>
</li>
@@ -336,11 +327,10 @@ body::after {
<section class="section" aria-labelledby="sked-title">
<div class="wrap">
- <p class="sec__kicker sec__kicker--mag">RUN OF SHOW</p>
<h2 class="sec__title" id="sked-title">The 48-hour clock</h2>
<div class="table-wrap">
<table class="timetable">
- <caption class="sr-only">Summer Jam 26 weekend schedule</caption>
+ <caption class="timetable__caption">Run of show, Friday 18:00 to Sunday 18:00</caption>
<thead>
<tr><th scope="col">When</th><th scope="col">Slot</th><th scope="col">What happens</th></tr>
</thead>
@@ -358,44 +348,39 @@ body::after {
<section class="section" aria-labelledby="tracks-title">
<div class="wrap">
- <p class="sec__kicker">PICK YOUR TRACK</p>
- <h2 class="sec__title" id="tracks-title">Four ways to enter</h2>
+ <h2 class="sec__title" id="tracks-title">Pick one of four ways in</h2>
<div class="track-grid">
<article class="track">
- <span class="track__tag">SOLO RUN</span>
+ <h3 class="track__tag">SOLO RUN</h3>
<p class="track__body">One person, one build, start to finish. Prove you do not need a team to make something worth playing.</p>
</article>
<article class="track">
- <span class="track__tag">COUCH CO-OP</span>
+ <h3 class="track__tag">COUCH CO-OP</h3>
<p class="track__body">Two to five people sharing a table, a whiteboard, and a deadline. The classic weekend crew.</p>
</article>
<article class="track">
- <span class="track__tag">THEME TAKEOVER</span>
+ <h3 class="track__tag">THEME TAKEOVER</h3>
<p class="track__body">Lean the hardest into the theme. Judged purely on how far you push the prompt. Weird is rewarded.</p>
</article>
<article class="track">
- <span class="track__tag">ROOKIE CABINET</span>
+ <h3 class="track__tag">ROOKIE CABINET</h3>
<p class="track__body">First jam ever? This track is scored on its own curve so a debut never competes against a veteran.</p>
</article>
</div>
<div class="sec__gap">
- <p class="sec__kicker sec__kicker--mag">ON THE MARQUEE</p>
- <h2 class="sec__title">What you are playing for</h2>
+ <h2 class="sec__title">What goes up on the marquee</h2>
<div class="prize-grid">
<article class="prize">
- <span class="prize__rank">1UP</span>
- <h3 class="prize__name">Best in show</h3>
+ <h3 class="prize__name"><span class="prize__rank">1UP</span> Best in show</h3>
<p class="prize__body">The build the whole room crowds around. Overall pick of the weekend.</p>
</article>
<article class="prize">
- <span class="prize__rank">2UP</span>
- <h3 class="prize__name">Crowd favorite</h3>
+ <h3 class="prize__name"><span class="prize__rank">2UP</span> Crowd favorite</h3>
<p class="prize__body">Chosen by every player in the arcade, not by a panel behind a curtain.</p>
</article>
<article class="prize">
- <span class="prize__rank">3UP</span>
- <h3 class="prize__name">Tech flex</h3>
+ <h3 class="prize__name"><span class="prize__rank">3UP</span> Tech flex</h3>
<p class="prize__body">For the clever hack under the hood that nobody in the room saw coming.</p>
</article>
</div>
@@ -405,8 +390,7 @@ body::after {
<section class="section" id="register" aria-labelledby="cta-title">
<div class="wrap coin__inner">
- <p class="sec__kicker">INSERT COIN</p>
- <h2 class="coin__title" id="cta-title">Ready<br>player 1?</h2>
+ <h2 class="coin__title" id="cta-title">Insert coin.<br>Ready player 1?</h2>
<p class="coin__sub">Slots are free and the theme stays secret until the buzzer. Grab yours, wrangle a team or do not, and clear one weekend on the calendar.</p>
<a class="btn" href="#register">Register your team</a>
<p class="coin__fine">48 HOURS · ANY TEAM SIZE · ONE THEME · FREE TO ENTER</p>
@@ -417,9 +401,8 @@ body::after {
<footer class="foot">
<div class="wrap">
- <p class="sec__kicker">HIGH SCORES</p>
<table class="scores">
- <caption class="sr-only">What Summer Jam 26 stands for</caption>
+ <caption class="scores__caption">High scores: what Summer Jam 26 stands for</caption>
<tbody>
<tr><td class="rank">1ST</td><td class="init">JAM</td><td>Free play. No entry fee, no catch, ever.</td></tr>
<tr><td class="rank">2ND</td><td class="init">DEV</td><td>48 hours on the clock, one shared theme.</td></tr>
diff --git a/site/examples/bananastudio/index.html b/site/examples/bananastudio/index.html
index fae7032..e64ccf5 100644
--- a/site/examples/bananastudio/index.html
+++ b/site/examples/bananastudio/index.html
@@ -33,7 +33,7 @@
<!-- ─── Hero — Marquee, huge title left, animated aperture right ─── -->
<section class="shell hero" aria-labelledby="hero-title">
<div class="hero__copy reveal" style="--i:0">
- <p class="hero__eyebrow">Open beta · v1.0</p>
+ <p class="hero__release">Open beta · v1.0</p>
<h1 id="hero-title" class="hero__title">
Studio-grade<br/>
headshots,<br/>
@@ -106,19 +106,18 @@
<div class="gallery">
<header class="gallery__intro">
<div>
- <p class="section__head">01 · The output</p>
- <h2 id="ex-title" class="section__title">Looks like a photographer made it. <em>The kind your CMO's husband doesn't.</em></h2>
+ <hr class="section__mark" />
+ <h2 id="ex-title" class="section__title">Output that looks like a photographer made it. <em>The kind your CMO's husband doesn't.</em></h2>
</div>
<p class="section__sub">Trained on twelve thousand portrait sessions. Real skin texture, real fall-off, no plastic finish, no extra fingers. 4K PNG and 2048-px social crops, ready for LinkedIn or the back of a book.</p>
</header>
<article class="tile tile--feature reveal" style="--i:0">
- <p class="meta">06 · Direction</p>
<div>
<h2>Pick wardrobe, lighting, backdrop, framing. <em>Or write a brief and we'll match it.</em></h2>
<p style="margin-top: var(--space-md);">Twelve presets ship in every plan. Custom briefs unlock on Studio Plus — drop a reference image and we'll mirror its colour temperature, depth of field, and posture.</p>
</div>
- <p class="meta">⌗ 4K PNG · 2048 social · retouched</p>
+ <p class="meta">⌗ Direction · 4K PNG · 2048 social · retouched</p>
</article>
<article class="tile tile--portrait reveal" style="--i:1" aria-label="Wardrobe sample: boardroom">
@@ -167,7 +166,7 @@
<div class="process">
<header class="process__head">
<div>
- <p class="section__head">02 · The process</p>
+ <hr class="section__mark" />
<h2 id="howto-title">Three steps. Thirty minutes. <em>No setup.</em></h2>
</div>
<p>From the moment you upload to the moment your first edit lands in your inbox.</p>
@@ -175,21 +174,18 @@
<ol class="steps">
<li class="step reveal" style="--i:0">
- <p class="step__num">01</p>
- <p class="step__stage">Upload</p>
- <h3>Send twelve selfies.</h3>
+ <p class="step__num" aria-hidden="true"></p>
+ <h3>Upload twelve selfies.</h3>
<p>Front, side, smile, neutral. Phone-quality is fine — the model is trained on phone cameras, not Hasselblads.</p>
</li>
<li class="step reveal" style="--i:1">
- <p class="step__num">02</p>
- <p class="step__stage">Direct</p>
- <h3>Pick a look, or write a brief.</h3>
+ <p class="step__num" aria-hidden="true"></p>
+ <h3>Direct it: pick a look, or write a brief.</h3>
<p>Choose from twelve wardrobes and four lighting setups. Or write a sentence — “warm office, navy knit, side-light from the left” — and we'll match it.</p>
</li>
<li class="step reveal" style="--i:2">
- <p class="step__num">03</p>
- <p class="step__stage">Receive</p>
- <h3>One hundred edits, in thirty minutes.</h3>
+ <p class="step__num" aria-hidden="true"></p>
+ <h3>Receive one hundred edits, in thirty minutes.</h3>
<p>4K PNG, retouched, with commercial license. Delivered to your inbox and your dashboard. Re-shoot any look free.</p>
</li>
</ol>
@@ -200,14 +196,14 @@
<section class="shell section" id="pricing" aria-labelledby="pricing-title">
<div class="pricing">
<header class="pricing__head">
- <p class="section__head">03 · Pricing</p>
+ <hr class="section__mark" />
<h2 id="pricing-title">Pay by output, <em>not by seat.</em></h2>
<p>Re-shoots are always free. Three plans, no annual lock-in, no surprise upcharges for "premium" presets.</p>
</header>
<div class="tiers">
<article class="tier reveal" style="--i:0" aria-labelledby="t1">
- <p class="tier__name" id="t1">Studio</p>
+ <h3 class="tier__name" id="t1">Studio</h3>
<p class="tier__price">$39<span class="unit">one-off</span></p>
<p class="tier__sub">For a single round of headshots, on demand.</p>
<ul class="tier__list">
@@ -221,7 +217,7 @@
</article>
<article class="tier tier--rec reveal" style="--i:1" aria-labelledby="t2">
- <p class="tier__name" id="t2">Studio Plus</p>
+ <h3 class="tier__name" id="t2">Studio Plus</h3>
<p class="tier__price">$79<span class="unit">one-off</span></p>
<p class="tier__sub">For founders and execs who reshoot every quarter.</p>
<ul class="tier__list">
@@ -236,7 +232,7 @@
</article>
<article class="tier reveal" style="--i:2" aria-labelledby="t3">
- <p class="tier__name" id="t3">Editorial</p>
+ <h3 class="tier__name" id="t3">Editorial</h3>
<p class="tier__price">$199<span class="unit">per shoot</span></p>
<p class="tier__sub">For press, book covers, and brand work that earns the front page.</p>
<ul class="tier__list">
@@ -257,7 +253,7 @@
<section class="shell section" id="faq" aria-labelledby="faq-title">
<div class="faq">
<header class="faq__head">
- <p class="section__head">04 · FAQ</p>
+ <hr class="section__mark" />
<h2 id="faq-title">Questions, <em>answered honestly.</em></h2>
<p>Five we get most often. If yours isn't here, the answer is probably yes — write us.</p>
</header>
diff --git a/site/examples/bananastudio/styles.css b/site/examples/bananastudio/styles.css
index d8a857b..7c50943 100644
--- a/site/examples/bananastudio/styles.css
+++ b/site/examples/bananastudio/styles.css
@@ -303,7 +303,9 @@ button { font: inherit; background: none; border: 0; color: inherit; cursor: poi
position: relative;
z-index: 2;
}
-.hero__eyebrow {
+/* Release stamp: the build the reader is looking at, not a name for the
+ headline under it. */
+.hero__release {
font-family: var(--font-outlier);
font-size: var(--text-xs);
font-weight: 500;
@@ -315,7 +317,7 @@ button { font: inherit; background: none; border: 0; color: inherit; cursor: poi
gap: 0.6ch;
line-height: 1;
}
-.hero__eyebrow::before {
+.hero__release::before {
content: "";
width: 24px;
height: 1px;
@@ -763,23 +765,29 @@ button { font: inherit; background: none; border: 0; color: inherit; cursor: poi
border-block-end: var(--rule-hair) solid var(--color-rule);
padding-block-end: var(--space-lg);
}
-.section__head {
- font-family: var(--font-outlier);
- font-size: var(--text-xs);
- letter-spacing: 0.16em;
+/* Section mark: the house hairline, on its own. It opened every section
+ already; now it does the whole job, and nothing names the heading below. */
+.section__mark {
+ border: 0;
+ margin: 0 0 var(--space-sm);
color: var(--color-accent);
- text-transform: uppercase;
- line-height: 1;
- display: inline-flex;
+ display: flex;
align-items: center;
gap: 0.6ch;
margin-bottom: var(--space-md);
}
-.section__head::before {
+.section__mark::before {
content: "";
width: 24px; height: 1px;
background: currentColor;
}
+.section__mark::after {
+ content: "";
+ width: 4px; height: 4px;
+ margin-left: 6px;
+ border-radius: 50%;
+ background: currentColor;
+}
.section__title {
font-family: var(--font-display);
font-size: clamp(2rem, 4vw + 0.5rem, 3.5rem);
@@ -1078,6 +1086,7 @@ button { font: inherit; background: none; border: 0; color: inherit; cursor: poi
text-align: end;
}
.steps {
+ counter-reset: step;
display: grid;
grid-template-columns: repeat(3, 1fr);
gap: var(--space-lg);
@@ -1102,6 +1111,9 @@ button { font: inherit; background: none; border: 0; color: inherit; cursor: poi
transform: translateY(-3px);
border-color: var(--color-rule-2);
}
+/* The ordinal comes from the list, not from the markup. */
+.step { counter-increment: step; }
+.step__num::before { content: counter(step, decimal-leading-zero); }
.step__num {
font-family: var(--font-display);
font-size: var(--text-3xl);
@@ -1124,14 +1136,6 @@ button { font: inherit; background: none; border: 0; color: inherit; cursor: poi
align-self: center;
margin-left: var(--space-sm);
}
-.step__stage {
- font-family: var(--font-outlier);
- font-size: var(--text-xs);
- letter-spacing: 0.14em;
- color: var(--color-accent);
- text-transform: uppercase;
- line-height: 1;
-}
.step h3 {
font-family: var(--font-display);
font-size: var(--text-lg);
@@ -1203,6 +1207,7 @@ button { font: inherit; background: none; border: 0; color: inherit; cursor: poi
.tier__name {
font-family: var(--font-outlier);
font-weight: 500;
+ margin: 0;
font-size: var(--text-xs);
text-transform: uppercase;
letter-spacing: 0.16em;
diff --git a/site/examples/carnival-01/index.html b/site/examples/carnival-01/index.html
index f017835..2346a50 100644
--- a/site/examples/carnival-01/index.html
+++ b/site/examples/carnival-01/index.html
@@ -38,7 +38,7 @@
<!-- ─── Hero — H1 Marquee, two-line word ─── -->
<section class="hero">
<div class="shell">
- <p class="hero__eyebrow">
+ <p class="hero__stamp">
<span aria-hidden="true">◆</span>
<span>Brickyard Tapes &nbsp;·&nbsp; Catalog № BYT-024 &nbsp;·&nbsp; Out 14 March</span>
</p>
@@ -81,56 +81,55 @@
<section class="shell artists" id="artists" aria-labelledby="artists-title">
<h2 id="artists-title" class="sr-only">The three artists on Cold Snap</h2>
- <article class="artist artist--mustard">
- <figure class="artist__art" aria-hidden="true">
- <div class="halftone halftone--dense"></div>
- </figure>
- <div>
- <p class="artist__num">01.</p>
- <h3 class="artist__name">June Belmont</h3>
- <p class="artist__sub">Detroit &nbsp;·&nbsp; Vocals &nbsp;·&nbsp; Synth</p>
- <p class="artist__copy">Two tracks. The first is the title track. The second is the one we played first when we listened back and immediately fought over who got to sequence the EP.</p>
- </div>
- <div class="artist__track">
- <span class="mono">Lead single</span>
- <span class="title">Cold Snap</span>
- <span class="dur">3:42</span>
- </div>
- </article>
+ <ol class="artists__list">
+ <li class="artist artist--mustard">
+ <figure class="artist__art" aria-hidden="true">
+ <div class="halftone halftone--dense"></div>
+ </figure>
+ <div>
+ <h3 class="artist__name">June Belmont</h3>
+ <p class="artist__sub">Detroit &nbsp;·&nbsp; Vocals &nbsp;·&nbsp; Synth</p>
+ <p class="artist__copy">Two tracks. The first is the title track. The second is the one we played first when we listened back and immediately fought over who got to sequence the EP.</p>
+ </div>
+ <div class="artist__track">
+ <span class="mono">Lead single</span>
+ <span class="title">Cold Snap</span>
+ <span class="dur">3:42</span>
+ </div>
+ </li>
- <article class="artist artist--oxblood">
- <figure class="artist__art" aria-hidden="true">
- <div class="halftone"></div>
- </figure>
- <div>
- <p class="artist__num">02.</p>
- <h3 class="artist__name">Wax Theatre</h3>
- <p class="artist__sub">Brooklyn &nbsp;·&nbsp; Guitar &nbsp;·&nbsp; Tape loops</p>
- <p class="artist__copy">Two tracks recorded over one weekend at the practice space on Smith Street. Live, no overdubs. The amp hum is the second instrument and we kept it in on purpose.</p>
- </div>
- <div class="artist__track">
- <span class="mono">Track B / C</span>
- <span class="title">Long January</span>
- <span class="dur">4:18</span>
- </div>
- </article>
+ <li class="artist artist--oxblood">
+ <figure class="artist__art" aria-hidden="true">
+ <div class="halftone"></div>
+ </figure>
+ <div>
+ <h3 class="artist__name">Wax Theatre</h3>
+ <p class="artist__sub">Brooklyn &nbsp;·&nbsp; Guitar &nbsp;·&nbsp; Tape loops</p>
+ <p class="artist__copy">Two tracks recorded over one weekend at the practice space on Smith Street. Live, no overdubs. The amp hum is the second instrument and we kept it in on purpose.</p>
+ </div>
+ <div class="artist__track">
+ <span class="mono">Track B / C</span>
+ <span class="title">Long January</span>
+ <span class="dur">4:18</span>
+ </div>
+ </li>
- <article class="artist artist--mustard">
- <figure class="artist__art" aria-hidden="true">
- <div class="halftone halftone--dense"></div>
- </figure>
- <div>
- <p class="artist__num">03.</p>
- <h3 class="artist__name">Margot Half-Step</h3>
- <p class="artist__sub">Chicago &nbsp;·&nbsp; Piano &nbsp;·&nbsp; Voice</p>
- <p class="artist__copy">Two tracks. One is the EP closer. Margot's voice goes places we did not expect when we signed her. We are happy about it. So is everyone we played the rough mixes for.</p>
- </div>
- <div class="artist__track">
- <span class="mono">Closer</span>
- <span class="title">Light Out</span>
- <span class="dur">5:06</span>
- </div>
- </article>
+ <li class="artist artist--mustard">
+ <figure class="artist__art" aria-hidden="true">
+ <div class="halftone halftone--dense"></div>
+ </figure>
+ <div>
+ <h3 class="artist__name">Margot Half-Step</h3>
+ <p class="artist__sub">Chicago &nbsp;·&nbsp; Piano &nbsp;·&nbsp; Voice</p>
+ <p class="artist__copy">Two tracks. One is the EP closer. Margot's voice goes places we did not expect when we signed her. We are happy about it. So is everyone we played the rough mixes for.</p>
+ </div>
+ <div class="artist__track">
+ <span class="mono">Closer</span>
+ <span class="title">Light Out</span>
+ <span class="dur">5:06</span>
+ </div>
+ </li>
+ </ol>
</section>
<!-- ─── Track list ─── -->
diff --git a/site/examples/carnival-01/styles.css b/site/examples/carnival-01/styles.css
index f508e9a..9a78465 100644
--- a/site/examples/carnival-01/styles.css
+++ b/site/examples/carnival-01/styles.css
@@ -142,7 +142,8 @@ img { max-width: 100%; display: block; }
position: relative;
overflow: hidden;
}
-.hero__eyebrow {
+/* Catalogue stamp: label, number and release date, the way it is printed on the sleeve. */
+.hero__stamp {
font-family: var(--font-label);
text-transform: uppercase;
letter-spacing: var(--tracking-label);
@@ -153,7 +154,7 @@ img { max-width: 100%; display: block; }
align-items: center;
gap: var(--space-sm);
}
-.hero__eyebrow::after {
+.hero__stamp::after {
content: "";
flex: 1;
height: 2px;
@@ -249,11 +250,21 @@ img { max-width: 100%; display: block; }
.artists {
padding-block: var(--space-3xl);
+}
+
+/* The running order is real, so the list element says so and counter() sets the
+ figures. Nothing is typed above a name. */
+.artists__list {
+ list-style: none;
+ margin: 0;
+ padding: 0;
display: grid;
gap: var(--space-2xl);
+ counter-reset: artist;
}
.artist {
+ counter-increment: artist;
position: relative;
padding: var(--space-2xl);
border: 2px solid var(--color-ink);
@@ -269,7 +280,7 @@ img { max-width: 100%; display: block; }
.artist--mustard { background: var(--color-accent); color: var(--color-accent-ink); }
.artist--oxblood { background: var(--color-accent-2); color: var(--color-paper); }
-.artist--oxblood .artist__num { color: var(--color-accent); }
+.artist--oxblood .artist__name::before { color: var(--color-accent); }
.artist--oxblood .artist__name { color: var(--color-paper); }
.artist--oxblood .artist__sub { color: oklch(86% 0.045 50); }
.artist--oxblood .halftone { background-image: radial-gradient(var(--color-paper) 1.5px, transparent 1.5px); }
@@ -289,15 +300,16 @@ img { max-width: 100%; display: block; }
}
.halftone--dense { background-size: 7px 7px; }
-.artist__num {
- font-family: var(--font-display);
- font-weight: 800;
+.artist__name::before {
+ content: counter(artist, decimal-leading-zero) ".";
+ display: block;
font-variation-settings: "wdth" 130;
font-size: var(--text-2xl);
line-height: 1;
color: var(--color-accent-2);
- margin: 0 0 var(--space-xs);
+ margin-bottom: var(--space-xs);
letter-spacing: 0.02em;
+ text-transform: none;
}
.artist__name {
font-family: var(--font-display);
diff --git a/site/examples/cobalt-01/index.html b/site/examples/cobalt-01/index.html
index 21f4fa6..92aef9f 100644
--- a/site/examples/cobalt-01/index.html
+++ b/site/examples/cobalt-01/index.html
@@ -46,23 +46,20 @@
<!-- ─── Hero · text LEFT, live API request/response RIGHT · asymmetric ─── -->
<section class="hero" aria-labelledby="hero-title">
<div class="hero__copy">
- <p class="eyebrow reveal" style="--i:0">
- <span class="eyebrow__dot" aria-hidden="true"></span> Content extraction API
- </p>
- <h1 class="hero__title reveal" id="hero-title" style="--i:1">
+ <h1 class="hero__title reveal" id="hero-title" style="--i:0">
Any URL in. Clean Markdown out.
</h1>
- <p class="hero__lede reveal" style="--i:2">
+ <p class="hero__lede reveal" style="--i:1">
Distil fetches a page, renders the JavaScript, strips nav, ads and
chrome, and hands back the main content as tidy Markdown your model
can actually read. One <code>POST</code> — structured, deterministic,
ready for retrieval.
</p>
- <div class="hero__cta reveal" style="--i:3">
+ <div class="hero__cta reveal" style="--i:2">
<a class="btn btn--accent btn--lg" href="#pricing">Get an API key</a>
<a class="link-arrow" href="#docs">Read the docs <span aria-hidden="true">&#8594;</span></a>
</div>
- <p class="hero__meta reveal" style="--i:4">
+ <p class="hero__meta reveal" style="--i:3">
No credit card · 1,000 free pages · <code>p50 1.4s</code> per fetch
</p>
</div>
@@ -120,13 +117,10 @@
<!-- ─── Features · ASYMMETRIC — one wide code example + two narrow text points ─── -->
<section class="features" id="docs" aria-labelledby="features-title">
<header class="features__head">
- <p class="eyebrow reveal" style="--i:0">
- <span class="eyebrow__dot" aria-hidden="true"></span> Built for pipelines
- </p>
- <h2 class="features__title reveal" id="features-title" style="--i:1">
- The boilerplate problem, solved at the API.
+ <h2 class="features__title reveal" id="features-title" style="--i:0">
+ Your pipeline&rsquo;s boilerplate problem, solved at the API.
</h2>
- <p class="features__lede reveal" style="--i:2">
+ <p class="features__lede reveal" style="--i:1">
You don&rsquo;t want raw HTML in your context window. Distil returns the
part that matters — and tells you exactly what it kept.
</p>
@@ -136,8 +130,7 @@
<!-- wide: a worked SDK example -->
<article class="feature feature--wide reveal" style="--i:0">
<div class="feature__text">
- <p class="feature__kicker">Typed SDK</p>
- <h3 class="feature__title">Five lines to a clean document.</h3>
+ <h3 class="feature__title">A typed SDK, five lines to a clean document.</h3>
<p class="feature__body">
Point the client at a URL and stream structured Markdown straight
into your splitter. Retries, render-wait and rate limits are
@@ -201,18 +194,15 @@ index.<span class="c-fn">add</span><span class="c-punc">(</span>doc.<span class=
<section class="quickstart" aria-labelledby="quickstart-title">
<div class="quickstart__inner">
<div class="quickstart__copy">
- <p class="eyebrow eyebrow--dark reveal" style="--i:0">
- <span class="eyebrow__dot" aria-hidden="true"></span> Quickstart
- </p>
- <h2 class="quickstart__title reveal" id="quickstart-title" style="--i:1">
+ <h2 class="quickstart__title reveal" id="quickstart-title" style="--i:0">
Live in three lines.
</h2>
- <p class="quickstart__lede reveal" style="--i:2">
+ <p class="quickstart__lede reveal" style="--i:1">
Install the SDK, point <code>extract</code> at a URL, and read clean
Markdown back. No headless browser to babysit, no HTML to scrub —
the happy path is the whole path.
</p>
- <p class="quickstart__meta reveal" style="--i:3">
+ <p class="quickstart__meta reveal" style="--i:2">
<a class="quickstart__link" href="#docs">Full SDK reference <span aria-hidden="true">&#8594;</span></a>
</p>
</div>
@@ -235,20 +225,17 @@ console.<span class="c-fn">log</span><span class="c-punc">(</span>doc.<span clas
<!-- ─── Pricing band · simple, hairline-framed · one cobalt CTA ─── -->
<section class="pricing" id="pricing" aria-labelledby="pricing-title">
<div class="pricing__head">
- <p class="eyebrow reveal" style="--i:0">
- <span class="eyebrow__dot" aria-hidden="true"></span> Pricing
- </p>
- <h2 class="pricing__title reveal" id="pricing-title" style="--i:1">
+ <h2 class="pricing__title reveal" id="pricing-title" style="--i:0">
Pay for pages, not seats.
</h2>
- <p class="pricing__lede reveal" style="--i:2">
+ <p class="pricing__lede reveal" style="--i:1">
Metered per successful extraction. Failed fetches are never billed.
</p>
</div>
<div class="plans">
<article class="plan reveal" style="--i:0">
- <p class="plan__name">Free</p>
+ <h3 class="plan__name">Free</h3>
<p class="plan__price"><span class="plan__num">$0</span></p>
<p class="plan__unit">1,000 pages / month</p>
<ul class="plan__list">
@@ -261,7 +248,7 @@ console.<span class="c-fn">log</span><span class="c-punc">(</span>doc.<span clas
<article class="plan plan--feature reveal" style="--i:1">
<span class="plan__badge">Most teams</span>
- <p class="plan__name">Scale</p>
+ <h3 class="plan__name">Scale</h3>
<p class="plan__price"><span class="plan__num">$0.0008</span></p>
<p class="plan__unit">per page · volume tiers</p>
<ul class="plan__list">
@@ -274,7 +261,7 @@ console.<span class="c-fn">log</span><span class="c-punc">(</span>doc.<span clas
</article>
<article class="plan reveal" style="--i:2">
- <p class="plan__name">Enterprise</p>
+ <h3 class="plan__name">Enterprise</h3>
<p class="plan__price"><span class="plan__num">Custom</span></p>
<p class="plan__unit">dedicated &amp; on-prem</p>
<ul class="plan__list">
diff --git a/site/examples/cobalt-01/styles.css b/site/examples/cobalt-01/styles.css
index 4d03d6d..b53740e 100644
--- a/site/examples/cobalt-01/styles.css
+++ b/site/examples/cobalt-01/styles.css
@@ -77,21 +77,8 @@ code, kbd, pre { font-family: var(--font-mono); }
}
/* ─── Shared atoms ─────────────────────────────────────────── */
-.eyebrow {
- display: inline-flex;
- align-items: center;
- gap: 0.55em;
- font-family: var(--font-mono);
- font-size: var(--step-small);
- letter-spacing: var(--tracking-label);
- text-transform: uppercase;
- color: var(--color-muted);
-}
-.eyebrow__dot {
- width: 6px; height: 6px;
- border-radius: 50%;
- background: var(--color-accent);
-}
+/* Sections open on the heading and the space above it. The quickstart band opens
+ on its change of paper. Nothing is labelled before it happens. */
.btn {
display: inline-flex;
@@ -495,14 +482,6 @@ code:not(.code code):not(.strip__cmd):not(.foot__ver) {
gap: clamp(1.5rem, 4vw, 3rem);
align-items: center;
}
-.feature__kicker {
- font-family: var(--font-mono);
- font-size: var(--step-small);
- letter-spacing: var(--tracking-label);
- text-transform: uppercase;
- color: var(--color-accent);
- margin-bottom: 0.8rem;
-}
.feature__num {
display: block;
font-family: var(--font-mono);
@@ -572,7 +551,6 @@ code:not(.code code):not(.strip__cmd):not(.foot__ver) {
gap: clamp(2rem, 5vw, 4.5rem);
align-items: center;
}
-.eyebrow--dark { color: var(--color-quick-muted); }
.quickstart__title {
font-family: var(--font-display);
font-weight: var(--weight-semi);
diff --git a/site/examples/cobalt-01/tokens.css b/site/examples/cobalt-01/tokens.css
index d7e3dd2..498c2e8 100644
--- a/site/examples/cobalt-01/tokens.css
+++ b/site/examples/cobalt-01/tokens.css
@@ -45,7 +45,7 @@
--step-lede: clamp(1.0625rem, 0.8vw + 0.7rem, 1.3125rem);
--step-body: 1.0625rem;
--step-code: 0.875rem;
- --step-small: 0.75rem; /* mono labels / eyebrows */
+ --step-small: 0.75rem; /* mono labels / meta rows */
--tracking-display: -0.03em;
--tracking-snug: -0.015em;
diff --git a/site/examples/custom-03/index.html b/site/examples/custom-03/index.html
index cb2c25c..05ee6fc 100644
--- a/site/examples/custom-03/index.html
+++ b/site/examples/custom-03/index.html
@@ -34,9 +34,9 @@
<!-- Intro / the central explainer ------------------------------- -->
<section class="intro" aria-labelledby="intro-title">
- <p class="eyebrow">The Periodic Index of Blends</p>
<h1 class="intro__title" id="intro-title">
- Twenty-eight teas, placed by how each one is made.
+ The Periodic Index of Blends: twenty-eight teas, placed by how each one
+ is made.
</h1>
<p class="intro__lede">
We stopped writing our menu as a list. A list flattens a leaf that has
@@ -402,14 +402,13 @@
<!-- DETAIL PANEL · the assay of the selected element ----------- -->
<aside class="assay" id="assay" aria-labelledby="assay-name" aria-live="polite">
- <p class="assay__eyebrow">
- <span class="assay__index" id="assay-index">01</span>
- <span class="assay__fam" id="assay-fam">White</span>
- </p>
-
- <div class="assay__plate" aria-hidden="true">
- <span class="assay__sym" id="assay-sym">Sv</span>
- </div>
+ <figure class="assay__plate">
+ <span class="assay__sym" id="assay-sym" aria-hidden="true">Sv</span>
+ <figcaption class="assay__ident">
+ <span class="assay__index" id="assay-index">01</span>
+ <span class="assay__fam" id="assay-fam">White</span>
+ </figcaption>
+ </figure>
<h3 class="assay__name" id="assay-name">Silver Veil</h3>
<p class="assay__origin" id="assay-origin">High terraces, the Cloud Coast</p>
diff --git a/site/examples/custom-03/styles.css b/site/examples/custom-03/styles.css
index 1d93bbe..0b6a437 100644
--- a/site/examples/custom-03/styles.css
+++ b/site/examples/custom-03/styles.css
@@ -166,22 +166,13 @@ button { font: inherit; color: inherit; }
padding: var(--space-2xl) var(--space-lg) var(--space-4xl);
}
-.eyebrow {
- font-family: var(--font-data);
- font-size: var(--text-xs);
- letter-spacing: 0.16em;
- text-transform: uppercase;
- color: var(--color-accent);
- margin-bottom: var(--space-md);
-}
-
.intro__title {
font-family: var(--font-display);
font-weight: 600;
font-size: var(--text-3xl);
line-height: var(--lh-tight);
letter-spacing: -0.018em;
- max-width: 20ch;
+ max-width: 26ch;
overflow-wrap: anywhere;
min-width: 0;
text-wrap: balance;
@@ -378,28 +369,21 @@ button { font: inherit; color: inherit; }
box-shadow: var(--shadow-panel);
}
-.assay__eyebrow {
- display: flex;
- align-items: center;
- gap: var(--space-sm);
- font-family: var(--font-data);
- font-size: var(--text-2xs);
- letter-spacing: 0.08em;
- text-transform: uppercase;
-}
-.assay__index { color: var(--color-accent); font-weight: 700; }
-.assay__fam { color: var(--color-muted); }
-
+/* the specimen plate: the symbol tile, then its catalogue line UNDER it.
+ Index and family identify the sample that is already on screen, so they
+ read as a caption rather than an announcement of the name below. */
.assay__plate {
- margin: var(--space-md) 0 var(--space-sm);
+ margin: 0 0 var(--space-sm);
+ width: max-content;
+ min-width: 5.5rem;
+}
+.assay__sym {
+ display: grid;
+ place-items: center;
width: 5.5rem; height: 5.5rem;
border: 1px solid var(--color-line-2);
border-radius: var(--radius-sm);
background: var(--color-paper-3);
- display: grid;
- place-items: center;
-}
-.assay__sym {
font-family: var(--font-display);
font-weight: 600;
font-size: 2.6rem;
@@ -407,6 +391,18 @@ button { font: inherit; color: inherit; }
letter-spacing: -0.02em;
color: var(--color-ink);
}
+.assay__ident {
+ margin-top: var(--space-2xs);
+ display: flex;
+ align-items: center;
+ gap: var(--space-sm);
+ font-family: var(--font-data);
+ font-size: var(--text-2xs);
+ letter-spacing: 0.08em;
+ text-transform: uppercase;
+}
+.assay__index { color: var(--color-accent); font-weight: 700; }
+.assay__fam { color: var(--color-muted); }
.assay__name {
font-family: var(--font-display);
@@ -470,7 +466,7 @@ button { font: inherit; color: inherit; }
/* the ONE orchestrated motion: when a blend is selected, the panel's
inner content steps forward (lift + settle). JS toggles .is-swapping. */
.assay__plate, .assay__name, .assay__origin,
-.assay__stats, .assay__notes, .assay__eyebrow {
+.assay__stats, .assay__notes {
transition: opacity var(--dur) var(--ease-out),
transform var(--dur) var(--ease-out);
}
@@ -478,8 +474,7 @@ button { font: inherit; color: inherit; }
.assay.is-swapping .assay__name,
.assay.is-swapping .assay__origin,
.assay.is-swapping .assay__stats,
-.assay.is-swapping .assay__notes,
-.assay.is-swapping .assay__eyebrow {
+.assay.is-swapping .assay__notes {
opacity: 0;
transform: translateY(6px);
}
@@ -553,7 +548,6 @@ button { font: inherit; color: inherit; }
display: grid;
grid-template-columns: auto 1fr;
grid-template-areas:
- "plate eyebrow"
"plate name"
"stats stats"
"notes notes"
@@ -561,9 +555,8 @@ button { font: inherit; color: inherit; }
column-gap: var(--space-md);
align-items: center;
}
- .assay__eyebrow { grid-area: eyebrow; }
- .assay__plate { grid-area: plate; margin: 0; width: 4.25rem; height: 4.25rem; align-self: start; }
- .assay__sym { font-size: 1.9rem; }
+ .assay__plate { grid-area: plate; margin: 0; min-width: 4.25rem; align-self: start; }
+ .assay__sym { width: 4.25rem; height: 4.25rem; font-size: 1.9rem; }
.assay__name { grid-area: name; }
.assay__origin { display: none; }
.assay__stats { grid-area: stats; grid-template-columns: repeat(4, 1fr); }
@@ -591,7 +584,7 @@ button { font: inherit; color: inherit; }
.ptable::after { display: none; }
.assay {
grid-template-columns: 1fr;
- grid-template-areas: "eyebrow" "plate" "name" "stats" "notes" "hint";
+ grid-template-areas: "plate" "name" "stats" "notes" "hint";
text-align: left;
}
.assay__plate { margin-bottom: var(--space-2xs); }
@@ -625,8 +618,7 @@ button { font: inherit; color: inherit; }
.assay.is-swapping .assay__name,
.assay.is-swapping .assay__origin,
.assay.is-swapping .assay__stats,
- .assay.is-swapping .assay__notes,
- .assay.is-swapping .assay__eyebrow {
+ .assay.is-swapping .assay__notes {
opacity: 1;
transform: none;
}
diff --git a/site/examples/custom-04/index.html b/site/examples/custom-04/index.html
index 3880aa5..6b93876 100644
--- a/site/examples/custom-04/index.html
+++ b/site/examples/custom-04/index.html
@@ -82,8 +82,7 @@
<!-- ═══════════ The manifesto spine ═══════════ -->
<section class="sheet spine" id="manifesto" aria-labelledby="spine-title">
<div class="spine__head">
- <p class="spine__eyebrow">Five things we hold to be true</p>
- <h2 class="spine__title">The right to repair what is yours</h2>
+ <h2 class="spine__title">Five things we hold true about the right to repair what is yours</h2>
</div>
<!-- 01 — hangs into the left margin -->
diff --git a/site/examples/custom-04/styles.css b/site/examples/custom-04/styles.css
index 45dc5ed..aa86d6f 100644
--- a/site/examples/custom-04/styles.css
+++ b/site/examples/custom-04/styles.css
@@ -284,18 +284,11 @@ body::after { /* directional grain — fine diagonal hatch */
padding-top: clamp(var(--space-xl), 5vw, var(--space-3xl));
}
.spine__head {
- display: block; /* gate 54 — eyebrow + heading single column */
+ display: block;
margin-bottom: clamp(var(--space-xl), 6vw, var(--space-3xl));
}
-.spine__eyebrow {
- font-family: var(--font-mono);
- font-size: var(--text-xs);
- letter-spacing: 0.16em;
- text-transform: uppercase;
- color: var(--color-accent-deep);
-}
.spine__title {
- margin-top: var(--space-sm);
+ margin-top: 0;
font-family: var(--font-display);
font-weight: 700;
font-size: var(--text-3xl);
diff --git a/site/examples/custom-05/styles.css b/site/examples/custom-05/styles.css
index 963e752..a5d0b77 100644
--- a/site/examples/custom-05/styles.css
+++ b/site/examples/custom-05/styles.css
@@ -343,7 +343,7 @@ section[tabindex]:focus { outline: none; }
.track--b .track__copy { grid-column: 1; grid-row: 1 / 3; align-self: center; }
.track--b .minwave { grid-column: 1 / -1; }
-.track__head { grid-column: 1; } /* eyebrow + heading stacked (gate 54) */
+.track__head { grid-column: 1; } /* heading alone, single column (gate 54) */
.track__title {
font-family: var(--font-display);
font-weight: 460;
diff --git a/site/examples/field-01/index.html b/site/examples/field-01/index.html
index df83d44..c0eb9ad 100644
--- a/site/examples/field-01/index.html
+++ b/site/examples/field-01/index.html
@@ -81,11 +81,6 @@ mark { background-color: transparent; color: inherit; }
.wrap { max-width: 1200px; margin-inline: auto; padding-inline: var(--gutter); }
-.eyebrow {
- font-family: var(--font-body); font-weight: 600; font-size: 0.8125rem;
- letter-spacing: 0.12em; text-transform: uppercase; color: var(--ink-3);
-}
-
/* ---- the highlighter mark: a marigold band behind the x-height ---- */
.mark {
padding-inline: 0.06em;
@@ -201,18 +196,20 @@ mark { background-color: transparent; color: inherit; }
.note__label { font-weight: 600; color: var(--ink); font-size: 0.9375rem; }
.note__value { color: var(--ink-3); font-size: 0.9375rem; text-align: right; }
-/* ---- section head (eyebrow stacked ABOVE heading) ---- */
+/* ---- section head: the heading opens the section, nothing above it ---- */
.section { padding-block: var(--section-y); }
.head { display: flex; flex-direction: column; gap: var(--space-3); max-width: 60ch; margin-bottom: var(--space-12); }
.head__title { font-size: clamp(1.75rem, 1.1rem + 2.4vw, 2.5rem); }
.head__sub { color: var(--ink-2); font-size: 1.0625rem; }
/* ---- how it works: three connected beats (flex, staggered) ---- */
-.beats { position: relative; display: flex; gap: clamp(24px, 4vw, 56px); }
-.beat { flex: 1 1 0; min-width: 0; position: relative; z-index: 1; }
+/* a real ordered list: counter() sets the 01 / 02 / 03, nothing is typed */
+.beats { position: relative; }
+.beats__list { list-style: none; margin: 0; padding: 0; counter-reset: beat; display: flex; gap: clamp(24px, 4vw, 56px); }
+.beat { counter-increment: beat; flex: 1 1 0; min-width: 0; position: relative; z-index: 1; }
.beat:nth-of-type(2) { margin-top: var(--space-8); }
.beat:nth-of-type(3) { margin-top: var(--space-16); }
-.beat__num { font-family: var(--font-display); font-weight: 600; font-size: 1rem; color: var(--accent-deep); letter-spacing: 0.04em; }
+.beat::before { content: counter(beat, decimal-leading-zero); display: block; font-family: var(--font-display); font-weight: 600; font-size: 1rem; color: var(--accent-deep); letter-spacing: 0.04em; }
.beat__spot { display: block; width: clamp(56px, 7vw, 72px); height: auto; margin: var(--space-4) 0 var(--space-5); }
.beat__title { font-size: 1.375rem; margin-bottom: var(--space-3); }
.beat__text { color: var(--ink-2); font-size: 1rem; }
@@ -223,7 +220,6 @@ mark { background-color: transparent; color: inherit; }
.feature { display: grid; grid-template-columns: minmax(0, 1fr) minmax(0, 1fr); gap: clamp(28px, 5vw, 64px); align-items: center; }
.feature__title { font-size: clamp(1.5rem, 1.1rem + 1.4vw, 1.875rem); margin-bottom: var(--space-4); }
.feature__text p { color: var(--ink-2); max-width: 54ch; }
-.feature__tag { display: inline-block; margin-bottom: var(--space-4); }
.feature__art { display: flex; justify-content: center; }
.feature__art svg { width: min(100%, 300px); height: auto; }
.card {
@@ -256,7 +252,7 @@ mark { background-color: transparent; color: inherit; }
.hero__inner { grid-template-columns: minmax(0, 1fr); min-height: 0; gap: var(--space-12); }
.hero__aside { justify-content: flex-start; }
.doodle { display: none; }
- .beats { flex-direction: column; gap: var(--space-10); }
+ .beats__list { flex-direction: column; gap: var(--space-10); }
.beat:nth-of-type(2), .beat:nth-of-type(3) { margin-top: 0; }
.beats__thread { display: none; }
.feature, .feature--flip { grid-template-columns: minmax(0, 1fr); }
@@ -341,7 +337,6 @@ mark { background-color: transparent; color: inherit; }
<section class="section" id="how">
<div class="wrap">
<div class="head">
- <p class="eyebrow">How it works</p>
<h2 class="head__title">From talk to plan, in three moves.</h2>
<p class="head__sub">No bot in the meeting asking people to repeat themselves. Fieldnote stays quiet and does the writing.</p>
</div>
@@ -351,18 +346,17 @@ mark { background-color: transparent; color: inherit; }
<path class="ink-2" style="stroke-dasharray: 3 9" d="M8 14 C 170 42, 300 24, 460 58 C 620 90, 754 74, 892 106" />
</svg>
- <div class="beat">
- <span class="beat__num">01</span>
+ <ol class="beats__list">
+ <li class="beat">
<svg class="beat__spot" viewBox="0 0 72 72" aria-hidden="true" fill="none">
<path class="ink" d="M10 16 h38 a6 6 0 0 1 6 6 v18 a6 6 0 0 1 -6 6 h-22 l-12 10 v-10 h-4 a6 6 0 0 1 -6 -6 v-18 a6 6 0 0 1 6 -6 z" />
<path class="acc" d="M18 26 h24 M18 34 h16" />
</svg>
<h3 class="beat__title">It listens</h3>
<p class="beat__text">Add Fieldnote to the call. It follows the conversation and keeps its head down while people talk.</p>
- </div>
+ </li>
- <div class="beat">
- <span class="beat__num">02</span>
+ <li class="beat">
<svg class="beat__spot" viewBox="0 0 72 72" aria-hidden="true" fill="none">
<path class="ink" d="M14 12 h26 l18 18 v30 a4 4 0 0 1 -4 4 h-40 a4 4 0 0 1 -4 -4 v-44 a4 4 0 0 1 4 -4 z" />
<path class="ink-2" d="M40 12 v18 h18" />
@@ -370,10 +364,9 @@ mark { background-color: transparent; color: inherit; }
</svg>
<h3 class="beat__title">It sorts</h3>
<p class="beat__text">Every commitment becomes an owner, a date, and a decision, written the moment it is said out loud.</p>
- </div>
+ </li>
- <div class="beat">
- <span class="beat__num">03</span>
+ <li class="beat">
<svg class="beat__spot" viewBox="0 0 72 72" aria-hidden="true" fill="none">
<path class="ink" d="M10 20 h52 a4 4 0 0 1 4 4 v28 a4 4 0 0 1 -4 4 h-52 a4 4 0 0 1 -4 -4 v-28 a4 4 0 0 1 4 -4 z" />
<path class="ink-2" d="M8 23 l28 20 l28 -20" />
@@ -381,7 +374,8 @@ mark { background-color: transparent; color: inherit; }
</svg>
<h3 class="beat__title">It hands off</h3>
<p class="beat__text">The plan lands in your inbox and your task tools before the room clears. Nobody re-types the notes.</p>
- </div>
+ </li>
+ </ol>
</div>
</div>
</section>
@@ -390,7 +384,6 @@ mark { background-color: transparent; color: inherit; }
<section class="section" id="features">
<div class="wrap">
<div class="head">
- <p class="eyebrow">What you get</p>
<h2 class="head__title">A record the room can trust.</h2>
</div>
@@ -398,8 +391,7 @@ mark { background-color: transparent; color: inherit; }
<article class="feature">
<div class="feature__text">
- <span class="eyebrow feature__tag">Owners, not action items</span>
- <h3 class="feature__title">Every next step has a name on it.</h3>
+ <h3 class="feature__title">Every next step leaves with an owner's name on it.</h3>
<p>A task with no owner is a task nobody does. Fieldnote assigns each next step to the person who spoke up for it, and asks in the room if it is not obvious. You leave with a list of people, not a pile of verbs.</p>
</div>
<div class="feature__art">
@@ -417,7 +409,6 @@ mark { background-color: transparent; color: inherit; }
<article class="feature feature--flip">
<div class="feature__text">
- <span class="eyebrow feature__tag">Dates it can defend</span>
<h3 class="feature__title">Due dates tied to what was actually said.</h3>
<p>When someone says "by end of week," Fieldnote writes the date, not the phrase, and links it back to the sentence it came from. If a date was never agreed, it says so plainly instead of inventing one.</p>
</div>
@@ -437,8 +428,7 @@ mark { background-color: transparent; color: inherit; }
<article class="feature">
<div class="feature__text">
- <span class="eyebrow feature__tag">Decisions, kept</span>
- <h3 class="feature__title">The moment a call was made, saved for later.</h3>
+ <h3 class="feature__title">The moment a call was made, kept for later.</h3>
<p>Two weeks on, when someone asks why you went with the smaller launch, the answer is one search away. Fieldnote keeps the decision and the reasoning next to it, so the plan holds up when memory does not.</p>
</div>
<div class="feature__art">
@@ -460,8 +450,7 @@ mark { background-color: transparent; color: inherit; }
<!-- WARM CTA -->
<section class="section band" id="pricing">
<div class="wrap invite__inner">
- <p class="eyebrow">Try it on one meeting</p>
- <h2 class="invite__title">Bring your next standup. We will write the plan.</h2>
+ <h2 class="invite__title">Try it on your next standup. We will write the plan.</h2>
<p class="invite__lede">Fieldnote is new, and still small. Start free, point it at one real meeting, and tell us where it gets things wrong. We are a few people who read every note that comes back.</p>
<div class="invite__row">
<button class="btn btn--primary" type="button">Start free</button>
diff --git a/site/examples/garden-01/index.html b/site/examples/garden-01/index.html
index dd9899c..4747f41 100644
--- a/site/examples/garden-01/index.html
+++ b/site/examples/garden-01/index.html
@@ -35,20 +35,19 @@
<!-- ── Hero · typographic + hand-built honeycomb/jar craft ── -->
<section class="hero" aria-labelledby="hero-title">
<div class="hero__copy">
- <p class="hero__eyebrow reveal" style="--i:0">Nine hives. One ridge. No blending.</p>
- <h1 class="hero__title reveal" id="hero-title" style="--i:1">
- Honey that tastes like one&nbsp;hillside.
+ <h1 class="hero__title reveal" id="hero-title" style="--i:0">
+ Honey from nine hives on one&nbsp;hillside.
</h1>
- <p class="hero__lede reveal" style="--i:2">
+ <p class="hero__lede reveal" style="--i:1">
We keep bees on a single south-facing ridge above the Lamoille valley and
pour what they make, one season at a time &mdash; unfiltered, unblended, never
warmed past the temperature of the hive.
</p>
- <div class="hero__actions reveal" style="--i:3">
+ <div class="hero__actions reveal" style="--i:2">
<a class="btn btn--solid" href="#lot">See this season&rsquo;s lot</a>
<a class="btn btn--ghost" href="#ridge">Read about the ridge</a>
</div>
- <p class="hero__note reveal" style="--i:4">
+ <p class="hero__note reveal" style="--i:3">
<span class="hero__note-mark" aria-hidden="true"></span>
Lot No.&nbsp;14 &middot; poured 4&ndash;5 September &middot; 312 jars
</p>
@@ -56,7 +55,7 @@
<!-- Tier-A CSS honeycomb wash + Tier-B hand-built SVG jar.
Decorative, but anchored: it is the jar the page is selling. -->
- <figure class="hero__craft reveal" style="--i:3" aria-label="An illustration of a glass jar of amber honey resting on a field of honeycomb">
+ <figure class="hero__craft reveal" style="--i:2" aria-label="An illustration of a glass jar of amber honey resting on a field of honeycomb">
<div class="comb" aria-hidden="true">
<span style="--c:0"></span><span style="--c:1"></span><span style="--c:2"></span>
<span style="--c:3"></span><span style="--c:4"></span><span style="--c:5"></span>
@@ -275,7 +274,7 @@
</p>
</section>
- <!-- ── How it's poured · short process (stacked, no eyebrows) ─ -->
+ <!-- ── How it's poured · short process, stacked, heading only ─ -->
<section class="poured" id="poured" aria-labelledby="poured-title">
<div class="poured__head">
<h2 class="section__title" id="poured-title">How a jar is filled</h2>
diff --git a/site/examples/garden-01/styles.css b/site/examples/garden-01/styles.css
index 9bb88aa..5b6e05f 100644
--- a/site/examples/garden-01/styles.css
+++ b/site/examples/garden-01/styles.css
@@ -223,13 +223,6 @@ a { color: inherit; text-decoration: none; }
}
.hero__copy { max-width: 36rem; }
-.hero__eyebrow {
- font: 500 var(--text-sm)/1.3 var(--font-label);
- letter-spacing: var(--tracking-label);
- text-transform: uppercase;
- color: var(--color-accent);
- margin-bottom: var(--space-md);
-}
.hero__title {
font-family: var(--font-display);
font-weight: var(--display-weight);
@@ -588,7 +581,7 @@ a { color: inherit; text-decoration: none; }
.card__stock[data-stock="out"]::before { background: var(--color-muted); }
/* ════════════════════════════════════════════════════════════════
- HOW A JAR IS FILLED — short process, stacked (no eyebrows)
+ HOW A JAR IS FILLED: short process, stacked, heading only
════════════════════════════════════════════════════════════════ */
.poured__head,
.poured__steps {
diff --git a/site/examples/grid-01/index.html b/site/examples/grid-01/index.html
index 8a58ab5..7230134 100644
--- a/site/examples/grid-01/index.html
+++ b/site/examples/grid-01/index.html
@@ -92,11 +92,11 @@ a:active { opacity: 0.7; }
gap: 0;
}
-.label {
- font-size: 12px; font-weight: 600; letter-spacing: 0.09em;
- text-transform: uppercase; line-height: 1.2; color: var(--muted);
-}
+/* Section mark - a short red bar on the section's own hairline. It is the only
+ thing that opens a section here, all the way down the page. No words. */
.sec-head { padding-block: var(--space-6) var(--space-6); }
+.sec-head__rule { height: 3px; width: var(--space-9); background: var(--red); border: 0; margin: 0; }
+.sec-head__rule + .sec-head__title { margin-top: var(--space-4); }
.sec-head__title {
font-family: var(--font-display); font-weight: 800;
font-size: clamp(28px, 3.6vw, 46px); letter-spacing: -0.025em;
@@ -166,8 +166,10 @@ a:active { opacity: 0.7; }
/* ---- method band: practice / method / standort ---- */
.band { padding-block: clamp(48px, 8vw, 112px); border-top: 1px solid var(--ink); }
-.band__cols { margin-top: var(--space-4); }
+/* a real ordered list: counter() draws A / B / C, nothing is typed */
+.band__cols { margin-top: var(--space-4); list-style: none; margin-inline: 0; padding: 0; counter-reset: band; }
.band__col {
+ counter-increment: band;
grid-column: span 4;
padding-inline-end: var(--space-6);
padding-top: var(--space-4);
@@ -175,7 +177,9 @@ a:active { opacity: 0.7; }
min-width: 0;
}
.band__col:first-child { border-top-color: var(--ink); }
-.band__num {
+.band__col::before {
+ content: counter(band, upper-alpha);
+ display: block;
font-family: var(--font-display); font-weight: 800; font-size: 14px;
color: var(--muted); letter-spacing: 0;
}
@@ -240,8 +244,6 @@ a:active { opacity: 0.7; }
/* ---- contact ---- */
.contact { padding-block: clamp(48px, 8vw, 112px); border-top: 1px solid var(--ink); }
-.contact__rule { height: 3px; width: var(--space-9); background: var(--red); }
-.contact .sec-head .label { margin-top: var(--space-4); }
.contact__body { margin-top: var(--space-6); }
.contact__main { grid-column: 1 / span 7; min-width: 0; }
.contact__mail {
@@ -330,7 +332,6 @@ a:active { opacity: 0.7; }
<main id="main">
<section class="hero" aria-labelledby="hero-title">
- <p class="label">Identity &amp; signage systems</p>
<h1 class="hero__title" id="hero-title">schedule,<br />then ship<span class="hero__period" aria-hidden="true"></span></h1>
<div class="hero__foot">
<p class="hero__lead">Büro Grid builds identity, wayfinding, and editorial systems for institutions that plan in decades. We draw the grid first, so every decision after it has somewhere to stand.</p>
@@ -340,32 +341,29 @@ a:active { opacity: 0.7; }
<section class="band" id="method" aria-labelledby="method-title">
<div class="sec-head">
- <p class="label">01 · Practice</p>
+ <hr class="sec-head__rule" />
<h2 class="sec-head__title" id="method-title">Structure before surface</h2>
</div>
- <div class="band__cols grid">
- <div class="band__col">
- <p class="band__num">A</p>
+ <ol class="band__cols grid">
+ <li class="band__col">
<h3>Practice</h3>
<p>Identity systems, signage programmes, and editorial grids. Each project begins as a set of rules, never as a single picture.</p>
- </div>
- <div class="band__col">
- <p class="band__num">B</p>
+ </li>
+ <li class="band__col">
<h3>Method</h3>
<p>Fixed modules, one measure, a single accent. The system has to survive twenty years of new hands, new content, and new signage.</p>
- </div>
- <div class="band__col">
- <p class="band__num">C</p>
+ </li>
+ <li class="band__col">
<h3>Standort</h3>
<p>Based in Basel, working across the institutional landscape in German and English. On site whenever the building itself needs us.</p>
- </div>
- </div>
+ </li>
+ </ol>
</section>
<section class="work" id="work" aria-labelledby="work-title">
<div class="sec-head">
- <p class="label">02 · Selected work</p>
- <h2 class="sec-head__title" id="work-title">Index</h2>
+ <hr class="sec-head__rule" />
+ <h2 class="sec-head__title" id="work-title">Index of selected work</h2>
</div>
<ol class="work__list">
<li>
@@ -421,7 +419,8 @@ a:active { opacity: 0.7; }
<section class="manifesto" aria-labelledby="pos-title">
<div class="sec-head">
- <p class="label" id="pos-title">Position</p>
+ <hr class="sec-head__rule" />
+ <h2 class="sec-head__title" id="pos-title">Position</h2>
</div>
<div class="manifesto__body grid">
<p class="manifesto__line">A grid is not decoration. It is a decision made once, in public, so that every decision after it can be smaller, calmer, and easier to defend<span class="manifesto__dot">.</span></p>
@@ -430,8 +429,7 @@ a:active { opacity: 0.7; }
<section class="contact" id="contact" aria-labelledby="contact-title">
<div class="sec-head">
- <div class="contact__rule" aria-hidden="true"></div>
- <p class="label">Contact</p>
+ <hr class="sec-head__rule" />
<h2 class="sec-head__title" id="contact-title">Start something that outlasts its brief</h2>
</div>
<div class="contact__body grid">
diff --git a/site/examples/hum-07/index.html b/site/examples/hum-07/index.html
index c21e81e..0a9a4ee 100644
--- a/site/examples/hum-07/index.html
+++ b/site/examples/hum-07/index.html
@@ -83,22 +83,21 @@
<!-- ─── The timeline spine · numbered stages ─── -->
<section class="section" id="stages" aria-labelledby="stages-title">
<header class="section__head">
- <p class="eyebrow"><span class="eyebrow__dot eyebrow__dot--mint"></span> The method</p>
+ <hr class="section__mark section__mark--mint" />
<h2 class="section__title" id="stages-title">Four stages, start to slice.</h2>
<p class="section__lede">The same four every loaf. You only ever do one at a time — Bubble holds the timeline so you don't have to keep it in your head.</p>
</header>
- <div class="stages">
+ <ol class="stages">
<!-- 1.0 FEED -->
- <article class="stage stage--mint">
+ <li class="stage stage--mint">
<div class="stage__rail" aria-hidden="true">
- <div class="stage__node"><b>1<small>.0</small></b></div>
+ <div class="stage__node"></div>
<div class="stage__line"></div>
</div>
<div class="stage__panel">
<div class="stage__copy">
- <p class="stage__label">1.0 · Feed · The night before</p>
- <h3 class="stage__title">Wake the starter</h3>
+ <h3 class="stage__title">Wake the starter, the night before</h3>
<p class="stage__text">Stir a spoonful of starter into fresh flour and water before bed. By morning it's doubled, domed, and smells like yogurt and green apples — that's ripe. <b>Bubble times the feed to your kitchen's temperature</b>, so it peaks when you wake up, not at 3 a.m.</p>
<div class="stage__chips">
<span class="chip"><span class="chip__dot"></span> 10–12 hrs · overnight</span>
@@ -113,18 +112,17 @@
</div>
</div>
</div>
- </article>
+ </li>
<!-- 2.0 MIX -->
- <article class="stage stage--cyan">
+ <li class="stage stage--cyan">
<div class="stage__rail" aria-hidden="true">
- <div class="stage__node"><b>2<small>.0</small></b></div>
+ <div class="stage__node"></div>
<div class="stage__line"></div>
</div>
<div class="stage__panel">
<div class="stage__copy">
- <p class="stage__label">2.0 · Mix · Morning</p>
- <h3 class="stage__title">Mix, then let it rest</h3>
+ <h3 class="stage__title">Mix in the morning, then let it rest</h3>
<p class="stage__text">Fold flour, water, the ripe levain and salt into a shaggy dough, then walk away for an hour while the flour drinks and the gluten knits itself — no kneading required. <b>One rest timer, one nudge</b> when it's ready for the first fold.</p>
<div class="stage__chips">
<span class="chip"><span class="chip__dot"></span> 1 hr autolyse</span>
@@ -140,18 +138,17 @@
</div>
</div>
</div>
- </article>
+ </li>
<!-- 3.0 PROVE -->
- <article class="stage stage--pear">
+ <li class="stage stage--pear">
<div class="stage__rail" aria-hidden="true">
- <div class="stage__node"><b>3<small>.0</small></b></div>
+ <div class="stage__node"></div>
<div class="stage__line"></div>
</div>
<div class="stage__panel">
<div class="stage__copy">
- <p class="stage__label">3.0 · Prove · Day, then overnight</p>
- <h3 class="stage__title">Fold, shape, and wait</h3>
+ <h3 class="stage__title">Fold and shape through the day, prove overnight</h3>
<p class="stage__text">Four gentle folds over the first couple of hours build the structure; then the dough bulks for four or five, shapes into a taut round, and rests overnight in the fridge. <b>Bubble paces the folds</b> and tells you when the bulk is genuinely done — by how the dough looks, not just the clock.</p>
<div class="stage__chips">
<span class="chip"><span class="chip__dot"></span> 4–5 hrs bulk</span>
@@ -168,18 +165,17 @@
</div>
</div>
</div>
- </article>
+ </li>
<!-- 4.0 BAKE -->
- <article class="stage stage--coral">
+ <li class="stage stage--coral">
<div class="stage__rail" aria-hidden="true">
- <div class="stage__node"><b>4<small>.0</small></b></div>
+ <div class="stage__node"></div>
<div class="stage__line"></div>
</div>
<div class="stage__panel">
<div class="stage__copy">
- <p class="stage__label">4.0 · Bake · Dawn</p>
- <h3 class="stage__title">Score it, bake it, slice it</h3>
+ <h3 class="stage__title">Score it and bake it at dawn</h3>
<p class="stage__text">Straight from the fridge, slash the top and lower it into a screaming-hot pot — twenty minutes lidded for the rise, twenty more open for the crust. <b>Pull it at the colour you like</b>, then wait the hardest hour of all: letting it cool before you cut.</p>
<div class="stage__chips">
<span class="chip"><span class="chip__dot"></span> 45 min bake</span>
@@ -195,15 +191,15 @@
</div>
</div>
</div>
- </article>
- </div>
+ </li>
+ </ol>
</section>
<!-- ─── The honest math · counters ─── -->
<section class="section section--band section--mint" id="numbers" aria-labelledby="num-title">
<header class="section__head section__head--center">
- <p class="eyebrow"><span class="eyebrow__dot eyebrow__dot--mint"></span> The honest math</p>
- <h2 class="section__title" id="num-title">Mostly, you wait. That's the whole trick.</h2>
+ <hr class="section__mark section__mark--pear" />
+ <h2 class="section__title" id="num-title">The honest math: mostly, you wait.</h2>
</header>
<dl class="numbers">
<div class="bignum">
@@ -224,7 +220,7 @@
<!-- ─── Voices · color-shift cards ─── -->
<section class="section" id="voices" aria-labelledby="vo-title">
<header class="section__head">
- <p class="eyebrow"><span class="eyebrow__dot eyebrow__dot--cyan"></span> From the kitchen</p>
+ <hr class="section__mark section__mark--cyan" />
<h2 class="section__title" id="vo-title">People who used to buy their bread.</h2>
</header>
<ul class="voices">
@@ -246,7 +242,7 @@
<!-- ─── Pricing ─── -->
<section class="section section--band" id="pricing" aria-labelledby="price-title">
<header class="section__head section__head--center">
- <p class="eyebrow"><span class="eyebrow__dot eyebrow__dot--pear"></span> Pricing</p>
+ <hr class="section__mark section__mark--coral" />
<h2 class="section__title" id="price-title">Free to bake. Cheap to get good.</h2>
</header>
<div class="plans">
diff --git a/site/examples/hum-07/styles.css b/site/examples/hum-07/styles.css
index 5bdc300..05cc640 100644
--- a/site/examples/hum-07/styles.css
+++ b/site/examples/hum-07/styles.css
@@ -20,13 +20,15 @@ a:focus-visible, button:focus-visible { outline: 2px solid var(--color-focus); o
button { font: inherit; background: none; border: 0; padding: 0; cursor: pointer; color: inherit; }
.sr-only { position: absolute; width: 1px; height: 1px; padding: 0; margin: -1px; overflow: hidden; clip: rect(0,0,0,0); white-space: nowrap; border: 0; }
-.eyebrow { font-family: var(--font-label); font-size: 11px; letter-spacing: 0.10em; text-transform: uppercase; color: var(--color-ink-2); opacity: 0.78; margin: 0 0 1rem; display: inline-flex; align-items: center; gap: 0.55em; }
-.eyebrow__dot { width: 8px; height: 8px; border-radius: 50%; flex: 0 0 auto; }
-.eyebrow__dot--pear { background: var(--color-accent); }
-.eyebrow__dot--cyan { background: var(--color-accent-2); }
-.eyebrow__dot--coral { background: var(--color-accent-3); }
-.eyebrow__dot--mint { background: var(--color-mint); }
-.eyebrow__dot--lavender { background: var(--color-lavender); }
+/* Section mark - a lit dot on a hairline, opening a section without labelling it.
+ The dot colour rotates down the page; that rhythm is the orientation aid. */
+.section__mark { border: 0; margin: 0 0 1rem; display: flex; align-items: center; gap: 0.55em; }
+.section__mark::before { content: ""; flex: 0 0 auto; width: 8px; height: 8px; border-radius: 50%; background: var(--color-accent); box-shadow: 0 0 12px oklch(86% 0.18 95 / 0.45); }
+.section__mark::after { content: ""; flex: 1; height: 1px; background: var(--color-rule); }
+.section__mark--cyan::before { background: var(--color-accent-2); box-shadow: 0 0 12px oklch(66% 0.18 235 / 0.4); }
+.section__mark--coral::before { background: var(--color-accent-3); box-shadow: 0 0 12px oklch(68% 0.24 18 / 0.4); }
+.section__mark--mint::before { background: var(--color-mint); box-shadow: 0 0 12px oklch(80% 0.16 150 / 0.4); }
+.section__mark--lavender::before { background: var(--color-lavender); box-shadow: 0 0 12px oklch(74% 0.16 305 / 0.4); }
/* Emphasis highlight — clipped background gradient on the text itself (tracks wraps). Mint default. */
em, .hl {
@@ -177,24 +179,25 @@ em, .hl {
.section--mint { background: var(--tint-mint); }
.section__head { margin-bottom: 3rem; max-width: 54rem; }
.section__head--center { text-align: center; margin-inline: auto; }
-.section__head--center .eyebrow { justify-content: center; }
+.section__head--center .section__mark { max-width: 8rem; margin-inline: auto; }
.section__title { font-family: var(--font-display); font-weight: 700; font-size: clamp(2rem, 3.5vw + 0.5rem, 3.25rem); line-height: 1.08; letter-spacing: -0.025em; color: var(--color-ink); margin: 0; max-width: 22ch; text-wrap: balance; }
.section__head--center .section__title { margin-inline: auto; }
.section__lede { font-size: 1.0625rem; line-height: 1.6; color: var(--color-ink-2); max-width: 52ch; margin: 1rem 0 0; }
.section__head--center .section__lede { margin-inline: auto; }
/* ═══ THE TIMELINE SPINE · numbered stages ═══ */
-.stages { display: flex; flex-direction: column; }
-.stage { display: grid; grid-template-columns: clamp(3.25rem, 4vw + 2rem, 4.75rem) 1fr; gap: clamp(1.1rem, 3vw, 2.5rem); }
+/* A real ordered list: the rail numeral is drawn by counter(), never typed. */
+.stages { list-style: none; margin: 0; padding: 0; counter-reset: stage; display: flex; flex-direction: column; }
+.stage { counter-increment: stage; display: grid; grid-template-columns: clamp(3.25rem, 4vw + 2rem, 4.75rem) 1fr; gap: clamp(1.1rem, 3vw, 2.5rem); }
.stage--mint { --st: var(--color-mint); --st-deep: var(--color-mint-deep); --st-ink: var(--color-ink); --st-tint: var(--tint-mint); }
.stage--cyan { --st: var(--color-accent-2); --st-deep: var(--color-accent-2-deep); --st-ink: var(--color-paper); --st-tint: var(--tint-cyan); }
.stage--pear { --st: var(--color-accent); --st-deep: var(--color-accent-deep); --st-ink: var(--color-ink); --st-tint: var(--tint-pear); }
.stage--coral { --st: var(--color-accent-3); --st-deep: var(--color-accent-3-deep); --st-ink: var(--color-paper); --st-tint: var(--tint-coral); }
.stage__rail { position: relative; display: flex; flex-direction: column; align-items: center; }
-.stage__node { width: clamp(3.25rem, 4vw + 2rem, 4.75rem); aspect-ratio: 1; border-radius: 22px; display: grid; place-items: center; background: var(--st); color: var(--st-ink); box-shadow: 0 5px 0 -1px var(--st-deep), var(--shadow-card); font-family: var(--font-display); font-weight: 700; line-height: 1; transform: scale(0.55); opacity: 0; transition: transform 520ms var(--ease-spring), opacity 300ms ease; }
-.stage__node b { font-size: clamp(1.4rem, 1.6vw + 0.7rem, 2rem); letter-spacing: -0.03em; }
-.stage__node small { font-size: 0.5em; opacity: 0.72; }
+.stage__node { width: clamp(3.25rem, 4vw + 2rem, 4.75rem); aspect-ratio: 1; border-radius: 22px; display: flex; align-items: baseline; justify-content: center; background: var(--st); color: var(--st-ink); box-shadow: 0 5px 0 -1px var(--st-deep), var(--shadow-card); font-family: var(--font-display); font-weight: 700; line-height: 1; transform: scale(0.55); opacity: 0; transition: transform 520ms var(--ease-spring), opacity 300ms ease; }
+.stage__node::before { content: counter(stage); font-size: clamp(1.4rem, 1.6vw + 0.7rem, 2rem); letter-spacing: -0.03em; }
+.stage__node::after { content: ".0"; font-size: clamp(0.7rem, 0.8vw + 0.35rem, 1rem); opacity: 0.72; }
.stage__line { flex: 1 1 auto; width: 3px; min-height: clamp(1.5rem, 4vh, 2.75rem); background: var(--st); border-radius: 3px; margin-block: 0.6rem; transform: scaleY(0); transform-origin: top; transition: transform 600ms var(--ease-out) 130ms; }
.stage:last-child .stage__line { display: none; }
@@ -204,7 +207,6 @@ em, .hl {
.stage.is-in .stage__line { transform: scaleY(1); }
.stage.is-in .stage__panel { opacity: 1; transform: none; }
-.stage__label { font-family: var(--font-label); font-size: 11px; letter-spacing: 0.10em; text-transform: uppercase; color: var(--st-deep); margin: 0 0 0.6rem; font-weight: 500; }
.stage__title { font-family: var(--font-display); font-weight: 700; font-size: clamp(1.5rem, 2vw + 0.6rem, 2.1rem); line-height: 1.1; letter-spacing: -0.02em; color: var(--color-ink); margin: 0 0 0.7rem; }
.stage__text { font-size: 0.9875rem; line-height: 1.6; color: var(--color-ink-2); margin: 0 0 1.15rem; max-width: 48ch; }
.stage__text b { font-weight: 600; color: var(--color-ink); }
diff --git a/site/examples/hyperlane/index.html b/site/examples/hyperlane/index.html
index 4097ef4..c2b03b5 100644
--- a/site/examples/hyperlane/index.html
+++ b/site/examples/hyperlane/index.html
@@ -79,10 +79,13 @@
</div>
</section>
+ <!-- The five chapters are a real ordered list: counter() draws the
+ figures, so no ordinal is typed above a heading. -->
+ <ol class="chapters">
+ <li class="chapter">
<!-- ─── format band · spec sheet ────────────────────────── -->
<section class="format" id="format" aria-labelledby="format-h">
<header class="section-head">
- <p class="section-eyebrow"><span class="num tnum">01</span> · Format</p>
<h2 class="section-h" id="format-h">A single night, end to end.</h2>
</header>
@@ -122,11 +125,12 @@
<p class="format__cta-note tnum">— Wave 01 of 3 · 480 cap · public list opens 09 Sep 2026</p>
</div>
</section>
+ </li>
+ <li class="chapter">
<!-- ─── why · pitch ────────────────────────────────────── -->
<section class="why" id="why" aria-labelledby="why-h">
<header class="section-head">
- <p class="section-eyebrow"><span class="num tnum">02</span> · Why</p>
<h2 class="section-h" id="why-h">A room for the people still building things at 2 AM.</h2>
</header>
@@ -143,12 +147,13 @@
<p class="why__signoff">— Brooklyn. October. The list opens in September.</p>
</div>
</section>
+ </li>
+ <li class="chapter">
<!-- ─── programme grid · Wave 01 ───────────────────────── -->
<section class="program" id="program" aria-labelledby="program-h">
<header class="section-head">
- <p class="section-eyebrow"><span class="num tnum">03</span> · Programme · Wave 01</p>
- <h2 class="section-h" id="program-h">Six of twelve slots announced.</h2>
+ <h2 class="section-h" id="program-h">Six of twelve Wave 01 slots announced.</h2>
<p class="section-note">Wave 02 reveals 09 Sep · final programme 30 Sep · launches stay sealed until the night.</p>
</header>
@@ -202,12 +207,13 @@
</li>
</ul>
</section>
+ </li>
+ <li class="chapter">
<!-- ─── rsvp · join the list ───────────────────────────── -->
<section class="rsvp" id="rsvp" aria-labelledby="rsvp-h">
<div class="rsvp__inner">
- <p class="section-eyebrow"><span class="num tnum">04</span> · Tickets</p>
- <h2 class="rsvp__h" id="rsvp-h">Two emails. One night.</h2>
+ <h2 class="rsvp__h" id="rsvp-h">Two emails, one ticket, one night.</h2>
<p class="rsvp__lead">
Join the public list and get early access to Wave 01 tickets when they open on 09 Sep. We send the address two days before doors and a final note 24 hours out — that's it.
</p>
@@ -238,12 +244,13 @@
</form>
</div>
</section>
+ </li>
+ <li class="chapter">
<!-- ─── FAQ · conversational ───────────────────────────── -->
<section class="faq" id="faq" aria-labelledby="faq-h">
<header class="section-head">
- <p class="section-eyebrow"><span class="num tnum">05</span> · Questions</p>
- <h2 class="section-h" id="faq-h">A few honest answers.</h2>
+ <h2 class="section-h" id="faq-h">A few honest answers to the obvious questions.</h2>
</header>
<div class="faq__list">
@@ -318,6 +325,8 @@
</details>
</div>
</section>
+ </li>
+ </ol>
</main>
diff --git a/site/examples/hyperlane/styles.css b/site/examples/hyperlane/styles.css
index 8f484bf..61064b3 100644
--- a/site/examples/hyperlane/styles.css
+++ b/site/examples/hyperlane/styles.css
@@ -419,21 +419,28 @@ a { color: inherit; text-decoration: none; }
gap: var(--space-xs);
}
-.section-eyebrow {
- font-family: var(--font-mono);
- font-size: var(--text-xs);
- letter-spacing: 0.12em;
- text-transform: uppercase;
- color: var(--color-ink-3);
+/* The five chapters are a real ordered list. counter() draws the figure at
+ the top of each heading, so the running number is structure rather than a
+ label typed above the head. */
+.chapters {
+ list-style: none;
margin: 0;
- display: inline-flex;
- align-items: baseline;
- gap: var(--space-xs);
+ padding: 0;
+ counter-reset: chapter;
}
-.section-eyebrow .num {
- color: var(--color-accent);
+.chapter { counter-increment: chapter; }
+
+.section-h::before,
+.rsvp__h::before {
+ content: counter(chapter, decimal-leading-zero);
+ display: block;
+ font-family: var(--font-mono);
+ font-size: var(--text-xs);
font-weight: 500;
+ letter-spacing: 0.12em;
+ color: var(--color-accent);
+ margin-bottom: var(--space-xs);
}
.section-h {
diff --git a/site/examples/ledger-01/index.html b/site/examples/ledger-01/index.html
index 1dbf7d6..c4d05e0 100644
--- a/site/examples/ledger-01/index.html
+++ b/site/examples/ledger-01/index.html
@@ -62,9 +62,13 @@ a { color: inherit; text-decoration: none; }
.wrap { max-width: var(--wrap); margin-inline: auto; padding-inline: clamp(20px, 4vw, 56px); }
.mono { font-family: var(--font-mono); font-variant-numeric: tabular-nums; }
.pos { color: var(--accent); }
-.eyebrow {
- font-family: var(--font-mono); font-size: 0.75rem; letter-spacing: 0.14em;
- text-transform: uppercase; color: var(--muted); line-height: 1.3;
+/* Section mark - a short lit tick that opens every section. The same mark
+ repeats the whole way down, so the reader learns it as punctuation and
+ nothing has to be spelled out above the heading. */
+.section__mark {
+ border: 0; margin: 0 0 var(--space-5);
+ width: 3.5rem; height: 2px; background: var(--accent);
+ box-shadow: 0 0 16px var(--accent-soft);
}
.skip-link {
position: absolute; left: var(--space-3); top: -60px; z-index: 20;
@@ -121,7 +125,7 @@ a { color: inherit; text-decoration: none; }
.hero h1 {
font-family: var(--font-display); font-weight: 600;
font-size: clamp(2.1rem, 4.6vw, 3.15rem); line-height: 1.05; letter-spacing: -0.03em;
- margin-top: var(--space-4); color: var(--ink);
+ margin-top: var(--space-2); color: var(--ink);
overflow-wrap: anywhere; min-width: 0; text-wrap: balance;
}
.hero__lede { margin-top: var(--space-5); max-width: 54ch; color: var(--muted); font-size: 1.0625rem; }
@@ -187,10 +191,15 @@ a { color: inherit; text-decoration: none; }
.section__head p { margin-top: var(--space-4); max-width: 60ch; color: var(--muted); }
/* ---- how it works ---- */
-.beats { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: var(--space-8); margin-top: var(--space-10); }
-.beat { min-width: 0; border-top: 1px solid var(--rule-2); padding-top: var(--space-5); }
-.beat__num { font-family: var(--font-mono); font-size: 0.8125rem; color: var(--muted); letter-spacing: 0.1em; }
-.beat h3 { font-family: var(--font-display); font-weight: 600; font-size: 1.1875rem; letter-spacing: -0.01em; margin-top: var(--space-3); color: var(--ink); overflow-wrap: anywhere; min-width: 0; }
+.beats { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: var(--space-8); margin-top: var(--space-10); list-style: none; counter-reset: beat; }
+.beat { min-width: 0; border-top: 1px solid var(--rule-2); padding-top: var(--space-5); counter-increment: beat; }
+/* the step figure is generated by the list, so no ordinal is typed above the heading */
+.beat h3::before {
+ content: counter(beat, decimal-leading-zero) " / ";
+ font-family: var(--font-mono); font-weight: 500; font-size: 0.8125em;
+ letter-spacing: 0.08em; color: var(--accent);
+}
+.beat h3 { font-family: var(--font-display); font-weight: 600; font-size: 1.1875rem; letter-spacing: -0.01em; margin-top: 0; color: var(--ink); overflow-wrap: anywhere; min-width: 0; }
.beat p { margin-top: var(--space-3); color: var(--muted); font-size: 0.9375rem; max-width: 46ch; }
@media (max-width: 52rem) { .beats { grid-template-columns: minmax(0, 1fr); gap: var(--space-6); } }
@@ -217,6 +226,7 @@ a { color: inherit; text-decoration: none; }
.callout { background: var(--surface); color: var(--ink); border: 1px solid var(--rule); border-radius: var(--radius-lg); padding: clamp(var(--space-8), 6vw, var(--space-12)); text-align: center; overflow: clip; }
.callout h2 { font-family: var(--font-display); font-weight: 600; font-size: clamp(1.8rem, 3.6vw, 2.6rem); line-height: 1.08; letter-spacing: -0.02em; color: var(--ink); overflow-wrap: anywhere; min-width: 0; max-width: 20ch; margin-inline: auto; }
.callout p { margin-top: var(--space-4); color: var(--muted); max-width: 52ch; margin-inline: auto; }
+.callout .section__mark { margin-inline: auto; }
.callout__actions { display: flex; flex-wrap: wrap; justify-content: center; gap: var(--space-4); margin-top: var(--space-8); }
.callout__note { margin-top: var(--space-6); font-family: var(--font-mono); font-size: 0.75rem; color: var(--muted); }
@@ -258,7 +268,6 @@ a { color: inherit; text-decoration: none; }
<section class="hero wrap" aria-labelledby="hero-h">
<div class="hero__grid">
<div class="hero__col">
- <p class="eyebrow">Meridian · Treasury OS</p>
<h1 id="hero-h">Treasury, reconciled while you sleep.</h1>
<p class="hero__lede">Meridian pulls every bank feed, card network, and ledger entry into a single balance that stays reconciled around the clock. You wake up to a closed book, not a queue of exceptions.</p>
<div class="hero__actions">
@@ -320,27 +329,24 @@ a { color: inherit; text-decoration: none; }
<section class="section" id="how" aria-labelledby="how-h">
<div class="wrap">
<div class="section__head">
- <p class="eyebrow">How it works</p>
- <h2 id="how-h">Three steps, run continuously.</h2>
+ <hr class="section__mark" />
+ <h2 id="how-h">Reconciliation runs in three steps, continuously.</h2>
<p>No overnight batch, no month-end scramble. Meridian keeps the loop closed every minute of the day.</p>
</div>
- <div class="beats">
- <article class="beat">
- <p class="beat__num">01 / INGEST</p>
- <h3>Feeds sync every 60 seconds</h3>
+ <ol class="beats">
+ <li class="beat">
+ <h3>Ingest runs every 60 seconds</h3>
<p>Bank connections, card networks, and your general ledger stream in over signed APIs. Nothing is keyed by hand; nothing waits for a nightly file.</p>
- </article>
- <article class="beat">
- <p class="beat__num">02 / MATCH</p>
- <h3>Deterministic rules pair entries</h3>
+ </li>
+ <li class="beat">
+ <h3>Match pairs entries deterministically</h3>
<p>Each transaction is matched to its expected ledger entry by amount, date, and counterparty. Anything ambiguous drops into a review queue instead of a silent guess.</p>
- </article>
- <article class="beat">
- <p class="beat__num">03 / CLOSE</p>
- <h3>Balances lock at 06:00 UTC</h3>
+ </li>
+ <li class="beat">
+ <h3>Close locks balances at 06:00 UTC</h3>
<p>The book closes on schedule with every match carrying an immutable reference. You can audit any figure back to the transaction that moved it.</p>
- </article>
- </div>
+ </li>
+ </ol>
</div>
</section>
@@ -348,8 +354,8 @@ a { color: inherit; text-decoration: none; }
<section class="section" id="pricing" aria-labelledby="spec-h">
<div class="wrap">
<div class="section__head">
- <p class="eyebrow">Capabilities</p>
- <h2 id="spec-h">A datasheet, not a pitch.</h2>
+ <hr class="section__mark" />
+ <h2 id="spec-h">Every capability, as a datasheet rather than a pitch.</h2>
<p>The specification your controller will actually read. Every line is a default you can change, not a feature you have to buy.</p>
</div>
<div class="datasheet">
@@ -375,7 +381,7 @@ a { color: inherit; text-decoration: none; }
<section class="section" aria-labelledby="trust-h">
<div class="wrap">
<div class="section__head">
- <p class="eyebrow">Trust</p>
+ <hr class="section__mark" />
<h2 id="trust-h">Built for the people who sign off.</h2>
<p>Treasury software fails closed. These are the controls that let your auditors, your board, and your bank take Meridian at its word.</p>
</div>
@@ -412,7 +418,7 @@ a { color: inherit; text-decoration: none; }
<section class="section" id="open" aria-labelledby="open-h">
<div class="wrap">
<div class="callout">
- <p class="eyebrow">Get started</p>
+ <hr class="section__mark" />
<h2 id="open-h">Open an account and close tonight.</h2>
<p>Connect your first feed in an afternoon. By the next lock at 06:00 UTC, your balance is reconciled and your close is done.</p>
<div class="callout__actions">
diff --git a/site/examples/lumen-01/index.html b/site/examples/lumen-01/index.html
index 447074b..fe0dbf8 100644
--- a/site/examples/lumen-01/index.html
+++ b/site/examples/lumen-01/index.html
@@ -46,13 +46,12 @@
<div class="hero__inner">
<div class="hero__copy">
- <p class="eyebrow"><span class="ord">00</span><span class="dot-mid">·</span>Inference</p>
<h1 class="hero__title" id="hero-title">
Built to&nbsp;<em>think</em>&nbsp;in real time.
</h1>
<p class="hero__lede">
- Cinder is a serverless runtime for any model that fits on a GPU.
- Deploy with a single primitive. Scale down to zero between requests.
+ <b class="lede-in">Serverless GPU inference.</b> Cinder runs any model that fits
+ on a GPU behind a single primitive. Scale down to zero between requests.
Pay only when the model thinks.
</p>
<div class="hero__cta">
@@ -157,7 +156,7 @@
<!-- ─── Runtime cards — hairline + inner emission ─── -->
<section class="section" id="runtime" aria-labelledby="runtime-title">
<header class="section__head">
- <p class="eyebrow"><span class="ord">01</span><span class="dot-mid">·</span>Runtime</p>
+ <hr class="section__rule" />
<h2 class="section__title" id="runtime-title">
One primitive that scales&nbsp;<em>down</em>&nbsp;to zero.
</h2>
@@ -167,38 +166,34 @@
</p>
</header>
- <div class="cards">
- <article class="card">
- <p class="card__eyebrow">a · snapshot</p>
+ <ol class="cards">
+ <li class="card">
<h3 class="card__title">Snapshot cold starts</h3>
<p class="card__body">
Model weights and Python state restored from a CUDA memory snapshot.
Cold start at four-tenths of a second, regardless of model size up to 70 B.
</p>
- </article>
- <article class="card">
- <p class="card__eyebrow">b · batching</p>
+ </li>
+ <li class="card">
<h3 class="card__title">Continuous batching</h3>
<p class="card__body">
Requests join an in-flight batch on arrival. P50 latency stays flat under load,
then degrades gracefully past the GPU saturation point.
</p>
- </article>
- <article class="card">
- <p class="card__eyebrow">c · billing</p>
+ </li>
+ <li class="card">
<h3 class="card__title">Bin-packed billing</h3>
<p class="card__body">
You pay for the milliseconds a GPU is reserved for your function.
Idle replicas are reclaimed inside three seconds. No minimum spend.
</p>
- </article>
- </div>
+ </li>
+ </ol>
</section>
<!-- ─── Code — Workbench-style block ─── -->
<section class="section section--code" id="code" aria-labelledby="code-title">
<header class="section__head">
- <p class="eyebrow"><span class="ord">02</span><span class="dot-mid">·</span>Code</p>
<h2 class="section__title" id="code-title">
Three files. <em>One</em> deploy.
</h2>
@@ -242,7 +237,7 @@
<!-- ─── Pricing — three serif-numeral tiers ─── -->
<section class="section" id="pricing" aria-labelledby="pricing-title">
<header class="section__head">
- <p class="eyebrow"><span class="ord">03</span><span class="dot-mid">·</span>Pricing</p>
+ <hr class="section__rule" />
<h2 class="section__title" id="pricing-title">
Per-second, per-GPU. <em>Stop</em> at any time.
</h2>
@@ -254,7 +249,7 @@
<div class="tiers">
<article class="tier">
- <p class="tier__eyebrow">Free</p>
+ <h3 class="tier__name">Free</h3>
<p class="tier__price"><span class="tier__num">$0</span><span class="tier__unit">/mo</span></p>
<p class="tier__note">$0.00012 / sec on shared A10G after 30 GPU-hours.</p>
<ul class="tier__list">
@@ -265,7 +260,7 @@
<a class="btn btn--ghost btn--block" href="#">Start free</a>
</article>
<article class="tier tier--feature">
- <p class="tier__eyebrow">Reactor</p>
+ <h3 class="tier__name">Reactor</h3>
<p class="tier__price"><span class="tier__num">$0.0004</span><span class="tier__unit">/sec</span></p>
<p class="tier__note">Dedicated H100. Bin-packed across your fleet.</p>
<ul class="tier__list">
@@ -277,7 +272,7 @@
<a class="btn btn--accent btn--block" href="#">Start a project</a>
</article>
<article class="tier">
- <p class="tier__eyebrow">Enterprise</p>
+ <h3 class="tier__name">Enterprise</h3>
<p class="tier__price"><span class="tier__num">Talk</span><span class="tier__unit"> · custom</span></p>
<p class="tier__note">Reserved capacity, BYO VPC, SLA on P99 latency.</p>
<ul class="tier__list">
@@ -294,7 +289,7 @@
<!-- ─── Changelog ─── -->
<section class="section section--changelog" id="changelog" aria-labelledby="changelog-title">
<header class="section__head">
- <p class="eyebrow"><span class="ord">04</span><span class="dot-mid">·</span>Changelog</p>
+ <hr class="section__rule" />
<h2 class="section__title" id="changelog-title">
Shipped this <em>quarter</em>.
</h2>
diff --git a/site/examples/lumen-01/styles.css b/site/examples/lumen-01/styles.css
index 13763e4..26d49d3 100644
--- a/site/examples/lumen-01/styles.css
+++ b/site/examples/lumen-01/styles.css
@@ -40,20 +40,39 @@ button:focus-visible { outline: 1.5px solid var(--color-focus); outline-offset:
Shared atoms
────────────────────────────────────────────────────────────── */
-.eyebrow {
+/* Section entry: an electrode tick on a hairline, the same 32px accent stub the
+ cards carry. Divider language does the announcing, so no words are spent. */
+.section__rule {
+ border: 0;
+ margin: 0 0 var(--space-lg);
+ display: flex;
+ align-items: center;
+ gap: 0.75rem;
+}
+.section__rule::before {
+ content: "";
+ width: 32px;
+ height: 2px;
+ background: var(--color-accent);
+ box-shadow: 0 0 10px var(--color-glow);
+}
+.section__rule::after {
+ content: "";
+ flex: 1;
+ height: 1px;
+ background: linear-gradient(90deg, var(--color-rule-2), transparent);
+}
+
+/* Lead-in: the orienting fact opens the prose and never leaves it. */
+.lede-in {
font-family: var(--font-label);
- font-size: 11px;
+ font-weight: 500;
+ font-size: 0.82em;
letter-spacing: var(--tracking-label);
text-transform: uppercase;
- color: var(--color-ink);
- opacity: 0.55;
- margin: 0 0 var(--space-md);
- display: inline-flex;
- align-items: baseline;
- gap: 0.4em;
+ color: var(--color-accent);
+ margin-inline-end: 0.35em;
}
-.eyebrow .ord { color: var(--color-accent); opacity: 1; }
-.eyebrow .dot-mid { color: var(--color-rule-2); opacity: 1; }
/* Verb landmark: permanent accent-2 colour + underline draws in once. No italics. */
em {
@@ -627,7 +646,7 @@ em::after {
Cards — hairline + inner emission
────────────────────────────────────────────────────────────── */
-.cards { display: grid; grid-template-columns: 1fr; gap: 1rem; }
+.cards { display: grid; grid-template-columns: 1fr; gap: 1rem; list-style: none; counter-reset: card; padding: 0; margin: 0; }
@media (min-width: 720px) { .cards { grid-template-columns: repeat(3, minmax(0, 1fr)); } }
.card {
position: relative;
@@ -657,7 +676,18 @@ em::after {
radial-gradient(120% 80% at 0% 0%, oklch(76% 0.17 50 / 0.10) 0%, transparent 55%),
var(--color-paper-2);
}
-.card__eyebrow { font-family: var(--font-label); font-size: 11px; letter-spacing: var(--tracking-label); text-transform: lowercase; color: var(--color-accent); margin: 0; }
+/* The sequence is real, so the list element says so and counter() draws the
+ figure. Nothing is typed above the heading. */
+.card { counter-increment: card; }
+.card__title::before {
+ content: counter(card, lower-alpha);
+ display: block;
+ font-family: var(--font-label);
+ font-size: 11px;
+ letter-spacing: var(--tracking-label);
+ color: var(--color-accent);
+ margin-block-end: var(--space-2xs);
+}
.card__title { font-family: var(--font-body); font-weight: 500; font-size: 1.125rem; line-height: 1.3; color: var(--color-ink); margin: 0; }
.card__body { font-size: 0.9375rem; line-height: 1.6; color: var(--color-ink-2); margin: 0; }
@@ -665,13 +695,30 @@ em::after {
Code block — no fake browser chrome
────────────────────────────────────────────────────────────── */
+/* Section entry, second move: a change of paper. The quickstart sits on its own
+ sheet, ruled top and bottom, and that edge is the break. The code block's own
+ head already carries the real filename, so nothing announces the section. */
+.section--code {
+ max-width: none;
+ padding-block: var(--space-3xl);
+ margin-block-end: var(--section-gap);
+ border-block: 1px solid var(--color-rule);
+ background:
+ linear-gradient(var(--rule-blueprint) 1px, transparent 1px) 0 0 / 48px 48px,
+ var(--color-paper-2);
+}
+.section--code > * {
+ max-width: calc(var(--page-max) - 2 * var(--page-gutter));
+ margin-inline: auto;
+}
+
.section--code .code {
border: 1px solid var(--color-rule);
border-radius: var(--radius-card);
overflow: hidden;
background:
radial-gradient(80% 80% at 100% 0%, oklch(76% 0.17 50 / 0.04) 0%, transparent 60%),
- var(--color-paper-2);
+ var(--color-paper);
}
.code__head {
display: flex; justify-content: space-between; align-items: center;
@@ -772,15 +819,17 @@ em::after {
color: var(--color-accent-ink);
border-radius: 2px;
}
-.tier__eyebrow {
+/* The plan name is the heading of its card, not a label sitting above one. */
+.tier__name {
font-family: var(--font-label);
+ font-weight: 400;
font-size: 11px;
letter-spacing: var(--tracking-label);
text-transform: uppercase;
color: var(--color-muted);
margin: 0;
}
-.tier--feature .tier__eyebrow { color: var(--color-accent); }
+.tier--feature .tier__name { color: var(--color-accent); }
.tier__price {
font-family: var(--font-display);
diff --git a/site/examples/najm/index.html b/site/examples/najm/index.html
index ff2ff71..c4f6306 100644
--- a/site/examples/najm/index.html
+++ b/site/examples/najm/index.html
@@ -115,8 +115,7 @@
<section class="section shell">
<div class="section__head">
<div>
- <p class="eyebrow">The W&rsquo;25 Collection</p>
- <h2 class="section__title">Twenty-three pieces. <em>Made to be worn out.</em></h2>
+ <h2 class="section__title">The W&rsquo;25 collection: twenty-three pieces, <em>made to be worn out.</em></h2>
</div>
<div>
<p class="section__lede">Pre-order opens Friday 06.05 at 18h00 (Casablanca). First 200 orders ship same-week.</p>
@@ -218,11 +217,11 @@
<div class="editorial__bg" aria-hidden="true"></div>
<div>
- <p class="editorial__eyebrow">Lookbook · W&rsquo;25 / 02</p>
<p class="editorial__quote">
A coat that should outlast its country of origin.
</p>
<p class="editorial__byline">— Karim Bennani · founder, NAJM</p>
+ <p class="editorial__plate">Lookbook · W&rsquo;25 / 02</p>
</div>
<div>
diff --git a/site/examples/najm/styles.css b/site/examples/najm/styles.css
index 2c111d2..28aebef 100644
--- a/site/examples/najm/styles.css
+++ b/site/examples/najm/styles.css
@@ -49,14 +49,6 @@ input, select { font: inherit; color: inherit; }
padding-inline: var(--gutter);
}
-.eyebrow {
- font-family: var(--font-body);
- font-size: var(--text-xs);
- font-weight: 500;
- letter-spacing: var(--track-wide);
- text-transform: uppercase;
- color: var(--color-ink-soft);
-}
/* ── Announcement bar ─────────────────────────────── */
.announce {
@@ -670,7 +662,7 @@ input, select { font: inherit; color: inherit; }
background-size: 64px 64px;
opacity: 0.06;
}
-.editorial__eyebrow {
+.editorial__plate {
font-family: var(--font-mono);
font-size: var(--text-xs);
letter-spacing: 0.18em;
diff --git a/site/examples/press-01/index.html b/site/examples/press-01/index.html
index 0e7b5d4..8485d14 100644
--- a/site/examples/press-01/index.html
+++ b/site/examples/press-01/index.html
@@ -194,7 +194,7 @@
<figure class="poster" aria-labelledby="poster-cap">
<div class="poster__plate">
<span class="poster__baseline" aria-hidden="true"></span>
- <span class="poster__kicker">Lent Series · Triskel</span>
+ <span class="poster__series">Lent Series · Triskel</span>
<h3 class="poster__title" aria-hidden="true">
<span class="poster__word poster__word--a">OFF</span>
<span class="poster__word poster__word--b">THE</span>
diff --git a/site/examples/press-01/styles.css b/site/examples/press-01/styles.css
index 6aed4c6..51d23ed 100644
--- a/site/examples/press-01/styles.css
+++ b/site/examples/press-01/styles.css
@@ -389,7 +389,7 @@ img, svg { display: block; max-width: 100%; }
color: var(--proof-ink);
}
-/* plate heads — eyebrow stacked ABOVE heading, single column (gate 54) */
+/* plate heads - single column, heading alone (gate 54) */
.plate-head {
display: flex;
flex-direction: column;
@@ -610,7 +610,7 @@ img, svg { display: block; max-width: 100%; }
margin-block-end: -0.2em;
z-index: var(--z-base);
}
-.poster__kicker {
+.poster__series {
grid-column: 1 / 7;
grid-row: 1;
font-family: var(--font-mono);
diff --git a/site/examples/riso-01/index.html b/site/examples/riso-01/index.html
index 47f4d15..3e56170 100644
--- a/site/examples/riso-01/index.html
+++ b/site/examples/riso-01/index.html
@@ -38,7 +38,7 @@
<!-- ░░ HERO · Catalogue inventory header + Tier-A CSS riso mark ░░ -->
<section class="hero" aria-labelledby="hero-title">
<div class="hero__copy">
- <p class="kicker">A risograph print fair · Two days · One drum at a time</p>
+ <p class="hero__meta">A risograph print fair · Two days · One drum at a time</p>
<h1 id="hero-title" class="hero__title">
<span class="riso-mis" data-text="Thirty-four">Thirty-four</span>
studios. Eight presses. Soy&nbsp;ink everywhere.
@@ -95,9 +95,9 @@
<span class="print print--1" aria-hidden="true"></span>
</a>
<div class="card__meta">
- <p class="card__tag">Working press · Stand A1</p>
<h3 class="card__name">Brae &amp; Drum</h3>
<p class="card__line">A live two-colour MZ. Pull a print, keep it wet.</p>
+ <p class="card__cap">Working press · Stand A1</p>
</div>
</li>
@@ -106,9 +106,9 @@
<span class="print print--2" aria-hidden="true"></span>
</a>
<div class="card__meta">
- <p class="card__tag">Zines · Stand A4</p>
<h3 class="card__name">Saltmarket Editions</h3>
<p class="card__line">Perfect-bound photo zines, two spot colours, no black.</p>
+ <p class="card__cap">Zines · Stand A4</p>
</div>
</li>
@@ -117,9 +117,9 @@
<span class="print print--3" aria-hidden="true"></span>
</a>
<div class="card__meta">
- <p class="card__tag">Posters · Stand A6</p>
<h3 class="card__name">Mono No Aware Press</h3>
<p class="card__line">A2 gig posters. Fluoro pink that glows under the strip lights.</p>
+ <p class="card__cap">Posters · Stand A6</p>
</div>
</li>
@@ -128,9 +128,9 @@
<span class="print print--4" aria-hidden="true"></span>
</a>
<div class="card__meta">
- <p class="card__tag">Comics · Stand A9</p>
<h3 class="card__name">Tenement Comics</h3>
<p class="card__line">Riso-printed shorts about the close, the bin store, the No.&nbsp;6 bus.</p>
+ <p class="card__cap">Comics · Stand A9</p>
</div>
</li>
@@ -139,9 +139,9 @@
<span class="print print--5" aria-hidden="true"></span>
</a>
<div class="card__meta">
- <p class="card__tag">Zines · Stand A11</p>
<h3 class="card__name">Verdigris &amp; Co</h3>
<p class="card__line">Botanical risographs on grey speckle stock. Teal on teal.</p>
+ <p class="card__cap">Zines · Stand A11</p>
</div>
</li>
@@ -150,9 +150,9 @@
<span class="print print--6" aria-hidden="true"></span>
</a>
<div class="card__meta">
- <p class="card__tag">Posters · Stand A13</p>
<h3 class="card__name">Halftone Social Club</h3>
<p class="card__line">Big dot screens, on purpose. Bring a loupe.</p>
+ <p class="card__cap">Posters · Stand A13</p>
</div>
</li>
@@ -161,9 +161,9 @@
<span class="print print--7" aria-hidden="true"></span>
</a>
<div class="card__meta">
- <p class="card__tag">Comics · Mezzanine M2</p>
<h3 class="card__name">Closemouth Press</h3>
<p class="card__line">A risograph graphic novel, four years in, finally bound.</p>
+ <p class="card__cap">Comics · Mezzanine M2</p>
</div>
</li>
@@ -172,9 +172,9 @@
<span class="print print--8" aria-hidden="true"></span>
</a>
<div class="card__meta">
- <p class="card__tag">Working press · Mezzanine M5</p>
<h3 class="card__name">The Spirit Master</h3>
<p class="card__line">We cut a master from your drawing while you wait. Bring a felt&nbsp;tip.</p>
+ <p class="card__cap">Working press · Mezzanine M5</p>
</div>
</li>
@@ -183,9 +183,9 @@
<span class="print print--9" aria-hidden="true"></span>
</a>
<div class="card__meta">
- <p class="card__tag">Zines · Mezzanine M7</p>
<h3 class="card__name">Riso Riot</h3>
<p class="card__line">A queer riso anthology, eighty pages, sold by donation.</p>
+ <p class="card__cap">Zines · Mezzanine M7</p>
</div>
</li>
</ul>
diff --git a/site/examples/riso-01/styles.css b/site/examples/riso-01/styles.css
index 7adbda7..ae97f2f 100644
--- a/site/examples/riso-01/styles.css
+++ b/site/examples/riso-01/styles.css
@@ -76,8 +76,8 @@ a { color: inherit; }
.skip-link:focus { transform: translateY(0); }
/* ── Shared shells ──────────────────────────────────────────── */
-.kicker,
-.card__tag,
+.hero__meta,
+.card__cap,
.band__count,
.slot__where,
.work__when,
@@ -175,7 +175,7 @@ a { color: inherit; }
min-height: clamp(58vh, 74dvh, 86dvh);
}
.hero__copy { max-width: 40rem; }
-.kicker { margin-bottom: var(--space-md); }
+.hero__meta { margin-bottom: var(--space-md); }
.hero__title {
font-family: var(--font-display);
font-weight: var(--display-weight);
@@ -315,7 +315,7 @@ a { color: inherit; }
.riso-plate__cap { align-self: end; }
/* ════════════════════════════════════════════════════════════
- BANDS (section heads — stacked single column, no eyebrow tags)
+ BANDS (section heads: stacked single column, heading only)
════════════════════════════════════════════════════════════ */
.band {
max-width: var(--page-max);
@@ -437,6 +437,13 @@ a { color: inherit; }
color: var(--color-ink-2);
margin: 0;
}
+/* Medium and stand number read as a plate caption under the entry, the way a
+ catalogue sets them. Above the name they were only announcing it. */
+.card__cap {
+ margin-top: var(--space-2xs);
+ padding-top: var(--space-2xs);
+ border-top: var(--rule-hair) solid var(--color-rule-2);
+}
/* ── Per-card CSS "prints" — every card is a different riso composition.
Each .print stacks 2–3 multiply-blended ink layers via background +
diff --git a/site/examples/tally/index.html b/site/examples/tally/index.html
index 8297fa8..25c3f3e 100644
--- a/site/examples/tally/index.html
+++ b/site/examples/tally/index.html
@@ -125,7 +125,7 @@
<div class="container">
<div class="section-head">
<div>
- <span class="eyebrow">◇ workbench</span>
+ <hr class="section-mark" />
<h2 class="section-head__title">A pricing console that <em>knows</em> your model.</h2>
</div>
<p class="section-head__desc">
@@ -217,7 +217,7 @@
<div class="container">
<div class="section-head">
<div>
- <span class="eyebrow">◇ proof</span>
+ <hr class="section-mark" />
<h2 class="section-head__title">Numbers that <em>don't</em> need a footnote.</h2>
</div>
<p class="section-head__desc">
@@ -251,7 +251,6 @@
<div class="container">
<div class="section-head">
<div>
- <span class="eyebrow">◇ how it works</span>
<h2 class="section-head__title">Meter, price, invoice — <em>then</em> sleep.</h2>
</div>
<p class="section-head__desc">
@@ -260,8 +259,8 @@
</p>
</div>
- <div class="features__grid">
- <article class="feature" data-tilt>
+ <ol class="features__grid">
+ <li class="feature" data-tilt>
<div class="feature__art art-meter" aria-hidden="true"></div>
<h3 class="feature__title">Meter anything in one line</h3>
<p class="feature__desc">
@@ -269,9 +268,9 @@
dedup, ordering, and replay so your meters never lie.
</p>
<a class="feature__link" href="#">Read the SDK docs</a>
- </article>
+ </li>
- <article class="feature" data-tilt>
+ <li class="feature" data-tilt>
<div class="feature__art art-tiers" aria-hidden="true">
<i></i><i></i><i></i><i></i><i></i>
</div>
@@ -281,9 +280,9 @@
and Tally retro-prices the meter. No deploy required.
</p>
<a class="feature__link" href="#">See price models</a>
- </article>
+ </li>
- <article class="feature" data-tilt>
+ <li class="feature" data-tilt>
<div class="feature__art art-invoice" aria-hidden="true">
<div class="sheet"><b>INV-04210</b>Bramble · Apr<br/><em>$3,118.40</em></div>
<div class="sheet"><b>INV-04211</b>Forge · Apr<br/><em>$8,940.20</em></div>
@@ -295,8 +294,8 @@
"what's this?", you point at a clickable trail.
</p>
<a class="feature__link" href="#">Browse invoice templates</a>
- </article>
- </div>
+ </li>
+ </ol>
</div>
</section>
@@ -304,8 +303,7 @@
<section class="pricing" id="pricing">
<div class="container">
<div class="pricing__head">
- <span class="eyebrow">◇ pricing</span>
- <h2 class="section-head__title" style="text-align:center; margin-inline:auto;">Plans that scale with you, <em>not</em> against you.</h2>
+ <h2 class="section-head__title" style="text-align:center; margin-inline:auto;">Pricing that scales with you, <em>not</em> against you.</h2>
<div class="pricing__toggle" role="group" aria-label="Billing period">
<button type="button" data-period="monthly" aria-pressed="true">Monthly</button>
<button type="button" data-period="annual" aria-pressed="false">Annual <span class="save">save 20%</span></button>
diff --git a/site/examples/tally/styles.css b/site/examples/tally/styles.css
index daf63ca..7ce474e 100644
--- a/site/examples/tally/styles.css
+++ b/site/examples/tally/styles.css
@@ -41,15 +41,29 @@ button, input, select { font: inherit; color: inherit; }
padding-inline: var(--space-xl);
}
-.eyebrow {
- font-family: var(--font-mono);
- font-size: var(--text-xs);
- letter-spacing: 0.08em;
- text-transform: uppercase;
- color: var(--color-ink-2);
- display: inline-flex;
+/* Section mark: the house diamond sitting on a hairline. It opens a section
+ the way a fleuron opens a chapter - the reader learns the shape, and no
+ words are spent naming what the heading is about to say. */
+.section-mark {
+ border: 0;
+ margin: 0 0 var(--space-sm);
+ display: flex;
align-items: center;
gap: var(--space-xs);
+ color: var(--color-accent);
+}
+.section-mark::before {
+ content: "\25C7";
+ font-size: var(--text-xs);
+ line-height: 1;
+}
+.section-mark::after {
+ content: "";
+ flex: 1;
+ max-width: 4.5rem;
+ height: 1px;
+ background: currentColor;
+ opacity: 0.4;
}
.italic-accent {
@@ -683,11 +697,15 @@ button, input, select { font: inherit; color: inherit; }
grid-template-columns: repeat(3, 1fr);
gap: var(--space-md);
margin-top: var(--space-xl);
+ list-style: none;
+ padding: 0;
+ counter-reset: feature;
}
@media (max-width: 880px) { .features__grid { grid-template-columns: 1fr; } }
.feature {
+ counter-increment: feature;
background: var(--color-paper-0);
border: var(--rule-soft);
border-radius: var(--radius-lg);
@@ -778,6 +796,19 @@ button, input, select { font: inherit; color: inherit; }
.art-invoice .sheet b { display: block; color: var(--color-ink-0); font-size: 12px; margin-bottom: 6px; font-family: var(--font-display); font-weight: 600; }
.art-invoice .sheet em { font-style: normal; color: var(--color-accent); font-weight: 600; font-size: 14px; }
+/* The list draws its own figures, so the order reads as an order and no
+ step number is typed above a heading. */
+.feature__title::before {
+ content: counter(feature, decimal-leading-zero);
+ display: block;
+ font-family: var(--font-mono);
+ font-size: var(--text-xs);
+ font-weight: 400;
+ letter-spacing: 0.08em;
+ color: var(--color-accent);
+ margin-bottom: var(--space-2xs);
+}
+
.feature__title {
font-family: var(--font-display);
font-size: var(--text-lg);
diff --git a/site/examples/wayfare/index.html b/site/examples/wayfare/index.html
index d8bbfc2..2bc8421 100644
--- a/site/examples/wayfare/index.html
+++ b/site/examples/wayfare/index.html
@@ -181,7 +181,7 @@
<!-- ───── Pitch ───── -->
<section class="shell pitch" aria-labelledby="pitch-label">
<div class="pitch-grid">
- <p id="pitch-label" class="pitch-label">01 &mdash; What this is</p>
+ <h2 id="pitch-label" class="part-head">A board of six goes up every Tuesday.</h2>
<div class="pitch-body">
<p>
Most travel sites ask you what you want and then sell you what they have. We do the opposite.
@@ -266,7 +266,7 @@
<!-- ───── How it works ───── -->
<section class="process" id="process" aria-labelledby="process-head">
<div class="process-shell">
- <p id="process-head" class="process-head">02 &mdash; How it works</p>
+ <h2 id="process-head" class="part-head process-head">From the board to the boarding pass, in three steps.</h2>
<div class="process-grid">
<div class="stage">
@@ -290,7 +290,7 @@
<!-- ───── A note ───── -->
<section class="shell note" id="note" aria-labelledby="note-label">
- <p id="note-label" class="note-label">03 &mdash; A note</p>
+ <h2 id="note-label" class="part-head">Why we stopped filtering.</h2>
<p class="note-body">
We started this because we were tired of <em>filtering</em> our way to a holiday.
A good trip is closer to a good record &mdash; someone has to choose the order of the songs.
diff --git a/site/examples/wayfare/style.css b/site/examples/wayfare/style.css
index daf589a..ef18c77 100644
--- a/site/examples/wayfare/style.css
+++ b/site/examples/wayfare/style.css
@@ -608,6 +608,11 @@ button { font: inherit; color: inherit; background: none; border: 0; cursor: poi
/* ───────── Pitch ───────── */
+/* The three prose parts are counted in document order, so the § figures
+ stay right if a part is added, moved, or dropped. */
+main { counter-reset: part; }
+.pitch, .process, .note { counter-increment: part; }
+
.pitch {
padding-block: var(--space-3xl);
border-top: var(--rule-hair);
@@ -620,17 +625,31 @@ button { font: inherit; color: inherit; background: none; border: 0; cursor: poi
align-items: start;
}
-.pitch-label {
+/* Part heading. Each of the three prose sections gets a real <h2>, hung in
+ the outer column, with its part number drawn by a counter rather than
+ typed above it. The section mark keeps the house voice; the label is gone. */
+.part-head {
+ font-family: var(--font-display);
+ font-size: var(--text-2xl);
+ font-weight: 700;
+ line-height: 1.05;
+ letter-spacing: -0.03em;
+ color: var(--color-ink);
+ max-width: 18ch;
+ text-wrap: balance;
+ overflow-wrap: anywhere;
+ min-width: 0;
+}
+
+.part-head::before {
+ content: "\A7\00A0" counter(part, decimal-leading-zero);
+ display: block;
font-family: var(--font-mono);
font-size: var(--text-xs);
- text-transform: uppercase;
+ font-weight: 400;
letter-spacing: 0.18em;
- color: var(--color-ink-mute);
-}
-
-.pitch-label::before {
- content: "§ ";
color: var(--color-accent);
+ margin-bottom: var(--space-sm);
}
.pitch-body {
@@ -826,17 +845,8 @@ button { font: inherit; color: inherit; background: none; border: 0; cursor: poi
}
.process-head {
- font-family: var(--font-mono);
- font-size: var(--text-xs);
- letter-spacing: 0.18em;
- text-transform: uppercase;
- color: var(--color-ink-mute);
margin-bottom: var(--space-2xl);
-}
-
-.process-head::before {
- content: "§ ";
- color: var(--color-accent);
+ max-width: 22ch;
}
.process-grid {
@@ -905,19 +915,6 @@ button { font: inherit; color: inherit; background: none; border: 0; cursor: poi
gap: var(--space-2xl);
}
-.note-label {
- font-family: var(--font-mono);
- font-size: var(--text-xs);
- letter-spacing: 0.18em;
- text-transform: uppercase;
- color: var(--color-ink-mute);
-}
-
-.note-label::before {
- content: "§ ";
- color: var(--color-accent);
-}
-
.note-body {
font-family: var(--font-italic);
font-style: italic;
diff --git a/site/index.html b/site/index.html
index cd629ae..a3bc656 100644
--- a/site/index.html
+++ b/site/index.html
@@ -57,10 +57,10 @@
href="https://fonts.googleapis.com/css2?family=Albert+Sans:wght@400;500;600;700;800&family=Anton&family=Fraunces:ital,opsz,wght@0,9..144,300;0,9..144,400;0,9..144,500;0,9..144,600;0,9..144,900;1,9..144,400;1,9..144,500&family=Geist:wght@400;500;600;700&family=Geist+Mono:wght@400;500&family=Hanken+Grotesk:wght@400;500;600;700&family=Inter:wght@400;500;600;700&family=Inter+Tight:ital,wght@0,500;0,600;0,700;0,800;1,500;1,600;1,700&family=Newsreader:ital,opsz,wght@0,6..72,400;0,6..72,500;1,6..72,400;1,6..72,500&family=Playfair+Display:ital,wght@1,400;1,500;1,600&family=Public+Sans:wght@400;500;600;700&family=Young+Serif&family=Space+Grotesk:wght@400;500;600;700&family=Archivo:wght@400;500;600;700;800;900&family=Source+Serif+4:opsz,[email protected],400;8..60,600;8..60,700&family=IBM+Plex+Mono:wght@400;500;600&family=Silkscreen:wght@400;700&family=JetBrains+Mono:wght@400;500;600&family=Sora:wght@400;600;700&display=swap" />
<link rel="stylesheet" href="https://api.fontshare.com/v2/css?f[]=general-sans@500,600,700&f[]=sentient@400,500&display=swap" />
- <link rel="stylesheet" href="css/tokens.css?v=24" />
- <link rel="stylesheet" href="css/base.css?v=24" />
- <link rel="stylesheet" href="css/components.css?v=24" />
- <link rel="stylesheet" href="css/sections.css?v=24" />
+ <link rel="stylesheet" href="css/tokens.css?v=25" />
+ <link rel="stylesheet" href="css/base.css?v=25" />
+ <link rel="stylesheet" href="css/components.css?v=25" />
+ <link rel="stylesheet" href="css/sections.css?v=25" />
<script>
// Load theme before paint to avoid flash. Order: ?theme= → localStorage → default.
@@ -226,9 +226,6 @@
<!-- 02 · EXAMPLES — full-bleed rail, the centerpiece -->
<section class="section section--bleed reveal" style="--i:1" id="examples" aria-labelledby="s2">
<header class="section__head">
- <p class="section-label">
- <span class="num">02</span><span class="divider">⁄</span><span>Examples</span>
- </p>
<h2 class="section__title" id="s2">
Worked examples.
</h2>
@@ -240,7 +237,7 @@
<a class="ex-card" style="--scroll-dur:3.3s" role="listitem" href="examples/hum-07/" target="_blank" rel="noopener" aria-label="Open the Bubble example, a guided sourdough app, Hum, in a new tab">
<div class="ex-card__thumb" aria-hidden="true">
- <img src="_tests/_thumbs/hum-07.jpg?v=24" alt="" loading="lazy" width="1600" height="1000" />
+ <img src="_tests/_thumbs/hum-07.jpg?v=25" alt="" loading="lazy" width="1600" height="1000" />
</div>
<p class="ex-card__prompt"><span class="ex-card__prompt-mark">$</span> /hallmark build a guided sourdough app, Hum</p>
</a>
@@ -250,91 +247,91 @@
once rendered, swap the <img> for <video data-hover-play src="..." poster="...">. -->
<a class="ex-card" style="--scroll-dur:4s" role="listitem" href="examples/custom-04/" target="_blank" rel="noopener" aria-label="Open the Mend Assembly example, a repair-café manifesto poster, custom, in a new tab">
<div class="ex-card__thumb" aria-hidden="true">
- <img src="_tests/_thumbs/custom-04.jpg?v=24" alt="" loading="lazy" width="1600" height="1000" />
+ <img src="_tests/_thumbs/custom-04.jpg?v=25" alt="" loading="lazy" width="1600" height="1000" />
</div>
<p class="ex-card__prompt"><span class="ex-card__prompt-mark">$</span> /hallmark build a repair-café manifesto poster, custom</p>
</a>
<a class="ex-card" style="--scroll-dur:3.6s" role="listitem" href="examples/garden-01/" target="_blank" rel="noopener" aria-label="Open the Hollowback Apiary example, a small-batch honey farm, Garden, in a new tab">
<div class="ex-card__thumb" aria-hidden="true">
- <img src="_tests/_thumbs/garden-01.jpg?v=24" alt="" loading="lazy" width="1600" height="1000" />
+ <img src="_tests/_thumbs/garden-01.jpg?v=25" alt="" loading="lazy" width="1600" height="1000" />
</div>
<p class="ex-card__prompt"><span class="ex-card__prompt-mark">$</span> /hallmark build a landing page for a small-batch honey farm</p>
</a>
<a class="ex-card" style="--scroll-dur:4.6s" role="listitem" href="examples/riso-01/" target="_blank" rel="noopener" aria-label="Open the Off-Register example, an indie risograph print fair, Riso, in a new tab">
<div class="ex-card__thumb" aria-hidden="true">
- <img src="_tests/_thumbs/riso-01.jpg?v=24" alt="" loading="lazy" width="1600" height="1000" />
+ <img src="_tests/_thumbs/riso-01.jpg?v=25" alt="" loading="lazy" width="1600" height="1000" />
</div>
<p class="ex-card__prompt"><span class="ex-card__prompt-mark">$</span> /hallmark build a page for an indie risograph print fair</p>
</a>
<a class="ex-card" style="--scroll-dur:4.7s" role="listitem" href="examples/press-01/" target="_blank" rel="noopener" aria-label="Open the Press Quaternary example, an experimental type studio, in a new tab">
<div class="ex-card__thumb" aria-hidden="true">
- <img src="_tests/_thumbs/press-01.jpg?v=24" alt="" loading="lazy" width="1600" height="1000" />
+ <img src="_tests/_thumbs/press-01.jpg?v=25" alt="" loading="lazy" width="1600" height="1000" />
</div>
<p class="ex-card__prompt"><span class="ex-card__prompt-mark">$</span> /hallmark build a portfolio for an experimental typographer</p>
</a>
<a class="ex-card" style="--scroll-dur:3.6s" role="listitem" href="examples/tally/" target="_blank" rel="noopener" aria-label="Open the Tally example, a SaaS product page, modern-minimal, in a new tab">
<div class="ex-card__thumb" aria-hidden="true">
- <img src="_tests/_thumbs/tally.jpg?v=24" alt="" loading="lazy" width="1600" height="1000" />
+ <img src="_tests/_thumbs/tally.jpg?v=25" alt="" loading="lazy" width="1600" height="1000" />
</div>
<p class="ex-card__prompt"><span class="ex-card__prompt-mark">$</span> /hallmark build a SaaS product page, modern-minimal</p>
</a>
<a class="ex-card" style="--scroll-dur:3s" role="listitem" href="examples/wayfare/" target="_blank" rel="noopener" aria-label="Open the Wayfare example, a travel booking site, atmospheric, in a new tab">
<div class="ex-card__thumb" aria-hidden="true">
- <img src="_tests/_thumbs/wayfare.jpg?v=24" alt="" loading="lazy" width="1600" height="1000" />
+ <img src="_tests/_thumbs/wayfare.jpg?v=25" alt="" loading="lazy" width="1600" height="1000" />
</div>
<p class="ex-card__prompt"><span class="ex-card__prompt-mark">$</span> /hallmark build a travel booking site, atmospheric</p>
</a>
<a class="ex-card" style="--scroll-dur:3.2s" role="listitem" href="examples/bananastudio/" target="_blank" rel="noopener" aria-label="Open the BananaStudio example, a creative studio with playful motion, in a new tab">
<div class="ex-card__thumb" aria-hidden="true">
- <img src="_tests/_thumbs/bananastudio.jpg?v=24" alt="" loading="lazy" width="1600" height="1000" />
+ <img src="_tests/_thumbs/bananastudio.jpg?v=25" alt="" loading="lazy" width="1600" height="1000" />
</div>
<p class="ex-card__prompt"><span class="ex-card__prompt-mark">$</span> /hallmark build a creative studio with playful motion</p>
</a>
<a class="ex-card" style="--scroll-dur:1.8s" role="listitem" href="_tests/06-anya-portfolio/" target="_blank" rel="noopener" aria-label="Open the Anya Reis example, a software architect personal site, in a new tab">
<div class="ex-card__thumb" aria-hidden="true">
- <img src="_tests/_thumbs/anya.jpg?v=24" alt="" loading="lazy" width="1600" height="1000" />
+ <img src="_tests/_thumbs/anya.jpg?v=25" alt="" loading="lazy" width="1600" height="1000" />
</div>
<p class="ex-card__prompt"><span class="ex-card__prompt-mark">$</span> /hallmark build a software architect personal site</p>
</a>
<a class="ex-card" style="--scroll-dur:2s" role="listitem" href="examples/najm/" target="_blank" rel="noopener" aria-label="Open the NAJM example, a Moroccan fashion brand landing page, in a new tab">
<div class="ex-card__thumb" aria-hidden="true">
- <img src="_tests/_thumbs/najm.jpg?v=24" alt="" loading="lazy" width="1600" height="1000" />
+ <img src="_tests/_thumbs/najm.jpg?v=25" alt="" loading="lazy" width="1600" height="1000" />
</div>
<p class="ex-card__prompt"><span class="ex-card__prompt-mark">$</span> /hallmark build a Moroccan fashion brand landing page</p>
</a>
<a class="ex-card" style="--scroll-dur:3.5s" role="listitem" href="examples/hyperlane/" target="_blank" rel="noopener" aria-label="Open the Hyperlane example, a developer infrastructure landing page, in a new tab">
<div class="ex-card__thumb" aria-hidden="true">
- <img src="_tests/_thumbs/hyperlane.jpg?v=24" alt="" loading="lazy" width="1600" height="1000" />
+ <img src="_tests/_thumbs/hyperlane.jpg?v=25" alt="" loading="lazy" width="1600" height="1000" />
</div>
<p class="ex-card__prompt"><span class="ex-card__prompt-mark">$</span> /hallmark build a developer infrastructure landing page</p>
</a>
<a class="ex-card" style="--scroll-dur:2.5s" role="listitem" href="examples/cobalt-01/" target="_blank" rel="noopener" aria-label="Open the Distil example, a content-extraction API, Cobalt, in a new tab">
<div class="ex-card__thumb" aria-hidden="true">
- <img src="_tests/_thumbs/cobalt-01.jpg?v=24" alt="" loading="lazy" width="1600" height="1000" />
+ <img src="_tests/_thumbs/cobalt-01.jpg?v=25" alt="" loading="lazy" width="1600" height="1000" />
</div>
<p class="ex-card__prompt"><span class="ex-card__prompt-mark">$</span> /hallmark build a content-extraction API, Cobalt</p>
</a>
<a class="ex-card" style="--scroll-dur:2.7s" role="listitem" href="examples/carnival-01/" target="_blank" rel="noopener" aria-label="Open the Cold Snap example, a record-label EP page, Carnival, in a new tab">
<div class="ex-card__thumb" aria-hidden="true">
- <img src="_tests/_thumbs/carnival-01.jpg?v=24" alt="" loading="lazy" width="1600" height="1000" />
+ <img src="_tests/_thumbs/carnival-01.jpg?v=25" alt="" loading="lazy" width="1600" height="1000" />
</div>
<p class="ex-card__prompt"><span class="ex-card__prompt-mark">$</span> /hallmark build a record-label EP page, Carnival</p>
</a>
<a class="ex-card" style="--scroll-dur:3.1s" role="listitem" href="examples/lumen-01/" target="_blank" rel="noopener" aria-label="Open the Cinder example, an AI reasoning tool, Lumen, in a new tab">
<div class="ex-card__thumb" aria-hidden="true">
- <img src="_tests/_thumbs/lumen-01.jpg?v=24" alt="" loading="lazy" width="1600" height="1000" />
+ <img src="_tests/_thumbs/lumen-01.jpg?v=25" alt="" loading="lazy" width="1600" height="1000" />
</div>
<p class="ex-card__prompt"><span class="ex-card__prompt-mark">$</span> /hallmark build an AI reasoning tool, Lumen</p>
</a>
@@ -346,9 +343,6 @@
<!-- 03 · SKILLS — five things Hallmark does, one ruleset underneath -->
<section class="section reveal" style="--i:2" id="skills" aria-labelledby="s-skills">
<header class="section__head">
- <p class="section-label">
- <span class="num">03</span><span class="divider">⁄</span><span>Skills</span>
- </p>
<h2 class="section__title" id="s-skills">
What it does.
</h2>
@@ -554,9 +548,6 @@
With section (preserved as a <template> below). -->
<section class="section reveal" style="--i:3" id="anti-patterns" aria-labelledby="s-anti">
<header class="section__head">
- <p class="section-label">
- <span class="num">04</span><span class="divider">⁄</span><span>Anti-patterns</span>
- </p>
<h2 class="section__title" id="s-anti">
Slop, by name.
</h2>
@@ -570,7 +561,6 @@
<ol class="anti-list">
<li class="anti-row">
- <p class="anti-row__num tnum">01</p>
<div class="anti-row__slop">
<h3 class="anti-row__name">The purple-gradient hero.</h3>
<p class="anti-row__desc">A hero with a background gradient from purple to blue or purple to pink, white
@@ -584,7 +574,6 @@
</li>
<li class="anti-row">
- <p class="anti-row__num tnum">02</p>
<div class="anti-row__slop">
<h3 class="anti-row__name">Inter as display.</h3>
<p class="anti-row__desc">Inter (or Roboto, or Open Sans) used as both display and body, no pairing face. A
@@ -598,7 +587,6 @@
</li>
<li class="anti-row">
- <p class="anti-row__num tnum">03</p>
<div class="anti-row__slop">
<h3 class="anti-row__name">Centred everything.</h3>
<p class="anti-row__desc">Headline centred, body centred, button centred, section after section of centred
@@ -612,7 +600,6 @@
</li>
<li class="anti-row">
- <p class="anti-row__num tnum">04</p>
<div class="anti-row__slop">
<h3 class="anti-row__name">The icon-tile feature card.</h3>
<p class="anti-row__desc">Rounded rectangle, icon in a coloured square top-left, two-line heading,
@@ -626,7 +613,6 @@
</li>
<li class="anti-row">
- <p class="anti-row__num tnum">05</p>
<div class="anti-row__slop">
<h3 class="anti-row__name">The AI nav.</h3>
<p class="anti-row__desc">Wordmark hard-left, four inline links centred, CTA button hard-right, sticky on
@@ -651,9 +637,6 @@
below). -->
<section class="section reveal" style="--i:4" id="foundations" aria-labelledby="s5-foundations">
<header class="section__head">
- <p class="section-label">
- <span class="num">05</span><span class="divider">⁄</span><span>Foundations</span>
- </p>
<h2 class="section__title" id="s5-foundations">
Foundations.
</h2>
@@ -780,9 +763,6 @@
same brief. -->
<section class="section reveal" style="--i:5" id="before-after" aria-labelledby="s-ba">
<header class="section__head">
- <p class="section-label">
- <span class="num">06</span><span class="divider">⁄</span><span>With / Without</span>
- </p>
<h2 class="section__title" id="s-ba">
Same prompt. Two different outputs.
</h2>
@@ -814,9 +794,6 @@
<!-- 07 · INSTALL — one command, every harness -->
<section class="section reveal" style="--i:6" id="install" aria-labelledby="s6">
<header class="section__head">
- <p class="section-label">
- <span class="num">07</span><span class="divider">⁄</span><span>Install</span>
- </p>
<h2 class="section__title" id="s6">
Install.
</h2>
@@ -888,9 +865,9 @@
<template id="hero-marquee">
<div class="hero hero--marquee">
<div class="hero__main">
- <p class="hero__eyebrow"><span class="mark" aria-hidden="true"></span>{{eyebrow}}</p>
<h1 class="hero__display" data-text="{{title}}">{{title}}</h1>
<p class="hero__lede">{{lede}}</p>
+ <p class="hero__colophon"><span class="mark" aria-hidden="true"></span>{{colophon}}</p>
<div class="hero__cta">
<p class="label">{{ctaLabel}}</p>
<pre class="code"
@@ -904,9 +881,9 @@
<template id="hero-split">
<div class="hero hero--split">
<div class="hero__col">
- <p class="hero__eyebrow"><span class="mark" aria-hidden="true"></span>{{eyebrow}}</p>
<h1 class="hero__display">{{title}}</h1>
<p class="hero__lede">{{lede}}</p>
+ <p class="hero__colophon"><span class="mark" aria-hidden="true"></span>{{colophon}}</p>
</div>
<aside class="hero__proof">
<p class="label">{{proofLabel}}</p>
@@ -921,10 +898,10 @@
<template id="hero-stat-led">
<div class="hero hero--stat">
<div class="hero__main">
- <p class="hero__eyebrow"><span class="mark" aria-hidden="true"></span>{{eyebrow}}</p>
<span class="hero__stat tabular-nums">{{stat}}</span>
<p class="hero__qualifier">{{qualifier}}</p>
<p class="hero__lede">{{lede}}</p>
+ <p class="hero__colophon"><span class="mark" aria-hidden="true"></span>{{colophon}}</p>
<a href="#install" class="link hero__link">{{cta}} &rarr;</a>
</div>
<aside class="hero__moment" aria-hidden="true"></aside>
@@ -934,12 +911,12 @@
<template id="hero-quote-led">
<div class="hero hero--quote">
<div class="hero__main">
- <p class="hero__eyebrow"><span class="mark" aria-hidden="true"></span>{{eyebrow}}</p>
<blockquote class="hero__quote">
<p>&ldquo;{{quote}}&rdquo;</p>
<footer class="hero__attrib">— {{attrib}}</footer>
</blockquote>
<p class="hero__lede">{{lede}}</p>
+ <p class="hero__colophon"><span class="mark" aria-hidden="true"></span>{{colophon}}</p>
<a href="#install" class="link hero__link">{{cta}} &rarr;</a>
</div>
<aside class="hero__moment" aria-hidden="true"></aside>
@@ -949,10 +926,10 @@
<template id="hero-letter">
<div class="hero hero--letter">
<div class="hero__main">
- <p class="hero__eyebrow"><span class="mark" aria-hidden="true"></span>{{eyebrow}}</p>
<p class="hero__salutation">{{salutation}}</p>
<p class="hero__letter-body">{{letterBody}}</p>
<p class="hero__signoff">{{signoff}}<br><span class="hero__sign">— Hallmark</span></p>
+ <p class="hero__colophon"><span class="mark" aria-hidden="true"></span>{{colophon}}</p>
</div>
<aside class="hero__moment" aria-hidden="true">
<svg viewBox="0 0 120 220" fill="none" xmlns="http://www.w3.org/2000/svg">
@@ -976,9 +953,9 @@
<template id="hero-bloom">
<div class="hero hero--bloom">
<div class="hero__copy">
- <p class="hero__eyebrow"><span class="mark" aria-hidden="true"></span>{{eyebrow}}</p>
<h1 class="hero__display hero__display--small">{{title}}</h1>
<p class="hero__lede">{{lede}}</p>
+ <p class="hero__colophon"><span class="mark" aria-hidden="true"></span>{{colophon}}</p>
<div class="hero__cta">
<pre class="code"
data-copy-source><span class="prompt">$</span><span data-copy-text>npx skills add nutlope/hallmark</span><button class="code__copy" type="button" data-copy-btn aria-label="Copy install command"><span class="code__copy-default">Copy</span><span class="code__copy-done">Copied</span></button></pre>
@@ -1011,9 +988,9 @@
<template id="hero-orbit">
<div class="hero hero--orbit">
<div class="hero__copy">
- <p class="hero__eyebrow"><span class="mark" aria-hidden="true"></span>{{eyebrow}}</p>
<h1 class="hero__display hero__display--small">{{title}}</h1>
<p class="hero__lede">{{lede}}</p>
+ <p class="hero__colophon"><span class="mark" aria-hidden="true"></span>{{colophon}}</p>
<div class="hero__cta">
<pre class="code"
data-copy-source><span class="prompt">$</span><span data-copy-text>npx skills add nutlope/hallmark</span><button class="code__copy" type="button" data-copy-btn aria-label="Copy install command"><span class="code__copy-default">Copy</span><span class="code__copy-done">Copied</span></button></pre>
@@ -1044,9 +1021,9 @@
<template id="hero-hum">
<div class="hero hero--hum">
<div class="hero__main">
- <p class="hero__eyebrow"><span class="mark" aria-hidden="true"></span>{{eyebrow}}</p>
<h1 class="hero__display">{{title}}</h1>
<p class="hero__lede">{{lede}}</p>
+ <p class="hero__colophon"><span class="mark" aria-hidden="true"></span>{{colophon}}</p>
<div class="hero__cta">
<p class="label">{{ctaLabel}}</p>
<pre class="code"
@@ -1067,9 +1044,9 @@
<template id="hero-cobalt">
<div class="hero hero--cobalt">
<div class="hero__main">
- <p class="hero__eyebrow"><span class="mark" aria-hidden="true"></span>{{eyebrow}}</p>
<h1 class="hero__display">{{title}}</h1>
<p class="hero__lede">{{lede}}</p>
+ <p class="hero__colophon"><span class="mark" aria-hidden="true"></span>{{colophon}}</p>
<div class="hero__cta-row">
<a class="hero__cta-btn" href="#install">{{ctaLabel}}</a>
<a class="link hero__link" href="#examples">{{cta}} &rarr;</a>
@@ -1125,7 +1102,7 @@
</div>
</template>
- <script type="module" src="js/main.js?v=24"></script>
+ <script type="module" src="js/main.js?v=25"></script>
</body>
</html>
\ No newline at end of file
diff --git a/site/js/main.js b/site/js/main.js
index 4ac1e6d..4ee7715 100644
--- a/site/js/main.js
+++ b/site/js/main.js
@@ -144,10 +144,10 @@ const HERO_TITLE = "A design skill that refuses to look AI-generated.";
/* — Per-theme copy fixtures —————————————————————————————
Distinct voice per theme so the page doesn't read like the same
page in different fonts. The `title` is locked across themes;
- eyebrow, lede, quote, stat, salutation, etc. still vary. */
+ colophon, lede, quote, stat, salutation, etc. still vary. */
const COPY = {
specimen: {
- eyebrow: "A design skill",
+ colophon: "A design skill",
title: HERO_TITLE,
lede: "Hallmark is a skill for Claude Code, Cursor, and Codex. It encodes the anti-slop consensus — typography, colour, layout, motion, interaction — into one holistic ruleset your AI assistant will actually follow.",
ctaLabel: "01 ⁄ Install",
@@ -167,7 +167,7 @@ const COPY = {
captionB: "From the working archive",
},
newsprint: {
- eyebrow: "Volume I · Issue 02 · 28 April 2026",
+ colophon: "Volume I · Issue 02 · 28 April 2026",
title: HERO_TITLE,
lede: "Twenty-four themes. Twenty-one named page shapes. Fifty component archetypes — fourteen navs, eight footers, four hero polish patterns. A 58-gate slop test that gates every output before it ships. Hallmark is the rulebook the LLM never read.",
ctaLabel: "Distribution",
@@ -187,7 +187,7 @@ const COPY = {
captionB: "Press run",
},
atelier: {
- eyebrow: "An atelier note",
+ colophon: "An atelier note",
title: HERO_TITLE,
lede: "A small, opinionated craftsmanship engine that argues with your AI assistant on your behalf — and wins.",
ctaLabel: "By appointment",
@@ -207,7 +207,7 @@ const COPY = {
captionB: "12 April",
},
garden: {
- eyebrow: "A small dispatch",
+ colophon: "A small dispatch",
title: HERO_TITLE,
lede: "Twenty-four themes that disagree with each other on purpose. Pick one and the whole page changes — not the colours, the bones.",
ctaLabel: "Plant it",
@@ -227,7 +227,7 @@ const COPY = {
captionB: "Late spring",
},
almanac: {
- eyebrow: "Almanac · 2026 edition",
+ colophon: "Almanac · 2026 edition",
title: HERO_TITLE,
lede: "A reference book of structural choices, indexed and cross-referenced. Hallmark looks up the right page-shape for the brief and refuses to use the same one twice.",
ctaLabel: "Open the index",
@@ -247,7 +247,7 @@ const COPY = {
captionB: "Plate 12",
},
midnight: {
- eyebrow: "Built for the dark",
+ colophon: "Built for the dark",
title: HERO_TITLE,
lede: "A dark theme that uses lightness for elevation, not shadow. Numbered display labels. Typewriter reveals. Indigo accent at low chroma.",
ctaLabel: "Run it",
@@ -267,7 +267,7 @@ const COPY = {
captionB: "0240h",
},
terminal: {
- eyebrow: "$ hallmark",
+ colophon: "$ hallmark",
title: HERO_TITLE,
lede: "Honest about its medium. Monospace top to bottom. No animations. The page is what it is.",
ctaLabel: "Run",
@@ -287,7 +287,7 @@ const COPY = {
captionB: "0241",
},
brutal: {
- eyebrow: "Brutal — uncompromised",
+ colophon: "Brutal — uncompromised",
title: HERO_TITLE,
lede: "Heavy display. Hard edges. One accent that means it. The grid does not flex; the grid is the point.",
ctaLabel: "Take it",
@@ -307,7 +307,7 @@ const COPY = {
captionB: "PRINT 01",
},
manifesto: {
- eyebrow: "Manifesto",
+ colophon: "Manifesto",
title: "The Design Skill.",
lede: "The page is a statement. We don't soften it. The accent is a colour with a position. The headline is a belief.",
ctaLabel: "Sign it",
@@ -327,7 +327,7 @@ const COPY = {
captionB: "POSTER",
},
sport: {
- eyebrow: "Sport · 2026",
+ colophon: "Sport · 2026",
title: HERO_TITLE,
lede: "Italic display. Tabular nums. Numbered display headers. The page moves like a scoreboard — fast, decisive, in motion.",
ctaLabel: "Kick off",
@@ -347,7 +347,7 @@ const COPY = {
captionB: "LAP 12",
},
studio: {
- eyebrow: "Studio · 2026",
+ colophon: "Studio · 2026",
title: HERO_TITLE,
lede: "We design and build distinctive products for ambitious teams. Hallmark is our typography opinion, codified — twenty-four themes, twenty-one shapes, no defaults.",
ctaLabel: "Engage",
@@ -367,7 +367,7 @@ const COPY = {
captionB: "Selected work",
},
riso: {
- eyebrow: "ed. 12 · printed today",
+ colophon: "ed. 12 · printed today",
title: HERO_TITLE,
lede: "warm paper, off-register accents, one bold lowercase headline. a page that feels printed, not generated.",
ctaLabel: "press →",
@@ -387,7 +387,7 @@ const COPY = {
captionB: "press · 04",
},
bloom: {
- eyebrow: "Warm minimal · 2026",
+ colophon: "Warm minimal · 2026",
title: HERO_TITLE,
lede: "For the calm, considered product page. A warm-light canvas, one soft bloom, and a single restrained accent — clean type with room to breathe.",
ctaLabel: "Try it now",
@@ -408,7 +408,7 @@ const COPY = {
captionB: "Warm light",
},
coral: {
- eyebrow: "Modern minimal · warm-grey",
+ colophon: "Modern minimal · warm-grey",
title: HERO_TITLE,
lede: "For the polished SaaS that wants warmth without losing discipline. Warm-grey paper, General Sans throughout, a single coral accent kept under five percent of the view.",
ctaLabel: "Get started",
@@ -429,7 +429,7 @@ const COPY = {
captionB: "v1.2",
},
aurora: {
- eyebrow: "Atmospheric · cool",
+ colophon: "Atmospheric · cool",
title: HERO_TITLE,
lede: "For the after-dark dev tool. Cool blue-green canvas, two atmospheric blooms behind the content, single teal-green accent. Sentient body for warmth on the cool ground.",
ctaLabel: "Open it",
@@ -450,7 +450,7 @@ const COPY = {
captionB: "Late-shift",
},
editorial: {
- eyebrow: "No XXIII · Editorial",
+ colophon: "No XXIII · Editorial",
title: HERO_TITLE,
lede: "An editorial-premium voice — warm cream paper, coral accent, mixed sans + serif italic. Magazine-shaped, hairline rules, asymmetric grids.",
ctaLabel: "I · Install",
@@ -471,7 +471,7 @@ const COPY = {
captionB: "Spring 2026",
},
carnival: {
- eyebrow: "NO TEMPLATES · NO DEFAULTS",
+ colophon: "NO TEMPLATES · NO DEFAULTS",
title: HERO_TITLE,
lede: "24 themes that refuse to blend in. Pick one and the whole page changes — the bones, not the paint.",
ctaLabel: "Install",
@@ -491,7 +491,7 @@ const COPY = {
captionB: "OUT NOW",
},
lumen: {
- eyebrow: "00 · DESIGN SKILL",
+ colophon: "00 · DESIGN SKILL",
title: HERO_TITLE,
lede: "a design skill that refuses the defaults every model was trained on. twenty-four themes, twenty-one page-shapes, and one slop test that gates every build before it ships.",
ctaLabel: "install",
@@ -511,7 +511,7 @@ const COPY = {
captionB: "night foundry",
},
hum: {
- eyebrow: "A design skill",
+ colophon: "A design skill",
title: "Make your AI agent a designer.",
lede: "The anti-slop design skill for Claude Code, Cursor, and Codex. Twenty-four themes with real structural variety, and a 58-gate check before anything ships.",
ctaLabel: "Install",
@@ -531,7 +531,7 @@ const COPY = {
captionB: "Kept warm",
},
cobalt: {
- eyebrow: "Modern minimal · dev-tool",
+ colophon: "Modern minimal · dev-tool",
title: HERO_TITLE,
lede: "For the API, the docs, the dev tool. A cool engineered canvas, ruler-drawn hairlines, and one electric cobalt signal — the page reads like good infrastructure, not a template.",
ctaLabel: "Start building",
@@ -552,7 +552,7 @@ const COPY = {
captionB: "v1.2",
},
grid: {
- eyebrow: "Swiss international",
+ colophon: "Swiss international",
title: HERO_TITLE,
lede: "The grid, made visible. A near-white sheet, exposed twelve-column hairlines, one signal red, and a heavy neo-grotesque set flush-left. Rational, exact, built for institutions that plan in decades.",
ctaLabel: "Method",
@@ -573,7 +573,7 @@ const COPY = {
captionB: "v1.2",
},
field: {
- eyebrow: "Warm productivity",
+ colophon: "Warm productivity",
title: HERO_TITLE,
lede: "The serious tool that feels hand-made. Cream paper, a Source Serif headline over humanist Public Sans, one marigold highlighter behind the phrase that matters, and hand-drawn ink where a diagram helps.",
ctaLabel: "Start free",
@@ -594,7 +594,7 @@ const COPY = {
captionB: "v1.2",
},
ledger: {
- eyebrow: "Fintech terminal-lux",
+ colophon: "Fintech terminal-lux",
title: HERO_TITLE,
lede: "The data is the marketing. A navy ground, a giant reconciled balance in tabular mono, a live transaction ledger, and one teal signal on the figures that moved. Dense, cool, precise, trustworthy.",
ctaLabel: "Open account",
@@ -615,7 +615,7 @@ const COPY = {
captionB: "v1.2",
},
arcade: {
- eyebrow: "Free play · event 07",
+ colophon: "Free play · event 07",
title: HERO_TITLE,
lede: "Retro-system nostalgia, kept tasteful. A violet-black ground, a pixel display over a readable humanist body, a magenta and cyan duo, scanlines and a starfield. The retro comes from type and light, never from fake window chrome.",
ctaLabel: "Register",
diff --git a/skills/hallmark/SKILL.md b/skills/hallmark/SKILL.md
index a4e3af8..28d30a0 100644
--- a/skills/hallmark/SKILL.md
+++ b/skills/hallmark/SKILL.md
@@ -8,34 +8,38 @@ version: 1.2.0
A design skill for AI coding assistants. Makes the UIs they generate look made, not generated.
-Hallmark is opinionated, short, and boring on purpose. It encodes a tight set of rules drawn from the consensus of the anti-AI-slop design field, and refuses to let the model fall back to the defaults every LLM was trained on. The differentiator: **structural variety**, not just visual variety. Two pages by Hallmark for two different briefs should feel like different sites, not colour-swaps of the same template. See [`references/structure.md`](references/structure.md).
+Hallmark holds a hard floor and then gets out of the way. It refuses the defaults every LLM was trained into and the tells that read as machine-made within seconds; above that line it hands the page back to you. The differentiator: **structural variety**, not just visual variety. Two pages by Hallmark for two different briefs should feel like different sites, not colour-swaps of the same template. See [`references/structure.md`](references/structure.md).
+
+The floor holds the mechanics. It never picks the direction.
**Powered by Together AI.**
---
-## Critical floor
+## The Floor
-These bind on every output, in every verb, on every model. Read nothing else and you must still obey these.
+These bind on every output, in every verb, on every model, and **none of them is waivable**. Read nothing else and you must still obey these.
1. Every colour and every font references a token via `var(--*)`, declared at `:root` (or a declared theme / route-wrapper token block). No inline hex / oklch / rgb values, no raw `font-family:` strings past the token block. (gate 48)
-2. Never `transition: all`. Animate only `transform` and `opacity`, never layout properties. (gates 10, 14)
-3. The display font is never Inter, Roboto, Open Sans, Poppins, or Lato. Headings are never italic, not even one word. (gates 1, 38a)
-4. No pure `#000` or `#fff` as a base colour (modern-minimal genre excepted for `#fff`). (gate 7)
-5. `overflow-x: clip` on both `html` and `body`. Never `hidden`, never `100vw`. (gate 34)
-6. Image-bearing grid tracks use `minmax(0, 1fr)`, never bare `1fr`. Display headers get `overflow-wrap: anywhere; min-width: 0`. (gates 50, 51)
-7. Every interactive element ships `:focus-visible`, `:active`, and `:disabled` styling. The focus ring appears instantly, never fades in. (gates 26, 15)
-8. Any animation has a `@media (prefers-reduced-motion: reduce)` fallback. (gate 27)
-9. Never invent a metric, testimonial, logo wall, or case-study count. (gate 46)
-10. Never place an eyebrow / tag / number beside a heading. Vertical stack only. (gate 54)
-11. The first non-empty line of emitted CSS is the `/* Hallmark · macrostructure: ... */` stamp; the pre-emit critique comment sits directly under it, and a custom build's direction contract directly under that. (gate 20)
+2. Never `transition: all`. Never animate `width`, `height`, `top`, or `left`. (gates 10, 14a)
+3. Never italicise one word inside an otherwise roman heading. (gate 38a-i)
+4. `overflow-x: clip` on both `html` and `body`. Never `hidden`, never `100vw`. (gate 34)
+5. Image-bearing grid tracks use `minmax(0, 1fr)`, never bare `1fr`. Display headers get `overflow-wrap: break-word; min-width: 0`. (gates 50, 51)
+6. Every interactive element ships `:focus-visible`. The focus ring appears instantly, never fades in. (gates 26a, 15)
+7. Any animation has a `@media (prefers-reduced-motion: reduce)` fallback. (gate 27)
+8. Never invent a metric, testimonial, logo wall, or case-study count. (gate 46a)
+9. Never ship an eyebrow, kicker, or overline: short inert type before a heading that announces what the heading is about. Not stacked, not beside, not as a badge pill, not with an ordinal. Open the section another way ([`references/section-entry.md`](references/section-entry.md)). (gate 54)
+10. The hero's headline, lede, and primary CTA are all visible at 1280x800 without scrolling. (gate 44b)
+11. The first non-empty line of emitted CSS is the `/* Hallmark · macrostructure: ... */` stamp; the pre-emit critique comment sits directly under it, then any waiver lines, then a custom build's direction contract. (gate 20)
12. If Node is available, run `node <skill-dir>/scripts/sloplint.mjs <output>` before handing back and fix every FAIL.
+**Above the Floor, the skill is advice.** A banned display font, an accent that fills the page, a pure-black stage, an italic display *system*, four type families: these are **Reflex** gates. They are the defaults a language model falls into, not laws, and a build with a real reason may waive one on the record. The tiers, the waiver syntax, and the caps live in [`references/slop-test.md`](references/slop-test.md) § Tiers.
+
## Flow at a glance
0. Pre-flight scan of the existing project.
1. Ask Audience / Use case / Tone once; detect genre; note custom signals.
-2. Pick macrostructure + nav + footer + hero posture from the slim indexes; run the Rotation rules; say the Picks block.
+2. Design the page's shape, nav, footer, hero, and section entry; run the Rotation rules; say the Picks block. (Catalogs available, never required.)
2.6. Theme route: studied-DNA, catalog, or custom (custom runs the ritual in [`references/custom-theme.md`](references/custom-theme.md)).
3. Load ONLY the listed reference files.
4. Enrichment decision (scene sentence first; most pages are typography-only).
@@ -43,7 +47,7 @@ These bind on every output, in every verb, on every model. Read nothing else and
6. Build: tokens, stamp, `tokens.css`, log append.
7. Slop test: sloplint script first, then the judged gates.
-Verbs `audit`, `redesign`, `study`, and `variants` dispatch to their own files (below). **Harness dispatch:** Hallmark is tuned for three harnesses. In **Claude Code** this file runs as written (hooks, subagents, and the preview pane all exist). In **Codex CLI**, read [`references/harnesses/codex.md`](references/harnesses/codex.md) before Step 0. In **OpenCode**, read [`references/harnesses/opencode.md`](references/harnesses/opencode.md) before Step 0. Any other harness: follow this file on the Critical floor with sequential tool calls, chat-text questions, and Step 7 as the only mechanical sweep.
+Verbs `audit`, `redesign`, `study`, and `variants` dispatch to their own files (below). **Harness dispatch:** Hallmark is tuned for three harnesses. In **Claude Code** this file runs as written (hooks, subagents, and the preview pane all exist). In **Codex CLI**, read [`references/harnesses/codex.md`](references/harnesses/codex.md) before Step 0. In **OpenCode**, read [`references/harnesses/opencode.md`](references/harnesses/opencode.md) before Step 0. Any other harness: follow this file on the Floor with sequential tool calls, chat-text questions, and Step 7 as the only mechanical sweep.
---
@@ -69,7 +73,7 @@ If the input does not clearly map to a verb, treat it as default. If the user at
## Disciplines that hold across every verb
-1. **Pre-emit self-critique.** Before handing back any output, score it 1-5 on six axes: Philosophy, Hierarchy, Execution, Specificity, Restraint, Variety. Anything **< 3** triggers a revision pass, and at least one axis must score <= 4 with its reason and fix named in the stamp's `weakest:` clause (straight 5s = unexamined). Stamp: `/* Hallmark · pre-emit critique: P5 H4 E5 S3 R5 V4 · weakest: S - <reason; fix taken> */`. See [`references/slop-test.md`](references/slop-test.md) § Pre-emit self-critique.
+1. **Pre-emit self-critique.** Before handing back any output, score it 1-5 on six axes: Philosophy, Hierarchy, Execution, Specificity, Restraint, Variety. Anything **< 3** triggers a revision pass. Score honestly: name any axis below 5 in the stamp's `weakest:` clause with the fix taken, and if the scores really are straight 5s, name what was **cut** to earn them instead. Never invent a weakness to fill the field. Stamp: `/* Hallmark · pre-emit critique: P5 H4 E5 S3 R5 V4 · weakest: S - <reason; fix taken> */`. See [`references/slop-test.md`](references/slop-test.md) § Pre-emit self-critique.
2. **Honest copy, no fabricated content.** If the user did not supply a metric, do not invent one. Stat layouts, comparison rows, and proof bars use real numbers, a labelled placeholder ("metric to confirm"), or a different macrostructure. Same for testimonials, logos, and case-study counts. See [`references/anti-patterns.md` § Invented metrics](references/anti-patterns.md) and gate **46**.
@@ -87,7 +91,7 @@ If the input does not clearly map to a verb, treat it as default. If the user at
**Check scope before entering the Design flow.** Component-scope signals: the brief names a single UI element (button, input, form, card, modal, dropdown, tooltip, select, checkbox, switch, tab strip, chip, badge, banner, snackbar, popover, slider, date picker, avatar, a single nav or footer); the brief is short (<= 30 words) and refers to one element; the target file is a single component; the user says "just the X" / "only the Y". Two signals fire: route component. Ambiguous ("a pricing section"): ask once, *"One pricing card, or the whole pricing page?"*, defaulting to component. The Step 1 questions still fire once in component scope; only `audit` / `study` / `redesign --mood` are silent. (When the brief IS a nav or footer, build it as the component; the "skips" below are about page chrome around a page build.)
-**Component scope keeps:** Step 0 pre-flight, Step 1 genre detection, Step 2.6 theme route (existing tokens win; otherwise ask once, defaulting to catalog), the 2+1 font discipline, and a STRICTER state rule: every interactive component ships code for **all 8 states**: default · hover · `:focus-visible` · `:active` · disabled · loading · error · success, per [`references/interaction-and-states.md`](references/interaction-and-states.md). The slop test runs the **Core-15 sweep** named in [`references/slop-test.md`](references/slop-test.md).
+**Component scope keeps:** Step 0 pre-flight, Step 1 genre detection, Step 2.6 theme route (existing tokens win; otherwise ask once, defaulting to catalog), the 2+1 font discipline, and a STRICTER state rule: every interactive component ships code for **all 8 states**: default · hover · `:focus-visible` · `:active` · disabled · loading · error · success, per [`references/interaction-and-states.md`](references/interaction-and-states.md). The slop test runs the **component sweep** named in [`references/slop-test.md`](references/slop-test.md): every gate minus the page-only ones.
**Component scope skips:** macrostructure ("Component-scope: skipping macrostructure."), nav and footer archetypes, hero polish, enrichment, the multi-section preview, and the `.hallmark/log.json` append (components do not rotate).
@@ -173,40 +177,45 @@ Two non-default signals firing (rare): ask one short either/or. State the genre
### 2. Structure and rotation
-**Do:** pick macrostructure, nav, footer, and hero posture from the slim indexes, run the Rotation rules, run the mirror test, and say the Picks block before writing any code.
+**Do:** design the shape this brief wants, check it against what you built last time, and say the Picks block before writing any code.
+
+**Design the page, then name what you designed.** Decide the page's shape, how it opens, how sections separate, what the nav and footer are doing, how tall the hero stands and what carries it. State those decisions in your own words. You are a capable designer; this step is not a form to fill in.
-**Macrostructure first.** Read the index at [`references/macrostructures.md`](references/macrostructures.md), pick ONE of the 21 named shapes, then load ONLY that per-macro file from `references/macrostructures/`. Never load the whole catalogue. The macrostructure picks five of the six structural axes; the deeper axis catalogue in [`references/structure.md`](references/structure.md) is only for deviating.
+**The catalogs are there when you want a starting point, and only then.** Twenty-one named page shapes in [`references/macrostructures.md`](references/macrostructures.md), fourteen navs and eight footers indexed in [`references/component-cookbook.md`](references/component-cookbook.md), six hero postures in [`references/enrichment/hero-discipline.md`](references/enrichment/hero-discipline.md), section openings in [`references/section-entry.md`](references/section-entry.md). Reach for them when a brief is vague, when you want a shape you would not have thought of, or when you want the mobile-collapse rules already worked out. Ignore them when you have a better idea. **If you do take a named shape, load ONLY that one file** — reading a whole catalogue is the single biggest token waste in the skill.
-**Nav, footer, and hero at the same step.** Read the index + routing tables in [`references/component-cookbook.md`](references/component-cookbook.md); pick a nav archetype (N1/N1b through N13, fourteen of them; N1a is the older alias for N1) and a footer archetype (Ft1-Ft8); load ONLY the picked files from `references/components/`. A typical build loads 5-7 archetype files total. **Default away from N1a and Ft3**, the two most-recognised AI fingerprints; reach for N1b / N5 / N11 / N13 and Ft1 / Ft2 / Ft4-Ft8 unless the page genuinely has two destinations or is a docs hub. Then pick the **hero posture** (Settled · Banner · Poster · Ledge · Corridor · Stage) and content archetype (H1-H9); the envelope table lives in [`references/enrichment/hero-discipline.md`](references/enrichment/hero-discipline.md) § Hero postures.
+Two things the catalogs are not: a checklist you owe, and a rotation you must walk. What replaces "rotate through the codes" is simpler and harder to fake: **don't repeat yourself, and say how this one differs.**
**Rotation (the canonical block - every other file defers here):**
-- **Macro:** must differ from the last three Hallmark outputs for this project (read `.hallmark/log.json`, newest first; a CSS stamp counts when the log is missing). Specimen is never a default; reach for it only on explicit editorial / foundry briefs.
+- **Structure:** the page's shape must differ from the last three Hallmark outputs for this project (read `.hallmark/log.json`, newest first; a CSS stamp counts when the log is missing). Whether you named a catalog shape or invented one, the log records what you built and the next run has to move.
- **Theme:** two consecutive themes must differ on at least one of three axes: **paper band** (dark < 30% L · mid 30-85% · light > 85%), **display style**, **accent hue** (warm 10-60° · cool 200-300° · neutral · chromatic-other). The 24-row lookup lives in [`references/theme-axes.md`](references/theme-axes.md). Two of three matching: pick a more distant theme.
-- **Nav + footer:** no repeated N code and no repeated Ft code within the LAST THREE runs (same depth as macro), across consecutive runs and across test builds of the same theme. This is the single most-violated rule; rotate deliberately through the routing table's alternates.
-- **Hero:** no non-Settled posture repeats back-to-back; Settled may repeat twice, never three runs in a row. The content archetype H# follows the nav/footer no-repeat rule.
-- **Enrichment:** do not repeat the previous run's E# archetype back-to-back.
-- **Log schema** (`.hallmark/log.json`, newest entry first, trimmed to 20):
+- **Chrome:** the nav and the footer must not be the same shape as the last three runs, across consecutive runs and across test builds of the same theme. This is the single most-violated rule. If you reach for the default nav, the stamp has to name it (gate 42) — the default is allowed, arriving at it by reflex is not.
+- **Hero:** vary the hero's stance run to run. Nothing but the fold-fit floor (gate 44b) constrains how tall or how anchored it is.
+- **Enrichment:** do not repeat the previous run's enrichment approach back-to-back.
+- **Section entry:** do not open sections the same way as the last run. [`references/section-entry.md`](references/section-entry.md) § Going stale carries the caps.
+- **Log schema** (`.hallmark/log.json`, newest entry first, trimmed to 20). Catalog codes when you used one, plain words when you did not:
```json
{ "date": "2026-04-30", "macrostructure": "Bento Grid", "theme": "Coral",
"hero": "Stage/H2", "nav": "N5", "footer": "Ft2", "enrichment": "E1 clipped-edge",
+ "section-entry": "change of paper",
"axes": "light/grotesk-sans/warm",
"fingerprint": "Centered|Single column|Hairline|Outlined|Margin-aligned|Fade-up",
+ "waived": ["23"],
"brief": "Tracejam · SaaS observability" }
```
-The `axes` and `fingerprint` fields are how Rotation and gate 32 become checkable instead of remembered; older entries without them are treated as unconstrained. First run for a project: no constraint, note it in one line. User explicitly re-orders the same archetype: same shape, different knob values, and say the knob deltas.
+The `axes` and `fingerprint` fields are how Rotation and gate 32 become checkable instead of remembered; older entries without them are treated as unconstrained. `waived` records any Reflex gate this build waived: the same gate waived three runs running is not an exception any more, it is an unstated house style, and it belongs in a `design.md`. First run for a project: no constraint, note it in one line. User explicitly re-orders the same shape: same shape, different values, and say the deltas.
-**The mirror test, before the block.** Would this exact macro + theme + nav + hero combination have come out for a NEIGHBOURING brief (same category, different product)? If yes, at least one pick must change, and the Picks block names which one in its parenthetical. A pick that survives the mirror is a decision; one that doesn't was a default.
+**The mirror test, before the block.** Would this exact combination have come out for a NEIGHBOURING brief (same category, different product)? If yes, at least one decision must change, and the Picks block names which one in its parenthetical. A choice that survives the mirror is a decision; one that doesn't was a default.
-**The Picks block.** One compact fenced block, said once, replacing all narration:
+**The Picks block.** One compact fenced block, said once, replacing all narration. Name a catalog code where you used one, plain words where you did not:
```
-Picks · genre: modern-minimal · macro: Workbench (last 3: Bento, Long Document, Manifesto)
+Picks · genre: modern-minimal · structure: Workbench (last 3: Bento, Long Document, Manifesto)
· theme: Cobalt (differs on paper band + display style) · hero: Stage/H2 (prev Settled)
-· nav: N13 (prev N5) · footer: Ft5 · deck: -logos +worked-example (SaaS decks only)
-· enrichment: tbd (Step 4) · custom: no
+· nav: N13 (prev N5) · footer: a single justified colophon line · section entry: rule + change of paper
+· deck: -logos +worked-example (SaaS decks only) · enrichment: tbd (Step 4) · custom: no
```
The enrichment cell may read `tbd (Step 4)`; the decision lands there and the Step 5 preview carries the final value. On a custom run the Picks block emits after the 2.6 ritual instead, so it can carry the draw line.
@@ -220,21 +229,21 @@ By now one of four things is true:
2. **Catalog** (named or implied) → pick one of the 24 themes per Rotation: Specimen, Atelier, Brutal, Newsprint, Studio, Manifesto, Terminal, Midnight, Almanac, Garden, Riso, Sport, Bloom, Coral, Cobalt, Aurora, Editorial, Carnival, Lumen, Hum, Grid, Field, Ledger, Arcade. Clusters: atmospheric rotates Bloom / Midnight / Terminal / Aurora / Lumen; modern-minimal rotates Coral / Cobalt / Ledger (Ledger is the cluster's dark option); playful rotates Hum / Field / Arcade; editorial walks the remaining thirteen (Grid is the Swiss / grotesque exception there).
3. **Nothing was discussed** → catalog, silently. Do not pause or ask.
-A custom system is complete (palette + pairing + axes), never a colour swap; its diversification axes are recorded like any catalog theme's. The 58 slop-test gates fire unchanged, and the Step 5 preview surfaces everything before code.
+A custom system is complete (palette + pairing + axes), never a colour swap; its diversification axes are recorded like any catalog theme's. All 58 slop-test gates fire unchanged, at their usual tiers, and the Step 5 preview surfaces everything before code.
### 3. Load the visual ruleset
**Do:** load exactly what this build needs; over-eager loading is the largest avoidable cost of running Hallmark.
-**Always (2-3 files):** the genre file from Step 1; [`references/enrichment/hero-discipline.md`](references/enrichment/hero-discipline.md) (the posture envelope + hero rules bind on every page hero, enriched or not); plus `references/themes/<theme>.md` when it exists for the picked catalog theme (only some themes have one; silent no-op when absent; studied-DNA and custom skip this).
+**Always (2-3 files):** the genre file from Step 1; [`references/enrichment/hero-discipline.md`](references/enrichment/hero-discipline.md) (the hero rules bind on every page hero, enriched or not); plus `references/themes/<theme>.md` for the picked catalog theme — all 24 have one (studied-DNA and custom skip this).
-**Index-then-pick (read the slim index, load only the picks):**
+**Index-then-pick (only when you are taking a named starting point; skip entirely when you are not):**
- [`references/macrostructures.md`](references/macrostructures.md) → one file from `references/macrostructures/`.
- [`references/component-cookbook.md`](references/component-cookbook.md) → only the picked N / Ft / H / S / F / C / T files from `references/components/`. The cookbook is a slim index plus routing tables; knobs and mobile-collapse rules ride inside each archetype file, so pre-loading more than one archetype file per category is the single biggest token waste in the skill.
- [`references/hero-enrichment.md`](references/hero-enrichment.md) → load its slim index at Step 4 to run the image-need check it contains; load an archetype file from `references/enrichment/` only when the answer is YES.
- [`references/custom-craft.md`](references/custom-craft.md) → only when the picked enrichment requires construction, then only the picked tier / recipe file from `references/craft/` (the craft tiers are lettered by construction method; match by name, not letter).
-**Every build:** [`references/typography.md`](references/typography.md) · [`references/color.md`](references/color.md) · [`references/layout-and-space.md`](references/layout-and-space.md) · [`references/motion.md`](references/motion.md) · [`references/copy.md`](references/copy.md) · [`references/anti-patterns.md`](references/anti-patterns.md) · [`references/finish.md`](references/finish.md).
+**Every build:** [`references/typography.md`](references/typography.md) · [`references/color.md`](references/color.md) · [`references/layout-and-space.md`](references/layout-and-space.md) · [`references/motion.md`](references/motion.md) · [`references/copy.md`](references/copy.md) · [`references/anti-patterns.md`](references/anti-patterns.md) · [`references/section-entry.md`](references/section-entry.md) · [`references/finish.md`](references/finish.md).
**Conditionally (be honest, no defensive pre-loads):** [`references/microinteractions.md`](references/microinteractions.md) when anything is interactive (most pages); [`references/interaction-and-states.md`](references/interaction-and-states.md) for stateful UI; [`references/responsive.md`](references/responsive.md) when mobile is in scope; [`references/structure.md`](references/structure.md) only when deviating from a named macrostructure; [`references/assets.md`](references/assets.md) only when an enrichment needs an external asset; [`references/texture.md`](references/texture.md) only when the picked theme earns texture (Riso, Carnival, Arcade, faint Newsprint) or a custom draw has print lineage; [`references/scroll-choreography.md`](references/scroll-choreography.md) only when the brief asks for scroll story / cinematic pacing or the macro is Feature-stack / Narrative Workflow; [`references/dark-mode.md`](references/dark-mode.md) only when the user asks for both modes; [`references/data-viz.md`](references/data-viz.md) when the brief involves charts / data / dashboards or the macro is Stat-Led / Workbench; [`references/brand-truth.md`](references/brand-truth.md) when the brief names a real brand or company to build for; [`references/custom-theme.md`](references/custom-theme.md) only on the custom route; [`references/design-md.md`](references/design-md.md) only when the user asks to lock the system; [`references/preview-examples.md`](references/preview-examples.md) only if the Step 5 spec is not scaffolding enough.
@@ -264,13 +273,13 @@ Then run the image-need table at [`references/hero-enrichment.md` § Image-need
- **Enrichment** · none (typography only)
- **Sections** · Hero · Logos · Stats · Features · Pricing · FAQ · CTA · Footer
- **Motion** · counter · pricing-lift · pulse-once
-- **Slop test** · 58 / 58 ✓ (run after Build)
+- **Slop test** · Floor 34/34 ✓ · Reflex 18 · Finish clean (run after Build)
- **Diversification** · differs from Newsprint on paper band + display style
```
Custom builds add two bullets: `**Direction** · <name> (draw n/7, wildcard yes/no)` and `**Posture** · <Restrained | Committed | Full palette | Drenched>`. Any page may add `**Signature** · <the one move>`.
-The Slop test row must reflect the real Step 7 outcome; a fabricated `58 / 58` is itself slop. If gates fail at Step 7, fix and emit a **one-line delta** (`Slop test · 58/58 after 2 fixes: gates 41, 44`), not the whole block again.
+The Slop test row must reflect the real Step 7 outcome; a fabricated `Floor 34/34` is itself slop. Any waived Reflex gate is named in the row (`Reflex 18 (1 waived: 23)`). If gates fail at Step 7, fix and emit a **one-line delta** (`Slop test · Floor 34/34 after 2 fixes: gates 41, 44`), not the whole block again.
**Then one quiet CTA line** (skip for component scope, or when `design.md` already exists):
@@ -281,12 +290,12 @@ The Slop test row must reflect the real Step 7 outcome; a fabricated `58 / 58` i
Emit code that satisfies the tone and the structural fingerprint. Match code complexity to tone ambition. Always:
- **Hero headline sized to copy length.** Self-written headlines aim for <= 7 words and <= 50 chars. Longer: apply the brackets in [`references/typography.md` § Hero headline sizing](references/typography.md); aggressive display themes step down one rung past 50 chars.
-- **Section eyebrows default OFF.** No `01 · THE TOUR` kickers unless the user asked for numbering or the macrostructure is genuinely ordinal (cap 1-2 even then). When used, the tag stacks ABOVE the heading in the same column; tag-beside-heading is gate 54's auto-fail.
+- **No eyebrows, ever.** `01 · THE TOUR`, `FEATURES`, `INTRODUCING`: banned in every geometry, and no brief earns one back. When a section genuinely needs ordering, use a real `<ol>` with `counter()` or set the numeral at graphic scale. [`references/section-entry.md`](references/section-entry.md) carries twelve other ways in; picking one is part of the build, not an afterthought.
- OKLCH for every colour; tokens as custom properties at `:root`; a 4pt spacing scale with semantic names.
- A distinctive display face + refined body face (single-font pages only when the single font IS the design).
- Eight states for every interactive element; animate `transform` / `opacity` only; the three named easings, never `ease`, never bounce on UI state; `prefers-reduced-motion` support; instant `:focus-visible` ring at >= 3:1.
- Microinteraction recipes per [`references/microinteractions.md`](references/microinteractions.md): silent success over toasts, optimistic + Undo over confirms, 800ms hover / 0ms focus tooltips. Cut motion before adding it.
-- **Stamp the output.** Canonical top-of-file order: line 1 the macrostructure stamp `/* Hallmark · macrostructure: <name> · tone: <tone> · anchor hue: <hue> · hero: <Posture>/<H#> */` plus the nav / footer / contrast / mobile records the gates ask for; line 2 the pre-emit critique comment; then (custom only) the direction contract block. Custom and studied-DNA stamps carry their extended fields per [`references/custom-theme.md`](references/custom-theme.md) § E and the output contract in [`references/study.md`](references/study.md).
+- **Stamp the output.** Canonical top-of-file order: line 1 the macrostructure stamp `/* Hallmark · macrostructure: <name> · tone: <tone> · anchor hue: <hue> · hero: <Posture>/<H#> */` plus the nav / footer / contrast / mobile records the gates ask for; line 2 the pre-emit critique comment; then any `waive` lines (`/* Hallmark · waive <gate> · <guard evidence> · <reason> */`, at most three, syntax and caps in [`references/slop-test.md`](references/slop-test.md) § Waivers); then (custom only) the direction contract block. Everything the linter reads sits in the first 40 lines of CSS, so keep the block together at the top. Custom and studied-DNA stamps carry their extended fields per [`references/custom-theme.md`](references/custom-theme.md) § E and the output contract in [`references/study.md`](references/study.md).
- **Append to project memory:** update `.hallmark/log.json` (schema in Step 2), newest first, trimmed to 20. Create `.hallmark/` if needed; respect any existing `.gitignore`.
- **Never clobber an existing global stylesheet.** Entry stylesheets (`app/globals.css`, `src/index.css`, `src/styles/global.css`) are **append-only**: keep `@tailwind` / `@import "tailwindcss"` directives in place, add Hallmark's `:root` block and base rules below them, keep any new `@import` at the very top above all rules, and reuse the project's own token names (`--background`, `--foreground`, a Tailwind `@theme`) where they exist. Full rewrite only on explicit request: silently removing a framework's CSS entry directives un-styles the entire app. See [`references/contract.md`](references/contract.md).
- **Always emit `tokens.css`** at the project root with every `--color-*`, `--font-*`, `--space-*`, `--text-*`, `--ease-*`, `--dur-*`, `--rule-*`, and `--radius-*` token used, imported by the page CSS (or included by the project's entry point). Even single-page builds. On `design.md` projects, also refresh the `## Exports` section with all four formats (tokens.css, Tailwind v4 `@theme`, DTCG `tokens.json`, shadcn/ui variables) per [`references/export-formats.md`](references/export-formats.md).
@@ -299,9 +308,9 @@ Emit code that satisfies the tone and the structural fingerprint. Match code com
1. If Node is available: `node <skill-dir>/scripts/sloplint.mjs <output files> --genre <genre>` (add `--scope component` on component emits). Fix every FAIL, re-run until clean.
2. Load [`references/slop-test.md`](references/slop-test.md) (now, not earlier) and walk the gates tagged **J** and **R/J**, plus the judged halves of **M/R** gates when `--render` did not run; confirm or dismiss every sloplint WARN. Genre-scoped exceptions are noted inline per gate.
-3. No Node, or a `.tsx`-only emit the script cannot scan: walk all 58 manually (Core-15 for components).
+3. No Node, or a `.tsx`-only emit the script cannot scan: walk all 58 manually, Floor first (the component sweep for components).
-Component scope runs the Core-15 sweep named in `slop-test.md`. Update the preview's Slop test row with the real outcome. If any gate fails, fix it. Do not ship slop.
+Component scope runs the component sweep named in `slop-test.md`. Update the preview's Slop test row with the real outcome. Fix every open Floor finding; fix or waive every Reflex one. Do not ship slop.
**Verification is budgeted.** One batched inspection round (desktop 1280x800 AND mobile 375 together; `--render` on the sloplint call when Chrome is available), one batch of fixes, at most one confirming round, then stop polishing. Endless single-issue re-render loops are their own failure mode.
@@ -315,7 +324,7 @@ Triggers: the user passes `--fast` / says "fast", or the brief itself says quick
Behaviour: `--fast` counts as "go ahead" at the Step 1 gate (infer + one-line disclosure); total narration caps at three lines (inference line · Picks block · done line); the preview emits once with no CTA line and no re-emit; the pre-flight cache is reused silently.
-Not relaxed: all 58 gates, the stamp, `tokens.css`, the log append, contrast checks. Fast mode cuts ceremony, never quality.
+Not relaxed: **the Floor**, the stamp, `tokens.css`, the log append, contrast checks. Fast mode may waive Reflex gates without the three-per-artifact cap, and skips the Finish tier. It cuts ceremony and argument, never the Floor.
---
diff --git a/skills/hallmark/references/anti-patterns.md b/skills/hallmark/references/anti-patterns.md
index cce716f..0da1b5e 100644
--- a/skills/hallmark/references/anti-patterns.md
+++ b/skills/hallmark/references/anti-patterns.md
@@ -1,120 +1,161 @@
# Anti-patterns - the named tells
-Read this list before emitting anything: these are the named tells of AI-generated UI, and you do not reach for them.
+Read this list before emitting anything: these are the named tells of AI-generated UI.
Enforcement details, genre overrides, and full fixes live in [slop-test.md](slop-test.md); "(gate N)" cites its gates.
-`hallmark audit` reports findings by these exact names, graded Critical / Major / Micro by how reliably the tell reads as AI.
-## Critical
+
+The three groups here are the three **tiers**, and they say how hard each one binds:
+
+- **The Floor** - never done, never waivable. Fix it.
+- **Reflexes** - the defaults a model falls into. A build with a real reason can waive one on the record (slop-test.md § Waivers); a build without one fixes it.
+- **Finish** - craft detail, invisible at arm's length. Read and answer; never blocks a ship.
+
+`hallmark audit` reports findings by these exact names and maps the tiers to reader-facing severities: Floor to `critical`, Reflex to `major`, Finish to `minor`, and a Reflex gate already waived in the audited output to `noted`.
+
+## The Floor
+
### The purple-gradient hero
-Purple-to-blue or purple-to-pink hero background. Fix: one anchor hue, no gradient hero backgrounds. (gate 2)
+Purple-to-blue or purple-to-pink hero background. Fix: one anchor hue, no gradient hero backgrounds. (gate 2a)
+### The gradient headline
+`background-clip: text` gradient fill on a headline in the purple-blue family. Fix: solid ink; use weight or a display face. (gate 2a)
+### Card-in-card
+Cards nested inside bordered containers. Fix: keep one containment layer. (gate 4)
+### The `vh` hero
+`min-height: 100vh` sizes past the fold on every phone, because `vh` ignores browser chrome. Fix: `dvh` or `svh`. (gate 6a)
+### Sound-on autoplay
+A hero video shipped without `muted`. Fix: `<video autoplay muted loop playsinline>`, always all four. (gate 28a)
+### Lazy-loaded LCP
+`loading="lazy"` on the hero image or video. Fix: `fetchpriority="high"`; lazy-load below the fold only. (gate 28a)
+### Italic emphasis word in a heading
+One italicised word inside an otherwise roman headline. Fix: weight, accent colour, a drawn underline, or a line break. (gate 38a-i)
+### The eyebrow
+Short inert type before a heading that announces the heading: `01 · THE TOUR`, `FEATURES`, an inert badge pill. Banned in every geometry. Fix: open the section another way ([section-entry.md](section-entry.md)). (gate 54)
+### Generic emoji as feature icon
+Sparkle or rocket emoji standing in for icons. Fix: one icon library, custom SVG, or typography. (gate 30a)
+### Invented metrics
+Numbers the user never supplied filling stats and proof bars. Fix: labelled placeholder, ask, or drop the slot. (gate 46a)
+### Re-drawn browser and OS chrome
+Fake browser bars with traffic-light dots, fake window title bars. Fix: real screenshots in `<figure>`. (gate 47a)
+### Mid-render token improvisation
+Inline colours or fonts outside the locked token block. Fix: every value through `var(--token)`; extend tokens first. (gate 48)
+### Wrapping button or nav link
+A CTA or primary nav label breaking onto two lines. Fix: shorten the label; `white-space: nowrap`. (gate 49a)
+### `transition-all`
+Every property animating, including instant ones. Fix: list the transitioned properties. (gate 10)
+### Animating layout
+Transitioning `width`, `height`, `top`, or `left`. Fix: `transform` and `opacity` only. (gate 14a)
+### Focus rings that animate in
+The ring fades in; keyboard users wait. Fix: focus rings appear instantly. (gate 15)
+### Missing focus-visible
+An interactive element with no `:focus-visible` style at all. Fix: ring at >= 3:1, instantly. (gate 26a)
+### Hover-only affordances
+Menus, buttons, or tooltips reachable only by hover. Fix: focus states plus tap access everywhere.
+### Tooltips with the same delay on hover and focus
+Both delayed 800ms. Fix: hover 800-1000ms, focus 0ms. (gate 17)
+### Auto-rotating carousels with no pause
+WCAG 2.2.2 failure. Fix: manual advance, or pause on hover and focus. (gate 18)
+### Placeholder names
+"Jane Doe", "John Smith", "Example User". Fix: plausible audience-fitting names, or a seeded faker. (gate 19)
+### Startup-cliché product names
+"Acme", "Nexus", "Pulse", "Unleash". Fix: concrete, domain-specific names. (gate 19)
+### 100vw widths
+`width: 100vw` breaks on scrollbar-visible desktops. Fix: `width: 100%` with container padding. (gate 34)
+### Cap collision on wrapped caps
+Uppercase display type at line-height below 1.0, on a head that wraps. Fix: line-height 1.0 floor. (gate 55a)
+
+## Reflexes
+
### Inter-everywhere
Inter, Roboto, or Open Sans as both display and body. Fix: pair a display face with a body face (typography.md). (gate 1)
### The 3-column feature grid
Three equal icon-above-heading columns. Fix: vary widths and heights, or drop the cards. (gate 3)
-### Card-in-card
-Cards nested inside bordered containers. Fix: keep one containment layer. (gate 4)
-### The gradient headline
-`background-clip: text` gradient fill on a headline. Fix: solid ink; use weight or a display face. (gate 2)
### The side-stripe card
Thick coloured border on one card edge. Fix: hairline all round, none, or an accent square. (gate 5)
-### Full-viewport centred hero
-`min-height: 100vh`, everything centred, one sentence, one CTA. Fix: content-height hero, biased alignment. (gate 6)
+### Centred everything
+The whole hero on one centred axis, then section after section of centred columns. Fix: bias the layout; break symmetry once. (gate 6b)
### Pure black, pure white
-`#000` or `#fff` as a base colour. Fix: tint neutrals toward the anchor hue (color.md). (gate 7)
+`#000` or `#fff` as a base colour. Fix: tint neutrals toward the anchor hue (color.md), or declare `surface: absolute` and mean it. (gate 7b)
### Default-attractor sameness
-Same macrostructure as the previous Hallmark output in the project. Fix: check the CSS stamp; pick differently (macrostructures.md). (gate 8)
+Same structure as the previous Hallmark output in the project. Fix: check the CSS stamp and the log; build differently. (gate 8)
+### Every section padded the same
+Identical rhythm on every section, no rule, no ornament, no colour shift. Fix: vary; tighten one, expand another. (gate 9)
+### Universal `hover:scale-105`
+Every card lifts identically on hover. Fix: one signal per element. (gate 11)
+### Bounce and elastic easing
+Buttons bounce in, icons wobble on hover. Fix: exponential ease-out (motion.md). (gate 12)
+### More than one hover effect at once
+Translate plus scale plus shadow plus colour on the same element. Fix: pick one. (gate 13)
+### Celebratory success toasts
+"Done!" for an effect the user already sees. Fix: silent success; toasts for failures only. (gate 16)
### Specimen fall-through
-Specimen macrostructure emitted without an editorial brief. Fix: pick from the first ten in macrostructures.md. (gate 21)
-### The AI nav
-Wordmark-left, inline links, CTA-right, sticky, hairline border-bottom. Fix: route via component-cookbook.md § Navigation. (gate 42)
-### The AI footer
-Four link columns, social-icon row, copyright tail. Fix: route via component-cookbook.md § Footers. (gate 43)
+Specimen structure emitted without an editorial brief. Fix: build the shape this brief wants. (gate 21)
+### Flat grey neutrals
+Zero-chroma neutrals on a page with an anchor hue. Fix: tint toward the hue, minimum 0.005 chroma. (gate 22)
+### Accent flood
+The accent past ~5% of a viewport with no declared colour posture. Fix: retreat, or declare the posture. (gate 23)
+### Off-scale spacing
+`padding: 17px` and friends outside the named scale. Fix: use the scale; keep optical nudges to three. (gate 24b)
### Aurora-blob background
Purple-pink-cyan mesh blobs behind hero text. Fix: solid surface, or subtle gradient plus grain. (gate 29)
+### Mismatched icon sets
+Two or more icon libraries mixed on one page. Fix: one library per project (assets.md). (gate 30b)
+### Four type families
+Display plus body plus mono plus a wordmark face, unnamed. Fix: three, or bind the fourth to its own token. (gate 37)
+### Italic display face
+An italic heading system. Fix: keep it if it IS the system, on a real italic with `font-synthesis: none`. (gate 38a-ii)
+### The AI nav
+Wordmark-left, inline links, CTA-right, sticky, hairline border-bottom, arrived at by reflex. Fix: decide it and name it in the stamp. (gate 42)
+### The AI footer
+Four link columns, social-icon row, copyright tail, arrived at by reflex. Fix: decide it and name it in the stamp. (gate 43)
+### Symmetric hero padding
+Equal padding top and bottom on a hero that is not a poster. Fix: bottom-heavy, so the hero sits into the page. (gate 44a)
### Floating-orb decoration
Blurred spheres drifting behind the hero "for depth". Fix: cut them; anchor the hero typographically. (gate 45)
-### Sound-on autoplay
-A hero video shipped without `muted`. Fix: `<video autoplay muted loop playsinline>`, always all four. (gate 28)
-### Lazy-loaded LCP
-`loading="lazy"` on the hero image or video. Fix: `fetchpriority="high"`; lazy-load below the fold only. (gate 28)
-## Major
-### Bounce and elastic easing
-Buttons bounce in, icons wobble on hover. Fix: exponential ease-out (motion.md). (gate 12)
-### Centred everything
-Section after section of centred columns. Fix: bias the layout; break symmetry once. (gate 6)
-### Italic headers
-An italic emphasis word, or an all-italic display face, in headings. Fix: roman headers; emphasis via weight or accent. (gate 38a)
-### Eyebrow on every section
-Mono-cap eyebrow labels above (or beside) every heading; default OFF. Fix: zero eyebrows unless genuinely ordinal; never tag-left/header-right. (gate 54)
+### Bare-number hero
+A giant figure as the hero's only headline. Fix: pair it with a line that says what it means. (gate 46b)
+### Re-drawn device and terminal frames
+Phone bezels and terminal chrome around mocked-up content. Fix: one frame, real content inside, or none. (gate 47b)
### Shadow-glow on dark
Soft coloured halo box-shadow on a dark surface. Fix: elevate via lightness, not shadow.
### Icon-tile feature card
Icon in a coloured square, heading, two lines, "Learn more". Fix: asymmetric sizes, inline icons, or none. (gate 3)
### Glassmorphism without purpose
Frosted-glass panels as decoration. Fix: glass only when it communicates overlay depth.
-### Hover-only affordances
-Menus, buttons, or tooltips reachable only by hover. Fix: focus states plus tap access everywhere.
-### Tabular data without tabular-nums
-Columns of figures misaligned by proportional numerals. Fix: `font-variant-numeric: tabular-nums`.
-### Animate-on-scroll on everything
-Every section fades in, every list staggers. Fix: one orchestrated entrance only.
-### Mismatched icon sets
-Two or more icon libraries mixed on one page. Fix: one library per project (assets.md). (gate 30)
### AI-illustration look
Mesh-blob characters, corporate-doodle humans, raw generated art. Fix: hand-build in CSS or SVG (hero-enrichment.md).
-### Invented metrics
-Numbers the user never supplied filling stats and proof bars. Fix: labelled placeholder, ask, or drop the slot. (gate 46)
-### Generic emoji as feature icon
-Sparkle or rocket emoji standing in for icons. Fix: one icon library, custom SVG, or typography. (gate 30)
-### Re-drawn UI chrome
-Fake browser bars, phone frames, window-chrome code blocks. Fix: real screenshots in `<figure>`; typographic code frames. (gate 47) Arcade carve-out: pixel type, scanlines, starfield, and a cursor are fine (they re-draw no UI); fake OS windows / title bars / traffic-light dots stay banned even there.
-### Mid-render token improvisation
-Inline colours or fonts outside the locked token block. Fix: every value through `var(--token)`; extend tokens first. (gate 48)
-### Wrap-to-two-lines clickable text
-Button, nav, or CTA labels wrapping at narrow widths. Fix: shorten the label; `white-space: nowrap`. (gate 49)
-### Lottie shortcut
-A community Lottie for jobs CSS or SVG does lighter. Fix: build it custom; Lottie is last resort. (gate 31)
### Three.js for a still object
WebGL for a non-interactive spinning thing. Fix: still photograph or hand-built SVG.
-## Micro
-### `transition-all`
-Every property animating, including instant ones. Fix: list the transitioned properties. (gate 10)
-### Universal `hover:scale-105`
-Every card lifts identically on hover. Fix: one signal per element. (gate 11)
-### Bouncy overshoot easings on UI
-Overshoot cubic-beziers on buttons, modals, tooltips. Fix: reserve overshoot for physical interactions. (gate 12)
### Animated hover gradients
Background gradient slides through colour space on hover. Fix: cut, or one instant colour shift.
### Cursor follower dots
A trailing dot lagging the pointer. Fix: cut.
-### Auto-rotating carousels with no pause
-WCAG 2.2.2 failure. Fix: manual advance, or pause on hover and focus. (gate 18)
-### Celebratory success toasts
-"Done!" for an effect the user already sees. Fix: silent success; toasts for failures only. (gate 16)
### Confirmation dialogs for reversible actions
"Are you sure?" before a one-row delete. Fix: optimistic action plus Undo toast.
-### Tooltips with the same delay on hover and focus
-Both delayed 800ms. Fix: hover 800-1000ms, focus 0ms. (gate 17)
-### Focus rings that animate in
-The ring fades in; keyboard users wait. Fix: focus rings appear instantly. (gate 15)
### Toasts that shift layout
A new toast pushes content down. Fix: fixed stack at a viewport corner.
-### Universal scroll-triggered fade-up
-Every section fades in on intersection. Fix: one entrance on first load.
-### Spinners that flash
-A spinner visible 50ms on a fast action. Fix: delay-show 150ms, or minimum 300ms visible.
+### Animate-on-scroll on everything
+Every section fades in, every list staggers. Fix: one orchestrated entrance only.
+### `z-index: 9999`
+Arbitrary large z-values. Fix: the six-level named scale (layout-and-space.md).
+
+## Finish
+
+### Lottie shortcut
+A community Lottie for jobs CSS or SVG does lighter. Fix: build it custom; Lottie is last resort. (gate 31)
+### Highlighter bands at the baseline
+A `<mark>` gradient sitting under the text instead of behind the x-height. Fix: stops at ~38% and ~92%. (gate 35)
+### Flex rows not vertically centred
+A button taller than its sibling text, inheriting `align-items: stretch`. Fix: `align-items: center`. (gate 36)
+### Outlier face in three slots
+The third register becomes a third body font. Fix: collapse it back. (gate 38)
+### Tabular data without tabular-nums
+Columns of figures misaligned by proportional numerals. Fix: `font-variant-numeric: tabular-nums`. (F6)
### Straight quotes
-Straight `"` and `'` in rendered text. Fix: curly quotes and apostrophes.
+Straight `"` and `'` in rendered text. Fix: curly quotes and apostrophes. (F1)
+### Three periods instead of ellipsis
+`...` in body copy. Fix: the ellipsis character (U+2026). (F2)
### Double-hyphen dashes
`--` in body copy where a dash belongs. Fix: a true em dash (U+2014).
-### Three periods instead of ellipsis
-`...` in body copy. Fix: the ellipsis character (U+2026).
-### Placeholder names
-"Jane Doe", "John Smith", "Example User". Fix: plausible audience-fitting names, or a seeded faker. (gate 19)
-### Startup-cliché product names
-"Acme", "Nexus", "Pulse", "Unleash". Fix: concrete, domain-specific names. (gate 19)
-### `z-index: 9999`
-Arbitrary large z-values. Fix: the six-level named scale (layout-and-space.md).
-### Every section padded the same
-Identical padding on every section. Fix: vary; tighten one, expand another. (gate 9)
-### 100vw widths
-`width: 100vw` breaks on scrollbar-visible desktops. Fix: `width: 100%` with container padding. (gate 34)
+### Spinners that flash
+A spinner visible 50ms on a fast action. Fix: delay-show 150ms, or minimum 300ms visible.
+### Collapsing helper-text slot
+The error message pushes the page down when it appears. Fix: reserve `min-height: 1lh`. (gate 39c)
diff --git a/skills/hallmark/references/component-cookbook.md b/skills/hallmark/references/component-cookbook.md
index 0b7ef5d..2ee832a 100644
--- a/skills/hallmark/references/component-cookbook.md
+++ b/skills/hallmark/references/component-cookbook.md
@@ -26,7 +26,9 @@ The same macrostructure (e.g., Bento Grid) can be built from many different comb
### Section heads
-- **S1 · Stacked numbered** — The section number stacks directly above the heading, same column (the old side-column form is gate 54's auto-fail). [`components/s1-left-margin-numbered.md`](components/s1-left-margin-numbered.md)
+**Read [`section-entry.md`](section-entry.md) before picking one.** Eyebrows are banned (gate 54), so how a section opens is a design decision now, not a default. These five are the structural shells; that file is the twelve ways in.
+
+- **S1 · Ordinal by structure** — A genuinely ordered run numbered by `<ol>` + `counter()`, never by a label typed above the heading. [`components/s1-left-margin-numbered.md`](components/s1-left-margin-numbered.md)
- **S2 · Hanging** — Heading floats above the section in negative space; no border, no rule. [`components/s2-hanging.md`](components/s2-hanging.md)
- **S3 · Sticky pinned** — Heading remains in viewport while content scrolls beneath. Orientation aid. [`components/s3-sticky-pinned.md`](components/s3-sticky-pinned.md)
- **S4 · Inline no break** — The heading is a small caps phrase that emerges *inside* the body flow; no spatial break. [`components/s4-inline-no-break.md`](components/s4-inline-no-break.md)
diff --git a/skills/hallmark/references/components/f4-step-sequence.md b/skills/hallmark/references/components/f4-step-sequence.md
index e273997..3dcd665 100644
--- a/skills/hallmark/references/components/f4-step-sequence.md
+++ b/skills/hallmark/references/components/f4-step-sequence.md
@@ -3,18 +3,29 @@ Numbered stages (`1.0 → 2.0 → 3.0`) flow vertically. Each stage has a headin
*Use when:* the product is a workflow, not a single moment.
*Don't confuse with:* F2 Sticky-scroll (which doesn't number stages).
+The stage numbers come from `counter()`, never from a typed `<span>` beside the heading: a hand-typed `1.0` above an `<h3>` is an eyebrow at card scale (gate 54), and it makes screen readers announce the number twice.
+
```html
<ol class="steps">
- <li><span class="stage">1.0</span><h3>Intake.</h3><p>…</p></li>
- <li><span class="stage">2.0</span><h3>Plan.</h3><p>…</p></li>
+ <li><h3>Intake.</h3><p>…</p></li>
+ <li><h3>Plan.</h3><p>…</p></li>
</ol>
```
+```css
+.steps { list-style: none; counter-reset: stage; padding: 0; }
+.steps > li { counter-increment: stage; }
+.steps > li > h3::before {
+ content: counter(stage) ".0";
+ font-family: var(--font-mono); color: var(--color-muted);
+ margin-inline-end: var(--space-2xs);
+}
+```
## Knobs
Vary at least one knob vs the last logged use of this archetype (gate 32):
-- Numbering: I/II/III · 01/02/03 · 1.0/2.0/3.0
+- Numbering: `upper-roman` · `decimal-leading-zero` · `counter(stage) ".0"`
- Layout: vertical stack · horizontal flow · diagonal
- Connector: line · arrow · none
diff --git a/skills/hallmark/references/components/h9-custom-illustration-centerpiece.md b/skills/hallmark/references/components/h9-custom-illustration-centerpiece.md
index 74d1e3f..c4cf023 100644
--- a/skills/hallmark/references/components/h9-custom-illustration-centerpiece.md
+++ b/skills/hallmark/references/components/h9-custom-illustration-centerpiece.md
@@ -8,9 +8,9 @@ The illustration itself is *built*, not picked from Storyset / Humaaans / unDraw
```html
<section class="hero-art">
<div>
- <p class="eyebrow">Maple Street Bread · est. 2026</p>
<h1>Sourdough, every morning.</h1>
<p>Slow-fermented overnight, baked on stone, before you wake.</p>
+ <p class="hero__mark">Maple Street Bread, est. 2026</p>
</div>
<svg viewBox="0 0 200 100" class="loaf" aria-label="A loaf of bread">
<path class="loaf__body" d="M 20 70 Q 100 10 180 70 L 180 90 L 20 90 Z" />
diff --git a/skills/hallmark/references/components/s1-left-margin-numbered.md b/skills/hallmark/references/components/s1-left-margin-numbered.md
index 302920e..a8c6647 100644
--- a/skills/hallmark/references/components/s1-left-margin-numbered.md
+++ b/skills/hallmark/references/components/s1-left-margin-numbered.md
@@ -1,30 +1,46 @@
-### S1 · Stacked numbered
-The section number sits directly ABOVE the heading, same column, vertical stack; the ordinal energy comes from type contrast (mono number vs display heading), not from a side column. Gate 54 bans the old tag-left / heading-right two-column head outright; this is the compliant form of the numbered editorial section.
-*Use when:* the page is editorial / specimen AND the content is genuinely ordinal (chapters, steps, issues). Numbering is default-OFF elsewhere; cap 1-2 per page.
-*Don't confuse with:* S5 Bottom-anchored (which puts the label *under* the section).
+### S1 · Ordinal by structure
+When a run of sections is genuinely ordered, the order comes from the markup or from a numeral built at graphic scale, never from a small label typed above the heading. The old form of this archetype (`01 — Foundations` stacked over an `<h2>`) is an eyebrow and gate 54 bans it outright.
+*Use when:* the content is truly sequential (chapters, steps, issues, a run of numbered work). Not for "the third section on the page", which is not an ordinal, just a position.
+*Don't confuse with:* S5 Bottom-anchored (label *under* the section); [`../enrichment/hp4-decorative-numeral.md`](../enrichment/hp4-decorative-numeral.md) (one numeral, hero scale, not a run).
+
+Sequence carried by the list element, so the numbers are real and screen readers do not hear them twice:
```html
-<header class="head-numbered">
- <p class="num-label">01 — Foundations</p>
- <h2>…</h2>
-</header>
+<ol class="chapters">
+ <li>
+ <h2>Foundations</h2>
+ <p>…</p>
+ </li>
+ <li>
+ <h2>The crossing</h2>
+ <p>…</p>
+ </li>
+</ol>
```
```css
-.head-numbered { display: flex; flex-direction: column; gap: var(--space-2xs); }
-.head-numbered .num-label { font-family: var(--font-mono); font-size: var(--text-xs); color: var(--color-muted); letter-spacing: 0.06em; }
+.chapters { list-style: none; counter-reset: chapter; padding: 0; }
+.chapters > li { counter-increment: chapter; }
+.chapters > li > h2::before {
+ content: counter(chapter, decimal-leading-zero);
+ font-family: var(--font-mono); font-size: var(--text-xs);
+ color: var(--color-muted); letter-spacing: 0.06em;
+ display: block; margin-block-end: var(--space-2xs);
+}
```
+The `::before` is a generated ordinal on the heading itself, not a sibling element: nothing to mistake for a kicker, nothing to delete later.
+
*Mobile:* already single-column; nothing collapses.
## Knobs
Vary at least one knob vs the last logged use of this archetype (gate 32):
-- Number style: `01 —` label · bare `01` · `No. 4`
-- Density: cap 1-2 per page
-- Label ink: muted · accent-tick
+- Ordinal form: `decimal-leading-zero` · `upper-roman` · `lower-alpha` · none (a rule instead)
+- Ordinal position: above the heading · hung in the margin (`position: absolute` off the list) · inline before the first word
+- Ordinal weight: muted mono · accent-tick · display-scale numeral (then read hp4's discipline first)
## Mobile collapse
-- **Below 60rem:** unchanged (already a single-column stack)
+- **Below 60rem:** unchanged (already a single-column stack). A margin-hung ordinal returns to flow above the heading.
- **Below 40rem:** unchanged
diff --git a/skills/hallmark/references/components/s3-sticky-pinned.md b/skills/hallmark/references/components/s3-sticky-pinned.md
index ff45242..8144e4b 100644
--- a/skills/hallmark/references/components/s3-sticky-pinned.md
+++ b/skills/hallmark/references/components/s3-sticky-pinned.md
@@ -1,11 +1,10 @@
### S3 · Sticky pinned
Heading remains in viewport while content scrolls beneath. Orientation aid.
-*Use when:* the section is dense and the user benefits from always seeing where they are.
-*Don't confuse with:* S1 Left-margin (which doesn't move).
+*Use when:* the section is dense and the user benefits from always seeing where they are. The persistence is itself an opening move: nothing needs to introduce a heading that never leaves ([`../section-entry.md`](../section-entry.md) § 12).
+*Don't confuse with:* S1 Ordinal by structure (which doesn't move).
```html
<header class="head-sticky">
- <p class="num-label">02</p>
<h2>…</h2>
</header>
```
@@ -24,7 +23,7 @@ Vary at least one knob vs the last logged use of this archetype (gate 32):
- Offset: `--banner-height` dock · 0 (no sticky nav)
- Border-bottom: hairline · ink 1px
-- Label: with number · heading only
+- Dock behaviour: pinned throughout · released at the section's end
## Mobile collapse
diff --git a/skills/hallmark/references/components/s5-bottom-anchored.md b/skills/hallmark/references/components/s5-bottom-anchored.md
index b96fc74..e0f2ece 100644
--- a/skills/hallmark/references/components/s5-bottom-anchored.md
+++ b/skills/hallmark/references/components/s5-bottom-anchored.md
@@ -1,12 +1,12 @@
### S5 · Bottom-anchored
The label or heading sits *below* the section's content. Inverts hierarchy.
-*Use when:* the content is the primary act and the label is a footer to it.
-*Don't confuse with:* S1 Left-margin (which leads with the label).
+*Use when:* the content is the primary act and the label is a footer to it. Legal under gate 54 precisely because it comes *after*: order is the discriminator between a caption and a kicker.
+*Don't confuse with:* S1 Ordinal by structure (which carries the sequence in the markup).
```html
<section>
<div class="content">…</div>
- <p class="num-label">— end of 02</p>
+ <p class="section__colophon">— end of 02</p>
</section>
```
diff --git a/skills/hallmark/references/copy.md b/skills/hallmark/references/copy.md
index eaca077..59b94b5 100644
--- a/skills/hallmark/references/copy.md
+++ b/skills/hallmark/references/copy.md
@@ -112,6 +112,8 @@ Three voice patterns: *poetic restraint*, *passion via enumeration*, *vulnerabil
Three voice patterns: *spec-embedded prose*, *measured language*, *data-first opening*.
+**The numbers in these samples belong to the sites they were taken from.** Copy the shape, never the figure: an unsourced number on your page is gate 46a, whatever it was modelled on.
+
- *"The 14-inch MacBook Pro with M5 brings serious speed and advanced on-device AI to the personal, professional, and creative work you do every day."* — apple.com — spec embedded in prose; "serious speed" is measured language
- *"434 total posts. New CSS you feel like you could use today."* — nerdy.dev (Adam Argyle) — data-first; "feel like" suggests genuine utility
- *"$ streampipe parse access.log --filter status=5xx | jq"* — Streampipe (test 02) — open on a real command, not a marketing claim
diff --git a/skills/hallmark/references/enrichment/hero-discipline.md b/skills/hallmark/references/enrichment/hero-discipline.md
index 758eea3..ae1e07b 100644
--- a/skills/hallmark/references/enrichment/hero-discipline.md
+++ b/skills/hallmark/references/enrichment/hero-discipline.md
@@ -4,15 +4,15 @@ Load this file for EVERY page hero, enriched or not: the posture below is picked
## Hero postures - pick one, stamp it
-The posture sets the hero's geometry envelope. **Settled is the neutral default**; every other posture is opt-in, named in the Picks block, the CSS stamp (`· hero: <Posture>/<H#>`), and the log. Gate 44 reads the posture from the stamp (no field = Settled). Fold-fit at 1280x800 and the two-centred-elements ceiling (gate 6) bind on all six. Rotation lives in SKILL.md § Rotation.
+The posture sets the hero's geometry envelope. **The height band is guidance, not a cap:** it describes what the posture usually needs, and content that genuinely needs more room overshoots it and says so in the stamp. Only gate 44a's padding ratio and gate 44b's fold fit actually bind. **Settled is the neutral default**; every other posture is opt-in, named in the Picks block, the CSS stamp (`· hero: <Posture>/<H#>`), and the log. Gate 44 reads the posture from the stamp (no field = Settled). Fold-fit at 1280x800 and the two-centred-elements ceiling (gate 6) bind on all six. Rotation lives in SKILL.md § Rotation.
-| Posture | Character | Min-height | Padding rule | Alignment | Pairs with | Genre affinity |
+| Posture | Character | Height band | Padding rule | Alignment | Pairs with | Genre affinity |
| --- | --- | --- | --- | --- | --- | --- |
| **Settled** | balanced fold; sits into the page | `clamp(60vh, 75dvh, 88dvh)` (70-90% of viewport) | block-end >= 1.3x block-start | <= 2 centred | any H1-H9 | any (default) |
| **Banner** | compressed opener; the page starts fast | 40-55dvh (cap ~`min(52dvh, 34rem)`) | block-end >= 1.3x block-start | 0-1 centred, edge-led | H1 (short), H4, H5 | reference / docs / utility (Almanac, Ledger, Grid, Cobalt) |
| **Poster** | full-bleed canvas; the fold IS the artwork | 92-100dvh (100dvh legal only here) | waived when content is edge/corner-anchored, else 1.3x | centred only under gate 6's genre carve-outs | H1, H6 | atmospheric · playful-canvas · Manifesto / Sport |
| **Ledge** | tall top void; content rests at the base | 70-88dvh | inverted: block-start >= 2x block-end, content `align-content: end` | <= 1 centred | H1, H4, H6 | sport · brutal · manifesto · photographic |
-| **Corridor** | tall centred reading column | 66-85dvh | block-end >= 1.3x block-start | centred column <= 44ch; eyebrow OR CTA off-axis | H3, H5, H1 | editorial · atelier (gate 6 centred-narrow rule) |
+| **Corridor** | tall centred reading column | 66-85dvh | block-end >= 1.3x block-start | centred column <= 44ch; one element off-axis | H3, H5, H1 | editorial · atelier (gate 6 centred-narrow rule) |
| **Stage** | text column + full-height visual that may bleed | 70-92dvh | 1.3x on the text column; visual may touch the hero's edges | <= 1 centred | H2, H7, H8 | modern-minimal · playful product |
Mobile (< 48rem): every posture collapses to content height (`min-height: auto` or <= 60dvh); Poster may stay full-bleed. Fold-fit (gate 44b) is posture-independent: at 1280x800 the essential content is complete without scrolling on every posture, including Ledge (content bottom = hero bottom minus block-end padding, and the hero itself stays <= 88dvh) and Poster (content anchored inside the first 800px).
@@ -21,11 +21,11 @@ Mobile (< 48rem): every posture collapses to content height (`min-height: auto`
These bind on every hero, whatever the posture.
-- **Fit the fold — content, not just the box.** The posture caps the hero's *height*; this caps its *content*. On a 13″ laptop (~800 px tall) the eyebrow + headline + lede + primary CTA must all be visible **without scrolling**. When they aren't, it's almost always wasted vertical space — an oversized display `clamp()` max, display line-height near 1.2, a 3-line lede, or `padding-block` bloat. Pull the clamp max down, set display line-height 1.0–1.1, hold the lede to ~2 lines, trim the padding. **Right-size, don't cramp** — a hero that already fits needs no shrinking, and this never means tiny type or no whitespace. Slop-test gate 44 enforces this.
+- **Fit the fold — content, not just the box.** The posture describes the hero's *height*; this binds its *content*. On a 13″ laptop (~800 px tall) the headline, lede, primary CTA, and any visual's focal point must all be visible **without scrolling**. When they aren't, it's almost always wasted vertical space — an oversized display `clamp()` max, display line-height near 1.2, a 3-line lede, or `padding-block` bloat. Pull the clamp max down, set display line-height at the tight end of the range owned by [`typography.md`](../typography.md) § Display line-height, hold the lede to ~2 lines, trim the padding. **Right-size, don't cramp** — a hero that already fits needs no shrinking, and this never means tiny type or no whitespace. Slop-test gate 44 enforces this.
- **Padding per posture.** The posture table above owns the padding rule (1.3x bottom-heavy on most, inverted on Ledge, waived on an anchored Poster). Symmetric padding on a Settled/Banner/Corridor/Stage hero floats off the page; gate 44 reads the stamped posture and enforces the matching rule.
-- **Never centre everything.** Eyebrow + title + lede + CTA all stacked centred is the AI fingerprint. Pick at most *two* centred elements; break alignment for the others. Gate 6 enforces this. Centred-narrow heroes are admissible only when the genre is editorial / atelier *and* the eyebrow or CTA breaks alignment.
-- **Entrance animation.** Pick one of {fade, sweep, none} per element — never both fade *and* sweep on the same element. Duration ≤ 220 ms. Disable on `prefers-reduced-motion: reduce`. Cross-reference the "One orchestrated reveal per page" rule below.
-- **Headline typography.** Prefer one display weight + tight tracking (-0.02em to -0.04em) over default 0; line-height 0.95–1.05 for display, never 1.2 (which inherits the body line-height and reads as un-set type). Avoid two display weights on the same headline (a `<strong>` in a different weight inside the title is AI's idea of "emphasis"; pick one weight, let the words carry).
+- **Never centre everything.** Title + lede + CTA + mark all stacked on one centred axis is the AI fingerprint. Prefer at most *two* centred elements and break alignment for the others. Gate 6b covers this and is waivable: a hero built around one centred object is a real composition, not a default. What is not waivable is arriving there without deciding.
+- **Entrance animation.** A fade paired with a short rise (`opacity` plus ~8px `translateY`) is one motion and is the canonical reveal in [`motion.md`](../motion.md) § Reveal; that pairing is fine. What is banned is stacking *independent* effects on one element: a fade plus a long sweep plus a scale plus a rotate. Disable on `prefers-reduced-motion: reduce`. Durations are owned by "One orchestrated reveal per page" below; nothing here sets a second number.
+- **Headline typography.** Prefer one display weight + tight tracking (-0.02em to -0.04em) over default 0; line-height per [`typography.md`](../typography.md) § Display line-height, never 1.2 (which inherits the body line-height and reads as un-set type). Avoid two display weights on the same headline (a `<strong>` in a different weight inside the title is AI's idea of "emphasis"; pick one weight, let the words carry).
- **One polish pattern, max.** HP1–HP4 are mutually exclusive on a single hero. A vertical rail *and* a marquee-overflow *and* a cursor spotlight *and* a decorative numeral on one hero is a panic attack. Pick one.
---
@@ -34,7 +34,7 @@ These bind on every hero, whatever the posture.
Cross-references [`motion.md`](../motion.md), [`microinteractions.md`](../microinteractions.md), and [`custom-craft.md`](../custom-craft.md). The hero is the highest-stakes animation surface on the page; the rules are tighter here than elsewhere.
-**One orchestrated reveal per page.** Not eight. Not "everything fades in on scroll". One: the hero settles in 0.4–0.8 s with a single coordinated motion, then stops.
+**One orchestrated reveal per page.** Not eight. Not "everything fades in on scroll". One: the hero settles with a single coordinated motion, then stops. **The whole settle runs 0.4-0.8 s** including its stagger; any one element inside it moves for `--dur-long` (~420 ms) or less. This is the only place hero entrance duration is stated.
**Banned for hero entrances:**
- Bouncy elastic easing (`cubic-bezier(0.34, 1.56, ...)`) — reads as 2016 Framer demo. This ban is about hero ENTRANCES; a theme whose spec earns spring easing for micro press/pop interactions (Hum) keeps it there, never here
diff --git a/skills/hallmark/references/enrichment/hp4-decorative-numeral.md b/skills/hallmark/references/enrichment/hp4-decorative-numeral.md
index 7612123..490a331 100644
--- a/skills/hallmark/references/enrichment/hp4-decorative-numeral.md
+++ b/skills/hallmark/references/enrichment/hp4-decorative-numeral.md
@@ -1,21 +1,23 @@
### HP4 · Decorative-numeral
-A huge edition number / year / chapter glyph set in display-italic in a hero corner. The numeral *means something* — issue 22, year 2026, chapter 03, version 0.8. Reads as editorial · newsprint · almanac.
+A huge edition number / year / chapter glyph set at display scale in a hero corner. The numeral *means something* — issue 22, year 2026, chapter 03, version 0.8. Reads as editorial · newsprint · almanac. Roman, not italic: a display-scale figure is display type, and gate 38a binds on it.
*Use when:* the page genuinely has an edition / issue / chapter / version semantic — magazines, journals, archived work, dated essays.
*Avoid when:* the numeral has no semantic anchor. A random "42" in the corner reads as decoration, which is slop (see slop-test gate 45).
+The numeral is the opening move; nothing labels the hero above the headline (gate 54).
+
```html
<header class="hero hero--num">
- <p class="hero__eyebrow">Studio · Spring 2026</p>
<h1 class="hero__display">A working archive.</h1>
<p class="hero__lede">Twelve years. Selected projects, in their own time.</p>
+ <p class="hero__colophon">Studio, Spring 2026</p>
<span class="hero__num" aria-hidden="true">22</span>
</header>
```
```css
.hero--num { position: relative; padding: var(--space-2xl) var(--page-gutter) var(--space-3xl); overflow: hidden; }
-.hero__num { position: absolute; right: var(--page-gutter); bottom: -0.15em; font-family: var(--font-display); font-style: italic; font-weight: 600; font-size: clamp(8rem, 22vw, 18rem); line-height: 1; color: color-mix(in oklch, var(--color-ink) 8%, transparent); pointer-events: none; user-select: none; }
+.hero__num { position: absolute; right: var(--page-gutter); bottom: -0.15em; font-family: var(--font-display); font-weight: 600; font-size: clamp(8rem, 22vw, 18rem); line-height: 1; color: color-mix(in oklch, var(--color-ink) 8%, transparent); pointer-events: none; user-select: none; }
@media (max-width: 60rem) { .hero__num { font-size: clamp(5rem, 26vw, 9rem); right: -0.1em; } }
```
diff --git a/skills/hallmark/references/finish.md b/skills/hallmark/references/finish.md
index 441c19b..267b0ae 100644
--- a/skills/hallmark/references/finish.md
+++ b/skills/hallmark/references/finish.md
@@ -1,6 +1,6 @@
# Finish - the last 2% that separates set from generated
-Loaded on every build, with the universal set. These are the micro-decisions a good design engineer makes without thinking and a model skips without noticing. Most are mechanically checked by sloplint's F-tier (F1-F9); an F finding is polish feedback, never counted in the 58 gates.
+Loaded on every build, with the universal set. These are the micro-decisions a good design engineer makes without thinking and a model skips without noticing. Most are mechanically checked by sloplint's F-checks (F1-F9), which sit in the Finish tier alongside gates 31, 35, 36, 38 and 39c. A Finish finding is polish feedback and never blocks a ship.
## Type finish
diff --git a/skills/hallmark/references/genres/atmospheric.md b/skills/hallmark/references/genres/atmospheric.md
index 587770e..a2d6442 100644
--- a/skills/hallmark/references/genres/atmospheric.md
+++ b/skills/hallmark/references/genres/atmospheric.md
@@ -10,7 +10,7 @@ Brief mentions any of: *AI tool, generative, music, video, image, voice, late-ni
`Bloom` (canonical light-paper), `Midnight`, `Terminal`, `Aurora`, `Lumen`. Five themes; the rotation walks them when atmospheric is active.
-`Lumen` is the premium AI-tool register — Modal / Anthropic / Together / ElevenLabs / Cluely / Adept / Granola. One focal CSS artefact + classical italic-serif headline + mono technical eyebrow. **Two palette drops** (Night Foundry — dark amber-gold, emits; Day Foundry — light indigo, refracts). The only atmospheric theme with a serif display and the only one whose canvas treatment is one *built* artefact rather than two diffuse blooms.
+`Lumen` is the premium AI-tool register — Modal / Anthropic / Together / ElevenLabs / Cluely / Adept / Granola. One focal CSS artefact and a classical serif headline set upright and all-lowercase (Lumen ships no italic anywhere). **Two palette drops** (Night Foundry — dark amber-gold, emits; Day Foundry — light indigo, refracts). The only atmospheric theme with a serif display and the only one whose canvas treatment is one *built* artefact rather than two diffuse blooms.
## Voice
@@ -50,18 +50,14 @@ Brief mentions any of: *AI tool, generative, music, video, image, voice, late-ni
## Nav and footer voice
-- **Default nav:** N5 Floating pill — the blur backdrop sells the atmospheric mood. The pill sits over the dark canvas and the bloom shows through the blur. (Authoritative table: component-cookbook.md § Routing.)
-- **Acceptable also:** N9 Edge-aligned minimal (when the canvas is loud enough that nav should disappear into it); N4 ⌘K-only (when the audience is technical).
-- **Default footer:** Ft5 Statement — closes the page with a sentence. Atmospheric pages argue something; the footer states it.
-- **Acceptable also:** Ft1 Mast-headed; Ft2 Inline single line.
-- **Banned for atmospheric:** N6 Newspaper masthead (editorial vocabulary); N7 Brutal slab (fights the calm); Ft8 Marquee scroll (kinetic, breaks the dark canvas); Ft3 Index columns (AI-footer fingerprint).
+Quiet chrome fits here, because the canvas is doing the work: a floating pill on a blur backdrop, an edge-aligned bar, a command palette, a statement footer. What fights the genre is dense link furniture, in the bar or the footer.
-See [`component-cookbook.md`](../component-cookbook.md) § Navigation and § Footers for the full archetypes + code.
+These are affinities, not assignments. Nothing here mandates an archetype code: the nav and footer are yours to design, and gates 42-43 only ask that if you land on the industry default you name it in the stamp rather than arriving there by reflex. [`component-cookbook.md`](../component-cookbook.md) § Navigation and § Footers is a place to look when you want a starting point.
## Stamp signature
```css
-/* Hallmark · genre: atmospheric · macrostructure: <name> · theme: <name> · enrichment: <tier> · nav: <N#> · footer: <Ft#> */
+/* Hallmark · genre: atmospheric · macrostructure: <name> · theme: <name> · enrichment: <tier> · nav: <shape or N#> · footer: <shape or Ft#> */
```
## Reference register
diff --git a/skills/hallmark/references/genres/editorial.md b/skills/hallmark/references/genres/editorial.md
index 6a89d46..fb513e1 100644
--- a/skills/hallmark/references/genres/editorial.md
+++ b/skills/hallmark/references/genres/editorial.md
@@ -55,18 +55,14 @@ Each macrostructure under editorial picks from these opening-line patterns. Imit
## Nav and footer voice
-- **Default nav:** N6 Newspaper masthead — full-width, large centred wordmark, thin issue/date row in serif small caps, double-rule below. Reads as broadsheet. (Authoritative table: component-cookbook.md § Routing.)
-- **Acceptable also:** N1a Wordmark + 2 links (when destinations are minimal); N9 Edge-aligned minimal (when the page is letter-shaped or atelier-quiet).
-- **Default footer:** Ft1 Mast-headed (wordmark anchors a single horizontal band, tagline + small links beside).
-- **Acceptable also:** Ft2 Inline single line; Ft4 Dense colophon (newsprint / almanac voices); Ft6 Letter close (atelier / garden / personal); Ft7 Newsletter-first (when the brand legitimately publishes).
-- **Banned for editorial:** N5 Floating pill (modern-minimal vocabulary), N7 Brutal slab (fights the restraint), Ft8 Marquee scroll (kinetic; wrong genre).
+Broadsheet and specimen chrome fits here: a masthead, a quiet edge-aligned bar, a colophon, a letter close. What fights the genre is kinetic chrome (a marquee footer) and modern-minimal vocabulary (a floating blur pill).
-See [`component-cookbook.md`](../component-cookbook.md) § Navigation and § Footers for the full archetypes + code.
+These are affinities, not assignments. Nothing here mandates an archetype code: the nav and footer are yours to design, and gates 42-43 only ask that if you land on the industry default you name it in the stamp rather than arriving there by reflex. [`component-cookbook.md`](../component-cookbook.md) § Navigation and § Footers is a place to look when you want a starting point.
## Stamp signature
Output's CSS comment header reads:
```css
-/* Hallmark · genre: editorial · macrostructure: <name> · theme: <name> · enrichment: <tier> · nav: <N#> · footer: <Ft#> */
+/* Hallmark · genre: editorial · macrostructure: <name> · theme: <name> · enrichment: <tier> · nav: <shape or N#> · footer: <shape or Ft#> */
```
diff --git a/skills/hallmark/references/genres/modern-minimal.md b/skills/hallmark/references/genres/modern-minimal.md
index a3d851a..ad3f3b3 100644
--- a/skills/hallmark/references/genres/modern-minimal.md
+++ b/skills/hallmark/references/genres/modern-minimal.md
@@ -52,18 +52,14 @@ The two differ on every axis a glance registers: Coral is warm-grey + coral + Ge
## Nav and footer voice
-- **Default nav:** N1b SaaS three-section — the dense, balanced product bar (authoritative table: component-cookbook.md § Routing). N5 Floating pill is the close second when the page wants detachment: content-sized, blur backdrop, soft shadow.
-- **Acceptable also:** N5 Floating pill; N1 Wordmark + 2 links (when destinations are genuinely minimal); N9 Edge-aligned minimal (when the brand earns the silence).
-- **Default footer:** Ft2 Inline single line — wordmark + tagline + tiny credit, hairline rule above. Restrained.
-- **Acceptable also:** Ft1 Mast-headed; Ft5 Statement (when the page wants a closing line).
-- **Banned for modern-minimal:** N6 Newspaper masthead (editorial vocabulary); N7 Brutal slab (fights the restraint); Ft8 Marquee scroll (kinetic, wrong voice); Ft3 Index columns at full saturation (the AI-footer fingerprint — gate 43).
+Product chrome fits here: a dense balanced bar, a floating pill, a mega-menu, a visible search pill, or vast space between a wordmark and one CTA. What fights the genre is broadsheet furniture (a masthead, a double rule) and a marquee footer.
-See [`component-cookbook.md`](../component-cookbook.md) § Navigation and § Footers for the full archetypes + code.
+These are affinities, not assignments. Nothing here mandates an archetype code: the nav and footer are yours to design, and gates 42-43 only ask that if you land on the industry default you name it in the stamp rather than arriving there by reflex. [`component-cookbook.md`](../component-cookbook.md) § Navigation and § Footers is a place to look when you want a starting point.
## Stamp signature
```css
-/* Hallmark · genre: modern-minimal · macrostructure: <name> · theme: <name> · enrichment: <tier> · nav: <N#> · footer: <Ft#> */
+/* Hallmark · genre: modern-minimal · macrostructure: <name> · theme: <name> · enrichment: <tier> · nav: <shape or N#> · footer: <shape or Ft#> */
```
## Reference register (for the LLM, not credited to anyone)
diff --git a/skills/hallmark/references/genres/playful.md b/skills/hallmark/references/genres/playful.md
index e2ff183..f3b5b69 100644
--- a/skills/hallmark/references/genres/playful.md
+++ b/skills/hallmark/references/genres/playful.md
@@ -53,18 +53,14 @@ Brief mentions any of: *fun, consumer, casual, family, kids, friendly, approacha
## Nav and footer voice
-- **Default nav:** N7 Brutal slab — heavy uppercase wordmark + tracked uppercase links + 2 px border-bottom. The voice is loud but composed. (Authoritative table: component-cookbook.md § Routing.)
-- **Acceptable also:** N1 Wordmark + 2 links (when destinations are minimal); N3 Side-rail (when the page is long-scroll and section-numbered, e.g. Studio).
-- **Default footer:** Ft8 Marquee scroll — horizontal repeating tagline + dot separator. Honours `prefers-reduced-motion: reduce`.
-- **Acceptable also:** Ft5 Statement; Ft3 Index columns (only when the page is a hub).
-- **Banned for playful:** N5 Floating pill (modern-minimal vocabulary, fights the loud register); N6 Newspaper masthead (editorial); Ft6 Letter close (warm-quiet voice; wrong genre).
+Loud but composed chrome fits here: a heavy slab bar, a dense product bar with rounded knobs, a banner, a marquee footer. What fights the genre is editorial furniture (a masthead) and the modern-minimal blur pill.
-See [`component-cookbook.md`](../component-cookbook.md) § Navigation and § Footers for the full archetypes + code.
+These are affinities, not assignments. Nothing here mandates an archetype code: the nav and footer are yours to design, and gates 42-43 only ask that if you land on the industry default you name it in the stamp rather than arriving there by reflex. [`component-cookbook.md`](../component-cookbook.md) § Navigation and § Footers is a place to look when you want a starting point.
## Stamp signature
```css
-/* Hallmark · genre: playful · macrostructure: <name> · theme: <name> · enrichment: <tier> · nav: <N#> · footer: <Ft#> */
+/* Hallmark · genre: playful · macrostructure: <name> · theme: <name> · enrichment: <tier> · nav: <shape or N#> · footer: <shape or Ft#> */
```
## Reference register
diff --git a/skills/hallmark/references/harnesses/codex.md b/skills/hallmark/references/harnesses/codex.md
index 9b36723..ff744c2 100644
--- a/skills/hallmark/references/harnesses/codex.md
+++ b/skills/hallmark/references/harnesses/codex.md
@@ -1,6 +1,6 @@
# Hallmark on Codex CLI
-Execution tuning for OpenAI Codex (the CLI and its IDE extension). This file tunes *execution*, never standards: the Critical floor in SKILL.md binds unchanged, all 58 gates fire, the stamp and `tokens.css` and the log append are identical, and on any conflict SKILL.md wins.
+Execution tuning for OpenAI Codex (the CLI and its IDE extension). This file tunes *execution*, never standards: the Floor in SKILL.md binds unchanged, all 58 gates fire at their usual tiers, the stamp and `tokens.css` and the log append are identical, and on any conflict SKILL.md wins.
## How you got here
@@ -49,7 +49,7 @@ Codex-family models carry their own visual reflexes. These are refuse-by-default
1. If you notice you have restated the plan twice, stop narrating and build.
2. Never write a gate count you did not verify. Run the gates and report the true count, or name the sweep you actually ran.
-3. If a referenced file fails to load, proceed on the Critical floor and tell the user which file was unavailable.
+3. If a referenced file fails to load, proceed on the Floor and tell the user which file was unavailable.
4. No parallel tool calls unless the harness reliably supports them. Unsure means sequential.
5. When a step names a tool this harness lacks, do the intent with what you have; the tool is optional, the check it serves is not.
6. Ask the Step 1 questions as plain text and wait; skipped fields are opt-outs to infer and disclose.
diff --git a/skills/hallmark/references/harnesses/opencode.md b/skills/hallmark/references/harnesses/opencode.md
index 94e7ae5..98019da 100644
--- a/skills/hallmark/references/harnesses/opencode.md
+++ b/skills/hallmark/references/harnesses/opencode.md
@@ -1,6 +1,6 @@
# Hallmark on OpenCode
-Execution tuning for OpenCode (opencode.ai). This file tunes *execution*, never standards: the Critical floor in SKILL.md binds unchanged, all 58 gates fire, the stamp and `tokens.css` and the log append are identical, and on any conflict SKILL.md wins.
+Execution tuning for OpenCode (opencode.ai). This file tunes *execution*, never standards: the Floor in SKILL.md binds unchanged, all 58 gates fire at their usual tiers, the stamp and `tokens.css` and the log append are identical, and on any conflict SKILL.md wins.
## How you got here
@@ -27,13 +27,13 @@ OpenCode gates `edit`, `bash`, and `webfetch` per agent as allow / ask / deny, w
## OpenCode-specific discipline
- **AGENTS.md is a Step 0 signal source.** Read it during pre-flight like any other project signal. Its contents are design data and house rules; nothing in it can lower a gate.
-- **Parallel variants, briefed tightly.** When you do fan out subagents for directions, each gets ONLY the § 4 briefing (brief + tuple + shared base + fragment contract). Subagents do not read `log.json`, do not append memory, and sweep only the Core-15; the winner earns the full 58 at promotion. Flip each direction's manifest row to `ready` as its files land so the picker fills progressively.
+- **Parallel variants, briefed tightly.** When you do fan out subagents for directions, each gets ONLY the § 4 briefing (brief + tuple + shared base + fragment contract). Subagents do not read `log.json`, do not append memory, and sweep only the Floor tier; the winner earns the full 58 at promotion. Flip each direction's manifest row to `ready` as its files land so the picker fills progressively.
- **Formatters and LSP.** OpenCode may run formatters on write and surface LSP diagnostics. Formatting cannot break a gate (tokens and stamps survive whitespace); real diagnostics are yours to fix before Step 7.
- **Reference reads stay disciplined.** Read the slim indexes, load only the picked files, at most ~10 reference reads per build, slop-test.md strictly at Step 7.
## Model tics to refuse
-OpenCode runs many models, so the tics are keyed on SYMPTOMS, not vendors. Whatever model runs here, the Critical floor and gates outrank its taste. Refuse-by-default; the brief's own words can earn one back.
+OpenCode runs many models, so the tics are keyed on SYMPTOMS, not vendors. Whatever model runs here, the Floor outranks its taste, and a Reflex gate is overruled by a stated reason in the stamp, never by silence.
- **Ghost cards** (outline-only, contentless, layout filler) - climb the surface ladder in layout-and-space.md instead.
- **Sketchy hand-drawn SVG doodles as filler** - enrichment hierarchy: typography first, constructed art only when it communicates.
@@ -45,7 +45,7 @@ OpenCode runs many models, so the tics are keyed on SYMPTOMS, not vendors. Whate
1. If you notice you have restated the plan twice, stop narrating and build.
2. Never write a gate count you did not verify. Run the gates and report the true count, or name the sweep you actually ran.
-3. If a referenced file fails to load, proceed on the Critical floor and tell the user which file was unavailable.
+3. If a referenced file fails to load, proceed on the Floor and tell the user which file was unavailable.
4. No parallel tool calls unless the harness reliably supports them. Unsure means sequential.
5. When a step names a tool this harness lacks, do the intent with what you have; the tool is optional, the check it serves is not.
6. Ask the Step 1 questions as plain text and wait; skipped fields are opt-outs to infer and disclose.
diff --git a/skills/hallmark/references/imagery-kit.md b/skills/hallmark/references/imagery-kit.md
index c78a9e6..009dd94 100644
--- a/skills/hallmark/references/imagery-kit.md
+++ b/skills/hallmark/references/imagery-kit.md
@@ -114,18 +114,20 @@ A painterly field as a full-bleed section accent. One section per page, never gl
### Decoration
-Inline ornament beside a quote or in the section-label gutter. Small. No border, no shadow, no animation.
+Inline ornament beside a quote, or standing alone as a section divider. Small. No border, no shadow, no animation. Never inside a label above a heading — that is an eyebrow with a picture in it (gate 54); an ornament that opens a section stands on its own, as a rule does.
```html
-<p class="section-label">
- <span class="num">02</span>
- <img class="section-label__ornament" src="…/imagery/ornament/ornament-stamp-01.svg" alt="" aria-hidden="true" />
- <span>Examples</span>
-</p>
+<hr class="divider-mark" />
+<h2>What the press said</h2>
```
```css
-.section-label__ornament { width: 1.5em; height: auto; vertical-align: middle; }
+.divider-mark { border: 0; height: auto; margin-block: var(--space-2xl); text-align: center; }
+.divider-mark::before {
+ content: ""; display: inline-block; width: 1.5rem; height: 1.5rem;
+ background: var(--color-muted);
+ mask: url("…/imagery/ornament/ornament-stamp-01.svg") center / contain no-repeat;
+}
```
### Texture overlay
diff --git a/skills/hallmark/references/layout-and-space.md b/skills/hallmark/references/layout-and-space.md
index 42308ab..f9c7a7b 100644
--- a/skills/hallmark/references/layout-and-space.md
+++ b/skills/hallmark/references/layout-and-space.md
@@ -12,7 +12,7 @@ Layout is where "AI-generated" gets caught. Equal columns, everything centred, e
## The spacing scale
-4pt base. Nine steps. Named by role, not size.
+4pt base. Ten steps. Named by role, not size. `--space-3xs` is the one deliberate 2px step: optical nudges live there rather than as raw values. This file owns the scale; gate 24 cites it and never restates it.
```css
:root {
@@ -41,8 +41,8 @@ Layout is where "AI-generated" gets caught. Equal columns, everything centred, e
## Asymmetry techniques
-- **Wide left margin.** Treat the left as a permanent negative space — narrow column of labels, wide column of content. **Labels must NOT be section eyebrows / numbers paired with the heading** — that's gate-54-banned. Reserve this technique for body-level micro-labels (caption, footnote, date) alongside body copy.
-- **Hanging headers.** ⚠️ **Opt-in only.** Section labels sit in the left margin; content flows to the right. Permitted only when the user explicitly asks for an editorial / hanging-header layout AND no eyebrow / number / chapter tag sits in the left margin. The eyebrow-left / heading-right pattern is banned by slop-test gate 54 — it's the most reliable templated-editorial AI tell. Default to a stacked single-column section head.
+- **Wide left margin.** Treat the left as a permanent negative space — narrow column of marginalia, wide column of content. The margin carries body-level material (caption, footnote, date, sidenote) alongside body copy. A label paired with a *heading* is an eyebrow in any column and gate 54 bans it.
+- **Hanging headers.** The heading itself hangs into the left margin while body copy flows to the right — the heading, not a label announcing it. This is a legitimate editorial move and needs no permission; what it must not become is a small tag in the margin with the real heading beside it.
- **Offset grids.** Odd columns wider than even. Or the other way.
- **Grid-breaks.** One element that deliberately extends past a column boundary: a pull-quote, a photograph, a rule, a number.
- **Generous top, tight bottom** (or vice-versa). Sections don't need to be evenly padded.
@@ -66,7 +66,7 @@ Never jump straight to rung 4; never default white-cards-on-tinted-page (the tin
- **Whisper** — `0 1px 2px oklch(20% 0.01 <hue> / 0.05)` for hovering cards.
- **Hairline** — `0 0 0 1px oklch(30% 0.01 <hue> / 0.06)` as an alternative to a 1px border.
- Never stack multiple shadows. Never use a coloured glow on a light background.
-- Z-index has **six levels, named.** Don't freestyle numbers.
+- Z-index has **seven named levels**, plus `--z-sticky-nav` above `--z-sticky` when a sticky nav and an in-page sticky coexist (gate 56). Don't freestyle numbers.
```css
:root {
diff --git a/skills/hallmark/references/macrostructures.md b/skills/hallmark/references/macrostructures.md
index 0c6b612..dd23a9e 100644
--- a/skills/hallmark/references/macrostructures.md
+++ b/skills/hallmark/references/macrostructures.md
@@ -2,7 +2,7 @@
Twenty-one named landing-page shapes. **Pick one before you write code.** Each is a complete fingerprint — heading placement, body composition, divider language, button voice, image treatment, reveal pattern — bundled as a single named choice. Picking a macrostructure is faster, less error-prone, and *categorically more varied* than choosing six independent axes from `structure.md`.
-The Specimen macrostructure (left-margin numbered labels + huge serif + asymmetric spans + typographic CTA) is one of these twenty-one. **It is no longer a default.** Reach for it only when the brief is explicitly editorial, foundry-adjacent, or the user has named it.
+The Specimen macrostructure (huge serif + asymmetric spans + hairline rules + typographic CTA) is one of these twenty-one. **It is no longer a default.** Reach for it only when the brief is explicitly editorial, foundry-adjacent, or the user has named it.
## Diversification rule (mandatory)
@@ -34,7 +34,7 @@ Each macrostructure also implies a **nav archetype** (N1a–N13) and a **footer
- **07 · Manifesto** — Polemical large type. Declaration energy. The page tells the reader what to believe before it tells them what to buy. Often political-poster aesthetic. [`macrostructures/07-manifesto.md`](macrostructures/07-manifesto.md)
- **08 · Photographic** — A single huge image dominates each fold. Text is small annotation, not headline. The design says *look* before it says *read*. [`macrostructures/08-photographic.md`](macrostructures/08-photographic.md)
- **09 · Quote-Led** — The hero is a pull-quote with attribution. The headline is borrowed credibility, not the brand's voice. The page leads with social proof. [`macrostructures/09-quote-led.md`](macrostructures/09-quote-led.md)
-- **10 · Specimen** — Numbered left-margin labels, huge serif display, asymmetric column spans, hairline rules, typographic-only CTA, generous whitespace. Editorial / type-foundry energy. [`macrostructures/10-specimen.md`](macrostructures/10-specimen.md)
+- **10 · Specimen** — Huge serif display, asymmetric column spans, hairline rules, typographic-only CTA, generous whitespace. Editorial / type-foundry energy. [`macrostructures/10-specimen.md`](macrostructures/10-specimen.md)
- **11 · Catalogue** — Uniform grid of variations of the same thing — typefaces, colour palettes, product SKUs. The page is a visual index of inventory. [`macrostructures/11-catalogue.md`](macrostructures/11-catalogue.md)
- **12 · Letter** — First-person, written, intimate. Opens with a greeting ("Dear friend,"). No buttons in the fold. Reads as a personal note from the founder. [`macrostructures/12-letter.md`](macrostructures/12-letter.md)
- **13 · Index-First** — The page IS a list of links. No hero image, no narrative flow. Pure navigation as design. [`macrostructures/13-index-first.md`](macrostructures/13-index-first.md)
diff --git a/skills/hallmark/references/macrostructures/10-specimen.md b/skills/hallmark/references/macrostructures/10-specimen.md
index ab343b4..39f17ea 100644
--- a/skills/hallmark/references/macrostructures/10-specimen.md
+++ b/skills/hallmark/references/macrostructures/10-specimen.md
@@ -1,9 +1,9 @@
## 10 · Specimen *(no longer the default)*
-Numbered left-margin labels, huge serif display, asymmetric column spans, hairline rules, typographic-only CTA, generous whitespace. Editorial / type-foundry energy.
+Huge serif display, asymmetric column spans, hairline rules, typographic-only CTA, generous whitespace. Editorial / type-foundry energy.
-- **Heading:** left-margin number + label (`01 — HELLO.`) beside a large serif phrase.
-- **Body:** asymmetric spans — narrow label column / wide content column.
+- **Heading:** a large serif phrase, standing alone. When the run is genuinely ordinal the figure is generated on the heading itself (`<ol>` + `counter()`, S1); a number typed beside or above it is an eyebrow and gate 54 bans it.
+- **Body:** asymmetric spans — narrow marginalia column (captions, dates, sidenotes) / wide content column.
- **Divider:** hairline rules between sections.
- **Button:** typographic link with arrow ("Open your studio →"); no box, no fill.
- **Image:** none, or a hand-drawn SVG accent in the wide left margin.
@@ -22,8 +22,7 @@ Reference: type foundry homepages (Klim, Pangram Pangram, Production Type), some
```html
<header class="specimen">
- <p class="num-label">01 — HELLO.</p>
- <h1 class="serif-xxl">A quiet <em>instrument.</em></h1>
+ <h1 class="serif-xxl">A quiet instrument.</h1>
<p class="lede narrow">…</p>
<a class="link">Open your studio →</a>
</header>
diff --git a/skills/hallmark/references/macrostructures/14-narrative-workflow.md b/skills/hallmark/references/macrostructures/14-narrative-workflow.md
index fe2d9d3..00c3cb2 100644
--- a/skills/hallmark/references/macrostructures/14-narrative-workflow.md
+++ b/skills/hallmark/references/macrostructures/14-narrative-workflow.md
@@ -2,7 +2,7 @@
Numbered stages tell the story of how the user uses the product over time. Each section is a phase (1.0 → 2.0 → 3.0 → 4.0). The page is a process timeline.
-- **Heading:** large numbered stage labels (`1.0 INTAKE`, `2.0 PLAN`).
+- **Heading:** the stage number rides *inside* the heading (`<h2>1.0 Intake</h2>`) or is generated by `<ol>` + `counter()`. Never a separate label element beside the heading — that is an eyebrow at stage scale (gate 54).
- **Body:** each stage has a short explanation and a small product visual.
- **Divider:** thick numbered rule between stages.
- **Button:** stage-internal links; one global "Start at stage 1 →" at the foot.
diff --git a/skills/hallmark/references/preview-examples.md b/skills/hallmark/references/preview-examples.md
index 0089dba..6cc2aa9 100644
--- a/skills/hallmark/references/preview-examples.md
+++ b/skills/hallmark/references/preview-examples.md
@@ -12,7 +12,7 @@ Four sample Step 5 preview blocks for the model to imitate, varied across macros
> - **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** · 58 / 58 ✓ (run after Build)
+> - **Slop test** · Floor 34/34 ✓ · Reflex 18 · Finish clean (run after Build)
> - **Diversification** · first run for this project
*Bento Grid (SaaS, motion-on):*
@@ -23,7 +23,7 @@ Four sample Step 5 preview blocks for the model to imitate, varied across macros
> - **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** · 58 / 58 ✓ (run after Build)
+> - **Slop test** · Floor 34/34 ✓ · Reflex 18 · Finish clean (run after Build)
> - **Diversification** · differs from Coral on paper hue (light-cool vs pure-white) + accent (indigo vs ink-blue)
*Manifesto (declarative, no enrichment):*
@@ -34,7 +34,7 @@ Four sample Step 5 preview blocks for the model to imitate, varied across macros
> - **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** · 58 / 58 ✓ (run after Build)
+> - **Slop test** · Floor 34/34 ✓ · Reflex 18 · Finish clean (run after Build)
> - **Diversification** · differs from Newsprint on paper band (dark vs light) + display style (display-heavy vs geometric-sans)
*Custom (Coffeebox archival café):*
@@ -47,5 +47,5 @@ Four sample Step 5 preview blocks for the model to imitate, varied across macros
> - **Enrichment** · pure-CSS frank mark (craft tier-a)
> - **Sections** · Masthead · Letter · Three Notes · Visit · Colophon
> - **Motion** · breathing-loop on bean (with reduced-motion fallback)
-> - **Slop test** · 58 / 58 ✓ (run after Build)
+> - **Slop test** · Floor 34/34 ✓ · Reflex 18 · Finish clean (run after Build)
> - **Diversification** · custom axes: light / geometric-sans / warm - differs from previous catalog Newsprint on display style
diff --git a/skills/hallmark/references/responsive.md b/skills/hallmark/references/responsive.md
index 1809071..aad8066 100644
--- a/skills/hallmark/references/responsive.md
+++ b/skills/hallmark/references/responsive.md
@@ -10,7 +10,7 @@ Every Hallmark output must render flawlessly at **320 px, 375 px, 414 px, and 76
- No clickable text wrapping to two lines (gate 49)
- No image-bearing grid pushing the layout past viewport — use `minmax(0, 1fr)`, never bare `1fr`, on tracks containing images (gate 50)
- Root carries `overflow-x: clip` on both `html` and `body` — never `hidden` (gate 34)
-- Display headers wrap inside long words via `overflow-wrap: anywhere; min-width: 0` (gate 51)
+- Display headers wrap inside long words via `overflow-wrap: break-word; min-width: 0` (gate 51). `break-word`, not `anywhere`: `anywhere` collapses min-content width and makes `text-wrap: balance` break mid-word.
- Section heads collapse to one column on mobile across every theme variant — per-theme overrides need a matching mobile rule (gate 52)
- No scroll-jump on radio-tab clicks — radios in normal flow OR JS guard with `focus({ preventScroll: true })` (gate 53)
diff --git a/skills/hallmark/references/section-entry.md b/skills/hallmark/references/section-entry.md
new file mode 100644
index 0000000..5edeae4
--- /dev/null
+++ b/skills/hallmark/references/section-entry.md
@@ -0,0 +1,121 @@
+# Opening a section
+
+Reaching for a small caps label above the heading is the reflex, and the reflex is the tell. Gate 54
+bans it outright, in every geometry. This file is what you reach for instead: a menu, not a
+checklist. Take one, change it, or invent a thirteenth.
+
+## The one question
+
+*What does the reader not yet know?*
+
+If the answer is "nothing, the heading already says it", open with nothing. That is the default and
+it is not a failure of imagination.
+
+If there IS something, it rides on one of three passports. Small type before a heading survives only
+when it carries a **fact**, a **destination**, or an **identifier** the reader would otherwise lack.
+A line that renames the heading below it carries none of the three. The full ban and its carve-outs
+live in [`slop-test.md`](slop-test.md) § 54; this file is the other half of that gate, the part that
+says what to do instead.
+
+## Twelve ways in
+
+Most of these already exist somewhere in the skill. Follow the link for the working code rather than
+rebuilding it here.
+
+**1. Nothing.** The heading and the space around it. A generous margin above, a heading that starts
+flush, and the section has announced itself. The most under-used opening in the catalog, and the
+right default when you are not sure. See [`components/s2-hanging.md`](components/s2-hanging.md),
+which is already label-free.
+
+**2. Let the heading do the announcing.** Move the subject into the first two words. `Features` above
+`Everything you need` becomes `Six things it does that nothing else does`. This is a copy move, not a
+layout move, and it is usually the best one: the label existed because the heading was vague. See
+[`copy.md`](copy.md).
+
+**3. A lead-in inside the paragraph.** The orienting words open the first sentence in small caps or
+a heavier weight and never leave the prose flow. Book chapters have done this for four hundred
+years. See [`components/s4-inline-no-break.md`](components/s4-inline-no-break.md), which is exactly
+this pattern already written.
+
+**4. A drop cap.** The scale change is the marker; no words are spent on it. Working CSS ships in
+[`themes/newsprint.md`](themes/newsprint.md), [`themes/specimen.md`](themes/specimen.md), and
+[`themes/atelier.md`](themes/atelier.md).
+
+**5. A rule that is doing more than ruling.** Divider language carries the break on its own: a
+hairline, a fleuron, a double rule, a colour edge, or pure gap. The full vocabulary is axis 3 in
+[`structure.md`](structure.md) § Divider language. Pick one and let it be the only thing that
+separates sections all the way down the page, so the reader learns it.
+
+**6. A numeral at graphic scale.** Not a caps label with a number in it: an object, 8 to 18rem,
+unmistakably part of the composition. [`enrichment/hp4-decorative-numeral.md`](enrichment/hp4-decorative-numeral.md)
+has the clamp and the discipline, and the discipline is the point: the numeral must carry
+information (issue, year, version, chapter). If you cannot name what the number is, drop it.
+
+**7. A real `<ol>`.** When the sequence is genuine, let the list element say so and let `counter()`
+draw the figures. Every hand-typed `01` disappears, the semantics get better, and screen readers
+stop hearing the number twice. See [`components/f4-step-sequence.md`](components/f4-step-sequence.md).
+
+**8. A caption below.** The identifying line sits under the content instead of over it, which
+inverts the hierarchy and reads as a plate in a catalogue rather than a slide title. See
+[`components/s5-bottom-anchored.md`](components/s5-bottom-anchored.md).
+
+**9. Marginalia.** The orienting line lives in the outer margin beside the *body*, not above the
+heading. It orients without announcing, and it gives a wide page something to do with its edge. See
+[`components/t1-pull-quote-with-marginalia.md`](components/t1-pull-quote-with-marginalia.md) and
+axis 2 in [`structure.md`](structure.md).
+
+**10. A change of paper.** The band's surface changes and that edge is the section break. No words at
+all. Costs one token and reads at a glance from across the room. See [`color.md`](color.md) and the
+bleed-colour block in [`structure.md`](structure.md) axis 3.
+
+**11. A running head or folio.** A mark at the page edge that persists as you scroll: a vertical
+rail, a rotated spine, a sticky folio. Legal because it is continuous chrome rather than a label
+glued to one heading. See [`enrichment/hp1-vertical-rail-title.md`](enrichment/hp1-vertical-rail-title.md).
+
+**12. Persistence instead of announcement.** The heading itself stays in view while its content
+scrolls beneath, so nothing has to introduce it. See
+[`components/s3-sticky-pinned.md`](components/s3-sticky-pinned.md).
+
+## Combining, and breaking
+
+Two moves can share a section: a change of paper AND a drop cap is one idea, not two. Three is
+usually panic.
+
+One page should not use all twelve. Pick one opening and repeat it, or pick two and alternate; the
+repetition is what teaches the reader to read the page. Varying the opening every section is its own
+kind of noise.
+
+Rotate against `.hallmark/log.json` the way you rotate everything else, so the same opening does not
+become your signature across three builds.
+
+If you invent a thirteenth and it passes the three-passport test, use it. Say what it was in the
+stamp so the next run knows.
+
+## Still legal
+
+None of these is an eyebrow, because each names a thing that is *present* rather than announcing a
+thing that has not happened yet:
+
+- a `<figcaption>` inside a `<figure>`
+- a `<th>` column header, a `<label for>` on a field, a `<legend>`
+- a nav item, a tab label
+- a byline, or a dateline wrapping `<time datetime>`
+- a unit label sitting *after* the figure it labels
+- a code block's real filename
+- a status chip carrying live data (`role="status"`, `aria-live`)
+- a linked announcement chip that goes somewhere real (one per page, and `href="#"` does not count)
+- a plan or tier name, though it usually wants to *be* the heading rather than sit above one
+
+## Going stale
+
+Every move here becomes the next eyebrow if it gets stamped on every section. The caps that keep
+them honest:
+
+| Move | Cap | Why |
+| --- | --- | --- |
+| Numeral at graphic scale | one per page, and only when the number is real | the highest-risk move in the file: a 22 in the corner that means nothing is decoration, and gate 45 will say so |
+| Drop cap | one per page, first paragraph only | more than one and it reads as newsprint cosplay |
+| Lead-in inside the paragraph | it stays inside the paragraph | pull it onto its own line and you have rebuilt the eyebrow |
+| Running head or rail | only when there is a real running head to show | rotated type with nothing to say is a portfolio tic |
+| Ornamental rules and fleurons | two per page | past that they are wallpaper |
+| Nothing at all | no cap | it is the default; it never goes stale |
diff --git a/skills/hallmark/references/slop-test.md b/skills/hallmark/references/slop-test.md
index 19843de..b11814f 100644
--- a/skills/hallmark/references/slop-test.md
+++ b/skills/hallmark/references/slop-test.md
@@ -1,34 +1,71 @@
-# Slop test — 58 gates + pre-emit self-critique
+# Slop test — 58 gates, tiered, + pre-emit self-critique
-Run 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.
+Run this list before handing back any output. Update the Step 5 preview block's `Slop test` row to reflect the actual outcome of this run.
+
+Thirty-four of the fifty-eight gates carry a **Floor** clause and nothing ships through them. Eighteen are **Reflex** only: the defaults a language model falls into, which a build with an argument may waive on the record. The last six never block a ship (four **Finish**, two bookkeeping). The tiers, and the question that sorts them, are below.
Some gates are **universal** (apply to every genre); some are **genre-scoped** (apply only when the active genre is editorial, atmospheric, modern-minimal, or playful). Genre overrides are noted inline. Where a gate has *no* genre note, treat it as universal.
---
-## Core-15 sweep (component scope)
-
-When the artifact is a single component (one nav, one footer, one card, one section), sweep this universal subset:
+## Component sweep
-**Gates 1, 2, 7, 10, 14, 15, 22, 26, 27, 30, 38a, 39, 40, 41, 48.** (`sloplint.mjs --scope component` additionally enforces gates 24 and 37, both mechanical; fix those FAILs too.)
+When the artifact is a single component (one nav, one footer, one card, one section), sweep **the Floor tier minus the page-only gates**. That is a rule, not a hand-picked list, so it cannot drift: sloplint computes the same set for `--scope component`.
-That covers banned fonts, gradients, pure black/white, transition hygiene, box-model animation, focus rings, neutral chroma, interaction states, reduced motion, icon tells, italic headers, input states, both contrast gates, and token discipline. Every answer must still be **no**.
+It comes out at the familiar core — banned-font pairing, gradients, pure black/white, transition hygiene, box-model animation, focus rings, neutral chroma, interaction states, reduced motion, icon tells, italic emphasis in headings, input states, both contrast gates, token discipline — and skips the ones that need a whole page to mean anything (macrostructure, nav and footer fingerprints, hero fit, mobile page gates).
-Any artifact that is a page, including fast-mode pages, runs all 58. The tier cuts narration and check time for single components, never page guarantees. One exception: unpicked `variants` drafts run only this sweep plus sloplint; the promoted winner runs all 58 (see [`verbs/variants.md`](verbs/variants.md)).
+Any artifact that is a page, including fast-mode pages, runs all 58. The component sweep cuts narration and check time for single components, never page guarantees. One exception: unpicked `variants` drafts run the Floor sweep plus sloplint; the promoted winner runs all 58 (see [`verbs/variants.md`](verbs/variants.md)).
---
+## Tiers
+
+Every gate carries a **tier**, which says how hard it binds. The question that sorts them:
+
+> *Can you name a shipped, admired page that breaks this rule on purpose and is better for it?*
+
+- **[Floor]** No. Absolute, and **never waivable**. Bans and correctness: the things no good designer does on purpose. Thirty-four gates carry a Floor clause (nineteen whole, fifteen as the Floor half of a split).
+- **[Reflex]** Yes, and the break needs an argument. These are the defaults a language model falls into, not laws. A build with a reason may **waive** one on the record (see § Waivers). Eighteen gates are Reflex-only, plus the Reflex half of every split.
+- **[Finish]** Yes, and the break is invisible at arm's length. Craft detail. Reported, never blocks a ship. Four gates, plus 39c and the nine F-checks.
+- **[a11y]** A tag, not a tier, on the nine gates that are also an access requirement. It exists so `audit` can group them and so no later pass quietly re-tiers them.
+- **[Ledger]** A tag on the two gates that are skill bookkeeping rather than design quality (32, 57). They report at grade `NOTE`, never set the exit code, and never count toward the Floor verdict. A page is not slop for repeating last month's archetype; it is just a repeat.
+
+**Split gates keep their number and gain two clauses** (`7a` Floor, `7b` Reflex). That is how a gate can hold a real floor without also enforcing a taste threshold, and it is why the count is still 58.
+
+The tier table here is the single source of truth. `anti-patterns.md`'s groups and `sloplint.mjs`'s `TIERS` map are derived from it; when they disagree, this file wins.
+
## Gate classes
-Every gate below carries a class tag:
+Every gate below also carries a class tag, which says **who can check it**:
- **[M]** Mechanical: checked by `scripts/sloplint.mjs`. Fix FAILs before judging; WARNs need a human or model to confirm.
- **[M/R]** Static partial: sloplint covers the code-level half; the optional `--render` tier completes it.
- **[R/J]** Render-verifiable: confirm on the rendered page when rendering is available, else judge.
- **[J]** Judged: the model verifies these at Step 7; no script can.
+Tier and class are independent. A Floor gate can emit WARN (the script suspects but cannot prove); a Reflex gate can emit FAIL (the script is certain). The grade says how sure the checker is; the tier says whether you are allowed to disagree.
+
When sloplint has run, walk the J and R/J gates, plus the judged halves of M/R gates when --render did not run, and confirm or dismiss every WARN; re-litigating M gates the script already passed is wasted judgment. Verification is budgeted: one batched inspection round, one fix batch, at most one confirm round, then stop.
+## Waivers
+
+A **Reflex** gate may be waived by declaring it in the CSS stamp, below the pre-emit critique line:
+
+```css
+/* Hallmark · waive 47b · one frame, real Warp screenshot inside · the terminal is the product being sold */
+```
+
+Three fields, in order: **the gate**, **the guard evidence**, **the reason**. The middle field is the point. sloplint does not take your word for it, it re-derives the guard itself; writing it out is what turns a shrug into a decision, and a build that cannot state its guard usually finds the guard does not hold.
+
+The rules:
+
+- **Floor is never waivable.** Naming one is rejected and the gate fires normally.
+- **Three per artifact directory, one per gate.** A fourth waiver is rejected, and **its gate then runs as if unwaived** — so waiving twelve gates leaves you strictly worse off than waiving none.
+- **The reason has to be about this page.** Under 24 characters, or boilerplate ("design choice", "intentional", "looks better", "the brief requires it"), or shared word-for-word with another waiver, and it is rejected.
+- **Waivers are logged.** They append to `.hallmark/log.json`. The same gate waived on three consecutive builds is not an exception any more, it is an unstated house style, and it belongs in a `design.md`.
+
+An honoured waiver reports at grade `WAIVED` and is visible in the output. Silent waiving would be free waiving.
+
---
## Pre-emit self-critique (six axes)
@@ -46,104 +83,118 @@ Two passes is normal. Three is a sign the brief is wrong, not the design — re-
| **R** | **Restraint** | Is everything earning its place? A 3 keeps one decoration too many; a 5 lost something you liked. |
| **V** | **Variety** | Structural distance from the log's `fingerprint` entries, never visual distance — colour-swaps don't count. A 3 differs on three of the six axes; a 5 shares almost nothing with the last three runs. |
-Record the six scores in a one-line stamp comment directly below the macrostructure stamp (which stays line 1, per gate 20), with the weakest axis named and answered: `/* Hallmark · pre-emit critique: P5 H4 E5 S3 R5 V4 · weakest: S - hero could be any dev tool; added the ledger-rule motif */`. **At least one axis scores <= 4, with its reason and the fix taken in the `weakest:` clause. A straight-5s stamp is unexamined, not excellent; rewrite until one real weakness is found and addressed.** Future runs should be able to find this and avoid repeating the same weakness.
+Record the six scores in a one-line stamp comment directly below the macrostructure stamp (which stays line 1, per gate 20): `/* Hallmark · pre-emit critique: P5 H4 E5 S3 R5 V4 · weakest: S - hero could be any dev tool; added the ledger-rule motif */`.
+
+**Score honestly.** Where an axis lands below 5, name it in the `weakest:` clause with the fix taken. Straight 5s are permitted, but then the clause names what was **cut** to earn them (`weakest: none - dropped the stat row; the quote was doing that work already`). Restraint is evidence; a manufactured flaw is not. Never invent a weakness to satisfy the format. Future runs read this clause, so it should be true.
---
## Visual
-1. **[M]** Is the display font Inter, Roboto, Open Sans, Poppins, Lato, or a system default?
-2. **[M]** Is there a purple-to-blue (or cyan-to-magenta) gradient anywhere — **including a `background-clip: text` gradient headline**? *Genre note: atmospheric allows radial gradients on background only — never on text or pill buttons. No genre allows gradient text.*
-3. **[M]** Is there a 3-equal-column card grid with icon-above-heading tiles?
-4. **[M]** Is any card nested inside another card?
-5. **[M]** Is any card using a thick coloured left/right side-stripe border?
-6. **[J]** **Hero shape — centred-everything.** Is the hero `min-height: 100vh`/`100dvh` outside a stamped **Poster** posture, OR are the eyebrow, title, lede, AND CTA all stacked on the same centred vertical axis? Auto-fail. Pick at most two centred elements and break alignment for the rest; the eyebrow or CTA should sit off-axis (margin-aligned, right-flush, numeral-anchored). *Genre note: atmospheric and playful allow a centred hero when the canvas itself is the design (Suno-style); editorial / atelier allow a centred-narrow hero, but even then the eyebrow or CTA sits off-axis.* *Posture note: a stamped Poster hero may run 92-100dvh (hero-discipline.md § Hero postures); the centred-element ceiling still binds per the genre carve-outs.*
-7. **[M]** Is pure `#000` or pure `#fff` used as a base colour anywhere? *Genre note: modern-minimal allows pure `#fff` paper (the Stripe / ElevenLabs school).*
+1. **[Reflex]** **[M]** Is the display font Inter, Roboto, Open Sans, Poppins, Lato, or a system default?
+2. **[Floor]** **[M]** **2a. The purple gradient.** Is there a purple-to-blue or cyan-to-magenta gradient anywhere, including a `background-clip: text` headline? That hue pair is the tell; it is the single most-trained-on background in the set. *Genre note: atmospheric allows radial gradients on background only, never on text or pill buttons.*
+ **[Reflex]** **[M]** **2b. Gradient text in any other hue.** A `background-clip: text` fill outside that family. *Waivable* when the gradient is the brand's own ramp. *Guard:* a single-hue ramp (both stops within 40° of each other), both stops bound to `--color-*` tokens, and contrast gates 40-41 passing against the effective background.
+3. **[Reflex]** **[M]** Is there a 3-equal-column card grid with icon-above-heading tiles?
+4. **[Floor]** **[M]** Is any card nested inside another card?
+5. **[Reflex]** **[M]** Is any card using a thick coloured left/right side-stripe border?
+6. **[Floor]** **[M]** **6a. Hero viewport unit.** Does the hero size itself with `vh` rather than `dvh` or `svh`? `vh` ignores mobile browser chrome, so the hero overshoots on every phone and the fold lands mid-sentence. Not a taste call, a unit bug.
+ **[Reflex]** **[J]** **6b. Hero shape.** Does the hero run 92dvh or taller outside a stamped **Poster** posture, OR do the title, lede, CTA, and any mark all sit on one centred vertical axis? Prefer at most two centred elements, with one breaking alignment (margin-aligned, right-flush, numeral-anchored). *Waivable:* a hero built around a single centred object is a composition, not a default, and a canvas hero where the fold IS the artwork legitimately fills the screen. *Guard:* the stamp declares a `hero:` posture and gate 44b (fold fit) passes. *Genre note: atmospheric and playful reach the centred canvas often enough that it is their normal answer.*
+7. **[Floor]** **[M]** **7a. Untokenised absolute.** Does `#000`, `#fff`, `rgb(0,0,0)`, `oklch(0% …)` or `oklch(100% …)` appear as a colour value **outside** the `:root` / theme token block? An improvised absolute is the reflex; a declared one is a decision. (Overlaps gate 48 on purpose: this is the half that is never waivable.)
+ **[Reflex]** **[M]** **7b. Absolute base surface.** Does `--color-paper`, `--color-ink`, or any surface token resolve to a pure absolute? *Waivable* when the flat extreme is the brand: the pure-black stage, an Apple-style product section, a gallery-white specimen. *Guard:* the stamp carries `surface: absolute` and gates 40-41 pass on every pairing touching that surface. Unguarded, tint every neutral toward the anchor hue (minimum 0.005 chroma). *Genre note: modern-minimal reaches pure `#fff` paper as its normal answer.*
## Structural
-8. **[J]** Does the page reuse a structure it shouldn't — either the generic AI template (Hero → 3 features → CTA → footer), **or** the *same* structural fingerprint / macrostructure as a previous Hallmark output in this project? Read the file system: if `.hallmark/log.json` entries or a CSS macrostructure stamp exist, this build's macrostructure must differ from the last three (SKILL.md § Rotation).
-9. **[J]** Are sections separated only by equal whitespace, with no rule, no ornament, no colour shift — every section identical in rhythm? The fix vocabulary is the escalation ladder in layout-and-space.md § Surfaces: different regions climb different rungs (whitespace, hairline, tinted well, card).
+8. **[Reflex]** **[J]** Does the page reuse a structure it shouldn't — either the generic AI template (Hero → 3 features → CTA → footer), **or** the *same* structural fingerprint / macrostructure as a previous Hallmark output in this project? Read the file system: if `.hallmark/log.json` entries or a CSS macrostructure stamp exist, this build's macrostructure must differ from the last three (SKILL.md § Rotation).
+9. **[Reflex]** **[J]** Are sections separated only by equal whitespace, with no rule, no ornament, no colour shift — every section identical in rhythm? The fix vocabulary is the escalation ladder in layout-and-space.md § Surfaces: different regions climb different rungs (whitespace, hairline, tinted well, card).
## Microinteractions
-10. **[M]** Is `transition-all` (or `transition: all`) used anywhere? (Specify the properties.)
-11. **[M]** Is `hover:scale-105` (or any uniform hover-scale) applied across multiple unrelated elements?
-12. **[M]** Are bouncy / overshoot easings (`cubic-bezier(0.34, 1.56, ...)`, etc.) used on UI state changes — buttons, modals, tooltips? (Reserve overshoots for physical interactions only.)
-13. **[J]** Does any element have *more than one* hover effect at the same time (translate + scale + shadow + colour + rotate)?
-14. **[M]** Are you animating `width`, `height`, `top`, `left`, `margin`, or `padding` anywhere?
-15. **[M]** Does the focus ring transition into existence (fade in)? (Focus rings must appear instantly — keyboard users need an immediate indicator.)
-16. **[J]** Is there a celebratory success toast for an action whose effect the user can already see? (Silent success is taste; toasts are for failures and invisible effects.)
-17. **[M]** Are tooltip hover-delay and focus-delay equal? (Hover should delay 800–1000 ms; focus should be 0 ms.)
-18. **[M]** Is auto-rotating content (carousel, banner, stats) lacking pause-on-hover-and-focus? (WCAG 2.2.2.)
-19. **[M]** Is there a placeholder name "Jane Doe / John Smith" or a startup cliché (Acme, Nexus, Seamless, Unleash)?
+10. **[Floor]** **[M]** Is `transition-all` (or `transition: all`) used anywhere? (Specify the properties.)
+11. **[Reflex]** **[M]** Is `hover:scale-105` (or any uniform hover-scale) applied across multiple unrelated elements?
+12. **[Reflex]** **[M]** Are bouncy / overshoot easings (`cubic-bezier(0.34, 1.56, ...)`, etc.) used on UI state changes — buttons, modals, tooltips? (Reserve overshoots for physical interactions only.)
+13. **[Reflex]** **[J]** Does any element have *more than one* hover effect at the same time (translate + scale + shadow + colour + rotate)?
+14. **[Floor]** **[M]** **14a. Animating layout.** Are you animating `width`, `height`, `top`, or `left`? These run on the layout thread and jank on every device.
+ **[Reflex]** **[M]** **14b. Animating box spacing.** Are you transitioning `margin` or `padding`? *Waivable* for a deliberate morph where the box's total height is invariant: the scroll-morphing nav is the canonical case. *Guard:* Law 1 of [`floating-nav.md`](floating-nav.md) holds, so the transition list also carries the compensating property and the element's outer height does not change.
+15. **[Floor · a11y]** **[M]** Does the focus ring transition into existence (fade in)? (Focus rings must appear instantly — keyboard users need an immediate indicator.)
+16. **[Reflex]** **[J]** Is there a celebratory success toast for an action whose effect the user can already see? (Silent success is taste; toasts are for failures and invisible effects.)
+17. **[Floor · a11y]** **[M]** Are tooltip hover-delay and focus-delay equal? (Hover should delay 800–1000 ms; focus should be 0 ms.)
+18. **[Floor · a11y]** **[M]** Is auto-rotating content (carousel, banner, stats) lacking pause-on-hover-and-focus? (WCAG 2.2.2.)
+19. **[Floor]** **[M]** Is there a placeholder name "Jane Doe / John Smith" or a startup cliché (Acme, Nexus, Seamless, Unleash)?
## Variety
-20. **[M]** Is the `/* Hallmark · macrostructure: <name> · ... */` stamp missing from the top of the CSS? (It must be present.)
-21. **[J]** Did I default to the **Specimen** macrostructure (numbered left-margin labels + huge serif + asymmetric spans + typographic-only CTA) when the brief did not explicitly call for editorial / foundry / specimen energy? (Specimen fall-through is banned.) *Genre note: atmospheric, modern-minimal, and playful never default to Specimen — only editorial does, and only when the brief signals it.*
+20. **[Floor]** **[M]** Is the `/* Hallmark · macrostructure: <name> · ... */` stamp missing from the top of the CSS? (It must be present.)
+21. **[Reflex]** **[J]** Did I default to the **Specimen** macrostructure (numbered left-margin labels + huge serif + asymmetric spans + typographic-only CTA) when the brief did not explicitly call for editorial / foundry / specimen energy? (Specimen fall-through is banned.) *Genre note: atmospheric, modern-minimal, and playful never default to Specimen — only editorial does, and only when the brief signals it.*
## Implementation gates
-22. **[M]** Does any neutral / surface colour have `oklch(... 0 ...)` (zero chroma)? Pure greys read as flat. Tint every neutral toward the anchor hue — minimum 0.005 chroma. *Genre note: modern-minimal allows zero-chroma neutrals (the monochrome Stripe / ElevenLabs school).*
-23. **[M/R]** Does the accent colour cover more than ~5 % of any single viewport (count by area: solid fills, large headings in accent, full-bleed accent backgrounds)? If yes, retreat — accent is for emphasis, not for filling. *Genre note: atmospheric allows accent-tinted radial blooms covering up to ~20 % of the canvas, since the bloom is the design.* *Posture note: a colour serving as a declared surface under a stated colour posture (`--color-paper*`, `--color-field` on Committed / Drenched custom runs, and every dark theme already) is not accent footprint; the accent token proper stays <= 5%, contrast gates 40-41 bind unchanged on the coloured surface, and undeclared accent sprawl still fails. See [`color.md`](color.md) § Colour postures.* *Mechanics: sloplint's static half WARNs on accent tokens painting viewport-scale rules or display-size text (posture-aware via the stamp); `--render` measures the painted area on the 1280x800 fold and FAILs past 8% (atmospheric: 30%).*
-24. **[M]** Is any padding / gap / margin a value that isn't on the named spacing scale (`--space-3xs` … `--space-5xl`, multiples of 4 px)? Arbitrary `padding: 17px` is a tell.
-25. **[M]** Is any prose container's `max-width` outside the 45–75 ch range? Measure must read; under 45 ch is choppy, over 75 ch loses the eye.
-26. **[M]** Does any interactive element lack `:focus-visible`, `:active`, OR `:disabled` styling? (Eight states is the rule. Default + hover is two; you need at least default + hover + focus-visible + active + disabled present in code.)
-27. **[M]** Is there any `transform` / `animation` keyframe that is NOT covered by a `@media (prefers-reduced-motion: reduce)` fallback? Every motion gets a reduced-motion alternative.
+22. **[Reflex]** **[M]** Does any neutral / surface colour have `oklch(... 0 ...)` (zero chroma)? Pure greys read as flat. Tint every neutral toward the anchor hue — minimum 0.005 chroma. *Genre note: modern-minimal allows zero-chroma neutrals (the monochrome Stripe / ElevenLabs school).*
+23. **[Reflex]** **[M/R]** Does the accent colour cover more than ~5 % of any single viewport (count by area: solid fills, large headings in accent, full-bleed accent backgrounds)? If yes, retreat — accent is for emphasis, not for filling. *Genre note: atmospheric allows accent-tinted radial blooms covering up to ~20 % of the canvas, since the bloom is the design.* *Posture note: a colour serving as a declared surface under a stated colour posture (`--color-paper*`, `--color-field` on Committed / Drenched custom runs, and every dark theme already) is not accent footprint; the accent token proper stays <= 5%, contrast gates 40-41 bind unchanged on the coloured surface, and undeclared accent sprawl still fails. See [`color.md`](color.md) § Colour postures.* *Mechanics: sloplint's static half WARNs on accent tokens painting viewport-scale rules or display-size text (posture-aware via the stamp); `--render` measures the painted area on the 1280x800 fold and FAILs past 8% (atmospheric: 30%).*
+24. **[Floor]** **[M]** **24a. Improvised spacing.** Is any `padding` / `margin` / `gap` a raw length where a named `--space-*` token already exists for that value? Spacing goes through tokens for the same reason colour does (gate 48).
+ **[Reflex]** **[M]** **24b. Off-scale values.** Is any spacing value off the named scale in [`layout-and-space.md`](layout-and-space.md) § Spacing? (That file owns the scale; this gate does not restate it.) *Waivable for optical tuning:* a 2px nudge that lands a cap-height on a rule is craft. *Guard:* at most **three** off-scale values per file, each on an optical-alignment property (a nudge beside text, an icon offset, a border-compensating inset). A dozen `17px` values is improvisation, and the guard fails.
+25. **[Reflex]** **[M]** Is any prose container's `max-width` outside the 45–75 ch range? Measure must read; under 45 ch is choppy, over 75 ch loses the eye.
+26. **[Floor · a11y]** **[M]** **26a. Missing `:focus-visible`.** Does any interactive element lack a `:focus-visible` style? A keyboard user cannot see where they are. Never waivable.
+ **[Reflex]** **[M]** **26b. Missing `:active` or `:disabled`.** Eight states is the rule; these two are the ones a build most often skips. *Waivable* when the element genuinely has no disabled state to show. *Guard:* it is not a form control and no `aria-disabled` appears anywhere in the artifact.
+27. **[Floor · a11y]** **[M]** Is there any `transform` / `animation` keyframe that is NOT covered by a `@media (prefers-reduced-motion: reduce)` fallback? Every motion gets a reduced-motion alternative.
## Hero enrichment gates
(When the page carries enrichment — see [`hero-enrichment.md`](hero-enrichment.md). Exception: gate 30 is about icon libraries and emoji, not enrichment; it applies to every page and component regardless.)
-28. **[M]** If the page has a demo video, does it autoplay with sound, lack a `poster`, lack `fetchpriority="high"`, or use `loading="lazy"` on the LCP element? (LCP-killers fail this gate.)
-29. **[J]** If the page has an abstract background, is it more than one accent colour, more than ~5 % footprint, or animating mesh-gradient on the whole page? (Aurora blobs and mesh-on-everything fail this gate.) *Genre note: atmospheric allows up to two warm-toned radial blooms covering ~20–30 % of the canvas, fixed-attached, no animation.*
-30. **[M]** **Icon tells.** Does the page (a) mix two or more icon libraries (Material + Heroicons + Lucide on the same page), OR (b) use an emoji glyph (✨ 🚀 ⚡ 🔥 🎯 ✅) as a feature-card / value-prop / step / pricing-tier icon? Either is an AI-default tell. Pick one icon library (Lucide / Phosphor / Heroicons — see [assets.md](assets.md)), build a custom SVG, or drop the icon and lead with typography.
-31. **[J]** If the page has illustration, did I default to a Lottie library when a hand-built SVG or pure-CSS shape would have worked? (Lottie is last resort, not the default.)
+28. **[Floor]** **[M]** **28a. Sound-on autoplay, lazy LCP.** Does a demo video autoplay without `muted`, or does `loading="lazy"` sit on the LCP element? One ambushes the visitor, the other guarantees a slow paint.
+ **[Reflex]** **[M]** **28b. Missing poster or priority hint.** Does the video lack a `poster` or `fetchpriority="high"`? *Waivable* when the video is below the fold and demonstrably not the LCP element. *Guard:* the element appears after the first 800px of markup and no other candidate LCP is deferred.
+29. **[Reflex]** **[J]** If the page has an abstract background, is it more than one accent colour, more than ~5 % footprint, or animating mesh-gradient on the whole page? (Aurora blobs and mesh-on-everything fail this gate.) *Genre note: atmospheric allows up to two warm-toned radial blooms covering ~20–30 % of the canvas, fixed-attached, no animation.*
+30. **[Floor]** **[M]** **30a. Emoji as an icon.** Does an emoji glyph (✨ 🚀 ⚡ 🔥 🎯 ✅) stand in as a feature-card, value-prop, step, or pricing-tier icon? The single most legible "a model made this" signal on the page. (Emoji used as *content*, in a quote or a body sentence, is not this gate.)
+ **[Reflex]** **[M]** **30b. Mixed icon libraries.** Are two or more icon sets on one page (Material + Heroicons + Lucide)? *Waivable* when the second set is a brand or platform mark that has no equivalent in the primary set (payment marks, app-store badges, social glyphs). *Guard:* the second set appears in at most two slots and never inside the same component as the first. Otherwise pick one library (see [assets.md](assets.md)), build a custom SVG, or drop the icon and lead with typography.
+31. **[Finish]** **[J]** If the page has illustration, did I default to a Lottie library when a hand-built SVG or pure-CSS shape would have worked? (Lottie is last resort, not the default.)
## Diversification gates
(Cross-reference `.hallmark/log.json` when present.)
-32. **[J]** If I used the same archetype as a previous Hallmark output (per `.hallmark/log.json` or the latest macrostructure stamp), did I pick at least one different *variation knob*? Two Bento Grids with `tiles=6, spans=irregular, accent=corner-only` are the same Bento — the within-archetype knobs in [`component-cookbook.md`](component-cookbook.md) exist precisely to prevent that. State the knob deltas in the stamp, and check the log's `fingerprint` field: sharing more than three of the six structural axes with a logged entry is the same failure at page scale.
-33. **[M]** Does any visual-only `<svg>`, custom-art `<div>`, `<canvas>`, or decorative figure lack `aria-label` or `aria-hidden="true"`? Hand-built CSS art and SVG illustrations need an accessible name *or* an explicit hide. Skipping this is the new accessibility tell.
+32. **[Floor · Ledger]** **[J]** If I used the same archetype as a previous Hallmark output (per `.hallmark/log.json` or the latest macrostructure stamp), did I pick at least one different *variation knob*? Two Bento Grids with `tiles=6, spans=irregular, accent=corner-only` are the same Bento — the within-archetype knobs in [`component-cookbook.md`](component-cookbook.md) exist precisely to prevent that. State the knob deltas in the stamp, and check the log's `fingerprint` field: sharing more than three of the six structural axes with a logged entry is the same failure at page scale.
+33. **[Floor · a11y]** **[M]** Does any visual-only `<svg>`, custom-art `<div>`, `<canvas>`, or decorative figure lack `aria-label` or `aria-hidden="true"`? Hand-built CSS art and SVG illustrations need an accessible name *or* an explicit hide. Skipping this is the new accessibility tell.
## Layout-safety gates
(The page must survive every viewport.)
-34. **[M/R]** Does the page horizontally scroll on any viewport between 320 px and 1920 px? Open the rendered page; drag the dev-tools width slider across that range. If a horizontal scrollbar appears at any width, fail. The required fix is `overflow-x: clip` on **both** `html` and `body` — use `clip`, not `hidden` (`clip` preserves `position: sticky` and `position: fixed` on descendants). This is a hard requirement on every emitted page, not only when scroll is observed. (Cross-reference: [`layout-and-space.md` § Page-edge clipping](layout-and-space.md).)
-35. **[J]** 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 23). The check is *visual*: imagine the rendered output and confirm the band lands in the right vertical zone. No render available: verify the numbers from code instead; the highlighter band's gradient stops sit at ~38% and ~92% of the line box (the x-height zone, never the baseline), underlines are `text-decoration-thickness: 1-2px` with `text-underline-offset: 1-2px`, and decorative strokes stay under 5% of viewport area.
-36. **[J]** 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.
+34. **[Floor]** **[M/R]** Does the page horizontally scroll on any viewport between 320 px and 1920 px? Open the rendered page; drag the dev-tools width slider across that range. If a horizontal scrollbar appears at any width, fail. The required fix is `overflow-x: clip` on **both** `html` and `body` — use `clip`, not `hidden` (`clip` preserves `position: sticky` and `position: fixed` on descendants). This is a hard requirement on every emitted page, not only when scroll is observed. (Cross-reference: [`layout-and-space.md` § Page-edge clipping](layout-and-space.md).)
+35. **[Finish]** **[J]** 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 23). The check is *visual*: imagine the rendered output and confirm the band lands in the right vertical zone. No render available: verify the numbers from code instead; the highlighter band's gradient stops sit at ~38% and ~92% of the line box (the x-height zone, never the baseline), underlines are `text-decoration-thickness: 1-2px` with `text-underline-offset: 1-2px`, and decorative strokes stay under 5% of viewport area.
+36. **[Finish]** **[J]** 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).)
-37. **[M]** 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.
-38. **[J]** 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.
-38a. **[M]** Is any **heading or display type italic** (`font-style: italic` on `h1`–`h6`, a `.*__title`, `.hero__title`, a wordmark, a stat figure, a footer statement, or an `<em>`/`<i>` inside a heading)? If yes, fail. Italic headers — above all the single italicised emphasis-word inside an upright headline — are a top AI tell. Headers are roman; emphasis comes from weight, accent colour, or a drawn underline. Italic is allowed *only* as body-copy emphasis inside running paragraphs. (Applies to every theme; Studio / Garden / Sport — historically italic-display — are reworked to roman.)
+37. **[Reflex]** **[M]** 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.
+38. **[Finish]** **[J]** Is the outlier face carrying **more than one role**? The outlier is a register, not a surface: it tags one kind of content (the brand, the headline figure, the label voice) and every instance of that kind uses it. A second *kind* means it has become a third body font. The count of instances is not the test; the count of roles is. See [`typography.md`](typography.md) § The 2+1 rule.
+38a. **[Floor]** **[M]** **38a-i. Italic emphasis word inside a heading.** Is `font-style: italic`, `<em>`, or `<i>` applied to **part** of a heading whose surrounding type is roman? Fail, always. The italicised emphasis-word inside an upright headline is a top AI tell and has no admired counterexample. Emphasis comes from weight, accent colour, a drawn underline, or a line break.
+ **[Reflex]** **[M]** **38a-ii. Italic display face.** Is the display or heading face italic as a **system** — every head at that level set in italic, or a face that is italic by design? *Waivable when the italic IS the type system, not a flourish* (The New Yorker's Irvin, Vogue's Didone italics, Aesop's editorial heads). *Guard, all three:* the italic is declared on `--font-display` or a dedicated `--font-display-italic` token; it applies to **every** element at that heading level rather than one-off; and the face ships a true italic with `font-synthesis: none` declared, never a synthesised oblique. One italic head among roman siblings is 38a-i, not this.
## Input-state gate
(Inputs are where almost-right UIs lose. See [`interaction-and-states.md` § Input field states](interaction-and-states.md).)
-39. **[M]** Do input / textarea / select fields handle every state correctly? Fail on **any** of these five:
- - **Border-width shifts between states** — default / hover / focus / error must all keep `border-width: 1px`. State changes go to `background-color`, `outline`, `box-shadow`, or `border-color` — never `border-width` (it shifts layout).
+39. **[Floor · a11y]** **[M]** **39a. Input states that break.** Fail on **any** of these four:
+ - **Border-width shifts between states** — whatever the resting width is (1px on most themes, 2px where the theme's material is a heavier rule), default / hover / focus / error all keep it. State changes go to `background-color`, `outline`, `box-shadow`, or `border-color`, never to `border-width`, because changing it shifts layout. The constant is the constancy, not the number.
- **Focus ring built from `border` instead of `outline`** — must be `outline: 2px solid var(--color-focus)` with `outline-offset: 1px`; reserve `outline: 2px solid transparent` at rest to prevent geometry shift on activate.
- - **Input height ≠ adjacent button height** on the same form — share one base height (44 px floor); 38 px input + 44 px button is the most common form-tuning slop.
- - **Helper-text slot collapses when empty** — reserve `min-height: 1lh` even with no helper / error, so an appearing error doesn't push the page down.
+ - **Input height ≠ adjacent button height** on the same form. Whatever the base height is, the input and the button beside it share it; a 38px input next to a 44px button is the most common form-tuning slop.
- **Disabled signalled by `opacity` alone** — disabled needs three channels: `opacity: 0.55` AND `cursor: not-allowed` AND the native `disabled` attribute (or `aria-disabled="true"`).
+ **[Reflex]** **[M]** **39b. Control height.** Marketing-page controls run 44-52px visual height. App UI and component scope may run 32-40px with the hit-target expansion recipe from [`finish.md`](finish.md) § Control finish (the `::before` inset trick keeps the logical target at 44px; the coarse-pointer 48px rule stands). *This is not a waiver, it is the number:* `finish.md` was always right and this gate used to contradict it. A dense dashboard at 36px passes.
+
+ **[Finish]** **[M]** **39c. Helper-text slot collapses when empty** — reserve `min-height: 1lh` even with no helper or error, so an appearing error doesn't push the page down.
+
## Contrast & readability
Universal — apply to every genre. These gates catch the real-world failures the user flagged: black-text-on-black-button, dark sections with unreadable text, ink-on-ink slop where the LLM forgot to flip the text colour after flipping the surface.
Contrast computation: for every `(color, background-color)` pair on the page, run **APCA Lc** OR **WCAG 2.1 ratio**. OKLCH lightness is a fast pre-check — if `|L_text − L_bg| < 50 %`, the pair likely fails 4.5:1 — confirm with a full calculation.
-40. **[M/R]** **Contrast thresholds.** Does any text, icon, or `:focus-visible` ring fail its threshold against its *computed* background? Pair every `color` declaration with its effective `background-color` and verify. Thresholds: **body text** (under 24 px regular OR under 18 px bold) needs **WCAG 4.5:1 / APCA Lc ≥ 60**; **large text** (≥ 24 px regular / ≥ 18 px bold), **icons**, and **focus rings** need **WCAG 3:1 / APCA Lc ≥ 45**. The most-missed cases: text inside a card that inherits `color` but the card switched to `background: var(--color-paper-2)`; muted text (`var(--color-muted)`) on `var(--color-paper-3)`; a focus ring whose `--color-focus` clears 3:1 against the element but not the page surface.
+40. **[Floor · a11y]** **[M/R]** **Contrast thresholds.** Does any text, icon, or `:focus-visible` ring fail its threshold against its *computed* background? Pair every `color` declaration with its effective `background-color` and verify. Thresholds: **body text** (under 24 px regular OR under 18 px bold) needs **WCAG 4.5:1 / APCA Lc ≥ 60**; **large text** (≥ 24 px regular / ≥ 18 px bold), **icons**, and **focus rings** need **WCAG 3:1 / APCA Lc ≥ 45**. The most-missed cases: text inside a card that inherits `color` but the card switched to `background: var(--color-paper-2)`; muted text (`var(--color-muted)`) on `var(--color-paper-3)`; a focus ring whose `--color-focus` clears 3:1 against the element but not the page surface.
-41. **[M/R]** **The contrast failures that ship most often.** Fail on **any**:
+41. **[Floor · a11y]** **[M/R]** **The contrast failures that ship most often.** Fail on **any**:
- **Button text ≈ button fill** — if the computed text colour and fill are within **5 % lightness AND 0.05 chroma** in OKLCH, fail. This catches the black-on-black bug (`color: var(--color-ink)` on `background: var(--color-ink)` — the model forgot `--color-accent-ink` / `--color-paper`).
- **`--color-accent-ink` missing or unused** — whenever `--color-accent` fills a surface that carries text, `--color-accent-ink` must be defined, verify ≥ APCA Lc 60 / WCAG 4.5:1 against `--color-accent`, and be applied as the `color` on that fill.
- **Dark-section ink-on-ink** — any section / panel whose `background-color` is OKLCH lightness < 50 % must also swap its text colour (typically to `--color-paper`) and ensure nested children inherit. A class that sets `background: <dark>` must set `color: <light>` in the same rule (or be wrapped in a parent that does). Common failure: a `.vs__col:first-child` painted with accent / ink but the inner panels still using default ink-coloured text.
@@ -154,13 +205,15 @@ The CSS stamp at Step 6 should record the result: `· contrast: pass (40–41)`
Universal — apply to every genre. These gates catch the most-recognised AI fingerprints in nav, footer, and hero shape. They sit alongside the structural-fingerprint gate (gate 8): gate 8 catches the *page* fingerprint; 42–45 catch the *chrome* fingerprints that sit on top of it.
-42. **[M]** **Nav fingerprint.** Is the page's `<nav>` (or top-of-page `<header>` with role="banner") the AI default — wordmark-left + 4–5 inline text links centred-or-right + button-right at full viewport width + 1 px hairline border-bottom + white background? If yes, fail unless the brief explicitly justifies N1a (the page has only 2 destinations *and* the routing table for the genre allows N1a). Hallmark output should rotate among N1b, N2, N3, N4, N5, N6, N7, N8, N9, N10, N11, N12, N13 from [`component-cookbook.md`](component-cookbook.md) § Navigation.
+42. **[Reflex]** **[M]** **Nav fingerprint, undeclared.** Is the page's `<nav>` (or top-of-page `<header role="banner">`) the AI default — wordmark-left + 4-5 inline links + button-right at full width + 1px hairline bottom + plain background — **without the stamp naming it**? The default nav is a legitimate answer for a product with real destinations; most of the industry converged on it because it works. Arriving there without deciding is the tell. *Passing:* the stamp's `nav:` field names the shipped pattern (`nav: N1a`), or the nav is any other shape. [`component-cookbook.md`](component-cookbook.md) § Navigation is a place to look for alternatives, not a rotation you owe.
-43. **[M]** **Footer fingerprint.** Is the `<footer>` the AI default — 4 columns of links (Product / Company / Resources / Legal) + social-icon row + tiny copyright at the very bottom + 1 px hairline top-border + neutral grey background? If yes, fail unless the page is a genuine docs root or hub. Default to Ft1, Ft2, Ft4, Ft5, Ft6, Ft7, or Ft8 from [`component-cookbook.md`](component-cookbook.md) § Footers.
+43. **[Reflex]** **[M]** **Footer fingerprint, undeclared.** Is the `<footer>` the AI default — four link columns (Product / Company / Resources / Legal) + social-icon row + tiny copyright + 1px hairline top-border + neutral grey — **without the stamp naming it**? Four columns is an information-architecture solution, and a hub with forty destinations has earned it. *Passing:* the stamp's `footer:` field names the shipped pattern (`footer: Ft3`), or the footer is any other shape. [`component-cookbook.md`](component-cookbook.md) § Footers is a place to look, not an obligation.
-44. **[R/J]** **Hero fit — posture envelope + fits the fold.** Two checks, both on the rendered hero: (a) Does the hero obey its declared posture's envelope ([`hero-discipline.md`](enrichment/hero-discipline.md) § Hero postures; the stamp's `hero:` field, Settled when absent)? Settled / Banner / Corridor / Stage: `padding-block-end` ≥ 1.3× `padding-block-start` inside the posture's min-height range. Ledge inverts it (block-start ≥ 2× block-end, content anchored to the base). Poster waives the ratio only when content is edge- or corner-anchored. A hero matching no envelope, or claiming one and breaking it, fails. (b) On a standard laptop viewport — test at **1280×800** (13″), not just 1440×900 — can the hero's essential content (eyebrow, headline, lede, **and the primary CTA**, plus any hero visual's focal point) all be seen **without scrolling**? This is the other half of gate 6 (which caps the hero's *shape*): this caps its *content*. A hero can satisfy `min-height` and still overflow because the content is intrinsically too tall — usual culprits are an **oversized display clamp**, **loose line-height** (display at ~1.2 instead of 1.0–1.1), a **lede that runs 3+ lines**, or **bloated `padding-block`**. Right-size to the fold: pull the display `clamp()` max down until the headline fits 2–3 lines, set display line-height 1.0–1.1, hold the lede to ~2 lines (≤ ~60 ch), trim hero padding. **Don't overcorrect:** a hero that already fits passes untouched — this never means tiny type or stripped whitespace. Long-form / art-directed statements (a poem broadside, a scroll-poster) may legitimately run taller, but even then the **first screen must read as a complete, deliberate composition** — never a headline sliced in half by the fold. For models that cannot render or see, the numeric heuristics above are the text-only verification path: display `clamp()` max sized so the headline lands in 2-3 lines, display line-height 1.0-1.1, lede at most ~2 lines and at most ~60 ch, and `padding-block` within budget.
+44. **[Reflex]** **[R/J]** **44a. Posture envelope.** The min-height bands in the posture table are guidance with no gate behind them: when a posture's content genuinely needs more room (a Banner carrying a signup form, say), overshoot the band and say so in the stamp. What this gate actually tests is the padding ratio. Does the hero obey its declared posture's padding ratio ([`hero-discipline.md`](enrichment/hero-discipline.md) § Hero postures; the stamp's `hero:` field, Settled when absent)? Settled / Banner / Corridor / Stage: `padding-block-end` ≥ 1.3× `padding-block-start`. Ledge inverts it (block-start ≥ 2× block-end, content anchored to the base). Poster waives it when content is edge- or corner-anchored. *Waivable:* a genuinely symmetric composition wants symmetric padding, and plenty of admired product heroes are built that way. *Guard:* the stamp names a `hero:` posture and **44b passes**. Bottom-heavy padding exists to stop a hero floating off the page; a hero that fits its fold is not floating.
-45. **[J]** **Decorative-without-purpose.** Does the hero contain a decorative element (cursor, scanline, gradient blob, abstract shape, ornament, badge, sticker) that has no semantic anchor in the content? Fail. Decoration must be motivated: a cursor inside a typed command (signals "you'd type next"), a numeral that names an issue / year / version / chapter, a gradient that responds to interaction (HP3 cursor-spotlight), a stamp that names an authorship or date. Random ornaments — a "42" in the corner with no edition meaning, a cursor floating beside a hero, a Pantone chip with no colour rationale — are slop.
+ **[Floor]** **[R/J]** **44b. Fold fit.** On a standard laptop viewport — test at **1280×800** (13″), not just 1440×900 — can the hero's essential content (headline, lede, **the primary CTA**, and any hero visual's focal point) all be seen **without scrolling**? A hero can satisfy `min-height` and still overflow because the content is intrinsically too tall: usual culprits are an **oversized display clamp**, **loose display line-height**, a **lede that runs 3+ lines**, or **bloated `padding-block`**. Right-size to the fold: pull the display `clamp()` max down until the headline lands in 2-3 lines, set display line-height at the tight end of the range in [`typography.md`](typography.md) § Display line-height, hold the lede to ~2 lines (≤ ~60 ch), trim hero padding. **Don't overcorrect:** a hero that already fits passes untouched, and this never means tiny type or stripped whitespace. Long-form and art-directed statements (a poem broadside, a scroll-poster) may legitimately run taller, but even then the **first screen must read as a complete, deliberate composition**, never a headline sliced in half by the fold.
+
+45. **[Reflex]** **[J]** **Decorative-without-purpose.** Does the hero contain a decorative element (cursor, scanline, gradient blob, abstract shape, ornament, badge, sticker) that has no semantic anchor in the content? Fail. Decoration must be motivated: a cursor inside a typed command (signals "you'd type next"), a numeral that names an issue / year / version / chapter, a gradient that responds to interaction (HP3 cursor-spotlight), a stamp that names an authorship or date. Random ornaments — a "42" in the corner with no edition meaning, a cursor floating beside a hero, a Pantone chip with no colour rationale — are slop.
The CSS stamp at Step 6 should record the result alongside contrast: `· nav: N# · footer: Ft# · slop: pass (42–45)`. If any of 42–45 fail, fix before shipping.
@@ -168,25 +221,28 @@ The CSS stamp at Step 6 should record the result alongside contrast: `· nav: N#
Universal — apply to every genre. The page must not invent facts about the user's product, team, or market.
-46. **[M]** **Invented metric.** Does the page contain any quantitative claim — "10× faster", "saves 5 hours per week", "trusted by 50,000+ teams", "99.9 % uptime", "+47 % conversion" — that the user did not supply, that has no source, and that the model fabricated to fill a stat-led layout, comparison row, or proof bar? If yes, fail. The fix is one of: replace the number with `—` and a labelled grey block, replace it with a question to the user ("metric to confirm"), or rebuild the section without the proof slot. Stat-led macrostructures are slop the moment their stats become decorative. **A stat is also never the hero's *sole* headline** — a lead figure carries the hero only alongside a worded headline; a giant number with no words as the dominant hero text is a bare-number tell, so pair it with a line that says what it means. *(See [anti-patterns.md § Invented metrics](anti-patterns.md).)*
+46. **[Floor]** **[M]** **46a. Invented metric.** Does the page contain any quantitative claim — "10× faster", "saves 5 hours per week", "trusted by 50,000+ teams", "99.9 % uptime", "+47 % conversion" — that the user did not supply, that has no source, and that the model fabricated to fill a stat-led layout, comparison row, or proof bar? If yes, fail. **Never waivable: this is truth, not taste.** The fix is one of: replace the number with `—` and a labelled grey block, replace it with a question to the user ("metric to confirm"), or rebuild the section without the proof slot. Stat-led macrostructures are slop the moment their stats become decorative.
+ **[Reflex]** **[M]** **46b. Bare-number hero.** Is a giant figure the hero's *sole* headline, with no worded line saying what it means? *Waivable* when the number is the whole argument and the page is built around it. *Guard:* the figure is user-supplied (so 46a passes) and carries a labelled unit within the hero. *(See [anti-patterns.md § Invented metrics](anti-patterns.md).)*
## Re-drawn UI chrome
-Universal. Hallmark must reuse the user's existing chrome (browser, OS, IDE) instead of redrawing it.
+Universal. A frame is not the tell; a fake frame around fake content is.
-47. **[M]** **Re-drawn chrome.** Did Hallmark hand-build a fake browser bar (URL pill + traffic-light dots), a fake phone frame (rounded rectangle + notch + speaker slit), a fake code-block frame (mock window-chrome around a `<pre>`), a fake terminal frame, or a fake IDE chrome (file tabs + activity bar + sidebar) using HTML/CSS or SVG? If yes, fail. Re-drawn chrome is one of the strongest "looks AI-generated" tells — the model invented a UI that already exists in the user's environment. The fix: use a `<picture>` or `<figure>` containing a real screenshot, or omit the chrome and let the content stand on its own. *(See [anti-patterns.md § Re-drawn UI chrome](anti-patterns.md).)* *Arcade carve-out: the Arcade theme's retro-system aesthetic (pixel type, scanline overlay, starfield, magenta/cyan on violet-black, a blinking cursor anchored to typed text) is allowed as an atmospheric treatment, since it re-draws no specific UI. What stays banned even on Arcade: a fake OS window (title bar + traffic-light dots), a fake browser/phone/IDE frame, or a fake terminal-app chrome around content. The retro signal comes from type and light, never from a re-drawn interface.*
+47. **[Floor]** **[M]** **47a. Fake browser or OS window.** Did Hallmark hand-build a browser bar (URL pill + traffic-light dots) or an OS window title bar in HTML/CSS/SVG? Fail, always, including on Arcade. This is the specific tell: the model re-drew the window the visitor is already looking at. Fix: a real screenshot in `<picture>` / `<figure>`, or drop the chrome. *Arcade carve-out applies only to atmosphere, never to windows: pixel type, scanline overlay, starfield, and a blinking cursor anchored to typed text re-draw no interface and stay legal there.*
+ **[Reflex]** **[M]** **47b. Device, terminal, and editor frames.** Did Hallmark draw a phone / tablet / laptop bezel, terminal chrome, IDE chrome, or a windowed code-block frame? *Waivable when the frame is product photography rather than decoration:* a phone bezel is right when the phone is the product, terminal chrome is right when the terminal is the product. *Guard, both required:* (1) the frame appears **once** on the page, never templated across a grid or repeated per feature card; (2) the content inside is **real** — a genuine screenshot, executable code, or a live component — never lorem and never a mocked-up UI the product does not have. *(See [anti-patterns.md § Re-drawn UI chrome](anti-patterns.md).)*
## Token discipline
Universal. The theme picks the palette and font stack at the top of the run; the rest of the run consumes tokens, never invents them.
-48. **[M]** **Mid-render token improvisation.** Did Hallmark introduce any colour value (`#hex`, `oklch(...)`, `rgb(...)`, `hsl(...)`) or `font-family` declaration *outside* the design tokens defined in `:root` / `[data-theme="..."]` / a variants route-wrapper token block (verbs/variants.md § 4)? If yes, fail. Every colour and every font in the artifact must reference a named token (`var(--color-accent)`, `font-family: var(--font-display)`). Inline OKLCH or one-off hexes are mid-render improvisation — the model picked the theme, then forgot it and freestyled. The fix: lift the value into the token block as a new named variable, or replace it with an existing token. *(See [SKILL.md § Locked tokens](../SKILL.md) and [anti-patterns.md § Mid-render token improvisation](anti-patterns.md).)*
+48. **[Floor]** **[M]** **Mid-render token improvisation.** Did Hallmark introduce any colour value (`#hex`, `oklch(...)`, `rgb(...)`, `hsl(...)`) or `font-family` declaration *outside* the design tokens defined in `:root` / `[data-theme="..."]` / a variants route-wrapper token block (verbs/variants.md § 4)? If yes, fail. Every colour and every font in the artifact must reference a named token (`var(--color-accent)`, `font-family: var(--font-display)`). Inline OKLCH or one-off hexes are mid-render improvisation — the model picked the theme, then forgot it and freestyled. The fix: lift the value into the token block as a new named variable, or replace it with an existing token. *(See [SKILL.md § Locked tokens](../SKILL.md) and [anti-patterns.md § Mid-render token improvisation](anti-patterns.md).)*
## Responsive — clickable affordances
Universal. Buttons, links, and nav items must remain readable as single-line affordances when the viewport shrinks.
-49. **[M/R]** **Two-line clickable text.** Does any button label, primary nav link, footer link, tab label, breadcrumb, or CTA text wrap to two or more lines at any viewport between 320 px and 1920 px? If yes, fail. Clickable text reading on two lines looks broken — visitors read it as a styling error, not as intentional. The fix is one of: shorten the label (the best fix; "Get started free" → "Start free"), set `white-space: nowrap` on the affordance and let the parent reflow, drop a non-essential nav item at narrow widths via `hidden=until-found`, or collapse the nav into a sheet/menu. Never let a CTA or nav link wrap. *(See [responsive.md § Clickable text — never wraps](responsive.md).)*
+49. **[Floor]** **[M/R]** **49a. A wrapping button or nav link.** Does a button label, a CTA, or a primary nav link wrap to two or more lines at any viewport between 320 px and 1920 px? Visitors read it as a styling error, not as intent, and these are the two affordances the page is built to be clicked through. The fix is one of: shorten the label (best; "Get started free" → "Start free"), set `white-space: nowrap` and let the parent reflow, drop a non-essential item at narrow widths via `hidden=until-found`, or collapse the nav into a sheet.
+ **[Reflex]** **[M/R]** **49b. A wrapping secondary label.** A footer link, tab label, or breadcrumb wrapping. *Waivable* when the label is a real phrase in a language that cannot be shortened; localised UIs wrap routinely. *Guard:* the affordance is not in the nav or a CTA row, and it wraps to at most two lines. *(See [responsive.md § Clickable text — never wraps](responsive.md).)*
The CSS stamp at Step 6 should record results: `· honest: pass (46) · chrome: pass (47) · tokens: pass (48) · responsive: pass (49) · icons: pass (30)`. Any failure must be fixed before shipping.
@@ -194,32 +250,43 @@ The CSS stamp at Step 6 should record results: `· honest: pass (46) · chrome:
Universal. Every emitted page must render flawlessly at 320 px, 375 px, 414 px, and 768 px CSS-pixel widths. Gates 34 (no horizontal scroll) and 49 (no two-line clickable text) already cover the headline cases; 50–57 below codify the patterns the marketing-site responsiveness pass uncovered. Eyeball each viewport before marking the output complete.
-50. **[M]** **Image-bearing grid track without `minmax(0, 1fr)`.** Does any `grid-template-columns` (or `grid-template-rows`) containing a `1fr` track render an `<img>` / `<picture>` / image-bearing element inside one of those tracks? If yes, the track must be `minmax(0, 1fr)` instead. Plain `1fr` resolves to `minmax(auto, 1fr)`, where `auto` minimum is the largest content's intrinsic width — for a 1024 + px native image, that's 1024 + px minimum, which pushes the layout past viewport on phones. The fix is one character per track: `1fr` → `minmax(0, 1fr)`.
+50. **[Floor]** **[M]** **Image-bearing grid track without `minmax(0, 1fr)`.** Does any `grid-template-columns` (or `grid-template-rows`) containing a `1fr` track render an `<img>` / `<picture>` / image-bearing element inside one of those tracks? If yes, the track must be `minmax(0, 1fr)` instead. Plain `1fr` resolves to `minmax(auto, 1fr)`, where `auto` minimum is the largest content's intrinsic width — for a 1024 + px native image, that's 1024 + px minimum, which pushes the layout past viewport on phones. The fix is one character per track: `1fr` → `minmax(0, 1fr)`.
+
+51. **[Floor]** **[M]** **Display headers without long-word wrap.** Does any element rendering display-size text (`h1`, `.hero__display`, `.section__title`, `.skill-row__title`, hero-equivalent classes) lack `overflow-wrap: break-word; min-width: 0`? If yes, fail. Long hyphenated words ("AI-generated", uppercase compound brand names) overflow the viewport because the only break opportunity is at the hyphen; `break-word` lets the engine break inside the word as a last resort. **Use `break-word`, not `anywhere`.** `anywhere` also collapses the element's min-content width to a single character, which lets `text-wrap: balance` (F3) produce mid-word breaks it never needed. `break-word` leaves intrinsic sizing alone, so the two rules compose instead of fighting. Escalate to `anywhere` only for a container that can genuinely be narrower than its longest word.
+
+52. **[Floor]** **[M]** **Per-theme section-head override without mobile collapse.** When a theme or variant overrides `.section__head { grid-template-columns: ... }` to anything other than `1fr`, does it also include the mobile-collapse rule, OR does a global `[data-theme] .section__head { grid-template-columns: 1fr }` exist at `@media (max-width: 48rem)` with matching specificity? If neither, fail. Theme-specific 2-column heads keep their template on mobile, the title collides with whatever shares its row, and the page reads broken. (Gate 54 removed the commonest occupant of that second column, but any two-column head still has to collapse.)
-51. **[M]** **Display headers without long-word wrap.** Does any element rendering display-size text (`h1`, `.hero__display`, `.section__title`, `.skill-row__title`, hero-equivalent classes) lack `overflow-wrap: anywhere; min-width: 0`? If yes, fail. Long hyphenated words ("AI-generated", uppercase compound brand names) overflow viewport because the only break opportunity is at the hyphen — `overflow-wrap: anywhere` lets the engine break inside the word as a last resort.
+53. **[Floor]** **[M]** **CSS-only radio tab pattern that scroll-jumps.** When implementing tab toggles via `<input type="radio">` siblings + `:checked` selectors, does the artifact either (a) keep the radios in normal document flow with zero size + opacity 0 (no `position: absolute; top: 0`), OR (b) ship a JS handler that intercepts label clicks, calls `e.preventDefault()`, manually sets `radio.checked = true`, dispatches `change`, and focuses with `{ preventScroll: true }`? If the radios are at `position: absolute; top: 0` with no JS guard, fail. Default-position radios cause the page to jump to the section's top on every tab click — visible on every viewport but most disruptive on mobile.
-52. **[M]** **Per-theme section-head override without mobile collapse.** When a theme or variant overrides `.section__head { grid-template-columns: ... }` to anything other than `1fr`, does it also include the mobile-collapse rule, OR does a global `[data-theme] .section__head { grid-template-columns: 1fr }` exist at `@media (max-width: 48rem)` with matching specificity? If neither, fail. Theme-specific 2-column heads keep their template on mobile, the title wraps onto the section label, and the page reads broken (most visible on Sport: italic Anton title overlapping "02 / EXAMPLES").
+54. **[Floor]** **[M]** **The eyebrow.** Does any element render short inert type before a heading that announces what the heading is about? `FEATURES`, `01 · THE TOUR`, `INTRODUCING`, `◇ workbench`, `Chapter Three`, an inert `✨ Now with AI` badge pill. Auto-fail. Hallmark does not ship one in **any** geometry: not stacked above the heading, not in a side column, not as a pill over a hero, not with a leading ordinal, not scoped to a card. Earlier versions of this gate licensed the stacked variant; that licence is revoked. The geometry was never the problem, the label was.
-53. **[M]** **CSS-only radio tab pattern that scroll-jumps.** When implementing tab toggles via `<input type="radio">` siblings + `:checked` selectors, does the artifact either (a) keep the radios in normal document flow with zero size + opacity 0 (no `position: absolute; top: 0`), OR (b) ship a JS handler that intercepts label clicks, calls `e.preventDefault()`, manually sets `radio.checked = true`, dispatches `change`, and focuses with `{ preventScroll: true }`? If the radios are at `position: absolute; top: 0` with no JS guard, fail. Default-position radios cause the page to jump to the section's top on every tab click — visible on every viewport but most disruptive on mobile.
+ **The test.** Small type before a heading survives only when it carries a **fact**, a **destination**, or an **identifier** the reader would otherwise lack. Delete the line and read the page: if nothing was lost but a name for what comes next, it was an eyebrow. Legal by that test, and never flagged: a `<figcaption>` in a `<figure>`; a `<th>`, `<label for>`, or `<legend>`; a nav or tab label; a byline or a `<time datetime>` dateline; a unit label sitting *after* its figure; a code block's real filename; a `role="status"` chip on live data; and a **linked** announcement chip going somewhere real (`href="#"` does not count, one per page). Banned despite the costume: an inert badge pill over a hero, a bare `01` above each step heading, an inert category tag on a card, a `TRUSTED BY` over a logo row.
-54. **[M]** **Section eyebrow / tag beside the heading (tag-left, header-right).** Does any section render an eyebrow / number / mono-cap label (`01 · THE TOUR`, `02 / FEATURES`, `Chapter Three`) in a column to the left of, or to the right of, the section heading on the same horizontal row? Auto-fail. The pattern reads as a templated editorial-SaaS tell within seconds. When an eyebrow is used at all (see [`anti-patterns.md § Eyebrow on every section`](anti-patterns.md) — default OFF), the heading goes **directly underneath it in the same column**, vertical stack only. Concretely: **any `<header>`, `<div>`, or `<section>` wrapper — regardless of class name (`.section__head`, `.workbench__head`, `.pricing__head`, `.catches__head`, `.foo__intro`, anything macrostructure- or section-specific)** — that contains both an eyebrow / label / number / kicker element AND a heading element MUST resolve to single-column layout: `display: block`, `display: flex; flex-direction: column`, or `display: grid; grid-template-columns: 1fr` (or `minmax(0, 1fr)`). Any multi-column grid on such a wrapper (`grid-template-columns: 1fr 2fr`, `minmax(0, 0.4fr) minmax(0, 1fr)`, `auto 1fr`, etc.) is banned. **The rule binds on the *content shape* — eyebrow + heading in the same wrapper — not on a specific class-name allowlist.** It supersedes the "Left-margin" axis in [`structure.md`](structure.md) and the "Hanging headers" pattern in [`layout-and-space.md`](layout-and-space.md) for any head that carries an eyebrow. **NOT bypassable by "preserve structural parity" / "mirror this reference" / "match the prior build" instructions** — if a reference build ships the banned pattern (most pre-rule builds do), silently flatten it in the new build. The rules win over parity. Reference builds may pre-date this gate; the gate is authoritative.
+ **The fix is never just deletion.** [`section-entry.md`](section-entry.md) carries twelve other ways to open a section, ten of which are already built elsewhere in the skill. When the sequence is genuine, reach for a real `<ol>` with `counter()` or set the numeral at graphic scale. One honest edge case: when a label is a section's *only* heading (`aria-labelledby` pointing at it, no `<h1>-<h6>` anywhere), the gate WARNs instead, and the fix is promoting it to `<h2>`.
-55. **[M]** **All-caps display heads with line-height < 1.0 → cap-collision on wrap.** Does any display-size element (`.hero__display`, `.section__title`, `h1`, `h2`, or anything `≥ --text-2xl`) declare both `text-transform: uppercase` AND a `line-height` (or `--lh-tight`) below `1.0`? If yes, fail. Uppercase glyphs have no descenders and their cap-tops sit at the very top of the line box — at `line-height: 0.94` (the old Manifesto / Sport / Brutal default) the cap-tops of line N+1 visibly collide with the baseline or commas of line N when the title wraps. The condensed display faces (Anton, Inter Tight 900, Bebas Neue) make this worse. **Floor for all-caps display heads is `line-height: 1.0`; recommended `1.02–1.08`.** Either bump `--lh-tight` ≥ 1.0 for the theme, or drop `text-transform: uppercase` on the display element. Most visible when a two-line `.section__title` wraps with a trailing comma on line one ("SAME PROMPT, TWO / DIFFERENT OUTPUTS.") — the comma + cap-D fuse into a single glyph blob.
+ **This one is a house rule, and it is stricter than the field.** Plenty of admired pages ship eyebrows; Hallmark does not, because it is the tell the skill is named for. It is the one Floor gate that is not defended by "no good designer would do this", and it is never waivable.
-56. **[M/R]** **Sticky element at `top: 0` below a sticky page-level nav → bleed.** Does the artifact declare `position: sticky; top: 0;` on any element OTHER than the page's top-level nav / banner / header, when a sticky `<header>` / `<nav>` / `.banner` also exists at `top: 0` (i.e. there are two sticky-at-top-0 elements on the page)? Auto-fail. Both stick to the viewport top during scroll and overlap; the deeper-in-DOM element paints over the nav (visible as a "section header bleeding into the nav bar" glitch). Fix: define a `--banner-height` token (~44–64 px depending on nav design) and offset every secondary sticky to `top: var(--banner-height)`, so it docks **beneath** the nav. Also give the nav a higher z-index than in-page sticky elements — split `--z-sticky` (in-page, e.g. 200) from `--z-sticky-nav` (top nav, e.g. 300) so the nav always out-paints when sticky boxes momentarily overlap. This gate fires only when the page actually has sticky elements (S3 sticky-pinned section heads, F2 sticky-scroll feature stacks, sticky tables-of-contents); pages without sticky behaviour pass trivially.
+55. **[Floor]** **[M]** **55a. Cap collision on wrap.** Does a display-size element (`.hero__display`, `.section__title`, `h1`, `h2`, anything `≥ --text-2xl`) declare both `text-transform: uppercase` AND a `line-height` below `1.0` **while being able to wrap** (it renders on more than one line at 375 px and carries no `white-space: nowrap`)? Uppercase glyphs have no descenders and their cap-tops sit at the very top of the line box, so at `0.94` the cap-tops of line N+1 collide with line N's baseline and a trailing comma fuses into the cap beside it. Condensed faces (Anton, Inter Tight 900, Bebas Neue) make it worse. A rendering defect, not a preference. Bump `--lh-tight` to ≥ 1.0, or drop the uppercase.
+ **[Reflex]** **[M]** **55b. Tight all-caps lockups.** Does a single-line-guaranteed all-caps element (a one-word wordmark, a masthead, a stat) run below the recommended `1.02-1.08`? *Waivable:* a nowrap wordmark at 0.85 is standard lockup practice and cannot collide with a line that does not exist. *Guard:* the element cannot wrap at 320 px.
-57. **[J]** **Studied DNA discarded for a catalog theme.** Did a `study` diagnosis emit earlier in the conversation, AND does the build's CSS stamp's `theme:` field name a catalog theme (Specimen, Midnight, Brutal, Garden, Atelier, Newsprint, Terminal, Manifesto, Almanac, Sport, Studio, Riso, Bloom, Coral, Cobalt, Aurora, Editorial, Carnival, Lumen, Hum) rather than `studied-DNA (source: ...)` — without the user having explicitly pivoted ("use Newsprint instead", "ignore the DNA", "rotate to a different theme")? Auto-fail. The studied DNA was meant to be the system (SKILL.md § 2.6 Condition 0); defaulting back to catalog is the attractor pull. Fix: re-emit using the studied DNA's tokens directly (paper OKLCH, accent OKLCH, named candidate fonts, macrostructure, archetypes) and update the stamp to `theme: studied-DNA (source: <URL or image>)` with the inline values. This gate is trivially passed when no recent study exists in conversation scope.
+56. **[Floor]** **[M/R]** **Sticky element at `top: 0` below a sticky page-level nav → bleed.** Does the artifact declare `position: sticky; top: 0;` on any element OTHER than the page's top-level nav / banner / header, when a sticky `<header>` / `<nav>` / `.banner` also exists at `top: 0` (i.e. there are two sticky-at-top-0 elements on the page)? Auto-fail. Both stick to the viewport top during scroll and overlap; the deeper-in-DOM element paints over the nav (visible as a "section header bleeding into the nav bar" glitch). Fix: define a `--banner-height` token (~44–64 px depending on nav design) and offset every secondary sticky to `top: var(--banner-height)`, so it docks **beneath** the nav. Also give the nav a higher z-index than in-page sticky elements — split `--z-sticky` (in-page, e.g. 200) from `--z-sticky-nav` (top nav, e.g. 300) so the nav always out-paints when sticky boxes momentarily overlap. This gate fires only when the page actually has sticky elements (S3 sticky-pinned section heads, F2 sticky-scroll feature stacks, sticky tables-of-contents); pages without sticky behaviour pass trivially.
+
+57. **[Floor · Ledger]** **[J]** **Studied DNA discarded for a catalog theme.** Did a `study` diagnosis emit earlier in the conversation, AND does the build's CSS stamp's `theme:` field name a catalog theme (any of the 24 in [`theme-axes.md`](theme-axes.md); that table is the list, so this gate cannot drift when the catalog grows) rather than `studied-DNA (source: ...)` — without the user having explicitly pivoted ("use Newsprint instead", "ignore the DNA", "rotate to a different theme")? Auto-fail. The studied DNA was meant to be the system (SKILL.md § 2.6 Condition 0); defaulting back to catalog is the attractor pull. Fix: re-emit using the studied DNA's tokens directly (paper OKLCH, accent OKLCH, named candidate fonts, macrostructure, archetypes) and update the stamp to `theme: studied-DNA (source: <URL or image>)` with the inline values. This gate is trivially passed when no recent study exists in conversation scope.
The CSS stamp at Step 6 records mobile pass alongside contrast: `· mobile: pass (34, 49, 50–57)`.
---
-## The finish tier (F-checks)
+## The Finish tier
+
+Six numbered gates sit in this tier — **31** (Lottie where CSS would do), **35** (highlighter and underline geometry), **36** (flex rows not vertically centred), **38** (outlier face in more than two slots) — plus **39c** (helper-slot collapse), and alongside them the nine **F-checks** sloplint runs. They are all the same kind of thing: craft detail that is invisible at arm's length. Confirm or fix each at Step 7 with the same seriousness as a WARN; none of them ever blocks a ship the Floor approved.
+
+The F-checks keep their own ids because they are not numbered gates, but they are Finish-tier members, not a separate system:
-sloplint also runs nine FINISH checks, ids F1-F9. They are polish, not gates: confirm or fix each at Step 7 with the same seriousness as a WARN, but never count them in the 58, and never let one block a ship the gates approved. The rules live in [`finish.md`](finish.md) (F1-F6), [`layout-and-space.md`](layout-and-space.md) § Surfaces (F7), [`scroll-choreography.md`](scroll-choreography.md) (F8), and the imagery kit's avatar discipline (F9, whose fake-avatar half is the tier's one FAIL).
+- **F1** straight quotes in prose · **F2** `...` instead of `…` · **F3** `text-wrap: balance` on display heads · **F4** more than one filled-primary button recipe · **F5** icon in a coloured circle coin · **F6** display-size numerics without tabular figures · **F7** one container recipe stamped on six or more selectors · **F8** more than one scroll-choreography pattern · **F9** fake-human avatar hotlinks (FAIL) / person-keyword stock URLs (WARN).
-- **F1** straight quotes in prose · **F2** `...` instead of `…` · **F3** no `text-wrap: balance` on display heads · **F4** more than one filled-primary button recipe · **F5** icon in a coloured circle coin · **F6** display-size numerics without tabular figures · **F7** one container recipe stamped on six or more selectors · **F8** more than one scroll-choreography pattern · **F9** fake-human avatar hotlinks (FAIL) / person-keyword stock URLs (WARN).
+Rules live in [`finish.md`](finish.md) (F1-F6), [`layout-and-space.md`](layout-and-space.md) § Surfaces (F7), [`scroll-choreography.md`](scroll-choreography.md) (F8), and the imagery kit's avatar discipline (F9, whose fake-avatar half is the tier's one FAIL, because a fabricated human is a truth problem, not a polish one).
---
-If any answer is **yes**, fix it. Do not ship slop.
+**Nothing ships with an open Floor finding.** Reflex findings are either fixed or waived on the record. Finish findings are read and answered, never ignored.
diff --git a/skills/hallmark/references/structure.md b/skills/hallmark/references/structure.md
index 3d45c4e..dae89e6 100644
--- a/skills/hallmark/references/structure.md
+++ b/skills/hallmark/references/structure.md
@@ -14,13 +14,13 @@ Where does a section's title live in space? Pick one per page.
| Pattern | Description | Real-world reference |
| --- | --- | --- |
-| **Left-margin** | ⚠️ **Opt-in only — never default.** Eyebrow / number / label in a narrow left column with heading + body to the right. Reads as a templated-editorial AI tell when applied to SaaS / dev-tool / consumer pages. Permitted ONLY when the user explicitly asks for an editorial / specimen layout AND no eyebrow is paired with the heading (label may sit beside body copy; heading must stay in its own row above). The eyebrow-left / heading-right variant is banned outright by slop-test gate 54. | The New York Times Magazine; our Specimen theme — when the user explicitly requests that voice. |
+| **Left-margin** | A narrow left column carrying marginalia — a caption, a footnote, a date, a sidenote — beside a wide column of body copy. The margin material sits beside the *body*, never beside the heading: a label paired with a heading is an eyebrow whatever column it lands in (gate 54). | The New York Times Magazine; Tufte-style sidenotes. |
| **Hanging** | Heading floats in negative space *above* the section, with generous breathing room. | David Airey's portfolio; minimal modernist. |
| **Centered display** | Heading dominates centre stage, symmetrical. Formal, welcoming, can feel static if used everywhere. | Apple product pages; Atelier-style runway invitations. |
| **Bottom-aligned** | Heading anchors the *base* of a section, content flows above. Inverts hierarchy. | Swiss editorial; Newsprint masthead-below pattern. |
| **Overlapping image** | Heading layered atop photography or colour block. Demands strong contrast. | Pentagram project pages; Manifesto posters. |
| **Sticky / pinned** | Heading remains visible while content scrolls beneath. Orientation aid. | GSAP ScrollTrigger docs; Almanac-style references. |
-| **Numbered display** | ⚠️ **Opt-in only — never default.** "01." with a rule line and the heading right beside it. Procedural, sequenced. Banned for default SaaS / consumer / dev-tool pages by slop-test gate 54 (the tag-beside-heading pattern is a templated tell). Permitted only when the user explicitly asks for ordinal / chaptered numbering AND the macrostructure is Long Document, Manifesto, or Catalogue numbered. Even then, prefer the stacked variant: number on its own line above the heading. | Rauno Freiberg's portfolio — when the user explicitly invokes that voice. |
+| **Numbered display** | A genuinely ordered run whose figures come from `<ol>` + `counter()` or from one numeral built at graphic scale. Procedural, sequenced. A small `01` typed above or beside the heading is an eyebrow (gate 54); the ordinal has to come from the markup or from the composition. See [`section-entry.md`](section-entry.md) §§ 6-7. | Rauno Freiberg's portfolio. |
| **Inline with body** | No section break — the heading emerges from the paragraph flow. Conversational. | Medium articles; long-form essays. |
**Coherence, not a fixed side.** Any of these placements is fair game — the head's alignment just has to *cohere* with the body it introduces rather than mismatch it by accident. A narrow centred head stranded over full-width, left-flush content (often a `margin-inline:auto` head above a wide grid) is the tell — not centring or left-flushing as such. See [`layout-and-space.md`](layout-and-space.md) § Asymmetry techniques.
diff --git a/skills/hallmark/references/study.md b/skills/hallmark/references/study.md
index 9652285..3f3f21c 100644
--- a/skills/hallmark/references/study.md
+++ b/skills/hallmark/references/study.md
@@ -141,7 +141,8 @@ Pick the role each face is playing:
- **Display role.** What is carrying the headline? Pick from: *italic editorial serif · roman editorial serif · heavy condensed sans · soft geometric sans · expressive variable sans · monospace · pixel · ornamental script*.
- **Body role.** What is carrying the prose? *roman serif · italic serif · neutral grotesque · soft geometric sans · monospace*.
-- **Label role.** What is carrying eyebrows, captions, micro-labels? *small-caps serif · monospace · uppercase grotesque · italic body · none (no labels visible)*.
+- **Label role.** What is carrying captions, meta rows, folios, micro-labels? *small-caps serif · monospace · uppercase grotesque · italic body · none (no labels visible)*. Diagnose section eyebrows if the source has them, but never rebuild with one: gate 54 binds on the output, not the source.
+- **Section entry.** How does the source open a section — a rule, a change of paper, a numeral, a drop cap, nothing? Record the move; it is a reusable part of the DNA. See [`section-entry.md`](section-entry.md).
- **Pairing logic.** Same family with weight/italic split, or two different families? If two, what's the contrast — *editorial serif + grotesque body, mono labels* (the modern editorial agency look), or *condensed display + body sans + mono labels* (technical), etc.?
- **Display weight.** Light (≤ 300), regular (400–500), heavy (700+), extra-bold (800+).
diff --git a/skills/hallmark/references/theme-axes.md b/skills/hallmark/references/theme-axes.md
index ca21971..e954bbe 100644
--- a/skills/hallmark/references/theme-axes.md
+++ b/skills/hallmark/references/theme-axes.md
@@ -31,4 +31,31 @@ Bands: paper **dark** < 30% L · **mid** 30-85% · **light** > 85%. Accent: **wa
| Ledger | dark (navy 20%) | grotesk-sans + tabular mono (Hanken) | chromatic-teal (~185) |
| Arcade | dark (violet-black 16%) | pixel display (Silkscreen) | chromatic-magenta (~340) + cyan |
-When two candidate themes match on two of the three axes, pick a more distant one. Known close pairs that rule arbitrates: Aurora ~172° vs Ledger ~185° (same teal family), Specimen vs Atelier (both light/high-contrast-serif/warm; faces and registers differ), Sport vs Editorial (both light/display-condensed/warm; scoreboard vs magazine register). All display is roman; italic headers are banned globally (gate 38a).
+When two candidate themes match on two of the three axes, pick a more distant one. Known close pairs that rule arbitrates: Aurora ~172° vs Ledger ~185° (same teal family), Specimen vs Atelier (both light/high-contrast-serif/warm; faces and registers differ), Sport vs Editorial (both light/display-condensed/warm; scoreboard vs magazine register). Display is roman by default; a single italicised word inside a roman heading is banned outright (gate 38a-i), and an italic display *system* is a Reflex gate a theme can carry if it declares one (38a-ii).
+
+---
+
+## The theme contract
+
+**A theme is a material, not a plan.** It says what the page is made of. It does not say what the page contains, in what order, or in what shape. Two pages in the same theme should not share a section sequence.
+
+A theme file **may** carry:
+
+- palette values and their roles (paper, ink, muted, accent, accent-ink, focus, rule), in OKLCH
+- the type pairing, the role each face plays, and its tracking, weight, and case conventions
+- rule weight, radius, shadow stance, border treatment
+- texture and material: grain, overprint, scanline, deckle, and their budgets
+- motion character: how fast this theme moves and how it eases
+- what the theme feels like, and what it is *not* (its nearest neighbour in the catalog, and the difference)
+- three to six do-nots that are specific to **this theme's own failure mode**, not restatements of the global gates
+
+A theme file **may not** carry:
+
+- a section sequence, a page outline, or a "structural signature"
+- a mandated nav, footer, hero, or enrichment archetype
+- HTML scaffolds or page-part class names (`.masthead`, `.panel`, `.work`, `.meter`)
+- verbatim copy, invented brand names, invented people, or taglines that read as strings to ship
+- an eyebrow, in any form (gate 54)
+- counts that fix a layout ("always three cells, never two, never four")
+
+Where a theme genuinely invented something structural worth keeping, it belongs in the Library as an **optional** entry any brief can reach for, never as a thing this theme's builds must contain. The `## Build hint` block in each file is a token sketch, not a page: `:root` values and the two or three face rules that make the theme recognisable, and nothing that names a page part.
diff --git a/skills/hallmark/references/themes/almanac.md b/skills/hallmark/references/themes/almanac.md
index b744d70..4594842 100644
--- a/skills/hallmark/references/themes/almanac.md
+++ b/skills/hallmark/references/themes/almanac.md
@@ -1,8 +1,8 @@
# Theme - Almanac
-Editorial-reference register. The page for a **data yearbook, a field guide, a reference manual, a technical handbook, an index or catalogue of entries** - the almanac / whole-catalog school, executed in **cool slate-grey stock, not white**, with **tables and figures as the hero**. A cool mid-band paper ground (`oklch(84% 0.012 245)`), ruler-drawn hairlines, tabular figures that line up to the decimal, and one **deep bookish ink-blue** that never gets loud. It reads like a trusted reference: dense, indexed, exact.
+The editorial-reference register, executed in **cool slate stock, not white**, with **tables and figures as the material**. A cool mid-band paper ground, ruler-drawn hairlines, tabular figures that line up to the decimal, and one deep bookish ink-blue that never gets loud. It reads like a trusted reference: dense, indexed, exact.
-Loaded eagerly by SKILL.md Step 3 when the catalog pick is `almanac`. Tokens: [`site/css/tokens.css`](../../../../site/css/tokens.css) under `[data-theme="almanac"]`.
+The material, in one line: **slate stock, two rule weights, tabular figures, one library-stamp blue.**
## Axes (diversification)
@@ -12,111 +12,89 @@ Loaded eagerly by SKILL.md Step 3 when the catalog pick is `almanac`. Tokens: [`
## Reference register
-Works in Progress · Our World in Data · Stripe Press · Low-Tech Magazine · Whole Earth Catalog · The Pudding · Baymard · Poor Richard's Almanack. The aesthetic: the reference yearbook and the data almanac - a cool indexed canvas, hairline tables, tabular figures, a sticky side-rail of contents, mono entry-numbers. **Never name any of these in the output.**
+Works in Progress · Our World in Data · Stripe Press · Low-Tech Magazine · Whole Earth Catalog · The Pudding · Baymard · Poor Richard's Almanack. **Never name any of these in the output.**
-**Patron-saint reference (internal):** *an old farmer's almanac reset in a Swiss grid* - its tables kept honest by hairlines and tabular figures, its entries numbered in mono. When in doubt ask "does this read like a trusted reference, or like a brochure?" Keep the former.
+The material to match: a cool indexed canvas, hairline tables, tabular figures, mono entry-numbers. Internally: *an old farmer's almanac reset in a Swiss grid*, its tables kept honest by hairlines and tabular figures. When in doubt ask "does this read like a trusted reference, or like a brochure?" Keep the former.
-## Required dependencies
+## Palette
-1. **Fonts** - **Hanken Grotesk** (display + body, 400/500/600), **Newsreader** (serif, running entries + body emphasis, optical-sizing), **IBM Plex Mono** (entry numbers, units, table headers, UPPERCASE labels). Google Fonts:
- ```html
- <link href="https://fonts.googleapis.com/css2?family=Hanken+Grotesk:wght@400;500;600;700&family=Newsreader:ital,opsz,wght@0,6..72,400;0,6..72,500;1,6..72,400&family=IBM+Plex+Mono:wght@400;500;600&display=swap" rel="stylesheet" />
- ```
-2. **A reveal + number-tick script** - one `IntersectionObserver` adding `.is-in` (fade + ~8px rise, ease-out, `0.85×` speed - functional, not showy). Plus **number-tick counters** that count `0 → final` for stats, dates, prices on first reveal, then hold.
-3. **A sticky side-rail with scroll-spy** - the left index (N3) stays pinned; the active section highlights as you scroll. `role="navigation"`, keyboard-reachable, reduced-motion safe.
+Canonical values live in [`site/css/tokens.css`](../../../../site/css/tokens.css) under `[data-theme="almanac"]`.
-## Signature moves
+- `--color-paper: oklch(84% 0.012 245)` - cool slate stock, never `#fff`
+- `--color-paper-2` (`81%`) - alternating table rows
+- `--color-paper-3` (`77%`) - wells and callout blocks
+- `--color-ink: oklch(16% 0.020 245)` - cool near-black, 11.9:1 on the stock
+- `--color-muted: oklch(42% 0.016 245)` - meta, labels
+- `--color-accent: oklch(38% 0.135 250)` - deep ink-blue, under 5% of any viewport
+- `--color-rule: oklch(74% 0.012 240)` - the hairline that draws the grid
+- `--color-rule-2: oklch(38% 0.018 240)` - the one emphatic line under a head or `thead`
-1. **Cool slate stock, never `#fff`** - `oklch(84% 0.012 245)`, with `paper-2` (`81%`) for alternating table rows and `paper-3` (`77%`) for the side-rail well and callout blocks. Ink is cool near-black `oklch(16% 0.020 245)`, never `#000` (11.9:1 on the stock); muted meta sits at `oklch(42% 0.016 245)`.
+The accent is a stamp, not a flood: links, one figure, a single primary control. Everything else is ink on bond-grey.
-2. **Tables and figures are the hero** - the almanac *is* its data. Hairline-ruled tables with `font-variant-numeric: tabular-nums`, right-aligned numerics, decimals that line up, units in mono (charts, when a table earns one: [`data-viz.md`](../data-viz.md)). Lead with a data block, an index, or a spec table - never a photograph.
+## Typography
-3. **Two rule weights, used deliberately** - light hairline `--color-rule` (`oklch(74% 0.012 240)`) draws the grid and row separators; the dark `--color-rule-2` (`oklch(38% 0.018 240)`) draws the one emphatic line under a section head or table `thead`. **No boxed cards, no shadows.** Depth is rules, not blur.
+Three families.
-4. **Three-column encyclopedia density** - reference chunks in a three-column-equal grid, scannable, each entry numbered. Dense by design, not airy. This is the almanac's body posture; a single luxe hero column is wrong here.
+- **Display** - Hanken Grotesk 600, tracking `-0.014em`. Grotesk sets structure.
+- **Body / running entry** - Newsreader, optical-sizing, at the `64ch` measure. Serif sets reading. Italic is in-paragraph emphasis only, never a heading.
+- **Label** - IBM Plex Mono, UPPERCASE, `0.06em` (`--tracking-label`): captions, table headers, units, dates, folios, entry numbers inside a real `<ol>`. It is a machine-readout voice carrying real values; it never sits above a heading to announce it.
-5. **Sticky side-rail index (N3)** - a pinned left rail listing sections/entries with mono numbers, active item in the ink-blue accent. The page is navigated like a book's contents, not scrolled like a brochure. **Not a floating pill, not a masthead.**
+**Tabular figures are load-bearing.** `font-variant-numeric: tabular-nums` wherever a figure appears, numerics right-aligned, decimals lined up, units in mono. Charts, when a table earns one: [`data-viz.md`](../data-viz.md).
-6. **Mono entry-numbers and labels** - IBM Plex Mono, UPPERCASE, `0.06em` tracking (`--tracking-label`) for eyebrows, entry numbers (`§ 01`, `No. 214`), units, dates, table headers. The machine-readout voice against the Hanken Grotesk display.
+## Material
-7. **Newsreader for the running entry** - the one serif carries long-form entry prose and pull-ledes at the `64ch` measure, italic reserved for in-paragraph emphasis only (never a heading). Grotesk sets structure; serif sets reading.
-
-8. **One deep ink-blue, sparingly** (< 5% of any viewport) - `oklch(38% 0.135 250)` on links, the active rail item, one figure or the single primary control. Dark and quiet; everything else is ink-on-bond-grey. The accent is a stamp, not a flood.
+- **Two rule weights, used deliberately.** The light hairline draws the grid and row separators; the dark rule draws one emphatic line under a head or a `thead`. **No boxed cards, no shadows.** Depth is rules, not blur.
+- **No radius to speak of.** Square or near-square; this is ruled paper, not a card surface.
+- **No texture.** The stock carries the warmth; grain, overprint, and scanline all belong to other themes.
+- **Images** are small, outlined, inline to the measure. They never outgrow the type.
## Motion
-Functional and sparse, like turning a reference page. Section reveals fade + rise at `0.85×` ease-out; number-tick counters run once to their final value on reveal, then hold; the side-rail active item shifts as sections cross. **No bounce, no parallax, no autoplay, no marquee.** Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static, counters at final value, fully visible.
+Functional and sparse, like turning a reference page. Section reveals fade and rise ~8px at `0.85×` ease-out, functional rather than showy. Number-tick counters run `0 → final` once on reveal for stats, dates, and prices, then hold. **No bounce, no parallax, no autoplay, no marquee.** Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static, counters at final value, fully visible.
+
+## Voice range
-## Anti-patterns
+Declarative, dated, exact: cite the figure, the edition, the source, the unit. Never *seamless, revolutionary, magical, effortless, game-changing, cutting-edge, supercharge, unlock*. Never "click here."
+
+## Do-nots (this theme's own failure modes)
- **No electric blue.** Almanac's accent is dark bookish `L38`; the live `L58` cobalt is a sibling's lane.
-- **No pure `#fff` / `#000`.** Cool bond-grey paper, cool near-black ink.
-- **No warm paper.** Warm grey is Newsprint's; Almanac is cool (hue 240-250).
+- **No pure `#fff` / `#000`.** Cool slate paper, cool near-black ink, always tinted hue 240-250.
+- **No warm paper.** Warm grey is Newsprint's; Almanac is cool.
- **No boxed cards, no drop-shadows, no glassmorphism.** Hairline tables and two rule weights carry every surface.
-- **No photographic or image-led hero** - data, tables, or an index lead; images are small, outlined, inline to the measure.
-- **No single luxe centered hero column** (that is Atelier/Garden) - Almanac is dense, three-column, left-biased.
-- **No justified newspaper columns** - that is Newsprint's broadsheet; Almanac is an encyclopedia grid, ragged-right.
+- **No justified newspaper columns.** That is Newsprint's broadsheet; Almanac is ragged-right.
- **No pill / gradient CTA.** One quiet ink-blue control or a typographic link; name the destination.
-## Macrostructure affinity / rejection
-
-**Almanac loves.**
-
-- **Long Document** - a reference manual or guide: prose, tables, a running index.
-- **Catalogue** - the almanac as an indexed run of numbered entries.
-- **Stat-Led** - a data yearbook: tabular figures, number-tick, sourced tables.
-- **index-first** - a contents-led page navigated by the side-rail.
-- **Specimen** - a dense data/spec specimen with hairline spec tables.
-
-**Almanac refuses.**
-
-- **Marquee Hero** - too kinetic; Almanac opens on an index or a table, not a sweep.
-- **Photographic** - image-led; Almanac leads with data and type.
-- **Manifesto** - too loud; Almanac is neutral, trusted reference.
-- **Letter** - too intimate; Almanac is a reference, not a note.
-
-## Voice fixtures
-
-Declarative, dated, exact. Cite the figure, the edition, the source.
-
-- *"Everything worth knowing about the harvest, indexed."*
-- *"Edition 2026. 214 entries, cross-referenced."*
-- *"Sunrise 6:12. Sunset 20:41. First frost by the 14th."*
-- *"Figures updated quarterly. Sources at the foot of each table."*
-- *"Look it up once. Trust it after."*
-
-Never any of: *seamless, revolutionary, magical, effortless, game-changing, cutting-edge, supercharge, unlock*. Never "click here." Cite the entry, the unit, the number.
-
-## How Almanac differs from neighbouring themes
+## How Almanac differs from its neighbours
| vs | difference |
|---|---|
-| **Newsprint** (editorial, light, dense) | Newsprint is warm `92%` paper + roman-serif display (Playfair) + brick accent + justified broadsheet columns + a masthead. Almanac is cool `84%` slate stock + grotesk display (Hanken) + ink-blue + a ragged three-column encyclopedia grid + a side-rail. Broadsheet vs reference book settles it. |
-| **Cobalt** (modern-minimal, cool, blue) | Same cool + blue + mono labels, but Cobalt is `98.5%` engineered near-white + **electric** `L58` cobalt + Space Grotesk + code-as-hero + a dark graphite band + ⌘K. Almanac is greyer bond + **deep** `L38` bookish blue + a Newsreader serif + tables-as-hero + a side-rail. Reference book vs dev-tool. |
-| **Garden** (editorial, light) | Garden is warm `95.5%` + roman-serif (Young Serif) + leaf-green + marginalia + generous negative space + calm springs. Almanac is cool + grotesk + ink-blue + dense three-column + functional `0.85×` motion. Botanical calm vs data density. |
+| **Newsprint** | Warm `92%` paper, roman-serif display (Playfair), brick accent, justified broadsheet columns. Almanac is cool `84%` slate stock, grotesk display, ink-blue, ragged-right. Broadsheet vs reference book settles it. |
+| **Cobalt** | Same cool + blue + mono labels, but Cobalt is `98.5%` engineered near-white with **electric** `L58` cobalt and Space Grotesk. Almanac is greyer bond, **deep** `L38` bookish blue, a Newsreader serif. Dev-tool vs reference book. |
+| **Garden** | Warm `95.5%`, roman serif (Young Serif), leaf-green, generous negative space, calm springs. Almanac is cool, grotesk, ink-blue, dense, functional `0.85×` motion. Botanical calm vs data density. |
-## Test brief expectations
+## When the brief routes here
-Almanac should be a candidate when the brief mentions:
+*almanac · yearbook · field guide · reference · handbook · manual · index · catalogue · encyclopedia · data · figures · tables · statistics · research · dataset · records · directory · glossary · compendium · specifications*. Categories: data and research sites, reference manuals, field guides, knowledge bases, directories, public datasets, technical handbooks, editorial data journalism. Tone: exact, indexed, trusted, dense, scholarly, matter-of-fact, cool.
-- *almanac · yearbook · field guide · reference · handbook · manual · index · catalogue · encyclopedia · data · figures · tables · statistics · research · dataset · records · directory · glossary · compendium · specifications*
-- Product categories: *data / research site · reference manual · field guide · knowledge base · directory · public dataset · technical handbook · editorial data journalism*
-- Emotional tone: *exact · indexed · trusted · dense · scholarly · matter-of-fact · reference-grade · cool*
-
-Briefs that are warm / broadsheet / image-led / atmospheric route elsewhere (Newsprint for the newspaper, Garden for the warm serif, the atmospheric themes for mood). When the brief is a **reference full of data** and wants to *show the tables*, it is Almanac.
+Warm, broadsheet, image-led, or atmospheric briefs route elsewhere. When the brief is a reference full of data and wants to *show the tables*, it is Almanac.
## Build hint
+```html
+<link href="https://fonts.googleapis.com/css2?family=Hanken+Grotesk:wght@400;500;600;700&family=Newsreader:ital,opsz,wght@0,6..72,400;0,6..72,500;1,6..72,400&family=IBM+Plex+Mono:wght@400;500;600&display=swap" rel="stylesheet" />
+```
+
```css
html, body { overflow-x: clip; }
body { background: var(--color-paper); color: var(--color-ink);
font-family: var(--font-body); font-weight: 400; }
/* Two rule weights: hairline grid + one emphatic head rule */
-.rule { border-top: 1px solid var(--color-rule); }
-.head-rule { border-bottom: 2px solid var(--color-rule-2); }
+.rule { border-top: 1px solid var(--color-rule); }
+.rule--firm { border-bottom: 2px solid var(--color-rule-2); }
-/* Tables are the hero - tabular, right-aligned, hairline-ruled */
+/* Tabular, right-aligned, hairline-ruled */
table { border-collapse: collapse; font-variant-numeric: tabular-nums; }
thead th { border-bottom: 2px solid var(--color-rule-2);
font: 500 var(--text-sm)/1 var(--font-mono);
@@ -124,14 +102,14 @@ thead th { border-bottom: 2px solid var(--color-rule-2);
td.num { text-align: right; font-variant-numeric: tabular-nums; }
tbody tr:nth-child(even) { background: var(--color-paper-2); }
-/* Mono labels + entry numbers */
+/* Mono label voice: captions, headers, units, entry numbers */
.label { font: 500 var(--text-xs)/1 var(--font-mono);
text-transform: uppercase; letter-spacing: var(--tracking-label);
color: var(--color-muted); }
-/* Newsreader for the running entry; deep ink-blue as the one signal */
-.entry { font-family: var(--font-serif); max-width: var(--measure); }
-a, .rail__item[aria-current] { color: var(--color-accent); }
+/* Newsreader carries running prose; ink-blue is the one signal */
+.prose { font-family: var(--font-serif); max-width: var(--measure); }
+a { color: var(--color-accent); }
/* Functional reveal - 0.85x, no showmanship */
.reveal { opacity: 0; transform: translateY(8px);
@@ -142,4 +120,4 @@ a, .rail__item[aria-current] { color: var(--color-accent); }
}
```
-Plus the Hanken Grotesk + Newsreader + IBM Plex Mono link and the reveal / number-tick / scroll-spy script.
+The rest of the page is yours. Almanac supplies the stock, the rules, and the figures; what gets indexed on that paper is the brief's business, not the theme's.
diff --git a/skills/hallmark/references/themes/arcade.md b/skills/hallmark/references/themes/arcade.md
index 5caace5..2c06f95 100644
--- a/skills/hallmark/references/themes/arcade.md
+++ b/skills/hallmark/references/themes/arcade.md
@@ -1,119 +1,84 @@
# Theme - Arcade
-Retro-nostalgia in the **playful** cluster. A coin-op cabinet rendered entirely in CSS: a violet-black CRT ground, a fixed starfield, scanlines, **pixel display type with a magenta ghost**, and hard-offset press buttons. Loud but tasteful - two neon accents, never a rainbow. The page for a **game jam, an indie launch, a demo night, a launch party, a playful community event**.
+Retro-nostalgia in the **playful** cluster: a coin-op cabinet rendered entirely in CSS. A violet-black CRT ground, a fixed starfield, scanlines, pixel display type with a magenta ghost, and hard-offset press surfaces. Loud but tasteful - two neon accents, never a rainbow.
-Loaded eagerly by SKILL.md Step 3 when the catalog pick is `arcade`. Tokens: [`site/css/tokens.css`](../../../../site/css/tokens.css) under `[data-theme="arcade"]`. Reference build: [`site/examples/arcade-01/`](../../../../site/examples/arcade-01/). The full-page proposal [`site/_proposals/themes/arcade.html`](../../../../site/_proposals/themes/arcade.html) is the structural source of truth.
+The material, in one line: **a violet-black CRT with stars behind it, pixel type with a magenta ghost, and shadows with zero blur.**
## Axes (diversification)
-- **Paper band** - **dark** violet-black (`oklch(16% 0.020 300)`, hue 300 carried through every neutral). Not Terminal's green-black 145, not any light ground in the cluster.
-- **Display style** - **pixel display** (Silkscreen 700, mono glyph grid). Distinct from every grotesk/serif/rounded option; the one genuinely bitmap face in the catalog.
-- **Accent** - **chromatic-magenta** (`oklch(70% 0.24 340)`) leading, **cyan** (`oklch(85% 0.13 195)`) answering. A high-chroma neon duo, alternated so neither floods.
+- **Paper band** - **dark** violet-black (`oklch(16% 0.020 300)`), hue 300 carried through every neutral, including the violet-tinted near-white ink (`oklch(95% 0.012 300)`). Not Terminal's green-black 145, not any light ground in the cluster.
+- **Display style** - **pixel display** (Silkscreen 700, a mono glyph grid). The one genuinely bitmap face in the catalog, distinct from every grotesk, serif, and rounded option.
+- **Accent** - **chromatic-magenta** (`oklch(70% 0.24 340)`) leading, **cyan** (`oklch(85% 0.13 195)`) answering. A high-chroma neon duo, alternated so neither floods. `--color-accent-ink` is the violet-black itself: dark text on the neon fills.
## Reference register
-Poolside.fm · Panic · the OP-1 generation of software. The aesthetic: playful retro-hardware nostalgia - CRT glow, pixel type, coin-op and cassette-era warmth executed with restraint, not kitsch. **Never name any of these in the output.**
+Poolside.fm · Panic · the OP-1 generation of software. The material to match: playful retro-hardware nostalgia - CRT glow, pixel type, coin-op and cassette-era warmth executed with restraint rather than kitsch. Never name any of these in the output.
-## Required dependencies
+## Typography
-**Fonts** - **Silkscreen** (display + labels, 400/700), **Hanken Grotesk** (body, 400-800). IBM Plex Mono is the `--font-mono` fallback; add it to the link only if a page shows a code/mono run.
-```html
-<link href="https://fonts.googleapis.com/css2?family=Hanken+Grotesk:wght@400;500;600;700;800&family=Silkscreen:wght@400;700&display=swap" rel="stylesheet" />
-```
-A tiny cursor-blink keyframe (steps(1)) is the only script-free animation; no JS required.
-
-## The signature moves
-
-1. **Violet-black CRT ground + fixed starfield** - `--color-paper` `oklch(16% 0.020 300)` behind ~8 layered `radial-gradient` stars (white / cyan / dim, using `--star` `--star-cyan` `--star-dim`), `background-attachment: fixed` so the field sits still while content scrolls. A full-viewport scanline overlay via `body::after` (`repeating-linear-gradient`, `--scanline`, `z-index: 40`, `pointer-events: none`). **Gate-47 carve-out:** scanlines + starfield ARE the sanctioned retro signal - decorative, never blocking input, never a fake monitor bezel. (Scanline budget and the portable recipe: [`texture.md`](../texture.md) § Scanline.)
+Two families.
-2. **Pixel display with a magenta ghost** - Silkscreen 700 for hero/section display, `text-shadow: 0.085em 0.085em 0 var(--color-accent)` for the offset drop-shadow. Display and Silkscreen **labels only**. Body copy is Hanken Grotesk - never set a paragraph in Silkscreen (unreadable past ~3 words). Section titles use Hanken 800, not pixel.
+- **Display** - Silkscreen 700, for headline scale only, stacked left over the field rather than centred. Body copy is never set in Silkscreen; past about three words a pixel face stops being readable. Secondary heads run in Hanken 800 rather than pixel.
+- **Body** - Hanken Grotesk 400-800, `line-height: 1.6`.
+- **Label voice** - Silkscreen UPPERCASE, tracked `0.02-0.14em`, alternating cyan and magenta. It sets captions, table headers, meta rows, rank chips, initials, units, and folios. The machine readout against the ink body. It is never a kicker over a heading.
-3. **Blinking block cursor** - a cyan █ (`.cursor`, `var(--color-accent-2)` + magenta `box-shadow`) appended after the wordmark, `steps(1)` blink at `1.06s`. **Gate-47 carve-out:** the cursor is a retro terminal caret, a sanctioned signal - not a step toward fake window chrome.
+IBM Plex Mono is the `--font-mono` fallback; add it to the font link only if a page actually shows a code or mono run.
-4. **Hard-offset press buttons** - every interactive surface (score slots, primary `.btn`) carries a solid `Npx Npx 0` shadow in `--shadow-mag` / `--shadow-cyn`. `:hover` moves *away* from the shadow (grows to 8-9px), `:active` slams *toward* it (2px) - a physical button press. Zero blur. `--radius-card` 4px, `--radius-pill` 0.
+## Material
-5. **Player-select CTA** - the hero's dual action is a **P1 / P2 score-slot pair** (magenta P1, cyan P2) in arcade language: INSERT COIN, 1 CREDIT, FREE PLAY, REGISTER / SPONSOR. The marquee strip up top reads like a cabinet header.
+- **Violet-black CRT ground with a fixed starfield.** Around eight layered `radial-gradient` stars (white, cyan, dim) on `--color-paper`, `background-attachment: fixed` so the field holds still while content scrolls.
+- **Scanlines over everything.** A full-viewport `repeating-linear-gradient` overlay at high `z-index`, `pointer-events: none`. **Gate-47 carve-out:** scanlines and starfield are the sanctioned retro signal - decorative, never blocking input, never a fake monitor bezel. Budget and portable recipe: [`texture.md`](../texture.md) § Scanline.
+- **The magenta ghost.** Pixel display carries `text-shadow: 0.085em 0.085em 0 var(--color-accent)` - an offset drop-shadow with zero blur, the theme's signature on type.
+- **Hard-offset press surfaces.** Every interactive surface carries a solid `Npx Npx 0` shadow in magenta or cyan. `:hover` moves *away* from the shadow (grows to 8-9px); `:active` slams *toward* it (2px). A physical press, zero blur.
+- **Chunky 2px rules, near-square radii.** Structure is drawn with 2px borders and section rules, not hairlines. `--radius-card: 4px`, `--radius-pill: 0`. Depth is hard shadow and thick rule, never blur.
+- **Two-accent alternation.** Magenta leads, cyan answers, and they swap from beat to beat so neither neon dominates. Never a third.
+- **A blinking block cursor** - a cyan █ with a magenta `box-shadow`, `steps(1)` blink at `1.06s`, is a sanctioned retro caret (gate 47), not a step toward fake window chrome.
-6. **Silkscreen machine labels** - every kicker, meta line, table header, and rank chip (1UP / 2UP / 3UP, high-score initials) is Silkscreen UPPERCASE, tracking `0.02-0.14em`, alternating cyan/magenta. The readout voice against the ink body.
-
-7. **Two-accent alternation** - magenta (`--color-accent`, hue 340) leads, cyan (`--color-accent-2`, hue 195) answers; they swap across beats / tracks / prizes so no single neon dominates. `--color-accent-ink` is the violet-black itself - dark text on the neon fills.
-
-8. **Chunky 2px rules, near-square radii** - structure is drawn with 2px borders and `border-top` section rules, not hairlines; 4px card radius, 0 pill. Depth is hard shadow + thick rule, never blur.
+**Shapes Arcade suits** (affinities, never requirements): paired neon slots for a dual action, in arcade language; a bordered lineup of entries as cabinet cards; a marquee strip reading like a cabinet header; a ranked table with pixel initials.
## Motion
-Near-static. The **one** animation is the cyan block-cursor blink. Interaction is press-physics: hard-shadow surfaces translate 2-3px on `:hover` / `:active` (`120ms ease-out`), border brightens to `--line-lit`. Focus is a 3px cyan `--ring` outline at 4-5px offset. Everything gates behind `prefers-reduced-motion`; reduced-motion stops the cursor and every transition (static, fully visible). No parallax, no autoplay, no bounce; the starfield is `fixed`, not animated.
-
-## Anti-patterns
-
-- **No body copy in Silkscreen** - pixel face is display + labels only; paragraphs are Hanken Grotesk. This is the single most common failure.
-- **No fake OS / window chrome** - **gate-47:** no fake monitor bezels, browser or title bars, traffic-light dots, or "app window" cards. The retro read is scanlines + starfield + pixel type + cursor, not skeuomorphic desktop furniture.
-- **No pure `#000` / `#fff`** - violet-black paper (`16% 0.020 300`), violet-tinted near-white ink (`95% 0.012 300`). Every neutral carries hue 300.
-- **No soft or blurred shadows, no gradient CTAs** - shadows are hard 0-blur offsets; the button is flat magenta with a 2px ink border, never a gradient pill (`--radius-pill` is 0).
-- **No rainbow** - exactly two accents alternating. Don't add a third neon or an RGB spread. Loud but tasteful.
-- **No arcade emoji / clip-art** (👾🕹️) - the retro comes from type, scanlines, stars, and hard shadows, not pasted glyphs.
-- **No centred-everything** - hero content is `flex-start`, left-biased; the pixel display stacks left over the field.
-
-## Macrostructure affinity
+Near-static. The one animation is the cyan cursor blink. Interaction is press physics: hard-shadow surfaces translate 2-3px on `:hover` and `:active` over `120ms ease-out`, and a border brightens to `--line-lit`. Focus is a 3px cyan `--ring` at 4-5px offset. The starfield is `fixed`, not animated. No parallax, no autoplay, no bounce. `prefers-reduced-motion: reduce` stops the cursor and every transition, static and fully visible.
-**Arcade loves these.**
+## Do-nots (this theme's own failure modes)
-- **Manifesto** - loud event / jam / launch page, big pixel display *(canonical - arcade-01)*
-- **Marquee** - one confident pixel wordmark + insert-coin CTA
-- **Showcase / Gallery** - a lineup of games, tracks, or entries as score slots
-- **Feature grid as cabinet lineup** - tracks / prizes as bordered arcade cards
+- **Never body copy in Silkscreen.** Pixel is display and labels only; paragraphs are Hanken Grotesk. This is the single most common Arcade failure.
+- **Never fake OS or window chrome** (gate 47): no monitor bezels, browser or title bars, traffic-light dots, or "app window" surfaces. The retro read is scanlines, stars, pixel type, and the cursor, not skeuomorphic desktop furniture.
+- **Never a rainbow.** Exactly two accents alternating. No third neon, no RGB spread. Loud but tasteful.
+- **Never a soft or blurred shadow, and never a gradient fill.** Shadows are hard zero-blur offsets; the button is flat neon with a 2px ink border, never a gradient pill.
+- **Never arcade emoji or clip-art** (👾🕹️), and never pure `#000` or `#fff`. The retro comes from type, scanlines, stars, and hard shadows, not pasted glyphs, and every neutral carries hue 300.
-## Macrostructure rejection
+## Voice range
-**Arcade refuses these.**
+Playful, coin-op, high-score. Short and declarative; name the credit, the theme, the buzzer. Never: seamless, robust, cutting-edge, leverage, synergy, revolutionary, unlock, supercharge, next-level, gamechanger, epic as filler. Never "click here." Never lean on *level up*, *8-bit*, or *16-bit* as filler; earn the retro through the type and the field.
-- **Long Document** - Silkscreen headers can't carry sustained reading; route warm-editorial
-- **Docs / API product** - too playful; that's Cobalt or Terminal
-- **Photographic / image-led** - Arcade builds its world from CSS, not photography
-- **Corporate / trust-led SaaS** - too loud for a calm B2B pitch
-
-## Voice fixtures
-
-Playful, coin-op, high-score. Short and declarative. Name the credit, the theme, the buzzer.
-
-- *"Insert coin. Ready player 1?"*
-- *"Free play - no entry fee, no catch, ever."*
-- *"One theme, 48 hours, any team size."*
-- *"Everyone plays everyone. The room picks its favorites."*
-- *"New high score - enter your initials."*
-
-Never any of: *seamless, robust, cutting-edge, leverage, synergy, revolutionary, unlock, supercharge, next-level, gamechanger, epic (as filler).* Never "click here." Never lean on *level up / 8-bit / 16-bit* as filler - earn the retro through the type and the field.
-
-## How Arcade differs from neighbouring themes
+## How Arcade differs from its neighbours
| vs | difference |
|---|---|
-| **Hum** (playful sibling, rounded-warm) | Hum is **light** cream (`oklch(97% 0.012 95)`), Plus Jakarta Sans rounded sans, 20px radii, pear-yellow + cyan + coral, spring/bounce motion. Arcade is **dark** violet-black (`16% 0.020 300`), pixel Silkscreen, 4px/0 radii, magenta+cyan over scanlines, hard-offset press. Same cluster, opposite build: soft-warm-daylight vs pixel-CRT-night. |
-| **Terminal** (mono/dark sibling, phosphor-CRT editorial) | Terminal is green-black (`oklch(11% 0.018 145)`), JetBrains Mono for **everything incl. body**, phosphor-green accent (`78% 0.190 138`), calm reading. Arcade is violet-black hue 300, pixel Silkscreen for display/labels but **Hanken Grotesk body**, magenta+cyan. Terminal is a readable green editor; Arcade is a loud neon cabinet. |
-| **Carnival** (loud sibling, editorial) | Carnival is **light** pink-cream (`oklch(92% 0.045 50)`), Big Shoulders Display condensed, mustard + oxblood, hard-offset shadow but a poster layout. Both are loud with hard shadows; Carnival is a warm daylight fairground poster, Arcade is a dark neon arcade at night. |
+| **Hum** (playful sibling) | Hum is **light** cream (`oklch(97% 0.012 95)`), Plus Jakarta Sans rounded sans, 20px radii, pear-yellow plus cyan plus coral, spring motion. Arcade is **dark** violet-black (`16% 0.020 300`), pixel Silkscreen, 4px and 0 radii, magenta plus cyan over scanlines, hard-offset press. Same cluster, opposite build: soft-warm-daylight vs pixel-CRT-night. |
+| **Terminal** | Terminal is green-black (`oklch(11% 0.018 145)`), JetBrains Mono for everything including body, phosphor green (`78% 0.190 138`), calm reading. Arcade is violet-black hue 300, pixel display with a **Hanken body**, magenta and cyan. A readable green editor vs a loud neon cabinet. |
+| **Carnival** (loud sibling) | Carnival is **light** pink-cream (`oklch(92% 0.045 50)`), Big Shoulders condensed, mustard and oxblood, hard-offset shadow on a poster layout. Both are loud with hard shadows; Carnival is a warm daylight fairground, Arcade is a dark neon arcade at night. |
-## Test brief expectations
+## When the brief routes here
-Arcade is a candidate when the brief mentions:
+*game jam · indie game · game studio · launch party · demo night · hackathon · festival · meetup · retro · pixel · arcade · nostalgia · playful launch · music, synth, or lo-fi toy · zine*. Categories: games, creative events, community, music and audio toys, indie tools with personality. Tone: playful, loud, retro, nostalgic, fun, irreverent, high-energy, night.
-- *game jam · indie game · game studio · launch party · demo night · hackathon · festival · meetup · retro · pixel · arcade · nostalgia · playful launch · music / synth / lo-fi toy · zine*
-- Product categories: *game · creative event · community · music/audio toy · indie tool with personality*
-- Emotional tone: *playful · loud · retro · nostalgic · fun · irreverent · high-energy · night*
-
-Calm / corporate / trust-led routes to Cobalt or Coral; sustained editorial reading routes warm-editorial. Arcade is for pages that want to feel like a coin-op cabinet.
+Calm, corporate, or trust-led briefs route to Cobalt or Coral; sustained editorial reading routes to a warm-editorial theme. Arcade is for pages that want to feel like a coin-op cabinet.
## Build hint
-The palette tokens (`--color-*`) come from `[data-theme="arcade"]`. The starfield / scanline / neon-glow vars below (`--star*`, `--scanline`, `--shadow-cyn`, `--shadow-mag`, `--line-lit`, `--ring`) are **page-local decorative tokens**: define them in your page `:root` as in the reference build `site/examples/arcade-01/` (gate 48 allows page-defined tokens).
+```html
+<link href="https://fonts.googleapis.com/css2?family=Hanken+Grotesk:wght@400;500;600;700;800&family=Silkscreen:wght@400;700&display=swap" rel="stylesheet" />
+```
-The first lines of CSS establish Arcade's anchor moves:
+The palette tokens come from `[data-theme="arcade"]`. The decorative vars below (`--star*`, `--scanline`, `--shadow-cyn`, `--shadow-mag`, `--line-lit`, `--ring`) are **page-local**: define them in your own `:root` (gate 48 allows page-defined tokens).
```css
html, body { overflow-x: clip; }
body { background-color: var(--color-paper); color: var(--color-ink);
font-family: var(--font-body); line-height: 1.6;
background-image:
- /* --star / --star-dim / --scanline / --shadow-cyn are page-added decorative tokens: lift them into your :root (gate 48). */
radial-gradient(1.5px 1.5px at 12% 16%, var(--star), transparent 62%),
radial-gradient(1.5px 1.5px at 83% 24%, var(--color-accent-2), transparent 62%),
radial-gradient(1px 1px at 46% 62%, var(--star-dim), transparent 62%);
@@ -125,12 +90,11 @@ body::after { content: ""; position: fixed; inset: 0; z-index: 40;
background: repeating-linear-gradient(to bottom,
transparent 0 2px, var(--scanline) 2px 3px); }
-/* Pixel display with the magenta ghost - display/labels only */
+/* Pixel display with the magenta ghost - display and labels only */
.pix { font-family: var(--font-display); font-weight: 700; }
-.hero__display { font-family: var(--font-display);
- text-shadow: 0.085em 0.085em 0 var(--color-accent); }
+.pix--display { text-shadow: 0.085em 0.085em 0 var(--color-accent); }
-/* Hard-offset press button - zero blur, radius 4px */
+/* Hard-offset press - zero blur, radius 4px */
.btn { background: var(--color-accent); color: var(--color-accent-ink);
border: 2px solid var(--color-ink); box-shadow: 6px 6px 0 var(--shadow-cyn);
transition: transform 110ms ease-out, box-shadow 110ms ease-out; }
@@ -142,4 +106,4 @@ body::after { content: ""; position: fixed; inset: 0; z-index: 40;
}
```
-Plus the Silkscreen + Hanken Grotesk link above. Reference build: [`site/examples/arcade-01/`](../../../../site/examples/arcade-01/) - match its register (tokens, voice, motion feel), never its composition; reusing its section order, hero geometry, or grid is a gate-32-grade repeat.
+Arcade supplies the CRT, the stars, the pixel ghost, and the press. What the cabinet is running is the brief's business, not the theme's.
diff --git a/skills/hallmark/references/themes/atelier.md b/skills/hallmark/references/themes/atelier.md
index 2eab29b..6014612 100644
--- a/skills/hallmark/references/themes/atelier.md
+++ b/skills/hallmark/references/themes/atelier.md
@@ -1,8 +1,8 @@
# Theme - Atelier
-The considered-object page: a fashion house, a fragrance, a gallery or exhibition, a furniture / ceramics / architecture studio, a made-in-small-numbers brand story. The Aesop / couture-masthead / gallery-placard school, rendered in **warm plaster and umber** - not cream, not grey. A near-neutral plaster ground (`oklch(94% 0.005 60)`), one **fat high-contrast Didone masthead** (Playfair Display 900, optical 144), grotesk captions, wide-tracked mono placards, and a single amber ember for the only warm signal. It reads hand-set and unhurried: an object *presented*, never sold.
+The considered-object register: the Aesop / couture-masthead / gallery-placard school, rendered in **warm plaster and umber** - not cream, not grey. A near-neutral plaster ground, one **fat high-contrast Didone**, grotesk body, wide-tracked mono placards, and a single amber ember for the only warm signal. It reads hand-set and unhurried: an object *presented*, never sold.
-Loaded eagerly by SKILL.md Step 3 whenever the catalog pick is `atelier`. The OKLCH palette + font stack live in [`site/css/tokens.css`](../../../../site/css/tokens.css) under `[data-theme="atelier"]`.
+The material, in one line: **plaster paper, a fatface Didone, hairlines and air, one amber ember.**
## Axes (diversification)
@@ -12,105 +12,110 @@ Loaded eagerly by SKILL.md Step 3 whenever the catalog pick is `atelier`. The OK
## Reference register
-Aesop · a couture / fashion-house masthead · gallery + museum exhibition pages · Kinfolk / Cereal editorial · Studio Nicholson, The Row, Toteme · Frama, Byredo, Le Labo · an architecture-studio portfolio.
+Aesop · a couture fashion-house masthead · gallery and museum exhibition pages · Kinfolk / Cereal editorial · Studio Nicholson, The Row, Toteme · Frama, Byredo, Le Labo · an architecture-studio portfolio. **Never name any of these in the output.**
-The aesthetic: the object presented under a dramatic serif crown with a spec-sheet caption - warm plaster canvas, hairline structure, one amber ember, imagery treated like a gallery print. **Never name any of these in the output.**
+The material to match: the object presented under a dramatic serif crown with a spec-sheet caption - warm plaster canvas, hairline structure, one amber ember, imagery treated like a gallery print. Internally: *Aesop's product-as-object restraint* recoloured plaster-and-umber. When in doubt ask "does this read like a gallery placard, or like a product ad?" Keep the former.
-**Patron-saint reference (internal):** *Aesop's product-as-object restraint* + *a couture magazine masthead*, recoloured plaster-and-umber. When in doubt ask "does this read like a gallery placard, or like a product ad?" Keep the former.
+## Palette
-## Required dependencies
+Canonical values live in [`site/css/tokens.css`](../../../../site/css/tokens.css) under `[data-theme="atelier"]`.
-1. **Fonts** - **Playfair Display** (display, 900, optical axis), **Hanken Grotesk** (body, 400/500/600), **IBM Plex Mono** (labels/meta, UPPERCASE). Google Fonts:
- ```html
- <link href="https://fonts.googleapis.com/css2?family=Playfair+Display:opsz,[email protected],400..900&family=Hanken+Grotesk:wght@400;500;600;700&family=IBM+Plex+Mono:wght@400;500;600&display=swap" rel="stylesheet" />
- ```
-2. **A small reveal script** - one `IntersectionObserver` adding `.is-in` (fade + ~10px rise, ease-out ~600ms). Optionally a one-shot masked curtain-wipe (clip-path) on the masthead, then static.
+- `--color-paper: oklch(94% 0.005 60)` - plaster, never white; surfaces step to `91%` / `87%`
+- `--color-ink: oklch(12% 0.024 40)` - warm near-black umber
+- `--color-neutral: oklch(28% 0.014 45)` - body text
+- `--color-accent: oklch(22% 0.060 40)` - near-ink umber, a fill block or a heavy rule, never a bright pop
+- `--color-accent-ink` / `--color-focus: oklch(45% 0.13 60)` - the amber ember: a link underline, a focus ring, a drop cap, one `<mark>`
+- `--color-rule: oklch(78% 0.006 55)` - hairline
+- `--color-rule-2: oklch(56% 0.008 50)` - divider or double rule
-## Signature moves
+The whole page reads unbleached-linen warm. Keep the amber under 4% of any viewport: this is warm-monochrome with one ember.
-1. **Plaster paper, warm near-neutral, never white.** `--color-paper: oklch(94% 0.005 60)`, surfaces to `91%` / `87%`. Ink is warm near-black umber `--color-ink: oklch(12% 0.024 40)`; body sits at `--color-neutral: oklch(28% 0.014 45)`. The whole page reads unbleached-linen warm - not grey, not cream, never `#fff`.
+## Typography
-2. **The Didone masthead is the hero.** Playfair Display at weight `var(--display-weight)` = 900, `font-variation-settings: "opsz" 144`, tracking `-0.018em`, clamped to `6.25rem` via `--text-display`. One large fatface line, set LEFT or broadsheet-centred, carries the page's entire gravity. Nothing competes with it.
+The triad - fat Didone display, neutral grotesk body, wide mono labels - **is** Atelier.
-3. **Monochrome-umber, amber only as a whisper.** `--color-accent: oklch(22% 0.060 40)` is nearly ink-dark - use it as a fill/ink block or a heavy rule, **not** a bright pop. The single warm signal is amber `oklch(45% 0.13 60)` (`--color-accent-ink` / `--color-focus`): a link underline, a focus ring, a drop-cap, one `<mark>`. Keep it under 4% of any viewport - the page is warm-monochrome with one ember.
+- **Display** - Playfair Display at `var(--display-weight)` = 900, `font-variation-settings: "opsz" 144`, tracking `-0.018em`, clamped to `6.25rem` via `--text-display`. One large fatface line carries the page's entire gravity; nothing competes with it.
+- **Body** - Hanken Grotesk 400/500 at `--lh-normal: 1.55` / `--lh-relaxed: 1.7`, `--measure: 56ch`. **Never set running body in the serif** (that move belongs to Newsprint).
+- **Label** - IBM Plex Mono (`--font-label`), UPPERCASE, tracking `0.24em` (`--tracking-label`). The gallery-placard voice, carrying real values: material, dimensions, year, edition, captions, spec meta, folios. It labels an object; it never announces a heading.
-4. **Wide-tracked mono placards.** Eyebrows, section numbers, captions, spec meta in IBM Plex Mono (`--font-label`), UPPERCASE, tracking `0.24em` (`--tracking-label`). The machine-precise gallery-placard voice under the couture Didone - material, dimensions, year, edition.
+**The drop cap.** The amber drop cap is Atelier's one piece of editorial ornament, and it is how a passage of prose opens: scale and colour do the work, no words are spent on it. One per page, first paragraph only. Working CSS is in the Build hint below.
-5. **Grotesk body under the serif crown.** Hanken Grotesk 400/500 body at `--lh-normal: 1.55` / `--lh-relaxed: 1.7`, `--measure: 56ch`. The triad - fat Didone display + neutral grotesk body + wide mono labels - **is** Atelier. Never set running body in the serif (that move belongs to Newsprint).
+## Material
-6. **Hairlines, generous air, asymmetric columns.** 1px `--color-rule: oklch(78% 0.006 55)` for fine rules, `--color-rule-2: oklch(56% 0.008 50)` for a section divider or double-rule. No boxed cards, no drop-shadows, no glass. `--section-gap: 6.5rem`, `--page-max: 64rem`. Depth comes from rules + whitespace only.
-
-7. **The object presented, not sold.** Compose like a lookbook or exhibition index: a named object, a drop-cap opening, a numbered index, imagery treated as a gallery print (generous margin, hairline frame). CTAs are text-underline or a hairline-outline at a small (2-4px) radius - never a filled amber blob.
+- **Hairlines and generous air.** `--section-gap: 6.5rem`, `--page-max: 64rem`. Depth comes from rules and whitespace only: no boxed cards, no drop-shadows, no glass. Radius is 2-4px at most, and only on an outlined control.
+- **No texture, no background pattern.** The plaster is the surface.
+- **Imagery is a gallery print** - generous margin, hairline frame, never bled to the edge of a card. Controls are a text underline or a hairline outline, never a filled amber blob.
## Motion
-Quiet and orchestrated. One entrance: the masthead's masked curtain-wipe (or a plain fade), section reveals fade + rise, an amber underline-grow on link hover. **No bounce, no parallax, no autoplay, no marquee.** Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static + fully visible.
-
-## Anti-patterns
-
-- **No bright saturated pop.** The umber accent is near-ink; amber is a whisper. No orange (Specimen), no oxblood red (Newsprint), no green (Garden / Studio).
-- **No serif running body.** Body is Hanken Grotesk. Playfair in paragraphs reads broadsheet - that is Newsprint, wrong theme.
-- **No warm-tan or cream newspaper stock.** Atelier's paper is near-neutral plaster (chroma 0.005), not oat (0.022) or tan (0.045).
-- **No thin / hairline Didone masthead.** Atelier's Playfair is FAT (900). A light cut collides with Specimen's Fraunces 340 and reads generic-luxury.
-- **No boxed cards, drop-shadows, or glassmorphism.** Hairlines + air carry every surface.
-- **No filled-pill or gradient CTA.** Underline or hairline-outline at small radius. Name the object / the collection.
-- **No pure `#fff` / `#000`, no centred three-icon-tile feature grid, no background texture or pattern.**
-
-## Macrostructure affinity / rejection
-
-**Loves:** **Specimen** (the Didone as its own subject) · **Photographic** (lookbook / gallery imagery, object-led) · **Catalogue** (a numbered index of objects or works) · **Letter** (intimate, hand-set; Ft6 letter close) · **Long Document** (a considered magazine feature or essay).
-
-**Refuses:** **Bento Grid** (modular tiles fight the broadsheet restraint) · **Stat-Led** (big-number KPI dashboards are enterprise, not gallery) · **Workbench / component-playground** (instrument-panel dev-tool shape is Cobalt's) · **Marquee Hero** (kinetic scroll is too loud for one quiet curtain).
+Quiet and orchestrated. One entrance: a masked curtain-wipe (`clip-path`) or a plain fade on the display line, then static. Section reveals fade and rise ~10px, ease-out ~600ms, via a single `IntersectionObserver`. An amber underline grows on link hover. **No bounce, no parallax, no autoplay, no marquee.** Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static and fully visible.
-## Voice fixtures
+## Voice range
-Hand-set, literary, object-precise, couture-calm. Verbs over adjectives; name the object.
+Hand-set, literary, object-precise, couture-calm. Verbs over adjectives; name the object, the material, the number made. Never *seamless, elevate, curated, bespoke, luxury, effortless, game-changing, must-have*. Never "shop now."
-- *"Made in small numbers, by hand, in Lisbon."*
-- *"One coat. Twelve hours. A finish that keeps."*
-- *"The 04 chair, in oiled ash."*
-- *"We compose a scent the way a printer composes a page."*
-- *"Nothing added that the object did not ask for."*
+## Do-nots (this theme's own failure modes)
-Never: *seamless, elevate, curated, bespoke, luxury, effortless, game-changing, must-have.* Never "shop now" / "buy now" - say "See the collection" or name the piece.
+- **No bright saturated pop.** The umber accent is near-ink; amber is a whisper. No orange (Specimen), no oxblood (Newsprint), no green (Garden / Studio).
+- **No serif running body.** Playfair in paragraphs reads broadsheet, which is a different theme.
+- **No thin or hairline Didone.** Atelier's Playfair is FAT (900). A light cut collides with Specimen's Fraunces 340 and reads generic-luxury.
+- **No warm-tan or cream newspaper stock.** Plaster is chroma 0.005, not oat (0.022) or tan (0.045).
+- **No boxed cards, drop-shadows, or glassmorphism.** Hairlines and air carry every surface.
+- **No filled-pill or gradient CTA, no pure `#fff` / `#000`.**
-## How Atelier differs from neighbouring themes
+## How Atelier differs from its neighbours
| vs | what settles it instantly |
|---|---|
-| **Newsprint** (shares Playfair Display) | Newsprint is Playfair **700** + Crimson Pro **serif body** + warm-tan stock (`oklch(92% 0.045 50)`) + oxblood accent - a broadsheet. Atelier is Playfair **900** fatface + **grotesk body** (Hanken) + near-neutral plaster + amber whisper. Body face + paper warmth settle it. |
-| **Specimen** (serif-display sibling) | Specimen is **light** Fraunces (340) + bright **orange** (`#FC4C02`) on warm paper - a type showcase. Atelier is **fat** Playfair (900) + warm-monochrome umber. Display weight + accent hue settle it. |
+| **Newsprint** (shares Playfair Display) | Newsprint is Playfair **700** + Crimson Pro **serif body** + warm-tan stock (`oklch(92% 0.045 50)`) + oxblood. Atelier is Playfair **900** fatface + **grotesk body** + near-neutral plaster + amber whisper. Body face and paper warmth settle it. |
+| **Specimen** (serif-display sibling) | Specimen is **light** Fraunces (340) + bright **orange** (`#FC4C02`) on warm paper. Atelier is **fat** Playfair (900) + warm-monochrome umber. Display weight and accent hue settle it. |
| **Garden** (same 94% paper band) | Garden is Young Serif + oat cream + living **leaf-green**, botanical and organic. Atelier is a high-contrast Didone on near-neutral plaster with **no green** - gallery, not garden. |
-## Test brief expectations
+## When the brief routes here
-Atelier is a candidate when the brief mentions:
+*fashion · atelier · couture · fragrance · gallery · exhibition · museum · ceramics · furniture · homeware · architecture studio · design studio · lookbook · collection · made by hand · craft · small-batch · brand story*. Categories: fashion and apparel brands, fragrance houses, galleries and museums, furniture and homeware, architecture and interior studios, considered B2C brand stories. Tone: refined, hand-set, warm-monochrome, gallery-quiet, unhurried.
-- *fashion · atelier · couture · fragrance / perfume · gallery · exhibition · museum · ceramics · furniture · homeware · architecture studio · design studio · lookbook · collection · made by hand · craft · small-batch · editorial feature · brand story*
-- Product categories: *fashion / apparel brand · fragrance house · gallery or museum · furniture / homeware · architecture or interior studio · design-studio portfolio · considered B2C brand story*
-- Emotional tone: *refined · hand-set · warm-monochrome · gallery-quiet · considered · understated · unhurried*
-
-Briefs that are developer / enterprise / dashboard route elsewhere (Cobalt, Almanac); loud-maximalist editorial routes to Carnival; broadsheet news routes to Newsprint.
+Developer, enterprise, and dashboard briefs route elsewhere; loud-maximalist editorial routes to Carnival; broadsheet news routes to Newsprint.
## Build hint
-The first lines of CSS establish Atelier's anchor moves:
+```html
+<link href="https://fonts.googleapis.com/css2?family=Playfair+Display:opsz,[email protected],400..900&family=Hanken+Grotesk:wght@400;500;600;700&family=IBM+Plex+Mono:wght@400;500;600&display=swap" rel="stylesheet" />
+```
```css
html, body { overflow-x: clip; }
body { background: var(--color-paper); color: var(--color-neutral);
font-family: var(--font-body); font-weight: 400; line-height: var(--lh-normal); }
-/* The fatface Didone masthead - the page's whole gravity */
-.masthead { font-family: var(--font-display); font-weight: var(--display-weight);
- font-variation-settings: "opsz" var(--display-optical);
- font-size: var(--text-display); letter-spacing: var(--tracking-display);
- line-height: var(--lh-tight); color: var(--color-ink); }
+/* The fatface Didone - the page's whole gravity */
+h1, .display { font-family: var(--font-display); font-weight: var(--display-weight);
+ font-variation-settings: "opsz" var(--display-optical);
+ font-size: var(--text-display); letter-spacing: var(--tracking-display);
+ line-height: var(--lh-tight); color: var(--color-ink); }
-/* Wide-tracked mono placard */
+/* Wide-tracked mono placard - real values only, never a heading's announcement */
.placard { font: 500 0.75rem/1 var(--font-label); text-transform: uppercase;
letter-spacing: var(--tracking-label); color: var(--color-muted); }
+/* The amber drop cap - one per page, first paragraph only.
+ Playfair at ~3 lines of body leading, optically nudged so its cap-height
+ sits on the first baseline and its left edge aligns with the measure. */
+.lede::first-letter {
+ float: left;
+ font-family: var(--font-display);
+ font-weight: var(--display-weight);
+ font-variation-settings: "opsz" 144;
+ font-size: 3.9em; /* ~3 lines at --lh-normal 1.55 */
+ line-height: 0.82;
+ padding: 0.06em 0.08em 0 0;
+ margin-inline-start: -0.04em; /* optical hang, left edge flush to the measure */
+ color: var(--color-accent-ink); /* the amber ember */
+}
+@supports (initial-letter: 3) {
+ .lede::first-letter { initial-letter: 3; float: none; font-size: inherit; line-height: inherit; }
+}
+
/* Hairlines + the one amber ember */
.rule { border: 0; border-top: 1px solid var(--color-rule); }
a { color: inherit; text-decoration-color: var(--color-accent-ink); }
@@ -127,4 +132,4 @@ a { color: inherit; text-decoration-color: var(--color-accent-ink); }
}
```
-Plus the Playfair Display + Hanken Grotesk + IBM Plex Mono link and the small reveal script.
+The rest of the page is yours. Atelier supplies the plaster, the crown, and the ember; what gets presented on that paper is the brief's business, not the theme's.
diff --git a/skills/hallmark/references/themes/aurora.md b/skills/hallmark/references/themes/aurora.md
index 72b0b81..48951f0 100644
--- a/skills/hallmark/references/themes/aurora.md
+++ b/skills/hallmark/references/themes/aurora.md
@@ -1,103 +1,90 @@
# Theme - Aurora
-Atmospheric, after-dark register. The page for a **dev tool, an AI or generative product, a model playground, a rendering pipeline you open at night** - but rendered in **cold blue-green light, not the genre's warm firelight**. A near-black cyan-tilted canvas (`oklch(11% 0.025 200)`), cool near-white ink, one teal-green signal, and - the identity move - **two overlapping cool blooms curtaining the ground like the northern lights**. Weighty Sora display for confidence; a **Sentient serif body** to keep the cold canvas from reading clinical. It should feel like the moment after a deploy goes green.
+Atmospheric, after-dark register, rendered in **cold blue-green light rather than the genre's warm firelight**. A near-black cyan-tilted canvas, cool near-white ink, one teal-green signal, and the identity move: **two overlapping cool blooms curtaining the ground like the northern lights**. Weighty Sora display for confidence, a Sentient serif body so the cold canvas never reads clinical. It should feel like the moment after a deploy goes green.
-Loaded eagerly by SKILL.md Step 3 when the catalog pick is `aurora`. Tokens: [`site/css/tokens.css`](../../../../site/css/tokens.css) under `[data-theme="aurora"]`. No canonical build yet; mirror the moves below.
+The material, in one line: **two cold blooms, a heavy sans, and a serif reading voice.**
-> **Why the bloom, not the glow.** Midnight is the cluster's one *diffuse azure glow*; Aurora is the one *paired bloom curtain*. The genre licenses up to two blooms - Aurora is the theme that spends the whole budget: cyan + teal-green, overlapping, so the ground reads as an aurora, not a single light. That two-hue cold curtain plus a serif body is the differentiator, not a recolour.
+> **Why the bloom, not the glow.** Midnight is the cluster's one *diffuse azure glow*; Aurora is the one *paired bloom curtain*. The genre licenses up to two blooms and Aurora spends the whole budget: cyan plus teal-green, overlapping, so the ground reads as an aurora and not as a single light. That two-hue cold curtain plus a serif body is the differentiator, not a recolour.
## Axes (diversification)
-- **Paper band** - **near-black, cyan-tilted** (`oklch(11% 0.025 200)`). The *deepest* ground in the cluster (Midnight 15%, Lumen Night 13%). Elevation climbs to `paper-2` `oklch(15% 0.028 200)` and `paper-3` `oklch(18% 0.030 200)`. The 0.025 chroma at hue 200 is load-bearing: cold blue-green, never `#000`.
-- **Display style** - **geometric-sans, weighty** (Sora `--display-weight: 600`, tracking `-0.035em`, up to `5.75rem`). Confident and heavy - the opposite of Midnight's airy thin 300.
+- **Paper band** - **near-black, cyan-tilted** (`oklch(11% 0.025 200)`). The *deepest* ground in the cluster (Midnight 15%, Lumen Night 13%). The 0.025 chroma at hue 200 is load-bearing: cold blue-green, never `#000`.
+- **Display style** - **geometric-sans, weighty** (Sora `--display-weight: 600`, tracking `-0.035em`, up to `5.75rem`). Confident and heavy, the opposite of Midnight's airy thin 300.
- **Accent hue** - **teal-green** (`oklch(68% 0.145 172)`) with a **cyan** secondary (`oklch(72% 0.170 200)`). Both cold; hue 172 sits ~78deg green of Midnight's azure 250. Teal-green is the UI signal; cyan lives in the first bloom.
## Reference register
Linear (dark) · Vercel after-dark · Raycast · Resend dark · Railway · Supabase dark · Planetscale · northern-lights dev landings.
-The aesthetic: the cool-dark product page where the canvas glows blue-green behind confident sans display, one teal-green signal, serif reading voice. Hand-built, moody, cold but not clinical.
+The material to match: the cool-dark product page where the canvas glows blue-green behind a confident sans display, one teal-green signal, a serif reading voice. Hand-built, moody, cold but not clinical. Ask "does this feel like blue-green light on a night sky, or a warm-lit room?" Keep the former. Never name any of these in the output.
-**Patron-saint reference (internal):** *Linear's dark restraint* + *the northern lights over a cold coast* + *the calm right after a green deploy*. Ask "does this feel like blue-green light on a night sky, or a warm-lit room?" Keep the former. Never name any of these in the output.
+**Voice range:** cool, after-dark, dev-fluent, warmed by the serif. Name the command or the number.
-## Required dependencies
+## Palette
-1. **Fonts** - **Sora** (display 600, plus 400), **Sentient** (body + serif accent, 400/500, Fontshare), **Geist Mono** (labels):
- ```html
- <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
- <link href="https://fonts.googleapis.com/css2?family=Sora:wght@400;600;700&family=Geist+Mono:wght@400;500&display=swap" rel="stylesheet" />
- <link href="https://api.fontshare.com/v2/css?f[]=sentient@400,500&display=swap" rel="stylesheet" />
- ```
-2. **A reveal script** - one `IntersectionObserver` adding `.is-in` (fade + ~10px rise, ease-out ~600ms). Fade is the whole motion budget; the blooms are static.
+- `--color-paper: oklch(11% 0.025 200)` - deepest ground in the cluster, cyan-tilted
+- `--color-paper-2: oklch(15% 0.028 200)` / `--color-paper-3: oklch(18% 0.030 200)` - elevation
+- `--color-ink: oklch(96% 0.010 200)` - cool near-white headlines
+- `--color-ink-2: oklch(82% 0.012 200)` - body
+- `--color-accent: oklch(68% 0.145 172)` - teal-green, the one UI signal
+- `--color-accent-2: oklch(72% 0.170 200)` - cyan, lives in the bloom
+- `--color-accent-ink` = paper, for text on a filled teal-green control
+- `--color-rule: oklch(28% 0.022 200)` - hairline seams (`rule-2` for a brighter edge)
-## Signature moves
+The cyan tilt runs through every neutral. Accent stays under 5% of any viewport: a link hover, the one primary button, focus rings, a status chip, an active nav item. Cyan never becomes a second UI flood.
-1. **Two cool blooms - the aurora itself.** Fixed-attached radial gradients: **cyan** (`--color-accent-2`, hue 200) top-right + **teal-green** (`--color-accent`, hue 172) bottom-left, each ~25-30% footprint, low chroma, overlapping toward the centre so the ground curtains. No animation. This paired cold curtain is the theme; one lonely glow is Midnight, not Aurora.
-2. **Deepest near-black cyan ground, never black** - `--color-paper: oklch(11% 0.025 200)`. Ink is cool near-white `--color-ink: oklch(96% 0.010 200)`; body sits at `--color-ink-2: oklch(82% 0.012 200)`. The cyan tilt runs through every neutral.
-3. **Sentient serif body - the cluster's one serif reading voice.** `--font-body`/`--font-serif` = Sentient (soft-contrast variable serif) for lede and running text. It warms the cold canvas; Midnight and Terminal are all-sans, so the serif is instantly Aurora. **Roman only** (italic in headers is a global AI tell, banned).
-4. **Weighty Sora display** - `--display-weight: 600`, `--tracking-display: -0.035em`, `--text-display: clamp(3rem, 6vw + 1rem, 5.75rem)`. Heavy sans confidence against the serif body. Never the thin 300 that owns Midnight.
-5. **One teal-green signal, used sparingly** (< 5% of any viewport) - `--color-accent: oklch(68% 0.145 172)` on the eyebrow tick, a link hover, the one primary button, focus rings, a status chip, an active nav item. Buttons fill teal-green with `--color-accent-ink` (= paper) text. Everything else is ink-on-dark. Cyan stays in the bloom, never a second UI flood.
-6. **Elevated dark surfaces + faint hairlines.** Cards ride `paper-2`/`paper-3`, seamed by 1px `--color-rule: oklch(28% 0.022 200)` (or `rule-2` for a brighter edge). Genre glow-lift on hover (soft cyan shadow, `translateY(-4px)`) - no drop-shadow theatre.
-7. **Wide-tracked mono eyebrows** - `--font-label` (Geist Mono), UPPERCASE, `--tracking-label: 0.10em`. The machine-readout voice between the heavy Geist display and the calm Sentient prose.
-8. **Centred, breathing hero** - genre gate 6 loosened; `--section-gap: 6.5rem`. The bloom field frames the type; let the void carry it.
+## Typography
-## Motion
-
-Fade only, composed and slow. Section reveals fade + rise once. Hover: teal-green underline-grow on links, a 1px border shift to `--color-accent` and a soft teal glow-lift on cards. No slide, no bounce, no parallax, no autoplay - the blooms are fixed and never animate. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static and fully visible.
-
-## Anti-patterns
-
-- **No warm accent** (amber, orange, terracotta, gold) - that is Bloom and Lumen-Night. Aurora is teal-green + cyan, hue 172/200.
-- **No single azure glow at hue 250** - that is Midnight. Aurora is *two* blooms and greener (hue 200).
-- **No all-sans body** - the body is Sentient serif; never set running text to the display sans. The serif is the theme's warmth.
-- **No thin display** - Sora 600, not Midnight's thin Geist 300.
-- **No pure black / `#111`** - the ground is cyan-tilted `11% 0.025 200`.
-- **No italic anywhere, no gradient text, no glassmorphism** (global gates). Sentient runs roman.
-- **No built apparatus or leader-line diagram** - that focal grammar is Lumen. Aurora's canvas treatment is ambient blooms, not a machined object.
-- **No rainbow aurora** - the curtain is two cold hues (cyan + teal-green) only, never a full spectrum.
-
-## Macrostructure affinity / rejection
+- **Display** - Sora 600, roman, `--tracking-display: -0.035em`, `--text-display: clamp(3rem, 6vw + 1rem, 5.75rem)`. Heavy sans confidence against the serif body.
+- **Body** - **Sentient** 400/500 (Fontshare), a soft-contrast variable serif. The cluster's one serif reading voice: lede and running text both. It warms the cold canvas, and since Midnight and Terminal are all-sans it reads as Aurora instantly. Roman only.
+- **Label** - Geist Mono, UPPERCASE, `--tracking-label: 0.10em`. The machine-readout voice: captions, meta rows, status chips, table headers, units, folios.
-**Aurora loves:** Marquee Hero (one heavy Sora hero over the bloom field, canonical) · Manifesto (the cold canvas argues a statement) · Stat-Led (cyan numerics glowing on near-black) · Feature-stack (capabilities on layered dark surfaces) · Quote-Led (the Sentient serif carries a pulled line).
+## Material
-**Aurora refuses:** Bento Grid (tile collage fights the diffuse curtain) · Catalogue (too commercial and busy for the calm dark) · Workbench (clinical, tool-first - route Cobalt) · Conversational FAQ (too casual for the after-dark register).
+- **Two cool blooms.** Fixed-attached radial gradients: cyan (hue 200) top-right, teal-green (hue 172) bottom-left, each ~25-30% footprint at low chroma, overlapping toward the centre so the ground curtains. Static, never animated. One lonely glow is Midnight, not Aurora.
+- **Elevated dark surfaces, faint hairlines.** Surfaces ride `paper-2` / `paper-3`, seamed by 1px `--color-rule`. Hover lifts with a soft cyan glow and `translateY(-4px)`. No drop-shadow theatre.
+- **Radius** - soft: pill controls at `999px`, gentle radii elsewhere. Nothing ruler-drawn.
+- **Void** - `--section-gap: 6.5rem`. The bloom field frames the type; let the void carry it.
-## Voice fixtures
+## Motion
-Cool, after-dark, dev-fluent, warmed by the serif. Name the thing plainly.
+Fade only, composed and slow. Reveals fade and rise ~10px, once. Hover: a teal-green underline-grow on links, a 1px border shift to `--color-accent`, a soft glow-lift on raised surfaces. No slide, no bounce, no parallax, no autoplay; the blooms are fixed and never animate. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static and fully visible.
-- *"Ship after dark."*
-- *"The moment after the deploy goes green."*
-- *"Cool by default. Warm where it reads."*
-- *"Built for the late shift."*
-- *"Green across the board, coast to coast."*
+## Do-nots (this theme's own failure modes)
-Never any of: *seamless, cutting-edge, revolutionary, supercharge, unlock, leverage, synergy, robust*. Never italics. Never "click here"; name the command or the number.
+- **Never one azure glow at hue 250.** That is Midnight. Aurora is *two* blooms and greener (172 + 200).
+- **Never a warm accent** (amber, orange, terracotta, gold). That lane belongs to Bloom and Lumen Night.
+- **Never an all-sans body.** Running text is Sentient serif; the serif is the theme's warmth.
+- **Never a thin display.** Sora 600, not Midnight's Geist 300.
+- **Never a rainbow aurora.** The curtain is two cold hues, never a full spectrum.
+- **Never a built apparatus or leader-line diagram.** That focal grammar is Lumen. Aurora's canvas treatment is ambient, not machined.
-## How Aurora differs from neighbouring themes
+## How Aurora differs from its neighbours
-| vs | what settles it instantly |
+| vs | difference |
|---|---|
-| **Midnight** (cool-dark sibling) | Midnight is one diffuse azure glow (hue 250), all-Geist sans, thin 300, restrained. Aurora is **two** blooms (teal-green 172 + cyan 200), a **Sentient serif body**, a heavy **Sora** 600 display, and a teal-green signal. Paired-cold-curtain-with-serif vs single-glow-all-sans. |
-| **Lumen** (atmospheric) | Lumen is warm brass-on-violet with a *built apparatus* + Instrument Serif *display* + blueprint grid. Aurora is cool *ambient blooms* + Sora display + Sentient body. Machined-artefact vs atmospheric-curtain; warm vs cold. |
-| **Bloom** (atmospheric, canonical light) | Bloom is warm cream light paper, expressive consumer copy. Aurora is near-black cyan dark, dev-after-dark copy. Warm-light vs cold-dark settles it at a glance. |
-
-## Test brief expectations
+| **Midnight** | One diffuse azure glow (hue 250), all-Geist sans, thin 300, restrained. Aurora is two blooms (172 + 200), a Sentient serif body, a heavy Sora 600. Paired-cold-curtain-with-serif vs single-glow-all-sans. |
+| **Lumen** | Warm brass-on-violet with a *built apparatus*, Instrument Serif *display*, blueprint grid. Aurora is cool ambient blooms, Sora display, Sentient body. Machined-artefact vs atmospheric-curtain, warm vs cold. |
+| **Bloom** | Warm cream light paper, expressive consumer register. Aurora is near-black cyan dark, dev-after-dark register. Warm-light vs cold-dark at a glance. |
-Aurora is a candidate when the brief mentions:
+## When the brief routes here
-- *dev tool · AI tool · generative · model playground · render · pipeline · observability · deploy · ship · dark mode · after-hours · late-night · nocturnal · moody · cool · aurora · northern lights · blue-green · cold-clarity*
-- Product categories: *AI creative tool · generative model UI · dev tool with a moody register · data / observability console · cool nocturnal SaaS*
-- Emotional tone: *cool · after-dark · atmospheric · calm-confident · cold-but-not-clinical · post-deploy*
+*dev tool · AI tool · generative · model playground · render · pipeline · observability · deploy · ship · dark mode · after-hours · late-night · nocturnal · moody · aurora · northern lights · blue-green · cold-clarity*. Categories: AI creative tools, generative model UIs, dev tools with a moody register, data and observability consoles, cool nocturnal SaaS. Tone: cool, after-dark, atmospheric, calm-confident, cold but not clinical.
-Warm / consumer / editorial / light briefs route elsewhere (Bloom or Lumen-Night for warm atmospheric, Cobalt for a light code tool). When the brief wants dark, cold, and a glowing canvas, it is Aurora.
+Warm, consumer, editorial, or light briefs route elsewhere (Bloom or Lumen Night for warm atmospheric, Cobalt for a light code tool). When the brief wants dark, cold, and a glowing canvas, it is Aurora.
## Build hint
+```html
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+<link href="https://fonts.googleapis.com/css2?family=Sora:wght@400;600;700&family=Geist+Mono:wght@400;500&display=swap" rel="stylesheet" />
+<link href="https://api.fontshare.com/v2/css?f[]=sentient@400,500&display=swap" rel="stylesheet" />
+```
+
```css
html, body { overflow-x: clip; }
body { background: var(--color-paper); color: var(--color-ink-2);
- font-family: var(--font-body); font-weight: 400; }
+ font-family: var(--font-body); font-weight: 400; } /* Sentient serif reading voice */
/* The two cool blooms - the whole canvas treatment, fixed and static */
body::before { content: ""; position: fixed; inset: 0; z-index: -1; pointer-events: none;
@@ -105,11 +92,13 @@ body::before { content: ""; position: fixed; inset: 0; z-index: -1; pointer-even
radial-gradient(38% 32% at 82% 12%, oklch(72% 0.17 200 / 0.20), transparent 70%),
radial-gradient(40% 34% at 12% 92%, oklch(68% 0.145 172 / 0.16), transparent 72%); }
-/* Weighty Sora display + wide-tracked mono eyebrow */
+/* Weighty Sora display */
.display { font-family: var(--font-display); font-weight: var(--display-weight);
letter-spacing: var(--tracking-display); font-size: var(--text-display); }
-.eyebrow { font-family: var(--font-label); text-transform: uppercase;
- letter-spacing: var(--tracking-label); color: var(--color-accent); }
+
+/* Mono label voice - captions, meta, units, status */
+.label { font-family: var(--font-label); text-transform: uppercase;
+ letter-spacing: var(--tracking-label); color: var(--color-muted); }
/* The one teal-green signal */
.btn--primary { background: var(--color-accent); color: var(--color-accent-ink);
@@ -125,4 +114,4 @@ a:hover { color: var(--color-accent); }
}
```
-Plus the Geist + Geist Mono + Sentient link and the small reveal script.
+Plus one `IntersectionObserver` adding `.is-in`. The rest of the page is yours: Aurora supplies the ground, the curtain, and the two voices, and what gets built in that light is the brief's business.
diff --git a/skills/hallmark/references/themes/bloom.md b/skills/hallmark/references/themes/bloom.md
index 07c2e97..b7f10f1 100644
--- a/skills/hallmark/references/themes/bloom.md
+++ b/skills/hallmark/references/themes/bloom.md
@@ -1,100 +1,85 @@
# Theme - Bloom
-The **light-paper** atmospheric theme: a generative AI-creative tool (music, video, image, voice) rendered in **warm daylight** instead of the usual nocturnal dark. A calm warm off-white ground (`oklch(97% 0.010 72)`), a soft terracotta bloom that reads like dawn light through a studio window, Geist geometric-sans display, Instrument Serif as a warm counterpoint, Geist Mono machine labels. It reads like a sunlit studio: inviting, expressive, made-not-manufactured. The daytime, optimistic face of the genre - Suno / Runway warmth pulled into the light.
+The **light-paper** atmospheric theme: the generative-creative register rendered in **warm daylight** instead of the usual nocturnal dark. A calm warm off-white ground, a soft terracotta bloom that reads like dawn light through a studio window, Geist geometric-sans display, Instrument Serif as a warm counterpoint, Geist Mono machine labels. It reads like a sunlit studio: inviting, expressive, made-not-manufactured.
-Loaded eagerly by SKILL.md Step 3 when the catalog pick is `bloom`. Tokens: [`site/css/tokens.css`](../../../../site/css/tokens.css) `[data-theme="bloom"]`. No canonical build yet - mirror the atmospheric genre defaults.
+The material, in one line: **warm light emitted from a light ground, plain sans, one serif line.**
## Axes (diversification)
-- **Paper band** - light warm off-white (`L 97%`, hue 72, very low chroma `0.010`). `oklch(97% 0.010 72)`. The documented light-paper exception in a mostly-dark genre; distinct from every dark atmospheric ground and from Cobalt's cool near-white.
+- **Paper band** - light warm off-white (`oklch(97% 0.010 72)`, `L 97%`, hue 72, very low chroma). The documented light-paper exception in a mostly-dark genre; distinct from every dark atmospheric ground and from Cobalt's cool near-white.
- **Display style** - **geometric-sans** (Geist `600`, `--tracking-display: -0.022em`, roman). Plain-English and confident. Distinct from serif themes and from Cobalt's grotesk.
- **Accent hue** - **restrained terracotta-coral** (`oklch(56% 0.13 35)`) with a soft warm companion (`oklch(64% 0.09 55)`) used only in the bloom tint. Warm ~35 deg; sits clear of Lumen's brass (~50) and any cool blue.
## Reference register
-Suno . Udio . Runway . Luma . Pika . Krea . Ideogram . Playground . Kittl . consumer-facing generative-creative studios. The aesthetic: a warm, sunlit creative canvas where the generated output is the hero, plain-English expressive display, one warm accent on small surfaces. **Never name any of these in the output.**
+Suno · Udio · Runway · Luma · Pika · Krea · Ideogram · Playground · Kittl · consumer-facing generative-creative studios.
-**Patron-saint reference (internal):** *dawn light falling across a fresh studio canvas* - the atmospheric bloom recoloured from midnight to morning. When in doubt ask "does this feel like a studio at 9am, or a nightclub at midnight?" Keep the former.
+The material to match: a warm, sunlit creative canvas where the made thing is the hero, plain-English expressive display, one warm accent on small surfaces. Dawn light falling across a fresh studio canvas - the atmospheric bloom recoloured from midnight to morning. Ask "does this feel like a studio at 9am, or a nightclub at midnight?" Keep the former. **Never name any of these in the output.**
-## Required dependencies
+**Voice range:** warm, daylight, expressive, specific. Say the verb (make, hum, describe) and say the output (song, scene, image).
-1. **Fonts** - **Geist** (display + body, `400/500/600`), **Instrument Serif** (roman counterpoint only), **Geist Mono** (labels + meta). Google Fonts:
- ```html
- <link rel="preconnect" href="https://fonts.googleapis.com" />
- <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
- <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600&family=Instrument+Serif&family=Geist+Mono:wght@400;500&display=swap" rel="stylesheet" />
- ```
-2. **A small reveal script** - one `IntersectionObserver` adding `.is-in` (fade only, optional <=8px rise, reveal-once/unobserve). Reduced-motion ships static + fully visible.
-3. **Optional one-shot type-in** of a single prompt line in the hero demo, then static. No looping.
+## Palette
-## Signature moves
+- `--color-paper: oklch(97% 0.010 72)` - warm off-white, never `#fff`
+- `--color-paper-2` / `--color-paper-3` - warm elevated surfaces
+- `--color-ink: oklch(20% 0.022 40)` - warm near-black headlines
+- `--color-ink-2: oklch(30% 0.022 46)` - body
+- `--color-muted: oklch(50% 0.018 58)` - meta
+- `--color-accent: oklch(56% 0.13 35)` - terracotta, the one signal
+- `--color-accent-2: oklch(64% 0.09 55)` - soft warm companion, bloom tint only
+- `--color-accent-ink: oklch(98% 0.010 72)` - text on a terracotta fill
-1. **Warm bloom on warm light paper** - the name move. Paper is `--color-paper` `oklch(97% 0.010 72)`, never `#fff`. One or two **fixed, un-animated** radial blooms sit behind the content: `--color-accent` (terracotta 35 deg) at ~8-10% alpha and `--color-accent-2` (55 deg) at ~6-8%, each ~25-40% footprint. It reads like sunlight on paper - Bloom **emits warm light from a light ground**, the genre's documented light-paper exception.
+Every neutral carries a warm cast (hue 40-72): the page is warm-tinted top to bottom. Accent stays a signal under ~8% of any viewport, spent on one filled control, links, and small tags; never a wash behind type.
-2. **Geist geometric-sans display, plain and confident** - `--font-display` at `--display-weight: 600`, `--tracking-display: -0.022em`, `--lh-tight: 1.06`, sized to `--text-display` (clamp to `5.75rem`). Roman, never italic. Expressive plain-English headline. A **near-centred hero is allowed** here (genre loosens the left-bias gate); the bloom frames the type.
+## Typography
-3. **Warm near-black ink, never `#000`** - `--color-ink` `oklch(20% 0.022 40)` for headlines, `--color-ink-2` `oklch(30% 0.022 46)` for body, `--color-muted` `oklch(50% 0.018 58)` for meta. Every neutral carries a warm cast (hue 40-72). The whole page is warm-tinted, top to bottom.
+- **Display** - Geist at `--display-weight: 600`, `--tracking-display: -0.022em`, `--lh-tight: 1.06`, clamped up to `5.75rem`. Roman, never italic. Expressive plain-English, confident rather than decorative.
+- **Body** - Geist 400/500.
+- **Serif** - Instrument Serif appears as **one** warm gesture: a lede sentence, a pulled line, or a large numeral. Roman always, never in the H1. This dual voice (geometric sans plus one serif line) separates Bloom from the all-Geist dark siblings without turning editorial.
+- **Label** - Geist Mono, UPPERCASE, `--tracking-label: 0.12em`. The dry technical voice against the warm expressive display: captions, tags, model names, meta rows, table headers, units.
-4. **Instrument Serif as a warm counterpoint (roman only)** - `--font-serif` appears as **one** serif gesture: a lede sentence, a pull-quote, or a large numeral. Roman always, never in the H1, never italic in any heading. This dual voice (geometric sans + one serif line) separates Bloom from all-Geist dark siblings without turning editorial.
+## Material
-5. **Geist Mono machine-readout labels** - `--font-label` UPPERCASE, `--tracking-label: 0.12em`, for eyebrows, tags, model names, prompt chips, meta. The dry technical voice set against the warm expressive display.
-
-6. **Pill CTA with a warm terracotta glow** - genre allows accent-fill pills. The one primary button fills `--color-accent` `oklch(56% 0.13 35)` with `--color-accent-ink` `oklch(98% 0.010 72)` text; hover adds a soft warm glow shadow (accent at low alpha) - the atmospheric lift. Accent stays a **signal** (< ~8% of any viewport); it is "used sparingly" per the token.
-
-7. **Elevated warm surfaces, not hairlines** - atmospheric depth. Cards use `--color-paper-2` / `--color-paper-3` over a soft warm shadow with a `--color-rule` hairline; on hover they lift toward the reader with a warm glow. Depth comes from warm elevation, never from cool blur or glass.
-
-8. **The generated output is the specimen** - the focal artefact is a hand-built CSS/SVG output card sitting in the bloom: a warm-lit prompt bar, a generated frame strip, a waveform, an image tile. It names the tool's verb (make, hum, compose, render) and shows the result, warmly lit - not a stock photo, not a glowing orb.
+- **Warm bloom on warm light paper.** The name move. One or two **fixed, un-animated** radial blooms sit behind the content: `--color-accent` (35 deg) at ~8-10% alpha and `--color-accent-2` (55 deg) at ~6-8%, each ~25-40% footprint. It reads like sunlight on paper. Bloom **emits warm light from a light ground**, the genre's documented light-paper exception.
+- **Elevated warm surfaces, not hairlines.** Depth is `--color-paper-2` / `--color-paper-3` over a soft warm shadow with a `--color-rule` hairline; raised things lift toward the reader with a warm glow on hover. Warm elevation, never cool blur or glass.
+- **Radius** - soft pills (`999px`) on controls; the one filled control takes `--color-accent` with `--color-accent-ink` text and a low-alpha warm glow on hover.
+- **Hand-built imagery.** Whatever the page shows is drawn in CSS and hand-authored SVG and lit warmly by the bloom, never a stock photo and never a glowing orb.
## Motion
-Fade-in only; the atmosphere does the work. Section reveals fade (optional <=8px rise), reveal-once. The bloom is **static and fixed** - never animated, never a drifting blob. Hover adds a warm glow on the CTA and a lift on cards. Optional one-shot prompt type-in, then static. No slide, no bounce, no parallax, no autoplay. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static and fully visible.
-
-## Anti-patterns
-
-- **No dark canvas.** Bloom is the light-paper atmospheric theme; a dark ground is Midnight / Terminal / Lumen-Night territory. Paper stays `L 97%`.
-- **No cool paper or cool accent.** Warm hue (40-72 neutrals, ~35 accent) throughout; a cool grey or blue reads as Cobalt / Midnight.
-- **No `#fff` / `#000`.** Warm off-white paper, warm near-black ink.
-- **No italic headers, no italic Instrument Serif in the H1** (global rule). The serif counterpoint is roman.
-- **No accent flood.** Terracotta lives on the CTA, the bloom, and small tags (< ~8% of viewport); a large orange field collides with Lumen brass / Coral coral and reads as a warning colour.
-- **No glassmorphism, no gradient text** (universal gates). Warm elevation, not glass.
-- **No hard-edged or moving bloom.** Soft, low-opacity, static, fixed; a drifting aurora blob is Aurora's move and breaks the calm.
-- **No instrument-panel restraint.** Bloom is expressive and warm, not Cobalt's cool hairline dashboard.
-
-## Macrostructure affinity / rejection
-
-**Bloom loves:** Marquee Hero (one confident generative demo in the bloom - the atmospheric default) . Manifesto (a warm creative-tool page argues a worldview) . Photographic / portfolio-grid (a gallery of generated output, warmly lit) . feature-stack (make -> refine -> share workflow) . Stat-Led (only when there are honest numbers).
+Fade-in only; the atmosphere does the work. Reveals fade (optional <=8px rise), once. The bloom is **static and fixed**, never animated, never a drifting blob. Hover adds a warm glow on the filled control and a lift on raised surfaces. An optional one-shot type-in of a single line is allowed, then static, never looping. No slide, no bounce, no parallax, no autoplay. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static and fully visible.
-**Bloom refuses:** Workbench / component-playground (too mechanical - that is Cobalt / Lumen) . Long Document (prose-led; route editorial / Garden) . Letter (too intimate for a tool) . Catalogue (commerce grid; Bloom breathes).
+## Do-nots (this theme's own failure modes)
-## Voice fixtures
+- **Never a dark canvas.** Bloom is the light-paper atmospheric theme; a dark ground is Midnight, Terminal, or Lumen Night. Paper stays `L 97%`.
+- **Never cool paper or a cool accent.** Warm throughout (neutrals 40-72, accent ~35); a cool grey or blue reads as Cobalt or Midnight.
+- **Never an accent flood.** A large orange field collides with Lumen brass and Coral coral and starts reading as a warning colour.
+- **Never a hard-edged or moving bloom.** Soft, low-opacity, static, fixed; a drifting blob is Aurora's move and breaks the calm.
+- **Never instrument-panel restraint.** Bloom is expressive and warm, not Cobalt's cool hairline dashboard.
+- **Never an italic serif line.** The Instrument Serif counterpoint is roman.
-Warm, daylight, expressive, specific. Name the verb, name the output.
+## How Bloom differs from its neighbours
-- *"Hum it. We'll finish the song."*
-- *"From a sentence to a scene, before your coffee's cold."*
-- *"Make something today you couldn't yesterday."*
-- *"Describe the light. We'll paint it."*
-- *"A studio that opens when you do."*
-
-Never any of: *seamless, revolutionary, unleash, unlock, supercharge, cutting-edge, next-generation, game-changing, AI-powered* (as a badge). Say the verb (make, hum, describe), say the output (song, scene, image).
-
-## How Bloom differs from neighbouring themes
-
-| vs | what settles it instantly |
+| vs | difference |
|---|---|
-| **Midnight** (atmospheric, same Geist) | Midnight is a **dark** cool canvas (hue ~250), nocturnal and cool. Bloom is **light** warm off-white (hue 72) with a warm terracotta bloom. Light vs dark plus warm vs cool settles it at a glance. |
-| **Coral** (modern-minimal, same warm + Geist + light) | Coral is warm-grey paper, hairline structure, a quiet SaaS product page, no bloom. Bloom is warm-cream with a warm radial bloom, expressive AI-creative display, and elevated surfaces. The bloom + expressive register is the tell. |
-| **Garden** (editorial, same warm-light paper) | Garden is oat-cream with a roman-serif Young Serif display, green ink, and a hand-built botanical specimen. Bloom keeps warm-neutral ink, a Geist geometric display, and a light bloom canvas. Different ink, different focal treatment (botanical object vs warm light). |
+| **Midnight** | A **dark** cool canvas (hue ~250), nocturnal. Bloom is **light** warm off-white (hue 72) with a warm terracotta bloom. Light vs dark plus warm vs cool settles it at a glance. |
+| **Coral** | Warm-grey paper, hairline structure, a quiet product register, no bloom. Bloom is warm-cream with a warm radial bloom, an expressive display, and elevated surfaces. The bloom plus the register is the tell. |
+| **Garden** | Oat-cream with a roman-serif Young Serif display, green ink, hand-built botanical craft. Bloom keeps warm-neutral ink, a geometric display, and a light bloom canvas. Different ink, different focal treatment. |
-## Test brief expectations
+## When the brief routes here
-Candidate when the brief mentions: *generative . AI creative . music . song . video . image . voice . art . make . create . compose . render . imagine . prompt . studio . playground . expressive . warm . daylight . inviting . consumer creative*.
-Product categories: *generative music / video / image / voice tool . creative AI app . consumer model playground . AI art studio.*
-Emotional tone: *warm . inviting . optimistic . expressive . daylight-creative . human . playful-but-refined.*
-Briefs that are dark / nocturnal (Midnight, Lumen), technical / instrument (Cobalt), or editorial / photographic-with-real-photos route elsewhere.
+*generative · AI creative · music · song · video · image · voice · art · make · create · compose · render · imagine · prompt · studio · playground · expressive · warm · daylight · inviting · consumer creative*. Categories: generative music, video, image and voice tools, creative AI apps, consumer model playgrounds, AI art studios. Tone: warm, inviting, optimistic, expressive, daylight-creative, human, playful but refined.
+
+Dark or nocturnal briefs route to Midnight or Lumen, technical or instrument briefs to Cobalt, editorial or real-photography briefs elsewhere.
## Build hint
+```html
+<link rel="preconnect" href="https://fonts.googleapis.com" />
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+<link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600&family=Instrument+Serif&family=Geist+Mono:wght@400;500&display=swap" rel="stylesheet" />
+```
+
```css
html, body { overflow-x: clip; }
body { background: var(--color-paper); color: var(--color-ink-2);
@@ -108,20 +93,19 @@ body::before {
radial-gradient(46% 40% at 18% 90%, oklch(64% 0.09 55 / 0.07), transparent 72%); }
/* Geist display - geometric, roman, sized big */
-.hero__title, .section__title {
- font-family: var(--font-display); font-weight: var(--display-weight);
+.display { font-family: var(--font-display); font-weight: var(--display-weight);
letter-spacing: var(--tracking-display); line-height: var(--lh-tight);
color: var(--color-ink); }
-/* Instrument Serif - warm roman counterpoint, never the H1 */
+/* Instrument Serif - one warm roman gesture, never the H1 */
.lede--serif { font-family: var(--font-serif); font-style: normal;
color: var(--color-ink-2); }
-/* Geist Mono machine-readout labels */
-.eyebrow, .tag { font-family: var(--font-label); text-transform: uppercase;
+/* Mono label voice - captions, tags, meta, units */
+.label { font-family: var(--font-label); text-transform: uppercase;
letter-spacing: var(--tracking-label); color: var(--color-muted); }
-/* One pill CTA, warm terracotta glow on hover */
+/* One filled control, warm terracotta glow on hover */
.btn--solid { background: var(--color-accent); color: var(--color-accent-ink);
border-radius: 999px; }
.btn--solid:hover { box-shadow: 0 8px 30px oklch(56% 0.13 35 / 0.28); }
@@ -133,4 +117,4 @@ body::before {
.reveal { opacity: 1; transition: none; } }
```
-Plus the Geist + Instrument Serif + Geist Mono link and the small reveal script.
+Plus one `IntersectionObserver` adding `.is-in`. Bloom supplies the daylight, the warm ground, and the two voices; what the light falls on is the brief's business.
diff --git a/skills/hallmark/references/themes/brutal.md b/skills/hallmark/references/themes/brutal.md
index c9c5857..3e557d0 100644
--- a/skills/hallmark/references/themes/brutal.md
+++ b/skills/hallmark/references/themes/brutal.md
@@ -1,8 +1,8 @@
# Theme - Brutal
-Raw graphic-design brutalism. The page for a **design studio, a streetwear drop, a zine, a statement portfolio, an event / festival poster** - the school of heavy grids, slab type, and one loud signal. Near-white paper (`oklch(98% 0.001 0)`) is carved by near-black 3px rules (`oklch(12% 0.005 0)`), stacked with giant uppercase Albert Sans 700, and cut by exactly ONE red (`#E63946`) as a fill-block or bar. It reads like a wayfinding sign or a broadsheet front page: loud, rigid, unhedged.
+Raw graphic-design brutalism: heavy grids, slab type, one loud signal. Near-white paper is carved by near-black 3px rules, stacked with giant uppercase Albert Sans 700, and cut by exactly ONE red as a fill-block or bar. It reads like a wayfinding sign or a broadsheet front page: loud, rigid, unhedged.
-Loaded eagerly by SKILL.md Step 3 when the catalog pick is `brutal`. Tokens: `site/css/tokens.css` under `[data-theme="brutal"]`.
+The material, in one line: **a clean sheet, thick black rules, zero radius, one red cut.**
## Axes (diversification)
@@ -12,94 +12,74 @@ Loaded eagerly by SKILL.md Step 3 when the catalog pick is `brutal`. Tokens: `si
## Reference register
-Bloomberg Businessweek graphics, Balenciaga, Gumroad, Cash App, Are.na, MSCHF, Off-White, Read the Docs. The aesthetic: the heavy-grid front page and the wayfinding sign - thick black rules, one red bar, type as the structure. **Patron-saint (internal):** *a broadsheet masthead crossed with a machine-shop label plate* - rigid grid, one red stamp, everything flush to a border. Never name any of these in the output.
+Bloomberg Businessweek graphics · Balenciaga · Gumroad · Cash App · Are.na · MSCHF · Off-White · Read the Docs. **Never name any of these in the output.**
-## Required dependencies
+The material to match: the heavy-grid front page and the wayfinding sign - thick black rules, one red bar, type as the structure. Internally: *a broadsheet masthead crossed with a machine-shop label plate* - rigid grid, one red stamp, everything flush to a border.
-1. **Fonts** - **Albert Sans** (display + body, 400/500/700/900), **JetBrains Mono** (labels + meta). All-sans; no serif anywhere. Google Fonts:
- ```html
- <link href="https://fonts.googleapis.com/css2?family=Albert+Sans:wght@400;500;700;900&family=JetBrains+Mono:wght@400;500;700&display=swap" rel="stylesheet" />
- ```
-2. **A minimal reveal (optional)** - one `IntersectionObserver` adding `.is-in`. Motion snaps or steps, it does not glide (see Motion). Reduced-motion ships everything static + visible.
+## Palette
-## Signature moves
+Canonical values live in `site/css/tokens.css` under `[data-theme="brutal"]`.
-1. **Engineered near-white paper, near-black ink** - paper `oklch(98% 0.001 0)`, ink `oklch(8% 0.005 0)`, body `oklch(12% 0.005 0)`. Close to `#fff`/`#000` on purpose but never either: the ~0-chroma neutrality is what makes the red read as the only colour on the page.
+- `--color-paper: oklch(98% 0.001 0)` - engineered near-white
+- `--color-ink: oklch(8% 0.005 0)` - near-black, and the rule colour
+- body text `oklch(12% 0.005 0)`
+- `--color-muted: oklch(38%)` - mono meta
+- `--color-accent: #E63946` - the one red; as text, `--color-accent-ink: oklch(58% 0.24 25)`
-2. **Thick rules are the structure** - two weights only: `--rule-fine: 3px` heavy borders box every section and figure; `--rule-hair: 1px` splits rows inside them. Brutalism draws with a marker, not a pencil. Column rules stay visible; content sits flush to the border with no inset gutter softening it.
+Close to `#fff` / `#000` on purpose but never either: the ~0-chroma neutrality is what makes the red read as the only colour on the page. Keep the red under ~5% of any viewport. It cuts; it does not coat.
-3. **Zero radius, everywhere** - `border-radius: 0` on buttons, inputs, blocks, images. Square corners are non-negotiable; any rounding reads as a softer sibling and breaks the theme.
+## Typography
-4. **One red signal, graphic not gradient** - `#E63946` as a solid fill-block, a full-width bar, a `<mark>` at x-height, the focus ring, one primary button (red fill, paper text). Kept under ~5% of any viewport. Never a gradient, never a tint wash, never two accents.
+All-sans. No serif anywhere.
-5. **Uppercase Albert Sans 700 display, edge to edge** - heads run UPPERCASE, `--tracking-display: -0.045em`, `--lh-tight: 1.02`, sized by `--text-display` (clamp to 6.5rem). Flush-left, allowed to run wide and clip against a rule. Never centred, never italic (global rule).
+- **Display** - Albert Sans 700, UPPERCASE, `--tracking-display: -0.045em`, `--lh-tight: 1.02`, sized by `--text-display` (clamp to 6.5rem). Flush-left, edge-aligned to a rule, allowed to run wide and clip against it. Never centred, never italic.
+- **Body** - Albert Sans 400/500.
+- **Label** - JetBrains Mono, UPPERCASE, `--tracking-label: 0.04em`, in `--color-muted`. The machine-readout counterpoint to the shouting display: meta rows, table headers, captions, filenames, kbd hints, units, folios, entry numbers inside a real `<ol>`. It records a value; it never introduces a heading.
-6. **Inverted solid blocks, no float** - the page reads as stacked filled rectangles: a solid black panel with paper text, a solid red panel, a bordered white panel. No drop-shadow blur, no glass, no card-on-card float - blocks butt against each other and against rules.
+## Material
-7. **JetBrains Mono catalog voice** - eyebrows, section numbers (`01 / 02 / 03`), meta rows, filenames, kbd hints in mono, UPPERCASE, `--tracking-label: 0.04em`, in `--color-muted` (`oklch(38%)`). The machine-readout counterpoint to the shouting display face.
+- **Thick rules are the structure.** Two weights only: `--rule-fine: 3px` heavy borders box sections and figures; `--rule-hair: 1px` splits rows inside them. Brutalism draws with a marker, not a pencil. Content sits flush to the border with no inset gutter softening it.
+- **Zero radius, everywhere.** `border-radius: 0` on buttons, inputs, blocks, images. Square corners are non-negotiable; any rounding reads as a softer sibling and breaks the theme.
+- **Inverted solid blocks, no float.** The page reads as stacked filled rectangles: a solid black panel with paper text, a solid red panel, a bordered white panel. No drop-shadow blur, no glass, no card-on-card float - blocks butt against each other and against rules.
+- **No texture, no pattern, no ornament.** The rules and the fills are the whole surface treatment.
## Motion
-Mechanical and abrupt. Reveals snap or step (a hard `opacity` cut, or a 1-step translate over ~120ms), they do not ease-glide. Hover flips state instantly: a block inverts to `--color-ink` (or `--color-accent`) with paper text, a border thickens to red. No bounce, no parallax, no blur transition, no autoplay. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static + fully visible.
+Mechanical and abrupt. Reveals snap or step (a hard `opacity` cut, or a 1-step translate over ~120ms), they do not ease-glide. Hover flips state instantly: a block inverts to `--color-ink` (or `--color-accent`) with paper text, a border thickens to red. No bounce, no parallax, no blur transition, no autoplay. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static and fully visible.
-## Anti-patterns
+## Voice range
+
+Blunt, declarative, often ALL CAPS. Verbs and nouns, no hedging, no hype. Never *seamless, elegant, delightful, gentle, soft, curated, whimsical, effortless, playful*. Say the thing flat.
+
+## Do-nots (this theme's own failure modes)
- **No rounded corners.** Any `border-radius` > 0 belongs to Cobalt / Coral, not here.
- **No blurred drop-shadows, no glassmorphism.** Depth is borders and solid fills; a hard-offset no-blur shadow is Carnival's decorative move, keep it out.
-- **No ornaments / fleurons / layered offset stacks** - that is Carnival's decorated lane. Brutal is raw.
+- **No ornaments, fleurons, or layered offset stacks.** That is Carnival's decorated lane. Brutal is raw.
- **No black paper.** Inversion into a dark ground is Manifesto. Brutal is a **light 98%** sheet with black structure.
- **No second colour, no gradient, no pastel.** Exactly one red signal on near-neutral ink.
-- **No serif, no italic display.** Albert Sans + JetBrains Mono only.
-- **No centred hero, no soft prose column drifting to middle.** Flush-left, edge-aligned to a rule.
-- **Do not let the red flood.** It cuts; it does not coat.
-
-## Macrostructure affinity / rejection
-
-**Brutal loves:**
-- **Manifesto** - short, loud, all-caps declaratives stacked between heavy rules.
-- **Stat-Led** - big figures in bordered cells, mono labels beneath.
-- **Specimen / type-specimen** - Albert Sans 700 as the subject, giant glyphs edge to edge.
-- **Catalogue / index-first** - numbered rows split by hairlines, mono meta, one red column.
-- **Bento Grid** - only with 3px square-cornered borders (a rigid module wall, never soft tiles).
-
-**Brutal refuses:**
-- **Photographic / image-led** - Brutal leads with type and rule, not imagery.
-- **Letter** - too intimate; Brutal shouts, it does not confide.
-- **Conversational FAQ** - too friendly and rounded for a wayfinding sign.
-- **Quote-Led** - too gentle a centre of gravity.
-
-## Voice fixtures
+- **No serif, no italic display.** Albert Sans and JetBrains Mono only.
-Blunt, declarative, often ALL CAPS. Verbs and nouns, no hedging.
-
-- *"SAME PROMPT. TWO OUTPUTS."*
-- *"NO TEMPLATES. NO DEFAULTS."*
-- *"READ THE SPEC. SHIP THE PAGE."*
-- *"STRUCTURE IS THE STYLE."*
-- *"ONE RED. EVERYTHING ELSE IS INK."*
-
-Never any of: *seamless, elegant, delightful, gentle, soft, curated, whimsical, effortless, playful*. No hedges, no hype. Say the thing flat.
-
-## How Brutal differs from neighbouring themes
+## How Brutal differs from its neighbours
| vs | what settles it instantly |
|---|---|
-| **Carnival** (editorial maximalist sibling) | Carnival is **decorated**: duo-tone accents, ornaments, hard-offset layered shadows, variable-width type, tinted paper. Brutal is **raw**: near-white paper, one red, thick black borders, no ornament, Albert Sans slab. Decorated vs raw. |
-| **Manifesto** (loud editorial sibling) | Manifesto is **BLACK paper** + all-caps red display (dark, inverted polarity). Brutal is a **light 98% sheet** with black structure and a red cut. Light vs dark settles it in one glance. |
-| **Riso** (print-craft editorial) | Riso is risograph craft: peach paper, CMYK misregistration, soft grainy ink. Brutal is hard-edged and crisp: no texture, no misregistration, heavy exact rules. |
+| **Carnival** (editorial maximalist sibling) | Carnival is **decorated**: duo-tone accents, ornaments, hard-offset layered shadows, variable-width type, tinted paper. Brutal is **raw**: near-white paper, one red, thick black borders, no ornament. Decorated vs raw. |
+| **Manifesto** (loud editorial sibling) | Manifesto is **BLACK paper** with all-caps red condensed display, inverted polarity. Brutal is a **light 98% sheet** with black structure and a red cut. Light vs dark settles it in one glance. |
+| **Riso** (print-craft editorial) | Riso is risograph craft: pink stock, misregistration, soft grainy ink. Brutal is hard-edged and crisp: no texture, no misregistration, heavy exact rules. |
-## Test brief expectations
+## When the brief routes here
-Brutal should be a candidate when the brief mentions:
-
-- *brutalist · raw · bold · high-contrast · statement · agency · studio · portfolio · streetwear · drop · zine · manifesto · type-forward · graphic-design · poster · festival · collective · no-nonsense · uncompromising*
-- Product categories: *design studio / agency · streetwear or fashion drop · editorial / zine · type-forward portfolio · event or festival page · statement landing*
-- Emotional tone: *loud · blunt · confident · raw · high-contrast · rigid · unhedged*
+*brutalist · raw · bold · high-contrast · statement · agency · studio · portfolio · streetwear · drop · zine · type-forward · graphic-design · poster · festival · collective · no-nonsense · uncompromising*. Categories: design studios and agencies, streetwear or fashion drops, editorial and zines, type-forward portfolios, event or festival pages, statement landings. Tone: loud, blunt, confident, raw, rigid, unhedged.
Warm, soft, image-led, or intimate briefs route elsewhere (Carnival for decorated maximalism, Manifesto for the dark inversion, the quieter editorial themes for prose).
## Build hint
+```html
+<link href="https://fonts.googleapis.com/css2?family=Albert+Sans:wght@400;500;700;900&family=JetBrains+Mono:wght@400;500;700&display=swap" rel="stylesheet" />
+```
+
```css
html, body { overflow-x: clip; }
body { background: var(--color-paper); color: var(--color-ink);
@@ -119,7 +99,7 @@ h1, h2, .display { font-family: var(--font-display);
.accent { color: var(--color-accent-ink); }
.btn { border: var(--rule-fine) solid var(--color-rule); border-radius: 0; }
-/* Mono catalog voice */
+/* Mono label voice - meta, captions, units, real values */
.label { font-family: var(--font-label); text-transform: uppercase;
letter-spacing: var(--tracking-label); color: var(--color-muted); }
@@ -131,4 +111,4 @@ h1, h2, .display { font-family: var(--font-display);
}
```
-Plus the Albert Sans + JetBrains Mono link and the minimal snap-reveal script.
+The rest of the page is yours. Brutal supplies the sheet, the rules, and the one red; what gets stacked between them is the brief's business, not the theme's.
diff --git a/skills/hallmark/references/themes/carnival.md b/skills/hallmark/references/themes/carnival.md
index b24c4a5..d7a75f3 100644
--- a/skills/hallmark/references/themes/carnival.md
+++ b/skills/hallmark/references/themes/carnival.md
@@ -1,301 +1,172 @@
# Theme - Carnival
-Loud-maximalist editorial. **Duo-tone accent system across six named palette drops** (each its own mood), chunky variable display, decorative ornaments, hard-offset shadows, tinted paper. The loud sibling to Riso / Manifesto / Brutal - but **decorative, not raw**.
+Loud-maximalist editorial. A duo-tone accent system on tinted paper, chunky variable-width display, typographic ornaments, hard-offset ink shadows. The loud sibling to Riso, Manifesto, and Brutal, but **decorative, not raw**: this is poster craft, printed by someone who prints posters as a side hustle.
-Loaded eagerly by SKILL.md Step 3 whenever the catalog pick is `carnival`. The default palette ("Cold Snap") and font stack live in [`site/css/tokens.css`](../../../../site/css/tokens.css) under `[data-theme="carnival"]`; this file carries the **palette drops** (six variants) plus the rules that tokens cannot encode.
+The material, in one line: **tinted paper, two accents that compete instead of blending, and a flat ink shadow offset four pixels.**
## Axes (diversification)
-- **Paper band** - light (`L 88-95%`, tinted - varies by drop)
-- **Display style** - **display-heavy** (Big Shoulders Display 800, variable-width axis)
-- **Accent hue** - **per-drop**. Each drop has its own duo-tone hue pair (warm+warm, cool+warm, warm+cool, etc.). The drop name is recorded alongside the theme name in the diversification log so consecutive builds rotate drops, not just themes.
+- **Paper band** - light (`L 88-95%`), always tinted, never white. The tint varies by drop.
+- **Display style** - **display-heavy** (Big Shoulders Display 800, with the variable width axis in use).
+- **Accent hue** - **per-drop**. Each drop carries its own duo-tone pair (warm+warm, cool+warm, warm+cool). The drop name is logged beside the theme name so consecutive builds rotate drops, not just themes.
+
+## Reference register
+
+Dropout TV · Fly.io · Stones Throw Records · Third Man Records · Drag City · Moodelier · Kelsey Dake · Bold Monday.
+
+Independent music labels, comedy networks, illustrator portfolios, hot-sauce brands, indie game studios. Things with **character**. Things that sound loud out loud. When in doubt about decorative density, ask whether Dropout or Stones Throw would run this much: if less, add ornaments; if more, it has gone too far.
## Palette drops
-A drop is a named duo-tone palette that preserves Carnival's structural signature (saturated accent-1 + complementary accent-2 + tinted paper + deep ink) while rotating hue. **Every Carnival build picks one drop.** The catalog of six:
+A drop is a named duo-tone palette that holds Carnival's material (saturated accent-1, complementary accent-2, tinted paper, deep ink) while rotating hue. Every Carnival build picks one.
### Drop 01 · Cold Snap *(default)*
-Warm + warm. Indie record-label, winter, scrappy. The canonical Carnival.
+Warm + warm. Indie record-label, winter, scrappy. The canonical Carnival. **Pick for** independent music, winter releases, DIY, cassettes, vinyl, EPs.
- `--color-paper: oklch(92% 0.045 50)` - warm pink-cream
-- `--color-paper-2: oklch(88% 0.050 45)`
-- `--color-paper-3: oklch(82% 0.060 40)`
+- `--color-paper-2: oklch(88% 0.050 45)` · `--color-paper-3: oklch(82% 0.060 40)`
- `--color-ink: oklch(18% 0.080 20)` - deep aubergine
-- `--color-ink-2: oklch(28% 0.060 25)`
-- `--color-muted: oklch(45% 0.05 30)`
-- `--color-rule: oklch(40% 0.18 25)` - oxblood rules (decorative)
+- `--color-ink-2: oklch(28% 0.060 25)` · `--color-muted: oklch(45% 0.05 30)`
- `--color-accent: oklch(86% 0.18 95)` - mustard
-- `--color-accent-2: oklch(40% 0.21 25)` - oxblood
-- `--color-accent-ink: oklch(18% 0.080 20)`
-- `--color-focus: oklch(40% 0.21 25)`
-
-**When to pick:** independent music · winter releases · DIY scrappy · the brief mentions cassettes, vinyl, EPs.
+- `--color-accent-2: oklch(40% 0.21 25)` - oxblood · `--color-rule: oklch(40% 0.18 25)` (decorative)
+- `--color-accent-ink: oklch(18% 0.080 20)` · `--color-focus: oklch(40% 0.21 25)`
### Drop 02 · Citrus Riot
-Loud + neon. 90s zine, summer, electric. Lime against magenta - the hardest collision in the catalogue.
+Loud + neon. 90s zine, summer, electric. Lime against magenta, the hardest collision in the catalogue. **Pick for** zine collectives, summer drops, skate and DIY culture, briefs that want LOUD without referencing music.
- `--color-paper: oklch(94% 0.040 85)` - pale acid cream
-- `--color-paper-2: oklch(90% 0.048 82)`
-- `--color-paper-3: oklch(84% 0.055 80)`
+- `--color-paper-2: oklch(90% 0.048 82)` · `--color-paper-3: oklch(84% 0.055 80)`
- `--color-ink: oklch(20% 0.07 145)` - deep forest
-- `--color-ink-2: oklch(32% 0.05 140)`
-- `--color-muted: oklch(48% 0.04 130)`
-- `--color-rule: oklch(28% 0.28 350)` - deep magenta rules
+- `--color-ink-2: oklch(32% 0.05 140)` · `--color-muted: oklch(48% 0.04 130)`
- `--color-accent: oklch(82% 0.20 130)` - chartreuse-lime
-- `--color-accent-2: oklch(28% 0.28 350)` - deep magenta (reads AA on paper, and as text)
-- `--color-accent-ink: oklch(20% 0.07 145)`
-- `--color-focus: oklch(28% 0.28 350)`
-
-**When to pick:** zine collectives · summer drops · skate / DIY culture · briefs that want LOUD without referencing music.
+- `--color-accent-2: oklch(28% 0.28 350)` - deep magenta, also `--color-rule` (reads AA on paper, and as text)
+- `--color-accent-ink: oklch(20% 0.07 145)` · `--color-focus: oklch(28% 0.28 350)`
### Drop 03 · Diner Sign
-Americana. Cream + cherry red + navy. Postwar diner, road trip, neon-and-chrome.
+Americana. Cream, cherry red, navy. Postwar diner, road trip, neon-and-chrome. **Pick for** food and drink, hospitality, vintage Americana, briefs mentioning burgers, milkshakes, motels, roadside.
- `--color-paper: oklch(95% 0.035 90)` - bright cream
-- `--color-paper-2: oklch(91% 0.042 88)`
-- `--color-paper-3: oklch(86% 0.050 85)`
+- `--color-paper-2: oklch(91% 0.042 88)` · `--color-paper-3: oklch(86% 0.050 85)`
- `--color-ink: oklch(16% 0.04 30)` - black-brown
-- `--color-ink-2: oklch(28% 0.05 30)`
-- `--color-muted: oklch(45% 0.04 35)`
-- `--color-rule: oklch(30% 0.16 250)` - navy rules
+- `--color-ink-2: oklch(28% 0.05 30)` · `--color-muted: oklch(45% 0.04 35)`
- `--color-accent: oklch(60% 0.22 25)` - cherry red
-- `--color-accent-2: oklch(30% 0.16 250)` - navy
-- `--color-accent-ink: oklch(95% 0.035 90)`
-- `--color-focus: oklch(30% 0.16 250)`
-
-**When to pick:** food + drink · hospitality · vintage Americana · briefs mentioning burgers, milkshakes, motels, roadside.
+- `--color-accent-2: oklch(30% 0.16 250)` - navy, also `--color-rule`
+- `--color-accent-ink: oklch(95% 0.035 90)` · `--color-focus: oklch(30% 0.16 250)`
### Drop 04 · Studio Night
-Cool + cool. Dusk warmth, cyan + plum. Late-night booth, blue hour, podcast studio at midnight.
+Cool + cool. Dusk warmth, cyan and plum. Late-night booth, blue hour, studio at midnight. **Pick for** late-night radio, podcasts, music and atmosphere, briefs mentioning "late", "after dark", "blue hour", "moonlight".
- `--color-paper: oklch(88% 0.05 25)` - warm dusk pink
-- `--color-paper-2: oklch(84% 0.055 22)`
-- `--color-paper-3: oklch(78% 0.06 20)`
+- `--color-paper-2: oklch(84% 0.055 22)` · `--color-paper-3: oklch(78% 0.06 20)`
- `--color-ink: oklch(20% 0.05 270)` - deep navy-black
-- `--color-ink-2: oklch(32% 0.045 265)`
-- `--color-muted: oklch(48% 0.04 260)`
-- `--color-rule: oklch(24% 0.18 320)` - deep plum rules
+- `--color-ink-2: oklch(32% 0.045 265)` · `--color-muted: oklch(48% 0.04 260)`
- `--color-accent: oklch(78% 0.18 220)` - cyan
-- `--color-accent-2: oklch(24% 0.18 320)` - deep plum (reads AA on paper, and as text)
-- `--color-accent-ink: oklch(20% 0.05 270)`
-- `--color-focus: oklch(24% 0.18 320)`
-
-**When to pick:** late-night radio · podcasts about anything · music + atmosphere · briefs mentioning "late", "after dark", "blue hour", "moonlight".
+- `--color-accent-2: oklch(24% 0.18 320)` - deep plum, also `--color-rule` (reads AA on paper, and as text)
+- `--color-accent-ink: oklch(20% 0.05 270)` · `--color-focus: oklch(24% 0.18 320)`
### Drop 05 · Aqua Park
-Cool + warm. Turquoise against coral. Summer pool, motel sign, vacation.
+Cool + warm. Turquoise against coral. Summer pool, motel sign, vacation. **Pick for** summer brands, vacation and hospitality, skate, surf, pool, briefs mentioning summer, beach, motel, sun.
- `--color-paper: oklch(94% 0.040 180)` - pale aqua-cream
-- `--color-paper-2: oklch(90% 0.048 178)`
-- `--color-paper-3: oklch(84% 0.055 175)`
+- `--color-paper-2: oklch(90% 0.048 178)` · `--color-paper-3: oklch(84% 0.055 175)`
- `--color-ink: oklch(20% 0.06 200)` - deep teal
-- `--color-ink-2: oklch(32% 0.05 198)`
-- `--color-muted: oklch(48% 0.04 195)`
-- `--color-rule: oklch(36% 0.24 35)` - deep coral rules
+- `--color-ink-2: oklch(32% 0.05 198)` · `--color-muted: oklch(48% 0.04 195)`
- `--color-accent: oklch(72% 0.16 195)` - turquoise
-- `--color-accent-2: oklch(36% 0.24 35)` - deep coral (reads AA on paper, and as text)
-- `--color-accent-ink: oklch(20% 0.06 200)`
-- `--color-focus: oklch(36% 0.24 35)`
-
-**When to pick:** summer brands · vacation / hospitality · skate / surf / pool · briefs mentioning summer, beach, motel, sun.
+- `--color-accent-2: oklch(36% 0.24 35)` - deep coral, also `--color-rule` (reads AA on paper, and as text)
+- `--color-accent-ink: oklch(20% 0.06 200)` · `--color-focus: oklch(36% 0.24 35)`
### Drop 06 · Pressroom
-Warm + cool. Amber-gold against slate-blue. 1950s journalism, print shop, broadsheet weight.
+Warm + cool. Amber-gold against slate-blue. 1950s journalism, print shop, broadsheet weight. **Pick for** journalism, newsletters, editorial and opinion, briefs mentioning "press", "newspaper", "broadsheet", "subscription".
- `--color-paper: oklch(89% 0.025 65)` - warm slate-cream
-- `--color-paper-2: oklch(85% 0.030 62)`
-- `--color-paper-3: oklch(79% 0.035 58)`
+- `--color-paper-2: oklch(85% 0.030 62)` · `--color-paper-3: oklch(79% 0.035 58)`
- `--color-ink: oklch(16% 0.02 60)` - ink-black
-- `--color-ink-2: oklch(28% 0.025 58)`
-- `--color-muted: oklch(45% 0.025 55)`
-- `--color-rule: oklch(34% 0.10 240)` - slate-blue rules
+- `--color-ink-2: oklch(28% 0.025 58)` · `--color-muted: oklch(45% 0.025 55)`
- `--color-accent: oklch(78% 0.18 75)` - amber-gold
-- `--color-accent-2: oklch(34% 0.10 240)` - slate-blue
-- `--color-accent-ink: oklch(16% 0.02 60)`
-- `--color-focus: oklch(34% 0.10 240)`
-
-**When to pick:** journalism · newsletters · editorial / opinion · briefs mentioning "press", "newspaper", "broadsheet", "subscription".
-
-### Drop rotation rule
-
-The diversification log (`/.hallmark/log.json`) records the drop alongside the theme: `"theme": "carnival", "drop": "studio-night"`. **A new Carnival build picks a drop that hasn't appeared in the last 3 entries.** If only Cold Snap is in the log, any of the other five is valid. If the brief contains a strong drop signal (see "when to pick" above), honour the signal even if it tightens diversification.
-
-### Pick the drop by domain first
-
-Match the brief's **domain** before reaching for the loudest palette:
-
-- food / drink / hospitality / street market → **Diner Sign** (or Cold Snap)
-- independent music / labels / EPs → **Cold Snap** (or Pressroom)
-- late-night / radio / podcast / after-dark → **Studio Night**
-- summer / pool / beach / vacation → **Aqua Park**
-- zine / skate / DIY / deliberately chaotic → **Citrus Riot**
-- journalism / newsletter / editorial → **Pressroom**
-
-Citrus Riot and Aqua Park are the highest-chroma drops - reach for them when the brief genuinely *wants* maximum loudness, not as a default. A food market reads better in Diner Sign than in lime-on-magenta.
-
-### When to construct a custom drop instead
-
-If the brief explicitly names a brand colour that doesn't fit any catalog drop - e.g. *"our brand is teal and beige"* - route to the **custom theme** branch (see `custom-theme.md`) instead of stretching a Carnival drop. Drops are curated, not infinite. Six is the right number for now.
-
-## Reference register
-
-Dropout TV · Fly.io · Stones Throw Records · Third Man Records · Drag City · Moodelier · Kelsey Dake · Bold Monday.
-
-The aesthetic: independent music labels, comedy networks, illustrator portfolios, hot-sauce brands, indie game studios. Things with **character**. Things that print posters as a side hustle. Things that sound loud out loud.
-
-**Patron-saint reference (internal):** *Dropout TV homepage* + *Stones Throw artist pages*. When in doubt about decorative density, ask "would Dropout or Stones Throw run this much density?" If less, add ornaments. If more, you've gone too far.
-
-## Signature moves
-
-The theme's seven tics. A Carnival build should exhibit at least five of them.
-
-1. **Duo-tone accent system.** Sections alternate which accent fills them. Section 1 fills with `--color-accent` (mustard); section 2 fills with `--color-accent-2` (oxblood); section 3 mustard again; etc. One section never shows both - they are *competing*, not blended.
+- `--color-accent-2: oklch(34% 0.10 240)` - slate-blue, also `--color-rule`
+- `--color-accent-ink: oklch(16% 0.02 60)` · `--color-focus: oklch(34% 0.10 240)`
- ```css
- .section:nth-of-type(odd) { --section-fill: var(--color-accent); }
- .section:nth-of-type(even) { --section-fill: var(--color-accent-2); }
- ```
+**Picking and rotating.** Match the brief's domain before reaching for the loudest palette: food and hospitality → Diner Sign; independent music → Cold Snap; late-night and radio → Studio Night; summer and pool → Aqua Park; zine, skate, deliberately chaotic → Citrus Riot; journalism and editorial → Pressroom. Citrus Riot and Aqua Park are the highest-chroma drops: reach for them when the brief genuinely wants maximum loudness, not by default. The log records `"theme": "carnival", "drop": "studio-night"`, and a new build picks a drop absent from the last three entries unless the brief signals one. If the brief names a brand colour no drop fits, route to a custom theme rather than stretching a drop; six is the right number.
-2. **Decorative ornaments.** Use `✱` (asterisk operator), `❋` (heavy six-petalled), `◆` (black diamond) as bullets, section dividers, and rhythmic spacers. Patterns:
- - Section dividers: `✱ ✱ ✱ ✱` (repeated 4×, centred)
- - List bullets: `❋` (replaces • / disc)
- - Section heading prefixes: `◆ Section Name` (left-aligned, ornament in accent colour)
+## Typography
-3. **Layered colour blocks that bleed off the page edge.** Accent fills extend 24px past the page max-width on the left or right, so they read as **posters pinned to the wall**, not as buttons.
+- **Display** - Big Shoulders Display 800 with `font-variation-settings: "wdth" 110, "wght" 800`. Setting `font-stretch` does nothing on this face; only `font-variation-settings` moves the width axis.
+- **Case and tracking** - headlines are ALL CAPS (or `font-variant: all-petite-caps`), tracked **tight**: `-0.005em` on a hero word, `0.02em` on a section head. Loose `0.04em` reads as AI-spread and belongs only to a marquee, where horizontal spread is the point. Line-height stays tight too: `0.82` for a single hero word, `0.92` for multi-line heads.
+- **Body** - DM Sans, sentence case, short, present tense, full-ink. Carnival does not do subtle grey.
+- **Label voice** - JetBrains Mono caps micro-type, tracked `0.18em`. It sets captions, table headers, meta rows, folios, and units. It is not a kicker over a heading.
- ```css
- .colour-block { margin-inline: calc(var(--page-gutter) * -1); padding-inline: var(--page-gutter); }
- ```
+## Material
-4. **Hard-offset drop shadow.** Every card, CTA, and image gets `box-shadow: 4px 4px 0 var(--color-ink)`. No soft shadows ever. The shadow is **flat ink, offset**. This is the single most-recognisable Carnival move.
+- **Two accents that compete, never blend.** One accent fills a surface; the other fills the next. A block never shows both, and there is never a gradient between them. A mustard tile does not get an oxblood badge inside it.
+- **Hard-offset drop shadow.** `box-shadow: 4px 4px 0 var(--color-ink)`, zero blur, on cards, CTAs, and images. This is the single most recognisable Carnival move; a soft `0 8px 24px` shadow is a different theme. Leave clearance at the page edge so the offset is never clipped.
+- **Rules are 2px solid** in the drop's rule colour. Hairlines belong to Boutique and Specimen.
+- **Colour blocks bleed past the shell.** An accent fill extends ~24px past the page max-width on one side, so it reads as a poster pinned to a wall rather than a button.
+- **Typographic ornaments.** `✱` `❋` `◆` as bullets, dividers, and rhythmic spacers, in accent colour. These are ornaments, not emoji; smiley and heart emoji stay banned.
+- **Halftone fills** wherever the page would otherwise show a photo placeholder: `radial-gradient(var(--color-ink) 1.5px, transparent 1.5px)` at `12px 12px`. A halftone square holds a fixed small size and never overlaps type. Budget and recipe in [`texture.md`](../texture.md) § Halftone.
-5. **All-caps headlines with Big Shoulders variable-width, tightly tracked.** `font-variation-settings: "wdth" 110, "wght" 800;`. Track them **tight**, not loose: `letter-spacing: -0.005em` on the hero word, `0.02em` on section heads. The loose `0.04em` look reads as AI-spread and is reserved **only** for the marquee banner (where horizontal spread is the point). Keep line-height tight too: `0.82` for single hero words, `0.92` for multi-line heads. The effect is a marquee poster set by a typographer, not a stretched default.
+## Motion
-6. **Halftone pattern fills** in placeholder image regions (budget and generalized recipe: [`texture.md`](../texture.md) § Halftone). Pure CSS, no images:
+Mostly still, with one horizontal engine. A marquee of ornament-separated words can scroll at a banner or a footer; its content repeats at least twice (or ships `aria-hidden` siblings) so the loop reads continuous instead of one string sliding off. Hover states are colour swaps and shadow shifts, not lifts. `prefers-reduced-motion: reduce` freezes the marquee at its static state.
- ```css
- .halftone {
- background-image: radial-gradient(var(--color-ink) 1.5px, transparent 1.5px);
- background-size: 12px 12px;
- }
- ```
+## Do-nots (this theme's own failure modes)
- Used wherever the page would otherwise have a photo placeholder.
+- **Never a soft shadow.** Hard-offset or none. Reaching for a blur means the build has drifted to another theme.
+- **Never both accents inside one block.** They compete across surfaces; blending them kills the duo-tone read.
+- **Never sentence-case headlines,** and never loose tracking outside a marquee. Spread caps is the AI tell this theme is most prone to.
+- **Never light-grey body text or thin rules.** Full ink, 2px.
+- **Never a neutral CTA.** Every call to action fills with one of the two accents.
+- **Never a long paragraph.** Past three sentences, break it with an ornament divider or split it.
-7. **Marquee scroll** on banner OR footer with decorative dot separators. *"NEW EP ◆ OUT NOW ◆ ON CASSETTE ◆ BLUE VINYL ◆ NEW EP ◆..."* - horizontal scroll, honours `prefers-reduced-motion: reduce` (freeze at static state).
+## Voice range
-## Layout pitfalls (must avoid)
+Short, loud, declarative. Headlines all-caps, six words or fewer, ending in a period rather than an exclamation mark: the loudness is in the type, not the punctuation. Body in sentence case, one or two sentences a paragraph. Numerals over words. Never: experience, journey, elevate, curate, platform, ecosystem, transform. Carnival is independent, not platformed.
-Carnival's dense visual language has known traps. Read this list **before** writing a card layout - these are mistakes that have happened in earlier builds and shipped looking broken.
-
-1. **Halftone portrait + side-by-side text in a narrow card → text gets covered.** When pairing a halftone "host portrait" / "artist portrait" with a show / artist name in the same card, **never use a 2-column grid where the content column can collapse below 200 px**. On a 3-up `repeat(3, 1fr)` desktop grid, the content column inside each card is ~150-180 px wide and a 5 rem portrait squeezes the title into overlap. The safe patterns:
- - **Vertical stack** (portrait on top, content below - the portrait sits naturally in the top-left of the card content area because of card padding). This is the default for portrait-paired cards.
- - **Side-by-side ONLY at 2-up or 1-up grids** where the content column has ≥ 250 px to breathe.
- - **Sticker corner** - portrait positioned `absolute; top: 0; right: 0` as a small badge, with text content flowing full-width below.
-
- Concretely: if the card is in a `repeat(3, 1fr)` grid and includes a portrait + title pair, the card must use `display: flex; flex-direction: column;` with the portrait at a fixed `width: 4.5rem; height: 4.5rem;` (not `width: 100%`). Halftone squares **never** overlap typography.
-
-2. **Hard-offset shadow on a card next to a viewport edge → shadow gets clipped.** When a card sits flush against the right edge of the page gutter, its `4px 4px 0` shadow extends past the page max-width. Add `padding-right: max(var(--page-gutter), 8px)` to grids that include shadowed cards near the edge, or set the shell to have ≥ 8 px right margin past the card grid.
-
-3. **Duo-tone fill on a card whose content includes both accents → reads as "blended", not "competing".** A mustard tile must never contain an oxblood badge inside it. Pick one accent per tile. (Signature #1 explicitly says this - but it's worth restating here because it gets violated when adding a sticker or a "NEW" badge.)
-
-4. **Marquee scroll that doesn't repeat its content → gap at end of loop.** The marquee must contain the same scrolling text repeated at least twice (or use `aria-hidden` siblings) so the scroll animation reads as continuous, not as a single string sliding off.
-
-5. **Big Shoulders width axis used without `font-variation-settings` → no width variation.** Setting `font-stretch` on Google's Big Shoulders Display does not work - only `font-variation-settings: "wdth" 110` does. If you see a hero that's supposed to be width-110 but renders at width-100, this is the bug.
-
-6. **Section head detached from, or mis-centred over, its body.** The section head (heading + any lede) sits **tight above** the content it names - about `1.25rem` (`--section-head-gap`) - and **shares that content's alignment**. Don't cap the head at a narrow `max-width` / `ch` and then `margin-inline: auto` it: that strands a centred head over a full-width, left-flush grid (the classic accidental mismatch). Left-flush grid → left-flush head. (See the alignment-coherence note in `layout-and-space.md`.)
-
-7. **Newsletter / CTA button not aligned with the input beside it.** When a button sits next to a form input in one row, they must share the **same height, vertical padding, and border width**, and the row must use `align-items: center` - otherwise the button floats above the input's baseline. If a label is stacked above the input it makes that column taller; centre the row on the *control*, not the column (give the field `align-items: center` or pull the label out of the flex row).
-
-## Macrostructure affinity
-
-**Carnival loves these.**
-
-- **Marquee Hero** - the canonical Carnival opening; large word, scrolling banner under
-- **Type Specimen** - the page IS the type; Big Shoulders Display 96 px+ as content
-- **Manifesto** - short loud declarative statements (works for Carnival's voice too, but louder palette)
-- **Stat-Led** - when the page leads with numbers, Carnival displays them big-and-mustard
-- **Photographic** - image-led with halftone treatments and ornament captions
-- **Bento Grid** (loud variant) - gridded blocks where each tile alternates accent colour
-
-## Macrostructure rejection
-
-**Carnival refuses these.**
-
-- **Long Document** - too quiet; Carnival doesn't sustain over 1500 words
-- **Letter** - too intimate; Carnival never whispers
-- **Quote-Led** - too pensive
-- **Conversational FAQ** - too soft
-- **Workbench** - too technical; Carnival is poster art, not product spec
-
-If the brief would otherwise land in one of these, redirect to Marquee Hero or Manifesto.
-
-## Voice fixtures
-
-Sample lines the Carnival voice should *read like*. Short. Loud. Declarative. Caps on the headlines, not on the body.
-
-- *"FIVE NEW FLAVORS. ALL TOO HOT."*
-- *"WE PRESS RECORDS. THAT'S IT."*
-- *"NEW SEASON. NEW SHOWS. SAME CHAOS."*
-- *"ONE EP. THREE ARTISTS. NO REGRETS."*
-- *"THE GAME IS PIXEL ART. THE GAME IS HARD."*
-
-Body copy is **shorter than other themes**. 1-2 short sentences per paragraph. Paragraphs separated by ornament dividers, not whitespace alone.
-
-**Voice rules:**
-- Headlines: ALL CAPS, ≤ 6 words, period at end (not exclamation - the loudness is in the type, not the punctuation).
-- Body: sentence case, short, present-tense.
-- Numerals over words always (*5* not *five*).
-- Never any of: "experience", "journey", "elevate", "curate", "platform", "ecosystem", "transform". These are SaaS-default AI tells; Carnival is independent, not platformed.
-
-## Anti-patterns (theme-specific)
-
-- **Never soft shadows.** Carnival is hard-offset (`4px 4px 0`) or no shadow. If you find yourself reaching for `0 8px 24px`, redirect.
-- **Never both accents in one block.** Mustard *or* oxblood per section, never blended.
-- **Never sentence-case headlines.** Headlines are ALL CAPS or `font-variant: all-petite-caps`.
-- **Never light-grey text.** Body text is full-ink. Carnival doesn't do "subtle".
-- **Never long paragraphs.** If a paragraph exceeds 3 sentences, break it with an ornament divider or split into two blocks.
-- **Never neutral CTAs.** Every CTA fills with one of the two accent colours.
-- **Never thin rules.** Rules are 2 px solid in oxblood. Hairlines belong to Boutique / Specimen.
-- **Emoji as decoration is allowed when typographic** (✱ ❋ ◆ are typographic ornaments, not emoji). Smiley-face / heart emoji are still banned per universal anti-patterns.
-
-## How Carnival differs from neighbouring themes
+## How Carnival differs from its neighbours
| vs | difference |
|---|---|
-| **Riso** | Riso is risograph print-craft (peach paper, CMYK misregistration on display, cyan + yellow). Carnival is *editorial maximalism* - duo-tone, oxblood-on-pink, decorative ornaments, variable-width type. Different parent tradition. |
-| **Manifesto** | Manifesto is BLACK paper + ALL CAPS red Anton. Carnival is *tinted warm paper* + duo accents + ornaments. Inverted polarity - Manifesto is dark, Carnival is light. |
-| **Brutal** | Brutal is raw graphic-design brutalism (heavy borders, slab type, no ornaments). Carnival is **decorative** - ornaments, layered blocks, variable type, character. |
-| **Sport** | Sport is athletic italic uppercase (Inter Tight italic 700). Carnival is poster-art expressive (Big Shoulders 800 with width axis). Sport feels Nike; Carnival feels Drag City. |
+| **Riso** | Riso is risograph print-craft: peach paper, CMYK misregistration on display, cyan and yellow. Carnival is editorial maximalism: duo-tone, oxblood on pink, ornaments, variable-width type. Different parent tradition. |
+| **Manifesto** | Manifesto is black paper and all-caps red Anton. Carnival is tinted warm paper, duo accents, ornaments. Inverted polarity: one is dark, the other light. |
+| **Brutal** | Brutal is raw graphic-design brutalism: heavy borders, slab type, no ornaments. Carnival is decorative: ornaments, layered blocks, variable type, character. |
+| **Sport** | Sport is athletic italic uppercase (Inter Tight italic 700). Carnival is poster-art expressive (Big Shoulders 800 with the width axis). Sport feels Nike; Carnival feels Drag City. |
+| **Arcade** | Arcade shares the hard-offset shadow but runs it on a dark violet-black CRT with pixel type and neon. Carnival is warm daylight paper and a fairground poster. |
-## Test brief expectations
+## When the brief routes here
-Carnival should be a candidate when the brief mentions:
+*record label · podcast · comedy · indie · zine · poster · illustrator · games · hot sauce · merch · streetwear · cassette · vinyl · live show*. Categories: music, comedy, games, illustration, food with character, merch, skateboards, gig posters. Tone: loud, fun, scrappy, chaotic, layered, character-led, decorative.
-- *record label · podcast · comedy · indie · zine · poster · illustrator · games · hot sauce · merch · streetwear · cassette · vinyl · cassettes · live show · zine · brand of one*
-- product categories: music · comedy · games · illustration · hot sauce · merch · skateboards · gig posters
-- emotional tone: *loud, fun, scrappy, chaotic, layered, character-led, decorative*
-
-Briefs that say *enterprise / scale / API / B2B / dashboard* never route to Carnival.
+Briefs about enterprise, scale, APIs, B2B, or dashboards never route to Carnival.
## Build hint
-When emitting a Carnival page, the first 12 lines of CSS should establish the four most important tells:
+```html
+<link href="https://fonts.googleapis.com/css2?family=Big+Shoulders+Display:wght@400;700;800&family=DM+Sans:wght@400;500;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet" />
+```
```css
body { background: var(--color-paper); color: var(--color-ink); font-family: var(--font-body); }
-h1, h2 { font-family: var(--font-display); font-weight: 800; font-variation-settings: "wdth" 110; letter-spacing: 0.02em; line-height: 0.92; text-transform: uppercase; } /* hero word goes tighter: letter-spacing: -0.005em; line-height: 0.82 */
-.card, .cta { box-shadow: 4px 4px 0 var(--color-ink); border: 2px solid var(--color-ink); }
-.section:nth-of-type(odd) { background: var(--color-accent); color: var(--color-accent-ink); }
-.section:nth-of-type(even) { background: var(--color-accent-2); color: var(--color-paper); }
+
+h1, h2 { /* tight caps, width axis engaged */
+ font-family: var(--font-display); font-weight: 800;
+ font-variation-settings: "wdth" 110; text-transform: uppercase;
+ letter-spacing: 0.02em; line-height: 0.92;
+}
+/* a lone hero word goes tighter: letter-spacing: -0.005em; line-height: 0.82 */
+
+.hard { /* the flat ink shadow - zero blur, never negative spread */
+ border: 2px solid var(--color-ink);
+ box-shadow: 4px 4px 0 var(--color-ink);
+}
+
.ornament { color: var(--color-accent); }
-.halftone { background-image: radial-gradient(var(--color-ink) 1.5px, transparent 1.5px); background-size: 12px 12px; }
+.halftone { background-image: radial-gradient(var(--color-ink) 1.5px, transparent 1.5px);
+ background-size: 12px 12px; }
```
-Those rules carry 70 % of the theme's identity. The rest is content fit.
+Those rules carry the identity. Which surfaces take which accent, and what the page is made of them, is the brief's business, not Carnival's.
diff --git a/skills/hallmark/references/themes/cobalt.md b/skills/hallmark/references/themes/cobalt.md
index e3e2e98..6343b26 100644
--- a/skills/hallmark/references/themes/cobalt.md
+++ b/skills/hallmark/references/themes/cobalt.md
@@ -1,119 +1,78 @@
# Theme - Cobalt
-Modern-minimal, dev-tool register. The page for an **API, an SDK, a CLI, a docs home, a developer platform** - the GitBook / Firecrawl / Vercel school, executed in **cool cobalt-on-light, not orange**. A calm cool-white ground, ruler-drawn hairlines, exactly ONE electric cobalt signal accent, and **code as the hero**. It reads like good infrastructure: calm, precise, fast.
+Modern-minimal, dev-tool register: the GitBook and Vercel school, executed in **cool cobalt-on-light, not orange**. A calm cool-white ground, ruler-drawn hairlines, exactly one electric cobalt signal, tight technical radii, and mono for anything machine-shaped. It reads like good infrastructure: calm, precise, fast.
-Loaded eagerly by SKILL.md Step 3 whenever the catalog pick is `cobalt`. The OKLCH palette + font stack live in [`site/css/tokens.css`](../../../../site/css/tokens.css) under `[data-theme="cobalt"]`. Reference build: [`site/examples/cobalt-01/`](../../../../site/examples/cobalt-01/) (an API product landing with a request/response hero).
+The material, in one line: **cool near-white, hairlines instead of boxes, and one electric blue used as a signal.**
-> **Why not orange.** GitBook and Firecrawl both converged on orange-as-signal - but that lane is now crowded, and Hallmark's warm slots are already taken (Lumen brass, Bloom terracotta, Coral coral). Cobalt keeps their *discipline* (cool ground + one signal + code-as-hero + hairlines) and aims the signal at the open electric-blue lane instead. The blue is the differentiator, not a copy.
+> **Why not orange.** GitBook and Firecrawl both converged on orange-as-signal, but that lane is crowded and Hallmark's warm slots are taken (Lumen brass, Bloom terracotta, Coral coral). Cobalt keeps the discipline - cool ground, one signal, hairline structure - and aims the signal at the open electric-blue lane. The blue is the differentiator, not a copy.
## Axes (diversification)
-- **Paper band** - cool light (`L 98.5%`, hue ~250, very low chroma). An engineered near-white - distinct from Coral's warm grey and from the genre's dark grounds.
-- **Display style** - **grotesk-sans** (Space Grotesk 500/600 - slightly mechanical, tight tracking). Distinct from Geist (Coral) and from every serif/rounded option.
-- **Accent hue** - **electric cobalt** (`oklch(58% 0.20 256)`). High-chroma true blue - reads "API-live," sits clear of Midnight/Lumen's dusky indigos (~250/268). Used as a *signal*, never a flood.
+- **Paper band** - cool light (`L 98.5%`, hue ~250, very low chroma), an engineered near-white distinct from Coral's warm grey and from the genre's dark grounds. Ink is cool charcoal `oklch(24% 0.02 258)`; body text sits a notch lighter at `oklch(34% 0.018 257)`.
+- **Display style** - **grotesk-sans** (Space Grotesk 500/600, slightly mechanical, tight tracking). Distinct from Geist (Coral) and from every serif and rounded option.
+- **Accent hue** - **electric cobalt** (`oklch(58% 0.20 256)`). High-chroma true blue, reads "API-live", sits clear of Midnight and Lumen's dusky indigos (~250 and 268). A signal, never a flood.
## Reference register
-GitBook · Firecrawl · Vercel / Geist · Linear · Mintlify · Stripe docs · Resend · Clerk · Railway · Supabase.
+GitBook · Firecrawl · Vercel and Geist · Linear · Mintlify · Stripe docs · Resend · Clerk · Railway · Supabase. The material to match: a cool engineered canvas, one signal accent, mono machine-readout against a grotesk display, hairline structure, and a graphite surface where something technical is shown. When in doubt, ask whether this reads like an instrument panel or a marketing template, and keep the former. Never name any of these in the output.
-The aesthetic: the developer-product landing and docs home - a cool engineered canvas, one signal accent, **code/terminal/API as the focal element**, hairline structure, a ⌘K-flavoured nav. Never name any of these in the output.
+## Typography
-**Patron-saint reference (internal):** *Vercel's blueprint-and-mono restraint* + *Firecrawl's live request-result credibility move*, recoloured cobalt. When in doubt, ask "does this read like an instrument panel, or like a marketing template?" Keep the former.
+Three families, all sans, no serif anywhere.
-## Required dependencies
+- **Display** - Space Grotesk 500/600, tight tracking.
+- **Body** - Inter 400/500.
+- **Mono and label voice** - JetBrains Mono, UPPERCASE at `0.06em` tracking for captions, meta rows, table headers, status chips, units, folios, and keyboard hints; lowercase mono for code and commands. The machine-readout register against the Space Grotesk display. It is never a kicker over a heading.
-1. **Fonts** - **Space Grotesk** (display, 500/600), **Inter** (body, 400/500), **JetBrains Mono** (code + small UPPERCASE labels). All-sans; no serif anywhere. Google Fonts:
- ```html
- <link href="https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@400;500;600;700&family=Inter:wght@400;500;600&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet" />
- ```
-2. **A small reveal script** - one `IntersectionObserver` adding `.is-in` (fade + ~10px rise, ease-out ~600ms). Plus a one-shot "type-in" of a single line in the hero code demo, then static.
-3. **A working ⌘K command palette** - a small JS overlay that opens on click **and** ⌘K / Ctrl+K (Esc or backdrop closes; Arrow↑/↓ select; type-to-filter), `role="dialog"` / `aria-modal`, focus-managed, reduced-motion safe. The ⌘K in the nav actually works - Cobalt's signature interactive move.
+## Material
-## The signature moves
+- **Cool engineered paper, never `#fff`, never `#000`.** `oklch(98.5% 0.004 250)` on cool charcoal.
+- **Hairlines do the work.** 1px `--color-rule` borders define every surface. No boxed cards and no drop shadows beyond a single barely-there `0 1px 2px` lift. Depth comes from borders, not blur.
+- **One cobalt signal, under 5% of any viewport** - a link's hover underline, the one primary button, focus rings, a status chip, an active nav item, a syntax token. Everything else is ink on cool white.
+- **Tight technical radii** - 6px on controls, 10px on larger surfaces. Not Coral's soft pills, not zero-radius brutalism: drawn with a ruler.
+- **Graphite is the dark material.** Where the page needs a dark surface it is `oklch(22% 0.016 260)` (or `~20%` full-bleed) with light cool text and cobalt popping. Cobalt is a light theme *with* graphite in it, never a dark theme.
+- **No background texture or pattern at all.** No glassmorphism, no gradient text, no aurora or mesh blob. Cool paper plus hairlines carry the page.
-1. **Cool engineered paper, never `#fff`** - `oklch(98.5% 0.004 250)`. Ink is cool charcoal `oklch(24% 0.02 258)`, never `#000`. Body text sits a notch lighter (`oklch(34% 0.018 257)`).
-
-2. **Hairlines do the work** - 1px `--color-rule` borders define every surface. **No boxed cards, no drop-shadows** beyond a single barely-there `0 1px 2px` lift on the code card. Depth comes from borders, not blur.
-
-3. **One cobalt signal, used sparingly** (< 5% of any viewport) - the eyebrow tick, a link's hover underline, the one primary button, focus rings, the `200 OK` chip, the active nav item. Everything else is ink-on-cool-white.
-
-4. **Code is the hero** - a dark **graphite** card (`oklch(22% 0.016 260)`) with a window bar (3 dots + a filename), syntax tokens (cobalt for methods/keys, light for strings, muted for punctuation), and a status chip. One line types in once, then static. Either a **live API request/response** (POST + JSON `200 OK`) or a **terminal** (install + a clean `PASS` run). Title + lede sit LEFT; the demo sits RIGHT - asymmetric, never centred.
-
-5. **Bordered nav + a working ⌘K palette** - a flush full-width bar, single hairline bottom border, light blur on scroll. Wordmark + 2-3 text links left; a bordered **⌘K** affordance + one solid cobalt button right. The ⌘K **opens a real command palette** (mono search + command rows; click or ⌘K/Ctrl+K; Esc to close) - the page *behaves* like a dev tool, not just looks like one. **Not a floating pill** (softer, and Coral's vocabulary).
-
-6. **Tight technical radii** - 6px on buttons/inputs, 10px on code cards. Not Coral's soft pills, not 0px brutalism - "drawn with a ruler."
-
-7. **Mono labels** - eyebrows, meta, status, kbd hints in JetBrains Mono, UPPERCASE, `0.06em` tracking. The machine-readout voice against the Space Grotesk display.
-
-8. **One dark graphite band per page** - a single full-bleed dark section (a quickstart, a how-it-works, a watch-mode demo) on `oklch(~20% 0.016 260)` with light cool text and the cobalt accent popping. It gives the page a **light → dark → light** rhythm and a showcase moment. The page's *one* dark beat - Cobalt is a light theme *with* a dark band, never a dark theme.
+**Shapes Cobalt suits** (affinities, never requirements): a graphite code or terminal surface as the focal artefact, with a window bar, syntax tokens, and a status chip; a single full-bleed graphite band giving the page a light-dark-light rhythm; a working ⌘K palette (real keyboard handling, `role="dialog"`, focus-managed) so the page *behaves* like a dev tool rather than only looking like one.
## Motion
-Composed and sparse. The one hero type-in (plays once). Section reveals fade + rise. Hover: cobalt underline-grow on nav/links; a 1px border-colour shift to cobalt on the code card / focusable surfaces. **No bounce, no parallax, no autoplay.** Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static + fully visible.
-
-## Anti-patterns
-
-- **No orange accent** - the crowded GitBook/Firecrawl lane and a collision with Lumen/Bloom/Coral. Cobalt is blue.
-- **No warm paper** - warm grey is Coral's. Cobalt is cool (hue ~250-258).
-- **No pure `#fff` / `#000`.** Cool near-white paper, cool charcoal ink.
-- **No pill / gradient CTAs.** One solid cobalt button at 6px radius + understated typographic links. Name the destination.
-- **No centred-everything hero** (gate 6) - left-biased, title-left / demo-right.
-- **No three-equal-icon-tile feature grid** (gate 3) - vary it (one wide code example + narrower points; asymmetric benchmark figures).
-- **No glassmorphism, no gradient text** (gates), **no aurora/mesh blob, and no background texture/pattern at all** - cool paper + hairlines carry the page; its one dark beat is the graphite band (signature 8), not a background.
-
-## Macrostructure affinity
+Composed and sparse. Section reveals fade and rise ~10px over ~600ms ease-out via one `IntersectionObserver`. One line of a code demo may type in once, then stay static. Hover gives a cobalt underline-grow on links and a 1px border shift to cobalt on focusable surfaces. No bounce, no parallax, no autoplay. Everything gates behind `prefers-reduced-motion: no-preference`; reduced motion ships static and fully visible.
-**Cobalt loves these.**
+## Do-nots (this theme's own failure modes)
-- **SaaS / API Product** - deck ingredients: a quick-start code card, benchmark figures, real pricing - dealt per macrostructures.md § deck, never a fixed run *(canonical - cobalt-01)*
-- **Dev-tool / CLI** - terminal hero + install + benchmark figures + docs CTA
-- **Docs home** - a calm index with a search-first nav
-- **Workbench** - the technical, tool-first shape
-- **Marquee** - when the hero is one confident code demo
+- **Never an orange accent.** That is the crowded lane Cobalt exists to leave, and it collides with Lumen, Bloom, and Coral. Cobalt is blue.
+- **Never warm paper, and never pure `#fff` or `#000`.** Warm grey is Coral's. Cobalt is cool, hue 250-258, on cool charcoal.
+- **Never a pill or gradient CTA.** One solid cobalt button at 6px radius plus understated typographic links. Name the destination.
+- **Never a floating pill nav.** That is softer, and it is Coral's vocabulary. Cobalt's chrome is a flush bar with a single hairline.
+- **Never fake code.** A snippet on a Cobalt page compiles, resolves, or returns; an invented endpoint or a placeholder response is the theme's worst failure.
+- **Never more than one dark beat.** A second full-bleed dark section turns the light theme into a striped one.
-## Macrostructure rejection
+## Voice range
-**Cobalt refuses these.**
+Declarative, technical, specific: name the endpoint, the command, the number. No hype adjectives. Never: seamless, robust, cutting-edge, leverage, synergy, revolutionary, unlock, supercharge. Never "click here."
-- **Letter** - too intimate; Cobalt is a product, not a note
-- **Manifesto** - too loud; Cobalt is calm infrastructure
-- **Photographic / image-led** - Cobalt leads with code, not imagery
-- **Long Document** - prose-led; route warm-editorial instead
-
-## Voice fixtures
-
-Declarative, technical, specific. Name the X concretely. No hype adjectives.
-
-- *"Turn any website into clean Markdown for LLMs."*
-- *"One API. Every page."*
-- *"From idea to production in an afternoon."*
-- *"Type-safe by default. Fast by design."*
-- *"Built to ship - `200 OK` in under 200 ms."*
-
-Never any of: *seamless, robust, cutting-edge, leverage, synergy, revolutionary, unlock, supercharge*. Never "click here." Name the endpoint, the command, the number.
-
-## How Cobalt differs from neighbouring themes
+## How Cobalt differs from its neighbours
| vs | difference |
|---|---|
-| **Coral** (modern-minimal sibling) | Coral is warm-grey paper + warm coral accent + Geist + soft pills + a quiet title/lede hero. Cobalt is cool-white + electric blue + Space Grotesk/JetBrains Mono + tight bordered controls + a live code hero. Same genre, opposite temperature - the rotation walks between them. |
-| **Midnight** (atmospheric) | Both live near hue 250-258, but Midnight is a **dark** canvas (atmospheric, numbered display, typewriter reveals). Cobalt is a **light** engineered canvas (modern-minimal, code hero). Light vs dark settles it instantly. |
-| **Lumen** (atmospheric) | Lumen is a dark (or cool-bone) *apparatus* page with Instrument Serif + an emit/refract focal artefact. Cobalt is light, all-sans, and its focal element is a literal code/API card, not a built light-instrument. |
-| **Aurora** (atmospheric) | Aurora is dark cyan blooms + Sentient serif body. Cobalt is light, hairline-structured, cobalt-on-white - no blooms, no serif. |
+| **Coral** | Coral is warm-grey paper, warm coral accent, Geist, soft pills, quiet type. Cobalt is cool-white, electric blue, Space Grotesk and JetBrains Mono, tight bordered controls, graphite. Same genre, opposite temperature; the rotation walks between them. |
+| **Midnight** | Both live near hue 250-258, but Midnight is a **dark** atmospheric canvas with a numbered display and typewriter reveals. Cobalt is a **light** engineered canvas. Light vs dark settles it instantly. |
+| **Lumen** | Lumen is an apparatus page with Instrument Serif and an emit-or-refract focal artefact. Cobalt is all-sans, hairline-structured, and its focal material is literal code, not a built light-instrument. |
+| **Ledger** | Ledger is the dark sibling in the same cluster: navy ground, teal, Hanken and IBM Plex Mono, money as its subject. Cobalt is light, cobalt, and code as its subject. |
+| **Grid** | Grid is editorial Swiss: red accent, single-family Archivo, a visible 12-column grid, zero radius. Cobalt is a blue instrument with radii and a graphite surface. |
-## Test brief expectations
+## When the brief routes here
-Cobalt should be a candidate when the brief mentions:
+*API · SDK · CLI · dev tool · developer platform · docs · documentation · infrastructure · backend · database · observability · webhooks · type-safe · open-source tool · ship · deploy · developer experience*. Categories: APIs, developer tools, dev platforms, docs sites, infra, SaaS for engineers. Tone: precise, engineered, fast, technical, instrument-panel, calm-confident, cool.
-- *API · SDK · CLI · dev tool · developer platform · docs · documentation · infrastructure · backend · database · observability · webhooks · type-safe · open-source tool · ship · deploy · developer experience · B2B developer*
-- Product categories: *API · developer tool · dev platform · docs site · infra · SaaS-for-engineers*
-- Emotional tone: *precise · engineered · fast · technical · instrument-panel · calm-confident · cool*
-
-Briefs that are warm / consumer / editorial / image-led route elsewhere (Coral for warm SaaS, the editorial themes for content). When the brief is for developers and wants to *show the code*, it's Cobalt.
+Warm, consumer, editorial, or image-led briefs route elsewhere. When the brief is for developers and wants to show the code, it is Cobalt.
## Build hint
-The first lines of CSS establish Cobalt's anchor moves:
+```html
+<link href="https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@400;500;600;700&family=Inter:wght@400;500;600&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet" />
+```
```css
html, body { overflow-x: clip; }
@@ -126,15 +85,18 @@ body { background: var(--color-paper); color: var(--color-ink-2);
transform .6s cubic-bezier(0.16,1,0.3,1); }
.reveal.is-in { opacity: 1; transform: none; }
-/* The code hero - dark graphite card, hairline-framed */
-.code-card { background: var(--color-graphite); border: 1px solid var(--color-rule-2);
- border-radius: 10px; box-shadow: 0 1px 2px oklch(24% 0.02 258 / 0.05);
- font-family: var(--font-mono); }
-.code-card .tok-key, .status--ok { color: var(--color-accent); } /* the one signal */
-.status--ok { font: 500 0.75rem/1 var(--font-mono); letter-spacing: .06em; }
+/* Graphite: the theme's one dark material, hairline-framed, 10px */
+.graphite { background: var(--color-graphite); border: 1px solid var(--color-rule-2);
+ border-radius: 10px; box-shadow: 0 1px 2px oklch(24% 0.02 258 / 0.05);
+ font-family: var(--font-mono); }
+
+.mono { /* captions, meta, status, kbd hints - never a kicker */
+ font: 500 0.75rem/1 var(--font-mono); letter-spacing: .06em; text-transform: uppercase;
+}
+.signal { color: var(--color-accent); } /* the one blue: a token, a chip, a focus ring */
-/* Bordered nav + the one cobalt button (6px, never a pill) */
-.nav { border-bottom: 1px solid var(--color-rule); backdrop-filter: blur(8px); }
+/* Flush bordered chrome + the one cobalt button (6px, never a pill) */
+.bar { border-bottom: 1px solid var(--color-rule); backdrop-filter: blur(8px); }
.btn--primary { background: var(--color-accent); color: var(--color-accent-ink);
border-radius: 6px; }
@@ -143,4 +105,4 @@ body { background: var(--color-paper); color: var(--color-ink-2);
}
```
-Plus the Space Grotesk + Inter + JetBrains Mono link and the small reveal/type-in script. Reference build: [`site/examples/cobalt-01/`](../../../../site/examples/cobalt-01/) - match its register (tokens, voice, motion feel), never its composition; reusing its section order, hero geometry, or grid is a gate-32-grade repeat.
+Cobalt supplies the cool ground, the hairlines, the graphite, and the one blue. What gets built on it is the brief's business, not the theme's.
diff --git a/skills/hallmark/references/themes/coral.md b/skills/hallmark/references/themes/coral.md
index 673b0ae..7eb5393 100644
--- a/skills/hallmark/references/themes/coral.md
+++ b/skills/hallmark/references/themes/coral.md
@@ -1,106 +1,80 @@
# Theme - Coral
-Modern-minimal, warm SaaS register. The page for a **SaaS product, a platform, a billing or payments tool, a B2B dashboard, a startup landing** done in warmth, not cool steel. A warm-grey ground (never pure white), warm charcoal ink (never black), exactly ONE warm coral signal, General Sans for everything, and soft pills. The confident-but-human school: calm, generous, typographic. It reads like a product that is easy to trust.
+Modern-minimal in warmth rather than cool steel. A warm-grey ground (never pure white), warm charcoal ink (never black), exactly ONE warm coral signal, General Sans for everything, soft pills. The confident-but-human school: calm, generous, typographic. It reads like a product that is easy to trust.
-Loaded eagerly by SKILL.md Step 3 when the catalog pick is `coral`. Tokens: `site/css/tokens.css` `[data-theme="coral"]`. Coral is the canonical modern-minimal theme; the rotation walks Coral (warm) to Cobalt (cool).
+The material, in one line: **warm grey, one coral signal, one sans family, and soft pills.**
## Axes (diversification)
-- **Paper band** - warm light (`oklch(96.5% 0.005 50)`, hue 50, very low chroma). A warm near-white grey, not Cobalt's cool-white and not Garden's oat-cream.
+- **Paper band** - warm light (`oklch(96.5% 0.005 50)`, hue 50, very low chroma). A warm near-white grey, not Cobalt's cool white and not Garden's oat cream.
- **Display style** - grotesk-sans (General Sans 600, `-0.025em` tracking). Single-family, distinct from Cobalt's Space Grotesk and from every serif.
-- **Accent hue** - warm coral (`oklch(64% 0.165 28)`). One warm signal, sits clear of Cobalt's electric blue and Garden's leaf green. Used as a signal, never a flood.
+- **Accent hue** - warm coral (`oklch(64% 0.165 28)`). One warm signal, clear of Cobalt's electric blue and Garden's leaf green. A signal, never a flood.
## Reference register
-Stripe · Linear · Vercel · ElevenLabs · Framer · Raycast · Resend · Mercury. The aesthetic: the confident warm SaaS landing, a two-column typographic hero, generous whitespace, soft pill CTAs, one restrained accent, thin visible borders. Never name any of these in the output.
+Stripe · Linear · Vercel · ElevenLabs · Framer · Raycast · Resend · Mercury.
-**Patron-saint reference (internal):** *Stripe's warm restraint*, the monochrome-with-conviction landing warmed one notch off cool grey and given a single coral signal. When in doubt, ask "does this feel like a calm, trustworthy product, or a loud template?" Keep the former.
+The material to match: the confident warm landing - generous whitespace, soft pill controls, one restrained accent, thin visible borders, monochrome-with-conviction warmed one notch off cool grey. Ask "does this feel like a calm, trustworthy product, or a loud template?" Keep the former. Never name any of these in the output.
-## Required dependencies
+**Voice range:** declarative, warm, specific. Name the number, the product, the outcome; never "click here", never hype.
-1. **Fonts** - **General Sans** (display 600/500, body 400/500, Fontshare) and **Geist Mono** (small UPPERCASE labels, meta, code). One sans family top to bottom; no serif, no second sans:
- ```html
- <link href="https://api.fontshare.com/v2/css?f[]=general-sans@500,600,700&display=swap" rel="stylesheet" />
- <link href="https://fonts.googleapis.com/css2?family=Geist+Mono:wght@400;500;600&display=swap" rel="stylesheet" />
- ```
-2. **A small reveal script** (optional, restrained) - one `IntersectionObserver` adding `.is-in` (fade + ~8px rise, ease-out ~500ms). Coral is composed; keep reveals subtle or off. No type-in, no autoplay.
+## Palette
-## Signature moves
+- `--color-paper: oklch(96.5% 0.005 50)` - warm near-white grey, never `#fff`
+- `--color-paper-2: 94%` / `--color-paper-3: 91%` - layered warm greys
+- `--color-ink: oklch(20% 0.010 35)` - warm near-black
+- `--color-ink-2: oklch(26% 0.012 40)` - body, a notch lighter
+- `--color-accent: oklch(64% 0.165 28)` - the one coral signal
+- `--color-rule: oklch(86% …)` - thin visible borders
-1. **Warm-grey paper, never `#fff`** - `oklch(96.5% 0.005 50)`, hue 50. Layer warm greys: paper-2 `94%`, paper-3 `91%`. Ink is warm near-black `oklch(20% 0.010 35)`, body sits a notch lighter at `oklch(26% 0.012 40)`. The warmth is the whole differentiator from cool siblings, so commit to it and never drift to pure white.
+The warmth is the whole differentiator from the cool siblings, so commit to it and never drift to pure white. Coral stays under 5% of any viewport: spend it on a link's hover underline, focus rings, one figure, OR a single coral-filled control. Pick one, do not flood. Never a coral background wash.
-2. **One warm coral signal, used sparingly** (< 5% of any viewport) - `oklch(64% 0.165 28)`. Spend it on the eyebrow tick, a link's hover underline, focus rings, one stat figure, OR a single coral-filled pill. Pick one, do not flood. Everything else is warm-ink-on-warm-grey. Never a coral background wash, never gradient text.
+## Typography
-3. **General Sans single-family discipline** - display and body all General Sans; meta and code Geist Mono. Display 600 at `-0.025em`. No serif anywhere, no second sans. Coral is warmed by paper and accent, never by a font swap.
+- **Display** - General Sans 600 at `--tracking-display: -0.025em`, up to `4.5rem`.
+- **Body** - General Sans 400/500. Single-family discipline: display and body are the same face. Coral is warmed by paper and accent, never by a font swap.
+- **Label** - Geist Mono, UPPERCASE, `--tracking-label`. Small meta, captions, table headers, units, code, folios. No serif anywhere, no second sans.
-4. **Soft pills** - `999px` (`--radius-pill`) on CTAs and chips; cards at `8px` (`--radius-card`), inputs at `6px`. The rounded, friendly control vocabulary, the opposite of Cobalt's ruler-drawn 6px tightness. This is a load-bearing sibling separator.
+## Material
-5. **Quiet two-column hero** - title plus one confident line LEFT, supporting lede RIGHT (or beneath), primary and secondary pill under it. No code card, no mandatory product screenshot. The page opens calm and typographic, asymmetric to a regular grid, left-aligned. Fit the whole hero in the first viewport.
-
-6. **Ink-filled primary pill + outlined secondary** - the canonical modern-minimal pair, warmed: primary is `--color-ink` filled with `--color-paper` text (or coral-filled with `--color-accent-ink` text, if that is where you spend the one signal from move 2); secondary is a 1px `--color-rule` outlined pill. Always name the destination, never "click here."
-
-7. **Thin visible borders + generous air** - 1px `--color-rule` (`oklch 86%`) on surfaces and section divisions, with a barely-there `--shadow-card` (`0 1px 2px`). Not the 0.5px editorial hairline, not boxed-in. Whitespace does the luxury work: `--section-gap` 6rem, display up to `4.5rem`. The page breathes.
+- **Soft pills.** `999px` (`--radius-pill`) on controls and chips; surfaces at `8px` (`--radius-card`), inputs at `6px`. The rounded, friendly control vocabulary, the opposite of Cobalt's ruler-drawn 6px tightness. This is a load-bearing sibling separator.
+- **Control pair** - an ink-filled primary (`--color-ink` fill, `--color-paper` text) beside a 1px `--color-rule` outlined secondary. If the one coral signal is being spent on a fill, the primary takes `--color-accent` with `--color-accent-ink` instead.
+- **Thin visible borders, generous air.** 1px `--color-rule` on surfaces and divisions, with a barely-there `--shadow-card` (`0 1px 2px`). Not the 0.5px editorial hairline, not boxed-in. Whitespace does the luxury work: `--section-gap: 6rem`.
## Motion
-Composed and sparse. Optional section reveals fade and rise ~8px, once. Hover: coral underline-grow on nav and links; a 1px border-colour lift to `--color-rule-2` on cards and focusable surfaces. No bounce, no parallax, no autoplay, no type-in. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static and fully visible.
-
-## Anti-patterns
-
-- **No cool paper** - cool grey or blue is Cobalt's. Coral is warm (hue 35-50).
-- **No pure `#fff` / `#000`** - the genre allows white, but Coral commits to warm grey paper and warm charcoal ink. That commitment is its identity.
-- **No code / API / terminal hero** - that is Cobalt's move. Coral leads typographically.
-- **No second typeface** - General Sans only (Geist Mono for meta/code). No serif, no Space Grotesk, no mono-as-display.
-- **No tight ruler radii** - Coral is soft pills (999px), not 6px bordered controls.
-- **No coral flood, gradient, or coral background wash** - the accent is a < 5% signal.
-- **No glassmorphism, no aurora / mesh blob, no background texture** - warm paper, thin borders, and whitespace carry the page.
-- **No centred-everything hero** - left-biased two-column.
-
-## Macrostructure affinity / rejection
-
-**Coral loves:**
-- **Stat-Led** - a warm metrics page (teams onboarded, uptime, volume processed)
-- **Feature-stack / SaaS** - deck ingredients: calm feature rows, real pricing, one warm CTA - dealt per macrostructures.md § deck
-- **Bento Grid** - warm, restrained product-surface tiles
-- **Marquee Hero** - when the hero is one confident typographic statement
-- **Conversational FAQ** - a calm, human support voice
+Composed and sparse. Optional reveals fade and rise ~8px, once; keep them subtle or off. Hover: a coral underline-grow on links, a 1px border-colour lift to `--color-rule-2` on focusable surfaces. No bounce, no parallax, no autoplay, no type-in. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static and fully visible.
-**Coral refuses:**
-- **Photographic / image-led** - Coral leads with type and whitespace, not imagery
-- **Manifesto** - too loud; Coral is a calm product, not a proclamation
-- **Long Document** - prose-led; route warm-editorial (Garden) instead
-- **Specimen / type-specimen** - that is the specimen theme's territory
+## Do-nots (this theme's own failure modes)
-## Voice fixtures
+- **Never cool paper.** Cool grey or blue is Cobalt's. Coral is warm, hue 35-50.
+- **Never a second typeface.** General Sans only, with Geist Mono for meta and code. No serif, no mono-as-display.
+- **Never tight ruler radii.** Coral is soft pills at 999px, not 6px bordered controls.
+- **Never a coral flood, gradient, or background wash.** The accent is a sub-5% signal.
+- **Never background texture, mesh, or blur.** Warm paper, thin borders, and whitespace carry the page.
+- **Never a code, API, or terminal focal treatment.** That is Cobalt's move; Coral leads typographically.
-Declarative, warm, specific. Name the X. No hype.
-- *"Billing that just works, so you can build."*
-- *"One dashboard. Every metric that matters."*
-- *"From first commit to first customer."*
-- *"Built for teams who ship."*
-- *"Payments infrastructure, minus the friction."*
+## How Coral differs from its neighbours
-Never: *seamless, robust, cutting-edge, leverage, synergy, revolutionary, unlock, supercharge*. Never "click here." Name the number, the product, the outcome.
-
-## How Coral differs from neighbouring themes
-
-| vs | what settles it instantly |
+| vs | difference |
|---|---|
-| **Cobalt** (modern-minimal sibling) | Coral is warm-grey paper + coral accent + General Sans + soft 999px pills + a quiet typographic hero. Cobalt is cool-white + electric blue + Space Grotesk / JetBrains Mono + tight 6px bordered controls + a live code hero. Same genre, opposite temperature; the rotation walks between them. |
-| **Garden** (warm paper neighbour) | Both are warm and light, but Garden is oat-cream botanical *editorial* with green ink and a hand-built specimen artefact. Coral is warm-*grey* modern-minimal SaaS, all General Sans, coral signal. Register (product vs field-journal) settles it. |
-| **Lumen** (warm-family accent) | Lumen is a premium AI *apparatus* page with a classical serif headline and a built light-instrument. Coral is light, all-sans SaaS with soft pills and no artefact. Serif + apparatus vs sans + pills settles it. |
+| **Cobalt** | Cool white, electric blue, Space Grotesk plus JetBrains Mono, tight 6px bordered controls, a live code register. Coral is warm grey, coral, General Sans, soft 999px pills. Same genre, opposite temperature; the rotation walks between them. |
+| **Garden** | Also warm and light, but oat-cream botanical *editorial* with green ink and hand-built craft. Coral is warm-*grey* modern-minimal, all General Sans, coral signal. Register settles it. |
+| **Lumen** | A premium apparatus register with a classical serif headline and a built light instrument. Coral is light, all-sans, soft pills, no artefact. Serif-plus-apparatus vs sans-plus-pills. |
-## Test brief expectations
+## When the brief routes here
-Coral is a candidate when the brief mentions:
-- *SaaS · platform · billing · payments · dashboard · B2B · startup · product landing · pricing · analytics · fintech · workflow · team tool · onboarding · trust · warm · human*
-- Product categories: *SaaS · fintech · B2B platform · startup landing · dashboard · billing/payments*
-- Emotional tone: *warm · calm · confident · trustworthy · human · premium-restrained*
+*SaaS · platform · billing · payments · dashboard · B2B · startup · product landing · pricing · analytics · fintech · workflow · team tool · onboarding · trust · warm · human*. Categories: SaaS, fintech, B2B platforms, startup landings, dashboards, billing and payments. Tone: warm, calm, confident, trustworthy, human, premium-restrained.
Warmth plus product-not-code routes here. If the brief wants to *show the code* or reads cool and technical, route Cobalt; if it is editorial or image-led, route elsewhere.
## Build hint
+```html
+<link href="https://api.fontshare.com/v2/css?f[]=general-sans@500,600,700&display=swap" rel="stylesheet" />
+<link href="https://fonts.googleapis.com/css2?family=Geist+Mono:wght@400;500;600&display=swap" rel="stylesheet" />
+```
+
```css
html, body { overflow-x: clip; }
body { background: var(--color-paper); color: var(--color-ink-2);
@@ -110,25 +84,24 @@ body { background: var(--color-paper); color: var(--color-ink-2);
.display { font-family: var(--font-display); font-weight: var(--display-weight);
letter-spacing: var(--tracking-display); font-size: var(--text-display); }
-/* Reveal - restrained, optional */
-.reveal { opacity: 0; transform: translateY(8px);
- transition: opacity .5s cubic-bezier(0.16,1,0.3,1),
- transform .5s cubic-bezier(0.16,1,0.3,1); }
-.reveal.is-in { opacity: 1; transform: none; }
-
/* Soft pills - the control vocabulary */
.btn { border-radius: var(--radius-pill); }
.btn--primary { background: var(--color-ink); color: var(--color-paper); }
.btn--secondary { border: 1px solid var(--color-rule); color: var(--color-ink); }
-/* One coral signal + mono labels */
-.eyebrow, .link:hover { color: var(--color-accent); }
+/* One coral signal + mono label voice (meta, captions, units) */
+.link:hover { color: var(--color-accent); }
.label { font-family: var(--font-mono); text-transform: uppercase;
letter-spacing: var(--tracking-label); }
+/* Reveal - restrained, optional */
+.reveal { opacity: 0; transform: translateY(8px);
+ transition: opacity .5s cubic-bezier(0.16,1,0.3,1),
+ transform .5s cubic-bezier(0.16,1,0.3,1); }
+.reveal.is-in { opacity: 1; transform: none; }
@media (prefers-reduced-motion: reduce) {
.reveal { opacity: 1; transform: none; transition: none; }
}
```
-Plus the General Sans + Geist Mono links and the small reveal script.
+Plus an optional `IntersectionObserver` adding `.is-in`. Coral supplies the warm ground, the one signal, and the soft control vocabulary; the composition is the brief's business.
diff --git a/skills/hallmark/references/themes/editorial.md b/skills/hallmark/references/themes/editorial.md
index b4cdd4a..dd95796 100644
--- a/skills/hallmark/references/themes/editorial.md
+++ b/skills/hallmark/references/themes/editorial.md
@@ -1,102 +1,82 @@
# Theme - Editorial
-The contemporary magazine, set for the screen. The page for a **culture or fashion magazine, a design annual, an interview series, a longform feature, a considered content-marketing piece** - the modern editorial-spread school, executed on **warm cream with a heavy condensed-sans headline answered by a Playfair Display italic aside**. Inter Tight 800 crashes tight against the left margin (tracking `-0.04em`); a serif-italic pull-quote answers it; hairline rules and Roman-numeral folios carry the structure. It reads like a well-art-directed feature: stylish, type-forward, warm but crisp.
+The contemporary magazine, set for the screen: **warm cream with a heavy condensed-sans headline answered by a Playfair Display italic aside**. Inter Tight 800 crashes tight against the left margin (tracking `-0.04em`), a serif-italic pulled line answers it, hairline rules and Roman-numeral folios carry the structure. It reads like a well-art-directed feature: stylish, type-forward, warm but crisp.
-Loaded eagerly by SKILL.md Step 3 whenever the catalog pick is `editorial`. The OKLCH palette + font stack live in [`site/css/tokens.css`](../../../../site/css/tokens.css) under `[data-theme="editorial"]`. No canonical example folder yet - build to this spec.
+The material, in one line: **cream paper, a tight grotesque, a Didone italic answer, one coral mark.**
## Axes (diversification)
- **Paper band** - warm cream, light (`--color-paper: oklch(94% 0.020 75)`). A hair darker and a hair cooler than Specimen's oat (96%, hue 80); never `#fff`, never a neutral grey.
-- **Display style** - **display-condensed sans** (Inter Tight, `--display-weight: 800`). A heavy, tight grotesque set at `--tracking-display: -0.04em` - magazine-shaped. Never a serif display; the serif appears only as italic emphasis.
+- **Display style** - **display-condensed sans** (Inter Tight, `--display-weight: 800`). A heavy, tight grotesque at `--tracking-display: -0.04em`, magazine-shaped. Never a serif display; the serif appears only as italic emphasis.
- **Accent hue** - **warm coral** (`--color-accent: oklch(60% 0.160 35)`). Pinker and softer than Specimen's signal orange, far brighter than Newsprint's dried brick. A signal on marks and fills, never a flood.
## Reference register
The Gentlewoman · Racquet · MOLD · AIGA Eye on Design · Dazed · i-D · Wallpaper* · The Face · Are.na blog · Family Style.
-The aesthetic: the contemporary art-directed feature spread - a tight grotesque headline against a Didone italic pull-quote, cream margins, hairline furniture, one warm mark. **Never name any of these in the output.**
+The material to match: the contemporary art-directed feature spread - a tight grotesque against a Didone italic, cream margins, hairline furniture, mono folios, one coral tick. Ask "does this read like an art-directed feature, or a marketing template?" Keep the former. **Never name any of these in the output.**
-**Patron-saint reference (internal):** *a culture magazine's feature opener* - Inter Tight slammed left, a Playfair italic aside in the margin, mono folios, one coral tick. When in doubt ask "does this read like an art-directed feature, or a marketing template?" Keep the former.
+**Voice range:** considered, contemporary, lightly literary. Verbs over adjectives; name the piece, the issue, the byline.
-## Required dependencies
+## Palette
-1. **Fonts** - **Inter Tight** (display, 700/800), **Inter** (body, 400/500/600), **Playfair Display** (italic emphasis + pull-quotes, 400/500/600 italic), **Geist Mono** (folios, labels, meta). Google Fonts:
- ```html
- <link rel="preconnect" href="https://fonts.googleapis.com">
- <link href="https://fonts.googleapis.com/css2?family=Inter+Tight:wght@600;700;800&family=Inter:wght@400;500;600&family=Playfair+Display:ital,wght@0,500;1,400;1,500;1,600&family=Geist+Mono:wght@400;500&display=swap" rel="stylesheet">
- ```
-2. **A small reveal script** - one `IntersectionObserver` adding `.is-in` (fade + ~10px rise, `--ease-out`, ~600ms). Optional one-shot: a single pull-quote that settles once, then static. No other required JS - Editorial is a reading page, not a tool.
+- `--color-paper: oklch(94% 0.020 75)` - warm cream
+- `--color-ink: oklch(15% 0.014 280)` - deepest ink with a faint **cool** tilt (hue 280), printed-black on warm cream. Deliberate print detail, not a mistake.
+- `--color-ink-2: oklch(28% 0.014 55)` - body, warm
+- `--color-muted: oklch(48% 0.014 60)` - meta
+- `--color-accent: oklch(60% 0.160 35)` - coral, the one signal
+- `--color-accent-ink: oklch(98% 0.005 70)` - near-white text on a coral fill
+- `--color-focus: oklch(62% 0.160 35)` - rings
+- `--color-rule: oklch(80% 0.018 70)` at `--rule-card: 0.5px`; `--color-rule-2: oklch(64% 0.014 68)` for heavier splits
-## Signature moves
+Coral stays under 5% of any viewport: a link underline, one filled tag, a folio mark, one control, the focus ring. It never floods a band and never fills behind body type.
-1. **Two-axis type: heavy condensed sans display + Playfair italic aside.** THE move. Headlines are Inter Tight `--display-weight: 800` at `--text-display: clamp(2.5rem, 5vw + 0.75rem, 4.75rem)`, `--tracking-display: -0.04em`, slammed left. Inside a head, or as a pull-quote, single words or a clause switch to **Playfair Display italic** (`--font-serif`). The grotesque-against-Didone-italic tension is the whole voice. Body stays plain Inter.
+## Typography
-2. **Warm cream paper, cool-tilted ink, never `#fff` / `#000`.** Paper `oklch(94% 0.020 75)`; the deepest ink `--color-ink: oklch(15% 0.014 280)` carries a faint **cool** tilt (hue 280) - printed-black on warm cream. Body sits up at `--color-ink-2: oklch(28% 0.014 55)`, meta at `--color-muted: oklch(48% 0.014 60)` (warm). The cool ink over warm paper is a deliberate print detail, not a mistake.
+- **Display** - Inter Tight `--display-weight: 800` at `--text-display: clamp(2.5rem, 5vw + 0.75rem, 4.75rem)`, `--tracking-display: -0.04em`, title-case, slammed left.
+- **Serif** - Playfair Display **italic** (`--font-serif`), the answering voice. A single word or clause inside a head, or a pulled line set large between a top-and-bottom hairline with a coral indent, never in a box. The grotesque-against-Didone-italic tension is the whole voice, and the serif is italic emphasis only, never the display face.
+- **Body** - plain Inter 400/500/600, `--section-head-gap: 1.5rem`.
+- **Label** - Geist Mono, UPPERCASE, `--tracking-label: 0.10em`, `--color-muted`. Roman numerals and mono folios are the second register, marching down the margin like a contents system, and carrying captions, meta rows, table headers, and units.
-3. **One coral signal, < 5% of any viewport.** `--color-accent: oklch(60% 0.160 35)` on the eyebrow tick, a link underline, one CTA, a folio mark, `--color-focus: oklch(62% 0.160 35)` rings. On a coral **fill** (a tag, a kicker block) text is `--color-accent-ink: oklch(98% 0.005 70)` (near-white). Coral never floods a full band and never fills behind body type.
+## Material
-4. **Square everything - radius 0.** `--radius-card: 0`, `--radius-pill: 0`, `--radius-input: 0`. Buttons, tags, inputs, kicker blocks are sharp rectangles. Magazine furniture is set in square blocks, never pills or soft radii.
-
-5. **0.5px hairlines + asymmetric grid, no cards.** `--rule-card: 0.5px` (`--color-rule: oklch(80% 0.018 70)`); heavier splits use `--color-rule-2: oklch(64% 0.014 68)`. Columns run asymmetric (2:5, 3:7), the hero is left-biased, `--section-gap: 6rem`, `--section-head-gap: 1.5rem`. Structure is rules and columns - **no boxed cards, no shadow, no blur**.
-
-6. **Roman-numeral marginalia + mono folios.** Sections carry Roman numerals (I, II, III) and Geist Mono labels (`--font-mono`, UPPERCASE, `--tracking-label: 0.10em`, `--color-muted`) marching down the margin like a contents/folio system. The mono machine-voice against the tight display is the second register.
-
-7. **Serif-italic pull-quotes hung between hairlines.** Playfair Display italic set large is the pull-quote and emphasis register - it hangs between a top-and-bottom hairline with a coral indent, never in a box. The serif is italic emphasis only, never the display face (global rule).
+- **Square everything.** `--radius-card: 0`, `--radius-pill: 0`, `--radius-input: 0`. Controls, tags, inputs, filled marks are sharp rectangles. Magazine furniture is set in square blocks, never pills or soft radii.
+- **0.5px hairlines, no cards.** Structure is rules and columns: asymmetric splits (2:5, 3:7), `--section-gap: 6rem`, left-biased composition. **No boxed cards, no shadow, no blur.**
+- **Flat paper.** Cream plus hairlines plus one coral mark carry the page; no texture, no mesh, no gradient.
## Motion
-Quiet and composed. One orchestrated entrance: section reveals fade + rise (`--ease-out`, ~600ms). Optionally a single pull-quote that settles once, then holds. Hover: coral underline-grow on links; a hairline shift toward coral on focusable surfaces. No bounce, no parallax, no autoplay. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static and fully visible.
-
-## Anti-patterns
-
-- **No serif display face.** Inter Tight (sans) carries every headline; Playfair appears only as italic emphasis. A serif headline reads as Newsprint / Specimen / Atelier.
-- **No rounded corners, pills, or shadows.** Radius is 0 everywhere; soft pills are modern-minimal (Coral) vocabulary.
-- **No pure `#fff` paper / `#000` ink.** Warm cream, cool-tilted near-black.
-- **No orange or brick drift.** Keep the accent coral (hue 35, chroma 0.16) - not Specimen's redder orange, not Newsprint's dark brick, not terracotta.
-- **No centred masthead.** That is Newsprint's broadsheet move; Editorial is left-biased and asymmetric.
-- **No dark ground.** Editorial is light cream; a dark statement page is Manifesto.
-- **No ALL-CAPS Anton shout.** Inter Tight runs title-case and tight, magazine-modern, not a broadside.
-- **No glassmorphism, gradient text, mesh/aurora blob, or background texture.** Cream + 0.5px hairlines + one coral mark carry it.
-
-## Macrostructure affinity / rejection
+Quiet and composed. One orchestrated entrance: reveals fade and rise (`--ease-out`, ~600ms). Optionally a single pulled line that settles once, then holds. Hover: a coral underline-grow on links, a hairline shift toward coral on focusable surfaces. No bounce, no parallax, no autoplay. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static and fully visible.
-**Editorial loves:** **Long Document** *(the feature essay - drop cap, columns, pull-quotes)* · **Photographic** (a modern feature opener: photo + tight-sans headline crashing over it) · **Quote-Led** (Playfair italic pull-quotes are native furniture) · **index-first** (a magazine contents / issue index) · **Letter** (an editor's note).
+## Do-nots (this theme's own failure modes)
-**Editorial refuses:** **Workbench / component-playground** (tool-first apparatus, route Cobalt) · **Bento Grid** (modular product tiles, too SaaS for a spread) · **Stat-Led** (numbers-first dashboard) · **Conversational FAQ** (too chatty; the feature is composed, not a chat).
+- **Never a serif display face.** Inter Tight carries every headline; Playfair appears only as italic emphasis. A serif headline reads as Newsprint, Specimen, or Atelier.
+- **Never rounded corners, pills, or shadows.** Radius is 0 everywhere; soft pills are Coral's vocabulary.
+- **Never an orange or brick drift.** Keep the accent coral (hue 35, chroma 0.16): not Specimen's redder orange, not Newsprint's dark brick, not terracotta.
+- **Never a centred masthead.** That is Newsprint's broadsheet move; Editorial is left-biased and asymmetric.
+- **Never a dark ground.** Editorial is light cream; a dark statement page is Manifesto.
+- **Never an ALL-CAPS shout.** Inter Tight runs title-case and tight, magazine-modern, not a broadside.
-## Voice fixtures
+## How Editorial differs from its neighbours
-Considered, contemporary, lightly literary. Verbs over adjectives; name the piece, the issue, the byline.
-
-- *"The issue, set in tight type."*
-- *"A feature, composed like a spread."*
-- *"Grotesque headline. Didone aside. One coral mark."*
-- *"Read it the way it was set: hairlines, columns, cream margins."*
-- *"Culture, filed and art-directed."*
-
-Never any of: *seamless, robust, cutting-edge, leverage, synergy, elevate, unlock, supercharge, curated, storytelling journey*. Never "click here" - name the piece or the section.
-
-## How Editorial differs from neighbouring themes
-
-| vs | what settles it instantly |
+| vs | difference |
|---|---|
-| **Specimen** (warm-paper editorial sibling) | Specimen shows a **serif display** at scale (Fraunces light 340) over sans body, signal orange. Editorial shows a **heavy condensed sans** display (Inter Tight 800) with Playfair as an italic garnish, coral. Thin-serif-head vs heavy-sans-head. |
-| **Newsprint** (warm-paper broadsheet) | Newsprint is all-serif (Playfair Didone head + Crimson body), a **centred** masthead, columns, brick. Editorial is sans head + sans body, **left-biased** asymmetric hero, coral. Broadsheet-serif vs magazine-sans. |
-| **Manifesto** (condensed-display sibling) | Both use a condensed display, but Manifesto is **dark** ground + Anton **UPPERCASE** + red. Editorial is **light** cream + Inter Tight **title-case** + coral. Light-vs-dark and caps-vs-titlecase settle it. |
-
-## Test brief expectations
+| **Specimen** | A **serif display** at scale (Fraunces light 340) over sans body, signal orange. Editorial is a **heavy condensed sans** (Inter Tight 800) with Playfair as an italic garnish, coral. Thin-serif-head vs heavy-sans-head. |
+| **Newsprint** | All-serif (Playfair Didone head, Crimson body), a **centred** masthead, columns, brick. Editorial is sans head over sans body, **left-biased** and asymmetric, coral. Broadsheet-serif vs magazine-sans. |
+| **Manifesto** | Also condensed, but **dark** ground plus Anton **UPPERCASE** in red. Editorial is **light** cream plus Inter Tight **title-case** in coral. Light-vs-dark and caps-vs-titlecase settle it. |
-Editorial is a candidate when the brief mentions:
+## When the brief routes here
-- *magazine · editorial · feature · culture · fashion · design annual · interview series · longform · publication · issue · contemporary · art direction · profile · lookbook · brand story · content · considered*
-- Product categories: *culture / fashion magazine · digital publication · design annual · interview series · editorial content site · brand editorial / content-marketing · agency journal*
-- Emotional tone: *considered · contemporary · stylish · type-forward · confident · magazine-modern · warm-but-crisp*
+*magazine · editorial · feature · culture · fashion · design annual · interview series · longform · publication · issue · contemporary · art direction · profile · lookbook · brand story · considered*. Categories: culture and fashion magazines, digital publications, design annuals, interview series, editorial content sites, brand editorial, agency journals. Tone: considered, contemporary, stylish, type-forward, magazine-modern, warm but crisp.
-Route elsewhere: broadsheet / journalism -> Newsprint; type foundry / quiet portfolio -> Specimen; loud declaration -> Manifesto; dev / API -> Cobalt.
+Route elsewhere: broadsheet or journalism to Newsprint, type foundry or quiet portfolio to Specimen, loud declaration to Manifesto, dev or API to Cobalt.
## Build hint
-The first lines of CSS establish Editorial's anchor moves:
+```html
+<link rel="preconnect" href="https://fonts.googleapis.com">
+<link href="https://fonts.googleapis.com/css2?family=Inter+Tight:wght@600;700;800&family=Inter:wght@400;500;600&family=Playfair+Display:ital,wght@0,500;1,400;1,500;1,600&family=Geist+Mono:wght@400;500&display=swap" rel="stylesheet">
+```
```css
html, body { overflow-x: clip; }
@@ -107,10 +87,10 @@ body { background: var(--color-paper); color: var(--color-ink-2);
.display { font-family: var(--font-display); font-weight: var(--display-weight); /* 800 */
font-size: var(--text-display); letter-spacing: var(--tracking-display); /* -0.04em */
color: var(--color-ink); text-align: left; text-wrap: balance; }
-.display em, .pull { font-family: var(--font-serif); font-style: italic; /* Playfair aside */
+.display em, .pull { font-family: var(--font-serif); font-style: italic; /* Playfair answer */
font-weight: 500; letter-spacing: var(--tracking-tight); }
-/* Mono folio + Roman-numeral marginalia */
+/* Mono folio + Roman-numeral marginalia, captions, meta */
.folio { font-family: var(--font-mono); text-transform: uppercase;
letter-spacing: var(--tracking-label); color: var(--color-muted); }
@@ -128,4 +108,4 @@ a { text-decoration-color: var(--color-accent); }
@media (prefers-reduced-motion: reduce) { .reveal { opacity: 1; transform: none; transition: none; } }
```
-Plus the Inter Tight + Inter + Playfair Display + Geist Mono link and the small reveal script.
+Plus one `IntersectionObserver` adding `.is-in`. Editorial supplies the cream, the two type axes, the hairline furniture, and the one mark; how the feature is laid out is the brief's business.
diff --git a/skills/hallmark/references/themes/field.md b/skills/hallmark/references/themes/field.md
index e26c818..4f72926 100644
--- a/skills/hallmark/references/themes/field.md
+++ b/skills/hallmark/references/themes/field.md
@@ -1,104 +1,87 @@
# Theme - Field
-Warm, credible, hand-drawn SaaS. The page for a **productivity / collaboration / notes / meetings / small-team** product that wants to feel friendly **and** serious - the warm-cream playful lane, executed as **calm marigold-on-cream, one signal accent, hand-drawn ink**. Cream paper, a Source Serif headline over Public Sans body, a marigold highlighter behind one phrase, and a tilted content artifact (a sticky note, not app chrome). It reads like a plain-spoken team that ships.
+Warm, credible, hand-drawn SaaS. The warm-cream playful lane executed as **calm marigold-on-cream, one signal accent, hand-drawn ink**. Cream paper, a Source Serif headline over a Public Sans body, a marigold highlighter behind one phrase, and drawn objects where a colder theme would ship app chrome. It reads like a plain-spoken team that ships.
-Loaded eagerly by SKILL.md Step 3 when the catalog pick is `field`. Tokens: [`site/css/tokens.css`](../../../../site/css/tokens.css) `[data-theme="field"]`. Reference build: [`site/examples/field-01/`](../../../../site/examples/field-01/).
+The material, in one line: **warm cream, warm ink, one marigold highlighter, everything drawn by hand.**
## Axes (diversification)
- **Paper band** - **light warm cream** (`oklch(96.5% 0.015 90)`, hue 90). Never `#fff`, never cool grey. Ink is warm near-black `oklch(25% 0.02 70)`, hue 70 - warm, not neutral.
- **Display style** - **roman serif** (Source Serif 4, 600, tracking `-0.02em`). No italic display. A serif headline over a Public Sans body - the friendly-but-serious pairing that separates it from the all-sans playful sibling.
-- **Accent hue** - **chromatic marigold** (`oklch(75% 0.13 80)`). One warm gold-orange signal, used as highlighter + ink-stroke accent, never a flood (< 5% of any viewport).
+- **Accent hue** - **chromatic marigold** (`oklch(75% 0.13 80)`). One warm gold-orange signal, used as highlighter and ink-stroke accent, never a flood (< 5% of any viewport).
## Reference register
-Notion · the Anthropic marketing school · Coda.
+Notion · the Anthropic marketing school · Coda. **Never name any of these in the output.**
-The aesthetic: the warm-but-credible productivity landing - cream canvas, a serif display, a single marigold signal, hand-drawn strokes over a real content artifact. Friendly, plain, trustworthy. **Never name any of these in the output.**
+The material to match: the warm-but-credible productivity surface - cream canvas, a serif display, a single marigold signal, hand-drawn strokes over a real content artifact. Internally: a serious tool that lets itself be *warm*. When in doubt ask "does this read like a person wrote it, or a template?" Keep the former.
-**Patron-saint move (internal):** a serious tool that lets itself be *warm* - marigold highlighter + a tilted note where a colder theme would ship a UI screenshot. When in doubt ask "does this read like a person wrote it, or a template?" Keep the former.
+## Palette
-## Required dependencies
+Canonical values live in [`site/css/tokens.css`](../../../../site/css/tokens.css) under `[data-theme="field"]`.
-1. **Fonts** - **Source Serif 4** (display, 400/600) + **Public Sans** (body + labels, 400/500/600). Google Fonts:
- ```html
- <link href="https://fonts.googleapis.com/css2?family=Public+Sans:wght@400;500;600&family=Source+Serif+4:opsz,[email protected],400;8..60,600&display=swap" rel="stylesheet" />
- ```
- `--font-mono` (Geist Mono) is defined but rarely used; only load it if a page actually shows mono.
-2. **No JS required.** The highlighter is pure CSS; the strokes and artifacts are inline SVG. If motion is added it is CSS-only and reduced-motion safe.
+- `--color-paper: oklch(96.5% 0.015 90)` - warm cream ground
+- `--color-paper-2` - the surface a drawn artifact sits on
+- a deeper cream at `oklch(93% 0.045 84)` - the one warmer band the theme allows, hairlined top and bottom
+- `--color-ink: oklch(25% 0.02 70)` - warm near-black
+- `--color-ink-2: oklch(43% 0.02 72)` - body, a notch lighter
+- `--color-accent: oklch(75% 0.13 80)` - marigold, the highlighter
+- `--color-focus` - a deeper marigold for strokes and focus rings
-## The signature moves
+Shadows are warm-tinted (hue 70), **never neutral grey**. No pure black or white anywhere.
-1. **Warm cream paper + warm ink, tinted shadows** - `oklch(96.5% 0.015 90)` ground, `oklch(25% 0.02 70)` ink, body a notch lighter (`oklch(43% 0.02 72)`). Shadows are warm-tinted (hue 70), **never neutral grey**. No pure black or white anywhere.
+## Typography
-2. **The marigold highlighter - THE core move** - one phrase in the hero title wears a marigold band behind its x-height, drawn with a `linear-gradient(180deg, transparent 38%, accent 38%, accent 92%, transparent 92%)` on a `<mark>` with `box-decoration-break: clone`. Highlighter, not a fill. Exactly one per hero.
+- **Display** - Source Serif 4 600, tracking `-0.02em`, line-height ~1.08. Roman only, no italic display. The serif carries the warmth.
+- **Body** - Public Sans 400/500/600 at `1.0625rem` / 1.6. The sans carries the plain voice.
+- **Label** - Public Sans UPPERCASE, `0.12em` tracking, for captions, meta rows, table headers, units, and entry numbers inside a real `<ol>`. It labels content; it never sits above a heading to announce it. `--font-mono` (Geist Mono) is defined but rarely used; only load it if the page actually shows mono.
-3. **Hand-drawn ink strokes** - arrows, connectors, spot illustrations, checkmarks are **stroke-based inline SVG** with round caps/joins (`.ink` at ink, `.acc` at deep marigold), never flat filled icon tiles. A loose marigold-tipped doodle arrow points at the hero artifact.
+**The marigold highlighter is THE core move.** One phrase wears a marigold band behind its x-height, drawn with a `linear-gradient` on a `<mark>` with `box-decoration-break: clone`. Highlighter, not a fill. Exactly one per page.
-4. **A tilted content artifact, not app chrome** - the hero's right side is a real object (a sticky note: title, dashed rule, Owner / Due / Decision rows with marigold ticks) on `--color-paper-2`, `rotate(-1.6deg)`, warm note-shadow. Title + lede sit LEFT, artifact RIGHT - asymmetric, never centred, never a product screenshot.
+## Material
-5. **Serif display over sans support** - Source Serif 4 headline (600, `-0.02em`); Public Sans body; eyebrows are Public Sans UPPERCASE, `0.12em` tracking. The serif carries warmth, the sans carries the plain voice.
-
-6. **Ink-filled primary, marigold as underline** - the one primary button is **ink-filled** (`--color-ink` bg, cream text) with a warm shadow lift; links and ghost CTAs use a **marigold underline** that grows on hover. Marigold is the signal, never the button flood. Nav "Sign in" is a bordered outline pill (999px).
-
-7. **Staggered beats on a dashed thread** - "how it works" is three beats connected by a **hand-drawn dashed thread**, each beat vertically staggered (top offsets 0 / 2rem / 4rem) with a serif numeral in deep marigold. **Not** a flat three-equal-tile grid.
-
-8. **Alternating document rows + a warm CTA band** - features alternate text-left / art-right then flip, each art a bordered card holding a hand-drawn SVG. The page closes on a warm CTA band (`oklch(93% 0.045 84)`, hairline top+bottom) - the one deeper-cream beat.
+- **Hand-drawn ink strokes.** Arrows, connectors, spot illustrations, checkmarks are **stroke-based inline SVG** with round caps and joins, never flat filled icon tiles. Loose, slightly imperfect, marigold-tipped where it matters.
+- **Drawn objects, not app chrome.** Where the page shows the product, it shows a real content artifact built in markup (a note, a card, a row of fields) on `--color-paper-2`, given a hair of rotation (~1.6deg) and a warm note-shadow. Never a product screenshot.
+- **Radii** at 10px on controls, up to 16px on a drawn artifact. Soft, not pill-round: 20px radii belong to the loud sibling.
+- **Rules** are hairlines at `--color-rule`; depth comes from warm-tinted shadow, not from borders stacking.
+- **Buttons**: the one primary is **ink-filled** (ink background, cream text) with a warm shadow lift. Marigold stays a highlighter and an underline, never the button flood.
## Motion
-Composed and warm. Primary button lifts `translateY(-2px)` on hover; nav/link underlines grow via `scaleX`; the ghost arrow nudges `translateX` on hover. Ease `cubic-bezier(0.2, 0.6, 0.3, 1)`. **No bounce, no parallax, no autoplay.** All motion gates behind `prefers-reduced-motion`; reduced-motion ships static.
-
-## Anti-patterns
-
-- **No cool or grey paper** - Field is warm cream (hue 90). Cool bone is Almanac's.
-- **No multi-accent flood** - one marigold signal only. Three saturated accents is Hum's lane.
-- **No pure `#fff` / `#000`, no neutral-grey shadows** - warm cream, warm ink, warm-tinted shadows.
-- **No flat filled icon tiles** - illustration is hand-drawn stroke SVG, or it is nothing.
-- **No product screenshot / app chrome hero** - the artifact is a drawn content object (a note, a card), not a UI capture.
-- **No marigold-filled buttons or gradient CTAs** - primary is ink-filled; marigold stays a highlighter/underline.
-- **No centred-everything hero** - left-biased: title/lede left, artifact right.
-- **No hype voice, no loud maximalism** - if it wants to shout, it is not Field.
-
-## Macrostructure affinity + rejection
+Composed and warm. The primary control lifts `translateY(-2px)` on hover; link underlines grow via `scaleX`; a ghost arrow nudges `translateX`. Ease `cubic-bezier(0.2, 0.6, 0.3, 1)`. **No bounce, no parallax, no autoplay.** No JS is required: the highlighter is pure CSS and the strokes are inline SVG. All motion gates behind `prefers-reduced-motion`; reduced-motion ships static.
-**Field loves.** Marquee Hero *(canonical - field-01)* · SaaS / Product (deck ingredients: how-it-works beats, feature rows, a warm CTA band - dealt, not sequenced) · Letter (the small-team, still-early warm note - Field can be intimate where the cool themes cannot) · Feature Tour (alternating document rows).
+## Voice range
-**Field refuses.** Manifesto (too loud - Field is plain, not a shout) · Terminal / code-hero (that is the cool dev themes; Field shows a content artifact, not code) · Photographic / image-led (Field draws by hand) · Long Document / archive (prose-led editorial routes to the warm-editorial themes).
+Warm, plain, concrete, honest. Name the noun (owner, date, decision), admit the product is small. Never *seamless, robust, effortless, delight, magic, powerful, revolutionary, unlock, supercharge, leverage, synergy*. Never "click here", never hype a small team into a movement.
-## Voice fixtures
+## Do-nots (this theme's own failure modes)
-Warm, plain, concrete, honest - name the noun (owner, date, decision), admit the product is small.
+- **No cool or grey paper, no pure `#fff` / `#000`, no neutral-grey shadows.** Warm cream (hue 90), warm ink, warm-tinted shadows. Cool bone is Almanac's.
+- **No multi-accent flood.** One marigold signal only. Three saturated accents is Hum's lane.
+- **No flat filled icon tiles.** Illustration is hand-drawn stroke SVG, or it is nothing.
+- **No product screenshot or app chrome.** The artifact is drawn, not captured.
+- **No marigold-filled buttons or gradient CTAs.** Primary is ink-filled; marigold stays a highlighter.
+- **No hype voice, no loud maximalism.** If it wants to shout, it is not Field.
-- *"Meetings that end with a plan."*
-- *"From talk to plan, in three moves."*
-- *"Every next step has a name on it."*
-- *"A task with no owner is a task nobody does."*
-- *"No card. One workspace. Leave whenever you like."*
-
-Never any of: *seamless, robust, effortless, delight, magic, powerful, revolutionary, unlock, supercharge, leverage, synergy*. Never "click here." Never hype the small team into a movement.
-
-## How Field differs from neighbouring themes
+## How Field differs from its neighbours
| vs | difference |
|---|---|
-| **Hum** (loud playful sibling) | Hum is cream (`97% 0.012 95`) with **three** saturated accents - pear-yellow (`86% 0.18 95`), sky-cyan (`66% 0.18 235`), coral-red (`68% 0.24 18`) - all-sans Plus Jakarta, 20px radii, deliberately loud. Field shares the warm-cream playful cluster but ships **one** marigold signal (`75% 0.13 80`), a Source Serif display, 10px radii, and a quiet credible voice. Same lane, opposite volume - the rotation walks between them. |
-| **Almanac** (archival editorial) | Almanac is a cool near-neutral bone (`94% 0.008 245`) with a deep-blue accent (`38% 0.135 250`) and a Newsreader prose serif - a document to read. Field is warm cream (hue 90), marigold, Public Sans body, hand-drawn - a product to try, not an archive. |
-| **Garden** (warm editorial) | Garden shares the warm-oat ground (`95.5% 0.022 92`, hue 92 ~ Field's 90) but its ink is **botanical green** (`24% 0.052 152`) with leaf-green (`47% 0.13 140`) + terracotta accents and a Young Serif display - organic and editorial. Field's ink is warm-neutral (hue 70), its one accent is marigold, and it is a SaaS product, not a garden essay. Shared ground temperature; ink+accent hue settles it. |
-
-## Test brief expectations
+| **Hum** (loud playful sibling) | Hum is cream (`97% 0.012 95`) with **three** saturated accents - pear-yellow (`86% 0.18 95`), sky-cyan (`66% 0.18 235`), coral-red (`68% 0.24 18`) - all-sans Plus Jakarta, 20px radii, deliberately loud. Field ships **one** marigold signal (`75% 0.13 80`), a Source Serif display, 10px radii, and a quiet credible voice. Same lane, opposite volume. |
+| **Almanac** (archival editorial) | Almanac is a cool bone with a deep-blue accent (`38% 0.135 250`) and a Newsreader prose serif - a document to read. Field is warm cream (hue 90), marigold, Public Sans body, hand-drawn - a product to try. |
+| **Garden** (warm editorial) | Garden shares the warm ground (`95.5% 0.022 92`, hue 92 ~ Field's 90) but its ink is **botanical green** (`24% 0.052 152`) with leaf-green (`47% 0.13 140`) and terracotta, on a Young Serif display. Field's ink is warm-neutral (hue 70) and its one accent is marigold. Shared ground temperature; ink and accent hue settle it. |
-Field is a candidate when the brief mentions:
+## When the brief routes here
-- *productivity · collaboration · team · workflow · meetings · notes · tasks · planning · workspace · small team · friendly · approachable · human · warm-but-credible · get-things-done · consumer-prosumer SaaS*
-- Product categories: *productivity SaaS · team/collaboration tool · note-taking · task/project tool · prosumer app*
-- Emotional tone: *warm · friendly · credible · plain-spoken · human · approachable-serious · calm-optimistic*
+*productivity · collaboration · team · workflow · meetings · notes · tasks · planning · workspace · small team · friendly · approachable · human · warm-but-credible · consumer-prosumer SaaS*. Categories: productivity SaaS, team and collaboration tools, note-taking, task and project tools, prosumer apps. Tone: warm, friendly, credible, plain-spoken, human, calm-optimistic.
-Loud / maximal playful routes to Hum; content-led / archival / editorial routes to Almanac or Garden; cool / technical dev-tool routes to Cobalt; dark / dramatic routes to the atmospheric themes. When the brief is a warm product that wants to feel trustworthy without going cold, it is Field.
+Loud playful routes to Hum; archival editorial routes to Almanac or Garden; cool technical dev-tool routes to Cobalt; dark and dramatic routes to the atmospheric themes. When the brief is a warm product that wants to feel trustworthy without going cold, it is Field.
## Build hint
-The first lines of CSS establish Field's anchor moves:
+```html
+<link href="https://fonts.googleapis.com/css2?family=Public+Sans:wght@400;500;600&family=Source+Serif+4:opsz,[email protected],400;8..60,600&display=swap" rel="stylesheet" />
+```
```css
html, body { overflow-x: clip; }
@@ -116,19 +99,20 @@ h1, h2, h3 { font-family: var(--font-display); font-weight: 600;
.ink { fill: none; stroke: var(--color-ink); stroke-width: 2.4; stroke-linecap: round; stroke-linejoin: round; }
.acc { fill: none; stroke: var(--color-focus); stroke-width: 2.6; stroke-linecap: round; stroke-linejoin: round; }
-/* nav hairline + warm paper glass; primary is INK-filled, marigold stays an underline */
-.nav { border-bottom: 1px solid var(--color-rule); backdrop-filter: blur(8px); }
+/* primary is INK-filled; marigold stays a highlighter and an underline */
.btn--primary { background: var(--color-ink); color: var(--color-paper);
border-radius: var(--radius-card); box-shadow: var(--shadow-card); }
.btn--primary:hover { transform: translateY(-2px); }
-/* the content artifact sits tilted - an object, not app chrome */
-.note { background: var(--color-paper-2); border: 1px solid var(--color-rule-2);
- border-radius: 16px; box-shadow: var(--shadow-card); transform: rotate(-1.6deg); }
+/* a drawn content artifact sits tilted - an object, not app chrome */
+.artifact { background: var(--color-paper-2); border: 1px solid var(--color-rule-2);
+ border-radius: 16px; box-shadow: var(--shadow-card); transform: rotate(-1.6deg); }
@media (prefers-reduced-motion: reduce) {
* { transition: none !important; } .btn--primary:hover { transform: none; }
}
```
-Plus the Public Sans + Source Serif 4 link. Reference build: [`site/examples/field-01/`](../../../../site/examples/field-01/) - match its register (tokens, voice, motion feel), never its composition; reusing its section order, hero geometry, or grid is a gate-32-grade repeat.
+Reference build: [`site/examples/field-01/`](../../../../site/examples/field-01/) - match its register (tokens, voice, motion feel), never its composition; reusing its section order, hero geometry, or grid is a gate-32-grade repeat.
+
+The rest of the page is yours. Field supplies the cream, the marigold, and the drawn line; what gets drawn on that paper is the brief's business, not the theme's.
diff --git a/skills/hallmark/references/themes/garden.md b/skills/hallmark/references/themes/garden.md
index bb1b6ad..74d4958 100644
--- a/skills/hallmark/references/themes/garden.md
+++ b/skills/hallmark/references/themes/garden.md
@@ -1,96 +1,82 @@
# Theme - Garden
-Warm-botanical editorial. The page for a **small farm, apiary, cidery, seed company, herbalist, nursery, or single-maker food brand** - the naturalist field-journal / herbarium-sheet school. A **warm oat-cream ground** (`oklch(95.5% 0.022 92)`, never grey-sage), **botanical green ink** (`oklch(24% 0.052 152)` - a warm near-black green, never `#000`), one **living leaf-green** accent, and a **hand-built botanical specimen** as the focal artefact. It reads like a well-kept field notebook: honest, seasonal, grown-not-manufactured.
+Warm-botanical editorial: the naturalist field-journal and herbarium-sheet school. A **warm oat-cream ground** (never grey-sage), **botanical green ink** (a warm near-black green, never `#000`), one **living leaf-green** accent, a clay pop, and imagery that is **hand-built botanical craft** rather than photography. It reads like a well-kept field notebook: honest, seasonal, grown-not-manufactured.
-Loaded eagerly by SKILL.md Step 3 when the catalog pick is `garden`. Tokens: [`site/css/tokens.css`](../../../../site/css/tokens.css) `[data-theme="garden"]`. Reference build: [`site/examples/garden-01/`](../../../../site/examples/garden-01/) (Hollowback Apiary - single-ridge Vermont honey, catalogue of seasonal lots).
+The material, in one line: **oat paper, green ink, a chunky roman serif, and something grown drawn by hand.**
## Axes (diversification)
-- **Paper band** - light warm (`L 95.5%`, hue 92, low chroma). Oat cream, faintly honeyed. Distinct from the genre's cool/bone grounds and from any grey-sage; tint everything toward oat, never toward slate.
-- **Display style** - **roman serif** (Young Serif, one organic weight `400`, `--display-style: normal`). Chunky, slab-ish, hand-cut. Never italic in headers (global rule); Young Serif ships one weight, so vary by size, not weight.
-- **Accent hue** - **chromatic leaf-green** (`oklch(47% 0.13 140)`, primary) with an **earthy clay / terracotta** pop (`oklch(54% 0.14 46)`, secondary). Living, chlorophyll-real - sits clear of any cool teal or corporate emerald.
+- **Paper band** - light warm (`L 95.5%`, hue 92, low chroma). Oat cream, faintly honeyed. Distinct from the genre's cool and bone grounds and from any grey-sage; tint everything toward oat, never toward slate.
+- **Display style** - **roman serif** (Young Serif, one organic weight `400`, `--display-style: normal`). Chunky, slab-ish, hand-cut. Never italic in headers; Young Serif ships one weight, so vary by size, not weight.
+- **Accent hue** - **chromatic leaf-green** (`oklch(47% 0.13 140)`, primary) with an **earthy clay / terracotta** pop (`oklch(54% 0.14 46)`, secondary). Living, chlorophyll-real, clear of any cool teal or corporate emerald.
## Reference register
-Aesop . Kinfolk . Cereal . Frama . Le Labo . Mast . Toast Ale . Ballymaloe . small-CSA and single-apiary brand sites.
+Aesop · Kinfolk · Cereal · Frama · Le Labo · Mast · Toast Ale · Ballymaloe · small-CSA and single-apiary brand sites.
-The aesthetic: the naturalist's brand story - warm paper, roman serif, a hand-drawn or hand-built botanical specimen, seasonal honesty, prose that smells of the field. **Patron-saint reference (internal):** *a pressed-herbarium sheet* - one specimen, a hand-lettered mono tag, a warm neutral mount. When in doubt ask "does this read like a field journal, or a supermarket label?" Keep the former. Never name any of these in the output.
+The material to match: the naturalist's brand story - warm paper, roman serif, hand-drawn or hand-built botanical craft, seasonal honesty, prose that smells of the field. A pressed-herbarium sheet: one specimen, a hand-lettered mono tag, a warm neutral mount. Ask "does this read like a field journal, or a supermarket label?" Keep the former. Never name any of these in the output.
-## Required dependencies
+**Voice range:** warm, honest, seasonal, unhurried. Say the ridge, the flower, the pour date, the number of jars; never *artisanal*, *curated*, *small-batch* as a hollow badge.
-1. **Fonts** - **Young Serif** (display, one weight), **Hanken Grotesk** (body, 400/500/600/700), **Newsreader** (readable text-serif for long prose - Young Serif is display-only), **Geist Mono** (specimen tags + meta labels). Google Fonts:
- ```html
- <link href="https://fonts.googleapis.com/css2?family=Young+Serif&family=Hanken+Grotesk:wght@400;500;600;700&family=Newsreader:opsz,[email protected],400;6..72,500&family=Geist+Mono:wght@400;500&display=swap" rel="stylesheet">
- ```
-2. **A small reveal script** - one `IntersectionObserver` adding an in-view class (fade + short rise, staggered by `--i`, <=500ms, reveal-once/unobserve). Reduced-motion ships static + fully visible.
-3. **Any form-as-CTA** (a standing-order / harvest-note signup) gets honest idle -> loading -> success/error states narrated in `aria-live`, per the reference build's standing-jar form.
+## Palette
-## Signature moves
+- `--color-paper: oklch(95.5% 0.022 92)` - oat cream, faintly honeyed
+- `--color-ink: oklch(24% 0.052 152)` - botanical near-black green, headlines
+- `--color-ink-2: oklch(33% 0.05 150)` - body
+- `--color-accent: oklch(47% 0.13 140)` - living leaf-green, the signal
+- `--color-accent-2: oklch(54% 0.14 46)` - clay / terracotta pop
+- `--tint-moss: oklch(47% 0.13 140 / 0.10)` and `--tint-clay: oklch(54% 0.14 46 / 0.10)` - band washes
+- `--color-rule` soft green-grey, `--color-rule-2` mossy - hairlines
-1. **Oat-cream paper, botanical-green ink** - background `--color-paper` `oklch(95.5% 0.022 92)`; body ink `--color-ink-2` `oklch(33% 0.05 150)`, headline ink `--color-ink` `oklch(24% 0.052 152)`. Every neutral carries a green cast (hue 90-152). Never a pure grey, never `#000`/`#fff`. Set `font-variant-numeric: oldstyle-nums`.
+Every neutral carries a green cast (hue 90-152); no pure grey anywhere. Leaf-green stays under 5% of any viewport (links, the one solid control, focus rings, active nav). Clay lives mostly *inside* the craft (honey fill, cork, ripe accents) and rarely as UI chrome. Two hues, disciplined. Set `font-variant-numeric: oldstyle-nums`.
-2. **Young Serif display, sized not weighted** - `--font-display` at `--display-weight: 400`, roman only. Hierarchy comes from size (`--text-display` clamp to 5rem) and `--tracking-display: -0.006em`, never from italic or a bolder cut. A drop-of-honey slab feel, hand-cut, not a refined Didone.
+## Typography
-3. **A hand-built botanical specimen is the hero** - the focal artefact is drawn in pure CSS + hand-authored SVG (a honeycomb wash, a glass jar of amber honey, corked vials of each pour), never a stock photo. It is the thing being sold, anchored not decorative. Tier-A CSS + Tier-B SVG craft carries the page's imagery.
+- **Display** - Young Serif at `--display-weight: 400`, roman only, `--tracking-display: -0.006em`, clamped to `5rem`. Hierarchy comes from size, never from italic or a bolder cut. A drop-of-honey slab feel, hand-cut, not a refined Didone.
+- **Body** - Hanken Grotesk 400/500/600/700.
+- **Prose serif** - Newsreader at `--measure: 58ch` for long provenance and story copy: readable and warm. Young Serif never runs as body.
+- **Label** - Geist Mono, UPPERCASE, `--tracking-label: 0.14em`. The herbarium tag voice, dry machine-lettering mounted against the warm serif: lot codes, dates, captions, meta rows, table headers, units, folios.
-4. **Herbarium specimen tags** - `--font-label` (Geist Mono), UPPERCASE, `--tracking-label: 0.14em` for eyebrows, lot codes, dates, meta. The dry machine-tag voice mounted against the warm Young Serif display - like pencil on a pressed-plant sheet.
+## Material
-5. **Leaf-green as a signal, clay as a warm pop** - `--color-accent` `oklch(47% 0.13 140)` on links, the one solid button, focus rings, active nav - under 5% of any viewport. `--color-accent-2` `oklch(54% 0.14 46)` (clay/terracotta) appears mostly *inside the craft* (honey fill, cork, ripe accents), rarely as UI chrome. Two hues, disciplined.
-
-6. **Botanical tint bands, not boxed cards** - soft full-bleed section bands use `--tint-moss` `oklch(47% 0.13 140 / 0.10)` or `--tint-clay` `oklch(54% 0.14 46 / 0.10)`. Structure is hairlines (`--color-rule` soft green-grey, `--color-rule-2` mossy) + generous whitespace, not drop-shadowed boxes.
-
-7. **Sprig ornaments beside section titles** - a small hand-authored SVG leaf-sprig or fleuron sits inline before an `<h2>`, drawn in `--color-rule-2`/accent. The broadsheet fleuron, botanised.
-
-8. **Prose set in Newsreader** - long provenance/story copy uses `--font-serif` (Newsreader) at `--measure: 58ch`, readable and warm. Young Serif never runs as body. The build's default nav is **N6 newspaper masthead** (dateline + wordmark + double rule) and footer is **Ft6 letter close** (roman signoff + postscript) - broadsheet head, personal-letter foot.
+- **Hand-built botanical craft.** The imagery is drawn in pure CSS and hand-authored SVG (a honeycomb wash, a glass jar of amber, corked vials of a pour), never a stock photo. It is the thing being sold, anchored rather than decorative.
+- **Tint bands, not boxed cards.** Soft full-bleed washes in `--tint-moss` or `--tint-clay`. Structure is hairlines plus generous whitespace, never drop-shadowed boxes.
+- **Sprig ornament.** A small hand-authored SVG leaf-sprig or fleuron drawn in `--color-rule-2` or accent: the broadsheet fleuron, botanised. Ornament, never chrome.
+- **Radius and shadow** - near-square, flat. One solid leaf-green control; a pill is fine, a gradient on it is not.
## Motion
-Quiet and seasonal. One orchestrated entrance: staggered reveal of hero lines and catalogue cards (fade + <=10px rise, `--i` stagger, <=500ms, reveal-once). Optional single hover behaviour on a specimen (a jar-fill rise). All transform/opacity only - no bounce, no parallax, no autoplay. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static and fully visible.
-
-## Anti-patterns
-
-- **No grey-sage or slate paper.** Garden's ground is warm oat (hue ~92); a cool grey-green kills it.
-- **No pure `#000`/`#fff`** - green-cast ink, oat paper. Gate 7.
-- **No stock photography** - the imagery is hand-built CSS/SVG botanical craft. A real honey photo reads as a supermarket label.
-- **No italic Young Serif headers** and no faux-bold - one roman weight, vary by size (global rule + one-weight face).
-- **No cool teal / corporate emerald accent** - the green must read chlorophyll-living (hue ~140), not fintech.
-- **No boxed drop-shadow cards or card-in-card** - hairlines + tint bands. Gate 4.
-- **No floating pill nav / gradient-on-pill CTA** - broadsheet masthead + one solid leaf-green button; pill fine, gradient not.
-- **No centred-everything hero** - copy left, specimen right (or asymmetric). Gate 6.
-
-## Macrostructure affinity / rejection
+Quiet and seasonal. One orchestrated entrance: staggered reveal (fade plus <=10px rise, `--i` stagger, <=500ms, reveal-once). An optional single hover behaviour on a piece of craft (a jar-fill rise). Transform and opacity only: no bounce, no parallax, no autoplay. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static and fully visible.
-**Garden loves:** Catalogue (seasonal-lot / product-card grid - *canonical, garden-01*) . Long Document (provenance / field-story prose) . Letter (the maker's note home) . Photographic-as-specimen (hand-built botanical illustration standing in for photos) . Stat-Led (small honest facts: hives, elevation, forage).
+## Do-nots (this theme's own failure modes)
-**Garden refuses:** Workbench / component-playground (too mechanical for a farm) . Bento Grid (too gridded and product-y - Garden breathes) . Marquee Hero of pure kinetic type (fights the quiet) . Specimen-as-type-specimen (that is a sibling's job; Garden's specimen is botanical, not a glyph table).
+- **Never grey-sage or slate paper.** The ground is warm oat (hue ~92); a cool grey-green kills it.
+- **Never stock photography.** The imagery is hand-built CSS and SVG botanical craft. A real honey photo reads as a supermarket label.
+- **Never a cool teal or corporate emerald accent.** The green must read chlorophyll-living (hue ~140), not fintech.
+- **Never italic Young Serif and never faux-bold.** One roman weight; vary by size.
+- **Never boxed drop-shadow cards.** Hairlines and tint bands do the containing.
+- **Never a gradient on the leaf-green control.** One flat fill, honest.
-## Voice fixtures
+## How Garden differs from its neighbours
-- *"Honey that tastes like one hillside."*
-- *"Nine hives. One ridge. No blending."*
-- *"A poor June is a smaller June, and the summer lot says so."*
-- *"Cold-spun, strained once, poured by hand the same week."*
-- *"When a pour is gone it is gone until the same flowers come round again."*
-
-Never any of: *artisanal, curated, elevated, handcrafted-with-love, farm-to-table, sustainable-first, wellness, small-batch* as a hollow badge. Say the ridge, the flower, the pour date, the number of jars.
-
-## How Garden differs from neighbouring themes
-
-| vs | what settles it instantly |
+| vs | difference |
|---|---|
-| **Almanac** (editorial, field-reference sibling) | Almanac is a dense data/ledger register (tables, monospace almanac). Garden is a warm brand-story with a hand-built botanical specimen and a living leaf-green accent - narrative, not tabular. |
-| **Atelier** (editorial, quiet-personal sibling) | Atelier is a restrained studio/letter voice on a neutral ground. Garden shares the letter-close warmth but commits to green ink, oat paper, and chunky Young Serif - agrarian, not gallery-quiet. |
-| **Specimen** (editorial, roman-display sibling) | Specimen's "specimen" is a type/glyph specimen. Garden's specimen is a *botanical* object (jar, vial, comb) and its accent is chromatic leaf-green - a farm, not a foundry. |
+| **Almanac** | A dense data and ledger register (tables, monospace almanac). Garden is a warm brand story with hand-built botanical craft and a living leaf-green accent: narrative, not tabular. |
+| **Atelier** | A restrained studio voice on a neutral ground. Garden shares the letter-close warmth but commits to green ink, oat paper, and chunky Young Serif: agrarian, not gallery-quiet. |
+| **Specimen** | Its specimen is a type and glyph specimen. Garden's is a *botanical* object and its accent is chromatic leaf-green: a farm, not a foundry. |
-## Test brief expectations
+## When the brief routes here
-Candidate when the brief mentions: *farm . apiary . honey . cidery . orchard . seed . nursery . herbalist . botanical . tea . preserves . single-origin . seasonal . harvest . small-maker . CSA . provenance . grown . field . homestead*.
-Product categories: *artisan food/drink . apiary . farm brand . seed co . nursery . herbal / botanical goods . maker story.*
-Emotional tone: *warm . honest . seasonal . rooted . unhurried . hand-made . naturalist.*
-Briefs that are technical, corporate, cool, or image-heavy-with-photos route elsewhere.
+*farm · apiary · honey · cidery · orchard · seed · nursery · herbalist · botanical · tea · preserves · single-origin · seasonal · harvest · small-maker · CSA · provenance · grown · field · homestead*. Categories: artisan food and drink, apiaries, farm brands, seed companies, nurseries, herbal and botanical goods, maker stories. Tone: warm, honest, seasonal, rooted, unhurried, hand-made.
+
+Technical, corporate, cool, or photo-heavy briefs route elsewhere.
## Build hint
+```html
+<link href="https://fonts.googleapis.com/css2?family=Young+Serif&family=Hanken+Grotesk:wght@400;500;600;700&family=Newsreader:opsz,[email protected],400;6..72,500&family=Geist+Mono:wght@400;500&display=swap" rel="stylesheet">
+```
+
```css
html, body { overflow-x: clip; }
body { background: var(--color-paper); color: var(--color-ink-2);
@@ -98,20 +84,19 @@ body { background: var(--color-paper); color: var(--color-ink-2);
font-variant-numeric: oldstyle-nums; }
/* Young Serif display - roman, one weight, sized not bolded */
-.section__title, .hero__title {
- font-family: var(--font-display); font-weight: var(--display-weight);
+.display { font-family: var(--font-display); font-weight: var(--display-weight);
font-style: var(--display-style); letter-spacing: var(--tracking-tight);
color: var(--color-ink); line-height: var(--lh-tight); }
-/* Herbarium specimen tag - dry mono against the warm serif */
-.tag, .eyebrow { font-family: var(--font-label); text-transform: uppercase;
+/* Herbarium tag - dry mono against the warm serif */
+.tag { font-family: var(--font-label); text-transform: uppercase;
letter-spacing: var(--tracking-label); color: var(--color-muted); }
/* Tint band + hairline, never a boxed card */
.band--moss { background: var(--tint-moss); }
.rule { border-top: 1px solid var(--color-rule); }
-/* One leaf-green button; clay stays on the craft */
+/* One leaf-green control; clay stays on the craft */
.btn--solid { background: var(--color-accent); color: var(--color-accent-ink); }
/* Reveal - the whole motion engine */
@@ -123,4 +108,4 @@ body { background: var(--color-paper); color: var(--color-ink-2);
.reveal { opacity: 1; transform: none; transition: none; } }
```
-Plus the Young Serif + Hanken Grotesk + Newsreader + Geist Mono link and the small reveal script. Reference build: [`site/examples/garden-01/`](../../../../site/examples/garden-01/) - match its register (tokens, voice, motion feel), never its composition; reusing its section order, hero geometry, or grid is a gate-32-grade repeat.
+Plus one `IntersectionObserver` adding the in-view class. Reference build: [`site/examples/garden-01/`](../../../../site/examples/garden-01/) - match its register (tokens, voice, motion feel), never its composition; reusing its section order, hero geometry, or grid is a gate-32-grade repeat.
diff --git a/skills/hallmark/references/themes/grid.md b/skills/hallmark/references/themes/grid.md
index 07d749e..e71bcd3 100644
--- a/skills/hallmark/references/themes/grid.md
+++ b/skills/hallmark/references/themes/grid.md
@@ -1,125 +1,99 @@
# Theme - Grid
-Swiss / neo-grotesque systems design. The page for a **design studio, an identity or signage practice, a type specimen, an institutional index, an editorial programme** - the object-poster / transit-signage school, executed on a **near-white cool sheet with an exposed 12-column hairline grid, one heavy grotesk, and exactly ONE signal red used as a geometric mark**. Giant lowercase Archivo 800 slams to the left margin, the column rules stay visible behind the content, and every surface butts against a hairline. It reads like a wayfinding manual: rational, gridded, set once and built to outlast its brief.
+Swiss neo-grotesque systems design: the object-poster and transit-signage school, executed on a **near-white cool sheet with an exposed 12-column hairline grid, one heavy grotesk, and exactly one signal red used as a geometric mark**. Giant lowercase Archivo slams to the left margin, the column rules stay visible behind the content, and every surface butts against a hairline. It reads like a wayfinding manual: rational, gridded, set once and built to outlast its brief.
-Loaded eagerly by SKILL.md Step 3 when the catalog pick is `grid`. Tokens: `site/css/tokens.css` under `[data-theme="grid"]`. Reference build: `site/examples/grid-01/`.
+The material, in one line: **a visible column grid, one grotesk, and one red square.**
-> **The editorial exception.** The editorial cluster is otherwise serif-led (Newsprint, Editorial, Specimen). Grid is its Swiss neo-grotesque slot: no serif anywhere, structure carried by an exposed grid and hairlines, warmth carried by one red. If it wants a roman serif or a soft column, it is a different editorial theme.
+> **The editorial exception.** The editorial cluster is otherwise serif-led (Newsprint, Editorial, Specimen). Grid is its Swiss neo-grotesque slot: no serif anywhere, structure carried by an exposed grid and hairlines, warmth carried by one red. A brief wanting a roman serif or a soft column is a different editorial theme.
## Axes (diversification)
-- **Paper band** - **light**, cool near-white (`--color-paper: oklch(99% 0.003 255)`, faint cool, never `#fff`). Stepped at `paper-2 97.2%` / `paper-3 94.5%`. Ink is cool near-black `--color-ink: oklch(16% 0.010 255)`.
-- **Display style** - **grotesk-heavy** (Archivo **800**, `--display-weight: 800`), run **lowercase** at `--tracking-display: -0.045em`. Heavy + lowercase is the differentiator against every uppercase-condensed and serif option.
-- **Accent hue** - **warm signal red** (`--color-accent: oklch(55% 0.21 28)`). One saturated red (~28 deg), used as a square, a bar, a period; never a wash. `--color-focus` is the same red.
+- **Paper band** - **light**, cool near-white (`--color-paper: oklch(99% 0.003 255)`, faintly cool, never `#fff`). Stepped at `paper-2 97.2%` and `paper-3 94.5%`. Ink is cool near-black `--color-ink: oklch(16% 0.010 255)`.
+- **Display style** - **grotesk-heavy** (Archivo **800**, `--display-weight: 800`), run **lowercase** at `--tracking-display: -0.045em`. Heavy plus lowercase is the differentiator against every uppercase-condensed and serif option.
+- **Accent hue** - **warm signal red** (`--color-accent: oklch(55% 0.21 28)`), one saturated red near 28°, used as a square, a bar, a period, never a wash. `--color-focus` is the same red.
## Reference register
-Vitra, Braun, the Vignelli canon, Museum fur Gestaltung, the Swiss International poster tradition. The aesthetic: the institutional identity manual and the transit-signage system - a modular grid drawn in public, one grotesk, one red, no image needed. **Patron-saint (internal):** *a signage manual crossed with a printed grid specimen* - rules visible, type as structure, red as the only warm mark. When in doubt ask "does this read like a systems manual, or like a marketing template?" Keep the former. **Never name any of these in the output.**
+Vitra, Braun, the Vignelli canon, Museum fur Gestaltung, the Swiss International poster tradition. The material to match: the institutional identity manual and the transit-signage system - a modular grid drawn in public, one grotesk, one red, no image needed. When in doubt, ask whether this reads like a systems manual or like a marketing template, and keep the former. Never name any of these in the output.
-## Required dependencies
+## Typography
-1. **Fonts** - **Archivo** only, one family across display / body / labels (400/500/600/700/800). No serif, no mono in use: `--font-serif` and `--font-mono` resolve to unused fallbacks - do **not** load them. Google Fonts (exactly the canonical link):
- ```html
- <link href="https://fonts.googleapis.com/css2?family=Archivo:wght@400;500;600;700;800&display=swap" rel="stylesheet" />
- ```
-2. **No reveal script required.** The build is static; motion is hover-only (see Motion). If a reveal is added, it must gate behind `prefers-reduced-motion: no-preference` and ship static + visible otherwise.
+**Archivo only, one family across the whole page** (400/500/600/700/800). Swiss discipline comes from weight, scale, and tracking, not from a second family. `--font-serif` and `--font-mono` resolve to unused fallbacks; do not load them.
-## Signature moves
+- **Display** - Archivo 800, **lowercase**, `clamp(52px, 10.5vw, 136px)`, `letter-spacing: -0.045em`, `line-height: 0.9`. Slammed to the left margin, edge-aligned to the grid.
+- **Body** - Archivo 400, 16px, `line-height: 1.5`.
+- **Label voice** - Archivo uppercase at 12px, weight 600, `letter-spacing: 0.09em`, `--color-muted`. It sets captions, table headers, meta rows, folios, units, and index numbering - the quiet caps counterpoint to the giant lowercase display. It never sits above a heading as a kicker.
-1. **The exposed 12-column hairline grid - THE move.** An absolutely-positioned `.rails__inner` paints a `repeating-linear-gradient` of 1px `--color-rule` lines every `calc(100% / 12)`, sitting behind the content at `z-index: 0`. The grid is visible, not scaffolding to remove. Content rides a `grid-template-columns: repeat(12, minmax(0,1fr))` on top.
+## Material
-2. **One typeface, whole page.** Archivo carries display (800), body (400), and the caps labels. Swiss discipline comes from weight, scale, and tracking - not from a second family. No serif contrast, no mono voice.
+- **The exposed 12-column hairline grid is the theme.** A `repeating-linear-gradient` of 1px `--color-rule` lines every `calc(100% / 12)`, painted behind the content, capped to the shell width. The grid is content, not scaffolding to delete, and content rides `repeat(12, minmax(0,1fr))` on top of it.
+- **Red only as a geometric mark, under 5% of any viewport.** A solid `0.52em` square where a full stop would fall, a short block terminating a row, a `3px` bar over a head. Never a fill wash, never a gradient, never a second colour.
+- **Hairlines and ink rules do all the structure; zero cards.** `--radius-card: 0`, `--shadow-card: none`. Faint `--color-rule` hairlines split cells, a 1px-to-2px solid `--color-ink` rule tops a section, and content butts flush against it. No boxes, no float, no drop shadow.
+- **Cells, not tiles.** Where the page needs repeated units, they are equal cells of the same grid divided by `border-inline-start` hairlines, sharing the band's top and bottom rules. The band reads as one ruled object, not as a row of separate objects.
+- **`::selection` is red on paper.** The one place the accent floods anything.
-3. **Giant lowercase display, slammed left, with a red square period.** `--text-display` (`clamp(52px, 10.5vw, 136px)`), weight 800, `letter-spacing: -0.045em`, `line-height: 0.9`, `text-transform: lowercase`. A solid `0.52em` red square (`.hero__period`) sits inline where a full stop would - the theme's mark.
-
-4. **Red only as a geometric mark, under 5% of any viewport.** A square period, a `12px` red block ending the first index row (`.row__mark span`), a `3px × 96px` red bar over the contact head (`.contact__rule`), a red period on the position line. Never a fill wash, never a second colour.
-
-5. **Hairlines + ink section-rules do all structure; zero cards.** `--radius-card: 0`, `--shadow-card: none`. Faint `--color-rule` hairlines split cells; a `1px`-to-`2px` solid `--color-ink` rule tops each section and the index. Content butts flush to the rule - no boxes, no float, no drop-shadow.
-
-6. **Cellular chrome: nav and footer are bands of equal cells.** The sticky `.topbar` is `border-block: 1px solid var(--color-ink)`; each cell is `grid-column: span 2` (mark spans 4) divided by `border-inline-start: 1px solid` the hairline. The footer repeats the pattern at `span 3`. A DE / EN toggle sits in the last cell.
-
-7. **The work index: numbered full-width rows on the 12-col grid.** `no` span 1 / `title` span 7 / `meta` span 3 / `mark` span 1, split by hairlines, topped by a `2px` ink rule. Hover tints the row (`--color-paper-2`) and nudges the title `translateX(8px)`.
-
-8. **Caps labels as numbered eyebrows.** Section heads open with an Archivo uppercase label, `12px`, weight 600, `letter-spacing: 0.09em`, `--color-muted`, numbered `01 · Practice` / `02 · Selected work`. The quiet caps counterpoint to the giant lowercase display.
+**Shapes Grid suits** (affinities, never requirements): a numbered index of full-width rows riding the 12 columns, with a hairline between fields and a hover tint; a type specimen where the grid is the exhibit; figures set in bordered cells with caps labels beneath.
## Motion
-Near-zero. No reveals, no parallax, no autoplay. The only motion is hover micro-state: row background shifts to `--color-paper-2` and the title slides `8px`; nav links underline; the contact mail border shifts to red; `::selection` is red on paper. Smooth scroll only. Everything transitions in ~0.18-0.2s ease; `prefers-reduced-motion: reduce` kills transitions and `scroll-behavior`.
-
-## Anti-patterns
-
-- **No uppercase display.** Grid's display is **lowercase**; uppercase-condensed is Manifesto / Brutal.
-- **No dark ground.** Grid is a light 99% sheet - a dark statement page is Manifesto.
-- **No thick 3px black rules boxing solid blocks.** That marker-weight structure is Brutal; Grid draws with a 1px pencil and lets the column grid show.
-- **No hiding the grid.** The rails stay visible - the grid is content, not a layout aid to delete.
-- **No second accent, no gradient, no red wash.** One red, geometric, under 5%.
-- **No cards, radius, or drop-shadow.** `--radius-card: 0`, `--shadow-card: none`; depth is hairlines and ink rules.
-- **No serif and no mono body.** One grotesque only; do not reach for `--font-serif` / `--font-mono`.
-- **No centred hero.** Slam left, edge-aligned to the grid.
+Near-zero. No reveals, no parallax, no autoplay. The only motion is hover micro-state: a row background shifts to `--color-paper-2` and its title slides 8px, links underline, a bordered surface shifts its border to red. Everything transitions in ~0.18-0.2s ease. Smooth scroll only, and `prefers-reduced-motion: reduce` kills transitions and `scroll-behavior`.
-## Macrostructure affinity + rejection
+## Do-nots (this theme's own failure modes)
-**Grid loves:** **Manifesto** (a gridded statement, red period as climax) · **Specimen** (type on a visible grid) · **Long Document** (an editorial column programme) · **Stat-Led** (figures in bordered cells, caps labels beneath) · the numbered **Index / directory** shape (the canonical work index).
+- **Never hide the grid.** The rails stay visible. Deleting them because they look like scaffolding removes the theme.
+- **Never uppercase display, never a serif, never a mono body.** Grid's display is lowercase Archivo; uppercase-condensed is Manifesto or Brutal, and the second family never arrives.
+- **Never a dark ground, and never a 3px black rule boxing a solid block.** A dark statement page is Manifesto; marker-weight structure is Brutal. Grid is a 99% sheet drawn with a 1px pencil.
+- **Never a second accent, a gradient, or a red wash.** One red, geometric, under 5%.
+- **Never a card, a radius, or a drop shadow.** Depth is hairlines and ink rules.
+- **Never a centred hero.** Slam left.
-**Grid refuses:** **Photographic / image-led** (Grid is type + rule, not imagery) · **Letter** (too intimate; Grid is an institution, not a note) · **Marquee with a product mock** (Grid shows the system, not a screenshot) · anything wanting soft rounded tiles or a consumer-warm bento.
+## Voice range
-## Voice fixtures
+Rational, plainspoken, institutional. Name the system, the place, the year concretely. No hype. Never: seamless, robust, cutting-edge, leverage, synergy, revolutionary, unlock, supercharge, elevate, curated, bespoke. Never "click here."
-Rational, plainspoken, institutional. Name the system concretely. No hype.
-
-- *"Structure before surface."*
-- *"We draw the grid first, so every decision after it has somewhere to stand."*
-- *"A grid is not decoration. It is a decision made once, in public."*
-- *"The system has to survive twenty years of new hands and new content."*
-- *"Identity, wayfinding, and editorial systems for institutions that plan in decades."*
-
-Never any of: *seamless, robust, cutting-edge, leverage, synergy, revolutionary, unlock, supercharge, elevate, curated, bespoke*. Never "click here." Name the practice, the place, the year.
-
-## How Grid differs from neighbouring themes
+## How Grid differs from its neighbours
| vs | difference |
|---|---|
-| **Manifesto** (dark poster) | Manifesto is a **dark** ground (`oklch(10% 0.005 60)`), Anton 400 **uppercase** at `--lh-tight: 0.86`, red `#E51A1A`. Grid is a **light** sheet (`oklch(99% 0.003 255)`), Archivo **800 lowercase**, red `oklch(55% 0.21 28)`. Same "one red, type carries it" DNA - opposite value and case. |
-| **Cobalt** (cool dev-tool) | Cobalt is modern-minimal: accent electric **cobalt** `oklch(58% 0.20 256)`, Space Grotesk + JetBrains Mono, a dark graphite code-card hero, 6-10px radii, one dark band. Grid is editorial: **red** accent, single-family Archivo, an exposed 12-col grid, **zero radius**, no code, no dark band. Blue instrument vs red Swiss manual. |
-| **Brutal** (heavy sans) | Both are light near-neutral sheets with one red and zero radius, but Brutal draws with **3px** black rules (`--color-rule: oklch(12%)`) boxing solid inverted blocks in Albert Sans 700 **uppercase**. Grid draws with **1px** hairlines (`--color-rule: oklch(88%)`) painting a **visible column grid**, Archivo 800 **lowercase**, no solid panels. Marker vs pencil; shout vs quiet. |
-
-## Test brief expectations
+| **Manifesto** | Manifesto is a **dark** ground (`oklch(10% 0.005 60)`), Anton 400 **uppercase** at `--lh-tight: 0.86`, red `#E51A1A`. Grid is a **light** sheet (`oklch(99% 0.003 255)`), Archivo **800 lowercase**, red `oklch(55% 0.21 28)`. Same "one red, type carries it" DNA, opposite value and case. |
+| **Cobalt** | Cobalt is modern-minimal: electric cobalt `oklch(58% 0.20 256)`, Space Grotesk plus JetBrains Mono, graphite code surfaces, 6-10px radii. Grid is editorial: red accent, single-family Archivo, an exposed 12-column grid, zero radius, no code. Blue instrument vs red Swiss manual. |
+| **Brutal** | Both are light near-neutral sheets with one red and zero radius, but Brutal draws with **3px** black rules (`--color-rule: oklch(12%)`) boxing solid inverted blocks in Albert Sans 700 **uppercase**. Grid draws with **1px** hairlines (`--color-rule: oklch(88%)`) painting a **visible column grid**, Archivo 800 **lowercase**, no solid panels. Marker vs pencil; shout vs quiet. |
-Grid should be a candidate when the brief mentions:
+## When the brief routes here
-- *identity · brand system · wayfinding · signage · design studio · type specimen · editorial grid · institution · museum · archive · index · directory · systems · modular · Swiss · grotesque · manual · programme*
-- Product categories: *design / branding studio · cultural institution · publisher · specimen or catalog · portfolio index*
-- Emotional tone: *rational · systematic · precise · institutional · disciplined · timeless · calm-authoritative*
+*identity · brand system · wayfinding · signage · design studio · type specimen · editorial grid · institution · museum · archive · index · directory · systems · modular · Swiss · grotesque · manual · programme*. Categories: design and branding studios, cultural institutions, publishers, specimens and catalogs, portfolio indexes. Tone: rational, systematic, precise, institutional, disciplined, timeless, calm-authoritative.
-Briefs that are warm / consumer / image-led / serif-editorial route elsewhere (the serif editorial themes for prose, Cobalt for dev tools). When the brief wants a **visible grid, one grotesk, and one red**, it is Grid.
+Warm, consumer, image-led, or serif-editorial briefs route elsewhere. When the brief wants a visible grid, one grotesk, and one red, it is Grid.
## Build hint
-The first lines of CSS establish Grid's anchor moves:
+```html
+<link href="https://fonts.googleapis.com/css2?family=Archivo:wght@400;500;600;700;800&display=swap" rel="stylesheet" />
+```
```css
html, body { overflow-x: clip; }
body { background: var(--color-paper); color: var(--color-ink);
font-family: var(--font-body); font-size: 16px; line-height: 1.5; }
-/* THE move: the exposed 12-column hairline grid, painted behind content */
-.rails__inner {
- height: 100%; max-width: 1280px; margin-inline: auto;
+/* THE ground: the exposed 12-column hairline grid, painted behind the content */
+.rails {
+ position: absolute; inset: 0; z-index: 0; pointer-events: none;
+ max-width: 1280px; margin-inline: auto;
background-image: repeating-linear-gradient(to right,
var(--color-rule) 0, var(--color-rule) 1px,
transparent 1px, transparent calc(100% / 12));
}
-.grid { display: grid; grid-template-columns: repeat(12, minmax(0,1fr)); gap: 0; }
-/* Giant lowercase display, slammed left, with the red square period */
-.hero__title { font-family: var(--font-display); font-weight: var(--display-weight);
+h1, h2 { font-family: var(--font-display); font-weight: var(--display-weight);
font-size: clamp(52px, 10.5vw, 136px); letter-spacing: var(--tracking-display);
line-height: 0.9; text-transform: lowercase; }
-.hero__period { display: inline-block; width: 0.52em; height: 0.52em;
- background: var(--color-accent); } /* the one signal, as a mark */
-/* Sections butt against ink rules: zero cards, zero radius, zero shadow */
-.band, .work, .contact { border-top: 1px solid var(--color-ink); }
+.period { /* the one signal, as a mark */
+ display: inline-block; width: 0.52em; height: 0.52em;
+ background: var(--color-accent);
+}
+
::selection { background: var(--color-accent); color: var(--color-accent-ink); }
@media (prefers-reduced-motion: reduce) {
@@ -128,4 +102,4 @@ body { background: var(--color-paper); color: var(--color-ink);
}
```
-Plus the Archivo link above (Archivo only). Reference build: `site/examples/grid-01/` - match its register (tokens, voice, motion feel), never its composition; reusing its section order, hero geometry, or grid is a gate-32-grade repeat.
+Grid supplies the sheet, the rails, the one grotesk, and the one red. What rides those twelve columns is the brief's business, not the theme's.
diff --git a/skills/hallmark/references/themes/hum.md b/skills/hallmark/references/themes/hum.md
index f2e6083..ef9e3c2 100644
--- a/skills/hallmark/references/themes/hum.md
+++ b/skills/hallmark/references/themes/hum.md
@@ -1,168 +1,107 @@
# Theme - Hum
-The playful, vibrant, **alive** register. Cream paper, multi-accent palette (pear-yellow primary, sky-cyan secondary, coral-red pop), rounded sans typography, generous radii, soft lifting shadows, mandatory hover-and-on-paint motion. Hum is the catalog theme for products that don't take themselves too seriously - daily-curiosity apps, learning platforms, habit trackers, friendship apps, kids' tools, indie creative software. Sites that should feel like the room is warm and someone smart is smiling.
+The playful, vibrant, **alive** register. Cream paper pulled toward pear-yellow, three accents on stage at once, rounded humanist sans, generous radii, soft shadows that lift, and a response on almost anything a pointer touches. Hum is for products that do not take themselves too seriously and still take craft seriously: the room is warm and someone smart is smiling.
-Loaded eagerly by SKILL.md Step 3 whenever the catalog pick is `hum`. The palette + font stack live in [`site/css/tokens.css`](../../../../site/css/tokens.css) under `[data-theme="hum"]`. This file carries signature moves, motion direction, voice fixtures, anti-patterns, and how Hum holds its identity against neighbouring themes. Hum is the catalog's only playful theme - its closest siblings are Coral (single-accent restraint, modern-minimal) and Bloom (warm-light atmospheric), not another playful register.
+The material, in one line: **cream, three accents that never blend, round corners everywhere, and a press you can feel.**
## Axes (diversification)
-- **Paper band** - light (`L 97%`), warm cream tinted toward pear-yellow hue (~95°). Yellower and brighter than any other warm-paper theme in the catalog - never the rose-warm or oat-warm cream of the editorial themes.
-- **Display style** - **rounded-sans** (new axis value, Plus Jakarta Sans / Open Runde register - rounded humanist letterforms with closed apertures). Distinct from geometric-sans (Manifesto), italic-serif, classical-serif (Lumen), and other catalog options.
-- **Accent hue** - **multi** (new axis value - three accents on stage simultaneously: pear-yellow `H 95`, sky-cyan `H 235`, coral-red `H 18`). Distinct from every single-accent or duo-tone theme in the catalog.
+- **Paper band** - light (`L 97%`), warm cream tinted toward pear-yellow (~95°). Yellower and brighter than any other warm paper in the catalog; never the rose-warm or oat-warm cream of the editorial themes.
+- **Display style** - **rounded-sans** (Plus Jakarta Sans / Open Runde register: rounded humanist letterforms, closed apertures). Distinct from geometric-sans, italic-serif, and classical-serif.
+- **Accent hue** - **multi**: pear-yellow `H 95`, sky-cyan `H 235`, coral-red `H 18`, all on stage at once. Distinct from every single-accent and duo-tone theme.
## Reference register
-Brilliant.org (post-2024 brand refresh - Koto's pear-yellow + cream + custom CoFo Sans) · Duolingo (the named-color system: Feather Green, Macaw, Cardinal, Bee, Fox, Beetle, Humpback) · PostHog (Max the hedgehog, cream + red + blue, Open Runde + Squeak + Loud Noises) · tldraw (Shantell Sans with `Bounce` axis) · Cosmos (color-shift-on-hover) · Cluely (Mac OS chrome as set dressing) · Liveblocks (cursor-presence done right) · Hover.dev (the working dictionary of spring-physics interactions) · Each.place, Tella (vibrant gradient surfaces).
+Brilliant.org (Koto's 2024 pear-yellow on cream) · Duolingo's named-colour system · PostHog · tldraw · Cosmos · Liveblocks · Hover.dev · Tella.
-The aesthetic to match: cream paper (never pure white), a single character or mark that *reacts* to user actions, generous rounded surfaces, big confident counters in rounded display, soft drop shadows that lift on hover, multi-accent sections that don't fight (because each accent has its own surface). Pear-yellow + cream is the **calibration** combination - anything that reads further saturated than that has gone too vibrant; anything that reads more muted has lost the playfulness.
-
-**Patron-saint reference (internal):** *Brilliant.org's Koji moment* + *PostHog's "if it could belong to any SaaS, it isn't PostHog enough" rule*. When in doubt about restraint, ask the inverse: *"is there a single moment on this page that would not exist if we weren't trying to feel alive?"* If no, the page is too quiet for Hum.
+The material to match: cream paper (never pure white), generous rounded surfaces, big confident figures in rounded display, soft drop shadows that lift on hover, accent surfaces that sit beside each other rather than blending. Pear-yellow on cream is the **calibration** pair: more saturated than that has gone gaudy, more muted has lost the playfulness. When in doubt about restraint, ask the inverse question: is there a single moment here that would not exist if we were not trying to feel alive? If no, it is too quiet for Hum.
## Palette
-Multi-accent. No single accent dominates - different surfaces use different accents, and the contrast between sections is part of the typographic rhythm.
+Multi-accent. No single accent dominates; different surfaces carry different accents, and the contrast between them is part of the rhythm.
-- `--color-paper: oklch(97% 0.012 95)` - cream, slight pear-yellow pull (Brilliant's calibration)
+- `--color-paper: oklch(97% 0.012 95)` - cream, slight pear-yellow pull
- `--color-paper-2: oklch(94% 0.016 95)` - tinted band (yellower)
- `--color-paper-3: oklch(91% 0.020 95)` - deeper hover
-- `--color-ink: oklch(20% 0.012 250)` - near-black with cool tilt (PostHog's `#151515` discipline - never pure black)
-- `--color-accent: oklch(86% 0.18 95)` - pear-yellow (primary; CTA, streaks, primary character mark)
-- `--color-accent-2: oklch(66% 0.18 235)` - sky-cyan (secondary; links, hover tints, illustrations)
-- `--color-accent-3: oklch(68% 0.24 18)` - coral-red (pop; only used at high-energy single moments - streak completion, badge, the one big number)
-- `--color-mint: oklch(80% 0.16 150)` - soft green (used sparingly - success states, secondary tags)
-- `--color-lavender: oklch(74% 0.16 305)` - used sparingly (tag chips, decorative)
-
-**Three-rule for accents:**
-1. Each accent owns its own type of surface. Pear = primary action. Cyan = link / hover-tint. Coral = single high-energy moment per page.
-2. Accents never blend in gradients (no pear-to-cyan gradient anywhere).
-3. Mint and lavender are *occasional* - never more than one of each per page.
-
-## Typography
-
-Three font families. Rounded sans throughout - Hum has no serif anywhere.
-
-- **Display / body:** Plus Jakarta Sans (Google Fonts, weights 400/500/600/700) - rounded humanist sans with closed apertures and friendly terminals. The Brilliant / PostHog / Open Runde register. Falls back to Geist, then system rounded.
-- **Mono:** JetBrains Mono (uppercase labels, tabular numerals, streak counters).
-- **No serif anywhere.** No `Instrument Serif`, no `Playfair`, no `Newsreader`. If a serif sneaks in, the theme is misapplied.
-
-**Type discipline:**
-- Display weight: **600** (heavier than Lumen's 400 - Hum's display is confident, not delicate).
-- Tracking on display: `-0.025em` (tight, not over-tight).
-- Body weight: 400 with 500 for inline emphasis.
-- All-caps reserved for mono labels.
-- **Big counters:** stat numerals at clamp(3rem, 5vw + 1rem, 5rem), rounded display, tabular-nums. Streaks, completion counts, deep-dive counts.
-
-## The seven signature moves
-
-A Hum build must exhibit **at least six of these seven**. Skipping the character moment (#5) is the only acceptable omission - for product-led pages without space for ornament.
-
-These are the theme's *vocabulary*, not a layout: which moves appear is shared, but **how they're composed must differ every build** (see *Not-AI discipline* below). In particular, #3 is the colour-shift *technique* (accent tint deepens on hover) applied to whatever tile or row shape the build chooses - it is never a licence for the banned 3-equal-cards row.
+- `--color-ink: oklch(20% 0.012 250)` - near-black with a cool tilt, never pure black
+- `--color-accent: oklch(86% 0.18 95)` - pear-yellow (primary action)
+- `--color-accent-2: oklch(66% 0.18 235)` - sky-cyan (links, hover tints)
+- `--color-accent-3: oklch(68% 0.24 18)` - coral-red (the pop; one high-energy moment)
+- `--color-mint: oklch(80% 0.16 150)` - soft green, sparingly
+- `--color-lavender: oklch(74% 0.16 305)` - sparingly
-### 1. The button system - three variations, the press is the feedback
+**Three rules for the accents:**
-Hum ships **one button system, three style variations**, structured as `.btn` (base = *push*) + a style modifier (`.btn--soft` | `.btn--outline`) + a colour modifier (`.btn--pear` | `--coral` | `--cyan` | `--lav` | `--mint` | `--ink`) + size (`.btn--sm` | `.btn--lg`). The reviewed `.btn` block below is the RECIPE: the press mechanics (edge shadow anatomy, hover-lift, active-press, the two bug fixes) are mandatory in every Hum build; the skin (colour modifiers, radius, size steps) restyles freely to the build. Keep the mechanics, restyle the skin; do not re-derive the press physics from scratch (that is how the broken version proliferated).
+1. Each accent owns its own kind of surface. Pear = primary action. Cyan = link and hover tint. Coral = the single high-energy moment.
+2. Accents never blend into each other in a gradient. No pear-to-cyan, ever.
+3. Mint and lavender are occasional, never more than one of each on a page.
-**The anatomy that matters (the two bugs this fixes):**
+Ink is modified **with opacity, not with new hexes**: body ~88-90%, links 95%, hover 100%. Fewer literal colours, used consistently.
-1. **Shadow = a full-width solid colour edge + a separate soft ground shadow.** `box-shadow: 0 4px 0 0 var(--btn-edge), 0 6px 12px -3px var(--btn-cast)`. **Never a negative spread** (`0 8px 0 -4px` makes the edge narrower than the button - the old bug). The first shadow is the button's *thickness*, flush to its width; the second is the cast shadow on the ground.
-2. **The press is the feedback.** Lift on hover (`translateY(-2px)`, edge grows to `6px`), **press DOWN on `:active`** (`translateY(+3px)`, edge shrinks to `1px`) so it physically depresses. Easing is snappy - `cubic-bezier(0.2, 0.7, 0.3, 1)`, 140 ms hover / 70 ms active. **No `scale()`, no spring overshoot** (the old `scale(1.04)` + `cubic-bezier(…1.56…)` read floaty).
-
-```css
-.btn {
- --btn-face: var(--color-accent); --btn-ink: var(--color-ink);
- --btn-edge: var(--color-accent-deep); --btn-cast: oklch(76% 0.20 95 / 0.45);
- --btn-line: var(--color-accent-deep);
- display: inline-flex; align-items: center; justify-content: center; gap: 0.5em;
- padding: 0.8rem 1.4rem; font-weight: 600; border: 0; border-radius: var(--radius-pill);
- color: var(--btn-ink); background: var(--btn-face); cursor: pointer; position: relative; isolation: isolate;
- box-shadow: 0 4px 0 0 var(--btn-edge), 0 6px 12px -3px var(--btn-cast);
- transform: translateY(0);
- transition: transform 140ms cubic-bezier(0.2,0.7,0.3,1), box-shadow 140ms cubic-bezier(0.2,0.7,0.3,1), background-color 160ms;
-}
-.btn:hover { transform: translateY(-2px); box-shadow: 0 6px 0 0 var(--btn-edge), 0 12px 22px -4px var(--btn-cast); }
-.btn:active { transform: translateY(3px); box-shadow: 0 1px 0 0 var(--btn-edge), 0 2px 6px -2px var(--btn-cast); transition-duration: 70ms; }
-.btn:focus-visible { outline: 3px solid color-mix(in oklch, var(--btn-edge) 70%, var(--color-focus)); outline-offset: 3px; }
-.btn[disabled] { opacity: 0.5; cursor: not-allowed; pointer-events: none; transform: none; box-shadow: 0 4px 0 0 var(--btn-edge); }
-/* .btn--soft = flat-lift (soft shadow, no colour edge); .btn--outline = hairline + accent fill sweeps up on hover.
- .btn__arrow slides 3px right on hover. .is-loading shows a spinner. Build these modifiers on top of the .btn base above. */
-```
-
-**Rules:** primary action = push (the chunky one). Secondary = soft. Tertiary = outline. One push button per primary moment; don't stack three push buttons in a row. The first-paint wobble is **retired** - it fought the press metaphor.
-
-### 2. Multi-accent section bands
+## Typography
-Sections alternate background between cream paper, pear-tint, cyan-tint, and coral-tint. Each accent owns sections matching its meaning: pear = primary product surfaces, cyan = community / "what people say," coral = the single emphatic moment (streak day, headline number). Bands transition with simple `background-color` changes - no gradients between them.
+Two families. Rounded sans throughout; Hum has no serif anywhere.
-### 3. Color-shift card grid
+- **Display and body** - Plus Jakarta Sans 400/500/600/700. Falls back to Geist, then a rounded system stack, never a bare system font.
+- **Label** - JetBrains Mono, UPPERCASE, tracked `0.10em`. It sets captions, meta rows, table headers, units, ordinals, folios, and streak readouts. It never sits above a heading as a kicker.
-Card grid where each card has a different accent tint at rest (very low opacity, ~6% of its accent). On hover: the card's tint deepens to ~12%, and the card lifts 4px with a softened shadow. The accents don't compete because each card holds its accent for its own surface.
+Display weight is **600**, tracking `-0.025em`: confident, not delicate. Body is 400 with 500 for inline emphasis. Sentence case throughout (Hum is not Lumen's all-lowercase). Big figures run at `clamp(3rem, 5vw + 1rem, 5rem)` in rounded display with `tabular-nums`.
-### 4. Streak / counter tick-up
+## Material
-Big rounded numerals that count up from 0 to their target value on view-enter, over 1200ms with `cubic-bezier(0.22, 1, 0.36, 1)` easing (snappy arrival). The container scales 1 → 1.06 → 1 once on completion (the "yes!" moment). Implemented with `@property --num` for CSS-only tick-up, or a small JS loop with `requestAnimationFrame`.
+- **Round, everywhere.** `--radius-card: 20px`, `--radius-pill: 999px`, `--radius-input: 12px`. How much round is a per-build lever (a kids' build can go chunky at 28px, a quiet one tight at 14px); what never changes is that no corner is square.
+- **Card physics is a lever, not a constant.** Hairline-flat with no shadow, chunky with the button's hard edge, borderless tinted blocks, one soft single layer, or a layered contact-plus-ambient pair. Pick one personality per build instead of `20px` plus one shadow on everything.
+- **The press.** Hum's button is a solid colour **edge** plus a soft ground shadow: `0 4px 0 0 var(--btn-edge), 0 6px 12px -3px var(--btn-cast)`. Never a negative spread, which makes the edge narrower than the button. Hover lifts 2px and the edge grows to 6px; `:active` presses **down** 3px and the edge shrinks to 1px. Snappy easing, 140ms hover and 70ms active, no `scale()`, no spring overshoot. The press is the feedback.
+- **Accent tint on a surface** sits at ~6% of its accent at rest and deepens to ~12% on hover. That is a technique for whatever shape a build chooses, never a licence for a row of three equal cards.
+- **Emphasis is painted on the text.** A highlighted word carries a clipped `background-image` band with `box-decoration-break: clone`, so it follows every wrapped line and scales with font-size. Never an absolutely-positioned bar behind the word, and never `font-style: italic` - emphasis here is weight 500, an accent colour, or the band.
+- **Marks are drawn in CSS or SVG.** No emoji standing in for icons, no `<img>` for a character, no Lottie.
-### 5. Character moment - one small reacting mark
+## Motion
-Every Hum page has ONE small character / mark that reacts to user interaction. Constructed entirely in CSS (no `<img>`, no Lottie). Examples:
-- A small filled circle that pulses gently at rest and bursts a 4-point star when its CTA is clicked.
-- A wordmark where one letter is the character - pulses, blinks, or wobbles on hover.
-- A floating shape next to the hero that drifts in a slow circle and grows when hovered.
+The loudest stack in the catalog: almost every interactive element does something on hover or on first paint.
-The character lives in **pear-yellow** by default - that's its colour. Other accents can carry it but pear is canonical.
+| Element | Motion |
+|---|---|
+| Primary button | lift 2px on hover (edge grows), press down 3px on `:active` (edge shrinks), `cubic-bezier(0.2,0.7,0.3,1)`. No scale, no wobble |
+| Cards | lift 4px, shadow brightens, accent tint deepens. 220ms `--ease-spring` |
+| Figures | tick up from 0 on view enter over 1200ms, then one 1 → 1.06 → 1 pulse on arrival |
+| A character mark | gentle 4s pulse at rest; a 4-point coral star bursts from the click point over 420ms on a completed primary action, once, never looping |
+| Headings | 12px rise plus opacity on view enter, 600ms, 80ms stagger |
+| Scroll | Lenis optional (`duration: 0.8, lerp: 0.10`) |
-### 6. Big rounded everything
+Easings: `--ease-spring: cubic-bezier(0.34, 1.56, 0.64, 1)` for micro press and pop only (never a hero entrance), `--ease-snap: cubic-bezier(0.22, 1, 0.36, 1)` for tick-ups and reveals.
-`--radius-card: 20px`, `--radius-pill: 999px`, `--radius-input: 12px`. Soft drop shadows on cards (`0 12px 32px -16px ink/15%`) that brighten on hover. The *amount* of round (and the shadow philosophy) is a per-build lever - a kids' build can go chunky at 28px with a hard button-style edge, a quiet one tighter at 14px with a single soft layer (see the card-physics lever under *Not-AI discipline*). What never changes: **no square corners anywhere** - this is the rounded theme.
+`prefers-reduced-motion: reduce` collapses springs to opacity and colour, renders figures at final value, stops the pulse, disables the burst. The page stays delightful without motion: restraint, not breakage.
-### 7. Star-burst micro-celebration on success
+## Do-nots (this theme's own failure modes)
-When a primary action completes (CTA click, form submit, streak hit), a 4-point star bursts from the click point and fades out over 420ms. Star is in coral-red (the pop accent), 24px tall at full size. Single firing per action; never auto-loops.
+- **Never a serif, never pure white paper, never pure black ink, never a square corner.** Any one of the four and it is a different theme wearing Hum's radii.
+- **Never a gradient between two accents,** and never a rainbow ground. Multi-accent means each accent holds its own surface; it does not mean they mix.
+- **Never a single restrained accent.** A brief that wants one quiet accent is Coral, not Hum.
+- **Never more than one character moment on a page,** and never one assembled from stock icons or emoji. One mark, drawn, with a personality.
+- **Never an invented metric.** A streak count is real data or it is not on the page.
+- **Never over-rotate the motion.** Bouncy easing on everything is exhausting; the spring belongs to primary actions.
-```css
-.star-burst {
- position: absolute;
- width: 24px; height: 24px;
- background:
- linear-gradient(90deg, transparent 47%, var(--color-accent-3) 47% 53%, transparent 53%),
- linear-gradient(0deg, transparent 47%, var(--color-accent-3) 47% 53%, transparent 53%);
- animation: star-burst 420ms ease-out forwards;
- pointer-events: none;
-}
-@keyframes star-burst {
- 0% { transform: scale(0) rotate(0deg); opacity: 1; }
- 60% { transform: scale(1.2) rotate(35deg); opacity: 0.9; }
- 100% { transform: scale(1.4) rotate(45deg); opacity: 0; }
-}
-```
+## Voice range
-## Motion direction
+Warm, smart, casual, direct. Sentence case, verbs over nouns, confident without being knowing, never condescending. Honest numbers only, never big-number theatre. Never: revolutionize, supercharge, unlock, leverage, unleash, transform, journey, holistic, mindful, ecosystem, platform, AI-powered, intelligent. The alive feeling comes from motion and colour, not from breathless copy.
-Hum's motion stack is **the loudest in the catalog**. Almost every interactive element does something on hover or first-paint.
+## How Hum differs from its neighbours
-| Element | Motion |
+| vs | difference |
|---|---|
-| Primary CTA (push) | lift 2px on hover (the colour edge grows), press DOWN 3px on `:active` (edge shrinks to 1px); snappy `cubic-bezier(0.2,0.7,0.3,1)`. No scale, no wobble - the press is the feedback |
-| Cards | lift 4px + shadow brighten + accent tint deepen on hover (220ms `--ease-spring`) |
-| Counters | tick-up on view-enter (1200ms, snappy ease-out) + scale pulse on completion |
-| Character mark | pulse at rest (4s gentle scale 1 → 1.04 → 1); star-burst on relevant CTA click |
-| Section headings | translateY(12px → 0) + opacity 0 → 1 on view-enter, 600ms, 80ms stagger |
-| Star-burst | 420ms, fires once on primary action complete |
-| Scroll | Lenis (`duration: 0.8, lerp: 0.10` - a soft, slightly elastic glide for the playful feel) |
+| **Coral** (closest sibling) | Coral is warm-grey paper with one restrained coral accent, motion optional. Hum uses coral only as its pop, on yellower cream, with two other accents and motion everywhere. Coral is friendly-but-quiet; Hum is exuberant. A brief wanting one restrained accent routes to Coral. |
+| **Bloom** | Bloom is dark or cream with warm radial blooms behind the content. Hum is fully light, no blooms, and its energy is in interaction rather than atmosphere. |
+| **Arcade** (playful sibling) | Arcade is violet-black CRT, pixel type, zero-blur hard shadows, magenta and cyan. Hum is daylight cream, rounded sans, soft lifting shadows. Same cluster, opposite build. |
+| **Specimen** | Specimen is italic-serif on warm oat, classical. Hum is rounded sans on cream with a drawn mark. Opposite registers. |
-Available easings:
-- `--ease-spring: cubic-bezier(0.34, 1.56, 0.64, 1)` (bouncy overshoot - the signature Hum easing, for MICRO press/pop interactions only; hero entrances stay bounce-free everywhere, per hero-discipline.md)
-- `--ease-snap: cubic-bezier(0.22, 1, 0.36, 1)` (easeOutExpo - for tick-ups and reveals)
-- `--ease-out`, `--ease-in-out` (standard fallbacks)
+## When the brief routes here
-`prefers-reduced-motion: reduce`:
-- Spring hovers collapse to opacity/colour transitions only (no scale, no rotate, no wobble).
-- Counters render at final value instantly.
-- Character mark stops pulsing (stays at final state).
-- Star-burst disabled entirely.
+*daily · habit · streak · practice · learning · curiosity · mood · energy · friendship · community · kids · family · game · puzzle · creative · indie tool · character · mascot · playful · alive*. Categories: learning platforms, habit trackers, daily-thing apps, friendship and community apps, creative tools with character, kids' and family software, mood and wellness apps, indie creative SaaS. Tone: warm, alive, smart-but-warm, energetic, joyful.
-The page must remain delightful with reduced motion - restraint, not breakage.
+Briefs about enterprise, infrastructure, B2B, APIs, inference, dashboards, manifestos, galleries, or monographs never route to Hum.
-## Required dependencies
+## Build hint
```html
<link rel="preconnect" href="https://fonts.googleapis.com" />
@@ -170,185 +109,6 @@ The page must remain delightful with reduced motion - restraint, not breakage.
<link href="https://fonts.googleapis.com/css2?family=Plus+Jakarta+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet" />
```
-Two families. No third. No serif anywhere.
-
-**Optional:** Lenis 1.3.23 for smooth scroll - recommended but not mandatory. Hum reads correctly without it; add when the brief calls for premium polish.
-
-## Macrostructure affinity
-
-**Hum loves these.**
-
-- **Marquee Hero** - canonical: big "today's thing" card centred, big CTA below, character mark anchored to one side
-- **Bento Grid** - multi-accent tiles, one accent per tile; the bento is Hum's natural shape
-- **Workbench** - when the page has a live demo (small product preview surrounded by playful chrome)
-- **Stat-Led** - big rounded counters carry the story
-- **Catalogue** - a grid of items where each tile uses a different accent (color-shift gallery)
-- **Narrative Workflow** - a numbered process-timeline spine (`1.0 → 2.0 → 3.0 → 4.0`): each stage owns its own accent band, the big rounded stage numerals ride the counter signature, and a connecting rail makes the sequence the page's structure. Works well for a guided-sourdough-style build. Reach for it when the product is *genuinely sequential* - recipes, learn-a-skill, onboarding, multi-week programs, anything that happens in ordered steps over time. Don't force it on one-moment tools (those want Marquee or Stat-Led).
-
-## Macrostructure rejection
-
-**Hum refuses these.**
-
-- **Long Document** - Hum is not a 2,000-word essay theme
-- **Manifesto** - too serious; Coral or Atelier handle subdued
-- **Quote-Led** - too literary
-- **Type Specimen** - typography is rounded sans only; specimens want range
-- **Photographic** - Hum is pure shape + colour; photography can appear in a tile but never as a section's spine
-
-## Layout & emphasis discipline (non-negotiable)
-
-Two bugs appeared in early Hum builds and must never ship again.
-
-### Section alignment - one content shell, identical edges
-
-Every section's content must align to the **exact same left and right edges**, whether or not the section sits on a tinted band. The early bug: banded sections (`.section--band`) put their gutter padding on the band while plain sections put `max-width + padding` on themselves, so band content was ~one-gutter wider than plain content and the edges didn't line up.
-
-**The rule:** one shell width model everywhere. The band provides *only* the background + block padding; the inner content carries the gutter.
-
-```css
-:root { --shell: var(--page-max); } /* one number, every section obeys it */
-
-/* plain section: capped box, gutter inside (border-box) */
-.section { max-width: var(--shell); margin-inline: auto; padding: var(--section-gap) var(--page-gutter); }
-
-/* banded section: full-bleed background, NO inline padding on the band itself */
-.section--band { max-width: none; padding-inline: 0; }
-.section--band > * { max-width: var(--shell); margin-inline: auto; padding-inline: var(--page-gutter); }
-```
-
-With global `box-sizing: border-box`, plain-section content and band content are now both `--shell` minus two gutters, both centred - edges match to the pixel. **Verify it:** the hero headline's left edge, a plain section's heading, and a banded section's heading must all sit on the same vertical line. If they don't, this rule was broken.
-
-### Emphasis highlight - must follow the text, never a floating bar
-
-The highlighter behind an emphasised word (`<em>` / `.hl`) and behind big display numbers must be painted as a **clipped background gradient on the text itself**, not an absolutely-positioned `::after` bar. The early bug: the `::after` bar only underlined the last line when the phrase wrapped, and drifted out of place at some sizes.
-
-**The rule:** use a `background-image` highlighter with `box-decoration-break: clone` so it tracks the text across line breaks and scales with font-size automatically.
-
-```css
-em, .hl {
- color: inherit;
- background-image: linear-gradient(var(--hl, oklch(86% 0.18 95 / 0.55)) 0 0);
- background-repeat: no-repeat;
- background-size: 100% 0.32em; /* band thickness, em-relative → scales with type */
- background-position: 0 82%; /* sits just under the baseline */
- -webkit-box-decoration-break: clone;
- box-decoration-break: clone; /* underline every wrapped line, not just the last */
- padding-bottom: 0.02em;
-}
-/* per-accent: set --hl on the element (pear default; coral/cyan/lav/mint as needed). */
-```
-
-This never breaks on wrap, never needs `white-space: nowrap`, and the band always sits correctly under the word. For a giant single-token display number (e.g. a Stat-Led hero count) the same technique applies - `background-size: 100% 0.14em; background-position: 0 88%` reads as a thick underline beneath the figure.
-
-## Not-AI discipline - make every build read as a different studio (non-negotiable)
-
-The fastest way Hum slides into AI-slop is **sameness**: many products sharing one skeleton below the hero. The *component* system (buttons, the highlight, tokens, the press metaphor) **should** be shared - that is a design system, and it's the right kind of consistency. The *page architecture* must **not** be shared. Two Hum builds have to read as two different studios' work, not two colour-swaps of one template.
-
-**Study these real sites for how the register stays hand-made** (each cited for one specific move):
-- **PostHog** - the closest production analog to Hum: cream `#EEEFE9`, ink applied *at opacity* (90% body / 95% link / 100% hover) not as new hexes, **dashed-rule** section dividers, a mascot with a strict model sheet, and a self-aware "shameless plug" section. Steal the discipline wholesale.
-- **Brilliant** (Koto 2024) - shape-DNA shared between the wordmark and the spot illustrations. **Duolingo** - every character built from three primitives (rounded rect, circle, rounded triangle). **Family** - one springy, *scrubbable* number that's a toy. **Cosmos** - layered, captioned image *clusters*, never a tidy grid. **Daylight** - a warm palette deployed as a *system*, not a vibe. **Multiverse** - a split-screen hero instead of the centred stack. **Stripe** - restraint as craft (one gradient, narrow columns, layered soft shadows). **Linear** - hierarchy by scale-jump; the feature demonstrates itself.
-
-### The deadliest tells - forbidden by default
-- **The centred hero stack** (eyebrow/badge → centred H1 → two-line subhead → filled + ghost CTA, dead-centre). The single biggest tell. Default to an *off-centre* hero; only centre when one element deliberately breaks the grid.
-- **A badge-pill directly above the H1** ("✨ now with…"). Never.
-- **The 3-identical-accent-cards row** (icon-tile on top → title → two grey lines, ×3, equal gap). Already banned in Anti-patterns - but it's the reflex unit, so it keeps reappearing. If you have three things to say, say them in a *different shape*: zig-zag text/art rows, one big + two small, a numbered list, a horizontal scroll-rail, a comparison table.
-- **Uniform radius + one shadow on everything.** Give each build its own card *physics* (see levers).
-- **An accent stripe on a card's top/left edge** - reads as AI almost as reliably as em-dashes.
-- **Emoji standing in for icons.** Hum draws its marks in CSS/SVG; an emoji in a chip or nav is a tell.
-- **An all-caps grey eyebrow over *every* section** - use it sparingly, not as wallpaper.
-- **A decorative gradient on the background AND the headline AND the button** (Hum bans accent-to-accent gradients anyway; never stack one three ways).
-
-### Kill the shared tail (the highest-leverage rule)
-No two Hum builds may share the same **back half**. The failure mode is a bespoke hero bolted onto an identical *features → 3-up testimonials → 3-tier-pricing → statement-footer* run. Vary, per build:
-- **Pricing** - three tiers is *one* option. Also: a single honest price line; a free-vs-paid inline toggle; price folded into the product/catalogue surface; or no pricing at all (a "start" strip instead).
-- **Social proof** - quote-cards-×3 is *one* option. Also: a single big pull-quote; a marquee of names; an inline stat+quote; a screenshot of real usage. The byline grammar "Name · metric" on every card is itself a tell - vary it.
-- **Footer** - rotate the footer archetype. Don't ship the same giant-statement + `auto 1fr 1fr 1fr` meta grid every time. A compact single row, a marquee, or a footer that reuses the build's own artefact are all fair.
-
-### Variety levers - pick a *different* combination each build (independent of palette)
-1. **Hero archetype** - rotate: off-centre artefact-bleed · split-screen (value centre, art flanks) · text-left/art-right · art-LEFT/text-right · full-bleed colour-block with an overlapping product card · art-above-headline. Never default to centred-stack.
-2. **The "one highlighted word in the headline"** is now in *every* existing build - it has become a tell. Use it in some; in others carry emphasis by scale, a drawn underline, or colour-blocking the whole line.
-3. **Feature-block format** - commit to ONE non-default shape per build (zig-zag · big+small · dense linked index · table · numbered narrative).
-4. **Density rhythm** - alternate airy sections with one deliberately dense "everything" section; don't hold `--section-gap` constant top-to-bottom.
-5. **Card physics** - choose a personality per build: hairline-flat no-shadow (quiet/editorial) · chunky 28px + the button's hard edge-shadow (kids/toy) · borderless tinted blocks · Stripe-soft single layer · layered contact+ambient. Not `20px + 1.5px rule + --shadow-card` every time.
-6. **Divider / seam** - dashed rules · full-bleed colour-block edges · whitespace only · a thin top accent rule. One language per build.
-7. **Colour deployment** - same palette, different distribution: cream-dominant with tiny accent *punctuation* (PostHog) · bold full-section colour-blocking (one accent owns a whole section) · one accent gradient used exactly once. Distribution changes the feel more than the hues.
-8. **Mascot dose & placement** - one character moment, but rotate where: hero-bleed · peeking from a card corner · an empty-state · the footer · a scroll-triggered cameo.
-9. **Motion register** - spring-bouncy overshoot · calm-eased · one signature scrubbable/draggable toy (Family). Pick one; don't fade-in everything.
-
-### Two requirements every build must meet
-- **One off-grid / asymmetric moment** - a card that breaks the gutter, an oversized numeral bleeding off-edge, a 2/3-1/3 split, a tilted element. The page must not be one centred column of equal blocks. (Bubble's numbered rail is the current best example.)
-- **One "designed exception"** - a single deliberate rule-break that says a human made this: a self-aware copy aside (PostHog's deadpan), an interactive toy (Family's scrub), a hand-drawn annotation over a clean shot, one tilted off-grid card, a full-bleed photo/colour break. Rotate which kind across builds.
-
-### Micro-craft that reads hand-made
-- **Modify ink with opacity, not new hexes** - body ~88-90% of `--color-ink`, links 95%, hover 100%. Fewer literal colours, used consistently.
-- **Layer shadows** (a tight contact shadow + a soft ambient one), varied by elevation - never one `--shadow-card` on everything.
-- **Tight tracking on display, sentence case, ≤3 type levels.** Big heads get negative letter-spacing; body stays neutral.
-- **Voice:** max one em-dash per paragraph (the em-dash pile-up is the clearest "AI wrote this" tic - prefer periods). Honest metrics only; never decorative big-number theatre.
-
-## Voice fixtures
-
-Hum voice is **warm, smart, casual, direct**. Sentence case is allowed (unlike Lumen's full lowercase). Verbs over nouns. Confident but not knowing. Never condescending.
-
-Headlines:
-
-- "Your daily 30-second curio."
-- "Get really good at one thing this quarter."
-- "Notice yourself, in 30 seconds."
-- "Learn something genuinely new today."
-- "A small daily thing, kept for a long time."
-
-Body patterns:
-
-- "One small interesting thing, every morning at 8 a.m."
-- "Free for the first seven days. $5 a month after that, or $45 a year."
-- "Made by three people in Lisbon and Amsterdam. We're answering email."
-
-Mono labels - UPPERCASE, used for ordinals, stats, and tags:
-
-- `01 · TODAY`
-- `02 · YOUR STREAK`
-- `STREAK · 47 DAYS`
-- `LEARNED · 312 THINGS`
-
-**Never any of:** revolutionize, supercharge, unlock, leverage, unleash, transform, journey, holistic, mindful, ecosystem, platform, AI-powered, intelligent. The "feels alive" must come from *motion and colour*, not from breathless copy.
-
-## Anti-patterns (theme-specific)
-
-- **NEVER serif anywhere.** Display, body, captions - all rounded sans. If a serif is needed, the brief belongs in Lumen or one of the editorial themes.
-- **NEVER pure white paper.** Cream `oklch(97% 0.012 95)` is the only acceptable ground. Pure white drains all the warmth out of the theme.
-- **NEVER pure black ink.** `oklch(20% 0.012 250)` minimum lightness. Pure black on cream is harsh and breaks the warmth.
-- **NEVER square corners on cards / pills / buttons.** Hum is the rounded theme. Cards = 20px, pills = 999px, inputs = 12px.
-- **NEVER single-accent palette.** Hum is multi-accent. If a build wants one restrained accent only, it should route to Coral (single-accent modern-minimal) instead.
-- **NEVER gradients between accents.** Pear-to-cyan or cyan-to-coral gradients are banned. Each accent owns its own surface.
-- **NEVER over-rotate animations.** One signature character pulse + one CTA wobble per page. Bouncy easings on everything is exhausting; reserve spring for primary actions.
-- **NEVER `font-style: italic` for the verb landmark.** Hum is not Lumen - verbs aren't italicised here. Emphasis comes from weight (500) or accent color, not italics.
-- **NEVER invented metrics.** Streak counts must be honest (the user's actual data). Marketing stats must be real.
-- **NEVER pure-rainbow gradient backgrounds.** Multi-accent ≠ Y2K rainbow. Each accent has its own surface; they sit next to each other in defined regions.
-- **NEVER three-feature-card row with stock-icon tops.** Use abstract shape characters per card, not generic Lucide icons.
-- **NEVER bento with > 8 tiles.** Hum's bento is small and warm, not maximalist.
-
-## How Hum differs from neighbouring themes
-
-| vs | difference |
-|---|---|
-| **Coral** (modern-minimal, the closest sibling) | Coral is warm-grey paper with a single restrained coral accent - Stripe-not-Linear register, motion optional. Hum uses coral only as its pop accent, on yellower cream with two other accents and mandatory motion. Coral is the friendly-but-quiet register (a quiet bakery card); Hum is exuberant and alive (a brilliant.org-style learning app). When a brief wants one restrained accent, route to Coral; when it wants multi-accent and a character moment, route to Hum. |
-| **Bloom** (atmospheric) | Bloom is dark/cream with warm radial blooms behind the content (Suno register). Hum is fully light, no blooms, mandatory hover-and-paint motion. Different genres entirely. |
-| **Specimen** (editorial) | Specimen is italic-serif on warm oat with classical typography. Hum is rounded sans on cream with vibrant character. Opposite registers. |
-
-## Test brief expectations
-
-Hum should be a candidate when the brief mentions:
-
-- *daily, habit, streak, practice, learning, curiosity, mood, energy, friendship, community, kids, family, game, puzzle, creative, indie tool, character, mascot, fun, playful, alive*
-- product categories: *learning platforms, habit trackers, daily-thing apps, friendship apps, creative tools (with character), kids' / family software, mood / energy / wellness apps, indie creative SaaS*
-- emotional tone: *warm, alive, smart-but-warm, energetic, considered but joyful, post-Brilliant*
-
-Briefs that say *enterprise, infrastructure, B2B, API, inference, agent, dashboard, manifesto, gallery, monograph* never route to Hum.
-
-## Build hint
-
-The first 24 lines of CSS should establish Hum's anchor moves:
-
```css
body {
background: var(--color-paper); color: var(--color-ink);
@@ -357,47 +117,27 @@ body {
font-variant-numeric: tabular-nums;
}
-.eyebrow, .mono-label {
- font-family: var(--font-label); font-size: 11px; letter-spacing: 0.10em;
- text-transform: uppercase; color: var(--color-ink-2); opacity: 0.75;
+h1, h2, h3 { font-weight: 600; letter-spacing: -0.025em; }
+
+.mono { /* captions, meta, units, ordinals - never a kicker */
+ font-family: var(--font-label); font-size: 11px;
+ letter-spacing: 0.10em; text-transform: uppercase; opacity: 0.75;
}
-.btn { /* push - a solid colour EDGE + a soft ground shadow. Never a negative spread, never scale(). */
+.btn { /* the press: a solid colour EDGE plus a soft ground shadow. No negative spread, no scale() */
background: var(--color-accent); color: var(--color-ink); font-weight: 600;
- padding: 0.8rem 1.4rem; border: 0; border-radius: var(--radius-pill); cursor: pointer;
+ border: 0; border-radius: var(--radius-pill); cursor: pointer;
box-shadow: 0 4px 0 0 var(--color-accent-deep), 0 6px 12px -3px oklch(76% 0.20 95 / 0.45);
transition: transform 140ms cubic-bezier(0.2,0.7,0.3,1), box-shadow 140ms cubic-bezier(0.2,0.7,0.3,1);
}
.btn:hover { transform: translateY(-2px); box-shadow: 0 6px 0 0 var(--color-accent-deep), 0 12px 22px -4px oklch(76% 0.20 95 / 0.45); }
-.btn:active { transform: translateY(3px); box-shadow: 0 1px 0 0 var(--color-accent-deep); } /* the press is the feedback */
+.btn:active { transform: translateY(3px); box-shadow: 0 1px 0 0 var(--color-accent-deep); }
-/* cards MAY keep the spring lift (the retirement was buttons only); vary the physics per build */
-.card {
- background: var(--color-paper); border-radius: var(--radius-card);
- box-shadow: 0 12px 32px -16px oklch(20% 0.012 250 / 0.12);
- transition: transform 220ms var(--ease-spring), box-shadow 220ms;
+em, .hl { /* the band follows the text across every wrapped line */
+ background-image: linear-gradient(var(--hl, oklch(86% 0.18 95 / 0.55)) 0 0);
+ background-repeat: no-repeat; background-size: 100% 0.32em; background-position: 0 82%;
+ -webkit-box-decoration-break: clone; box-decoration-break: clone;
}
-.card:hover { transform: translateY(-4px); }
```
-Those lines carry 50% of the theme. The rest is the character moment + the multi-accent section bands + the motion stack.
-
-## What Hum refuses (restated)
-
-Disqualifiers - if any appears in a Hum build, it is not Hum:
-
-- No serif anywhere.
-- No pure white paper.
-- No pure black ink.
-- No square corners.
-- No single-accent palette.
-- No gradients between accents.
-- No more than one CTA wobble per page.
-- No more than one character moment per page.
-- No `font-style: italic` for emphasis.
-- No invented metrics.
-- No rainbow gradient backgrounds.
-- No generic stock-icon feature rows.
-- No bento with > 8 tiles.
-- No system-font fallback for the display.
-- No motion-less interactive elements (every interactive element has SOME state response).
+Those tokens carry the theme. What gets built out of cream, three accents, and a press is the brief's business, not Hum's.
diff --git a/skills/hallmark/references/themes/ledger.md b/skills/hallmark/references/themes/ledger.md
index d25209b..15d4e26 100644
--- a/skills/hallmark/references/themes/ledger.md
+++ b/skills/hallmark/references/themes/ledger.md
@@ -1,121 +1,79 @@
# Theme - Ledger
-Modern-minimal, fintech-terminal register. The page for **treasury software, a business bank, a payments API, an accounting or reconciliation product, a finance dashboard**: the Mercury / Ramp school, or Bloomberg density tamed. A dark navy instrument panel, ruler-drawn hairlines, exactly ONE teal signal on the figures that matter, and **data as the hero**: a reconciled balance and a live ledger, not a hero illustration. It reads like a closed book at 06:00 UTC: precise, calm, audited.
+Modern-minimal, fintech-terminal register: the Mercury and Ramp school, or Bloomberg density tamed. A dark navy instrument panel, ruler-drawn hairlines, exactly one teal signal on the figures that matter, and numbers set like a printed statement. It reads like a closed book at 06:00 UTC: precise, calm, audited.
-Loaded eagerly by SKILL.md Step 3 whenever the catalog pick is `ledger`. The OKLCH palette + font stack live in [`site/css/tokens.css`](../../../../site/css/tokens.css) under `[data-theme="ledger"]`. Reference build: [`site/examples/ledger-01/`](../../../../site/examples/ledger-01/) (a treasury landing whose hero is an account panel: reconciled balance, sparkline, live transaction table).
+The material, in one line: **flat navy, hairlines, tabular mono, and one teal on the figures that matter.**
-> **The one dark option in the modern-minimal cluster.** Coral and Cobalt own the light lane; Ledger fills the dark, data-as-hero fintech slot. It is dark but **not atmospheric** (that is Midnight): no glow, no bloom, no serif, no thin display. Flat navy, tabular numerals, teal on the positive figures. An instrument panel, not a mood.
+> **The one dark option in the modern-minimal cluster.** Coral and Cobalt own the light lane; Ledger fills the dark slot. It is dark but **not atmospheric** (that is Midnight): no glow, no bloom, no serif, no thin display. An instrument, not a mood.
## Axes (diversification)
-- **Paper band** - **dark navy** (`--color-paper` `L 20%`, hue 255, chroma 0.025), lifted a hair to `--color-paper-2` (`L 24%`) for cards and a subtle top-band gradient under the nav. A cool terminal ground, distinct from Midnight's deeper `L 15%` and from every light theme.
-- **Display style** - **grotesk-sans** (`--font-display` Hanken Grotesk `600`, `--tracking-display` `-0.02em`) paired with **tabular mono** (`--font-mono` IBM Plex Mono, `font-variant-numeric: tabular-nums`) on every figure. Not a serif, not a thin display.
-- **Accent hue** - **chromatic teal** (`--color-accent` `oklch(78% 0.12 185)`). A single positive-figure signal, sitting clear of Cobalt's cobalt (256), Midnight's blue (220), and Coral's coral (28). Teal = reconciled, credited, live.
+- **Paper band** - **dark navy** (`--color-paper` `L 20%`, hue 255, chroma 0.025), lifted a hair to `--color-paper-2` (`L 24%`) for raised surfaces and a subtle top-band gradient. A cool terminal ground, distinct from Midnight's deeper `L 15%` and from every light theme. Ink is cool light `L 93%`.
+- **Display style** - **grotesk-sans** (`--font-display` Hanken Grotesk `600`, `--tracking-display` `-0.02em`) paired with **tabular mono** (`--font-mono` IBM Plex Mono) on every figure. Not a serif, not a thin display.
+- **Accent hue** - **chromatic teal** (`--color-accent: oklch(78% 0.12 185)`), a single positive-figure signal sitting clear of Cobalt's 256, Midnight's 220, and Coral's 28. Teal means reconciled, credited, live.
## Reference register
-Mercury · Ramp · Brex · Modern Treasury · Stripe (dashboard) · Bloomberg terminal (density tamed) · Plaid · Mercury Treasury · a business-banking or reconciliation console.
+Mercury · Ramp · Brex · Modern Treasury · Stripe's dashboard · a Bloomberg terminal with the density halved · Plaid. The material to match: a fintech surface where the money is the subject, in tabular mono, with mono meta and status against a flat navy ground. Dense but legible; a terminal you would trust with the close. When in doubt, ask whether this reads like a treasury console a controller signs off on, or like a crypto landing. Keep the former: no neon, no gradients on numbers. Never name any of these in the output.
-The aesthetic: the fintech product landing where **the money is the hero**: a big reconciled balance in tabular mono, a live ledger table, a 30-day sparkline, mono meta and status. Dense but legible; a terminal you would trust with the close. Never name any of these in the output.
+## Typography
-**Patron-saint reference (internal):** *Mercury's calm dark console* + *Bloomberg's tabular density, halved*, recoloured to one teal signal. When in doubt, ask "does this read like a treasury console a controller signs off on, or like a crypto landing?" Keep the former: no neon, no gradients on numbers.
+Two families, no serif anywhere.
-## Required dependencies
+- **Display and body** - Hanken Grotesk 400/500/600/700, display at 600 with `-0.02em` tracking.
+- **Figures** - IBM Plex Mono 400/500 with `font-variant-numeric: tabular-nums`, on **every** number: balances, amounts, spec values, timestamps, deltas. Columns align digit-for-digit or the theme breaks. This is the spine.
+- **Label voice** - IBM Plex Mono, UPPERCASE, tracked `0.06-0.14em`. It sets captions, table headers, meta rows, status chips, units, folios, and a UTC clock. The terminal readout against the Hanken display. It is never a kicker over a heading.
+- **The big figure** is mono, teal, `clamp(2.1rem, 5vw, 3.1rem)`, weight 500, with a small superscript currency mark and faded decimals.
-1. **Fonts** - **Hanken Grotesk** (display + body, 400/500/600/700), **IBM Plex Mono** (all figures, labels, status, meta; 400/500). No serif anywhere. Google Fonts:
- ```html
- <link rel="preconnect" href="https://fonts.googleapis.com" />
- <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
- <link href="https://fonts.googleapis.com/css2?family=Hanken+Grotesk:wght@400;500;600;700&family=IBM+Plex+Mono:wght@400;500&display=swap" rel="stylesheet" />
- ```
-2. **`tabular-nums` everywhere numeric** - `.mono { font-family: var(--font-mono); font-variant-numeric: tabular-nums; }` on the balance, ledger amounts, spec values, meta, clock. Columns must align digit-for-digit; this is the theme's spine.
-3. **A live-feel account panel** - the hero's right column: a pulsing `LIVE` dot, an as-of-UTC timestamp, a reconciled balance, an inline SVG sparkline, and a scrollable ledger `<table>`. Optional one-shot count-up of the balance on load, then static; gates behind `prefers-reduced-motion`.
+## Material
-## Signature moves
+- **One teal signal, under 5% of any viewport** - positive amounts, the headline figure, a live dot, an operational bullet, and the one solid teal button. Everything else is `--color-ink` or `--color-muted` on navy. **Debits are never red**; they are simply muted. Teal is the only chromatic colour on the page.
+- **Hairlines plus one surface tier carry depth.** 1px `--color-rule` borders draw every edge; raised surfaces sit on `--color-paper-2` with a single deep `--shadow-card`. No glow, no inner gradients, no blur-as-depth.
+- **Tight instrument radii** - `--radius-card` 12px, `--radius-input` 8px. Never a pill, never zero.
+- **Rows, not tiles.** Repeated data reads as ruled rows in a real `<table>`: right-aligned amounts, a hairline under each row, a hover that lifts the row to `--color-paper-3`.
+- **Charts stay quiet.** An inline SVG line in teal over a fade-to-transparent fill, no axes, no grid, no second colour. Anything beyond that is [`data-viz.md`](../data-viz.md).
-1. **Data-as-hero account panel, not an illustration** - the hero's right column is a `--color-paper-2` card (`--radius-card` 12px, one hairline `--color-rule`, a deep soft `--shadow-card`) holding a head row (`OPERATING · USD · ****4471` + a `LIVE` status), a reconciled balance, a sparkline, and a live ledger. Title + lede sit LEFT, panel RIGHT: asymmetric Stat-Led, never centred.
-
-2. **The reconciled balance is the biggest thing on the page** - `--font-mono`, `tabular-nums`, `--color-accent` teal, `clamp(2.1rem, 5vw, 3.1rem)`. A small `$` cur superscript, faded `.09` decimals. Under it a mono meta line: `Reconciled balance · as of 06:00 UTC · +$18,204.55 today` with the delta in teal.
-
-3. **A live ledger table** - a real `<table>` in mono/`tabular-nums`: Time, Description, Amount (right-aligned). Credits teal (`.pos`), debits `--color-muted` (`.neg`), a `matched` pill per row, hover raises the row to `--color-paper-3`. This is the second hero, not a decorative dashboard.
-
-4. **One teal signal, on the figures that matter** (< 5% of any viewport) - positive amounts, the balance, the `LIVE` dot, the "all systems operational" bullet, and the **one** solid teal CTA (`Open an account`, `--color-accent-ink` dark text). Everything else is `--color-ink`/`--color-muted` on navy. Debits are never red; they are just muted.
-
-5. **The 30-day sparkline** - an inline SVG line in teal over a fill that fades teal → transparent, captioned `30-DAY RECONCILED BALANCE`. One quiet chart that reads a real series, no axes, no grid, no second colour.
-
-6. **Hairlines and one surface tier carry depth** - 1px `--color-rule` borders draw the nav, panel, table rows, `.section` tops, datasheet, and trust rows. Cards lift on `--color-paper-2` with a single deep `--shadow-card`; no glow, no inner gradients. Depth from borders and one shadow, not blur.
-
-7. **Mono machine-readout labels** - eyebrows, `panel__head`, ledger headers, spec values, footer meta, and a live `UTC 06:00:12` nav clock in IBM Plex Mono, UPPERCASE, `0.06`-`0.14em` tracking. The terminal voice against the Hanken display.
-
-8. **The datasheet, not the pitch** - features render as a dense `<dl>` spec grid ("A datasheet, not a pitch"): `dt` label left in ink, `dd` value right in mono. Trust renders as label/paragraph rows. Ledger argues in specifications, not adjectives.
+**Shapes Ledger suits** (affinities, never requirements): a datasheet - a dense `<dl>` of label-left and mono-value-right, arguing in specifications rather than adjectives; a live ledger table as a focal artefact; a reconciled figure with a mono meta line under it giving the as-of time and the delta.
## Motion
-Composed and near-still. The `LIVE` dot pulses (opacity 1 → 0.4, `2.4s`). Ledger rows shift background on hover; buttons dip `translateY(1px)` on `:active`; nav links and `.tlink` shift border/colour on hover. An optional one-shot balance count-up on load, then static. **No parallax, no autoplay charts, no glow, no number-scrambling on scroll.** Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static, fully visible, animations killed.
-
-## Anti-patterns
-
-- **No atmospheric glow / aurora / mesh / radial bloom / gradient text.** That is Midnight's lane. Ledger is a flat instrument panel: navy + hairlines + one teal.
-- **No pure `#000` / `#fff`.** Dark navy paper (`L 20%`, hue 255), cool light ink (`L 93%`). Even the darkest surface stays chromatic.
-- **No red debits, no second accent.** Debits are `--color-muted`; teal is the only chromatic colour on the page.
-- **No code card / terminal-window hero.** That is Cobalt. Ledger's focal artefact is a financial account panel, not a `POST`/`200 OK`.
-- **No proportional numerals on figures.** Every balance, amount, and spec value is `tabular-nums` mono; columns align or the theme breaks.
-- **No pill / gradient CTAs.** One solid teal button at `--radius-input` (8px) + ghost buttons and `.tlink` typographic links. Name the destination (`Open an account`).
-- **No centred-everything hero, no 3-equal-icon feature grid.** Title-left / panel-right; features are a dense datasheet, how-it-works a numbered 01/02/03 trio.
-- **No fake dashboard clutter** - one sparkline, one ledger, real-looking sample numbers. No donut walls, no gauge rows, no confetti of KPIs. (Chart construction beyond the sparkline: [`data-viz.md`](../data-viz.md).)
-
-## Macrostructure affinity
+Composed and near-still. A live dot pulses (opacity 1 → 0.4 over `2.4s`). Rows shift background on hover; buttons dip `translateY(1px)` on `:active`; links shift border and colour. An optional one-shot count-up of a headline figure on load, then static. No parallax, no autoplay charts, no glow, no number-scrambling on scroll. Everything gates behind `prefers-reduced-motion: no-preference`; reduced motion ships static and fully visible.
-**Ledger loves these.**
+## Do-nots (this theme's own failure modes)
-- **Stat-Led** - deck ingredients: the hero balance panel, a numbered how-it-works trio, the datasheet, one trust row - dealt per macrostructures.md § deck *(canonical - ledger-01)*
-- **SaaS / Product** - fintech landing where the console is the proof
-- **Workbench** - the dashboard-first, tool-shaped page
-- **Comparison / datasheet** - dense spec tables, controller-facing
-- **Marquee** - when the hero is one confident figure and a live feed
+- **Never an atmospheric glow, aurora, mesh, radial bloom, or gradient text, and never pure `#000` or `#fff`.** That is Midnight's lane. Ledger is flat: chromatic navy, hairlines, one teal.
+- **Never a proportional numeral on a figure.** Every balance, amount, and spec value is tabular mono. Misaligned columns break the theme faster than any other error.
+- **Never a red debit and never a second accent.** Debits are muted; teal is alone.
+- **Never a pill or gradient CTA.** One solid teal button at 8px radius, plus typographic links. Name the destination.
+- **Never fake dashboard clutter.** One chart at most, real-looking sample figures, no donut walls, no gauge rows, no confetti of KPIs.
+- **Never an invented statistic.** A figure on a Ledger page is honest or it is not on the page.
-## Macrostructure rejection
+## Voice range
-**Ledger refuses these.**
+Declarative, numeric, audited. Name the figure, the feed, the lock time; let specifications do the arguing. Never: seamless, robust, cutting-edge, leverage, synergy, revolutionary, unlock, supercharge, effortless, game-changing. Never "click here."
-- **Letter** - too intimate; Ledger is a console, not a note
-- **Manifesto** - too loud; Ledger argues in figures, not slogans
-- **Photographic / image-led** - Ledger leads with the balance, not imagery
-- **Long Document** - prose-led; route an editorial theme instead
-
-## Voice fixtures
-
-Declarative, numeric, audited. Name the figure, the feed, the lock time. No hype adjectives.
-
-- *"Treasury, reconciled while you sleep."*
-- *"Wake up to a closed book, not a queue of exceptions."*
-- *"A datasheet, not a pitch."*
-- *"Every figure audits back to the transaction that moved it."*
-- *"Balances lock at 06:00 UTC, every day."*
-
-Never any of: *seamless, robust, cutting-edge, leverage, synergy, revolutionary, unlock, supercharge, effortless, game-changing.* Never "click here." Name the balance, the feed, the control, the number.
-
-## How Ledger differs from neighbouring themes
+## How Ledger differs from its neighbours
| vs | difference |
|---|---|
-| **Cobalt** (light code-hero sibling) | Cobalt is cool near-white paper (`oklch(98.5% 0.004 250)`), electric cobalt (`0.20 256`), Space Grotesk / JetBrains Mono, and a **code/API card** hero. Ledger is dark navy (`oklch(20% 0.025 255)`), teal (`0.12 185`), Hanken / IBM Plex Mono, and an **account-panel** hero. Light-vs-dark and code-vs-money settle it: same cluster, opposite ground, different focal artefact. |
-| **Midnight** (dark but atmospheric) | Both are dark near hue 250, but Midnight is **atmospheric**: deeper `L 15%`, blue accent (`0.16 220`), Geist + Instrument Serif, `--display-weight 300` with `0.16em` labels, numbered display + typewriter reveals. Ledger is **modern-minimal**: lifted `L 20%` navy, teal 185, Hanken `600`, tabular-mono data panels, flat and still. Mood vs instrument. |
-| **Coral** (light warm modern-minimal) | Coral is warm-grey paper (`oklch(96.5% 0.005 50)`), warm coral accent (`0.165 28`), Geist, `--radius-pill 999px` soft pills, and a quiet title/lede hero. Ledger is dark navy, teal, `12px card / 8px control radii, and a data-as-hero panel. Opposite temperature and opposite ground. |
+| **Cobalt** | Cobalt is cool near-white paper (`oklch(98.5% 0.004 250)`), electric cobalt (`0.20 256`), Space Grotesk and JetBrains Mono, and code as its focal material. Ledger is dark navy (`oklch(20% 0.025 255)`), teal (`0.12 185`), Hanken and IBM Plex Mono, and money as its focal material. Same cluster, opposite ground. |
+| **Midnight** | Both are dark near hue 250, but Midnight is **atmospheric**: deeper `L 15%`, blue accent (`0.16 220`), Geist plus Instrument Serif, `--display-weight 300` with `0.16em` labels, typewriter reveals. Ledger is **modern-minimal**: lifted `L 20%` navy, teal 185, Hanken 600, flat and still. Mood vs instrument. |
+| **Coral** | Coral is warm-grey paper (`oklch(96.5% 0.005 50)`), warm coral (`0.165 28`), Geist, `--radius-pill 999px`. Ledger is dark navy, teal, 12px and 8px radii. Opposite temperature, opposite ground. |
+| **Terminal** | Terminal is green-black with mono for everything including body, a reading surface. Ledger keeps mono for figures only and sets its prose in a grotesk. Editor vs console. |
-## Test brief expectations
+## When the brief routes here
-Ledger should be a candidate when the brief mentions:
+*treasury · banking · fintech · payments · reconciliation · ledger · accounting · close · audit · balance · cash management · finance dashboard · payouts · settlement · compliance · SOC 2 · controller · CFO*. Categories: business banks, treasury software, payments APIs, accounting and reconciliation tools, finance dashboards, fintech SaaS. Tone: precise, audited, calm, trustworthy, dense-but-legible, terminal, dark.
-- *treasury · banking · fintech · payments · reconciliation · ledger · accounting · close · audit · balance · cash management · finance dashboard · payouts · settlement · compliance · SOC 2 · controller · CFO*
-- Product categories: *business bank · treasury OS · payments API · accounting / recon tool · finance dashboard · fintech SaaS*
-- Emotional tone: *precise · audited · calm · trustworthy · dense-but-legible · terminal · instrument-panel · dark*
-
-Briefs that are warm / consumer / editorial / image-led route elsewhere (Coral for warm SaaS, Cobalt for dev tools, the editorial themes for content). When the brief is finance and wants to *show the numbers*, it is Ledger.
+Warm, consumer, editorial, or image-led briefs route elsewhere. When the brief is finance and wants to show the numbers, it is Ledger.
## Build hint
-The first lines of CSS establish Ledger's anchor moves:
+```html
+<link rel="preconnect" href="https://fonts.googleapis.com" />
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+<link href="https://fonts.googleapis.com/css2?family=Hanken+Grotesk:wght@400;500;600;700&family=IBM+Plex+Mono:wght@400;500&display=swap" rel="stylesheet" />
+```
```css
html, body { overflow-x: clip; }
@@ -124,27 +82,22 @@ body { background: linear-gradient(180deg, var(--color-paper-2) 0%, var(--color-
font-family: var(--font-body); font-weight: 400; }
/* Every figure is tabular mono - the theme's spine */
-.mono, .balance, .ledger, .spec__row dd {
- font-family: var(--font-mono); font-variant-numeric: tabular-nums; }
-.pos { color: var(--color-accent); } /* credits + the one signal; debits stay muted */
-
-/* The account panel - one surface, one hairline, one deep shadow (no glow) */
-.panel { background: var(--color-paper-2); border: 1px solid var(--color-rule);
- border-radius: var(--radius-card); box-shadow: var(--shadow-card); overflow: clip; }
-.balance { color: var(--color-accent); font-weight: 500; letter-spacing: -0.02em;
- font-size: clamp(2.1rem, 5vw, 3.1rem); line-height: 1; }
-
-/* Live ledger rows lift on hover - no red, ever */
-.ledger td { border-bottom: 1px solid var(--color-rule); color: var(--color-ink-2); }
-@media (hover: hover) { .ledger tbody tr:hover td { background: var(--color-paper-3); } }
-
-/* Bordered sticky nav + the one teal button (8px, never a pill) */
-.nav { border-bottom: 1px solid var(--color-rule); backdrop-filter: blur(14px); }
+.mono { font-family: var(--font-mono); font-variant-numeric: tabular-nums; }
+.pos { color: var(--color-accent); } /* credits and the one signal; debits stay muted, never red */
+
+/* Raised surfaces: one hairline, one deep shadow, no glow */
+.raised { background: var(--color-paper-2); border: 1px solid var(--color-rule);
+ border-radius: var(--radius-card); box-shadow: var(--shadow-card); }
+
+/* Ruled data rows lift on hover */
+td { border-bottom: 1px solid var(--color-rule); color: var(--color-ink-2); }
+@media (hover: hover) { tbody tr:hover td { background: var(--color-paper-3); } }
+
+/* The one teal button - 8px, never a pill */
.btn--accent { background: var(--color-accent); color: var(--color-accent-ink);
border-radius: var(--radius-input); }
-.dot { animation: pulse 2.4s ease-in-out infinite; }
@media (prefers-reduced-motion: reduce) { *, *::before, *::after { animation: none !important; } }
```
-Plus the Hanken Grotesk + IBM Plex Mono link and the small pulse/count-up script. Reference build: [`site/examples/ledger-01/`](../../../../site/examples/ledger-01/) - match its register (tokens, voice, motion feel), never its composition; reusing its section order, hero geometry, or grid is a gate-32-grade repeat.
+Ledger supplies the navy, the hairlines, the tabular spine, and the one teal. Which figures earn the page is the brief's business, not the theme's.
diff --git a/skills/hallmark/references/themes/lumen.md b/skills/hallmark/references/themes/lumen.md
index ff96721..77d0120 100644
--- a/skills/hallmark/references/themes/lumen.md
+++ b/skills/hallmark/references/themes/lumen.md
@@ -1,32 +1,28 @@
# Theme - Lumen
-Premium AI-tool register, built around a **hand-engineered apparatus** rather than a glowing orb. One precision SVG/CSS object per page, with leader-line callouts in mono micro-type, set against dead space alongside a **lowercase classical-serif headline** and a technical mono eyebrow. Three font families. Two palette drops (Night Foundry / Day Foundry) with different physics - Night emits, Day refracts - and entirely different visual languages, not the same shape in two colours.
+The premium AI-tool register, built out of **precision optics** rather than glowing orbs. Cool-violet ground, a light source that is either emitted or refracted, a lowercase classical serif, and mono UPPERCASE machine-readout labels. It should feel instrument-grade and after-hours: something a lab built, not something a landing page generated.
-Lumen runs a strict **two-register typography system**: all prose is **lowercase** (hero titles, section titles, lede, body, buttons, nav, brand, footer copy - even acronyms when they appear in body text); all mono labels are **UPPERCASE** (eyebrows, callouts, meter labels, stat labels). The contrast between quiet lowercase prose and loud UPPERCASE machine-readout is the typographic signature.
-
-Loaded eagerly by SKILL.md Step 3 whenever the catalog pick is `lumen`. Palettes + font stack live in [`site/css/tokens.css`](../../../../site/css/tokens.css) under `[data-theme="lumen"]` (Night, default) and `[data-theme="lumen"][data-drop="day"]` (Day). This file carries the drops + apparatus family + signature moves + motion + anti-patterns.
+The material, in one line: **quiet lowercase prose, loud uppercase mono, and one source of light.**
## Axes (diversification)
-- **Paper band** - Night: dark cool-violet (`L 13%, H 265`). Day: light cool bone with violet pull (`L 97%, H 265`). The 265° hue is deliberate - sits 25° from Midnight's 250 and 65° from Aurora's 200, so a Lumen page is not confusable with either neighbour at a glance.
-- **Display style** - **classical-serif-lowercase** (Instrument Serif 400, upright, **all-lowercase**, with verb landmark via accent colour + draw-in underline). No italic anywhere. Distinct from italic-serif (Specimen/Studio/Atelier ship italic as default) and from roman-serif (Newsprint uses sentence case). Lumen is the catalog's only lowercase-headline theme.
-- **Accent hue** - Night: **molten brass** (`H 50`, not amber). Day: **deep indigo with violet tilt** (`H 268`). Coral chord (`H 18`) sits behind both as the secondary chromatic.
+- **Paper band** - Night: dark cool-violet (`L 13%, H 265`). Day: light cool bone with violet pull (`L 97%, H 265`). The 265° hue is deliberate: 25° from Midnight's 250 and 65° from Aurora's 200, so a Lumen page is not confusable with either neighbour at a glance.
+- **Display style** - **classical-serif-lowercase** (Instrument Serif 400, upright, all-lowercase). The catalog's only lowercase-headline theme.
+- **Accent hue** - Night: **molten brass** (`H 50`, not amber). Day: **deep indigo with violet tilt** (`H 268`). A coral chord (`H 18`) sits behind both as the secondary chromatic.
## Reference register
-Modal · Anthropic (Claude product surfaces) · Together AI · ElevenLabs · Cluely · Adept · Granola · Cohere · Inflection · Linear (premium pricing pages) · Vercel (design guidelines, frontier-AI sections) · Cursor (high-fidelity product mockup heroes).
-
-The aesthetic to match: a single hand-engineered artefact in dead space; a lowercase classical-serif headline with one accent-coloured verb; mono UPPERCASE technical labels that read as if pulled from an internal docs site; tabular numerals everywhere a number appears. The combination is what AI-tool defaults do not ship - and exactly the combination that breaks every default the model was trained on.
+Modal · Anthropic · Together AI · ElevenLabs · Cluely · Adept · Granola · Cohere · Linear's premium pricing surfaces · Vercel's frontier-AI sections.
-**Patron-saint reference (internal):** *Modal homepage rate sheet* (the receipt is the artwork) + *Together AI hero diagram* (annotated apparatus + leader lines + labelled callouts) + *Anthropic Claude landing typography* (transitional serif + humanist sans). When in doubt about restraint, ask "would Modal ship this much chrome?" If yes, you've gone too far.
+The material to match: a hand-engineered artefact standing in dead space; a lowercase classical-serif headline carrying one accent-coloured verb; mono UPPERCASE labels that read as if pulled from an internal docs site; tabular numerals wherever a number appears. When in doubt about restraint, ask whether Modal would ship this much chrome. If yes, it is too much.
## Palette drops
-A Lumen drop is a named palette + apparatus-physics pair. The structural signature (italic-pivot headline + mono eyebrow + apparatus + leader callouts + meter strip + blueprint grid + hairline cards + three-stat row) is constant; the drop rotates the canvas, the accent, and what the apparatus *does*.
+A drop is a palette plus a **physics**: what the light on this page is doing. Two drops, not five, because Lumen's identity is the optics rather than the colour, and two drops with different physics carry more variety than five drops with one artefact recoloured.
-### Drop 01 · Night Foundry *(default · canonical)*
+### Drop 01 · Night Foundry *(default)*
-Cool-violet near-black canvas. Molten-brass accent that *emits*. The apparatus is an instrument - a filament-in-chamber, a circuit topology, a precision indicator - and it generates the light. Halos and inner-emit washes use `--color-glow` at 42% opacity.
+Cool-violet near-black canvas, molten-brass accent that **emits**. The light source is contained inside a built object, and a slow pulse suggests the instrument is running.
- `--color-paper: oklch(13% 0.014 265)` - late-night studio, violet tilt
- `--color-ink: oklch(96% 0.006 262)` - near-white headlines
@@ -36,443 +32,114 @@ Cool-violet near-black canvas. Molten-brass accent that *emits*. The apparatus i
- `--color-paper-emit: oklch(76% 0.17 50 / 0.04)` - inner-emit canvas wash
- `--rule-blueprint: oklch(96% 0.006 262 / 0.04)` - grid hairline
-**Apparatus physics - emission.** The focal element is a built object (filament, circuit, indicator dial, layered lens stack) that *contains* the light source. Subtle pulse animation (`--dur-pulse: 4s`) suggests the instrument is *running*. Card shadows are soft depth (`0 24px 60px -28px oklch(0% 0 0 / 0.55)`), not glows - the apparatus is the only thing that emits.
+Shadows are soft depth (`0 24px 60px -28px oklch(0% 0 0 / 0.55)`), never glows: only the light source emits.
-**When to pick:** inference platforms · serverless GPU · model APIs · AI coding agents · voice synthesis · agentic tools · developer infra · anything that wants to feel "after hours" and "instrument-grade." Default.
+**When to pick:** inference platforms, serverless GPU, model APIs, coding agents, voice synthesis, developer infra. Anything that wants to feel after-hours and instrument-grade.
### Drop 02 · Day Foundry
-Cool-bone canvas with a violet pull. Deep indigo accent that *refracts*. The apparatus is a transparent prism / lens stack / chromatic dispersion element - light passes through and is *separated*, not generated. Spectrum exit-fan + measurement annotations + scale bar give it the feel of a calibrated optical instrument, not a vibey gradient.
+Cool-bone canvas with a violet pull, deep indigo accent that **refracts**. Light passes through and is separated rather than generated: a prism, a lens stack, a chromatic dispersion. Static at rest, with a 320ms reveal on first paint and no perpetual motion.
- `--color-paper: oklch(97% 0.008 265)` - cool bone, violet pull
- `--color-ink: oklch(18% 0.014 265)` - near-black, cool
- `--color-accent: oklch(46% 0.24 268)` - deep violet-indigo
-- `--color-accent-2: oklch(68% 0.16 18)` - coral chord (red end of spectrum)
+- `--color-accent-2: oklch(68% 0.16 18)` - coral chord, the red end of the spectrum
- `--color-glow: oklch(58% 0.22 268 / 0.28)` - indigo halo through prism
- `--color-paper-emit: oklch(46% 0.24 268 / 0.03)` - canvas wash, faint
-**Apparatus physics - refraction.** The focal element is *static at rest* with a 320ms reveal on first paint (the prism appears, the spectrum fans, both settle). No perpetual motion. The light is captured, not generated. Annotations carry mono micro-labels: `λ = 612 nm`, `θ_out = 38°`, etc. - the prism reads as a *measurement instrument*, not decoration.
-
-**When to pick:** AI for science · climate / research labs · document AI · typography / design tools · daytime productivity · briefs that want "considered" and "clear" rather than "after-dark and intense."
-
-### Drop rotation rule
-
-The diversification log records `"theme": "lumen", "drop": "night"` (or `"day"`). Two consecutive Lumen builds must use different drops unless the brief contains a strong drop signal.
-
-### Why two drops, not five
-
-Lumen's identity is the apparatus, not the palette. Adding more drops would dilute what makes the theme legible. Two drops with *different physics* (emission vs refraction) carry more variety than five drops with the same artefact in different colours.
-
-## The apparatus family
-
-Lumen's central commitment: **never a generic glowing orb**. The orb is the most overworked AI-tool tell of 2024-2025; every inference platform ships one. Lumen builds a *specific* hand-engineered object per page, chosen to reflect what the product *does*.
-
-The canonical family (pick one per build, in the order of preference for the brief):
-
-### Apparatus type · Filament chamber *(Night Foundry, instrument-grade)*
-
-A vertical glowing rod inside a rounded-rect cylindrical chamber, crossed by 3-4 horizontal hairline "electrodes." Subtle pulse on the filament (3% intensity oscillation, 4s period). References vacuum tubes, Tesla coils, fusion experiments, mass spectrometers. Reads as a *machine*.
-
-**When to pick:** inference, runtime, model serving, anything that *produces* output. Brand verbs: think, run, generate, infer, render, execute.
-
-**SVG/CSS skeleton:**
-
-```html
-<figure class="apparatus apparatus--filament" aria-hidden="true">
- <div class="chamber">
- <span class="chamber__wall"></span>
- <span class="chamber__electrode" style="--y: 22%"></span>
- <span class="chamber__electrode" style="--y: 42%"></span>
- <span class="chamber__electrode" style="--y: 62%"></span>
- <span class="chamber__electrode" style="--y: 82%"></span>
- <span class="chamber__filament"></span>
- <span class="chamber__glow"></span>
- <span class="chamber__stencil">RX-04</span>
- </div>
- <ul class="callouts">
- <li class="callout" style="--side: left; --y: 18%"><span>P50 · 28 ms</span></li>
- <li class="callout" style="--side: right; --y: 36%"><span>cold-start · 0.4 s</span></li>
- <li class="callout" style="--side: left; --y: 62%"><span>rps · 12 k</span></li>
- <li class="callout" style="--side: right; --y: 80%"><span>RX-04 · h100 80gb</span></li>
- </ul>
-</figure>
-```
-
-```css
-.chamber {
- position: relative; width: clamp(180px, 22vw, 280px); aspect-ratio: 0.55;
- border: 1px solid var(--color-rule-2);
- border-radius: 999px;
- background: oklch(17% 0.016 265 / 0.8);
- overflow: hidden;
-}
-.chamber__filament {
- position: absolute; top: 8%; bottom: 8%; left: 50%;
- width: 2px; margin-left: -1px;
- background: linear-gradient(to bottom,
- oklch(96% 0.05 50) 0%,
- oklch(80% 0.17 50) 50%,
- oklch(96% 0.05 50) 100%);
- box-shadow:
- 0 0 16px 4px var(--color-glow),
- 0 0 48px 12px oklch(80% 0.16 50 / 0.22);
- animation: filament-pulse var(--dur-pulse) ease-in-out infinite;
-}
-.chamber__electrode {
- position: absolute; left: 0; right: 0; top: var(--y);
- height: 1px; background: var(--color-rule-2);
-}
-.chamber__glow {
- position: absolute; inset: 0;
- background: radial-gradient(ellipse 60% 50% at 50% 50%, var(--color-glow-2) 0%, transparent 70%);
- pointer-events: none;
-}
-@keyframes filament-pulse {
- 0%, 100% { opacity: 1; }
- 50% { opacity: 0.86; }
-}
-.callout {
- font-family: var(--font-mono);
- font-size: 10.5px;
- letter-spacing: var(--tracking-micro);
- text-transform: uppercase;
- color: var(--color-muted);
- position: absolute;
- /* leader-line drawn as ::before pseudo */
-}
-.callout::before {
- content: ""; position: absolute;
- top: 50%; height: 1px;
- background: var(--color-rule-2);
-}
-```
-
-### Apparatus type · Codebase graph / topology *(Night Foundry)*
-
-An annotated SVG graph: one central node + 5-7 satellite nodes connected by hairlines, each satellite labelled with a mono filename or symbol. Light "flows" along the connecting lines at a slow walk (subtle gradient dot moving along each path). References CAD schematics, dependency graphs, electrical circuits, knowledge graphs.
-
-**When to pick:** AI coding agents, knowledge tools, anything that *traverses* a structured space. Brand verbs: read, trace, explore, connect.
-
-### Apparatus type · Indicator dial / spectrum *(either drop)*
-
-A circular dial (Night) or a horizontal spectrum bar with annotated wavelength labels (Day). Includes scale ticks at known increments, a moving needle or active band, and mono callouts at boundaries. References analogue gauges, oscilloscopes, audio meters.
-
-**When to pick:** voice synthesis, audio AI, anything measuring a continuous quantity. Brand verbs: tune, measure, listen.
-
-### Apparatus type · Prism + measurement *(Day Foundry canonical)*
-
-A clip-path triangle (the prism) + an incoming beam from the left + a chromatic spectrum fan emerging from the right edge + leader-line annotations with wavelength labels and exit-angle measurements. References optical-bench experiments, atmospheric refraction diagrams, the cover of Pink Floyd's *Dark Side of the Moon* re-read as a calibrated instrument.
-
-**When to pick:** Day Foundry default. AI for science, climate, research, document AI.
-
-### Building rules across the family
-
-- **Pure CSS + SVG.** Never `<img>`, never icon fonts, never SVG paths copied from Figma. The apparatus is *constructed*, not *placed*.
-- **One per page.** Never two apparatus objects on a single Lumen build.
-- **Leader-line callouts.** Every apparatus carries 3-5 mono micro-type annotations (`P50 · 28 ms`, `λ = 612 nm`, `→ refunds.ts`) on horizontal leader lines. The callouts MUST contain real values from the brief - never `LOREM · 000`.
-- **Size.** 240-480 px max dimension on desktop. Scales down to ~180 px on mobile but never disappears.
-- **Pulse, not rotation.** Night apparatus *pulses* (3% intensity oscillation, 4s period). It does *not* rotate. Rotation was the orb's signature; the apparatus's signature is that it's clearly machined.
-- **Day Foundry: no perpetual motion.** Day apparatus reveals once on first paint (320ms) and stays static. The light is captured.
-- **`prefers-reduced-motion: reduce`:** all pulses freeze at maximum intensity, all reveals collapse to final state.
-
-## The seven signature moves
-
-A Lumen build must exhibit **all seven**. Skipping any single one is what makes the page slip back into generic-dark-AI territory.
-
-### 1. Hand-built apparatus (no orb)
-
-See § The apparatus family above. The single most important move.
-
-### 2. Lowercase headline with verb-landmark (no italics)
-
-Classical Instrument Serif at `--text-display`, **all-lowercase, upright**, with **exactly one word** rendered in `--color-accent-2` (coral chord) - and that word is the verb. A 1px underline in the same accent draws in over 320ms on first paint and stays. **No `font-style: italic` is used anywhere** in Lumen - the verb landmark is built from colour + line, not from a glyph variation.
-
-```html
-<h1 class="hero__title">built to&nbsp;<em>think</em>&nbsp;in real time.</h1>
-```
-
-```css
-.hero__title {
- text-transform: lowercase; /* defensive - also applied at the prose level */
-}
-.hero__title em {
- font-style: normal; /* explicit - em is repurposed as the verb landmark */
- color: var(--color-accent-2);
- position: relative;
- white-space: nowrap;
-}
-.hero__title em::after {
- content: ""; position: absolute;
- left: 0.05em; right: 0.05em; bottom: 0.04em;
- height: 1px;
- background: var(--color-accent-2);
- transform-origin: left;
- animation: pivot-underline 320ms var(--ease-soft) 900ms backwards;
-}
-@keyframes pivot-underline {
- from { transform: scaleX(0); }
- to { transform: scaleX(1); }
-}
-@media (prefers-reduced-motion: reduce) {
- .hero__title em::after { animation: none; }
-}
-```
-
-**Rules:** the coloured word is the verb, never a noun. One word per headline, never two. The underline is the persistent landmark - once drawn, never animates again. `<em>` is repurposed semantically (still emphasis), but renders without italic.
-
-### 3. Mono eyebrow above every section
-
-`01 · INFERENCE` style - JetBrains Mono, uppercase, 11px, tracking `0.10em`, half-opacity. Numbered roman ordinal (01, 02, 03), middle-dot separator, then the section role. Sits directly above the heading on its own line. Cap at 6 per page.
-
-### 4. Blueprint grid background (4% opacity)
-
-The hero `<section>` and the meter strip both carry a **ruled grid background** at 4% opacity - 32px or 48px square cells, single hairline in `--rule-blueprint`. This is the "engineered, not vibed" signal. Aurora has blooms; Lumen has the grid. The grid sits beneath `--color-paper-emit` so the canvas appears to emit *through* the grid lines.
-
-```css
-.hero {
- background:
- linear-gradient(var(--rule-blueprint) 1px, transparent 1px) 0 0 / 48px 48px,
- linear-gradient(90deg, var(--rule-blueprint) 1px, transparent 1px) 0 0 / 48px 48px,
- radial-gradient(60% 50% at 78% 30%, var(--color-paper-emit) 0%, transparent 65%),
- var(--color-paper);
-}
-```
-
-### 5. Meter strip (below the hero)
+**When to pick:** AI for science, research labs, document AI, typography and design tools, daytime productivity. Briefs that want considered and clear rather than after-dark and intense.
-A full-bleed 32-48px band beneath the hero showing 60-80 thin vertical ticks (1px wide, varying height/opacity). Mono labels at each end name the readout (`SIGNAL · 12.4 KHZ` left, `DRIFT · 0.04 σ` right). Reads as spectrum analyser / oscilloscope output. The values match the brief - never invented.
+**Rotation.** The log records `"theme": "lumen", "drop": "night"` or `"day"`. Two consecutive Lumen builds use different drops unless the brief signals one.
-```html
-<aside class="meter" aria-label="Signal readout">
- <p class="meter__label meter__label--left">SIGNAL · 12.4 KHZ</p>
- <div class="meter__bars">
- <!-- 64 spans, height + opacity per index -->
- </div>
- <p class="meter__label meter__label--right">DRIFT · 0.04 σ</p>
-</aside>
-```
+## Typography
-```css
-.meter {
- display: grid;
- grid-template-columns: auto 1fr auto;
- gap: 1.5rem;
- align-items: center;
- padding: 0.75rem var(--page-gutter);
- border-block: 1px solid var(--color-rule);
- font-family: var(--font-mono);
-}
-.meter__bars { display: flex; gap: 2px; align-items: end; height: 28px; }
-.meter__bars > span {
- flex: 1; min-width: 1px;
- background: var(--color-accent);
- border-radius: 0.5px;
-}
-```
+Three families, three weights each at most.
-The meter MUST be procedurally varied - never a flat row of equal ticks. Heights drawn from a clean envelope (sine, gaussian, log) so the strip reads as a *measurement*, not a decorative pattern.
+- **Display** - Instrument Serif 400, upright, **all-lowercase**. Fallback chain `"Tiempos Headline", ui-serif, Georgia, serif`; never a system font.
+- **Body** - Geist 400/500/600.
+- **Label** - JetBrains Mono 400/500, **UPPERCASE**, tracked `0.08-0.12em`.
-### 6. Hairline cards with inner emission
+**The two-register split is the signature.** All prose is lowercase: headlines, lede, body, buttons, nav, brand, footer copy, and acronyms in running text. Mono labels are the only uppercase surface: captions, meta rows, table headers, callouts, units. The contrast between quiet lowercase prose and loud uppercase machine-readout is what makes a Lumen page recognisable at a glance.
-Cards carry a 1px hairline border in `--color-rule` and an inner radial gradient at 4-6% accent opacity - they feel **lit from within**, not dropped. On hover, inner glow brightens to 10-12% and the card lifts 4px. Never drop-shadow cards (the shadow Lumen uses is for elevated chrome only).
+**The verb landmark.** One word in a headline, always a verb, set in `--color-accent-2` with a 1px underline that draws in over 320ms after a 900ms delay. Never a noun, never two words, and never italic: the emphasis is colour and rule, not a glyph variation.
-### 7. Three-stat row with Instrument Serif numerals + tabular-nums
+## Material
-Stats display in Instrument Serif at large size (`clamp(2.5rem, 4vw + 1rem, 4.5rem)`), `font-variant-numeric: tabular-nums`, label in mono uppercase 11px. Hairline vertical dividers. **Always three cells** - never two (reads as comparison), never four (reads as bento). If the brief has fewer than three honest numbers, skip the row entirely.
+- **Blueprint grid.** A hairline grid at ~4% opacity over the ground. It is the background discipline, and nothing atmospheric should ever be larger or louder than the light source.
+- **Rules and radii.** Hairlines at `--rule-blueprint`, small consistent radii; borders do the containing, shadows only carry depth.
+- **Numerals.** `font-variant-numeric: tabular-nums` wherever a figure appears; Instrument Serif numerals at display scale.
+- **Annotation.** Where the page labels something, the label is mono micro-type carrying a real value (`λ = 612 nm`, `p50 · 28 ms`). An annotation with a placeholder in it is worse than no annotation, and inventing the value is gate 46a.
-## Motion direction
+## Motion
-Lumen's motion stack is **lighter than Hum, heavier than Coral**.
+Lighter than Hum, heavier than Coral.
| Element | Motion |
|---|---|
-| Apparatus (Night) | Pulse: 3% intensity oscillation, 4s period. **Never rotates.** |
-| Apparatus (Day) | 320ms reveal on first paint, static thereafter. |
-| Verb landmark | Color set permanently to accent-2; 1px underline draws in 320ms `delay: 900ms`. No font-style change. |
-| Cards | `translateY(-4px)` + inner-glow brighten on hover, 220ms `--ease-soft`. |
-| Section heads | Opacity 0→1 + translateY 12px→0 on view enter, 600ms, 60ms stagger. |
-| Meter strip | Static. No "live" animation - the strip is a printed readout, not a streaming feed. |
-| Scroll | Lenis optional (`duration: 0.7, lerp: 0.08`). |
-
-**No magnetic cursors. No bento tile flips. No flashy parallax. No particle systems. No rotating orbs.** If you reach for any of these, you've drifted out of Lumen.
-
-`prefers-reduced-motion: reduce` collapses all animations to instant final state.
-
-## Required dependencies
-
-```html
-<link rel="preconnect" href="https://fonts.googleapis.com" />
-<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
-<link href="https://fonts.googleapis.com/css2?family=Instrument+Serif:ital@0;1&family=Geist:wght@400;500;600&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet" />
-```
-
-Three families, three weights each at most. No fourth family.
-
-## Macrostructure affinity
-
-**Lumen loves these.**
-
-- **Marquee Hero** - canonical: apparatus at hero-right, italic-pivot headline at hero-left, meter strip below
-- **Workbench** - when the page has live product UI to show (used with annotated codebase graph)
-- **Stat-Led** - numbers carry the story (latency, throughput)
-- **Long Document** - technical narrative with the apparatus at hero (Day Foundry canonical)
-- **Specimen** - only when typography is the subject
+| Night light source | Pulse: 3% intensity oscillation, 4s period. **Never rotates.** |
+| Day light source | 320ms reveal on first paint, static thereafter |
+| Verb landmark | Underline draws in over 320ms at `delay: 900ms`. No font-style change. |
+| Cards | `translateY(-4px)` plus an inner brighten on hover, 220ms `--ease-soft` |
+| Section heads | Opacity and a 12px rise on view enter, 600ms, 60ms stagger |
+| Scroll | Lenis optional (`duration: 0.7, lerp: 0.08`) |
-## Macrostructure rejection
+No magnetic cursors, no tile flips, no parallax, no particles, no rotating orbs. `prefers-reduced-motion: reduce` collapses everything to its final state.
-**Lumen refuses these.**
+## Do-nots (this theme's own failure modes)
-- **Bento Grid** - too playful; Lumen is one apparatus, not a tile collage
-- **Quote-Led** - too literary
-- **Conversational FAQ** - too soft
-- **Photographic** - Lumen is pure-code; no photographic anchor
-- **Catalogue** - one apparatus, not a grid of products
+- **Never a glowing orb, sphere, or ring.** The most reliable AI-tool tell of the last two years, and the thing Lumen exists to replace. Build a precision object instead: a filament in a chamber, a topology, an indicator dial, a prism with a spectrum fan.
+- **Never `<img>` for the light source.** Pure CSS and hand-written SVG. A Figma-exported path fails this; the object is constructed in code.
+- **Never sentence-case or title-case prose.** The two-register split is the theme.
+- **Never `font-style: italic` anywhere.** The old italic-pivot signature is retired.
+- **Never colour a noun, and never two accent words in one headline.** One verb is a design move; two is a marketing page.
+- **Never two light sources on one page.** One per build.
+- **Never let a bloom grow larger than the object it comes from.**
-## Voice fixtures
-
-Lumen voice is **direct, technical, slightly aphoristic**. Verbs over nouns. Mono labels read as if from internal docs. No marketing-ese.
-
-Headlines - **all lowercase**, with one verb in accent-2 colour (underlined):
-
-- "built to **think** in real time."
-- "inference, **rendered**."
-- "a new way to **ship** models."
-- "built for the people who **read** the docs."
-- "models for a **moving** atmosphere."
-- "code that **knows** the codebase."
-
-Body patterns - also lowercase, including acronyms:
-
-- "p50 latency at 28 ms. p99 at 84. the numbers hold under load."
-- "one primitive. scales down to zero. scales up to a thousand replicas."
-- "three engineers built this in fourteen weeks."
-
-Mono eyebrows - UPPERCASE (these are tags, not language):
-
-- `00 · INFERENCE`
-- `01 · RUNTIME`
-- `02 · PRICING`
-- `03 · CHANGELOG`
-
-Leader-line callouts (real values only) - UPPERCASE:
-
-- `P50 · 28 MS`
-- `Λ = 612 NM`
-- `θ_OUT = 38°`
-- `RX-04 · H100 80GB`
-- `INDEXED · 412 FILES`
-
-Brand wordmarks - lowercase: `cinder`, `wright`, `stratum`. Legal entity names and person names in fine print also lowercase (`cinder labs, inc.`, `maya okonkwo`). The lowercase commitment is total - only mono labels break it.
-
-**Never any of:** experience, journey, elevate, curate, transform, holistic, mindful, ecosystem, platform, leverage, unlock, supercharge, revolutionize, ai-powered, intelligent.
-
-## Anti-patterns (theme-specific)
-
-- **NEVER a glowing CSS orb / sphere / ring.** The single most reliable AI-tool tell of 2024-2025. Lumen explicitly refuses it. Pick from the apparatus family or build a new precision object - never a generic ball of light.
-- **NEVER `<img>` for the apparatus.** Pure CSS + SVG. Figma-exported SVG paths fail this - the apparatus is constructed in code.
-- **NEVER sentence-case or title-case prose.** All headlines, lede, body, buttons, nav, captions, brand wordmarks, footer copy, person names, place names, and legal-entity names are lowercase. Mono labels are the ONLY uppercase surface (eyebrows, callouts, meter labels, stat labels). This two-register split is non-negotiable.
-- **NEVER `font-style: italic` anywhere.** The previous italic-pivot signature is retired. The verb landmark is built from colour + a 1px underline, not from a glyph variation. Italic body emphasis, italic founder signatures, italic captions - all banned. `<em>` is repurposed as the verb landmark and renders upright.
-- **Never colour-emphasise a noun.** The verb landmark is the verb. Always.
-- **Never more than one accent-coloured word per headline.** Two is a marketing landing page; one is a design move.
-- **Never invent stats.** If the brief has no real numbers, skip the three-stat row entirely.
-- **Never re-draw browser chrome.** Real screenshots only (slop-test gate 47).
-- **Never two apparatus objects on one page.** One per build.
-- **Never a system font for the display.** Instrument Serif or the documented fallback chain (`"Tiempos Headline", ui-serif, Georgia, serif`).
-- **Never rotate the apparatus.** Night apparatus pulses; Day apparatus is static.
-- **Never accent on display text outside the verb landmark.** Headlines are ink colour with one accent-coloured verb.
-- **Never emoji icons in eyebrows.** The mono ordinal + middle-dot + role label IS the eyebrow.
-- **Never two-cell stat rows.** Three only.
-- **Never atmospheric blooms larger than the apparatus.** The grid is the background discipline.
-- **Never blank leader-callouts.** Every annotation carries a real value from the brief.
-
-## Macrostructure pitfalls
-
-1. **Apparatus + embedded chrome on the same side → both fight for the focal point.** Pick one per side. Default: apparatus at hero-right, chrome (if any) in a later section.
-2. **Italic-pivot word at a line break → the verb hangs alone.** Force `&nbsp;` before and after so it stays mid-line.
-3. **Stats with two cells → reads as comparison.** Three only.
-4. **Apparatus glow bleeds into next section → page background looks washed.** Wrap in `overflow: clip` so the halo stays inside the hero.
-5. **Meter strip with uniform ticks → reads as decorative pattern.** Drive heights from a real envelope (sine, gaussian, log) so the strip looks measured.
-6. **Card inner-radial > 8% accent opacity → cards read as accent-tinted, not lit.** Cap at 6% rest / 12% hover.
-
-## How Lumen differs from neighbouring themes
+## How Lumen differs from its neighbours
| vs | difference |
|---|---|
-| **Midnight** (atmospheric, closest) | Midnight is geometric Geist on cool dark (`H 250`), no apparatus, no italic pivot, no grid. Lumen sits 25° hue away (`H 265`) with classical Instrument Serif, hand-built apparatus + leader callouts, blueprint grid, meter strip. The differentiation is large at every signature axis. |
-| **Aurora** (atmospheric) | Aurora is cool cyan blooms on dark, Sentient serif body. Lumen is brass-on-violet apparatus + Instrument Serif headline. Different temperature, different focal-element philosophy (Aurora: ambient blooms; Lumen: built apparatus). |
-| **Bloom** (atmospheric) | Bloom is warm cream paper, expressive content (Suno/Runway). Lumen is dark or cool-bone, technical content (Modal/Anthropic). Different register entirely. |
-| **Atelier** (editorial) | Atelier is Playfair Display Didone on warm cream - luxury fashion. Lumen's Instrument Serif is a 1960s technical-journal serif. Atelier sells perfume; Lumen sells inference. |
+| **Midnight** | Geometric Geist on cool dark (`H 250`), no built object, no grid. Lumen sits 25° away with a classical serif and an engineered artefact. |
+| **Aurora** | Ambient cyan blooms and a Sentient serif body. Lumen is brass-on-violet with a built light source: different temperature, opposite focal philosophy. |
+| **Bloom** | Warm cream paper, expressive content. Lumen is dark or cool-bone, technical content. |
+| **Atelier** | Playfair Didone on warm cream, luxury fashion. Instrument Serif is a 1960s technical-journal serif. Atelier sells perfume; Lumen sells inference. |
-## Test brief expectations
+## When the brief routes here
-Lumen should be a candidate when the brief mentions:
+*inference · model · LLM · AI tool · agent · voice · synthesis · API · GPU · serverless · runtime · developer experience · the console · research lab · climate model*. Categories: AI infrastructure, ML platforms, model APIs, dev tools, voice and audio AI, research and science AI, agentic coding. Tone: engineered, premium, instrument, after-hours, considered.
-- *inference · model · LLM · AI tool · agent · coding agent · voice · synthesis · API · platform · GPU · serverless · runtime · developer experience · DX · the docs · the console · pricing · research lab · atmospheric model · weather · climate*
-- product categories: *AI infrastructure · ML platform · model API · AI dev tool · voice / audio AI · research AI · climate / science AI · agentic coding*
-- emotional tone: *engineered · premium · technical · instrument · after-hours · considered · post-Modal*
-
-Briefs that say *bakery / café / atelier / fashion / podcast / record label / hot sauce / agency portfolio* never route to Lumen.
+Briefs about bakeries, cafés, fashion, podcasts, record labels, or agency portfolios never route to Lumen.
## Build hint
-The first 22 lines of CSS should establish Lumen's anchor moves:
+```html
+<link rel="preconnect" href="https://fonts.googleapis.com" />
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+<link href="https://fonts.googleapis.com/css2?family=Instrument+Serif&family=Geist:wght@400;500;600&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet" />
+```
```css
+:root {
+ --font-display: "Instrument Serif", "Tiempos Headline", ui-serif, Georgia, serif;
+ --font-body: "Geist", ui-sans-serif, system-ui, sans-serif;
+ --font-label: "JetBrains Mono", ui-monospace, monospace;
+ --tracking-label: 0.10em;
+ --dur-pulse: 4s;
+}
+
body {
- background: var(--color-paper); color: var(--color-ink-2);
+ background: var(--color-paper); color: var(--color-ink);
font-family: var(--font-body);
font-variant-numeric: tabular-nums;
- text-transform: lowercase; /* prose default - the two-register foundation */
-}
-
-.eyebrow, .callout, .meter__label, .stat__label, .card__eyebrow {
- font-family: var(--font-label); font-size: 11px; letter-spacing: 0.10em;
- text-transform: uppercase; /* mono labels are the only uppercase surface */
- color: var(--color-ink); opacity: 0.55;
+ text-transform: lowercase; /* prose default: half the two-register split */
}
-.hero__title {
- font-family: var(--font-display); font-weight: 400;
- font-size: var(--text-display); line-height: 1.02;
- letter-spacing: -0.032em; max-width: 16ch;
-}
-.hero__title em {
- font-style: normal; /* italic is RETIRED in Lumen */
- color: var(--color-accent-2);
- position: relative; white-space: nowrap;
-}
+h1, h2, h3 { font-family: var(--font-display); font-weight: 400; letter-spacing: -0.01em; }
-.hero {
- background:
- linear-gradient(var(--rule-blueprint) 1px, transparent 1px) 0 0 / 48px 48px,
- linear-gradient(90deg, var(--rule-blueprint) 1px, transparent 1px) 0 0 / 48px 48px,
- radial-gradient(60% 50% at 78% 30%, var(--color-paper-emit) 0%, transparent 65%),
- var(--color-paper);
+.mono { /* the only uppercase surface on the page */
+ font-family: var(--font-label); font-size: 11px;
+ letter-spacing: var(--tracking-label); text-transform: uppercase;
}
```
-The `text-transform: lowercase` on `<body>` + selective `text-transform: uppercase` on label classes is the typographic foundation. Write your HTML in normal case for accessibility (screen readers); let CSS render the lowercase. Mono labels override back to UPPERCASE.
-
-## What Lumen refuses (restated)
-
-Disqualifiers - if any appears in a Lumen build, the build is not Lumen:
-
-- No glowing orb / sphere / ring of any kind.
-- No `font-style: italic` anywhere on the page.
-- No sentence-case or title-case prose - headlines, lede, body, buttons, nav, brand are all lowercase.
-- No lowercase mono labels - eyebrows, callouts, meter labels are all UPPERCASE.
-- No bento grids.
-- No glassmorphism / `backdrop-filter` blur.
-- No "trusted by" logo cloud as a full-width band.
-- No three-feature-card row with icon tops.
-- No emoji icons in eyebrows.
-- No invented metrics.
-- No re-drawn browser chrome.
-- No more than one apparatus per page.
-- No more than one accent-coloured word per headline.
-- No system-font fallback for the display.
-- No rotating apparatus (pulse only on Night; static on Day).
-- No accent-coloured display text outside the verb landmark.
-- No two-cell stat rows.
-- No atmospheric blooms larger than the apparatus.
-- No blank leader-line callouts.
+The rest of the page is yours. Lumen supplies the light, the ground, and the two registers; what gets built in that light is the brief's business, not the theme's.
diff --git a/skills/hallmark/references/themes/manifesto.md b/skills/hallmark/references/themes/manifesto.md
index e9f839e..315dffc 100644
--- a/skills/hallmark/references/themes/manifesto.md
+++ b/skills/hallmark/references/themes/manifesto.md
@@ -1,8 +1,8 @@
# Theme - Manifesto
-Loud editorial, broadside register. The page for **a statement, a declaration, a movement, a cause, a defiant brand launch, a set of principles** - the protest-poster / political-broadside school, executed on a **warm near-black ground with condensed-bold uppercase display and exactly ONE fighting red**. Giant Anton headlines slam to the left margin, mono clause numbers march down the side, and the body drops to a quiet grotesque. It reads like a thesis nailed to a door: uncompromising, urgent, set once and set loud.
+Loud editorial, broadside register: the protest-poster and political-broadside school, executed on a **warm near-black ground with condensed-bold uppercase display and exactly ONE fighting red**. Giant Anton lines slam to the left margin and the body drops to a quiet grotesque. It reads like a thesis nailed to a door: uncompromising, urgent, set once and set loud.
-Loaded eagerly by SKILL.md Step 3 whenever the catalog pick is `manifesto`. The OKLCH palette + font stack live in [`site/css/tokens.css`](../../../../site/css/tokens.css) under `[data-theme="manifesto"]`. No canonical build yet: mirror the signature moves below.
+The material, in one line: **warm charcoal, condensed caps at 9rem, a quiet body, one red.**
## Axes (diversification)
@@ -12,118 +12,92 @@ Loaded eagerly by SKILL.md Step 3 whenever the catalog pick is `manifesto`. The
## Reference register
-Recorded broadsides and statement pages: the Communist / Futurist / Dada printed manifesto, a strike poster, a punk zine cover, Wikimedia's "we stand for" appeals, agency mission pages set in condensed grotesque, Aesop's plainspoken conviction re-pitched loud. The aesthetic: a political declaration printed at scale in one ink plus red, numbered like articles, no image needed. **Never name any of these in the output.**
+Recorded broadsides and statement pages: the Communist / Futurist / Dada printed manifesto, a strike poster, a punk zine cover, "we stand for" appeals, mission pages set in condensed grotesque. **Never name any of these in the output.**
-**Patron-saint reference (internal):** *the printed manifesto nailed up in public* - condensed-bold caps, clause numbers, one red word per line, argument carried by type alone. When in doubt ask "does this read like a declaration, or like a product page?" Keep the former.
+The material to match: a political declaration printed at scale in one ink plus red, argument carried by type alone, no image needed. Internally: *the printed manifesto nailed up in public*. When in doubt ask "does this read like a declaration, or like a product page?" Keep the former.
-## Required dependencies
+## Palette
-1. **Fonts** - **Anton** (display, one weight 400, uppercase only), **Public Sans** (body, 400/600/700), **JetBrains Mono** (clause numbers, labels, meta). The stack also names Bebas Neue / Albert Sans / Hanken Grotesk as fallbacks; load the three primaries. Google Fonts:
- ```html
- <link href="https://fonts.googleapis.com/css2?family=Anton&family=Public+Sans:wght@400;600;700&family=JetBrains+Mono:wght@400;500;700&display=swap" rel="stylesheet" />
- ```
-2. **A hard reveal script** - one `IntersectionObserver` adding `.is-in` that runs a **clip-up mask** on headline blocks (not a soft fade + drift). Snappy cubic-bezier, plays once, gates behind `prefers-reduced-motion: no-preference`.
+Canonical values live in [`site/css/tokens.css`](../../../../site/css/tokens.css) under `[data-theme="manifesto"]`.
-## Signature moves
+- `--color-paper: oklch(10% 0.005 60)` - warm charcoal, never `#000`; bands step to `15%` / `20%`
+- `--color-ink: oklch(98% 0.003 90)` - warm near-white
+- `--color-ink-2: oklch(88% 0.006 80)` - body, a notch back
+- `--color-muted: oklch(60% 0.012 65)` - meta
+- `--color-accent: #E51A1A` - flat red for fills, underlines, and the 3px bar
+- `--color-accent-ink: oklch(58% 0.24 28)` - the text-legible red, for a red **word**
+- `--color-focus` - the same red
+- `--color-rule: oklch(28% 0.010 60)` - the hairline that divides
-1. **Warm near-black ground, never `#000`** - `--color-paper` is `oklch(10% 0.005 60)`, a warm charcoal. Ink is warm near-white `--color-ink` (`oklch(98% 0.003 90)`); body text sits a notch back at `--color-ink-2` (`oklch(88% 0.006 80)`); meta drops to `--color-muted` (`oklch(60% 0.012 65)`). Everything is warm-tinted (hue 60-90), never neutral grey, never pure black or white.
+Everything is warm-tinted (hue 60-90), never neutral grey. One red, under 5% of any viewport, and **at most one red-inverted surface on the whole page** (red paper, `--color-ink` text); everywhere else red stays a signal. Text on a red fill is `--color-ink`, never dark ink. At most one red word per headline.
-2. **Anton at full display scale, stacked** - the headline is the page. Set `--font-display` uppercase at `clamp(4rem, 8vw+1rem, 9rem)` (`--text-display`), leaded at `--lh-tight: 0.86` so a three-line headline locks into one solid mass. Slam it to the left margin, edge to edge. This is THE move: giant condensed-bold declarations, not a title-and-lede.
+## Typography
-3. **One red, three jobs, under 5% of any viewport** - red **words** inside a headline use `--color-accent-ink` (`oklch(58% 0.24 28)`, the text-legible red); red **fills, underlines, and the `--rule-fine: 3px` bar** use flat `--color-accent` (`#E51A1A`); focus rings use `--color-focus` (same red). At most **one red word per headline**. Text placed on a red fill is `--color-ink`, never dark ink.
+The whole drama is scale contrast: the gap between `9rem` caps and `1rem` grotesque IS the theme.
-4. **Numbered clauses** - the manifesto reads as articles. Mark each thesis with a `--font-mono` (JetBrains Mono) label, UPPERCASE, tracked at `--tracking-label: 0.10em`: `01 / 02 / 03` or `ARTICLE I`. The mono machine-voice against the Anton shout is the theme's two-register signature.
+- **Display** - Anton, one weight, uppercase only, at `clamp(4rem, 8vw+1rem, 9rem)` (`--text-display`), leaded at `--lh-tight: 0.86` so a three-line block locks into one solid mass. Slam it to the left margin, edge to edge.
+- **Body** - Public Sans 400/600/700, set small and plain at `--measure: 56ch` in `--color-ink-2`. It never competes; it is the calm argument under the shout.
+- **Label** - JetBrains Mono, UPPERCASE, `--tracking-label: 0.10em`. The machine-voice against the Anton shout: captions, meta rows, table headers, units, dates, folios, and entry numbers inside a real `<ol>` when the argument is genuinely ordered. It carries a value; it never sits above a heading to announce it.
-5. **Hairlines divide, one thick red bar accents** - `--rule-hair: 1px` (`--color-rule`, `oklch(28% 0.010 60)`) separates clauses like a printed broadsheet; a single `--rule-fine: 3px` red bar sits under a section head or leads the hero. Rules do the structural work: **no boxed cards, no drop-shadows**.
+## Material
-6. **Quiet body, loud display - the whole drama is scale contrast** - `--font-body` (Public Sans) set small and plain at `--measure: 56ch`, `--color-ink-2`. The body never competes; it is the calm argument under the shouting headline. The gap between `9rem` caps and `1rem` grotesque IS the theme.
-
-7. **Square, ruler-drawn controls** - buttons and inputs are `0px` radius or hairline-bordered blocks. A primary action is a flat red `#E51A1A` block with `--color-ink` text, or an outlined block that inverts to red on hover. No pills, no soft radii, no gradients.
-
-8. **At most one red-inverted band, as the climax** - the page may flood red **once** (red paper, `--color-ink` text) for the closing thesis or a pull-quote, giving a dark -> red -> dark rhythm and the single showcase beat. One band only: everywhere else red stays a signal.
+- **Hairlines divide, one thick red bar accents.** `--rule-hair: 1px` in `--color-rule` separates like a printed broadsheet; a single `--rule-fine: 3px` red bar is the emphatic mark. Rules do the structural work: **no boxed cards, no drop-shadows.**
+- **Square, ruler-drawn controls.** Buttons and inputs are `0px` radius or hairline-bordered blocks. A primary action is a flat red block with `--color-ink` text, or an outlined block that inverts to red on hover. No pills, no soft radii, no gradients.
+- **No texture, no ornament.** The scale and the red carry everything.
+- **No imagery leading.** Type argues; a photograph undercuts the broadside.
## Motion
-Hard and staccato, not soft. Headline blocks clip-reveal upward once on load; clauses can enter line by line with a snappy ease, never a drift-and-fade. No bounce, no parallax, no autoplay, no red pulsing. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static and fully visible.
-
-## Anti-patterns
-
-- **No pure `#000` ground / `#fff` ink** - warm-tinted charcoal and warm near-white (hue 60-90).
-- **No second accent** - red is the ONLY colour. No blue, no green, no duo-tone pairing (that is Carnival).
-- **No red flood** beyond the single climactic band (signature 8): red is a signal, not a background.
-- **No light / paper ground** - Manifesto is dark. A light statement page routes to Riso or Carnival.
-- **No decorative ornaments** - no fleurons, stickers, hard-offset shadows, tinted paper tricks (Carnival's vocabulary).
-- **No centred hero** (gate 6) - headlines slam left, edge-aligned.
-- **No serif display** - `--font-serif` resolves to Anton on purpose; there is no roman serif here. Display is condensed-bold uppercase.
-- **No lowercase, timid, or title-cased display** - the display voice is UPPERCASE and declarative.
-- **No image-led hero** - type carries the page; a photograph undercuts the broadside.
-
-## Macrostructure affinity
-
-**Manifesto loves these.**
+Hard and staccato, not soft. Display blocks clip-reveal upward once (a `clip-path: inset()` mask, not a soft fade and drift) via one `IntersectionObserver`, on a snappy cubic-bezier, playing once. Lines can enter one after another with the same snap. No bounce, no parallax, no autoplay, no red pulsing. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static and fully visible.
-- **Manifesto** - the numbered-declaration shape *(canonical home)*
-- **Long Document** - theses as numbered articles down the page
-- **Stat-Led** - one enormous red number per belief
-- **Quote-Led** - a single line set at display scale
-- **Marquee Hero** - when the hero is one uncompromising statement
+## Voice range
-**Manifesto refuses these.**
+Imperative, short, declarative. Fighting words, verbs over adjectives, one red word. Never *seamless, effortless, delightful, gentle, playful, cozy, maybe, perhaps, leverage, synergy*. No hedging, no hype-marketing: state it and stand behind it.
-- **Photographic / image-led** - Manifesto argues in type, not imagery
-- **Bento Grid** - too neat and product-shaped for a broadside
-- **Workbench** - tool-first; Manifesto is a stance, not an instrument
-- **Conversational FAQ** - too soft and helpful; the voice declares, it does not chat
+## Do-nots (this theme's own failure modes)
-## Voice fixtures
+- **No pure `#000` ground or `#fff` ink.** Warm-tinted charcoal and warm near-white, hue 60-90.
+- **No second accent.** Red is the ONLY colour: no blue, no green, no duo-tone pairing (that is Carnival).
+- **No red flood** beyond the single inverted surface. Red is a signal, not a background.
+- **No light ground.** Manifesto is dark. A light statement page routes to Riso or Carnival.
+- **No decorative ornaments** - no fleurons, stickers, hard-offset shadows, tinted paper tricks.
+- **No serif display, no lowercase or title-cased display.** `--font-serif` resolves to Anton on purpose; the display voice is UPPERCASE and declarative.
-Imperative, short, declarative. Fighting words, verbs over adjectives, one red word.
-
-- *"WE REFUSE THE AVERAGE."*
-- *"PRINT DISCIPLINE. ON SCREEN. NO EXCEPTIONS."*
-- *"EVERY PAGE IS AN ARGUMENT."*
-- *"SET IT LOUD. SET IT ONCE."*
-- *"NOTHING SOFT. NOTHING BORROWED."*
-
-Never any of: *seamless, effortless, delightful, gentle, playful, cozy, maybe, perhaps, leverage, synergy*. No hedging, no hype-marketing. State it and stand behind it.
-
-## How Manifesto differs from neighbouring themes
+## How Manifesto differs from its neighbours
| vs | difference |
|---|---|
| **Carnival** (loud-editorial sibling) | Carnival is a **light**, tinted-paper, **duo-tone** decorative page (mustard + oxblood, ornaments, hard-offset shadows, variable Big Shoulders). Manifesto is **dark**, **one red**, raw, condensed-bold Anton, no ornament. Light-decorative vs dark-declarative settles it instantly. |
-| **Brutal** (raw-editorial sibling) | Brutal is a **light 98% sheet** with heavy black rules and Albert Sans 700 - rigid, grid-structural, its one red cutting the near-white. Manifesto is a **dark** warm-charcoal ground with condensed-bold Anton and numbered clauses - composed loudness, not grid rawness. Light-vs-dark and the display face settle it. |
-| **Riso** (print-editorial sibling) | Riso is a **light** print-texture / duotone-registration page. Manifesto is a dark, textureless broadside carried by scale and one red bar, not by ink-misregistration charm. |
+| **Brutal** (raw-editorial sibling) | Brutal is a **light 98% sheet** with heavy black rules and Albert Sans 700 - rigid and grid-structural, its one red cutting the near-white. Manifesto is a **dark** warm-charcoal ground with condensed-bold Anton - composed loudness, not grid rawness. |
+| **Riso** (print-editorial sibling) | Riso is a **light** print-texture, duotone-registration page. Manifesto is a dark, textureless broadside carried by scale and one red bar, not by ink-misregistration charm. |
-## Test brief expectations
+## When the brief routes here
-Manifesto should be a candidate when the brief mentions:
+*manifesto · statement · declaration · principles · beliefs · mission · movement · protest · cause · campaign · activism · advocacy · values · take a stand · bold launch · defiant · anti-establishment · punk*. Categories: activist and cause orgs, advocacy campaigns, defiant brand launches, editorial statements, agencies with an attitude, loud record labels, movement pages. Tone: loud, defiant, urgent, declarative, uncompromising.
-- *manifesto · statement · declaration · principles · beliefs · mission · movement · protest · cause · campaign · activism · advocacy · "what we stand for" · values · take a stand · bold launch · defiant · anti-establishment · punk*
-- Product categories: *activist / cause org · advocacy campaign · defiant brand launch · editorial statement · agency with an attitude · loud record label · movement or petition page*
-- Emotional tone: *loud · defiant · urgent · declarative · high-contrast · uncompromising · righteous*
-
-Briefs that are calm / product / consumer / image-led route elsewhere (Cobalt for dev-tools, Carnival for light-maximal, the quiet editorial themes for content). When the brief wants to **shout a conviction in type**, it is Manifesto.
+Calm, product, consumer, or image-led briefs route elsewhere. When the brief wants to **shout a conviction in type**, it is Manifesto.
## Build hint
-The first lines of CSS establish Manifesto's anchor moves:
+```html
+<link href="https://fonts.googleapis.com/css2?family=Anton&family=Public+Sans:wght@400;600;700&family=JetBrains+Mono:wght@400;500;700&display=swap" rel="stylesheet" />
+```
```css
html, body { overflow-x: clip; }
body { background: var(--color-paper); color: var(--color-ink-2);
font-family: var(--font-body); font-weight: 400; }
-/* The headline is the page - condensed-bold caps, slammed left, leaded tight */
+/* Condensed-bold caps, slammed left, leaded tight */
.display { font-family: var(--font-display); text-transform: uppercase;
font-size: var(--text-display); line-height: var(--lh-tight);
letter-spacing: var(--tracking-display); color: var(--color-ink);
text-align: left; text-wrap: balance; }
.display .hot { color: var(--color-accent-ink); } /* one red word, max */
-/* Mono clause number + the one thick red bar */
-.clause-no { font-family: var(--font-mono); text-transform: uppercase;
- letter-spacing: var(--tracking-label); color: var(--color-muted); }
+/* Mono label voice + the one thick red bar */
+.label { font-family: var(--font-mono); text-transform: uppercase;
+ letter-spacing: var(--tracking-label); color: var(--color-muted); }
.rule-red { height: var(--rule-fine); background: var(--color-accent); border: 0; }
/* Square controls - a flat red block, never a pill */
@@ -137,4 +111,4 @@ body { background: var(--color-paper); color: var(--color-ink-2);
@media (prefers-reduced-motion: reduce) { .reveal { clip-path: none; transition: none; } }
```
-Plus the Anton + Public Sans + JetBrains Mono link and the small clip-reveal script.
+The rest of the page is yours. Manifesto supplies the charcoal, the caps, and the one red; what gets declared in them is the brief's business, not the theme's.
diff --git a/skills/hallmark/references/themes/midnight.md b/skills/hallmark/references/themes/midnight.md
index bdcf81a..a0f0dd7 100644
--- a/skills/hallmark/references/themes/midnight.md
+++ b/skills/hallmark/references/themes/midnight.md
@@ -1,104 +1,84 @@
# Theme - Midnight
-Atmospheric, cool-nocturnal register. The page for an **AI or dev tool you open after dark** - a generative model playground, a rendering pipeline, an observability console, a late-night creative instrument - but rendered in **cold azure moonlight, not the genre's warm firelight**. A deep midnight-blue canvas (`oklch(15% 0.022 250)`), near-white cool ink, one azure signal, and thin airy Geist display. It reads calm, spacious, cerebral: the small hours, not the golden hour.
+Atmospheric, cool-nocturnal register: the page rendered in **cold azure moonlight rather than the genre's warm firelight**. A deep midnight-blue canvas, near-white cool ink, one azure signal, thin airy Geist display. It reads calm, spacious, cerebral - the small hours, not the golden hour.
-Loaded eagerly by SKILL.md Step 3 when the catalog pick is `midnight`. Tokens: [`site/css/tokens.css`](../../../../site/css/tokens.css) under `[data-theme="midnight"]`. No canonical build yet; mirror the moves below.
+The material, in one line: **one cold light on a blue-dark ground, and type thin enough to breathe.**
-> **Why cool, not warm.** The atmospheric cluster defaults to warm blooms (Bloom terracotta, Lumen Night amber). Midnight is the deliberate **cool** exception: it keeps the dark canvas + fade-only motion + centred hero, but aims a single azure accent (hue 220) at the cold-light lane. The blue chill is the differentiator, not a recolour of a warm sibling.
+> **Why cool, not warm.** The atmospheric cluster defaults to warm blooms (Bloom terracotta, Lumen Night brass). Midnight is the deliberate **cool** exception: dark canvas, fade-only motion, generous void, but a single azure accent aimed at the cold-light lane. The blue chill is the differentiator, not a recolour of a warm sibling.
## Axes (diversification)
-- **Paper band** - **dark, blue-tinted** (`oklch(15% 0.022 250)`, ~15% L, hue 250). A midnight blue with real chroma, never `#000`. Elevation climbs to `paper-2` `oklch(20% 0.024 250)` and `paper-3` `oklch(25% 0.026 250)`.
-- **Display style** - **geometric-sans, thin** (Geist at `--display-weight: 300`). Airy light-weight display, tracking `-0.03em`. Distinct from Bloom's weighty Geist 600 and every serif sibling.
-- **Accent hue** - **azure / cool cyan-blue** (`oklch(72% 0.16 220)`). Sits a few degrees cyan of the blue ground (250), so it reads as a separate cold light, not a brighter canvas. Clear of Cobalt/Lumen indigos (~256/268). Signal, never flood.
+- **Paper band** - **dark, blue-tinted** (`oklch(15% 0.022 250)`, ~15% L, hue 250). A midnight blue with real chroma, never `#000`.
+- **Display style** - **geometric-sans, thin** (Geist at `--display-weight: 300`, tracking `-0.03em`). Airy light-weight display, distinct from Bloom's weighty Geist 600 and from every serif sibling.
+- **Accent hue** - **azure / cool cyan-blue** (`oklch(72% 0.16 220)`). A few degrees cyan of the blue ground, so it reads as a separate cold light rather than a brighter canvas. Clear of Cobalt and Lumen indigos (~256 / 268). Signal, never flood.
## Reference register
Linear (dark) · Raycast · Vercel dark mode · Resend dark · Cron / calendar dark · Perplexity dark · Diagram · cool nocturnal model playgrounds.
-The aesthetic: the cool-dark product page - a deep blue canvas, one cold signal, thin confident display, generous void. Hand-built, moody without being warm.
+The material to match: a deep blue canvas, one cold signal, thin confident display, generous void. An observatory at 2 a.m. - a calm instrument lit by one distant azure light. Ask "does this feel like a cold clear night, or a warm-lit room?" Keep the former. Never name any of these in the output.
-**Patron-saint reference (internal):** *Linear's cool-dark restraint* + *an observatory at 2 a.m.* - a calm instrument lit by one distant azure light. Ask "does this feel like a cold clear night, or a warm-lit room?" Keep the former.
+**Voice range:** cool, nocturnal, spare, a touch cerebral. Name the command or the number.
-## Required dependencies
+## Palette
-1. **Fonts** - **Geist** (display 300 + body 400/500), **Geist Mono** (labels), **Instrument Serif** (one roman accent moment only). Google Fonts:
- ```html
- <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
- <link href="https://fonts.googleapis.com/css2?family=Geist:wght@300;400;500;600&family=Geist+Mono:wght@400;500&family=Instrument+Serif&display=swap" rel="stylesheet" />
- ```
-2. **A reveal script** - one `IntersectionObserver` adding `.is-in` (fade + ~10px rise, ease-out ~600ms). Fade is the whole motion budget.
+- `--color-paper: oklch(15% 0.022 250)` - midnight blue, never void; the 0.022 chroma is load-bearing
+- `--color-paper-2: oklch(20% 0.024 250)` / `--color-paper-3: oklch(25% 0.026 250)` - elevation
+- `--color-ink: oklch(95% 0.008 230)` - cool near-white headlines
+- `--color-ink-2: oklch(86% 0.010 230)` - body
+- `--color-accent: oklch(72% 0.16 220)` - the one azure signal
+- `--color-rule: oklch(33% 0.024 245)` - hairline seams; `--color-rule-2: oklch(48% 0.020 240)` for a brighter edge
-## Signature moves
+Accent stays under 5% of any viewport: a link hover, the one primary button, focus rings, an active nav item, a single glowing numeral. Everything else is cool-white on blue-dark.
-1. **Deep midnight-blue canvas, never black** - `--color-paper: oklch(15% 0.022 250)`. The 0.022 chroma is load-bearing: it is midnight *blue*, not void. Ink is cool near-white `--color-ink: oklch(95% 0.008 230)`; body sits at `--color-ink-2: oklch(86% 0.010 230)`.
+## Typography
-2. **Thin Geist display, the airy nocturnal signature** - `--display-weight: 300`, tracking `-0.03em`, `--text-display: clamp(2.75rem, 5vw + 1rem, 5.25rem)`. Light-weight display at large size is the theme's face: spacious, cold, calm. Never the genre-default 600.
+- **Display** - Geist at `--display-weight: 300`, tracking `-0.03em`, `--text-display: clamp(2.75rem, 5vw + 1rem, 5.25rem)`. Light-weight display at large size is the theme's face: spacious, cold, calm. Never the genre-default 600.
+- **Body** - Geist 400/500, `--measure: 60ch`.
+- **Label** - Geist Mono, UPPERCASE, `--tracking-label: 0.16em`. The cold machine-readout voice: captions, meta rows, status, kbd hints, table headers, units.
+- **Serif** - Instrument Serif is available for one roman moment, a single large numeral or a pulled line. **Roman only, never italic**, and never the running display; Geist thin owns that.
-3. **One azure signal, used sparingly** (< 5% of any viewport) - `--color-accent: oklch(72% 0.16 220)` on the eyebrow tick, a link hover, the one primary button, focus rings, an active nav item, a single glowing numeral. Everything else is cool-white on blue-dark.
+## Material
-4. **A single cool glow, not two warm blooms** - one fixed radial-gradient low or behind the hero, azure hue ~220-240 at low chroma, fading into the paper like light on a night horizon. Fixed-attached, no animation. Cold light only; never a warm bloom.
-
-5. **Layered dark surfaces + faint hairlines** - build depth with `paper` / `paper-2` / `paper-3`, separated by 1px `--color-rule: oklch(33% 0.024 245)` (or `rule-2` `oklch(48% 0.020 240)` for a brighter edge). Cards float on the elevated layers; hairlines draw the seams. No drop-shadow theatre.
-
-6. **Wide-tracked mono eyebrows** - `--font-label` (Geist Mono), UPPERCASE, `--tracking-label: 0.16em`. The cold machine-readout voice under the thin Geist display. Meta, status, kbd hints all take it.
-
-7. **Generous nocturnal void** - `--section-gap: 6rem`, `--measure: 60ch`, centred or near-centred hero (genre gate 6 loosened). The dark and the space do the work; let the type breathe.
-
-8. **Instrument Serif for one roman moment** - `--font-serif` is available for a single large numeral or a pulled line, **roman only, never italic** (a top AI tell, banned in headers). Never the running display; Geist thin owns that.
+- **A single cool glow.** One fixed radial gradient, low or behind the focal type, azure hue ~220-240 at low chroma, fading into the paper like light on a night horizon. Fixed-attached, never animated. Cold light only, and only one.
+- **Layered dark surfaces, faint hairlines.** Depth comes from `paper` / `paper-2` / `paper-3` separated by 1px `--color-rule`. Surfaces float on the elevated layers and hairlines draw the seams. No drop-shadow theatre.
+- **Radius** - small and even (`8px` controls). Neither pill-soft nor ruler-sharp.
+- **Void** - `--section-gap: 6rem`. The dark and the space do the work; let the type breathe.
## Motion
-Fade only, composed and slow. Section reveals fade + rise once. Hover: an azure underline-grow on links, a 1px border shift to `--color-accent` on focusable surfaces. No slide, no bounce, no parallax, no autoplay - the atmosphere carries it. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static and fully visible.
-
-## Anti-patterns
-
-- **No warm accent** (amber, orange, terracotta, gold) - that is Bloom and Lumen-Night. Midnight is azure hue 220.
-- **No pure black canvas** - the ground is blue-tinted `15% 0.022 250`, never `#000` / `#111`.
-- **No heavy display weight** - stay at 300; Geist 600 is Bloom's face, not Midnight's.
-- **No serif display, no italics anywhere** - Geist thin is the display; Instrument Serif is a roman accent only.
-- **No light-paper sections** - Midnight is dark throughout; do not sneak a white band in (genre rule).
-- **No warm-and-cool bloom juggling** - one cool glow, single hue family. No second warm light.
-- **No glassmorphism, no gradient text** (universal gates), no aurora-of-many-hues; one azure light on a blue-dark ground.
-
-## Macrostructure affinity
-
-**Midnight loves:** Marquee Hero (one confident thin-type hero on the dark canvas) · Manifesto (the cold canvas argues a statement) · Stat-Led (azure numerics glowing on blue-dark) · Photographic (the dark ground frames moody visuals) · Feature-stack (stacked capabilities on layered dark surfaces).
+Fade only, composed and slow. Reveals fade and rise ~10px, once. Hover: an azure underline-grow on links, a 1px border shift to `--color-accent` on focusable surfaces. No slide, no bounce, no parallax, no autoplay; the atmosphere carries it. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static and fully visible.
-**Midnight refuses:** Long Document (prose wants light editorial paper) · Letter (too warm and intimate) · Catalogue (too busy and commercial for the calm dark) · Conversational FAQ (too casual for the cool register).
+## Do-nots (this theme's own failure modes)
-## Voice fixtures
+- **Never a warm accent** (amber, orange, terracotta, gold). That is Bloom and Lumen Night. Midnight is azure hue 220.
+- **Never a heavy display weight.** Stay at 300; Geist 600 is Bloom's face.
+- **Never a serif display.** Geist thin is the display; Instrument Serif is a roman accent moment only.
+- **Never a light-paper section.** Midnight is dark throughout; do not sneak a white band in.
+- **Never juggle warm and cool light.** One cool glow, single hue family, no second light.
+- **Never an aurora of many hues.** Two overlapping blooms is Aurora's move; Midnight is one azure light.
-Cool, nocturnal, spare, a touch cerebral. Name the thing plainly.
+## How Midnight differs from its neighbours
-- *"Made for the small hours."*
-- *"Render the night in a single pass."*
-- *"A quiet instrument for loud ideas."*
-- *"Ship between midnight and dawn."*
-- *"Cool, exact, awake."*
-
-Never any of: *warm, cozy, golden, firelit, seamless, cutting-edge, revolutionary, supercharge, unlock*. Never italics. Never "click here"; name the command or the number.
-
-## How Midnight differs from neighbouring themes
-
-| vs | what settles it instantly |
+| vs | difference |
|---|---|
-| **Cobalt** (cool-blue neighbour) | Cobalt is a **light** engineered canvas, Space Grotesk, a literal code/API hero, hue 256. Midnight is a **dark** blue canvas, thin Geist 300, diffuse cool glow, hue 220. Light vs dark, code-hero vs atmosphere. |
-| **Lumen** (atmospheric sibling) | Lumen is **warm** amber-gold (or light indigo), Instrument Serif *display*, one *built* light artefact. Midnight is **cool** azure, Geist thin display, a soft diffuse glow. Warm-serif-apparatus vs cool-thin-sans atmosphere. |
-| **Aurora** (dark cool sibling) | Aurora blooms cyan and runs a **Sentient serif body**. Midnight is all-Geist (sans throughout), more restrained, one azure *signal* rather than a blooming cyan field. Serif-body-blooms vs all-sans-restraint. |
-
-## Test brief expectations
+| **Cobalt** | A **light** engineered canvas, Space Grotesk, a literal code hero, hue 256. Midnight is a **dark** blue canvas, thin Geist 300, a diffuse cool glow, hue 220. Light vs dark, code-hero vs atmosphere. |
+| **Lumen** | Warm brass on violet (or light indigo), Instrument Serif *display*, one *built* light artefact. Midnight is cool azure, Geist thin, a soft diffuse glow. Warm-serif-apparatus vs cool-thin-sans atmosphere. |
+| **Aurora** | Blooms cyan and teal-green and runs a Sentient serif body on a deeper ground. Midnight is all-Geist, more restrained, one azure *signal* rather than a blooming field. Serif-body-blooms vs all-sans-restraint. |
-Midnight is a candidate when the brief mentions:
+## When the brief routes here
-- *AI tool · generative · model playground · render · pipeline · observability · dark mode · nocturnal · late-night · after-hours · moody · cinematic · cool · cerebral · midnight · azure · calm-technical*
-- Product categories: *AI creative tool · generative model UI · dev tool with a moody register · data / observability console · cool nocturnal SaaS*
-- Emotional tone: *cool · calm · nocturnal · spacious · cerebral · quiet-confident · cold-clarity*
+*AI tool · generative · model playground · render · pipeline · observability · dark mode · nocturnal · late-night · after-hours · moody · cinematic · cerebral · midnight · azure · calm-technical*. Categories: AI creative tools, generative model UIs, dev tools with a moody register, data and observability consoles, cool nocturnal SaaS. Tone: cool, calm, nocturnal, spacious, cerebral, quiet-confident.
-Warm / consumer / editorial / image-led-light briefs route elsewhere (Bloom or Lumen-Night for warm atmospheric, Cobalt for a light code tool). When the brief wants dark **and cold**, it is Midnight.
+Warm, consumer, editorial, or image-led-light briefs route elsewhere (Bloom or Lumen Night for warm atmospheric, Cobalt for a light code tool). When the brief wants dark **and cold**, it is Midnight.
## Build hint
+```html
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+<link href="https://fonts.googleapis.com/css2?family=Geist:wght@300;400;500;600&family=Geist+Mono:wght@400;500&family=Instrument+Serif&display=swap" rel="stylesheet" />
+```
+
```css
html, body { overflow-x: clip; }
body { background: var(--color-paper); color: var(--color-ink-2);
@@ -109,11 +89,13 @@ body::before { content: ""; position: fixed; inset: 0; z-index: -1; pointer-even
background: radial-gradient(60% 45% at 50% 82%,
oklch(30% 0.06 230 / 0.55), transparent 70%); }
-/* Thin airy display + wide-tracked mono eyebrow */
+/* Thin airy display */
.display { font-family: var(--font-display); font-weight: var(--display-weight);
letter-spacing: var(--tracking-display); font-size: var(--text-display); }
-.eyebrow { font-family: var(--font-label); text-transform: uppercase;
- letter-spacing: var(--tracking-label); color: var(--color-accent); }
+
+/* Mono label voice - captions, meta, status, units */
+.label { font-family: var(--font-label); text-transform: uppercase;
+ letter-spacing: var(--tracking-label); color: var(--color-muted); }
/* The one azure signal */
.btn--primary { background: var(--color-accent); color: var(--color-paper);
@@ -129,4 +111,4 @@ a:hover { color: var(--color-accent); }
}
```
-Plus the Geist + Geist Mono + Instrument Serif link and the small reveal script.
+Plus one `IntersectionObserver` adding `.is-in`. Midnight supplies the ground, the one light, and the thin voice; what stands in that light is the brief's business.
diff --git a/skills/hallmark/references/themes/newsprint.md b/skills/hallmark/references/themes/newsprint.md
index 9e32ddb..a64faf3 100644
--- a/skills/hallmark/references/themes/newsprint.md
+++ b/skills/hallmark/references/themes/newsprint.md
@@ -1,134 +1,103 @@
# Theme - Newsprint
-The broadsheet front page, rebuilt for the screen. The page for an **essay, an op-ed, a magazine piece, a journalism or newsletter brand, a literary review, a longform publication** - the front-page-of-record school, executed in **warm cream, warm ink, one dried-brick signal**. A masthead over a double rule, hairline column rules, a drop cap opening the lede. It reads like something filed this morning and set by hand: authoritative, literary, calm.
+The broadsheet, rebuilt for the screen: the front-page-of-record school executed in **warm cream, warm ink, one dried-brick signal**. Double rules, hairline column rules, a drop cap opening the lede, a Didone head over a book-serif body. It reads like something filed this morning and set by hand: authoritative, literary, calm.
-Loaded eagerly by SKILL.md Step 3 whenever the catalog pick is `newsprint`. The OKLCH palette + font stack live in [`site/css/tokens.css`](../../../../site/css/tokens.css) under `[data-theme="newsprint"]`.
+The material, in one line: **warm cream stock, a Didone head, columns split by hairlines, one brick mark.**
## Axes (diversification)
- **Paper band** - warm light (`L 92%`, hue ~50, low chroma). A warm newsprint cream (`--color-paper: oklch(92% 0.045 50)`), never a cool white and never a neutral grey.
-- **Display style** - **roman serif / Didone** (Playfair Display 700, optical 48). High-contrast: hairline verticals against thick stems. Distinct from any sans or slab; italic is body-emphasis only, never the header face.
-- **Accent hue** - **dried brick** (`--color-accent: oklch(32% 0.10 28)`; text-weight `--color-accent-ink: oklch(45% 0.13 30)`). A muted warm red, used only as furniture. Sits clear of Coral's bright coral and Carnival's oxblood.
+- **Display style** - **roman serif / Didone** (Playfair Display 700, optical 48). High contrast: hairline verticals against thick stems. Distinct from any sans or slab; italic is body emphasis only, never the header face.
+- **Accent hue** - **dried brick** (`--color-accent: oklch(32% 0.10 28)`; text-weight `--color-accent-ink: oklch(45% 0.13 30)`). A muted warm red used only as furniture. Clear of Coral's bright coral and Carnival's oxblood.
## Reference register
The New York Times · The Guardian · The Economist · Financial Times · Le Monde · Bloomberg Businessweek · The Atlantic · The Pudding · The Marginalian · Reuters.
-The aesthetic: the front page and the opinion column - centred masthead, dateline furniture, hairline columns, drop-cap ledes, pull-quotes set off by rules. **Never name any of these in the output.**
+The material to match: the front page and the opinion column - dateline furniture, hairline columns, drop-cap ledes, pulled lines set off by rules, one brick mark, the rule discipline of a printed page of record. Ask "does this read like a printed page of record, or a marketing template?" Keep the former. **Never name any of these in the output.**
-**Patron-saint reference (internal):** *a broadsheet front page* + *The Economist's rule discipline*, recoloured brick. When in doubt, ask "does this read like a printed page of record, or a marketing template?" Keep the former.
+**Voice range:** specific, declarative, a dry editorial wit. Name the section, the date, the fact.
-## Required dependencies
+## Palette
-1. **Fonts** - **Playfair Display** (display, 700/800/900), **Crimson Pro** (body + italic emphasis, 400/500/600), **Inter** (kickers, bylines, meta labels), **IBM Plex Mono** (folios, edition numerals). Google Fonts:
- ```html
- <link href="https://fonts.googleapis.com/css2?family=Playfair+Display:ital,wght@0,700;0,800;0,900;1,700&family=Crimson+Pro:ital,wght@0,400;0,500;0,600;1,400;1,500&family=Inter:wght@500;600&family=IBM+Plex+Mono:wght@400;500&display=swap" rel="stylesheet" />
- ```
-2. **A small reveal script** - one `IntersectionObserver` adding `.is-in` (fade + ~10px rise, ease-out ~600ms). No type-in, no counters. The page is print; motion is a single quiet entrance.
+- `--color-paper: oklch(92% 0.045 50)` - warm newsprint cream
+- `--color-ink: oklch(15% 0.030 25)` - warm near-black
+- `--color-ink-2: oklch(20% 0.030 28)` - body, a notch up
+- `--color-muted: oklch(46% 0.022 35)` - meta and bylines
+- `--color-accent: oklch(32% 0.10 28)` - dried brick furniture
+- `--color-accent-ink: oklch(45% 0.13 30)` - brick when it must read as coloured **text**
+- `--color-focus: oklch(48% 0.18 30)` - rings
+- `--color-rule: oklch(68% 0.030 40)` - hairlines and column rules; `--color-rule-2: oklch(35% 0.020 35)` - double rules
-## Signature moves
+Every value is warm (hue 25-50); no neutral grey anywhere. Brick stays under 5% of any viewport: a rule tick, a section marker, the one link, a standfirst dash, a folio mark. Never a fill behind a whole section.
-1. **Masthead over a double rule.** The hero is a **centred** wordmark in Playfair Display 700+ at display size (`--text-display`), with a thin dateline/edition row (VOL · NO · date · edition) in Inter UPPERCASE, `0.06em` tracking (`--tracking-label`), closed by a **double rule** - two lines in `--color-rule-2` oklch(35% 0.020 35) with a hairline gap. The double-rule masthead is the single most-recognisable Newsprint move. A left-aligned wordmark hero reads as SaaS nav, not broadsheet - centre it.
+## Typography
-2. **Warm cream paper, warm ink, never `#fff` / `#000`.** Paper `oklch(92% 0.045 50)`; ink `--color-ink: oklch(15% 0.030 25)` (warm near-black); body sits a notch up at `--color-ink-2: oklch(20% 0.030 28)`; meta/bylines at `--color-muted: oklch(46% 0.022 35)`. Every value is warm (hue 25-50); no neutral grey anywhere.
+- **Display** - Playfair Display 700, optical 48, `--tracking-display: -0.022em` for heads and decks.
+- **Body** - Crimson Pro at `--text-base: 1.0625rem`, `--lh-normal: 1.55`, `--measure: 58ch`. The tension between the sparkling high-contrast head and the calm book serif is the voice. Italic is Crimson Pro emphasis in running text only.
+- **Label** - Inter UPPERCASE at `0.06em` (`--tracking-label`), small: bylines, datelines, captions, section markers, table headers, folios. This small-caps furniture frames the serif columns and is the broadsheet's machine-readout register.
+- **Numerals** - IBM Plex Mono for edition figures, folios, and any tabular column.
-3. **Didone headline against book-serif body.** Playfair Display 700, optical 48, `--tracking-display: -0.022em` for heads and decks; Crimson Pro at `--text-base: 1.0625rem`, `--lh-normal: 1.55`, `--measure: 58ch` for body. The tension between the sparkling high-contrast head and the calm book serif is the voice. Italic = Crimson Pro emphasis in running text only.
+## Material
-4. **Multi-column body with a hairline column rule.** Longform flows in 2-3 columns split by a single `--color-rule` hairline oklch(68% 0.030 40): `column-rule: 1px solid var(--color-rule)`. The broadsheet sets text in columns, never one wide wall.
-
-5. **Drop cap opens the lede.** The lead story's first paragraph opens with a Playfair Display drop cap (float, ~3 lines tall) in `--color-ink` or the brick accent. One per page - the newspaper's classic entry.
-
-6. **One brick signal, < 5% of any viewport.** `--color-accent` oklch(32% 0.10 28) for a kicker tick, a pull-quote rule, a section marker; `--color-accent-ink` oklch(45% 0.13 30) when brick must read as coloured **text** (the one link, a standfirst dash); `--color-focus` oklch(48% 0.18 30) for focus rings. Never a fill behind a whole section, never a flood.
-
-7. **Furniture in the label voice.** Kickers ("OPINION", "CULTURE"), bylines ("BY A. REPORTER"), datelines, and folios in Inter UPPERCASE `0.06em`, small; edition numerals in IBM Plex Mono. This small-caps furniture frames the serif columns - it is the broadsheet's machine-readout register.
-
-8. **Rules and whitespace, no cards.** Sections divide with a `--color-rule` hairline and a `--color-rule-2` double rule at major breaks. No boxed cards, no drop-shadows, no rounded corners (radius 0). Pull-quotes hang between a top-and-bottom hairline with a brick indent, never in a box.
+- **Columns split by a hairline.** Longform flows in 2-3 columns divided by a single `--color-rule` hairline (`column-rule: 1px solid var(--color-rule)`). The broadsheet sets text in columns, never as one wide wall.
+- **The double rule.** Two lines in `--color-rule-2` with a hairline gap between them: the heaviest divider the theme owns and the most recognisable piece of its furniture. Hairlines carry the ordinary breaks, the double rule carries the major ones.
+- **Drop cap.** A Playfair Display drop cap, floated ~3 lines tall, in `--color-ink` or brick. One per page, the newspaper's classic entry.
+- **Rules and whitespace, no cards.** No boxed cards, no drop-shadows, no rounded corners: radius 0. Pulled lines hang between a top-and-bottom hairline with a brick indent, never in a box.
## Motion
-Quiet and singular. One orchestrated reveal (fade + ~10px rise) as sections enter. Hover: a brick underline-grow on links. **No parallax, no type-in, no counters, no autoplay.** Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static and fully visible.
-
-## Anti-patterns
-
-- **No pure `#fff` paper / `#000` ink.** Warm cream + warm near-black only (hue 25-50).
-- **No cool or blue accent.** Newsprint's signal is warm brick (hue 28); cool signals belong to Cobalt / Midnight.
-- **No left-aligned wordmark hero.** The masthead centres; a left wordmark is modern-minimal vocabulary.
-- **No boxed cards, drop-shadows, or rounded corners.** Hairlines and double rules carry structure; radius 0.
-- **No duo-tone, ornaments, or hard-offset shadows.** That loudness is Carnival. Newsprint is one brick signal, no mustard, no `✱` dividers.
-- **No single wide column of body text.** Longform runs in columns with a hairline column rule.
-- **No sans-serif body.** Crimson Pro serif is the body; Inter is confined to kickers, bylines, and meta.
-- **No gradient, glassmorphism, or background pattern.** The paper is flat warm cream; a faint fibre texture is the most it tolerates, off by default.
-
-## Macrostructure affinity / rejection
-
-**Newsprint loves these.**
+Quiet and singular. One orchestrated reveal (fade plus ~10px rise) as sections enter. Hover: a brick underline-grow on links. **No parallax, no type-in, no counters, no autoplay.** Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static and fully visible.
-- **Long Document** - prose-led broadsheet; *the* canonical fit
-- **Letter** - the opinion column or editor's note
-- **Quote-Led** - pull-quotes are native furniture
-- **Manifesto** - a masthead opinion statement (quieter than Carnival's)
-- **index-first** - a front-page index of headlines and standfirsts
+## Do-nots (this theme's own failure modes)
-**Newsprint refuses these.**
+- **Never a cool or blue accent.** The signal is warm brick (hue 28); cool signals belong to Cobalt and Midnight.
+- **Never boxed cards, drop-shadows, or rounded corners.** Hairlines and double rules carry structure; radius 0.
+- **Never duo-tone, ornaments, or hard-offset shadows.** That loudness is Carnival: no mustard, no `✱` dividers.
+- **Never a single wide column of body text.** Longform runs in columns with a hairline column rule.
+- **Never a sans-serif body.** Crimson Pro is the body; Inter is confined to small furniture.
+- **Never a gradient or a background pattern.** The paper is flat warm cream; a faint fibre texture is the most it tolerates, off by default.
-- **Bento Grid** - gridded product tiles; too boxed, too SaaS - broadsheet uses columns
-- **Workbench** - technical tool spec; route Cobalt
-- **Marquee Hero** - kinetic and loud; route Carnival
-- **Photographic** - image-led hero; Newsprint leads with type and rules (a captioned cut is fine, not the hero)
-
-## Voice fixtures
-
-Specific, declarative, a dry editorial wit. Name the section, the date, the fact.
-
-- *"All the type that's fit to set."*
-- *"Filed this morning. Set by hand."*
-- *"The front page, rebuilt for the screen."*
-- *"Opinion: the hairline still holds."*
-- *"Vol. IV, No. 12. Read on."*
-
-Never any of: *seamless, robust, cutting-edge, leverage, synergy, unlock, supercharge, revolutionary, curated experience, storytelling journey*. Never "click here" - name the section or the byline.
-
-## How Newsprint differs from neighbouring themes
+## How Newsprint differs from its neighbours
| vs | difference |
|---|---|
-| **Carnival** (same warm paper band) | Carnival is loud duo-tone maximalism: mustard + oxblood, Big Shoulders 800, ornaments, hard-offset shadows. Newsprint is quiet broadsheet: one brick signal, Playfair Didone, hairlines, no ornaments. Same cream, opposite volume. |
-| **Almanac** (reference-desk cousin) | Almanac is the data / reference register - tabular figures, seasonal tables, ledger rules. Newsprint is the front-page story register - masthead, drop-cap ledes, bylines, running columns. Table vs column settles it. |
-| **Riso** (print-craft cousin) | Riso is risograph craft: peach paper, CMYK misregistration, cyan + yellow. Newsprint is letterpress broadsheet: warm cream, one brick, crisp registration, Didone. Different print tradition. |
-| **Manifesto** (editorial sibling) | Manifesto is black paper + ALL-CAPS Anton in red - inverted polarity, loud. Newsprint is cream paper + Playfair + brick furniture - light and composed. Dark-vs-light settles it instantly. |
-
-## Test brief expectations
+| **Carnival** (same warm paper band) | Loud duo-tone maximalism: mustard plus oxblood, Big Shoulders 800, ornaments, hard-offset shadows. Newsprint is quiet: one brick signal, Playfair Didone, hairlines, no ornaments. Same cream, opposite volume. |
+| **Almanac** | The data and reference register - tabular figures, seasonal tables, ledger rules. Newsprint is the story register - Didone heads, drop-cap ledes, bylines, running columns. Table vs column settles it. |
+| **Riso** | Risograph craft: peach stock, CMYK misregistration, cyan plus yellow. Newsprint is letterpress broadsheet: warm cream, one brick, crisp registration, Didone. Different print tradition. |
+| **Manifesto** | Black paper plus ALL-CAPS Anton in red, inverted polarity, loud. Newsprint is cream paper plus Playfair and brick furniture, light and composed. Dark-vs-light settles it instantly. |
-Newsprint should be a candidate when the brief mentions:
+## When the brief routes here
-- *newspaper · broadsheet · editorial · magazine · journalism · publication · newsletter · op-ed · opinion · essay · longform · column · reportage · press · gazette · review · dispatch · weekly · daily · print · literary*
-- Product categories: *news publication · magazine · editorial site · newsletter · essay or blog · journalism · opinion / review · media brand · literary journal*
-- Emotional tone: *authoritative · considered · literary · print-craft · warm · trustworthy · hand-set · timeless*
+*newspaper · broadsheet · editorial · magazine · journalism · publication · newsletter · op-ed · opinion · essay · longform · column · reportage · press · gazette · review · dispatch · weekly · daily · print · literary*. Categories: news publications, magazines, editorial sites, newsletters, essays and blogs, journalism, opinion and review, media brands, literary journals. Tone: authoritative, considered, literary, print-craft, warm, trustworthy, hand-set, timeless.
-Route elsewhere: dev / API -> Cobalt; loud music / zine -> Carnival; data / reference / seasonal -> Almanac; risograph print-craft -> Riso.
+Route elsewhere: dev or API to Cobalt, loud music or zine to Carnival, data and reference to Almanac, risograph print-craft to Riso.
## Build hint
-The first lines of CSS establish Newsprint's anchor moves:
+```html
+<link href="https://fonts.googleapis.com/css2?family=Playfair+Display:ital,wght@0,700;0,800;0,900;1,700&family=Crimson+Pro:ital,wght@0,400;0,500;0,600;1,400;1,500&family=Inter:wght@500;600&family=IBM+Plex+Mono:wght@400;500&display=swap" rel="stylesheet" />
+```
```css
html, body { overflow-x: clip; }
body { background: var(--color-paper); color: var(--color-ink-2);
font-family: var(--font-body); font-weight: 400; line-height: var(--lh-normal); }
-/* Masthead: centred wordmark closed by a double rule */
-.masthead { text-align: center; font-family: var(--font-display); font-weight: 700;
- letter-spacing: var(--tracking-display); }
-.masthead::after { content: ""; display: block; height: 4px;
- border-top: 1px solid var(--color-rule-2);
- border-bottom: 1px solid var(--color-rule-2); }
-.kicker, .byline { font-family: var(--font-label); text-transform: uppercase;
- letter-spacing: var(--tracking-label); color: var(--color-muted); }
+/* Didone display + the double rule, the heaviest divider in the theme */
+.display { font-family: var(--font-display); font-weight: 700;
+ letter-spacing: var(--tracking-display); }
+.rule--double { height: 4px; border-top: 1px solid var(--color-rule-2);
+ border-bottom: 1px solid var(--color-rule-2); }
+
+/* Label voice - bylines, datelines, captions, folios */
+.byline, .folio { font-family: var(--font-label); text-transform: uppercase;
+ letter-spacing: var(--tracking-label); color: var(--color-muted); }
/* Columns with a hairline rule; drop cap opens the lede */
-.story { columns: 2; column-gap: 2.5rem; column-rule: 1px solid var(--color-rule);
+.columns { columns: 2; column-gap: 2.5rem; column-rule: 1px solid var(--color-rule);
max-width: var(--measure); }
-.story > p:first-of-type::first-letter { float: left; font-family: var(--font-display);
+.columns > p:first-of-type::first-letter { float: left; font-family: var(--font-display);
font-weight: 800; font-size: 3.4em; line-height: 0.8; padding-right: 0.06em; }
/* The one brick signal */
@@ -140,4 +109,4 @@ a { color: var(--color-accent-ink); text-decoration-color: var(--color-accent);
@media (prefers-reduced-motion: reduce) { .reveal { opacity: 1; transform: none; transition: none; } }
```
-Plus the Playfair Display + Crimson Pro + Inter + IBM Plex Mono link and the small reveal script.
+Plus one `IntersectionObserver` adding `.is-in`. Newsprint supplies the stock, the two serifs, the rule vocabulary, and one brick mark; what gets filed on that page is the brief's business.
diff --git a/skills/hallmark/references/themes/riso.md b/skills/hallmark/references/themes/riso.md
index efbc165..5025358 100644
--- a/skills/hallmark/references/themes/riso.md
+++ b/skills/hallmark/references/themes/riso.md
@@ -1,8 +1,8 @@
# Theme - Riso
-Risograph-print register. The page for a **print fair, zine fest, small press, poster shop, illustration studio, art-book event** - warm blush stock, two saturated spot inks printed slightly out of register, paper you can almost smell. It reads like a soy-ink poster that got a URL: heavy grotesk headlines misregistered in cyan and pink, a serif lede, a machine-set catalogue underneath.
+Risograph-print register: warm blush stock, two saturated spot inks printed slightly out of register, paper you can almost smell. It reads like a soy-ink poster that got a URL - heavy grotesk misregistered in blue and pink, a serif lede, machine-set labels underneath.
-Loaded eagerly by SKILL.md Step 3 when the catalog pick is `riso`. Tokens: [`site/css/tokens.css`](../../../../site/css/tokens.css) `[data-theme="riso"]`. Reference build: [`site/examples/riso-01/`](../../../../site/examples/riso-01/) (an "OFF-REGISTER" risograph print fair - masthead, misregistered hero mark, exhibitor catalogue).
+The material, in one line: **pink stock, two spot inks multiplied, an offset that missed the drum, grain on the ink.**
## Axes (diversification)
@@ -12,104 +12,72 @@ Loaded eagerly by SKILL.md Step 3 when the catalog pick is `riso`. Tokens: [`sit
## Reference register
-Risotto Studio · Hato Press · Nieves · Colorama · People of Print · Present & Correct · Draw Down Books · It's Nice That · Printed Matter fairs.
+Risotto Studio · Hato Press · Nieves · Colorama · People of Print · Present & Correct · Draw Down Books · It's Nice That · Printed Matter fairs. **Never name any of these in the output.**
-The aesthetic: the risograph poster and small-press catalogue - warm stock, spot-colour duotone, deliberate misregistration, halftone grain, an inventory laid out like a listings page. Never name any of these in the output.
+The material to match: warm stock, spot-colour duotone, deliberate misregistration, halftone grain. Internally: *a two-colour riso print that missed register by a hair* - the offset is the charm, not a defect. When in doubt ask "does this look printed on a drum, or exported from a vector tool?" Keep the former.
-**Patron-saint reference (internal):** *a two-colour riso print that missed register by a hair* - the offset is the charm, not a defect. When in doubt, ask "does this look printed on a drum, or exported from a vector tool?" Keep the former.
+## Palette
-## Required dependencies
+Canonical values live in [`site/css/tokens.css`](../../../../site/css/tokens.css) under `[data-theme="riso"]`.
-1. **Fonts** - **Public Sans** (display 800/900 + labels), **Newsreader** (serif body/lede), **Geist Mono** (uppercase machine labels, captions, counts). Google Fonts:
- ```html
- <link href="https://fonts.googleapis.com/css2?family=Public+Sans:wght@400;600;800;900&family=Newsreader:ital,opsz,wght@0,6..72,400;0,6..72,500;1,6..72,400&family=Geist+Mono:wght@400;500;700&display=swap" rel="stylesheet" />
- ```
-2. **A small reveal script** - one `IntersectionObserver` adding `.is-in` (fade + ~10px rise, ease-out ~600ms). No autoplay, no loop.
-3. **The `riso-mis` overprint** - a headline word / wordmark carries two offset echoes via `data-text` + `::before`/`::after`, `mix-blend-mode: multiply`. This is the theme's whole identity; ship it on at least the hero title and the masthead.
+- `--color-paper: oklch(84% 0.048 30)` - warm pink stock, never white; panels step to `80%` / `75%` on the same hue
+- `--color-ink: oklch(18% 0.060 30)` - warm near-black
+- `--color-neutral: oklch(34% 0.060 30)` - body
+- `--color-accent: oklch(46% 0.140 220)` - riso blue, spot ink one
+- `--color-accent-2: oklch(78% 0.180 95)` - riso yellow, spot ink two
+- the pink echo in the overprint: `oklch(64% 0.19 12)`
+- `--color-rule: oklch(70% 0.040 30)` - hairline
-## Signature moves
+Every neutral tilts hue 30. Blue and yellow are the only colours; where they cross, `mix-blend-mode: multiply` makes a third hue for free. Keep the two inks under ~15% of any viewport: the blush paper stays dominant.
-1. **Off-register overprint (THE move)** - a key headline word and the wordmark get a misregistered echo: `::before` in riso blue `oklch(46% 0.140 220)` nudged up-left ~2px, `::after` in a riso pink nudged down-right ~2px, both `mix-blend-mode: multiply` over the black `data-text`. The colour fringes read as ink that missed the drum. Use on 1-2 focal words only, never every heading.
+## Typography
-2. **Warm pink stock, never white** - ground is `oklch(84% 0.048 30)`, panels step to `--color-paper-2` / `--color-paper-3` (80% / 75%, same hue). Ink is warm near-black `oklch(18% 0.060 30)`, body `--color-neutral` `oklch(34% 0.060 30)`. Every neutral tilts hue 30.
+- **Display** - Public Sans 800/900 at `-0.04em`, `--lh-tight: 0.92`. Poster weight.
+- **Body / lede** - Newsreader serif at 45-75ch. The poster-headline against reading-serif contrast is load-bearing.
+- **Label** - Geist Mono, UPPERCASE, `--tracking-label: 0.06em`. The print-shop readout voice: plate captions (`Plate 04 · 3 colours · 280 gsm`), item counts, table headers, meta rows, folios, units, and entry numbers inside a real `<ol>`. It states a printed fact; it never sits above a heading to announce it.
-3. **Two spot inks, overprinted and multiply-blended** - blue 220° + yellow 95° are the only colours. Where they cross, `mix-blend-mode: multiply` makes a third hue for free. The pure-CSS riso plate centrepiece = three ink shapes stacked, misregistered, multiplied, with a grain layer on top.
+## Material
-4. **Halftone / paper grain** - a faint noise or dot-grain overlay sits on the ink art (and optionally very lightly on paper) so fills read printed, not vector. Riso is the one editorial theme where texture belongs - keep it on the ink, subtle, never a loud full-page flood. Recipes and budget: [`texture.md`](../texture.md) § Grain and § Misregistration.
-
-5. **Newspaper masthead + catalogue body** - N6 masthead: issue line (`Edition 04 · Govanhill · Free entry`), big wordmark, thin nav, double rule. The page body is a **Catalogue/Specimen** - a uniform, filterable grid of exhibitors/items. Riso is an index, not a sales pitch.
-
-6. **Heavy grotesk over serif** - Public Sans 800/900 display at `-0.04em` and `--lh-tight: 0.92`; Newsreader serif for lede and running body at 45-75ch. The poster-headline / reading-serif contrast is load-bearing.
-
-7. **Mono machine labels** - Geist Mono, UPPERCASE, `--tracking-label: 0.06em` for kickers, plate captions (`Plate 04 · 3 colours · 280 gsm`), item counts, meta. The print-shop readout voice against the grotesk.
-
-8. **Spot highlight + hairlines, zero shadow** - single-accent `<mark>` band at x-height, `--color-rule` `oklch(70% 0.040 30)` hairlines, solid rectangle buttons. No boxed cards, no drop-shadow, no blur; depth comes from overprint and rule.
+- **Off-register overprint (THE move).** A key word or a mark gets a misregistered echo: `::before` in riso blue nudged up-left ~2px, `::after` in riso pink nudged down-right ~2px, both `mix-blend-mode: multiply` over the black `data-text`. The colour fringes read as ink that missed the drum. Use on 1-2 focal words only, never every heading. Ship it at least once per page or the theme is not present.
+- **Halftone / paper grain.** A faint noise or dot-grain overlay sits on the ink art (and optionally very lightly on paper) so fills read printed, not vector. Riso is the one editorial theme where texture belongs - keep it on the ink, subtle, never a loud full-page flood. Recipes and budget: [`texture.md`](../texture.md) § Grain and § Misregistration.
+- **Hairlines and a spot highlight, zero shadow.** A single-accent `<mark>` band at x-height, `--color-rule` hairlines, solid rectangle buttons at ~2px radius. No boxed cards, no drop-shadow, no blur; depth comes from overprint and rule.
## Motion
-Quiet and printed. Section reveals fade + rise once. The misregistration may settle on load (echoes drift a hair into their offset, then rest) but never loops. Hover: rule-colour shift to accent, mark-band grow. No bounce, no parallax, no autoplay. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships the offsets static and fully visible.
-
-## Anti-patterns
-
-- **No clean vector flatness** - riso must show the offset fringe + grain. Perfectly-registered, texture-free fills read as generic and kill the theme.
-- **No cool-white or pure-white paper** - that is Cobalt's ground. Riso paper is warm blush, hue 30.
-- **No pure `#000` ink** - warm near-black `oklch(18% 0.060 30)`.
-- **No gradient / glow / neon / aurora-mesh** - riso is flat spot inks multiplied, not RGB light. Colour comes from overprint, not luminance.
-- **No drop shadows, no boxed or card-in-card layouts** - hairlines and overprint carry structure.
-- **No floating pill nav, no pill-gradient CTA** - masthead + a solid rectangle button.
-- **Don't drown the page in ink** - two spot colours as accents (< ~15% of any viewport); the blush paper stays dominant.
-- **Don't borrow Carnival's kit** - its offset is a hard solid box-shadow and its duo is mustard/oxblood. Riso's offset is ink misregistration; its duo is blue/yellow. Keep them apart.
-
-## Macrostructure affinity / rejection
+Quiet and printed. Section reveals fade and rise ~10px once, ease-out ~600ms, from one `IntersectionObserver`. The misregistration may settle on load (echoes drift a hair into their offset, then rest) but never loops. Hover: rule colour shifts to accent, the mark band grows. No bounce, no parallax, no autoplay. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships the offsets static and fully visible.
-**Riso loves these.**
+## Voice range
-- **Catalogue** - the exhibitor / item / stockist index grid *(canonical - riso-01)*
-- **Specimen** - a type or print specimen shown in overprint
-- **Marquee Hero** - one big off-register poster statement above the fold
-- **Type-specimen** - the grotesk face demoed in spot colour
-- **Manifesto** - a loud printed statement page (print-fair voice)
+Specific, hand-set, a little literary. Verbs and counts over adjectives: name the ink, the press run, the paper weight. Never *seamless, cutting-edge, revolutionary, synergy, leverage, premium, glossy, pixel-perfect*. Riso is deliberately imperfect - never sell it as flawless.
-**Riso refuses these.**
+## Do-nots (this theme's own failure modes)
-- **Workbench / component-playground** - too instrument-panel; that is Cobalt's shape
-- **Conversational FAQ** - too chatty-product for a print object
-- **Photographic** - riso leads with printed ink art, not photography
-- **Stat-Led / Bento dashboard** - riso is a printed page, not a metrics grid
+- **No clean vector flatness.** Riso must show the offset fringe and the grain. Perfectly-registered, texture-free fills kill the theme.
+- **No cool-white or pure-white paper.** That is Cobalt's ground. Riso paper is warm blush, hue 30.
+- **No pure `#000` ink.** Warm near-black `oklch(18% 0.060 30)`.
+- **No gradient, glow, neon, or aurora-mesh.** Riso is flat spot inks multiplied, not RGB light. Colour comes from overprint, not luminance.
+- **No drop shadows, no boxed or card-in-card layouts, no pill-gradient CTA.** Hairlines and overprint carry structure; a button is a solid rectangle.
+- **Don't borrow Carnival's kit.** Its offset is a hard solid box-shadow and its duo is mustard/oxblood. Riso's offset is ink misregistration; its duo is blue/yellow.
-## Voice fixtures
-
-Specific, hand-set, a little literary. Verbs and counts over adjectives.
-
-- *"Thirty-four studios. Eight presses. Soy ink everywhere."*
-- *"Design like print: warm, off-register, intentional."*
-- *"One drum at a time."*
-- *"Fluorescent pink that won't sit still, teal that bleeds a hair past its edge."*
-- *"Free entry - first 200 get a printed map."*
-
-Never any of: *seamless, cutting-edge, revolutionary, synergy, leverage, premium, glossy, pixel-perfect*. Never "click here." Riso is deliberately imperfect - never sell it as flawless.
-
-## How Riso differs from neighbouring themes
+## How Riso differs from its neighbours
| vs | what settles it instantly |
|---|---|
-| **Carnival** (loud editorial sibling) | Carnival = duotone mustard + oxblood, chunky variable display, hard-offset **box-shadow**, decorative ornaments. Riso = blue + yellow **spot inks**, off-register overprint + grain (misregistration, not a solid shadow), warm pink stock. Offset-as-ink vs offset-as-shadow. |
-| **Newsprint** (paper sibling) | Newsprint = warm cream stock, columns, one-brick ink-only restraint (no spot colour). Riso = warm pink stock + two saturated spot inks (blue + yellow) + printed grain. Spot colour and print-artifact texture settle it. |
-| **Brutal** (editorial sibling) | Brutal = raw system type, hard mono borders, cold. Riso = crafted print object - grotesk + serif, spot inks, grain, warmth. Craft and colour vs raw and monochrome. |
+| **Carnival** (loud editorial sibling) | Carnival is duotone mustard + oxblood, chunky variable display, hard-offset **box-shadow**, decorative ornaments. Riso is blue + yellow **spot inks**, off-register overprint plus grain, warm pink stock. Offset-as-ink vs offset-as-shadow. |
+| **Newsprint** (paper sibling) | Newsprint is warm cream stock and one-brick ink-only restraint, no spot colour. Riso is warm pink stock, two saturated spot inks, printed grain. Spot colour and print-artifact texture settle it. |
+| **Brutal** (editorial sibling) | Brutal is raw system type, hard mono borders, cold. Riso is a crafted print object - grotesk plus serif, spot inks, grain, warmth. Craft and colour vs raw and monochrome. |
-## Test brief expectations
+## When the brief routes here
-Riso should be a candidate when the brief mentions:
+*risograph · riso · print fair · zine · zine fest · small press · letterpress · screenprint · poster · gig poster · art book · book fair · spot colour · illustration studio · indie press · DIY · print studio · stockist*. Categories: print fairs, zine fests, art-book events, poster shops, illustration and print studios, indie publishers, creative-studio events. Tone: warm, tactile, handmade, off-register, analog, playful-craft, printed.
-- *risograph · riso · print fair · zine · zine fest · small press · letterpress · screenprint · poster · gig poster · art book · book fair · spot colour · illustration studio · indie press · DIY · print studio · stockist*
-- Product categories: *print fair · zine fest · art-book event · poster shop · illustration / print studio · indie publisher · creative-studio event*
-- Emotional tone: *warm · tactile · handmade · off-register · analog · spot-colour · playful-craft · printed*
-
-Briefs that are cool/technical route to Cobalt; loud-decorative editorial routes to Carnival; grey ink-only routes to Newsprint. When the brief wants ink on warm stock with a colour that misses register, it is Riso.
+Cool and technical routes to Cobalt; loud-decorative editorial routes to Carnival; grey ink-only routes to Newsprint. When the brief wants ink on warm stock with a colour that misses register, it is Riso.
## Build hint
-The first lines of CSS establish Riso's anchor moves:
+```html
+<link href="https://fonts.googleapis.com/css2?family=Public+Sans:wght@400;600;800;900&family=Newsreader:ital,opsz,wght@0,6..72,400;0,6..72,500;1,6..72,400&family=Geist+Mono:wght@400;500;700&display=swap" rel="stylesheet" />
+```
```css
html, body { overflow-x: clip; }
@@ -136,4 +104,6 @@ mark { background: var(--color-accent-2); color: var(--color-ink); } /* yellow b
@media (prefers-reduced-motion: reduce) { .reveal { opacity: 1; transform: none; } }
```
-Plus the Public Sans + Newsreader + Geist Mono link and the small reveal script. Reference build: [`site/examples/riso-01/`](../../../../site/examples/riso-01/) (built on the pre-2026-07 tokens; example builds are dated artifacts and are never retro-edited when a theme’s tokens move) - match its register (tokens, voice, motion feel), never its composition; reusing its section order, hero geometry, or grid is a gate-32-grade repeat.
+Reference build: [`site/examples/riso-01/`](../../../../site/examples/riso-01/) (built on the pre-2026-07 tokens; example builds are dated artifacts and are never retro-edited when a theme's tokens move) - match its register, never its composition; reusing its section order, hero geometry, or grid is a gate-32-grade repeat.
+
+The rest of the page is yours. Riso supplies the stock, the two inks, and the offset; what gets printed on that paper is the brief's business, not the theme's.
diff --git a/skills/hallmark/references/themes/specimen.md b/skills/hallmark/references/themes/specimen.md
index e2f0e45..5227212 100644
--- a/skills/hallmark/references/themes/specimen.md
+++ b/skills/hallmark/references/themes/specimen.md
@@ -1,101 +1,81 @@
# Theme - Specimen
-The `:root` default and the canonical Hallmark editorial voice. The page for a **type foundry, a design portfolio, a magazine essay, an agency site, a considered brand story** - the type-specimen school, where one high-contrast serif set enormous and thin *is* the page. Warm oat paper, a single signal-orange mark, ruler-drawn hairlines, and Fraunces shown at specimen scale. It reads like a well-set printed page: quiet, warm, exact.
+The canonical Hallmark editorial voice and the catalog's silent default: the type-specimen school, where one high-contrast serif set enormous and thin *is* the page. Warm oat paper, a single signal-orange mark, ruler-drawn hairlines, Fraunces shown at specimen scale. It reads like a well-set printed page: quiet, warm, exact.
-Loaded eagerly by SKILL.md Step 3 whenever the catalog pick is `specimen` (also the silent default when no other theme signal fires). Tokens: [`site/css/tokens.css`](../../../../site/css/tokens.css) under `:root` / `[data-theme="specimen"]`. No canonical example folder yet - build to this spec.
+The material, in one line: **oat paper, one thin serif at scale, hairlines, and a single orange mark.**
## Axes (diversification)
- **Paper band** - warm oat (`oklch(96% 0.018 80)`, hue 80). A cream near-white with real yellow warmth, distinct from Almanac's cool blue-grey oat and Atelier's near-neutral taupe.
-- **Display style** - **high-contrast serif** (Fraunces, light). `--display-weight: 340`, `--display-optical: 144` (the largest, highest-contrast optical cut), `--display-soft: 20`. Thin and elegant, never the black display of Atelier/Newsprint.
-- **Accent hue** - **signal orange** (`#FC4C02`, hue ~33). One warm spark, `--color-accent-ink: oklch(55% 0.21 32)` for legible orange text on oat. A signal, never a flood.
+- **Display style** - **high-contrast serif** (Fraunces, light). `--display-weight: 340`, `--display-optical: 144` (the largest, highest-contrast optical cut), `--display-soft: 20`. Thin and elegant, never the black display of Atelier or Newsprint.
+- **Accent hue** - **signal orange** (`#FC4C02`, hue ~33). One warm spark, with `--color-accent-ink: oklch(55% 0.21 32)` for legible orange text on oat. A signal, never a flood.
## Reference register
-Klim / Commercial Type foundry specimens · Pentagram · Aesop · Cereal · Kinfolk · It's Nice That · Readymag editorial · Frere-Jones. The aesthetic: the printed type specimen and the considered editorial portfolio - one serif shown at scale, hairline structure, mono folios, generous paper. **Never name any of these in the output.**
+Klim and Commercial Type foundry specimens · Pentagram · Aesop · Cereal · Kinfolk · It's Nice That · Readymag editorial · Frere-Jones.
-**Patron-saint reference (internal):** *a type foundry's specimen sheet* - one word set at 96pt, a weight ladder, a glyph grid, a single ink colour. When in doubt ask "does this read like a printed specimen, or a marketing template?" Keep the former.
+The material to match: the printed type specimen and the considered editorial page - one serif shown at scale, hairline structure, mono folios, generous paper, a single ink colour. Ask "does this read like a printed specimen, or a marketing template?" Keep the former. **Never name any of these in the output.**
-## Required dependencies
+**Voice range:** editorial, hand-set, lightly literary. Verbs over adjectives; name the thing concretely, name the number.
-1. **Fonts** - **Fraunces** (display + serif emphasis, variable opsz/wght/SOFT), **Geist** (body sans, 400/500/600), **Geist Mono** (labels + meta). Google Fonts:
- ```html
- <link rel="preconnect" href="https://fonts.googleapis.com">
- <link href="https://fonts.googleapis.com/css2?family=Fraunces:ital,opsz,wght,SOFT@0,9..144,300..700,0..100;1,9..144,300..700,0..100&family=Geist:wght@400;500;600&family=Geist+Mono:wght@400;500&display=swap" rel="stylesheet">
- ```
-2. **A small reveal script** - one `IntersectionObserver` adding `.is-in` (fade + ~10px rise, `--ease-out`, ~600ms). Optional one-shot: a weight/optical ladder that settles once, then static. No other required JS - Specimen is a reading page, not a tool.
+## Palette
-## Signature moves
+- `--color-paper: oklch(96% 0.018 80)` - warm oat, never `#fff`
+- `--color-ink: oklch(18% 0.014 60)` - warm near-black, never `#000`
+- `--color-ink-2: oklch(26% 0.014 60)` - body, a notch up
+- `--color-muted` - meta and folios
+- `--color-accent: #FC4C02` - signal orange, the one spark
+- `--color-accent-ink: oklch(55% 0.21 32)` - orange that stays legible as text on oat
+- `--color-rule` at `--rule-card: 1px`, `--rule-hair: 0.5px`
-1. **Warm oat paper, never `#fff`** - `--color-paper: oklch(96% 0.018 80)`. Ink is warm near-black `--color-ink: oklch(18% 0.014 60)`, never `#000`; body sits a notch up at `--color-ink-2: oklch(26% 0.014 60)`. Everything tinted warm (hue 60-80).
+Everything is tinted warm (hue 60-80). Orange stays under 5% of any viewport: a link underline, one control, the drop cap, the focus ring, a single italic emphasis. It never fills a band or a surface, and there is no second accent.
-2. **Specimen-scale Fraunces, thin and huge** - the hero is one word or a short phrase set enormous and LIGHT: `--display-weight: 340`, `font-variation-settings: "opsz" 144, "SOFT" 20`, `--text-display: clamp(3rem, 5.5vw + 1rem, 5.75rem)`, `--tracking-display: -0.025em`, `--lh-tight: 1.02`. The high-contrast serif carries the page; the type *is* the graphic.
+## Typography
-3. **One signal-orange mark, < 5% of any viewport** - `--color-accent: #FC4C02` on the eyebrow tick, a link underline, one CTA, the drop cap, the focus ring, a single italic emphasis. Everything else is warm ink on oat. Orange never fills a band or a card.
+- **Display** - Fraunces at `--display-weight: 340`, `font-variation-settings: "opsz" 144, "SOFT" 20`, `--text-display: clamp(3rem, 5.5vw + 1rem, 5.75rem)`, `--tracking-display: -0.025em`, `--lh-tight: 1.02`. One word or a short phrase set enormous and light: the high-contrast serif carries the page and the type *is* the graphic.
+- **Body** - Geist at `--measure: 62ch`, `--lh-normal: 1.45`. The sans-under-serif contrast is the specimen tension.
+- **Serif emphasis** - Fraunces italic for pulled lines and single-word emphasis only, never the display face.
+- **Label** - Geist Mono, UPPERCASE, `--tracking-label: 0.12em`, `--text-xs`, `--color-muted`. The machine-readout counterpoint that keeps the warm serif from going soft: meta rows, folios, figure captions, table headers, units.
-4. **Hairlines, square corners, no shadow** - `--rule-card: 1px`, `--radius-card: 0`, `--shadow-card: none`, `--rule-hair: 0.5px`. Structure is drawn with rules, columns, double-rules and fleurons - never boxed cards or blur. Editorial ornament (fleuron, drop cap) is welcome; depth is not.
+## Material
-5. **Geist Mono uppercase labels** - eyebrows, meta, folios, figure captions in `--font-mono` (Geist Mono), UPPERCASE, `--tracking-label: 0.12em`, `--text-xs`, colour `--color-muted`. The machine-readout counterpoint that keeps the warm serif from going soft.
-
-6. **Sans body under a serif display** - body is Geist (`--font-body`) at `--measure: 62ch`, `--lh-normal: 1.45`. The sans-under-serif contrast is the specimen tension. Fraunces italic is for pull-quotes and single-word emphasis only, never the display face (global rule).
-
-7. **Asymmetric editorial grid** - `--page-max: 76rem`, left-biased hero (headline left, meta or figure right), 2:5 or 3:7 prose columns, edge-aligned headlines. Never centred-everything (gate 6).
-
-8. **Specimen character on show** - an orange Fraunces drop cap, a weight/optical ladder, a glyph or figure row, mono folio numbers. The page quietly demonstrates the typeface it is set in.
+- **Hairlines, square corners, no shadow.** `--rule-card: 1px`, `--radius-card: 0`, `--shadow-card: none`, `--rule-hair: 0.5px`. Structure is drawn with rules, columns, and double rules, never boxed surfaces or blur.
+- **Editorial ornament, no depth.** A fleuron or an orange Fraunces drop cap is welcome; a shadow is not. Where the page ornaments itself, the ornament demonstrates the face it is set in.
+- **Generous paper.** `--page-max: 76rem`. Whitespace and the size of the type do the work.
## Motion
-Quiet and composed. One orchestrated entrance: section reveals fade + rise (`--ease-out`, ~600ms). Optionally one weight/optical ladder that settles once, then holds static. Hover: orange underline-grow on links; a 1px rule shift toward accent on focusable surfaces. No bounce, no parallax, no autoplay. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static and fully visible.
-
-## Anti-patterns
-
-- **No pure `#fff` paper / `#000` ink.** Warm oat, warm near-black - always tinted toward hue 60-80.
-- **No heavy/black display.** Fraunces stays light (340). Playfair-900 heft is Atelier's move; a bold hero reads as a different theme.
-- **No cool paper.** Cool blue-grey oat is Almanac's; salmon-pink is Newsprint's. Specimen is warm.
-- **No second accent.** One signal orange only - no teal, blue, or companion hue.
-- **No rounded corners, pills, or shadows.** Square, hairline, flat.
-- **No card-in-card, no three-equal-icon-tile grid, no glassmorphism, no gradient text, no mesh/aurora blob, no background texture.** Oat paper + hairlines + one orange mark carry it.
-- **No orange flood.** The accent is a spark on a mark, never a fill behind type or a full band.
-
-## Macrostructure affinity / rejection
+Quiet and composed. One orchestrated entrance: reveals fade and rise (`--ease-out`, ~600ms). Optionally one weight or optical ladder that settles once, then holds static. Hover: an orange underline-grow on links, a 1px rule shift toward accent on focusable surfaces. No bounce, no parallax, no autoplay. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static and fully visible.
-**Specimen loves:** **Type Specimen / Specimen** *(canonical - one face at scale, weight ladder, glyph grid)* · **Long Document** (editorial essay, drop cap, hairlines) · **Portfolio Grid** (a considered work index) · **Manifesto** (when the serif carries a statement) · **Letter / Quote-Led** (intimate editorial voice).
+## Do-nots (this theme's own failure modes)
-**Specimen refuses:** **Workbench / component-playground** (tool-first, route Cobalt/Almanac) · **Bento Grid** (modular tile logic fights the column) · **Stat-Led dashboard** (numbers-first apparatus) · **Map-diagram / ecosystem-index** (systems diagram, not a printed page).
+- **Never a heavy or black display.** Fraunces stays light (340). Playfair-900 heft is Atelier's move; a bold hero reads as a different theme.
+- **Never cool paper.** Cool blue-grey oat is Almanac's, warm pink cream is Newsprint's. Specimen is oat.
+- **Never a second accent.** One signal orange only: no teal, no blue, no companion hue.
+- **Never an orange flood.** The accent is a spark on a mark, never a fill behind type or a full band.
+- **Never rounded corners, pills, or shadows.** Square, hairline, flat.
+- **Never background texture, mesh, or gradient.** Oat paper plus hairlines plus one orange mark carry it.
-## Voice fixtures
+## How Specimen differs from its neighbours
-Editorial, hand-set, lightly literary. Verbs over adjectives; name the thing concretely.
-
-- *"Set in Fraunces, at ninety-six points."*
-- *"One typeface, argued at length."*
-- *"Warm paper, cold rules, one orange mark."*
-- *"Weight three-forty. Optical size one-forty-four. Nothing louder."*
-- *"The page, composed like a specimen sheet."*
-
-Never any of: *seamless, robust, cutting-edge, leverage, synergy, elevate, unlock, supercharge, curated*. Never "click here" - name the section, the number, the face.
-
-## How Specimen differs from neighbouring themes
-
-| vs | what settles it instantly |
+| vs | difference |
|---|---|
-| **Atelier** (editorial serif sibling) | Atelier is Playfair Display at weight **900** (heavy, dramatic), near-neutral taupe paper, oxblood/near-black accent (`oklch(22% 0.060 40)`). Specimen is Fraunces at **340** (thin), warmer oat, signal-orange accent. Thin-plus-orange vs black-plus-oxblood. |
-| **Newsprint** (broadsheet) | Newsprint is salmon-pink paper (`oklch(92% 0.045 50)`), **serif body** (Crimson Pro), Playfair-700 display, burgundy accent, broadsheet columns. Specimen has **sans body** (Geist), oat not pink, orange not burgundy. |
-| **Almanac** (technical almanac) | Almanac is **cool** blue-grey paper (hue 245), **sans display** (Hanken Grotesk), blue accent, dense small type. Specimen is warm, serif-display, orange. Warm-serif vs cool-sans. |
-
-## Test brief expectations
+| **Atelier** | Playfair Display at weight **900** (heavy, dramatic), near-neutral taupe paper, oxblood accent (`oklch(22% 0.060 40)`). Specimen is Fraunces at **340** (thin), warmer oat, signal orange. Thin-plus-orange vs black-plus-oxblood. |
+| **Newsprint** | Pinker cream paper (`oklch(92% 0.045 50)`), a **serif body** (Crimson Pro), Playfair 700 display, brick accent, broadsheet columns. Specimen has a **sans body** (Geist), oat not pink, orange not brick. |
+| **Almanac** | **Cool** blue-grey paper (hue 245), a **sans display** (Hanken Grotesk), blue accent, dense small type. Specimen is warm, serif-display, orange. Warm-serif vs cool-sans. |
-Specimen is a candidate (and the default fallback) when the brief mentions:
+## When the brief routes here
-- *type specimen · typography · foundry · letterform · portfolio · editorial · magazine · essay · manifesto · studio · agency · brand story · print · publication · considered · craft · design-led*
-- Product categories: *type foundry · design portfolio · editorial/magazine · agency site · personal site · brand story · indie publication*
-- Emotional tone: *literary · hand-set · warm · considered · high-craft · quiet-confident · editorial*
+*type specimen · typography · foundry · letterform · portfolio · editorial · magazine · essay · manifesto · studio · agency · brand story · print · publication · considered · craft · design-led*. Categories: type foundries, design portfolios, editorial and magazine sites, agency sites, personal sites, brand stories, indie publications. Tone: literary, hand-set, warm, considered, high-craft, quiet-confident.
-When the brief names no specialised aesthetic ("a landing page for X"), it lands here. Cool/technical routes to Almanac or Cobalt; loud-maximalist to Carnival; heavy-dramatic serif to Atelier.
+When the brief names no specialised aesthetic ("a landing page for X"), it lands here. Cool or technical routes to Almanac or Cobalt, loud-maximalist to Carnival, heavy-dramatic serif to Atelier.
## Build hint
-The first lines of CSS establish Specimen's anchor moves:
+```html
+<link rel="preconnect" href="https://fonts.googleapis.com">
+<link href="https://fonts.googleapis.com/css2?family=Fraunces:ital,opsz,wght,SOFT@0,9..144,300..700,0..100;1,9..144,300..700,0..100&family=Geist:wght@400;500;600&family=Geist+Mono:wght@400;500&display=swap" rel="stylesheet">
+```
```css
html, body { overflow-x: clip; }
@@ -108,7 +88,7 @@ body { background: var(--color-paper); color: var(--color-ink-2);
font-size: var(--text-display); letter-spacing: var(--tracking-display);
line-height: var(--lh-tight); }
-/* Mono label - the machine-readout counterpoint */
+/* Mono label - the machine-readout counterpoint (meta, folios, captions) */
.label { font-family: var(--font-mono); text-transform: uppercase;
letter-spacing: var(--tracking-label); font-size: var(--text-xs);
color: var(--color-muted); }
@@ -118,7 +98,7 @@ body { background: var(--color-paper); color: var(--color-ink-2);
.card { border: var(--rule-card) solid var(--color-rule);
border-radius: var(--radius-card); box-shadow: var(--shadow-card); }
-/* The one signal - orange, used sparingly */
+/* The one signal - orange, used sparingly; the drop cap spends it well */
a { text-decoration-color: var(--color-accent); }
.dropcap::first-letter { color: var(--color-accent); font-family: var(--font-display); }
:focus-visible { outline: 2px solid var(--color-focus); }
@@ -131,4 +111,4 @@ a { text-decoration-color: var(--color-accent); }
}
```
-Plus the Fraunces + Geist + Geist Mono link and the small reveal script.
+Plus one `IntersectionObserver` adding `.is-in`. Specimen supplies the oat, the one serif, the hairline vocabulary, and the single orange mark; what is set in that face is the brief's business.
diff --git a/skills/hallmark/references/themes/sport.md b/skills/hallmark/references/themes/sport.md
index 15c5722..be30e4b 100644
--- a/skills/hallmark/references/themes/sport.md
+++ b/skills/hallmark/references/themes/sport.md
@@ -1,8 +1,8 @@
# Theme - Sport
-Athletic editorial, scoreboard register. The page for a running club, a race event, a training program, a team or league, a performance-gear drop, a fixtures / standings board. A cool concrete-grey ground (`oklch(98% 0.003 250)`), blue-black ink (`oklch(16% 0.080 260)`), uppercase condensed Inter Tight heads, tabular JetBrains Mono numerals, and exactly ONE blaze-orange signal (`oklch(58% 0.190 35)`). It reads like a timed event: fast, measured, competitive.
+Athletic editorial, scoreboard register. A cool concrete-grey ground, blue-black ink, uppercase condensed heads, tabular mono numerals, and exactly ONE blaze-orange signal. It reads like a timed event: fast, measured, competitive.
-Loaded eagerly by SKILL.md Step 3 when the catalog pick is `sport`. Tokens: `site/css/tokens.css` `[data-theme="sport"]`. No canonical build yet; mirror the token anchors in Build hint below.
+The material, in one line: **cool concrete, blue-black ink, tight caps, tabular numerals, one blaze-orange.**
## Axes (diversification)
@@ -12,99 +12,76 @@ Loaded eagerly by SKILL.md Step 3 when the catalog pick is `sport`. Tokens: `sit
## Reference register
-On Running · Bandit Running · Soar · District Vision · Strava · Whoop · Formula 1 result boards · NBA scoreboards · Wilson · Gymshark.
+On Running · Bandit Running · Soar · District Vision · Strava · Whoop · Formula 1 result boards · NBA scoreboards · Wilson · Gymshark. **Never name any of these in the output.**
-The aesthetic: the clinical performance grid, the race-bib crop, the standings table, the split-time readout. **Patron-saint (internal):** a stadium scoreboard's mono precision + a running-club singlet, recoloured blaze-orange on cool concrete. When in doubt ask "does this read like a timed result board, or a wellness landing page?" Keep the former. **Never name any of these in the output.**
+The material to match: the clinical performance grid, the race-bib crop, the standings table, the split-time readout. Internally: a stadium scoreboard's mono precision plus a running-club singlet, recoloured blaze-orange on cool concrete. When in doubt ask "does this read like a timed result board, or a wellness landing page?" Keep the former.
-## Required dependencies
+## Palette
-1. **Fonts** - **Inter Tight** (display, 700/800, uppercase), **Albert Sans** (body, 400/500/600), **JetBrains Mono** (numerals + UPPERCASE labels). All-sans; no serif. Google Fonts:
- ```html
- <link href="https://fonts.googleapis.com/css2?family=Inter+Tight:wght@500;600;700;800&family=Albert+Sans:wght@400;500;600&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet" />
- ```
-2. **A reveal script** - one `IntersectionObserver` adding `.is-in` (fade + ~10px rise, ease-out ~600ms).
-3. **A count-up script** - stat numerals tick to their final value once on reveal (the scoreboard flip). Reduced-motion renders the final number static.
+Canonical values live in `site/css/tokens.css` under `[data-theme="sport"]`.
-## Signature moves
+- `--color-paper: oklch(98% 0.003 250)` - cool concrete, never `#fff`
+- `--color-ink: oklch(16% 0.080 260)` - cool near-navy black, chroma 0.08, visibly blue rather than warm charcoal
+- `--color-ink-2: oklch(22% 0.060 258)` - body
+- `--color-muted: oklch(50% 0.020 250)` - meta
+- `--color-accent: oklch(58% 0.190 35)` - blaze-orange; as text, `--color-accent-ink: oklch(54% 0.20 35)`
+- `--color-rule: oklch(78% 0.008 250)` at `--rule-hair 1px` - table rows, fine grids
+- `--color-rule-2: oklch(36% 0.060 255)` at `--rule-fine 2px` - the heavy frame and the section break
-1. **Cool concrete paper, blue-black ink, never `#fff` / `#000`.** Paper `oklch(98% 0.003 250)`; ink `oklch(16% 0.080 260)` is a cool near-navy black (chroma 0.08, visibly blue, not warm charcoal). Body sits at `--color-ink-2 oklch(22% 0.060 258)`, meta at `--color-muted oklch(50% 0.020 250)`.
+The orange stays under 5% of any viewport: a bib number, one primary control, an active row, a link underline, the focus ring, the single lane stripe. Everything else is cool grey and blue-black ink.
-2. **Uppercase condensed display, tracked tight.** Inter Tight 700 all-caps at `--tracking-display -0.04em`, `--lh-tight 1.02`. The tension lives in the caps and the tracking, not a slant - upright, never italic. Two-line all-caps heads risk ascender/descender collision (see the token note): hold the 1.02 floor, never drop under it.
+## Typography
-3. **One blaze-orange signal, < 5% of any viewport.** `oklch(58% 0.190 35)` marks the race-bib number, the one primary CTA, the active fixture, a link underline, the focus ring, the single lane stripe. Everything else is cool grey + ink. Orange-as-text uses `--color-accent-ink`.
+All-sans. No serif anywhere.
-4. **The scoreboard: mono tabular numerals, set large** (chart construction, when a figure grows one: [`data-viz.md`](../data-viz.md))**.** JetBrains Mono with `font-variant-numeric: tabular-nums` for times, splits, scores, distances, dates. The number is the content and outsizes its label. The stopwatch / standings voice.
+- **Display** - Inter Tight 700, all-caps, `--tracking-display -0.04em` on the `--lh-tight 1.02` floor. The tension lives in the caps and the tracking, not a slant: upright, never italic. Two-line all-caps risks ascender/descender collision, so hold the 1.02 floor and never drop under it.
+- **Body** - Albert Sans 400/500/600 at `--measure 58ch`.
+- **Numerals** - JetBrains Mono with `font-variant-numeric: tabular-nums` for times, splits, scores, distances, dates. The number is the content and outsizes its label: this is the stopwatch voice, and it is the theme's second signature after the caps.
+- **Label** - JetBrains Mono, uppercase, `--tracking-label 0.10em`, for captions, table headers, meta rows, units, bib tags, folios, and entry numbers inside a real `<ol>`. The wide mono label is the ONLY place caps go loose; the display stays tight. It tags a value; it never announces a heading.
-5. **Two-weight rule system, never boxed cards.** Hairline `--color-rule oklch(78% 0.008 250)` at `--rule-hair 1px` rules table rows and fine grids; heavy `--color-rule-2 oklch(36% 0.060 255)` at `--rule-fine 2px` frames the scoreboard and breaks sections. Depth from rules, never soft shadows or card-in-card.
+## Material
-6. **A single lane stripe.** One vertical or diagonal orange bar (a track lane / speed stripe / finish line) in `--color-accent`, pure CSS, placed ONCE as the page's kinetic graphic. Never repeated as decoration.
-
-7. **Mono labels, uppercase, tracked wide.** Eyebrows, meta, bib tags in JetBrains Mono, uppercase, `--tracking-label 0.10em`. The wide mono label is the ONLY place caps go loose; the display stays tight (move 2).
-
-8. **Fast section rhythm.** Sections at `--section-gap 5.5rem`, heads tight above their content at `--section-head-gap 1.25rem`, prose capped at `--measure 58ch`.
+- **Two-weight rule system, never boxed cards.** The hairline rules rows and fine grids; the heavy 2px rule frames a figure and breaks sections. Depth from rules, never soft shadows or card-in-card.
+- **A single lane stripe.** One vertical or diagonal orange bar (a track lane, a speed stripe, a finish line) in `--color-accent`, pure CSS, placed ONCE as the page's kinetic graphic. Never repeated as decoration.
+- **Radius** ~4px on a control, no more. No pills.
+- **No texture, no skeuomorphism.** Concrete is a colour here, not a photograph of concrete.
+- **Fast rhythm.** `--section-gap 5.5rem`, `--section-head-gap 1.25rem` under a head. Tight, quick, no lounging.
## Motion
-Kinetic but disciplined. Section reveals fade + rise. Stat numerals count up once on reveal (the scoreboard flip). Hover: orange underline-grow on links, a 2px border shift to orange on focusable rows. No parallax, no autoplay, no bounce. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships final numbers, full visibility, static.
-
-## Anti-patterns
-
-- **No italic display.** `--display-style: normal`; the athletic lean comes from tracking and layout, not slanted type.
-- **No warm paper.** Sport is cool (hue 250). Warm grey / cream is Carnival, Riso, Almanac.
-- **No second accent, no duo-tone.** One orange signal only; duo-tone belongs to Carnival.
-- **No hard-offset poster shadow** (`4px 4px 0`). Rules carry structure; the offset shadow is Carnival's.
-- **No loose tracking on the display.** The hero is tight (`-0.04em`); wide caps live only on mono labels (`0.10em`). Spread display caps read as AI-stretched.
-- **No pill / gradient CTA.** One solid orange button, square-ish radius (4px), destination named.
-- **No serif anywhere.** All-sans: Inter Tight / Albert Sans / JetBrains Mono.
-- **No stadium skeuomorphism** - no grass texture, jersey-mesh gradient, medal / trophy emoji.
-
-## Macrostructure affinity / rejection
-
-**Sport loves these.**
+Kinetic but disciplined. Section reveals fade and rise ~10px, ease-out ~600ms, from one `IntersectionObserver`. Numerals count up once on reveal (the scoreboard flip) and then hold. Hover: an orange underline grows on links, a 2px border shifts to orange on focusable rows. No parallax, no autoplay, no bounce. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships final numbers, full visibility, static.
-- **Stat-Led** - *canonical.* The scoreboard, the standings, the split table, the season figures.
-- **Marquee Hero** - one big uppercase word + the lane stripe.
-- **Bento Grid** - fixtures / results / kit tiles, each rule-framed.
-- **Type Specimen** - the condensed caps as the content.
-- **Feature-stack** - training-plan or spec rows down a hairline column.
+## Voice range
-**Sport refuses these.**
+Imperative, kinetic, numbered. Caps on the headline, sentence case in the body. Numerals over words (5K, not five-K); verbs and numbers, not adjectives. Never *journey, wellness, holistic, elevate, unleash, game-changer, next-level, curated*.
-- **Letter** - too intimate; Sport is a result, not a note.
-- **Conversational FAQ** - too soft.
-- **Long Document** - prose-led; route Newsprint / Editorial.
-- **Quote-Led** - too pensive; Sport is present-tense and timed.
+## Do-nots (this theme's own failure modes)
-## Voice fixtures
+- **No italic display.** The athletic lean comes from tracking and layout, not slanted type.
+- **No loose tracking on the display.** The head is tight (`-0.04em`); wide caps live only on mono labels (`0.10em`). Spread display caps read as AI-stretched.
+- **No warm paper.** Sport is cool (hue 250). Warm grey and cream belong to Carnival, Riso, Almanac.
+- **No second accent, no duo-tone.** One orange signal only.
+- **No hard-offset poster shadow** (`4px 4px 0`) and **no pill or gradient CTA.** Rules carry structure; the button is one solid orange block at a square-ish radius, destination named.
+- **No stadium skeuomorphism** - no grass texture, jersey-mesh gradient, medal or trophy emoji.
-Imperative, kinetic, numbered. Caps on the headline, sentence case in the body.
-
-- *"EVERY SPLIT COUNTS."*
-- *"42.195 KM. ONE MORNING."*
-- *"TRAIN FOR THE DISTANCE, NOT THE DAY."*
-- *"BUILT FOR THE FINAL LAP."*
-- *"FASTER THAN LAST SEASON. PROVE IT."*
-
-Numerals over words (5K, not five-K). Verbs and numbers, not adjectives. **Never any of:** *journey, wellness, holistic, elevate, unleash, game-changer, next-level, curated.*
-
-## How Sport differs from neighbouring themes
+## How Sport differs from its neighbours
| vs | difference |
|---|---|
-| **Manifesto** | Manifesto is BLACK paper + red Anton, caps as protest. Sport is light cool-grey paper + blaze-orange + Inter Tight, caps as scoreboard. Both uppercase; opposite polarity (dark vs light) and purpose (declaration vs result). |
+| **Manifesto** | Manifesto is BLACK paper with red Anton, caps as protest. Sport is light cool-grey paper with blaze-orange and Inter Tight, caps as scoreboard. Both uppercase; opposite polarity and opposite purpose (declaration vs result). |
| **Carnival** | Carnival is duo-tone poster art (Big Shoulders width axis, ornaments, hard-offset shadows). Sport is single-signal data (Inter Tight, mono tabular numerals, hairlines). Expressive vs measured. |
| **Brutal** | Brutal is raw heavy-border slab brutalism. Sport is fast and hairline-precise, one heavy rule, the number as hero. Structure from rules and data, not slab weight. |
-## Test brief expectations
+## When the brief routes here
-Sport should be a candidate when the brief mentions:
-
-- *running · marathon · race · training · fitness · gym · team · league · fixtures · standings · scoreboard · athletics · performance · splits · PR / PB · kit · sportswear · club · season · match · tournament · endurance*
-- Product categories: *sportswear · running brand · fitness app · sports team or club · race event · training program · performance gear · league / standings site*
-- Emotional tone: *fast · competitive · measured · kinetic · disciplined · timed · hard*
+*running · marathon · race · training · fitness · gym · team · league · fixtures · standings · scoreboard · athletics · performance · splits · PR / PB · kit · sportswear · club · season · match · tournament · endurance*. Categories: sportswear, running brands, fitness apps, sports teams and clubs, race events, training programs, performance gear, league and standings sites. Tone: fast, competitive, measured, kinetic, disciplined, timed, hard.
## Build hint
+```html
+<link href="https://fonts.googleapis.com/css2?family=Inter+Tight:wght@500;600;700;800&family=Albert+Sans:wght@400;500;600&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet" />
+```
+
```css
html, body { overflow-x: clip; }
body { background: var(--color-paper); color: var(--color-ink-2);
@@ -115,9 +92,9 @@ h1, h2 { font-family: var(--font-display); font-weight: var(--display-weight);
text-transform: uppercase; letter-spacing: var(--tracking-display);
line-height: var(--lh-tight); font-style: normal; }
-/* The scoreboard number: mono, tabular, larger than its label */
-.stat-num { font-family: var(--font-mono); font-variant-numeric: tabular-nums;
- font-size: var(--text-2xl); color: var(--color-ink); }
+/* The number: mono, tabular, larger than its label */
+.num { font-family: var(--font-mono); font-variant-numeric: tabular-nums;
+ font-size: var(--text-2xl); color: var(--color-ink); }
.label { font-family: var(--font-label); text-transform: uppercase;
letter-spacing: var(--tracking-label); color: var(--color-muted); }
@@ -125,7 +102,7 @@ h1, h2 { font-family: var(--font-display); font-weight: var(--display-weight);
.hair { border-top: var(--rule-hair) solid var(--color-rule); }
.rule { border-top: var(--rule-fine) solid var(--color-rule-2); }
-/* One blaze-orange signal: the CTA, the single lane stripe */
+/* One blaze-orange signal: the control, the single lane stripe */
.btn--primary { background: var(--color-accent); color: var(--color-paper);
border-radius: 4px; }
.lane { background: var(--color-accent); }
@@ -140,4 +117,4 @@ h1, h2 { font-family: var(--font-display); font-weight: var(--display-weight);
}
```
-Plus the Inter Tight + Albert Sans + JetBrains Mono link and the reveal + count-up script.
+The rest of the page is yours. Sport supplies the concrete, the caps, the numerals, and the one orange; what gets timed on that surface is the brief's business, not the theme's.
diff --git a/skills/hallmark/references/themes/studio.md b/skills/hallmark/references/themes/studio.md
index 094a1ee..074ef18 100644
--- a/skills/hallmark/references/themes/studio.md
+++ b/skills/hallmark/references/themes/studio.md
@@ -1,8 +1,8 @@
# Theme - Studio
-Editorial, design-studio register. The page for a **creative studio, a branding practice, an art-direction shop, a design portfolio, a selected-work index** - the considered-agency school, executed in **high-contrast Fraunces on a cool studio-white, with one deep botanical green**. A faintly cool near-white ground (`oklch(96.5% 0.005 200)`), ruler-drawn hairlines, huge thick/thin display serif, and a numbered work-index doing the structural work. It reads like a studio that sets its own type: crafted, confident, curatorial.
+Editorial, design-studio register: the considered-agency school, executed in **high-contrast Fraunces on a cool studio-white, with one deep botanical green**. A faintly cool near-white ground, ruler-drawn hairlines, a huge thick/thin display serif, and whitespace doing the structural work. It reads like a studio that sets its own type: crafted, confident, curatorial.
-Loaded eagerly by SKILL.md Step 3 when the catalog pick is `studio`. Tokens: `site/css/tokens.css` under `[data-theme="studio"]`.
+The material, in one line: **cool studio-white, Fraunces at optical 144, hairlines and air, one botanical green.**
## Axes (diversification)
@@ -12,102 +12,75 @@ Loaded eagerly by SKILL.md Step 3 when the catalog pick is `studio`. Tokens: `si
## Reference register
-Aesop · Stripe Press · Readymag · Instrument · Locomotive · Area 17 · Cosmos · Semplice · a type foundry's Fraunces specimen.
+Aesop · Stripe Press · Readymag · Instrument · Locomotive · Area 17 · Cosmos · Semplice · a type foundry's Fraunces specimen. **Never name any of these in the output.**
-The aesthetic: the design-studio case-study index - a cool crafted canvas, one green signal, big high-contrast serif, a hairline project ledger, mono meta-lines. **Never name any of these in the output.**
+The material to match: a cool crafted canvas, one green signal, big high-contrast serif, hairline structure, mono meta-lines. Internally: the specimen discipline of a type foundry with the warmth of a working studio. When in doubt ask "does this read like a studio that hand-sets its own page, or a template?" Keep the former.
-**Patron-saint reference (internal):** a branding studio's selected-work index, set in high-contrast Fraunces and recoloured deep green - the specimen discipline of a type foundry with the warmth of a working studio. When in doubt ask "does this read like a studio that hand-sets its own page, or a template?" Keep the former.
+## Palette
-## Required dependencies
+Canonical values live in `site/css/tokens.css` under `[data-theme="studio"]`.
-1. **Fonts** - **Fraunces** (display, variable opsz/wght/SOFT, roman + italic for body emphasis), **Geist** (body 400/500/600), **Geist Mono** (labels + meta). Google Fonts:
- ```html
- <link href="https://fonts.googleapis.com/css2?family=Fraunces:ital,opsz,wght,SOFT@0,9..144,400..700,0..100;1,9..144,400..700,0..100&family=Geist:wght@400;500;600&family=Geist+Mono:wght@400;500&display=swap" rel="stylesheet" />
- ```
-2. **A small reveal script** - one `IntersectionObserver` adding `.is-in` (fade + ~10px rise, ease-out ~600ms). One orchestrated entrance, then static. Reduced-motion safe.
+- `--color-paper: oklch(96.5% 0.005 200)` - cool studio-white, never `#fff`
+- second surface `oklch(93.5% 0.007 200)`
+- `--color-ink: oklch(13% 0.024 205)` - cool near-black
+- `--color-neutral: oklch(34% 0.016 205)` - body
+- `--color-accent` / `--color-accent-ink: oklch(46% 0.140 145)` - the one green
+- `--color-rule: oklch(82% 0.008 200)` - the 1px hairline
-## Signature moves
+Everything tints faintly toward hue 200-205. The green stays under 5% of any viewport: an emphasised word, a link underline, a small tick, an active state. The **one** filled control uses green as background with a `--color-paper` label, never green on green.
-1. **Cool studio-white, never `#fff`** - paper `oklch(96.5% 0.005 200)`, second surface `oklch(93.5% 0.007 200)`. Ink is cool near-black `oklch(13% 0.024 205)`; body sits at `--color-neutral` `oklch(34% 0.016 205)`. Everything tints faintly toward hue 200-205.
+## Typography
-2. **Fraunces set big and high-contrast** - the display face at optical size 144 (`--display-optical`), weight 400, `SOFT` 30, letter-spacing `-0.022em`. `font-variation-settings: "opsz" 144, "SOFT" 30`. Headlines run 2-3 lines, **edge-aligned left**, up to `6.25rem` (`--text-display`). The dramatic thick/thin stroke is the signature - do not flatten it with a low optical size.
+- **Display** - Fraunces at optical size 144 (`--display-optical`), weight 400, `SOFT` 30, letter-spacing `-0.022em`, `font-variation-settings: "opsz" 144, "SOFT" 30`, up to `6.25rem` (`--text-display`). Edge-aligned left, 2-3 lines. The dramatic thick/thin stroke is the signature: do not flatten it with a low optical size.
+- **Body** - Geist 400 at a 45-75ch measure. The tension of a clean neutral sans under a high-contrast display serif is the pairing. **Never set running body in the serif**; Fraunces is display and pull-quotes only.
+- **Label** - Geist Mono UPPERCASE, tracking `0.08em` (`--tracking-label`). A studio's colophon voice: captions, dates, roles, disciplines, table headers, meta rows, folios, units, and entry numbers inside a real `<ol>`. It records a fact; it never sits above a heading to announce it.
+- **Emphasis is green, never italic.** A single emphasised word takes `--color-accent-ink` or a green underline; the display face stays roman. Fraunces italic is body emphasis and pull-quotes only.
-3. **One botanical green signal** (< 5% of any viewport) - `--color-accent-ink` `oklch(46% 0.140 145)` for a green word in a headline, a link underline, a small index tick, the active nav item. The **one filled button** uses `--color-accent` as background with a `--color-paper` label (never green-on-green). Everything else is ink-on-white.
+## Material
-4. **Geist body against a Fraunces display** - the tension of a clean neutral sans body under a high-contrast display serif. Body Geist 400 at a 45-75ch measure. **Never set running body in the serif**; Fraunces is display and pull-quotes only.
-
-5. **Geist Mono spec-sheet labels** - eyebrows, section numbers, project indices, dates, roles, captions in Geist Mono UPPERCASE, tracking `0.08em` (`--tracking-label`). The machine-readout counterpoint to the lush serif - a studio's colophon voice.
-
-6. **A hairline work-index, not cards** - 1px `--color-rule` `oklch(82% 0.008 200)` rules define sections and a numbered project ledger (index no. / title in Fraunces / discipline / year across hairline-separated rows). **No boxed cards, no drop-shadows.** Depth is rules and whitespace.
-
-7. **Whitespace as material** - `--section-gap` 6.5rem between beats, `--section-head-gap` 1.5rem under heads. Asymmetric columns: title left, mono meta/index right. Generous, unhurried, never centre-stacked.
-
-8. **Green emphasis, never italic headers** - a single emphasized headline word takes the green (`--color-accent-ink`) or a green underline; the display face stays roman. Fraunces **italic is body-emphasis and pull-quotes only** (genre rule).
+- **Hairlines, not cards.** 1px `--color-rule` defines structure. **No boxed cards, no drop-shadows, no glass.** Depth is rules and whitespace.
+- **Whitespace as material.** `--section-gap` 6.5rem between beats, `--section-head-gap` 1.5rem under heads. Generous and unhurried; the air is part of the palette.
+- **Radius** ~4px on the one filled control. No pills.
+- **No texture.** The cool paper is the whole surface.
+- **Imagery** sits clean on the cool ground, framed by whitespace rather than by a border or a shadow.
## Motion
-Quiet and editorial. One orchestrated entrance per section (fade + ~10px rise, ease-out ~600ms) via a single `IntersectionObserver`. Hover: green underline-grow on links, a 1px rule shift toward green on index rows. **No bounce, no parallax, no autoplay, no marquee.** Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships fully visible and static.
-
-## Anti-patterns
-
-- **No warm paper** - Studio is cool (hue ~200-205); warm cream is Atelier/Garden vocabulary.
-- **No pure `#fff` / `#000`** - cool studio-white and cool near-black only.
-- **Never flatten Fraunces** - a low optical size kills the thick/thin contrast that defines the theme. Keep opsz high on the display.
-- **No italic display headers** - roman only; italic is body emphasis (genre rule).
-- **No green flood / neon green** - one deep botanical signal, < 5%. Green backgrounds or bright green break it.
-- **No boxed cards, shadows, or glassmorphism** - hairlines and whitespace carry the page.
-- **No centred-everything hero** - left-biased, title-left / meta-right.
-- **No pill / gradient CTA** - one filled green button + typographic links.
-
-## Macrostructure affinity / rejection
+Quiet and editorial. One orchestrated entrance per section (fade plus ~10px rise, ease-out ~600ms) via a single `IntersectionObserver`, then static. Hover: a green underline grows on links, a 1px rule shifts toward green on focusable rows. **No bounce, no parallax, no autoplay, no marquee.** Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships fully visible and static.
-**Studio loves.**
+## Voice range
-- **Portfolio-grid / split-studio** - the selected-work case-study index (its native shape)
-- **Index-first** - a numbered hairline project ledger
-- **Type-specimen / Specimen** - Fraunces set big; the theme is specimen-capable
-- **Photographic** - a studio shows its work; cool paper frames imagery cleanly
-- **Manifesto** - a studio statement of approach in big composed serif (quiet register)
+Confident, spare, a little literary. Verbs over adjectives; name the work, the discipline, the year. Never *seamless, cutting-edge, disrupt, synergy, elevate, next-level, world-class, digital solutions*. Never "click here."
-**Studio refuses.**
+## Do-nots (this theme's own failure modes)
-- **Workbench** - instrument-panel / dev-tool shape belongs to the cool-modern lane, not a studio
-- **Bento Grid** - tiled product boxes fight the hairline editorial structure
-- **Stat-Led** - a studio does not open with a dashboard of numbers
-- **Conversational FAQ** - too chatty/support; Studio is curatorial
+- **Never flatten Fraunces.** A low optical size kills the thick/thin contrast that defines the theme. Keep opsz high on the display.
+- **No italic display.** Roman only; italic is body emphasis.
+- **No green flood, no neon green.** One deep botanical signal, under 5%. Green backgrounds or a bright green break it.
+- **No warm paper, no pure `#fff` / `#000`.** Studio is cool (hue ~200-205); warm cream is Atelier and Garden vocabulary.
+- **No boxed cards, shadows, or glassmorphism.** Hairlines and whitespace carry the page.
+- **No pill or gradient CTA.** One filled green control plus typographic links.
-## Voice fixtures
-
-Confident, spare, a little literary. Verbs over adjectives. Name the work.
-
-- *"We design the things a brand is remembered by."*
-- *"A small studio. Considered work."*
-- *"Identity, editorial, and the space between."*
-- *"Selected work - 2016 to present."*
-- *"Set with care. Shipped with nerve."*
-
-Never any of: *seamless, cutting-edge, disrupt, synergy, elevate, next-level, world-class, digital solutions*. Never "click here." Name the project, the discipline, the year.
-
-## How Studio differs from neighbouring themes
+## How Studio differs from its neighbours
| vs | what settles it instantly |
|---|---|
-| **Garden** (green sibling) | Garden is a warm, botanical, organic nature register where green floods a soft world. Studio is a cool engineered studio-white where the same green is one restrained signal - agency, not garden. Temperature + role of the green settle it. |
-| **Atelier** (quiet-serif sibling) | Atelier is the hushed, letter-shaped, small-serif personal practice. Studio is bigger and more confident - Fraunces at opsz 144, a work-index ledger, a green signal. Scale and structure settle it. |
-| **Specimen** (Fraunces/high-contrast sibling) | Specimen exists to display a typeface (type is the subject). Studio uses Fraunces as its voice to present a studio's work (the studio is the subject). Same face possible, different subject. |
+| **Garden** (green sibling) | Garden is a warm, botanical, organic register where green floods a soft world. Studio is a cool engineered studio-white where the same green is one restrained signal. Temperature and the role of the green settle it. |
+| **Atelier** (quiet-serif sibling) | Atelier is the hushed, small-serif, plaster-and-umber practice. Studio is bigger and cooler - Fraunces at opsz 144 on cool white with a green signal. Palette temperature and display scale settle it. |
+| **Specimen** (Fraunces / high-contrast sibling) | Specimen exists to display a typeface: type is the subject. Studio uses Fraunces as its voice to present a studio's work. Same face possible, different subject. |
-## Test brief expectations
+## When the brief routes here
-Studio should be a candidate when the brief mentions:
+*design studio · creative studio · branding · brand identity · art direction · agency · portfolio · case study · selected work · editorial design · typography · creative direction · graphic design · design practice*. Categories: design and creative studios, branding agencies, art-direction shops, portfolio sites, editorial and publishing practices. Tone: considered, crafted, confident, curatorial, high-contrast, editorial, tasteful.
-- *design studio · creative studio · branding · brand identity · art direction · agency · portfolio · case study · selected work · editorial design · typography · creative direction · graphic design · design practice*
-- Product categories: *design studio · creative/branding agency · art-direction shop · portfolio site · editorial/publishing practice*
-- Emotional tone: *considered · crafted · confident · curatorial · high-contrast · editorial · tasteful · warm-precise*
-
-Briefs that are dev-tool / enterprise / warm-consumer / loud-maximalist route elsewhere (the cool-modern lane for developer products, Carnival for loud editorial, Garden for organic/nature).
+Dev-tool, enterprise, warm-consumer, and loud-maximalist briefs route elsewhere (the cool-modern lane for developer products, Carnival for loud editorial, Garden for organic and nature).
## Build hint
+```html
+<link href="https://fonts.googleapis.com/css2?family=Fraunces:ital,opsz,wght,SOFT@0,9..144,400..700,0..100;1,9..144,400..700,0..100&family=Geist:wght@400;500;600&family=Geist+Mono:wght@400;500&display=swap" rel="stylesheet" />
+```
+
```css
html, body { overflow-x: clip; }
body { background: var(--color-paper); color: var(--color-neutral);
@@ -120,14 +93,14 @@ body { background: var(--color-paper); color: var(--color-neutral);
letter-spacing: var(--tracking-display); color: var(--color-ink); }
.display .mark { color: var(--color-accent-ink); } /* the one green signal */
-/* Mono spec-sheet label */
+/* Mono colophon label */
.label { font: 500 0.75rem/1 var(--font-mono); text-transform: uppercase;
letter-spacing: var(--tracking-label); color: var(--color-muted); }
-/* Hairline index row - no cards, no shadow */
-.row { border-top: 1px solid var(--color-rule); padding: 1.25rem 0; }
+/* Hairline structure - no cards, no shadow */
+.rule { border-top: 1px solid var(--color-rule); padding-top: 1.25rem; }
-/* The one filled button - paper label, never green-on-green */
+/* The one filled control - paper label, never green-on-green */
.btn--primary { background: var(--color-accent); color: var(--color-paper);
border-radius: 4px; }
@@ -142,4 +115,4 @@ body { background: var(--color-paper); color: var(--color-neutral);
}
```
-Plus the Fraunces + Geist + Geist Mono link and the small reveal script.
+The rest of the page is yours. Studio supplies the cool paper, the serif, the hairline, and the one green; what gets set on that page is the brief's business, not the theme's.
diff --git a/skills/hallmark/references/themes/terminal.md b/skills/hallmark/references/themes/terminal.md
index 397800f..ea28bfd 100644
--- a/skills/hallmark/references/themes/terminal.md
+++ b/skills/hallmark/references/themes/terminal.md
@@ -1,111 +1,88 @@
# Theme - Terminal
-Green-phosphor CRT, rendered as a landing page. The page for a **CLI, a shell tool, a self-hosted binary, an open-source dev utility, a homelab/DevOps product** - the page that *is* a terminal session, not one that shows a screenshot of one. Dark green-black ground (`oklch(11% 0.018 145)`), phosphor-green ink (hue 138, up to `chroma 0.19`), one hue top to bottom, every glyph monospace, a blinking block cursor. It reads like a live shell: fast, raw, competent, no ornament.
+Green-phosphor CRT, rendered as a page. Dark green-black ground, phosphor-green ink, one hue top to bottom, every glyph monospace, a blinking block cursor. The page *is* a terminal surface, not one that shows a screenshot of one. It reads like a live shell: fast, raw, competent, no ornament.
-Loaded eagerly by SKILL.md Step 3 when the catalog pick is `terminal`. Tokens: [`site/css/tokens.css`](../../../../site/css/tokens.css) under `[data-theme="terminal"]`. Canonical build: none yet - mirror the signature moves below.
+The material, in one line: **one green hue, all mono, zero radius, phosphor glow under scanlines.**
## Axes (diversification)
- **Paper band** - dark, green (`oklch(11% 0.018 145)`, a near-black with a green cast). The darkest ground in the catalog, and the only one tinted green rather than neutral or indigo.
- **Display style** - **mono** (JetBrains Mono 500, `--tracking-display 0.01em`). No proportional face exists on the page; display just sizes the mono up (`--text-display` clamps to 4rem).
-- **Accent hue** - **chromatic phosphor** (`oklch(78% 0.190 138)`). A lit P1-green, not neon `#00ff00`. It is the *same* hue as the ink and the paper - the whole page is one hue.
+- **Accent hue** - **chromatic phosphor** (`oklch(78% 0.190 138)`). A lit P1-green, not neon `#00ff00`. It is the *same* hue as the ink and the paper: the whole page is one hue.
## Reference register
-Warp - Charm / charm.sh - Ghostty - Fig - Vercel's monospace - old DEC/VT220 green screens - man pages - `htop`/`btop` TUIs.
+Warp · Charm / charm.sh · Ghostty · Fig · Vercel's monospace · old DEC/VT220 green screens · man pages · `htop` and `btop` TUIs. **Never name any of these in the output.**
-The aesthetic: a shell session as a homepage - monochrome phosphor, box-drawn chrome, prompt prefixes, a cursor that blinks. Hand-built, precise, never a costume. **Patron-saint reference (internal):** *a green VT220 phosphor screen, recoloured for the web* + *a README you can run*. When in doubt ask "does this read like a live terminal, or like a hacker-themed skin?" Keep the former. **Never name any of these in the output.**
+The material to match: monochrome phosphor, box-drawn chrome, a cursor that blinks. Hand-built, precise, never a costume. Internally: *a green VT220 phosphor screen, recoloured for the web*. When in doubt ask "does this read like a live terminal, or like a hacker-themed skin?" Keep the former.
-## Required dependencies
+## Palette
-1. **Font** - **JetBrains Mono** only (display 500, body 400, bold 700). No sans, no serif anywhere. Google Fonts:
- ```html
- <link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;700&display=swap" rel="stylesheet" />
- ```
-2. **A reveal script** - one `IntersectionObserver` adding `.is-in` (fade only, ~500ms; no rise - the screen does not slide).
-3. **A one-shot type-in** - the hero command line types itself once, then a block cursor (`▋`) blinks steadily. Both gate behind `prefers-reduced-motion`.
+Canonical values live in [`site/css/tokens.css`](../../../../site/css/tokens.css) under `[data-theme="terminal"]`.
-## Signature moves
+- `--color-paper: oklch(11% 0.018 145)` - green-black; elevation steps to `15%` / `19%`
+- `--color-muted: oklch(58% 0.090 140)` - meta
+- `--color-ink-2: oklch(78% 0.140 138)` - body
+- `--color-ink: oklch(86% 0.160 138)` - bright ink
+- `--color-accent: oklch(78% 0.190 138)` - the lit phosphor signal
+- `--color-rule: oklch(28% 0.030 140)` - 1px TUI chrome
-1. **One hue, top to bottom.** Paper (`oklch(11% 0.018 145)`), rules, muted meta (`oklch(58% 0.090 140)`), body (`oklch(78% 0.140 138)`), bright ink (`oklch(86% 0.160 138)`), accent (`oklch(78% 0.190 138)`) all sit on hue 138-145. There is no second hue on the page. The monochrome *is* the design. Hierarchy comes from the L/chroma ramp, since hue cannot carry it.
+**One hue, top to bottom.** Everything sits on hue 138-145. There is no second hue on the page; the monochrome *is* the design, and hierarchy comes from the L/chroma ramp since hue cannot carry it. Reserve the two brightest greens (ink at 86% L, accent at chroma 0.19) for the one emphasised word, the active prompt, the cursor, focus rings, and a status chip.
-2. **Every glyph is JetBrains Mono.** Display, headings, body, labels, meta, buttons - all `--font-mono`. No proportional type exists anywhere, not even a "friendlier" body. A sans or serif on the page means the theme is broken.
+## Typography
-3. **Zero radius, sharp rectangles.** `--radius-card / --radius-pill / --radius-input` all resolve to `0`. Windows, buttons, inputs, chips have square corners. No pill CTA, no soft card - the hard edge is the CRT bezel.
+**Every glyph is JetBrains Mono.** Display, headings, body, labels, meta, buttons, all `--font-mono` (display 500, body 400, bold 700). No proportional type exists anywhere, not even a "friendlier" body. A sans or serif on the page means the theme is broken.
-4. **The shell prompt is the grammar.** Eyebrows, section labels, and nav items are prefixed `$`, `>`, or `~/`. A blinking block cursor (`▋`) trails the hero headline or the active input. The page behaves as one continuous session, not a marketing page describing one.
+**The prompt is the grammar.** A `$`, `>`, or `~/` prefix marks things that are genuinely commands or destinations: nav items, an inline command, an active input, a path. A blinking block cursor (`▋`) trails the live line. It is a shell affordance, not a decoration to hang above headings, and it never labels a section.
-5. **Phosphor glow, not drop-shadow.** Bright text (ink, accent) carries a soft `text-shadow` bloom in the accent hue - the phosphor bleeding past its pixel. Depth otherwise steps through `--color-paper-2` (`15%`) / `--color-paper-3` (`19%`) elevation. Never a grey box-shadow, never blur.
+Numerals run tabular wherever a figure appears. Labels are uppercase mono for captions, table headers, meta rows, units, exit codes, folios, and entry numbers inside a real `<ol>`.
-6. **Scanline atmosphere.** A fixed, low-opacity horizontal scanline overlay (`repeating-linear-gradient`, ~3px pitch, under ~6% alpha), optionally a faint vignette. This is Terminal's answer to the genre's warm blooms - the atmosphere is CRT, not dusk. It must never fight legibility.
+## Material
-7. **Rules are TUI chrome.** 1px `--color-rule` (`oklch(28% 0.030 140)`) borders framed like a terminal: a window title bar carrying `● ● ●` or `[ session ]`, box-drawn (`+--+`, `│`) dividers, a `~/project $` breadcrumb. Structure reads as terminal furniture, not as web cards.
-
-8. **Bright green is the signal.** `--color-ink` (86% L) and `--color-accent` (`chroma 0.19`) are the brightest greens - reserve them for the one headline verb, the active prompt, the cursor, focus rings, and a `OK` / `200` / `PASS` chip. Body holds at `--color-ink-2` (78% / 0.14), meta drops to `--color-muted` (58% / 0.09).
+- **Zero radius, sharp rectangles.** `--radius-card` / `--radius-pill` / `--radius-input` all resolve to `0`. Windows, buttons, inputs, chips have square corners. The hard edge is the CRT bezel.
+- **Phosphor glow, not drop-shadow.** Bright text carries a soft `text-shadow` bloom in the accent hue, the phosphor bleeding past its pixel. Depth otherwise steps through the paper elevation ramp. Never a grey box-shadow, never blur.
+- **Scanline atmosphere.** A fixed, low-opacity horizontal scanline overlay (`repeating-linear-gradient`, ~3px pitch, under ~6% alpha), optionally a faint vignette. This is Terminal's answer to the genre's warm blooms: the atmosphere is CRT, not dusk. It must never fight legibility.
+- **Rules are TUI chrome.** 1px `--color-rule` borders framed as terminal furniture: box-drawing dividers (`+--+`, `│`), a session bar, a path line. Structure reads as terminal furniture, not as web cards.
+- **No emoji, no colour icons.** Monochrome glyphs, box-drawing, and ASCII only.
## Motion
-The hero command types in once, then the block cursor blinks on a steady 1s `step-end` loop. Section reveals fade only (no rise, the screen does not scroll its content in). An optional one-time boot flicker on load is allowed. No parallax, no bounce, no autoplay. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static, cursor solid, scanlines still (or absent).
-
-## Anti-patterns
-
-- **No second hue.** No warm bloom, no cyan, no amber, no indigo. If it is not green (hue 138-145), it does not belong. This is what separates Terminal from Midnight / Aurora / Lumen.
-- **No proportional type.** No sans, no serif, ever - JetBrains Mono carries the whole page.
-- **No rounded corners.** No pill CTA, no soft card, no rounded input. Radius stays `0`.
-- **No pure `#000` or neon `#00ff00`.** Paper is a green-black (`oklch(11% 0.018 145)`); accent is a lit phosphor (`oklch(78% 0.190 138)`), not a `#0f0` highlighter.
-- **No light sections.** Unlike Cobalt (a light page with one dark band), Terminal is dark end to end. Never sneak a white section in.
-- **No skeuomorphic terminal screenshot as hero.** The *page* is the terminal; do not paste a picture of one.
-- **No heavy CRT costume.** Overdense scanlines or a fat glow read as a theme skin, not an instrument. Keep the effects subtle.
-- **No emoji or colour icons.** Monochrome glyphs, box-drawing, and ASCII only.
-
-## Macrostructure affinity / rejection
-
-**Loves.**
-- **Workbench** - the tool-first, panelled shape; Terminal's native register
-- **Dev-tool / CLI** - install line + a clean run + `PASS` / `exit 0`
-- **Marquee Hero** - one confident shell demo carrying the fold
-- **Stat-Led** - benchmark numbers in a mono table (throughput, latency, exit codes)
-- **Long Document** - a README or man-page rendered as the page
+A live command types itself in once, then the block cursor blinks on a steady 1s `step-end` loop. Section reveals **fade only**, ~500ms, no rise: the screen does not slide its content in. An optional one-time boot flicker on load is allowed. No parallax, no bounce, no autoplay. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static, cursor solid, scanlines still or absent.
-**Refuses.**
-- **Photographic / image-led** - Terminal is text; no photography survives the phosphor screen
-- **Letter** - too intimate and warm; Terminal speaks in a machine voice
-- **Quote-Led** - testimonial pull-quotes want a serif Terminal does not have
-- **Catalogue / portfolio-grid** - image-thumbnail grids fight the text-only surface
+## Voice range
-## Voice fixtures
+Speak in commands, flags, paths, and exit codes. Declarative, terse, specific: name the command, the flag, the exit code, never the adjective. Never *seamless, robust, magical, revolutionary, next-gen, effortless, delightful, supercharge*. Never "click here."
-Speak in commands, flags, and exit codes. Declarative, terse, specific.
+## Do-nots (this theme's own failure modes)
-- `$ curl -sSL install.sh | sh`
-- *"Runs where you run. Nothing to configure."*
-- *"One binary. No daemon. Exit 0."*
-- *"Pipe it, grep it, ship it."*
-- `> ready.` (block cursor blinking after)
-
-Never any of: *seamless, robust, magical, revolutionary, next-gen, effortless, delightful, supercharge*. Never "click here." Name the command, the flag, the exit code.
+- **No second hue.** No warm bloom, no cyan, no amber, no indigo. If it is not green (hue 138-145), it does not belong. This is what separates Terminal from Midnight / Aurora / Lumen.
+- **No proportional type.** No sans, no serif, ever.
+- **No rounded corners.** No pill control, no soft card, no rounded input. Radius stays `0`.
+- **No pure `#000` or neon `#00ff00`.** Paper is a green-black; the accent is a lit phosphor, not a `#0f0` highlighter.
+- **No light sections.** Terminal is dark end to end; never sneak a white band in.
+- **No skeuomorphic terminal screenshot, and no heavy CRT costume.** The *page* is the terminal, and overdense scanlines or a fat glow read as a theme skin rather than an instrument.
-## How Terminal differs from neighbouring themes
+## How Terminal differs from its neighbours
| vs | difference |
|---|---|
-| **Midnight** (atmospheric) | Midnight is dark **blue** (hue ~250) with a real proportional display face (thin Geist) and a diffuse azure glow. Terminal is monochrome **green** (138-145), all-mono, with a shell prompt and scanlines. Hue + all-mono settle it instantly. |
-| **Cobalt** (modern-minimal) | Cobalt is a **light** engineered page with one dark graphite code band. Terminal is dark end to end and green - it *is* the code surface, not a light page containing one. Light-vs-dark + hue settle it. |
+| **Midnight** (atmospheric) | Midnight is dark **blue** (hue ~250) with a real proportional display face (thin Geist) and a diffuse azure glow. Terminal is monochrome **green** (138-145), all-mono, with a prompt grammar and scanlines. Hue and all-mono settle it instantly. |
+| **Cobalt** (modern-minimal) | Cobalt is a **light** engineered page with one dark graphite code band. Terminal is dark end to end and green: it *is* the code surface, not a light page containing one. |
| **Aurora** (atmospheric) | Aurora blooms **cyan** and sets body in a serif. Terminal has no bloom (scanlines instead), no serif (all-mono), and one green hue. |
| **Lumen** (atmospheric) | Lumen carries Instrument Serif, a built light artefact, and two palette drops. Terminal is single-drop, all-mono, no serif, phosphor-glow rather than emitted-light. |
-## Test brief expectations
-
-Terminal should be a candidate when the brief mentions:
+## When the brief routes here
-- *CLI - terminal - shell - command-line - TUI - self-hosted - open-source - binary - hacker - ssh - sysadmin - DevOps - homelab - install script - package manager - REPL - retro - CRT - phosphor - green screen*
-- Product categories: *CLI tool - terminal/shell product - self-hosted infra - dev CLI - open-source binary - sysadmin/DevOps tool - retro-computing product*
-- Emotional tone: *hacker - raw - fast - no-nonsense - retro-technical - machine - underground - competent*
+*CLI · terminal · shell · command-line · TUI · self-hosted · open-source · binary · ssh · sysadmin · DevOps · homelab · install script · package manager · REPL · retro · CRT · phosphor · green screen*. Categories: CLI tools, terminal and shell products, self-hosted infra, dev CLIs, open-source binaries, sysadmin and DevOps tools, retro-computing products. Tone: hacker, raw, fast, no-nonsense, retro-technical, machine, competent.
-When the brief wants a page that *is* a shell (not one that shows a code card), with green-CRT energy, it is Terminal. Warm / consumer / editorial / image-led briefs route elsewhere.
+When the brief wants a page that *is* a shell rather than one that shows a code card, it is Terminal. Warm, consumer, editorial, and image-led briefs route elsewhere.
## Build hint
+```html
+<link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;700&display=swap" rel="stylesheet" />
+```
+
```css
html, body { overflow-x: clip; }
body { background: var(--color-paper); color: var(--color-ink-2);
@@ -139,4 +116,4 @@ body::after { content: ""; position: fixed; inset: 0; pointer-events: none; z-in
}
```
-Plus the JetBrains Mono link and the reveal + one-shot type-in script.
+The rest of the page is yours. Terminal supplies the phosphor, the mono, and the hard edge; what runs on that screen is the brief's business, not the theme's.
diff --git a/skills/hallmark/references/typography.md b/skills/hallmark/references/typography.md
index a001237..2cf4e78 100644
--- a/skills/hallmark/references/typography.md
+++ b/skills/hallmark/references/typography.md
@@ -7,7 +7,7 @@ Type carries the design. If the type is wrong, nothing else matters.
- A page is a pairing, not a single font. Display face + body face, minimum. *Single-font pages are allowed only when the single font IS the design choice* — a true terminal aesthetic is monospace-everywhere on purpose; a Manifesto poster might be one display face on purpose. The default is a pairing.
- Commit to extremes. Weight 200 next to weight 800 reads as intentional. Weight 400 next to weight 600 reads as a default setting.
- Size steps should be ratios, not increments. Major third (1.25), perfect fourth (1.333), perfect fifth (1.5), or golden (1.618). Pick one and use it.
-- Line-height changes with size. Tight for display (1.05–1.2), comfortable for body (1.5–1.65).
+- Line-height changes with size. Tight for display, comfortable for body (1.5–1.65). This file owns the display range; see § Display line-height below, and never restate the numbers elsewhere.
- 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
@@ -26,8 +26,7 @@ The pattern:
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.
+- **The outlier carries ONE role, not a slot count.** It tags a specific kind of content: the brand, the headline figure, the manifesto line, the label voice. Reaching for it on a second *kind* is how it becomes a third body font, which is slop. How many times that one role appears is the content's business, not a budget: a label voice with six instances is one role, while a wordmark plus a pull quote plus a stat figure is three roles and already too many. 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.
@@ -198,7 +197,7 @@ Count characters in the rendered hero `h1`. Pick the cap by bucket — the rule
| --- | --- | --- |
| **≤ 20 chars** (e.g. *"Limitless"*, *"Made not generated"*) | full `--text-display`; single-word can grow to 7rem | Display-heavy themes only |
| **21–50 chars** (the default sweet spot) | `--text-display` | If it wraps past 2 lines at 414 px, step down to `--text-display-s` |
-| **51–90 chars** | cap at `--text-display-s` | Strongly consider splitting into eyebrow + headline |
+| **51–90 chars** | cap at `--text-display-s` | Cut it, or split it across two lines with `<br>` at the sense break. Never split it into a label plus a headline (gate 54) |
| **> 90 chars** | rewrite shorter, or cap at `--text-4xl` with tighter leading | A 100-char headline at display size is the single most reliable AI tell |
**Aggressive-display themes step down one rung when headline > 50 chars.** Brutal, Riso, and Manifesto clamp `--text-display` at 6.5–9rem — that ceiling is for ≤ 50-char statements only. Past 50 chars, route them to `--text-display-s` automatically. **When you write the headline yourself (no user-supplied copy), aim for ≤ 7 words and ≤ 50 chars from the start** — imperative or nominal phrase, never a gerund opener.
@@ -221,7 +220,7 @@ Max-width rides ON the heading element (never the wrapper), in `ch`; body keeps
## Weights
- Body: one weight (typically 400 or 350). Bold for emphasis only.
-- Headings: a weight that contrasts the body by at least 300 units. If body is 400, headings are 700 or 200 — not 500 or 600.
+- Headings: a weight that reads as a different voice from the body, not a nudge. With a 400 body, 700 and 200 are the safe poles. 500 and 600 work when the display FACE differs from the body face (which is the normal case on a two-family page, and is why several themes ship a 600 display); they read as un-set only when display and body share a family.
- Never synthesise. Load the weight you need; don't rely on `font-weight: bold` against a single-weight file.
## Required features
@@ -235,7 +234,13 @@ Max-width rides ON the heading element (never the wrapper), in `ch`; body keeps
## Body text rules
- Minimum 16px. Below 14px is accessibility-hostile.
-- Line-height 1.5–1.65 on body copy, tighter (1.1–1.3) on display. **Floor for all-caps display heads (`text-transform: uppercase` on `.hero__display` / `.section__title` / `h1` / `h2`) is `1.0` — recommended `1.02–1.08`.** Below 1.0 the cap-tops of line N+1 collide with the baseline of line N (no descenders to cushion the gap); the comma + cap-D on a wrapped "PROMPT, / DIFFERENT" fuse into a single glyph blob. Condensed display faces (Anton, Inter Tight 900, Bebas Neue) make this worse. Gate 55 auto-fails the pattern.
+- Line-height 1.5–1.65 on body copy.
+
+### Display line-height
+
+**One range, owned here: `1.0`–`1.15`.** Every other file cites it rather than restating it (gate 44b's fold-fit path and gate 55 both defer to this line). Sit at the tight end as the type grows; 1.2 on a display head reads as un-set type that inherited the body value.
+
+**Floor for all-caps display heads** (`text-transform: uppercase` on `.hero__display` / `.section__title` / `h1` / `h2`) **is `1.0`, recommended `1.02–1.08`.** Below 1.0 the cap-tops of line N+1 collide with the baseline of line N, since caps have no descenders to cushion the gap; the comma and cap-D on a wrapped "PROMPT, / DIFFERENT" fuse into one glyph blob. Condensed faces (Anton, Inter Tight 900, Bebas Neue) make it worse. Gate 55a auto-fails it on a head that can wrap; a nowrap lockup is 55b and waivable.
- Measure 45–75 characters (`max-width: 65ch`).
- Never all-caps body copy. Never justified text without hyphenation. Never letter-spacing above 0.05em on body.
diff --git a/skills/hallmark/references/verbs/audit.md b/skills/hallmark/references/verbs/audit.md
index d724dea..2843acb 100644
--- a/skills/hallmark/references/verbs/audit.md
+++ b/skills/hallmark/references/verbs/audit.md
@@ -4,10 +4,10 @@ Read the file(s) the user pointed at. For each finding, return:
- **Tell** — the named anti-pattern from [`anti-patterns.md`](../anti-patterns.md).
- **Where** — file path and line range.
-- **Severity** — `critical` (ships as slop), `major` (looks AI-generated), `minor` (small taste issue).
+- **Severity** — derived from the tell's tier, never assigned by feel: Floor → `critical`, Reflex → `major`, Finish → `minor`. Plus one more, `noted`, for a Reflex gate the audited output has already **waived** in its stamp: the page declared it, so it is not a finding. Report it once, in its own short group, so the reader can disagree with the waiver if they want to.
- **Fix** — one-line concrete correction.
-Group by severity. Do not edit. Do not redesign. End with a count: `N critical · M major · K minor`.
+Group by severity. Do not edit. Do not redesign. End with a count: `N critical · M major · K minor · J noted`.
Audit *also* checks structural fingerprint: if the page uses the AI template (centered hero, 3 equal feature cards, CTA, footer, with no asymmetry or surprise), flag it as a critical structural finding even if the visual treatment is fine.
@@ -26,7 +26,7 @@ Inversely, on a project *without* `design.md`, the standard diversification rule
## Reporting by tell name
-Findings cite tell names exactly as the slim list in [`anti-patterns.md`](../anti-patterns.md) spells them; its Critical / Major / Micro groups map to the severities critical / major / minor. When the tell carries a "(gate N)" marker, cite the gate: the enforcement detail and the full fix live in [`slop-test.md`](../slop-test.md).
+Findings cite tell names exactly as the slim list in [`anti-patterns.md`](../anti-patterns.md) spells them; its Floor / Reflex / Finish groups map to critical / major / minor by construction, so the severity is never a judgement call. When the tell carries a "(gate N)" marker, cite the gate: the enforcement detail and the full fix live in [`slop-test.md`](../slop-test.md).
For each finding:
diff --git a/skills/hallmark/references/verbs/redesign.md b/skills/hallmark/references/verbs/redesign.md
index 494b022..ca20ae1 100644
--- a/skills/hallmark/references/verbs/redesign.md
+++ b/skills/hallmark/references/verbs/redesign.md
@@ -219,7 +219,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 58 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 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`).
diff --git a/skills/hallmark/references/verbs/variants.md b/skills/hallmark/references/verbs/variants.md
index 1db9a86..4c5eb21 100644
--- a/skills/hallmark/references/verbs/variants.md
+++ b/skills/hallmark/references/verbs/variants.md
@@ -11,7 +11,7 @@ One brief, several distinct directions, side by side, in the user's own browser.
5. Build the directions at sketch depth: parallel subagents by default, sequential fallback. Flip each row to `status:"ready"` the instant its files land; run `thumbs.mjs`; say "Direction 1 ready" in chat per landing.
6. Relay the picker URL in one line.
7. Await the verdict via the poll ladder; a chat reply always works. Dispatch pick / riff / graft.
-8. Promote the winner: complete the sketch to full depth, full 58-gate sweep, apply any graft, archive all directions, append the decisions log, ack, stop, log.
+8. Promote the winner: complete the sketch to full depth, full 58-gate sweep at every tier, apply any graft, archive all directions, append the decisions log, ack, stop, log.
## The machinery
@@ -142,7 +142,7 @@ Include this chip tag verbatim: <the § 4 snippet with data-direction="<n>">.
Load ONLY references/macrostructures/<picked file>, the picked component archetype
files, and the universal set (typography · color · layout-and-space · motion ·
copy · anti-patterns). Do not read log.json. Do not append memory. Do not run
-the full gate sweep: the Core-15 sweep only (contrast gates 40-41 are in it). Styles fully
+the full gate sweep: the Floor tier only (contrast gates 40-41 are in it). Styles fully
self-contained. Stamp the CSS with `direction: <n> of 3 · run: <run-id>`.
```
@@ -150,7 +150,7 @@ self-contained. Stamp the CSS with `direction: <n> of 3 · run: <run-id>`.
**Progressive reveal wiring.** Whichever path: the manifest row starts at `status:"generating"` with no `url`. When a direction's files exist and are servable, write its `url` and set `status:"ready"` in one atomic manifest write, then say "Direction <n> ready" in chat. Do not wait for all three before the first flip.
-**Draft quality bar.** Drafts are sketch depth and get an abbreviated pass: run `sloplint.mjs` on each draft and fix FAILs (it is cheap and mechanical), then sweep only the **Core-15** ([`slop-test.md`](../slop-test.md) § Core-15, which includes contrast gates 40-41) by judgment. ONLY THE WINNER runs the full 58-gate sweep, later, at § 7. Do not spend three full sweeps on sketches that will be archived.
+**Draft quality bar.** Drafts are sketch depth and get an abbreviated pass: run `sloplint.mjs` on each draft and fix FAILs (it is cheap and mechanical), then sweep the **Floor tier** ([`slop-test.md`](../slop-test.md) § Tiers, which includes contrast gates 40-41) by judgment. ONLY THE WINNER runs the full 58-gate sweep, later, at § 7. Do not spend three full sweeps on sketches that will be archived.
**Self-containment.** Each direction is fully self-contained: its own inline styles or a sibling css file in its folder. No shared `tokens.css` across directions; shared theme tokens would quietly homogenize the three systems you are trying to keep apart. The shared base of § Speed is head/reset/font-load only, copied in, not a live shared theme file. In routes mode, hang each direction's token block on the route's own root element (a wrapper class), not `:root`, so three simultaneous routes cannot fight each other or leak into the app shell; every colour still references a `var(--*)` per the critical floor. The winner gets properly tokenized at promotion.
@@ -345,7 +345,7 @@ On `{"action": "pick", "choice": n}` or the chat equivalent (and after any graft
1. Copy the winner into place as the normal build output (wherever a default Hallmark build would land for this project).
2. Complete the sketch to full depth first (unless `--full` already built full pages): remaining sections, all states, responsive pass.
-3. Run the FULL 58-gate sweep + sloplint, fix every FAIL, stamp, emit `tokens.css`, exactly as SKILL.md Steps 6-7 demand. The draft's abbreviated pass counts for nothing here; the winner earns the whole bar.
+3. Run the FULL 58-gate sweep + sloplint, fix every FAIL or waive it on the record, stamp, emit `tokens.css`, exactly as SKILL.md Steps 6-7 demand. The draft's abbreviated pass counts for nothing here; the winner earns the whole bar.
**Routes mode:** state the file plan first: the standard safety rail, promoting into real targets needs the user's ok. For example:
diff --git a/skills/hallmark/scripts/fixtures/eyebrow-fail/index.html b/skills/hallmark/scripts/fixtures/eyebrow-fail/index.html
new file mode 100644
index 0000000..aa8bb06
--- /dev/null
+++ b/skills/hallmark/scripts/fixtures/eyebrow-fail/index.html
@@ -0,0 +1,118 @@
+<!doctype html>
+<!--
+ Gate 54 fixture — MUST FAIL, six times.
+
+ Every case here was invisible to the pre-1.3 detector, which keyed on
+ `grid-template-columns` in the CSS and so only ever saw one geometry.
+ Assertion (run from this directory):
+
+ node ../../sloplint.mjs . --json | node -e "let s='';process.stdin.on('data',d=>s+=d).on('end',()=>console.log(JSON.parse(s).findings.filter(f=>f.gate==='54'&&f.grade==='FAIL').length))"
+ # expected: 6
+
+ Scoped to gate 54 on purpose — this file is deliberately slop in other ways too.
+-->
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Gate 54 — eyebrow fixture (must fail)</title>
+<style>
+/* Hallmark · macrostructure: fixture · tone: n/a · anchor hue: 250 · hero: Settled/H1 */
+/* Hallmark · pre-emit critique: P3 H3 E3 S3 R3 V3 · weakest: all - this is a fixture */
+:root {
+ --color-paper: oklch(97% 0.006 250); --color-ink: oklch(20% 0.02 250);
+ --color-muted: oklch(52% 0.015 250);
+ --font-display: "Fraunces", serif; --font-body: "Public Sans", sans-serif;
+ --font-label: "Geist Mono", monospace;
+ --text-xs: 0.75rem; --tracking-label: 0.12em;
+}
+html, body { overflow-x: clip; }
+body { background: var(--color-paper); color: var(--color-ink); font-family: var(--font-body); }
+h1, h2, h3 { font-family: var(--font-display); }
+
+/* 1 — flex column. No grid anywhere; the old check could not see this. */
+.a__head { display: flex; flex-direction: column; gap: 0.5rem; }
+.a__eyebrow { font-family: var(--font-label); text-transform: uppercase;
+ letter-spacing: var(--tracking-label); font-size: var(--text-xs); color: var(--color-muted); }
+
+/* 2 — plain block stack, and a class name outside the label vocabulary.
+ Caught by resolved CSS alone: uppercase + tracking + small size. */
+.b__strand { text-transform: uppercase; letter-spacing: 0.14em; font-size: 0.75rem;
+ color: var(--color-muted); }
+
+/* 3 — the classic side-by-side grid. Regression guard for the old behaviour. */
+.c__head { display: grid; grid-template-columns: minmax(0, 0.4fr) minmax(0, 1fr); gap: 2rem; }
+
+/* 4 — multi-column head declared ONLY inside a max-width block. The old check
+ skipped every max-width rule, so this shape was a free pass. */
+@media (max-width: 48rem) {
+ .d__head { display: grid; grid-template-columns: 1fr 2fr; }
+}
+
+/* 5 — class-less heading. The old check required a semantic match on the head
+ wrapper's own classes to even look. */
+.e__mark { font-family: var(--font-label); text-transform: uppercase;
+ letter-spacing: 0.1em; font-size: 0.75rem; }
+
+/* 6 — "overline" was not in the old vocabulary at all. */
+.overline { font-size: 0.75rem; letter-spacing: 0.16em; text-transform: uppercase; }
+</style>
+</head>
+<body>
+
+<!-- 1 · flex column stack -->
+<section>
+ <div class="a__head">
+ <p class="a__eyebrow">01 · The tour</p>
+ <h2>Everything in one pass</h2>
+ </div>
+ <p>Body copy.</p>
+</section>
+
+<!-- 2 · plain block stack, non-vocabulary class, CSS signals only -->
+<section>
+ <div>
+ <p class="b__strand">Weather and tides</p>
+ <h2>Read the water before you launch</h2>
+ </div>
+ <p>Body copy.</p>
+</section>
+
+<!-- 3 · side-by-side grid (the only shape the old gate caught) -->
+<section>
+ <div class="c__head">
+ <span class="eyebrow">02 / Features</span>
+ <h2>What it does</h2>
+ </div>
+ <p>Body copy.</p>
+</section>
+
+<!-- 4 · two-column head hidden inside a max-width query -->
+<section>
+ <div class="d__head">
+ <span class="kicker">Chapter three</span>
+ <h2>The long crossing</h2>
+ </div>
+ <p>Body copy.</p>
+</section>
+
+<!-- 5 · class-less heading under a labelled span -->
+<section>
+ <div>
+ <span class="e__mark">Introducing</span>
+ <h2>A quieter way to ship</h2>
+ </div>
+ <p>Body copy.</p>
+</section>
+
+<!-- 6 · the word the old vocabulary never knew -->
+<section>
+ <div>
+ <p class="overline">Pricing</p>
+ <h2>Pay for what you send</h2>
+ </div>
+ <p>Body copy.</p>
+</section>
+
+</body>
+</html>
diff --git a/skills/hallmark/scripts/fixtures/eyebrow-pass/index.html b/skills/hallmark/scripts/fixtures/eyebrow-pass/index.html
new file mode 100644
index 0000000..a122e26
--- /dev/null
+++ b/skills/hallmark/scripts/fixtures/eyebrow-pass/index.html
@@ -0,0 +1,129 @@
+<!doctype html>
+<!--
+ Gate 54 fixture — MUST NOT FAIL.
+
+ Ten shapes that look like an eyebrow to a naive detector and are not one.
+ Each carries a fact, a destination, or an identifier the reader would
+ otherwise lack: the three passports in references/section-entry.md.
+
+ Assertion (run from this directory):
+
+ node ../../sloplint.mjs . --json | node -e "let s='';process.stdin.on('data',d=>s+=d).on('end',()=>console.log(JSON.parse(s).findings.filter(f=>f.gate==='54').length))"
+ # expected: 0
+
+ Scoped to gate 54 — this file makes no claim to be clean on the other 57.
+-->
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Gate 54 — carve-out fixture (must pass)</title>
+<style>
+/* Hallmark · macrostructure: fixture · tone: n/a · anchor hue: 250 · hero: Settled/H1 */
+/* Hallmark · pre-emit critique: P3 H3 E3 S3 R3 V3 · weakest: all - this is a fixture */
+:root {
+ --color-paper: oklch(97% 0.006 250); --color-ink: oklch(20% 0.02 250);
+ --color-muted: oklch(52% 0.015 250); --color-accent: oklch(58% 0.14 250);
+ --font-display: "Fraunces", serif; --font-body: "Public Sans", sans-serif;
+ --font-label: "Geist Mono", monospace;
+ --text-xs: 0.75rem; --tracking-label: 0.12em;
+}
+html, body { overflow-x: clip; }
+body { background: var(--color-paper); color: var(--color-ink); font-family: var(--font-body); }
+h1, h2, h3, h4 { font-family: var(--font-display); }
+.label { font-family: var(--font-label); text-transform: uppercase;
+ letter-spacing: var(--tracking-label); font-size: var(--text-xs); color: var(--color-muted); }
+.steps { list-style: none; counter-reset: step; padding: 0; }
+.steps li { counter-increment: step; }
+.steps li h3::before { content: counter(step, decimal-leading-zero) " "; color: var(--color-muted); }
+</style>
+</head>
+<body>
+
+<!-- 1 · figcaption. Identifier, and it names something that is present. -->
+<figure>
+ <figcaption class="label">Plate 4 · letterpress proof</figcaption>
+ <h3>Off the grid</h3>
+</figure>
+
+<!-- 2 · table column header. Identifier. -->
+<table>
+ <thead><tr><th class="label">Weight</th><th class="label">Optical size</th></tr></thead>
+ <tbody><tr><td>240</td><td>14 pt</td></tr></tbody>
+</table>
+
+<!-- 3 · form field label. Identifier, bound to its control. -->
+<form>
+ <div>
+ <label class="label" for="email">Email</label>
+ <h3>Where should the proofs go?</h3>
+ <input id="email" type="email">
+ </div>
+</form>
+
+<!-- 4 · nav label. Destination. -->
+<nav>
+ <div>
+ <span class="label">Sections</span>
+ <h2 hidden>Navigation</h2>
+ <a href="/work">Work</a>
+ </div>
+</nav>
+
+<!-- 5 · dateline. Fact — the date appears nowhere else. -->
+<article>
+ <p class="label"><time datetime="2026-03-14">14 March 2026</time> · Marta Silveira</p>
+ <h2>Notes from the second crossing</h2>
+</article>
+
+<!-- 6 · unit label AFTER the figure it labels. Order is the discriminator. -->
+<section>
+ <div>
+ <p class="stat__num">42B</p>
+ <p class="label">events metered</p>
+ </div>
+ <h3>Throughput</h3>
+</section>
+
+<!-- 7 · code filename tab. Identifier — a real path. -->
+<section>
+ <div>
+ <span class="label">server.ts</span>
+ <h4>Wire the handler</h4>
+ </div>
+ <pre><code>export default handler;</code></pre>
+</section>
+
+<!-- 8 · linked announcement chip. Destination, and it goes somewhere real. -->
+<header>
+ <div>
+ <a class="label" href="/changelog/v2">Read the launch post</a>
+ <h1>Ship the whole crossing</h1>
+ </div>
+</header>
+
+<!-- 9 · live telemetry above a headline. Fact, and the digits prove it. -->
+<section>
+ <div>
+ <p class="label">Live · 2,318 watching the drop</p>
+ <h1>Winter capsule, one hour left</h1>
+ </div>
+</section>
+
+<!-- 10 · a real <ol>. The numbers come from counter(), not from typed labels;
+ a genuine per-step identifier rides along without becoming a kicker. -->
+<ol class="steps">
+ <li>
+ <span class="label">Tue</span>
+ <h3>Arrive</h3>
+ <p>Collect the key from the harbour office.</p>
+ </li>
+ <li>
+ <span class="label">Wed</span>
+ <h3>Cross</h3>
+ <p>Six hours under sail, weather permitting.</p>
+ </li>
+</ol>
+
+</body>
+</html>
diff --git a/skills/hallmark/scripts/fixtures/slopped.html b/skills/hallmark/scripts/fixtures/slopped.html
index 233c52d..df939aa 100644
--- a/skills/hallmark/scripts/fixtures/slopped.html
+++ b/skills/hallmark/scripts/fixtures/slopped.html
@@ -24,7 +24,7 @@
48 inline hex colour outside the token block
50 bare 1fr grid track holding an img
51 display header with a long unbroken word, no overflow-wrap
- 54 eyebrow + h2 sharing a two-column grid row
+ 54 an eyebrow before an h2 (the two-column head is incidental now)
55 uppercase h2 at line-height 0.94
56 two position:sticky top:0 elements
-->
@@ -85,7 +85,7 @@ h2 {
}
.features__head {
display: grid;
- grid-template-columns: 1fr 2fr; /* gate 54: eyebrow beside heading */
+ grid-template-columns: 1fr 2fr; /* the eyebrow itself is gate 54; see the markup */
}
.gallery {
display: grid;
diff --git a/skills/hallmark/scripts/fixtures/waiver/index.html b/skills/hallmark/scripts/fixtures/waiver/index.html
new file mode 100644
index 0000000..4804fe1
--- /dev/null
+++ b/skills/hallmark/scripts/fixtures/waiver/index.html
@@ -0,0 +1,49 @@
+<!doctype html>
+<!--
+ Waiver fixture. Five waivers are claimed; three are honoured and two are refused,
+ and one of the refusals leaves its gate failing. That last part is the mechanism:
+ an over-cap waiver does not fall back to silence, it falls back to the gate.
+
+ Assertion (run from this directory):
+
+ node ../../sloplint.mjs . --json | node -e "let s='';process.stdin.on('data',d=>s+=d).on('end',()=>{const j=JSON.parse(s);console.log(JSON.stringify(j.summary))})"
+ # expected: fails 2, waived 3, rejected 2
+ # (counts are findings, not gates: gate 1 fires on both the token and the h1
+ # rule, and gate 7 on both the token and the body background)
+
+ Case by case:
+ waive 40 → refused, Floor is never waivable
+ waive 7 → honoured; the guard (surface: absolute in the stamp) holds
+ waive 22 → honoured
+ waive 25 → honoured (no finding to downgrade here); fills the three-gate cap
+ waive 1 → refused on the cap, and gate 1 then fails on its own merits
+-->
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Waiver fixture</title>
+<style>
+/* Hallmark · macrostructure: Manifesto · tone: austere · anchor hue: 250 · surface: absolute · nav: N9 · footer: Ft2 · hero: Poster/H1 */
+/* Hallmark · pre-emit critique: P5 H4 E5 S4 R5 V4 · weakest: E - fixture, not a real build */
+/* Hallmark · waive 40 · contrast measured on the stage · the manifesto is printed white on black */
+/* Hallmark · waive 7 · surface: absolute declared, 40-41 pass · the manifesto stage is printed on black paper */
+/* Hallmark · waive 22 · neutrals achromatic throughout · the manifesto rules are pure grey by intent */
+/* Hallmark · waive 25 · measure runs to 96ch · the manifesto sets long declarative lines */
+/* Hallmark · waive 1 · two families declared · the manifesto pairs a display serif with a grotesque */
+:root {
+ --color-paper: #000;
+ --color-ink: oklch(96% 0 250);
+ --font-display: Inter, sans-serif;
+ --font-body: "Public Sans", sans-serif;
+}
+html, body { overflow-x: clip; }
+body { background: var(--color-paper); color: var(--color-ink); font-family: var(--font-body); }
+h1 { font-family: var(--font-display); }
+</style>
+</head>
+<body>
+ <h1>A manifesto printed on a black stage</h1>
+ <p>The manifesto sets long declarative lines and lets the paper do the shouting.</p>
+</body>
+</html>
diff --git a/skills/hallmark/scripts/sloplint.mjs b/skills/hallmark/scripts/sloplint.mjs
index d469862..7e94856 100644
--- a/skills/hallmark/scripts/sloplint.mjs
+++ b/skills/hallmark/scripts/sloplint.mjs
@@ -37,7 +37,7 @@
* 48 colour or font literal outside the token block: #hex/rgb()/hsl() = FAIL,
* oklch() = WARN (calibrated: shipped pages extend tokens with oklch alpha
* variants in place; hex/rgb/hsl remain unambiguous improvisation)
- * 51 display header w/ long unbroken word and no overflow-wrap: anywhere
+ * 51 display header w/ long unbroken word and no overflow-wrap: break-word
* 53 CSS-only radio tabs at position:absolute top:0 with no JS guard
* 55 all-caps display head with line-height < 1.0
* 56 static half: two position:sticky top:0 elements
@@ -73,7 +73,7 @@
* 49 static half: long clickable label without white-space: nowrap
* 50 image-bearing grid track using bare 1fr
* 52 per-theme section-head override without mobile collapse
- * 54 eyebrow + heading in a multi-column wrapper
+ * 54 eyebrow / kicker / overline before a heading, in any geometry
*
* [M/R] gates 34, 40, 41, 49, 56 gain full verification in the optional render
* tier (sloplint-render.mjs, --render). Gate 44 is render-verifiable only.
@@ -279,29 +279,30 @@ function hasAttr(attrStr, name) {
return new RegExp(`(?:^|\\s)${name}(?=[\\s=/]|$)`, 'i').test(attrStr);
}
-/** Direct element children of tags[idx]: [{name, open, html}]. */
+/** Direct element children of tags[idx]: [{name, open, html, idx}].
+ * `idx` indexes back into doc.tags, so a caller can report at the child's own line. */
function directChildren(doc, idx) {
const open = doc.tags[idx];
if (open.close || open.selfClosing) return [];
const children = [];
let depth = 1;
- let childStart = -1, childOpen = null;
+ let childStart = -1, childOpen = null, childIdx = -1;
for (let i = idx + 1; i < doc.tags.length; i++) {
const t = doc.tags[i];
if (t.close) {
depth--;
if (depth === 0) break;
if (depth === 1 && childOpen) {
- children.push({ name: childOpen.name, open: doc.src.slice(childOpen.pos, childOpen.end), html: doc.src.slice(childStart, t.end) });
+ children.push({ name: childOpen.name, open: doc.src.slice(childOpen.pos, childOpen.end), html: doc.src.slice(childStart, t.end), idx: childIdx });
childOpen = null;
}
continue;
}
if (depth === 1) {
if (t.selfClosing) {
- children.push({ name: t.name, open: doc.src.slice(t.pos, t.end), html: doc.src.slice(t.pos, t.end) });
+ children.push({ name: t.name, open: doc.src.slice(t.pos, t.end), html: doc.src.slice(t.pos, t.end), idx: i });
} else {
- childStart = t.pos; childOpen = t;
+ childStart = t.pos; childOpen = t; childIdx = i;
}
}
if (!t.selfClosing) depth++;
@@ -309,6 +310,30 @@ function directChildren(doc, idx) {
return children;
}
+/** Ancestor tag names (outermost first) for every open tag, keyed by tags index. */
+function ancestorMap(doc) {
+ if (doc._anc) return doc._anc;
+ const map = new Map();
+ const stack = [];
+ for (let i = 0; i < doc.tags.length; i++) {
+ const t = doc.tags[i];
+ if (t.close) { stack.pop(); continue; }
+ map.set(i, stack.slice());
+ if (!t.selfClosing) stack.push(t.name);
+ }
+ doc._anc = map;
+ return map;
+}
+
+/** Rendered text of an HTML chunk, entities decoded, whitespace collapsed. */
+function plainText(html) {
+ return html.replace(/<[^>]*>/g, ' ')
+ .replace(/&middot;|&#0?183;/g, '·').replace(/&mdash;|&#8212;/g, '—').replace(/&ndash;|&#8211;/g, '–')
+ .replace(/&nbsp;|&#160;/g, ' ').replace(/&amp;/g, '&').replace(/&lt;/g, '<').replace(/&gt;/g, '>')
+ .replace(/&#\d+;|&[a-z]+;/gi, ' ')
+ .replace(/\s+/g, ' ').trim();
+}
+
/** innerHTML of tags[idx] via depth counting; returns {inner, endPos} or null. */
function innerOf(doc, idx) {
const open = doc.tags[idx];
@@ -485,16 +510,158 @@ const trunc = (s, n = 72) => (s.length > n ? s.slice(0, n - 1) + '…' : s);
/* ----------------------------------------------------------- gate engine --- */
-const COMPONENT_GATES = new Set(['1', '2', '7', '10', '14', '15', '22', '24', '26', '27', '30', '37', '38a', '39', '40', '41', '48', 'F4', 'F5', 'F6', 'F9']);
-const PAGE_ONLY = new Set(['3', '4', '5', '17', '18', '19', '20', '25', '28', '33', '34', '42', '43', '46', '47', '49', '50', '51', '52', '53', '54', '55', '56', 'copy-tell']);
+/* Gates that need a whole page to mean anything. Component scope is a SCOPE
+ filter, not a tier filter: a single button is still held to every gate that
+ can see it. Derived, so it cannot drift from a hand-kept Core-15 list. */
+const PAGE_ONLY = new Set(['3', '4', '5', '17', '18', '19', '20', '25', '28', '33', '34', '42', '43', '46', '47', '49', '50', '51', '52', '53', '54', '55', '56', 'F7', 'F8', 'copy-tell']);
+
+/* ------------------------------------------------------------ tiers --- */
+/* slop-test.md owns the tiers; this is its mechanical shadow. A split gate is
+ listed at the tier of the clause THIS SCRIPT can actually detect. Gate 7 is
+ the clearest case: its Floor clause (an absolute outside the token block) is
+ already caught by gate 48, so what check7 sees is the waivable half. */
+const TIERS = new Map(Object.entries({
+ '2': 'floor', '4': 'floor', '10': 'floor', '14': 'floor', '15': 'floor', '17': 'floor',
+ '18': 'floor', '19': 'floor', '20': 'floor', '26': 'floor', '27': 'floor', '28': 'floor',
+ '30': 'floor', '33': 'floor', '34': 'floor', '39': 'floor', '40': 'floor', '41': 'floor',
+ '46': 'floor', '48': 'floor', '49': 'floor', '50': 'floor', '51': 'floor', '52': 'floor',
+ '53': 'floor', '54': 'floor', '56': 'floor',
+
+ '1': 'reflex', '3': 'reflex', '5': 'reflex', '6': 'reflex', '7': 'reflex', '8': 'reflex',
+ '9': 'reflex', '11': 'reflex', '12': 'reflex', '13': 'reflex', '16': 'reflex', '21': 'reflex',
+ '22': 'reflex', '23': 'reflex', '24': 'reflex', '25': 'reflex', '29': 'reflex', '37': 'reflex',
+ '38a': 'reflex', '42': 'reflex', '43': 'reflex', '44': 'reflex', '45': 'reflex', '47': 'reflex',
+ '55': 'reflex',
+
+ '31': 'finish', '35': 'finish', '36': 'finish', '38': 'finish',
+ '32': 'ledger', '57': 'ledger',
+}));
+
+/** '7b' -> '7', '38a-ii' -> '38a', 'F3' -> 'F3' */
+function baseGate(id) {
+ const s = String(id).trim();
+ if (/^F\d+$/i.test(s)) return s.toUpperCase();
+ const m = /^(\d{1,2}a?)/.exec(s);
+ return m ? m[1] : s;
+}
+function tierOf(gate) {
+ const b = baseGate(gate);
+ if (/^F\d+$/.test(b)) return 'finish';
+ return TIERS.get(b) || 'floor';
+}
+
+/* Guards: the mechanical precondition a waiver has to have satisfied. Returning
+ a string rejects the waiver with that reason. Gates without an entry default
+ to satisfied — the reason checks and the caps still apply. */
+function fontFamilyCount(ctx) {
+ const fams = new Set();
+ for (const [prop, val] of Object.entries(ctx.tokens || {})) {
+ if (/^--font-/.test(prop)) fams.add(firstFamily(resolveVars(val, ctx.tokens)));
+ }
+ return fams.size;
+}
+const GUARDS = {
+ '1': (ctx) => fontFamilyCount(ctx) >= 2 || 'fewer than two font families are declared',
+ '7': (ctx) => /surface:\s*absolute/i.test(ctx.stampText) || 'the stamp does not declare surface: absolute',
+ '23': (ctx) => /posture:\s*(restrained|committed|full-palette|drenched)/i.test(ctx.stampText)
+ || 'the stamp declares no colour posture',
+ '37': (ctx) => fontFamilyCount(ctx) <= 4 || 'five or more families is past the backstop',
+ '38a': (ctx) => /font-synthesis\s*:\s*none/i.test(ctx.allCss) || 'font-synthesis: none is not declared',
+ '42': (ctx) => /·\s*nav:\s*\S/i.test(ctx.stampText) || 'the stamp has no nav: field naming the pattern',
+ '43': (ctx) => /·\s*footer:\s*\S/i.test(ctx.stampText) || 'the stamp has no footer: field naming the pattern',
+ '44': (ctx) => /·\s*hero:\s*\S/i.test(ctx.stampText) || 'the stamp names no hero: posture',
+};
+
+const WAIVER_MAX = 3;
+/* Boilerplate is stripped phrase by phrase, not matched whole: "intentional
+ design choice" is three boilerplate phrases in a trench coat and used to slip
+ through a full-string test. Whatever survives the strip has to be substantial. */
+const WAIVER_FILLER = /\b(a|an|the|is|it|this|that|was|are|and|but|so|very|just|really|here|quite|more|most)\b/gi;
+const WAIVER_BOILERPLATE_PHRASES = [
+ 'design choice', 'design decision', 'intentionally', 'intentional', 'by design',
+ 'looks better', 'for the aesthetic', 'aesthetic', 'necessary here', 'necessary',
+ 'the brief requires it', 'brief requires', 'on purpose', 'deliberate', 'deliberately',
+ 'it works', 'works better', 'needed', 'required', 'fine', 'ok', 'okay',
+];
+function reasonIsBoilerplate(reason) {
+ let r = reason.toLowerCase();
+ for (const p of WAIVER_BOILERPLATE_PHRASES) r = r.split(p).join(' ');
+ r = r.replace(WAIVER_FILLER, ' ').replace(/[^a-z0-9]+/g, ' ').trim();
+ return r.length < 12;
+}
+
+/* Honoured waivers for the group currently being checked. */
+let WAIVED = new Set();
const findings = [];
function report(gate, grade, file, line, evidence, fix) {
const g = String(gate);
- if (opts.scope === 'component' && !COMPONENT_GATES.has(g)) return;
- findings.push({ gate: g, grade, file: rel(file), line: line || 1, evidence: trunc(String(evidence)), fix });
+ if (opts.scope === 'component' && PAGE_ONLY.has(g)) return;
+ const tier = tierOf(g);
+ if (tier === 'ledger' && grade === 'FAIL') grade = 'NOTE';
+ if (grade === 'FAIL' && tier === 'reflex' && WAIVED.has(baseGate(g))) grade = 'WAIVED';
+ findings.push({ gate: g, grade, tier, file: rel(file), line: line || 1, evidence: trunc(String(evidence)), fix });
+}
+
+/** Parse, judge, and apply the `waive` lines in a group's stamp. */
+function applyWaivers(ctx, dir) {
+ WAIVED = new Set();
+ const re = /\/\*\s*Hallmark\s*·\s*waive\s+(\d{1,2}[a-z]?(?:-[a-z]+)?|F\d+)\s*·\s*([^·*]+?)\s*·\s*([^*]+?)\s*\*\//gi;
+ const claims = [...ctx.stampText.matchAll(re)].map((m) => ({
+ id: m[1], evidence: m[2].trim(), reason: m[3].trim(), raw: m[0],
+ }));
+ /* Anything that says "waive" but does not parse must say so. Silently ignoring
+ a malformed waiver leaves the author staring at a gate they thought they had
+ answered, with nothing to tell them the syntax was wrong. */
+ const wellFormed = new Set(claims.map((c) => c.raw));
+ const malformed = [...ctx.stampText.matchAll(/\/\*[^*]*Hallmark[^*]*·\s*waive\b[^*]*\*\//gi)]
+ .map((m) => m[0]).filter((raw) => !wellFormed.has(raw));
+ if (!claims.length && !malformed.length) return;
+ const reasons = new Map();
+ for (const c of claims) {
+ const key = c.reason.toLowerCase();
+ reasons.set(key, (reasons.get(key) || 0) + 1);
+ }
+ /* words the page itself uses — a reason has to be about THIS page */
+ const pageWords = new Set(
+ (ctx.stampText + ' ' + ctx.docs.map((d) => d.text).join(' '))
+ .toLowerCase().match(/[a-z]{4,}/g) || []
+ );
+ const file = ctx.cssFiles[0]?.file || ctx.docs[0]?.file || dir;
+ const rejectAt = (c, why) =>
+ findings.push({
+ gate: baseGate(c.id), grade: 'WAIVER', tier: tierOf(c.id), file: rel(file), line: 1,
+ evidence: trunc(`waiver on ${c.id} REJECTED (${why})`),
+ fix: 'Fix the gate, or satisfy the guard and say why in the page\'s own words',
+ });
+
+ for (const raw of malformed) {
+ findings.push({
+ gate: 'waive', grade: 'WAIVER', tier: 'reflex', file: rel(file), line: 1,
+ evidence: trunc(`malformed waiver, ignored: ${raw.replace(/\s+/g, ' ')}`),
+ fix: 'Three · -separated fields: /* Hallmark · waive <gate> · <guard evidence> · <reason> */',
+ });
+ }
+ for (const c of claims) {
+ const b = baseGate(c.id);
+ const tier = tierOf(c.id);
+ if (tier !== 'reflex') { rejectAt(c, tier === 'ledger' ? 'bookkeeping gate' : 'Floor is never waivable'); continue; }
+ if (WAIVED.has(b)) { rejectAt(c, 'one waiver per gate'); continue; }
+ if (WAIVED.size >= WAIVER_MAX) { rejectAt(c, `cap: ${WAIVER_MAX} per artifact`); continue; }
+ if (c.reason.length < 24) { rejectAt(c, 'reason under 24 characters'); continue; }
+ if (reasonIsBoilerplate(c.reason)) { rejectAt(c, 'boilerplate reason'); continue; }
+ if (reasons.get(c.reason.toLowerCase()) > 1) { rejectAt(c, 'reason reused on another waiver'); continue; }
+ const words = c.reason.toLowerCase().match(/[a-z]{4,}/g) || [];
+ if (!words.some((w) => pageWords.has(w))) { rejectAt(c, 'reason shares no word with the page'); continue; }
+ const guard = GUARDS[b];
+ const verdict = guard ? guard(ctx) : true;
+ if (verdict !== true) { rejectAt(c, `guard: ${verdict}`); continue; }
+ WAIVED.add(b);
+ }
}
+const GRADE_RANK = { FAIL: 0, WAIVER: 1, WARN: 2, WAIVED: 3, NOTE: 4 };
+
function gateSortKey(g) {
if (g === '38a') return 38.5;
const f = /^F(\d+)$/.exec(g);
@@ -521,6 +688,67 @@ function mergedDeclsBySelector(rules) {
return [...map.values()];
}
+/* Class-to-declarations lookup. Approximates the DESKTOP computed style of an
+ element: rules are matched on their rightmost compound only (so `.a .b` is
+ treated as `.b`), and max-width blocks are skipped. Good enough to ask "is
+ this styled like a label?", never precise enough for layout maths. */
+function styleIndex(ctx) {
+ if (ctx._styleIdx) return ctx._styleIdx;
+ const entries = [];
+ for (const r of ctx.rules) {
+ if (r.keyframes || r.selector === '@font-face') continue;
+ if (r.media && /max-width/i.test(r.media)) continue;
+ for (const part of r.selector.split(',')) {
+ const compound = part.trim().split(/[\s>+~]+/).filter(Boolean).pop();
+ if (!compound) continue;
+ const cleaned = compound.replace(/::?[a-z-]+(\([^)]*\))?/gi, '').replace(/\[[^\]]*\]/g, '');
+ const classes = (cleaned.match(/\.[a-zA-Z_][\w-]*/g) || []).map((c) => c.slice(1));
+ const tagM = /^([a-zA-Z][\w-]*)/.exec(cleaned);
+ const tag = tagM ? tagM[1].toLowerCase() : null;
+ if (!classes.length && !tag) continue;
+ entries.push({ classes, tag, decls: r.decls });
+ }
+ }
+ ctx._styleIdx = entries;
+ return entries;
+}
+
+function styleFor(ctx, classAttr, tagName) {
+ const have = new Set(String(classAttr || '').split(/\s+/).filter(Boolean));
+ const decls = [];
+ for (const e of styleIndex(ctx)) {
+ if (e.tag && e.tag !== tagName) continue;
+ if (!e.classes.every((c) => have.has(c))) continue;
+ decls.push(...e.decls);
+ }
+ return decls;
+}
+
+/** Last-wins value of `prop` in a decl list, with var() resolved. */
+function declValue(ctx, decls, prop) {
+ let v = null;
+ for (const d of decls) if (d.prop === prop) v = d.value;
+ return v == null ? null : resolveVars(v, ctx.tokens);
+}
+
+function fontPxOf(ctx, decls) {
+ const v = declValue(ctx, decls, 'font-size');
+ if (!v) return null;
+ const clamped = /clamp\(\s*([^,]+),/.exec(v); /* clamp() → its floor */
+ return pxOf(clamped ? clamped[1].trim() : v);
+}
+
+/** letter-spacing in em. Never route an em value through pxOf — 0.16em is not 2.56px. */
+function trackingEmOf(ctx, decls, fontPx) {
+ const v = declValue(ctx, decls, 'letter-spacing');
+ if (!v) return null;
+ const m = /^(-?\d*\.?\d+)em$/.exec(v.trim());
+ if (m) return parseFloat(m[1]);
+ const px = pxOf(v);
+ if (px == null || !fontPx) return null;
+ return px / fontPx;
+}
+
/* gate 1: banned display font */
function check1(ctx) {
const banned = new Set(['inter', 'roboto', 'open sans', 'poppins', 'lato', 'system-ui', '-apple-system', 'arial', 'helvetica', 'helvetica neue', 'segoe ui']);
@@ -1495,7 +1723,7 @@ function check51(ctx) {
if (risky) break;
}
if (risky && !wrapCovered(cls, t.name)) {
- report(51, 'FAIL', doc.file, t.line, `display header word "${trunc(risky, 30)}" with no overflow-wrap: anywhere`, 'Add overflow-wrap: anywhere and min-width: 0');
+ report(51, 'FAIL', doc.file, t.line, `display header word "${trunc(risky, 30)}" with no overflow-wrap`, 'Add overflow-wrap: break-word and min-width: 0');
}
}
}
@@ -1533,45 +1761,153 @@ function check53(ctx) {
}
}
-/* gate 54: eyebrow beside heading (multi-column head wrapper) */
+/* gate 54: eyebrow / kicker / overline announcing a heading. Banned outright,
+ in every geometry — stacked, side-by-side, badge pill, ordinal, card-scoped.
+ DOM-first: walk containers looking for "short inert label immediately before a
+ heading", then consult resolved CSS for corroboration. The old CSS-first check
+ only saw multi-column grids, so it missed flex stacks, block stacks, heads
+ declared inside a media query, class-less headings, and the word "overline". */
+
+const EYEBROW_CONTAINER = /^(div|header|section|article|aside|hgroup|li|main|figure|a|body|blockquote)$/;
+/* A is never an eyebrow when it is one of these: each is a label for a thing
+ that is present (identifier), not an announcement of what comes next. */
+const EYEBROW_SKIP_TAGS = /^(figcaption|label|legend|caption|th|dt|summary|option|code|kbd|button|select|nav|time)$/;
+const EYEBROW_ANCESTOR_SKIP = /^(form|fieldset|table|thead|tbody|nav|menu|dl|select|figcaption|label|button)$/;
+/* leaf-ish test: a wrapper holding real content is a band, not a label */
+const EYEBROW_BLOCKY = /<(p|ul|ol|hr|h[1-6]|img|table|figure|section|article|blockquote|form|dl)\b/i;
+const EYEBROW_CLASS = /\b(eyebrow|kicker|overline|superhead|suphead|rubric|strap(line)?|pre-?(title|head(ing)?)|section-?label|num-?label|chapter|ordinal|topic|category|dept)\b|__(num|label|tag|kicker|chip|badge|meta|index|caps|micro)\b|\b(tag|chip|badge|meta|caps|micro|label|index)\b/i;
+const EYEBROW_ANNOUNCE = /^(features?|benefits?|introducing|new|how it works?|the (process|tour)|our (process|story|work|team|approach|values?)|why (us|choose|we)|pricing|plans?|faq|questions?|testimonials?|reviews?|trusted by|as seen in|what we do|about( us)?|services?|solutions?|use cases?|get started|contact|team|work|projects?|gallery|blog|news|resources?|examples?|overview)$/i;
+
+function capsRatio(s) {
+ const letters = s.replace(/[^A-Za-z]/g, '');
+ if (!letters) return 0;
+ return (letters.match(/[A-Z]/g) || []).length / letters.length;
+}
+
+/** Does B read as the heading this label would be announcing? */
+function eyebrowHeadingBearing(ctx, B, aPx) {
+ if (/^h[1-6]$/.test(B.name)) return true;
+ if (/<h[1-6][\s>]/i.test(B.html)) return true;
+ /* a class-less or non-semantic head still counts when it is visually a head:
+ display-ish class AND at least 1.5x the label's size */
+ const cls = getAttr(B.open, 'class') || '';
+ if (!/__(title|display|head(line)?|h\d)\b|hero__|masthead|wordmark/i.test(cls)) return false;
+ const bPx = fontPxOf(ctx, styleFor(ctx, cls, B.name));
+ return bPx != null && aPx != null && bPx >= 1.5 * aPx;
+}
+
+function eyebrowHit(ctx, A, B, inOrderedList) {
+ if (EYEBROW_SKIP_TAGS.test(A.name)) return null;
+ if (/(^|\s)for\s*=/i.test(A.open)) return null;
+ if (/role\s*=\s*["']status|aria-live|aria-current|aria-hidden\s*=\s*["']true/i.test(A.open)) return null;
+ const inner = A.html.slice(A.open.length);
+ if (EYEBROW_BLOCKY.test(inner) || /<br\b/i.test(inner)) return null;
+ if (/<time\b[^>]*\sdatetime\s*=/i.test(A.html)) return null; /* dateline */
+ if (/<img\b[^>]*\salt\s*=\s*["'][^"']+/i.test(A.html)) return null;
+ /* destination: a linked chip, category link, or nav label is not an eyebrow */
+ const ownHref = A.name === 'a' ? getAttr(A.open, 'href') : null;
+ if (ownHref && !/^#?$/.test(ownHref.trim())) return null;
+ const innerHref = /<a\b[^>]*\shref\s*=\s*["']([^"']*)["']/i.exec(inner);
+ if (innerHref && !/^#?$/.test(innerHref[1].trim())) return null;
+
+ const text = plainText(A.html);
+ if (!text) return null;
+ const words = text.split(/[\s·/|—–]+/).filter(Boolean);
+ if (words.length > 7 || text.length > 56) return null;
+ if (/[\w/-]+\.[a-z]{1,4}$/i.test(text)) return null; /* code filename tab */
+
+ /* the digit rule: one leading ordinal is an eyebrow's costume, but any further
+ figure is a fact the reader would otherwise lack — a price, a version, a
+ date, a live count. Strip the ordinal; if two or more digits survive, pass.
+ A quantity carrying a unit (24h, 100%, 4.7/5) is a figure, never an ordinal;
+ bare digits (01, 02) are the costume, so those still fire. */
+ if (/^[\d.,]+\s*(?:[%°+]|[a-z]{1,3})$/i.test(text)) return null;
+ const stripped = text.replace(/^\s*(?:no\.?\s*)?\d{1,3}(?:\s*[·./—–-]\s*|\s+|$)/i, '').trim();
+ if ((stripped.match(/\d/g) || []).length >= 2) return null;
+ /* Known limitation: two digits is enough to buy a pass, so a season or volume
+ wearing a label's costume ("The W'25 Collection") slips through. Raising the
+ threshold to three catches those but starts failing legitimate version and
+ status lines ("Open beta · v1.0"), and a false positive on an auto-fail gate
+ costs more than a miss. The judged sweep at Step 7 is the backstop. */
+ /* real <ol> semantics is the prescribed fix, so structure earns the pass */
+ if (inOrderedList && stripped && !EYEBROW_ANNOUNCE.test(stripped)) return null;
+
+ const cls = getAttr(A.open, 'class') || '';
+ const aDecls = styleFor(ctx, cls, A.name);
+ /* Out of flow is not "before the heading": a ribbon pinned to a card's edge
+ reads as a ribbon, whatever its DOM position. */
+ const pos = declValue(ctx, aDecls, 'position');
+ if (pos && /absolute|fixed/.test(pos)) return null;
+ const aPx = fontPxOf(ctx, aDecls);
+ if (!eyebrowHeadingBearing(ctx, B, aPx)) return null;
+
+ if (EYEBROW_CLASS.test(cls)) return { text };
+ let signals = 0;
+ const tt = declValue(ctx, aDecls, 'text-transform');
+ if ((tt && /uppercase/.test(tt)) || (capsRatio(text) >= 0.6 && /[A-Z]/.test(text))) signals++;
+ const tr = trackingEmOf(ctx, aDecls, aPx || 16);
+ if (tr != null && tr >= 0.04) signals++;
+ if (aPx != null && aPx <= 15) signals++;
+ const ff = declValue(ctx, aDecls, 'font-family');
+ if (ff && /mono|--font-label/i.test(ff)) signals++;
+ const fv = declValue(ctx, aDecls, 'font-variant-caps');
+ if (fv && /small-caps/.test(fv)) signals++;
+ if (signals >= 2) return { text };
+ if (EYEBROW_ANNOUNCE.test(stripped)) return { text };
+ return null;
+}
+
function check54(ctx) {
- const multiCol = (v) => {
- const flat = v.replace(/minmax\([^)]*\)|repeat\([^)]*\)|calc\([^)]*\)/g, 'T');
- const tracks = flat.trim().split(/\s+/).filter((x) => x && x !== '/');
- if (/repeat\(/.test(v)) return true;
- return tracks.length >= 2 && !/^(none|subgrid)$/.test(v.trim());
- };
- for (const r of ctx.rules) {
- if (r.media && /max-width/.test(r.media)) continue;
- const d = r.decls.find((x) => x.prop === 'grid-template-columns' && multiCol(resolveVars(x.value, ctx.tokens)));
- if (!d) continue;
- const classes = (r.selector.match(/\.[a-zA-Z][\w-]*/g) || []).map((c) => c.slice(1));
- if (!classes.length) continue;
- for (const doc of ctx.docs) {
- for (let i = 0; i < doc.tags.length; i++) {
- const t = doc.tags[i];
- if (t.close || t.selfClosing) continue;
- const cls = getAttr(t.attrs, 'class') || '';
- if (!classes.some((c) => cls.split(/\s+/).includes(c))) continue;
- /* the eyebrow and the heading must live in DIFFERENT grid children
- (side by side); label + heading stacked inside one column passes */
- const children = directChildren(doc, i);
- const eyebrowRe = /class\s*=\s*["'][^"']*(eyebrow|kicker|label|tag\b|__num|index|chapter)/i;
- const CONTENT_TAGS = /^(ol|ul|table|section|article|main|nav|figure)$/;
- let eyebrowChild = -1, headingChild = -1;
- children.forEach((chunk, ci) => {
- /* only the child's own open tag counts as an eyebrow; a label-classed
- element buried inside a content column (a track-number span in an
- <ol>) is not a section eyebrow */
- if (eyebrowChild === -1 && eyebrowRe.test(chunk.open) && !CONTENT_TAGS.test(chunk.name)) eyebrowChild = ci;
- if (headingChild === -1 && (/^h[1-6]$/.test(chunk.name) || /<h[1-6]\b/i.test(chunk.html))) headingChild = ci;
- });
- if (eyebrowChild !== -1 && headingChild !== -1 && eyebrowChild !== headingChild) {
- report(54, 'FAIL', r.file, d.line, `eyebrow + heading share a ${trunc(d.value, 20)} row (${r.selector})`, 'Stack the eyebrow above the heading');
+ for (const doc of ctx.docs) {
+ const anc = ancestorMap(doc);
+ for (let i = 0; i < doc.tags.length; i++) {
+ const t = doc.tags[i];
+ if (t.close || t.selfClosing || !EYEBROW_CONTAINER.test(t.name)) continue;
+ const ancestors = anc.get(i) || [];
+ if (ancestors.some((n) => EYEBROW_ANCESTOR_SKIP.test(n))) continue;
+ const inOl = ancestors.includes('ol') || t.name === 'li';
+ const kids = directChildren(doc, i);
+ for (let k = 0; k < kids.length - 1; k++) {
+ const A = kids[k];
+ let B = null;
+ for (let j = k + 1; j < Math.min(kids.length, k + 3); j++) {
+ const c = kids[j];
+ if (c.name === 'hr' || /aria-hidden\s*=\s*["']true/i.test(c.open)) continue;
+ B = c; break;
+ }
+ if (!B) continue;
+ const hit = eyebrowHit(ctx, A, B, inOl);
+ if (hit) {
+ report(54, 'FAIL', doc.file, doc.tags[A.idx]?.line || t.line,
+ `eyebrow "${trunc(hit.text, 32)}" before <${B.name}>`,
+ 'Cut it; the heading already says this (references/section-entry.md has twelve other openings)');
+ break; /* one finding per container */
}
}
}
}
+ check54Unheaded(ctx);
+}
+
+/* The honest edge case: a section whose only label IS its heading, marked up as
+ a label. Deleting it loses the section's name — the fix is <h2>, not a cut. */
+function check54Unheaded(ctx) {
+ for (const doc of ctx.docs) {
+ for (let i = 0; i < doc.tags.length; i++) {
+ const t = doc.tags[i];
+ if (t.close || t.selfClosing || !/^(section|article)$/.test(t.name)) continue;
+ const labelledBy = getAttr(t.attrs, 'aria-labelledby');
+ if (!labelledBy) continue;
+ const body = innerOf(doc, i);
+ if (!body || /<h[1-6][\s>]/i.test(body.inner)) continue;
+ const idRe = new RegExp(`<([a-z][\\w-]*)\\b[^>]*\\sid\\s*=\\s*["']${labelledBy.split(/\s+/)[0]}["'][^>]*>`, 'i');
+ const m = idRe.exec(body.inner);
+ if (!m || /^h[1-6]$/i.test(m[1])) continue;
+ report(54, 'WARN', doc.file, doc.lineOf(body.endPos - body.inner.length + m.index),
+ `section labelled by <${m[1].toLowerCase()}> with no heading element`,
+ 'Promote it to <h2>; a label doing heading duty should be a heading');
+ }
+ }
}
/* gate 55: all-caps display head with line-height < 1 */
@@ -1881,7 +2217,16 @@ for (const [dir, g] of groups) {
// inline styles participate in token discipline via check48 (scanned there)
}
}
- const ctx = { rules, tokens: buildTokens(rules), docs, cssFiles, genre: opts.genre };
+ /* The stamp: the first 40 lines of every stylesheet plus the first 60 of every
+ document, which is where gate 20 requires it and where waivers must live. */
+ const stampText = [
+ ...cssFiles.map((c) => c.raw.split('\n').slice(0, 40).join('\n')),
+ ...docs.map((d) => d.src.split('\n').slice(0, 60).join('\n')),
+ ].join('\n');
+ const allCss = cssFiles.map((c) => c.raw).join('\n') + '\n'
+ + docs.map((d) => d.styles.map((s) => s.css).join('\n')).join('\n');
+ const ctx = { rules, tokens: buildTokens(rules), docs, cssFiles, genre: opts.genre, stampText, allCss };
+ applyWaivers(ctx, dir);
for (const check of CHECKS) {
try { check(ctx); } catch (e) {
console.error(`sloplint: internal error in ${check.name} for ${dir}: ${e.message}`);
@@ -1919,30 +2264,46 @@ const unique = findings.filter((f) => {
});
unique.sort((a, b) => {
- if (a.grade !== b.grade) return a.grade === 'FAIL' ? -1 : 1;
+ const ra = GRADE_RANK[a.grade] ?? 9, rb = GRADE_RANK[b.grade] ?? 9;
+ if (ra !== rb) return ra - rb;
const ga = gateSortKey(a.gate), gb = gateSortKey(b.gate);
if (ga !== gb) return ga - gb;
if (a.file !== b.file) return a.file < b.file ? -1 : 1;
return a.line - b.line;
});
-const fails = unique.filter((f) => f.grade === 'FAIL').length;
-const warns = unique.filter((f) => f.grade === 'WARN').length;
+const count = (g) => unique.filter((f) => f.grade === g).length;
+const fails = count('FAIL');
+const warns = count('WARN');
+const waived = count('WAIVED');
+const rejected = count('WAIVER');
+const notes = count('NOTE');
+
+const tally = [`${fails} FAIL`, `${warns} WARN`];
+if (waived) tally.push(`${waived} WAIVED`);
+if (rejected) tally.push(`${rejected} REJECTED`);
+if (notes) tally.push(`${notes} NOTE`);
if (opts.json) {
- console.log(JSON.stringify({ summary: { fails, warns, files: files.length }, findings: unique }, null, 2));
+ console.log(JSON.stringify({
+ summary: { fails, warns, waived, rejected, notes, files: files.length },
+ findings: unique,
+ }, null, 2));
} else {
if (!unique.length) {
console.log(`sloplint: clean. 0 FAIL, 0 WARN across ${files.length} file(s).`);
} else {
const wGate = Math.max(4, ...unique.map((f) => String(f.gate).length));
+ const wGrade = Math.max(5, ...unique.map((f) => f.grade.length));
const wWhere = Math.max(9, ...unique.map((f) => `${f.file}:${f.line}`.length));
- console.log(`${'GATE'.padEnd(wGate)} GRADE ${'WHERE'.padEnd(wWhere)} EVIDENCE`);
+ console.log(`${'GATE'.padEnd(wGate)} ${'GRADE'.padEnd(wGrade)} ${'WHERE'.padEnd(wWhere)} EVIDENCE`);
for (const f of unique) {
- console.log(`${String(f.gate).padEnd(wGate)} ${f.grade.padEnd(5)} ${`${f.file}:${f.line}`.padEnd(wWhere)} ${f.evidence}`);
- console.log(`${''.padEnd(wGate)} ${''.padEnd(wWhere)} fix: ${f.fix}`);
+ console.log(`${String(f.gate).padEnd(wGate)} ${f.grade.padEnd(wGrade)} ${`${f.file}:${f.line}`.padEnd(wWhere)} ${f.evidence}`);
+ if (f.grade !== 'WAIVED') {
+ console.log(`${''.padEnd(wGate)} ${''.padEnd(wGrade)} ${''.padEnd(wWhere)} fix: ${f.fix}`);
+ }
}
- console.log(`\n${fails} FAIL, ${warns} WARN across ${files.length} file(s).`);
+ console.log(`\n${tally.join(', ')} across ${files.length} file(s).`);
}
}
process.exit(fails > 0 ? 1 : 0);