Skip to content

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

CSS

Twelve overlapping archetypes become six with knobs

Youssefb9306400a27b
diff --git a/skills/hallmark/references/component-cookbook.md b/skills/hallmark/references/component-cookbook.md
index 939f59c..778de95 100644
--- a/skills/hallmark/references/component-cookbook.md
+++ b/skills/hallmark/references/component-cookbook.md
@@ -13,23 +13,20 @@ The same page shape (say, Bento Grid) can be built from many combinations of the
### Heroes
- **H1 · Marquee.** A single statement fills the fold. No subhead; the primary action is the fold's one other visible control. [`components/h1-marquee.md`](components/h1-marquee.md)
-- **H2 · Split diptych.** Headline and lede on one side, image or product capture on the other. 6/6 or 7/5 columns. [`components/h2-split-diptych.md`](components/h2-split-diptych.md)
+- **H2 · Split.** Headline, one sentence and the action on one side; one visual on the other, beside the text: a capture plate, a clipped demo video, a built illustration or a photograph, each with its enrichment recipe. [`components/h2-split-diptych.md`](components/h2-split-diptych.md)
- **H3 · Quote led.** A pull-quote with attribution is the hero, both the user's material. The headline is borrowed credibility. [`components/h3-quote-led.md`](components/h3-quote-led.md)
- **H4 · Stat led.** One figure the user gave, with its unit, is the hero. A small qualifier line below says what it means. [`components/h4-stat-led.md`](components/h4-stat-led.md)
- **H5 · Letter hero.** First-person opening, "Dear reader,". No buttons; the action is one typographic link inside the fold. Reads as personal correspondence. [`components/h5-letter-hero.md`](components/h5-letter-hero.md)
- **H6 · Photographic fold.** A single full-bleed image fills the viewport. The caption sits in a corner. [`components/h6-photographic-fold.md`](components/h6-photographic-fold.md)
-- **H7 · Demo video clipped by viewport edge.** Display headline left, demo video right, the rightmost 10 to 20% extending past the viewport so it is deliberately cut off. The clip *is* the design: it implies more product than fits the screen. [`components/h7-demo-video-clipped-by-viewport-edge.md`](components/h7-demo-video-clipped-by-viewport-edge.md)
-- **H8 · Screenshot as a plate**: Headline left, one real capture right in a `<figure>` with a `<figcaption>` carrying a fact, or the theme's labelled `data-slot`. One hairline frame at most, no chrome, no tilt. [`components/h8-mockup-split-browser-framed.md`](components/h8-mockup-split-browser-framed.md)
-- **H9 · Custom illustration centerpiece.** A single hand-built SVG (Tier B in the enrichment hierarchy, or pure CSS at Tier A for simpler shapes) sitting on the hero as one illustrative element: the bakery loaf, the studio mark. [`components/h9-custom-illustration-centerpiece.md`](components/h9-custom-illustration-centerpiece.md)
### Section heads
**Read `craft.md` § 7 before picking one.** These five are the structural shells; that section is the twelve ways in.
- **S1 · Ordinal by structure.** A genuinely ordered run numbered by `<ol>` and `counter()`, the numeral inline at heading size, never a small label above the heading. [`components/s1-left-margin-numbered.md`](components/s1-left-margin-numbered.md)
-- **S2 · Hanging.** Air above, heading flush; no border, no rule. [`components/s2-hanging.md`](components/s2-hanging.md)
+- **S2 · Hanging.** Air above, the heading flush; no border, no rule, no file: `craft.md` § 7, item 1.
- **S3 · Sticky pinned.** The heading remains in the viewport while content scrolls beneath. An orientation aid. [`components/s3-sticky-pinned.md`](components/s3-sticky-pinned.md)
-- **S4 · Inline no break.** The heading is a heavier phrase that emerges *inside* the body flow; no spatial break. [`components/s4-inline-no-break.md`](components/s4-inline-no-break.md)
+- **S4 · Inline, no break.** The heading is a heavier phrase that opens the paragraph; no spatial break, no file: `craft.md` § 7, item 3.
- **S5 · Bottom anchored.** A caption carrying a fact sits *below* the section's content. Inverts the hierarchy. [`components/s5-bottom-anchored.md`](components/s5-bottom-anchored.md)
### Feature blocks
@@ -70,20 +67,17 @@ Every block here is built from the user's material: their quote, their name, the
### Navigation
-- **N1 · Wordmark 2 links.** Top-of-page bar: wordmark on the left, two text links on the right ("Pricing", "Sign in"). No logo image, no menu icon. The *minimal* variant; for the dense canonical SaaS bar use **N1b**. [`components/n1-wordmark-2-links.md`](components/n1-wordmark-2-links.md)
- **N2 · Floating chip.** A small fixed chip in a corner: wordmark and a single action ("Try it"). Does not sit in document flow. [`components/n2-floating-chip.md`](components/n2-floating-chip.md)
- **N3 · Side rail.** A thin vertical strip on the left edge, wordmark rotated, plus named section links with `aria-current`; never the default nav, only where a sticky object earns it. [`components/n3-side-rail.md`](components/n3-side-rail.md)
-- **N4 · Hidden behind k.** No visible nav. The user opens a command palette via `⌘K` to get anywhere. For keyboard-first audiences. [`components/n4-hidden-behind-k.md`](components/n4-hidden-behind-k.md)
-- **N5 · Floating pill.** A rounded full-pill nav, *visibly detached* from the page edges, sitting about `var(--space-md)` from the top, soft blur backdrop, soft shadow. Contemporary modern-minimal. [`components/n5-floating-pill.md`](components/n5-floating-pill.md)
+- **N5 · Floating pill.** A content-sized pill detached from the edges, blur backdrop, hairline ring; from the first paint, or morphing from a full bar once the reader scrolls (one DOM, one curve, constant height). [`components/n5-floating-pill.md`](components/n5-floating-pill.md)
- **N6 · Newspaper masthead.** Full-width header: a large centred wordmark on the top row, a thin issue and date line above or below in the body face, an optional inline link row beneath, a double rule under the whole thing. [`components/n6-newspaper-masthead.md`](components/n6-newspaper-masthead.md)
- **N7 · Brutal slab.** A heavy, full-width nav with a 2px solid border-bottom, an all-caps wordmark and a heavy sentence-case link row; dense rhythm, no shadow, no rounded corners. [`components/n7-brutal-slab.md`](components/n7-brutal-slab.md)
-- **N8 · Terminal command.** A nav formatted as a CLI prompt: `> studio --catalog --voice --get▮`. The links are command flags. The blinking cursor (`▮`) is allowed *only here*, where it has a purpose. [`components/n8-terminal-command.md`](components/n8-terminal-command.md)
-- **N9 · Edge aligned minimal.** Wordmark hard-left, single CTA hard-right, vast empty space between, no link row at all. The *absence* is the design. [`components/n9-edge-aligned-minimal.md`](components/n9-edge-aligned-minimal.md)
-- **N10 · Floating on scroll morph.** A sticky bar at the top that **morphs into a floating pill** as the user scrolls past a threshold. Two visual modes share one DOM: `.nav` (outer) owns the bar look, `.nav__inner` the pill. [`components/n10-floating-on-scroll-morph.md`](components/n10-floating-on-scroll-morph.md)
-- **N1b · Canonical SaaS three-section.** Wordmark left, a centred cluster of four to six links (some with hover dropdowns), sign-in and a filled CTA right. The dominant modern marketing nav; frosts on scroll. N1 is the *minimal* two-link variant; this is the dense, balanced one. [`components/n1b-saas-three-section.md`](components/n1b-saas-three-section.md)
+- **N8 · Terminal command.** A nav formatted as a CLI prompt: `> studio --catalog --voice --get`. The links are command flags; a cursor may end the typed line and nothing else on the page blinks. [`components/n8-terminal-command.md`](components/n8-terminal-command.md)
+- **N9 · Edge-aligned.** Wordmark at one edge, one action or two text links at the other, nothing between. The first nav for a page with one or two destinations. [`components/n9-edge-aligned-minimal.md`](components/n9-edge-aligned-minimal.md)
+- **N1 · Three-section bar.** Wordmark left, a centred cluster of three to five links (some with small dropdowns), sign-in and one filled action right. The reflex product bar (42): only for four or more real top-level destinations, named in the stamp. [`components/n1-three-section-bar.md`](components/n1-three-section-bar.md)
- **N11 · Mega-menu panel.** A top bar whose triggers open a full-width multi-column panel (icon, title and description per item, grouped, plus a feature card); the page dims behind a scrim. For platforms and hubs with many grouped destinations. [`components/n11-mega-menu.md`](components/n11-mega-menu.md)
- **N12 · Announcement banner + retracting nav.** A coloured promo banner stacked above one real nav; the banner retracts on scroll-down, returns on scroll-up, dismisses via ×. The banner is not a second nav (colour contrast keeps them distinct). [`components/n12-banner-retract.md`](components/n12-banner-retract.md)
-- **N13 · Inline ⌘K search pill.** A visible search pill in the bar (placeholder plus a `⌘K` hint) opening a spotlight modal with grouped, keyboard-navigable results. The *visible* opposite of N4. For search-heavy and docs-heavy products. [`components/n13-inline-cmdk-pill.md`](components/n13-inline-cmdk-pill.md)
+- **N13 · Command palette.** A spotlight dialog of grouped, keyboard-navigable results opened by ⌘K; triggered by a visible search pill in the bar, or by one small `Menu ⌘K` control with no other nav for keyboard-first audiences. [`components/n13-inline-cmdk-pill.md`](components/n13-inline-cmdk-pill.md)
---
@@ -121,17 +115,17 @@ The knob values live **inside each archetype file** (`## Knobs`), next to the co
## Routing, which nav fits which genre / theme
-| Genre / cluster | Default nav | Acceptable also |
+| Genre / cluster | Default nav | Also OK |
| --- | --- | --- |
-| editorial | **N6 Masthead** | N1, N9, N12 |
-| modern-minimal | **N1b SaaS three-section** | N5, N11, N13, N9 |
-| atmospheric | **N5 Floating pill** (blur backdrop sells the mood) | N9, N4, N13, N1b |
-| playful | **N7 Brutal slab** on a heavy theme; **N12** or **N1b** on a soft one (N7 refuses rounded corners) | N11, N13 |
-| terminal / CLI | **N8 Terminal command** | N4 ⌘K-only, N13 |
-| docs / reference | **N1 edge-aligned bar**, N3 only when a sticky object earns it | N13, N4 |
-| commerce / product launch | **N12 Banner + retract** | N1b, N11, N9 |
-
-**Default away from N1.** The most-recognised machine fingerprint is N1 (wordmark, inline link row, button right) used reflexively. For a real product nav reach for **N1b** (the dense, balanced canonical bar) or N5, N11 or N13 first; reach for N1 only when the page genuinely has two destinations.
+| editorial | **N6 Masthead** on an issue or edition; **N9 Edge-aligned** otherwise | N12, N3 when a sticky object earns it |
+| modern-minimal | **N9 Edge-aligned** | N5, N13, N11 for six or more grouped products, N1 for four or more destinations |
+| atmospheric | **N5 Floating pill** (the blur sells the mood) | N9, N13 |
+| playful | **N7 Brutal slab** on a heavy theme; **N12** or **N9** on a soft one (N7 refuses rounded corners) | N5, N13 |
+| terminal / CLI | **N8 Terminal command** | N13 |
+| docs / reference | **N13 Command palette** with a search pill | N9, N3 when a sticky contents list earns it |
+| commerce / product launch | **N12 Banner + retract** | N9, N11 |
+
+**Default away from N1.** Wordmark left, a centred link row, a filled button right and a hairline under it is the most recognised machine-made nav (42). Start from the page's real destinations: one or two is N9, a search-led product is N13, a launch is N12, an edition is N6. N1 is right only when four or more top-level destinations exist, and then the stamp names it.
---
diff --git a/skills/hallmark/references/components/h2-split-diptych.md b/skills/hallmark/references/components/h2-split-diptych.md
index 380c0af..14343ed 100644
--- a/skills/hallmark/references/components/h2-split-diptych.md
+++ b/skills/hallmark/references/components/h2-split-diptych.md
@@ -1,26 +1,43 @@
-### H2 · Split diptych
-Headline and one sentence on one side, a capture or a photograph on the other. 7/5 or 6/6.
-*Use when:* the claim has a visual proof.
-*Not:* H6 (full bleed, not paired). The visual sits beside the text, centres within 60px (44c), never pinned to the viewport corner.
+### H2 · Split
+Headline, one sentence and the action on one side; one visual on the other, beside the text (vertical centres within 60px, 48 to 120px apart, 44c). The visual is the page's proof, so it is real material or a labelled slot, never a drawn product (47c).
+*Use when:* the claim has something to show.
+*Not:* H6 (the photograph fills the fold); a visual pinned to the viewport corner beside a text block hugging the opposite edge, the most recognisable machine-made hero there is.
```html
<section class="hero-split">
- <div class="hero-split__copy"><h1>…</h1><p>…</p><a class="cta-outline" href="#">…</a></div>
- <figure class="hero-split__visual" data-slot="hero"></figure>
+ <div class="hero-split__copy"><h1>…</h1><p>…</p><a class="btn btn--primary" href="#">…</a></div>
+ <figure class="hero-split__visual">
+ <div class="hero-split__media" data-slot="hero"><!-- the user's material, or the theme's placeholder (craft.md § 8) --></div>
+ <figcaption>…</figcaption>
+ </figure>
</section>
```
```css
-.hero-split { min-height: 80dvh; display: grid; grid-template-columns: minmax(0, 7fr) minmax(0, 5fr); gap: var(--gap-columns); align-items: center; padding-block: var(--space-2xl) var(--space-3xl); }
-.hero-split__visual { margin: 0; aspect-ratio: 16 / 10; }
-@media (max-width: 60rem) { .hero-split { grid-template-columns: minmax(0, 1fr); } }
+.hero-split { min-height: 80dvh; display: grid; grid-template-columns: minmax(0, 7fr) minmax(0, 5fr); gap: var(--space-3xl); align-items: center; padding-block: var(--space-2xl) var(--space-3xl); }
+.hero-split__visual { margin: 0; display: grid; gap: var(--space-sm); }
+.hero-split__media { aspect-ratio: 16 / 10; border-radius: min(1vw, 12px); outline: 1px solid color-mix(in oklab, var(--color-ink) 8%, transparent); outline-offset: -1px; }
+.hero-split__visual figcaption { font-size: var(--text-sm); color: var(--color-muted); }
+@media (max-width: 60rem) { .hero-split { grid-template-columns: minmax(0, 1fr); gap: var(--space-xl); } }
```
+The caption sits outside the slot, so the slot script does not hide it when the image lands. A caption states a fact (what the capture shows, where the photograph was taken), never a label for the picture.
+
+## The visual
+
+Pick one; its recipe is the enrichment file, read only that one.
+
+- **Capture plate.** One real screenshot, set like a plate in a catalogue, a hairline inset at most: no browser bar, traffic lights, tilt or stack (47a, 47b). Recipe: [`enrichment/e4-floating-no-frame.md`](../enrichment/e4-floating-no-frame.md).
+- **Clipped demo video.** The user's footage, its outer 10 to 20% running past the viewport edge (`margin-inline-end: calc(-1 * min(12vw, 12rem))`, the section keeps `overflow: visible`, the page clips at `html` and `body`, 34). Recipe: [`enrichment/e1-clipped-demo-video.md`](../enrichment/e1-clipped-demo-video.md).
+- **Built illustration.** One hand-built SVG or CSS shape that is the brand's own thing (a loaf, a mark, a process), fills from tokens (48), an `aria-label` or `aria-hidden` (33), never a library illustration (F10). Recipe: [`enrichment/e5-custom-illustration-centerpiece.md`](../enrichment/e5-custom-illustration-centerpiece.md).
+- **Photograph.** The user's photograph, cropped tighter than feels safe, toned toward the paper. Recipe: [`enrichment/e8-hero-photography.md`](../enrichment/e8-hero-photography.md).
+
## Knobs
-- Ratio: 7/5 · 6/6 · 5/7
-- Right side: capture · photograph · proof column
-- Divider: air · hairline
+- Ratio: 7/5 · 6/6 · 5/7 (the visual leads)
+- Side: visual right · visual left
+- Media: 16/10 · 4/3 · 1/1 · one phone-tall 9/16 with real content
+- Caption: beneath · in the margin beside · none (when nothing true can be said)
## Mobile
-- Below 60rem: one column, text first, the visual beneath at 16/9.
+- Below 60rem: one column, text first, the visual beneath; a clipped video stops clipping and runs full width.
diff --git a/skills/hallmark/references/components/h7-demo-video-clipped-by-viewport-edge.md b/skills/hallmark/references/components/h7-demo-video-clipped-by-viewport-edge.md
deleted file mode 100644
index 6f45fd0..0000000
--- a/skills/hallmark/references/components/h7-demo-video-clipped-by-viewport-edge.md
+++ /dev/null
@@ -1,33 +0,0 @@
-### H7 · Demo video, clipped by the viewport edge
-Headline left, a real demo video right, its rightmost 10 to 20% running past the viewport: the clip implies more product than fits the screen. The recipe (codecs, autoplay, poster, reduced motion) is [`enrichment/e1-clipped-demo-video.md`](../enrichment/e1-clipped-demo-video.md); this is the structural sketch.
-*Use when:* the product has a screen and the user supplied real footage. Without footage the same slot holds a real capture or the theme's `data-slot` placeholder (47c), never a drawn mockup.
-*Not:* H8 (a still, uncut); H4 (number led).
-
-```html
-<section class="hero hero--clipped">
- <div class="hero__copy"><h1>…</h1><p>…</p><a class="cta-outline" href="#">…</a></div>
- <figure class="hero__media" data-slot="hero">
- <video autoplay muted loop playsinline preload="metadata" poster="/hero-poster.webp" fetchpriority="high">
- <source src="/hero.av1.mp4" type='video/mp4; codecs="av01.0.05M.08"'>
- <source src="/hero.h264.mp4" type="video/mp4">
- </video>
- </figure>
-</section>
-```
-```css
-.hero--clipped { min-height: 80dvh; display: grid; grid-template-columns: minmax(0, 1fr) minmax(0, 1.4fr); gap: var(--gap-columns); align-items: center; overflow: visible; }
-.hero__media { margin: 0 calc(-1 * min(12vw, 12rem)) 0 0; aspect-ratio: 16 / 10; border-radius: min(1vw, 12px); overflow: hidden; }
-@media (max-width: 60rem) { .hero--clipped { grid-template-columns: minmax(0, 1fr); } .hero__media { margin: 0; } }
-```
-
-The section keeps `overflow: visible`; the page clips at `html` and `body` (34).
-
-## Knobs
-
-- Clip side: right · left
-- Ratio: 16/10 · 16/9
-- Frame: none · hairline inset
-
-## Mobile
-
-- Below 60rem: the clip drops; one column, full width media. Below 40rem: 16/9, the poster shows and autoplay is off.
diff --git a/skills/hallmark/references/components/h8-mockup-split-browser-framed.md b/skills/hallmark/references/components/h8-mockup-split-browser-framed.md
deleted file mode 100644
index 1597fbc..0000000
--- a/skills/hallmark/references/components/h8-mockup-split-browser-framed.md
+++ /dev/null
@@ -1,33 +0,0 @@
-### H8 · Screenshot as a plate
-Headline left, one real capture right, set like a plate in a catalogue: a `<figure>` with a `<figcaption>` carrying a fact (what is shown, which build, when), or the theme's `data-slot` placeholder until the user's capture arrives. No chrome, no tilt, no stack (47a, 47b).
-*Use when:* the product is a web app and the user has a clean capture.
-*Not:* H7 (video, clipped); a drawn mockup with invented figures (47c). One frame at most: a hairline inset outline, never a browser bar or an OS window.
-
-```html
-<section class="hero-plate">
- <div class="hero-plate__copy"><h1>…</h1><p>…</p><a class="cta-outline" href="#">…</a></div>
- <figure class="hero-plate__figure">
- <div class="hero-plate__capture" data-slot="hero"><!-- the user's capture, or the theme's placeholder (`craft.md` § 8) --></div>
- <figcaption>…</figcaption>
- </figure>
-</section>
-```
-```css
-.hero-plate { min-height: 80dvh; display: grid; grid-template-columns: minmax(0, 1fr) minmax(0, 1.2fr); gap: var(--gap-columns); align-items: center; padding-block: var(--space-2xl) var(--space-3xl); }
-.hero-plate__figure { margin: 0; display: grid; gap: var(--space-sm); }
-.hero-plate__capture { aspect-ratio: 16 / 10; border-radius: min(1vw, 12px); outline: 1px solid color-mix(in oklab, var(--color-ink) 8%, transparent); outline-offset: -1px; box-shadow: var(--shadow-card); }
-.hero-plate__figure figcaption { font-size: var(--text-sm); color: var(--color-muted); }
-@media (max-width: 60rem) { .hero-plate { grid-template-columns: minmax(0, 1fr); } }
-```
-
-The caption sits outside the slot so the slot script does not hide it when the image lands.
-
-## Knobs
-
-- Frame: none · hairline inset
-- Caption: beneath · in the margin beside
-- Capture: 16/10 · 4/3 · one phone-tall 9/16 with real content
-
-## Mobile
-
-- Below 60rem: one column, the plate beneath the text, full width.
diff --git a/skills/hallmark/references/components/h9-custom-illustration-centerpiece.md b/skills/hallmark/references/components/h9-custom-illustration-centerpiece.md
deleted file mode 100644
index 1fc14df..0000000
--- a/skills/hallmark/references/components/h9-custom-illustration-centerpiece.md
+++ /dev/null
@@ -1,28 +0,0 @@
-### H9 · Custom illustration centrepiece
-One built illustration beside the text: a hand-built SVG or a CSS shape that is the brand's thing (a loaf, a mark, a diagram). The build tiers, recipes and animation rules are [`enrichment/e5-custom-illustration-centerpiece.md`](../enrichment/e5-custom-illustration-centerpiece.md); this is the page-level sketch.
-*Use when:* the brand has a thing worth drawing: a craft, a character, a process.
-*Not:* H6 (photography); H8 (a capture). Never a library illustration (F10, 47c). The SVG carries an `aria-label` or `aria-hidden="true"` (33); its fills are tokens (48).
-
-```html
-<section class="hero-art">
- <div class="hero-art__copy"><h1>…</h1><p>…</p><a class="cta-outline" href="#">…</a></div>
- <svg class="hero-art__figure" viewBox="0 0 200 100" role="img" aria-label="…">…</svg>
-</section>
-```
-```css
-.hero-art { min-height: 80dvh; display: grid; grid-template-columns: minmax(0, 1fr) minmax(0, 1fr); gap: var(--gap-columns); align-items: center; }
-.hero-art__figure { width: 100%; max-width: 36rem; justify-self: center; }
-.hero-art__figure .fill { fill: var(--color-accent); }
-.hero-art__figure .line { stroke: var(--color-ink); stroke-width: 2; fill: none; stroke-linecap: round; }
-@media (max-width: 60rem) { .hero-art { grid-template-columns: minmax(0, 1fr); } }
-```
-
-## Knobs
-
-- Build: pure CSS · hand-built SVG · generated still (when a character demands it)
-- Motion: none · one loop that pauses on hover and focus · scroll linked (one per page)
-- Scale: accent · dominant
-
-## Mobile
-
-- Below 60rem: one column; the figure sits beneath the text at 40% of the viewport width or less.
diff --git a/skills/hallmark/references/components/n1b-saas-three-section.md b/skills/hallmark/references/components/n1-three-section-bar.md
similarity index 86%
rename from skills/hallmark/references/components/n1b-saas-three-section.md
rename to skills/hallmark/references/components/n1-three-section-bar.md
index b6ab5d2..8974873 100644
--- a/skills/hallmark/references/components/n1b-saas-three-section.md
+++ b/skills/hallmark/references/components/n1-three-section-bar.md
@@ -1,7 +1,7 @@
-### N1b · Three-section product bar
-Wordmark hard left, a centred cluster of three to five links (one or two opening small dropdowns), a sign-in link and one filled action hard right. Dense and balanced; the structural opposite of N1.
+### N1 · Three-section bar
+Wordmark hard left, a centred cluster of three to five links (one or two opening small dropdowns), a sign-in link and one filled action hard right. Dense and balanced; the structural opposite of N9.
*Use when:* a product page has several real destinations and one clear primary action.
-*Not:* N1 (two links, no centre); N5 (a detached pill); N11 (full width panels). This is the reflex bar (42): the stamp names it and one knob moves. The cluster never collides with the brand or the action; if it cannot sit centred with room, drop to three links or use N1. A dropdown opens on hover and on focus, and closes on Escape.
+*Not:* N9 (one or two destinations at the far edge); N5 (a detached pill); N11 (full width panels). This is the reflex bar (42): reach for it only when the product has four or more real top-level destinations, name it in the stamp and move one knob. The cluster never collides with the brand or the action; if it cannot sit centred with room, drop to three links or use N9. A dropdown opens on hover and on focus, and closes on Escape.
```html
<header class="nav"><div class="nav__inner">
diff --git a/skills/hallmark/references/components/n1-wordmark-2-links.md b/skills/hallmark/references/components/n1-wordmark-2-links.md
deleted file mode 100644
index 497e9b1..0000000
--- a/skills/hallmark/references/components/n1-wordmark-2-links.md
+++ /dev/null
@@ -1,21 +0,0 @@
-### N1 · Wordmark and two links
-A top bar: wordmark left, two text links right ("Pricing", "Sign in"). No logo image, no menu icon.
-*Use when:* the page has two destinations, no more.
-*Not:* N1b (a centre cluster and a button, the reflex bar, 42); N9 (one action and nothing else).
-
-```html
-<nav class="nav-min" aria-label="Primary">
- <a class="wordmark" href="/" aria-label="Studio, home">Studio</a>
- <ul><li><a href="/pricing">Pricing</a></li><li><a href="/sign-in">Sign in</a></li></ul>
-</nav>
-```
-```css
-.nav-min { display: flex; justify-content: space-between; align-items: center; padding: var(--space-md) var(--gutter); }
-.nav-min ul { display: flex; gap: var(--space-lg); list-style: none; margin: 0; padding: 0; }
-.nav-min a { font-size: var(--text-sm); text-decoration: none; }
-```
-
-## Knobs
-
-- Placement: split · both right
-- Sticky: yes · no
diff --git a/skills/hallmark/references/components/n10-floating-on-scroll-morph.md b/skills/hallmark/references/components/n10-floating-on-scroll-morph.md
deleted file mode 100644
index e31b48a..0000000
--- a/skills/hallmark/references/components/n10-floating-on-scroll-morph.md
+++ /dev/null
@@ -1,93 +0,0 @@
-### N10 · Floating-on-scroll morph
-A sticky bar at the top that morphs into a floating pill once the user scrolls past a threshold. Two visual modes share one DOM: `.nav` (outer) owns the bar look, `.nav__inner` (inner) owns the pill look. Cross-faded on one class toggle (`.is-floating`) with one timing curve.
-*Use when:* atmospheric or modern-minimal pages where one kinetic moment earns its place. One surprise; it resists novelty.
-*Not:* N5 (always a pill, no scroll behaviour). N10 is N5 plus a default bar state that morphs into it.
-
-```html
-<header class="nav">
- <div class="nav__inner">
- <a class="wordmark" href="/" aria-label="Studio, home">Studio</a>
- <ul class="nav__links">…</ul>
- <a class="cta" href="/install">Install</a>
- </div>
-</header>
-```
-
-#### The four laws
-
-**1. Total nav height stays constant.** If the outer's height changes when the state flips, every pixel below shifts and the page reads as jumping mid-scroll. Compensate the inner's shrink with the outer's `padding-block` so the sum is the same in both states (the 10b guard).
-
-**2. The visible offset is `transform: translateY()`, never `padding` or `margin`.** The pill sits detached from the viewport top; adding padding to the outer breaks law 1. `transform` leaves layout alone: the pill drops visually and the box stays put.
-
-**3. Cross-fade ownership of every shared visual.** For every property the outer carries at rest (background, border, backdrop-filter, box-shadow), neutralise it in `.is-floating` and put it in the transition list. Forget one, say a stale `backdrop-filter: blur(14px)` on the outer in floating mode, and an invisible blurred strip drags across the viewport behind nothing.
-
-**4. One timing curve across every property.** Eight properties on eight curves read as eight animations. The same eight on `var(--dur-long)` and `var(--ease-out)` read as one motion.
-
-#### The property morph, one curve
-
-| Element | Property | Default | Floating |
-|---|---|---|---|
-| `.nav` | `padding-block` | `0` | `var(--space-2xs)` |
-| `.nav` | `background-color` | `color-mix(in oklab, var(--color-paper) 62%, transparent)` | `transparent` |
-| `.nav` | `border-block-end-color` | `var(--color-rule)` | `transparent` |
-| `.nav` | `backdrop-filter` | `saturate(1.4) blur(14px)` | `blur(0)` |
-| `.nav__inner` | `max-width` | `var(--container)` | `58rem` |
-| `.nav__inner` | `min-height` | `60px` | `52px` |
-| `.nav__inner` | `padding-block` | `var(--space-sm)` | `var(--space-2xs)` |
-| `.nav__inner` | `border-radius` | `0` | `var(--radius-pill)` |
-| `.nav__inner` | `background-color` | `transparent` | `color-mix(in oklab, var(--color-paper) 82%, transparent)` |
-| `.nav__inner` | `backdrop-filter` | `blur(0)` | `blur(18px)` |
-| `.nav__inner` | `box-shadow` | `none` | `var(--shadow-card), inset 0 0 0 1px var(--color-rule)` |
-| `.nav__inner` | `transform` | `translateY(0)` | `translateY(var(--space-sm))` |
-
-The outer is `position: sticky; top: 0; z-index: var(--z-sticky-nav)`. Use `blur(0)`, not `none`: `none` snaps, `blur(0)` transitions. `backdrop-filter` transitions are baseline in every current browser.
-
-#### The scroll handler
-
-```js
-(() => {
- const nav = document.querySelector(".nav");
- if (!nav) return;
- const THRESHOLD = 80; // 60px or more, so micro-scrolls do not twitch it
- let floating = false;
- let ticking = false;
- const update = () => {
- const next = window.scrollY > THRESHOLD;
- if (next !== floating) { // flip guard: toggle once per state change
- floating = next;
- nav.classList.toggle("is-floating", floating);
- }
- };
- window.addEventListener("scroll", () => {
- if (ticking) return;
- ticking = true;
- requestAnimationFrame(() => { update(); ticking = false; });
- }, { passive: true });
- update();
-})();
-```
-
-Three discipline points: `passive: true` (the listener never calls `preventDefault`, so the main thread stays free for scrolling); a `requestAnimationFrame` throttle (at most one update per paint); the flip guard (the class changes once per state change, not once per scroll event).
-
-#### What breaks it
-
-1. Two `<header>` elements swapped by opacity: double DOM, broken focus order, content that desyncs.
-2. Animating `top` or `margin-top` for the floating offset: layout on every frame. `transform` is the only lever.
-3. `backdrop-filter: none` in the floating state: it snaps. `blur(0)` transitions.
-4. Letting the nav height change between states: content jitter, the most damaging mistake in this pattern.
-5. Different durations per property ("speed up the radius", "delay the shadow"): reads as broken even though everything moves. One curve.
-6. A `scroll` listener without `{ passive: true }` or without the rAF throttle: both kill mobile scroll performance.
-7. A threshold of 0: the morph fires on the slightest scroll. Use 60px or more.
-8. No flip guard: toggling the class on every scroll event thrashes layout.
-
-One orchestrated morph and nothing else: the polish is the single curve and the height-constant arithmetic.
-
-## Knobs
-
-- Threshold: 80 to 120px · one viewport
-- Pill width: content sized · capped at 560px
-- Cross-fade: `--dur-short` · `--dur-long`
-
-## Mobile
-
-- Below 60rem: the morph is off; the nav renders as the floating pill only. Below 40rem: a corner chip, wordmark left, menu right (as N5).
diff --git a/skills/hallmark/references/components/n11-mega-menu.md b/skills/hallmark/references/components/n11-mega-menu.md
index 7fe3439..3e1beb0 100644
--- a/skills/hallmark/references/components/n11-mega-menu.md
+++ b/skills/hallmark/references/components/n11-mega-menu.md
@@ -1,7 +1,7 @@
### N11 · Mega menu panel
A standard bar whose triggers open a full width, multi-column panel: an icon, a title and a one-line description per item, grouped under column heads, with an optional feature cell at one side. The page dims behind a scrim.
*Use when:* the brand has many destinations that need grouping and explanation (six or more products, a docs hub). The panel is the design problem, not the bar.
-*Not:* N1b (small single-column dropdowns). At most four columns, never taller than 60vh, never opened on hover without a close grace (the panel flickers as the pointer crosses the gap). Every item carries its description; a bare link grid is N1b in disguise. Column heads are the body face, sentence case (67).
+*Not:* N1 (small single-column dropdowns). At most four columns, never taller than 60vh, never opened on hover without a close grace (the panel flickers as the pointer crosses the gap). Every item carries its description; a bare link grid is N1 in disguise. Column heads are the body face, sentence case (67).
```html
<header class="nav">
diff --git a/skills/hallmark/references/components/n13-inline-cmdk-pill.md b/skills/hallmark/references/components/n13-inline-cmdk-pill.md
index cddc151..1151fc8 100644
--- a/skills/hallmark/references/components/n13-inline-cmdk-pill.md
+++ b/skills/hallmark/references/components/n13-inline-cmdk-pill.md
@@ -1,7 +1,7 @@
-### N13 · Inline ⌘K search pill
-A visible search control sits in the bar beside the links: placeholder text and a `⌘K` hint. Click it, or press ⌘K or Ctrl K, and a spotlight dialog opens with grouped, keyboard-navigable results. The opposite of N4: the affordance is on the surface for newcomers, the shortcut for the rest.
+### N13 · Command palette
+A spotlight dialog with grouped, keyboard-navigable results, opened by ⌘K or Ctrl K. The trigger is a visible search pill in the bar (placeholder text and a `⌘K` hint) for newcomers, or, for a keyboard-first audience, one small control showing the shortcut and no other nav at all.
*Use when:* search is a primary action (developer docs, a library, a large catalogue).
-*Not:* N4 (no visible nav); a search icon that focuses an input in place. The dialog is a `<dialog>` that traps focus and closes on Escape: ship the pill, ship the keyboard model. The pill reads as search (an icon and a placeholder), not as a generic button.
+*Not:* a search icon that focuses an input in place. The dialog is a `<dialog>` that traps focus and closes on Escape: ship the pill, ship the keyboard model. The pill reads as search (an icon and a placeholder), not as a generic button.
```html
<header class="nav" id="nav"><div class="nav__inner">
@@ -42,7 +42,7 @@ JS: ⌘K or Ctrl K toggles, Escape closes (native), a backdrop click closes, the
- Pill placement: centred · beside the brand
- Results: flat · grouped
- Footer hints: shown · hidden
-- Open trigger: pill and ⌘K (⌘K alone is N4)
+- Trigger: a search pill in the bar and ⌘K · one small `Menu ⌘K` control fixed top right, no other nav (the palette lists every destination)
## Mobile
diff --git a/skills/hallmark/references/components/n3-side-rail.md b/skills/hallmark/references/components/n3-side-rail.md
index 3730d19..6a39ca2 100644
--- a/skills/hallmark/references/components/n3-side-rail.md
+++ b/skills/hallmark/references/components/n3-side-rail.md
@@ -1,7 +1,7 @@
### N3 · Side rail
A thin vertical strip on one edge: the wordmark set vertically, then the page's sections as text links in the same writing mode, the current one in ink. Every link is a real section name; never an empty dot (33, 63).
-*Use when:* a long, sectioned page where a sticky object (a ticket, a contents list) earns the rail. Never the default nav; a top bar is (N1, N9).
-*Not:* N1 (horizontal). The wordmark is the only rotated text; rotated words with nothing to say are decoration (66).
+*Use when:* a long, sectioned page where a sticky object (a ticket, a contents list) earns the rail. Never the default nav; a top bar is (N9, N1).
+*Not:* N9 (horizontal). The wordmark is the only rotated text; rotated words with nothing to say are decoration (66).
```html
<nav class="nav-rail" aria-label="Sections">
diff --git a/skills/hallmark/references/components/n4-hidden-behind-k.md b/skills/hallmark/references/components/n4-hidden-behind-k.md
deleted file mode 100644
index b3fa8ee..0000000
--- a/skills/hallmark/references/components/n4-hidden-behind-k.md
+++ /dev/null
@@ -1,24 +0,0 @@
-### N4 · Hidden behind ⌘K
-No visible nav. One small control shows the shortcut; the palette opens with it.
-*Use when:* the audience is technical and expects the affordance.
-*Not:* N13 (the search is visible in the bar); N2 (always visible). The palette is a `<dialog>` that traps focus and closes on Escape, never a `<div>`.
-
-```html
-<button class="kbd-hint" type="button" aria-haspopup="dialog" aria-controls="palette">Menu <kbd>⌘</kbd><kbd>K</kbd></button>
-<dialog class="palette" id="palette" aria-label="Go to">…</dialog>
-```
-```css
-.kbd-hint { position: fixed; top: var(--space-md); right: var(--gutter); z-index: var(--z-sticky-nav); min-height: 44px; display: inline-flex; align-items: center; gap: var(--space-xs); padding: 0 var(--space-sm); background: var(--color-paper); border: var(--rule-hair) solid var(--color-rule); border-radius: var(--radius-input); color: var(--color-ink); cursor: pointer; }
-.kbd-hint kbd { font-family: var(--font-outlier); font-size: var(--text-xs); padding: 0 var(--space-2xs); border: var(--rule-hair) solid var(--color-rule-2); border-radius: var(--radius-input); }
-.kbd-hint:focus-visible { outline: 2px solid var(--color-focus); outline-offset: 2px; }
-```
-
-## Knobs
-
-- Trigger: button and keyboard · keyboard first (the button stays for pointer users)
-- Surface: centred modal · top sheet
-- Recents: shown · hidden
-
-## Mobile
-
-- Below 60rem: the control reads "Menu" and opens the same dialog by tap.
diff --git a/skills/hallmark/references/components/n5-floating-pill.md b/skills/hallmark/references/components/n5-floating-pill.md
index 92154f6..f3b83c1 100644
--- a/skills/hallmark/references/components/n5-floating-pill.md
+++ b/skills/hallmark/references/components/n5-floating-pill.md
@@ -1,13 +1,13 @@
### N5 · Floating pill
-A rounded, content-sized nav, visibly detached from the edges, `--space-md` from the top, a blurred backdrop and a hairline ring.
-*Use when:* modern-minimal or atmospheric pages where the hero has a surface or imagery for the blur to sit over.
-*Not:* N1 (full width); N2 (a corner chip). A pill 95% of the viewport wide is a full width bar with round ends; if the links push it past 720px, drop a link or use N1.
+A rounded, content-sized nav, visibly detached from the edges, `--space-md` from the top, a blurred backdrop and a hairline ring. It is a pill from the first paint, or it starts as a full bar and morphs into the pill once the reader scrolls.
+*Use when:* modern-minimal or atmospheric pages where the hero has a surface or imagery for the blur to sit over; the morph only when one kinetic moment earns its place on the page.
+*Not:* N9 (edge-aligned, in flow); N2 (a corner chip). A pill 95% of the viewport wide is a full width bar with round ends; if the links push it past 720px, drop a link or use N9.
```html
<nav class="nav-pill" aria-label="Primary">
<a class="wordmark" href="/" aria-label="Studio, home">Studio</a>
<ul class="nav-pill__links"><li><a href="/catalog">Catalog</a></li><li><a href="/voice">Voice</a></li></ul>
- <a class="cta-fill" href="/start">Start</a>
+ <a class="btn btn--primary" href="/start">Start</a>
</nav>
```
```css
@@ -19,12 +19,96 @@ A rounded, content-sized nav, visibly detached from the edges, `--space-md` from
.nav-pill a { font-size: var(--text-sm); text-decoration: none; }
```
+#### On scroll: the morph from a bar
+
+One DOM, two visual modes: `.nav` (outer, `position: sticky; top: 0`) owns the bar look, `.nav__inner` owns the pill look, cross-faded on one class toggle (`.is-floating`) with one timing curve.
+
+```html
+<header class="nav">
+ <div class="nav__inner">
+ <a class="wordmark" href="/" aria-label="Studio, home">Studio</a>
+ <ul class="nav__links">…</ul>
+ <a class="btn btn--primary" href="/install">Install</a>
+ </div>
+</header>
+```
+
+##### The four laws
+
+**1. Total nav height stays constant.** If the outer's height changes when the state flips, every pixel below shifts and the page reads as jumping mid-scroll. Compensate the inner's shrink with the outer's `padding-block` so the sum is the same in both states (the 10b guard).
+
+**2. The visible offset is `transform: translateY()`, never `padding` or `margin`.** The pill sits detached from the viewport top; adding padding to the outer breaks law 1. `transform` leaves layout alone: the pill drops visually and the box stays put.
+
+**3. Cross-fade ownership of every shared visual.** For every property the outer carries at rest (background, border, backdrop-filter, box-shadow), neutralise it in `.is-floating` and put it in the transition list. Forget one, say a stale `backdrop-filter: blur(14px)` on the outer in floating mode, and an invisible blurred strip drags across the viewport behind nothing.
+
+**4. One timing curve across every property.** Eight properties on eight curves read as eight animations. The same eight on `var(--dur-long)` and `var(--ease-out)` read as one motion.
+
+##### The property morph, one curve
+
+| Element | Property | Default | Floating |
+|---|---|---|---|
+| `.nav` | `padding-block` | `0` | `var(--space-2xs)` |
+| `.nav` | `background-color` | `color-mix(in oklab, var(--color-paper) 62%, transparent)` | `transparent` |
+| `.nav` | `border-block-end-color` | `var(--color-rule)` | `transparent` |
+| `.nav` | `backdrop-filter` | `saturate(1.4) blur(14px)` | `blur(0)` |
+| `.nav__inner` | `max-width` | `var(--container)` | `58rem` |
+| `.nav__inner` | `min-height` | `60px` | `52px` |
+| `.nav__inner` | `padding-block` | `var(--space-sm)` | `var(--space-2xs)` |
+| `.nav__inner` | `border-radius` | `0` | `var(--radius-pill)` |
+| `.nav__inner` | `background-color` | `transparent` | `color-mix(in oklab, var(--color-paper) 82%, transparent)` |
+| `.nav__inner` | `backdrop-filter` | `blur(0)` | `blur(18px)` |
+| `.nav__inner` | `box-shadow` | `none` | `var(--shadow-card), inset 0 0 0 1px var(--color-rule)` |
+| `.nav__inner` | `transform` | `translateY(0)` | `translateY(var(--space-sm))` |
+
+The outer is `position: sticky; top: 0; z-index: var(--z-sticky-nav)`. Use `blur(0)`, not `none`: `none` snaps, `blur(0)` transitions. `backdrop-filter` transitions are baseline in every current browser.
+
+##### The scroll handler
+
+```js
+(() => {
+ const nav = document.querySelector(".nav");
+ if (!nav) return;
+ const THRESHOLD = 80;
+ let floating = false;
+ let ticking = false;
+ const update = () => {
+ const next = window.scrollY > THRESHOLD;
+ if (next !== floating) {
+ floating = next;
+ nav.classList.toggle("is-floating", floating);
+ }
+ };
+ window.addEventListener("scroll", () => {
+ if (ticking) return;
+ ticking = true;
+ requestAnimationFrame(() => { update(); ticking = false; });
+ }, { passive: true });
+ update();
+})();
+```
+
+Three discipline points: `passive: true` (the listener never calls `preventDefault`, so the main thread stays free for scrolling); a `requestAnimationFrame` throttle (at most one update per paint); the flip guard (the class changes once per state change, not once per scroll event).
+
+##### What breaks it
+
+1. Two `<header>` elements swapped by opacity: double DOM, broken focus order, content that desyncs.
+2. Animating `top` or `margin-top` for the floating offset: layout on every frame. `transform` is the only lever.
+3. `backdrop-filter: none` in the floating state: it snaps. `blur(0)` transitions.
+4. Letting the nav height change between states: content jitter, the most damaging mistake in this pattern.
+5. Different durations per property ("speed up the radius", "delay the shadow"): reads as broken even though everything moves. One curve.
+6. A `scroll` listener without `{ passive: true }` or without the rAF throttle: both kill mobile scroll performance.
+7. A threshold of 0: the morph fires on the slightest scroll. Use 60px or more.
+8. No flip guard: toggling the class on every scroll event thrashes layout.
+
+One orchestrated morph and nothing else: the polish is the single curve and the height-constant arithmetic.
+
## Knobs
+- Scroll: always a pill · morphs from a full bar past 80 to 120px
- Width: content sized · capped at 720px · capped at 560px
- Backdrop: blur and saturate · solid paper
- Anchor: top centre · top right
## Mobile
-- Below 60rem: the links drop; wordmark and action stay in the pill. Below 40rem: a corner chip, wordmark left, menu right.
+- Below 60rem: the morph is off and the links drop; wordmark and action stay in the pill. Below 40rem: a corner chip, wordmark left, menu right.
diff --git a/skills/hallmark/references/components/n6-newspaper-masthead.md b/skills/hallmark/references/components/n6-newspaper-masthead.md
index 510e925..337b75c 100644
--- a/skills/hallmark/references/components/n6-newspaper-masthead.md
+++ b/skills/hallmark/references/components/n6-newspaper-masthead.md
@@ -1,7 +1,7 @@
### N6 · Newspaper masthead
A full width header: a large centred wordmark, an issue and date line in the body face above or below it, an optional link row beneath, a double rule under all of it.
*Use when:* the page is editorial, a magazine, framed as an issue or an edition.
-*Not:* N1 (small, asymmetric). On a SaaS or developer product it reads as costume. The issue line is a fact in a `<time>`, never an eyebrow (54); the wordmark's capitals are the wordmark's and nothing else in the masthead is uppercase (67).
+*Not:* N9 (small, asymmetric). On a SaaS or developer product it reads as costume. The issue line is a fact in a `<time>`, never an eyebrow (54); the wordmark's capitals are the wordmark's and nothing else in the masthead is uppercase (67).
```html
<header class="nav-mast">
diff --git a/skills/hallmark/references/components/n7-brutal-slab.md b/skills/hallmark/references/components/n7-brutal-slab.md
index 0fb6dce..f1bde6b 100644
--- a/skills/hallmark/references/components/n7-brutal-slab.md
+++ b/skills/hallmark/references/components/n7-brutal-slab.md
@@ -1,7 +1,7 @@
### N7 · Brutal slab
A heavy full width bar: a 2px ink rule beneath, the wordmark in the display face, a heavy sentence-case link row, no shadow, no radius.
*Use when:* the genre is playful (Brutal, Manifesto, Sport) or the voice is heavy and declarative.
-*Not:* N1 (small, quiet). Radius, soft shadow or blur fight this vocabulary: reach for blur and it is N5. The wordmark may be capitals, tracked 0.04em at most (67 allows the wordmark); the links are sentence case.
+*Not:* N9 (small, quiet). Radius, soft shadow or blur fight this vocabulary: reach for blur and it is N5. The wordmark may be capitals, tracked 0.04em at most (67 allows the wordmark); the links are sentence case.
```html
<header class="nav-slab">
diff --git a/skills/hallmark/references/components/n8-terminal-command.md b/skills/hallmark/references/components/n8-terminal-command.md
index 722f054..5dce51e 100644
--- a/skills/hallmark/references/components/n8-terminal-command.md
+++ b/skills/hallmark/references/components/n8-terminal-command.md
@@ -1,7 +1,7 @@
### N8 · Terminal command
The nav is a command line: `> studio --catalog --voice --get`, the links are flags. A blinking cursor ends the line. It is legal because the line is a typed command and the cursor says "type next"; it is the page's only cursor, and nothing else on the page blinks (66).
*Use when:* the page is a CLI tool, developer docs, or a theme whose material is mono.
-*Not:* N4 (a palette, not a bar). On a non-developer site the `>` prompt is set decoration.
+*Not:* N13 (a palette, not a bar). On a non-developer site the `>` prompt is set decoration.
```html
<header class="nav-term">
diff --git a/skills/hallmark/references/components/n9-edge-aligned-minimal.md b/skills/hallmark/references/components/n9-edge-aligned-minimal.md
index 907f48e..5b7e484 100644
--- a/skills/hallmark/references/components/n9-edge-aligned-minimal.md
+++ b/skills/hallmark/references/components/n9-edge-aligned-minimal.md
@@ -1,25 +1,28 @@
-### N9 · Edge-aligned minimal
-Wordmark hard left, one action hard right, nothing between. The absence is the design.
-*Use when:* luxury, quiet, atelier pages where the brand earns silence; the default bar when a page has one destination.
-*Not:* N1 (fills the middle). Four links "to fill the space" makes N1 with extra steps. The action is a verb ("Book a fitting"), never "Get" with an arrow (63).
+### N9 · Edge-aligned
+Wordmark at one edge, one action or two text links at the other, nothing between. The absence is the design.
+*Use when:* the page has one or two destinations; quiet, atelier, editorial and product pages that earn silence. The first nav to reach for on a page that does not need more.
+*Not:* N1 (a centre cluster and a filled button, the reflex bar, 42). Four links "to fill the space" is N1 with extra steps. The action is a verb ("Book a fitting"), never "Get" with an arrow (63).
```html
<header class="nav-edge">
<a class="wordmark" href="/" aria-label="Studio, home">Studio</a>
- <a class="cta-outline" href="/book">Book a fitting</a>
+ <nav aria-label="Primary"><a class="btn btn--secondary" href="/book">Book a fitting</a></nav>
</header>
```
```css
-.nav-edge { display: flex; justify-content: space-between; align-items: center; padding: var(--space-md) var(--gutter); }
+.nav-edge { display: flex; justify-content: space-between; align-items: center; gap: var(--space-lg); padding: var(--space-md) var(--gutter); }
+.nav-edge nav { display: flex; align-items: center; gap: var(--space-lg); }
.nav-edge .wordmark { font-family: var(--font-display); font-size: var(--text-md); text-decoration: none; }
+.nav-edge nav a:not(.btn) { font-size: var(--text-sm); text-decoration: none; }
```
## Knobs
-- Action: outlined · filled pill · typographic link
+- Far side: one action · two text links · one link and one action
+- Action: outlined · filled · typographic link
- Wordmark: display face · body face · the outlier
-- Padding block: `--space-sm` · `--space-md` · `--space-lg`
+- Sticky: no · yes, with a paper background once scrolled
## Mobile
-- Below 40rem: the action keeps a 44px hit target.
+- Below 40rem: the links fold into the action or a menu control; the action keeps a 44px hit target.
diff --git a/skills/hallmark/references/components/s2-hanging.md b/skills/hallmark/references/components/s2-hanging.md
deleted file mode 100644
index c9a9e24..0000000
--- a/skills/hallmark/references/components/s2-hanging.md
+++ /dev/null
@@ -1,3 +0,0 @@
-### S2 · Hanging
-Air above, heading flush, no rule and no label: `craft.md` § 7 item 1. `padding-block: var(--space-3xl) var(--space-xl)` on the section head, or 4xl over 2xl on an airier page; the padding steps down one token below 60rem.
-*Don't confuse with:* S3 Sticky pinned (which moves with scroll).
diff --git a/skills/hallmark/references/components/s4-inline-no-break.md b/skills/hallmark/references/components/s4-inline-no-break.md
deleted file mode 100644
index 36839ce..0000000
--- a/skills/hallmark/references/components/s4-inline-no-break.md
+++ /dev/null
@@ -1,3 +0,0 @@
-### S4 · Inline (no break)
-The heading is a heavier phrase inside the paragraph's first line, never on its own line: `craft.md` § 7 item 3. A `<span class="head-inline">` at weight 600 or 700 in the body face and ink; the paragraph keeps its measure and nothing collapses on mobile.
-*Don't confuse with:* S2 Hanging (which separates with air).
diff --git a/skills/hallmark/references/enrichment/e8-hero-photography.md b/skills/hallmark/references/enrichment/e8-hero-photography.md
index f0b0146..845292b 100644
--- a/skills/hallmark/references/enrichment/e8-hero-photography.md
+++ b/skills/hallmark/references/enrichment/e8-hero-photography.md
@@ -1,5 +1,11 @@
-### E8 · Hero photography, one tightly cropped image
+### E8 · Hero photography
-The cookbook's H6 archetype, cross-referenced here. Knobs are in [`component-cookbook.md`](../component-cookbook.md).
+One photograph beside the headline (the photograph visual of [`components/h2-split-diptych.md`](../components/h2-split-diptych.md)); the full-bleed version is [`components/h6-photographic-fold.md`](../components/h6-photographic-fold.md).
-**Example.** A small Lisbon café. One tightly cropped photograph of the espresso machine at dawn, 4/3, not full-bleed. The caption sits margin-aligned at lower left in the body face, a step smaller, sentence case ("The espresso machine at 6:42 a.m., plate four."). The photograph is desaturated 8% from the source to sit with the page's warm paper. Pair photography with a tone-matched type pairing ([`craft.md` § 1](../craft.md)); a luxury-tone photo on a brutalist page jars.
+- **Source.** The user's own photograph. Without one, a `data-slot` sized for it with the theme's placeholder; never a stock person, never a face as social proof (F9). Sources and licences when the brief allows stock scenery: [`assets.md`](../assets.md) § Photography.
+- **Crop.** Tighter than feels safe: the object, not the room. 4/3 or 1/1 beside text; the subject's weight sits toward the headline.
+- **Tone.** Pull it toward the paper: desaturate 5 to 10% and warm or cool it to the paper's hue so the page and the picture share light. Never a gradient wash over it (29).
+- **Caption.** A `<figcaption>` beneath or in the margin, in the body face a step smaller, sentence case, stating a fact ("The espresso machine at 6:42, Rua da Rosa"). No credit line under a placeholder (66).
+- **Weight.** `fetchpriority="high"` and explicit `width` and `height` on the LCP image; never `loading="lazy"` on it (28a).
+
+**Example.** A small Lisbon café. One photograph of the espresso machine at dawn, 4/3, cropped to the group head and the steam; desaturated 8% toward the warm paper; the caption beneath names the machine, the time and the street.
diff --git a/skills/hallmark/references/macrostructures/02-long-document.md b/skills/hallmark/references/macrostructures/02-long-document.md
index dadf7b6..a3c9aed 100644
--- a/skills/hallmark/references/macrostructures/02-long-document.md
+++ b/skills/hallmark/references/macrostructures/02-long-document.md
@@ -13,7 +13,7 @@ Reach for it for case studies, founder posts, mission pages, products whose sale
Avoid when there is one decisive action to take. Long Document hides its actions inside sentences, which is wrong for a transactional page.
-Heading code: [`../components/s4-inline-no-break.md`](../components/s4-inline-no-break.md).
+Heading: the inline lead-in of [`../craft.md`](../craft.md) § 7, item 3.
```html
<article class="prose">