Skip to content

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

CSS

v0.9.0 polish — drop image gen + sprinkle, normalize section spacing across themes

Youssef78167667a23f
diff --git a/README.md b/README.md
index d747436..02ed6da 100644
--- a/README.md
+++ b/README.md
@@ -3,7 +3,7 @@
**A design skill that studies what you admire — and rebuilds your content with it.**
→ Live demo: **[hallmark-murex.vercel.app](https://hallmark-murex.vercel.app)** · twenty-three themes, eight worked tests, press `T` to cycle.
-→ Current version: **v0.9.0** — adds the **Editorial** theme (open-design-inspired premium · warm cream + coral + Inter Tight × Playfair italic), a **watercolor + ink-wash sprinkle** across the marketing site (18 seeded plates from `google/gemini-3-pro-image` via Together AI), **generated-imagery.md** in the skill (Tier C promoted to peer of Tier B with seed-and-reference discipline + per-theme style-prompt table for all 23 themes), a power-user [`generate.mjs`](skill/_assets/scripts/generate.mjs) drop-in script, and selected open-design utilities (Roman-numeral section heads, corner-bracket image annotations, dark-slab section reversal, pulse animation, `.tnum` utility).
+→ Current version: **v0.9.0** — adds the **Editorial** theme (open-design-inspired premium · warm cream + coral + Inter Tight × Playfair italic) and a small kit of open-design utilities any theme can reach for: Roman-numeral section heads, corner-bracket image annotations, dark-slab section reversal, pulse animation for live indicators, and a `.tnum` tabular-numerals utility.
→ Previously in **v0.8**: genres (editorial · modern-minimal · atmospheric · playful), `design.md` for whole-project redesigns, the 2+1 font rule with 55-gate slop test, component-library exports, 9 nav archetypes (incl Floating pill), 8 footer archetypes, 4 hero polish patterns, contrast gates 46–50, nav/footer/hero structural gates 51–55.
<table>
diff --git a/scripts/generate-marketing.mjs b/scripts/generate-marketing.mjs
deleted file mode 100644
index 99be8f7..0000000
--- a/scripts/generate-marketing.mjs
+++ /dev/null
@@ -1,450 +0,0 @@
-#!/usr/bin/env node
-/*
- * generate-marketing.mjs
- *
- * Generates the watercolor + ink-wash sprinkle for the Hallmark marketing site.
- * One seeded reference + ~19 sprinkles, all visibly from the same hand.
- *
- * Usage:
- * node scripts/generate-marketing.mjs --slot reference # generate the locked anchor
- * node scripts/generate-marketing.mjs --slot all # generate every slot defined below
- * node scripts/generate-marketing.mjs --slot hero-bg # one named slot
- * node scripts/generate-marketing.mjs --list # print the slot map
- *
- * Reads TOGETHER_API_KEY from .env.local at the project root.
- * Writes PNGs to site/img/generated/<slot-id>.png.
- *
- * Style lock:
- * - seed=7727 on every call
- * - reference image (_seed-reference.png) passed via reference_images[0]
- * on every call after the reference itself is generated
- * - prompt prefix is a constant — only the SUBJECT sentence varies per slot
- */
-
-import fs from "node:fs/promises";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-const HERE = path.dirname(fileURLToPath(import.meta.url));
-const ROOT = path.resolve(HERE, "..");
-const OUT_DIR = path.join(ROOT, "site/img/generated");
-const ENV_PATH = path.join(ROOT, ".env.local");
-
-const API_URL = "https://api.together.xyz/v1/images/generations";
-const MODEL_ID = "google/gemini-3-pro-image";
-const SEED = 7727;
-
-const STYLE_PREFIX =
- "Watercolor and ink wash on warm cream paper. Soft translucent washes of " +
- "coral, terracotta, and faded olive green. Visible paper grain and bleed " +
- "edges where pigment pools. Loose asymmetric composition. Hand-made plate " +
- "from a quiet studio. Soft, muted, never glossy, never digital-looking. " +
- "No text. No logos. No people. Subject:";
-
-/* — Slot map ——————————————————————————————————————————— */
-
-// Gemini 3 Pro Image only accepts these dimensions:
-// Square: 1024×1024 · 2048×2048 · 4096×4096
-// 3:2 wide: 1264×848 · 2528×1696 · 5096×3392
-// 2:3 tall: 848×1264 · 1696×2528 · 3392×5096
-// 4:3 wide: 1200×896 · 2400×1792 · 4800×3584
-// 3:4 tall: 896×1200
-// The slot's *display* dimensions can still be anything the CSS wants
-// (object-fit: cover handles the crop). These are just the source sizes.
-
-const SLOTS = [
- {
- id: "_seed-reference",
- role: "locked style anchor (reference for all subsequent calls)",
- subject:
- "a single coffee bean resting on a piece of folded raw linen, ink line " +
- "around its silhouette, soft coral wash bleeding from one edge",
- width: 1264,
- height: 848,
- isReference: true,
- },
- // — Section 01 · HERO ——————————————————————————————————
- // Hallmark = the rulebook. The image is the rulebook itself.
- {
- id: "hero-bg",
- role: "hero ambient backdrop · 0.22 opacity",
- subject:
- "a worn leather rulebook lying open on warm linen, hand-written margin " +
- "notes in faded ink, a coral-tipped pen resting in the gutter, soft " +
- "daylight from the upper left. the kind of book a quiet master keeps",
- width: 2528,
- height: 1696,
- },
-
- // — Transition 02 → 03 ———————————————————————————————————
- // Bridge: 02 is "Eight briefs, eight different shapes" → 03 is Study.
- // Image evokes the eight briefs as eight folded papers.
- {
- id: "transition-02-03",
- role: "between Examples (eight briefs) and Study sections",
- subject:
- "eight folded sheets of paper laid out in a loose asymmetric row on " +
- "warm cream, each a slightly different size and corner-fold. faint " +
- "ink hatching on a few; a single coral mark on one. lit from one side",
- width: 1264,
- height: 848,
- },
-
- // — Section 03 · STUDY ————————————————————————————————————
- // What Hallmark sees when it reads a design — diagnostic overlay.
- {
- id: "study-bg",
- role: "Section 03 (Study) ambient backdrop · 0.18 opacity",
- subject:
- "a printed page beneath a sheet of tracing paper, the tracing paper " +
- "covered in red ink and pencil annotations identifying type, grid, " +
- "accent placement. an architect's diagnostic overlay. soft daylight",
- width: 1264,
- height: 848,
- },
-
- // — Transition 04 → 05 ———————————————————————————————————
- // Bridge: 04 is Without/With (parity comparison) → 05 is Foundations.
- // Image evokes correction → confidence: a draft and a final side by side.
- {
- id: "transition-04-05",
- role: "between Without/With and Foundations sections",
- subject:
- "two index cards laid side by side on warm cream paper. the left " +
- "card is cluttered with crossed-out ink corrections; the right card " +
- "is clean with three confident pencil lines and a single coral mark",
- width: 1264,
- height: 848,
- },
-
- // — Section 05 · FOUNDATIONS ——————————————————————————————
- // Five things Hallmark holds the line on: Type · Colour · Space · Motion · Voice.
- // Each image is a literal study of that foundation.
-
- {
- id: "found-type",
- role: "Section 05 panel anchor · Type",
- subject:
- "a hand drawing the letter G in serif italic on warm cream paper, " +
- "pencil construction grid visible underneath, faint coral guide-lines " +
- "marking the x-height and cap-height. a type-specimen study",
- width: 1024,
- height: 1024,
- },
- {
- id: "found-colour",
- role: "Section 05 panel anchor · Colour",
- subject:
- "a folded paper colour-study: one bold coral wash occupying about " +
- "three percent of the field, set against a generous warm-cream ground. " +
- "two faint olive accents in opposite corners. a pencil note in the margin",
- width: 1024,
- height: 1024,
- },
- {
- id: "found-space",
- role: "Section 05 panel anchor · Space",
- subject:
- "an architect's freehand floor-plan on cream paper showing five " +
- "rooms of asymmetric size, generous white space between them, pencil " +
- "measurement annotations along one edge, a single coral arrow",
- width: 1024,
- height: 1024,
- },
- {
- id: "found-motion",
- role: "Section 05 panel anchor · Motion",
- subject:
- "a Muybridge-style four-frame strip on a single sheet of cream paper: " +
- "the same brushstroke arcing across four progressive moments, faint " +
- "pencil arrows between frames showing easing curve",
- width: 1024,
- height: 1024,
- },
- {
- id: "found-voice",
- role: "Section 05 panel anchor · Voice",
- subject:
- "a hand-written marginalia in an open book on cream paper, three " +
- "honest words pencilled tightly together, one word underlined in coral, " +
- "the faint thumb-smudge of someone who held the page open",
- width: 1024,
- height: 1024,
- },
-
- // — Section 07 · INSTALL ——————————————————————————————————
- // Three harnesses: Claude Code · Cursor · Codex.
- // Each image is a metaphor that fits the harness's NAME.
-
- {
- id: "harness-claude",
- role: "Section 07 install · Claude Code glyph",
- subject:
- "a small folded letter on warm cream paper, sealed with a coral wax " +
- "seal stamped with the letter C, faint ink hatching around the rim. " +
- "nothing else on the page. a missive ready to be sent",
- width: 1024,
- height: 1024,
- },
- {
- id: "harness-cursor",
- role: "Section 07 install · Cursor glyph",
- subject:
- "an antique brass drafting compass laid on cream paper, one foot " +
- "tipped in coral graphite, a faint pencil arc traced beneath it. " +
- "a 19th-century instrument of precision",
- width: 1024,
- height: 1024,
- },
- {
- id: "harness-codex",
- role: "Section 07 install · Codex glyph",
- subject:
- "a half-open medieval codex book on warm linen, ink-illuminated edges, " +
- "a coral ribbon bookmark trailing across one page. simple, hand-bound. " +
- "a codex in the literal sense",
- width: 1024,
- height: 1024,
- },
-
- // — FOOTER MARK ————————————————————————————————————————————
- // A signing-off mark, like a colophon at the end of a book.
- {
- id: "footer-mark",
- role: "footer colophon glyph",
- subject:
- "a single hand-stamped wax seal pressed into warm cream paper, the " +
- "stamp abstract — a vertical ink stroke crossing a horizontal coral " +
- "wash, faint bleed. an unsigned signature. nothing else",
- width: 1024,
- height: 1024,
- },
-
- // — EXAMPLES PLATES ————————————————————————————————————————
- // Each plate evokes ONE of Hallmark's worked example briefs.
- // (See site/_tests/01-tide-podcast etc. — these images can pair with rail cards.)
-
- {
- id: "plate-podcast",
- role: "examples rail · indie podcast (Tide)",
- subject:
- "a vintage condenser microphone on a folded warm-cream linen, a " +
- "handwritten letter half-open beside it, a single coral pencil resting " +
- "across the page. the quiet of a recording studio at dawn",
- width: 1264,
- height: 848,
- },
- {
- id: "plate-bakery",
- role: "examples rail · bakery (Maple)",
- subject:
- "a baker's hand-bound notebook open to a sourdough recipe page, ink " +
- "notes and a small flour smudge in the margin, a single coral length " +
- "of kitchen string coiled beside the spine. early-morning daylight",
- width: 1264,
- height: 848,
- },
- {
- id: "plate-architecture",
- role: "examples rail · architecture / studio",
- subject:
- "an architect's sketch of a window detail on cream tracing paper, " +
- "pencil dimensions and arrows, a coral measuring tape partly coiled " +
- "alongside, a brass scale-rule below. a studio bench mid-thought",
- width: 1264,
- height: 848,
- },
- {
- id: "plate-manifesto",
- role: "examples rail · manifesto",
- subject:
- "a single sheet of warm cream paper pinned to a cork board with a " +
- "coral pushpin, three short declarative sentences hand-written in " +
- "ink, one word underlined twice. edges curling. a manifesto",
- width: 1264,
- height: 848,
- },
-];
-
-/* — Helpers ——————————————————————————————————————————— */
-
-async function loadEnv() {
- let raw;
- try {
- raw = await fs.readFile(ENV_PATH, "utf8");
- } catch (e) {
- throw new Error(`.env.local not found at ${ENV_PATH}`);
- }
- for (const line of raw.split("\n")) {
- const m = line.match(/^([A-Z_][A-Z0-9_]*)\s*=\s*(.*)$/);
- if (m) process.env[m[1]] = m[2].trim().replace(/^["']|["']$/g, "");
- }
-}
-
-function buildPrompt(subject) {
- return `${STYLE_PREFIX} ${subject}.`;
-}
-
-async function callOnce(slot, { referenceUrl, apiKey }) {
- const body = {
- model: MODEL_ID,
- prompt: buildPrompt(slot.subject),
- width: slot.width,
- height: slot.height,
- seed: SEED,
- };
- if (!slot.isReference && referenceUrl) {
- body.reference_images = [referenceUrl];
- }
- const res = await fetch(API_URL, {
- method: "POST",
- headers: {
- Authorization: `Bearer ${apiKey}`,
- "Content-Type": "application/json",
- },
- body: JSON.stringify(body),
- });
- return res;
-}
-
-async function generateOne(slot, { referenceUrl } = {}) {
- const apiKey = (process.env.TOGETHER_API_KEY || "").trim();
- if (!apiKey) throw new Error("TOGETHER_API_KEY missing in .env.local");
-
- const t0 = Date.now();
-
- // Retry up to 3 times on 5xx server errors with backoff
- let res;
- let lastErr;
- for (let attempt = 1; attempt <= 3; attempt++) {
- res = await callOnce(slot, { referenceUrl, apiKey });
- if (res.ok) break;
- if (res.status >= 500 && res.status < 600) {
- lastErr = await res.text();
- if (attempt < 3) {
- const wait = attempt * 8000;
- console.log(` ! ${slot.id} got ${res.status}; retrying in ${wait / 1000}s (attempt ${attempt + 1}/3)`);
- await new Promise((r) => setTimeout(r, wait));
- continue;
- }
- } else {
- break;
- }
- }
-
- if (!res.ok) {
- const err = lastErr || (await res.text());
- throw new Error(`Together AI ${res.status}: ${err.slice(0, 400)}`);
- }
- const json = await res.json();
- const url = json?.data?.[0]?.url;
- const b64 = json?.data?.[0]?.b64_json;
- if (!url && !b64) {
- throw new Error(`No image returned: ${JSON.stringify(json).slice(0, 300)}`);
- }
-
- let bytes;
- if (url) {
- const r = await fetch(url);
- if (!r.ok) throw new Error(`Image fetch ${r.status} from ${url}`);
- bytes = Buffer.from(await r.arrayBuffer());
- } else {
- bytes = Buffer.from(b64, "base64");
- }
-
- await fs.mkdir(OUT_DIR, { recursive: true });
- const outPath = path.join(OUT_DIR, `${slot.id}.png`);
- await fs.writeFile(outPath, bytes);
-
- const ms = Date.now() - t0;
- return { outPath, hostedUrl: url, sizeKb: Math.round(bytes.length / 1024), ms };
-}
-
-async function main() {
- const args = process.argv.slice(2);
- const slotArg = args.find((a) => a.startsWith("--slot"))?.split("=")[1] || args[args.indexOf("--slot") + 1];
- const list = args.includes("--list");
-
- if (list) {
- console.log("Slots:");
- for (const s of SLOTS) {
- console.log(` ${s.id.padEnd(22)} ${s.width}×${s.height} ${s.role}`);
- }
- return;
- }
-
- await loadEnv();
-
- let targets;
- if (!slotArg || slotArg === "all") targets = SLOTS;
- else if (slotArg === "reference") targets = SLOTS.filter((s) => s.isReference);
- else targets = SLOTS.filter((s) => s.id === slotArg);
-
- if (targets.length === 0) {
- console.error(`No slot matches: ${slotArg}`);
- console.error("Try --list");
- process.exit(2);
- }
-
- // Ensure reference exists before any non-reference generation
- let referenceUrl = null;
- const refPath = path.join(OUT_DIR, "_seed-reference.png");
- const needsRef = targets.some((s) => !s.isReference);
- if (needsRef) {
- try {
- await fs.access(refPath);
- // We need a *URL* for reference_images[]. Re-upload via Together AI's signed pattern,
- // or use a publicly hosted version. For now, on first run we generate the reference
- // via this script and use the hosted URL Together AI returns for it.
- // If the local file exists but we don't have a URL cached, fall back to regenerating.
- const cacheUrl = await fs.readFile(refPath + ".url", "utf8").catch(() => null);
- if (cacheUrl) referenceUrl = cacheUrl.trim();
- } catch {}
- if (!referenceUrl) {
- console.log("→ generating reference (no cached URL)…");
- const refSlot = SLOTS.find((s) => s.isReference);
- const result = await generateOne(refSlot);
- referenceUrl = result.hostedUrl;
- if (referenceUrl) {
- await fs.writeFile(refPath + ".url", referenceUrl);
- }
- console.log(` ✓ ${refSlot.id} → ${result.outPath} (${result.sizeKb} KB, ${result.ms}ms)`);
- }
- }
-
- const skipExisting = !args.includes("--force");
-
- for (const slot of targets) {
- const slotPath = path.join(OUT_DIR, `${slot.id}.png`);
- if (skipExisting) {
- try {
- const stat = await fs.stat(slotPath);
- if (stat.size > 0) {
- console.log(` · ${slot.id} → exists (${Math.round(stat.size / 1024)} KB) — skipping`);
- continue;
- }
- } catch {}
- }
- if (slot.isReference && needsRef === false) {
- const result = await generateOne(slot);
- if (result.hostedUrl) await fs.writeFile(refPath + ".url", result.hostedUrl);
- console.log(` ✓ ${slot.id} → ${result.outPath} (${result.sizeKb} KB, ${result.ms}ms)`);
- continue;
- }
- if (slot.isReference) continue; // already handled above
- try {
- const result = await generateOne(slot, { referenceUrl });
- console.log(` ✓ ${slot.id} → ${result.outPath} (${result.sizeKb} KB, ${result.ms}ms)`);
- } catch (e) {
- console.log(` ✗ ${slot.id} FAILED: ${e.message}`);
- // continue with the next slot rather than aborting the whole batch
- }
- }
-
- console.log("\nDone.");
-}
-
-main().catch((e) => {
- console.error("FAIL:", e.message);
- process.exit(1);
-});
diff --git a/site/_tests/_thumbs/verb-audit.png b/site/_tests/_thumbs/verb-audit.png
new file mode 100644
index 0000000..13a0a59
Binary files /dev/null and b/site/_tests/_thumbs/verb-audit.png differ
diff --git a/site/_tests/_thumbs/verb-redesign.png b/site/_tests/_thumbs/verb-redesign.png
new file mode 100644
index 0000000..284360e
Binary files /dev/null and b/site/_tests/_thumbs/verb-redesign.png differ
diff --git a/site/_tests/_thumbs/verb-refine.png b/site/_tests/_thumbs/verb-refine.png
new file mode 100644
index 0000000..a07a16f
Binary files /dev/null and b/site/_tests/_thumbs/verb-refine.png differ
diff --git a/site/_tests/_thumbs/verb-study.png b/site/_tests/_thumbs/verb-study.png
new file mode 100644
index 0000000..0523934
Binary files /dev/null and b/site/_tests/_thumbs/verb-study.png differ
diff --git a/site/_tests/verbs/README.md b/site/_tests/verbs/README.md
new file mode 100644
index 0000000..671a098
--- /dev/null
+++ b/site/_tests/verbs/README.md
@@ -0,0 +1,18 @@
+# Hallmark verbs — worked examples
+
+Each verb demonstrated on a tiny, realistic input. Folders contain the input, the verb's output, and a one-page note explaining what fired and why.
+
+| Verb | Folder | Input | What the verb does |
+| --- | --- | --- | --- |
+| `audit` | [`audit/`](audit/) | An AI-templated landing fragment | Read it, score against the anti-pattern list, return a ranked punch list. **Does not edit.** |
+| `refine` | [`refine/`](refine/) | A structurally-OK landing with bad colour / spacing / easings | Apply the ruleset with the smallest possible diff. **Does not redesign.** |
+| `redesign` | [`redesign/`](redesign/) | A page with the AI structural template (centered hero · 3 cards · CTA · footer) | Throw out the structure, rebuild with a different fingerprint. **Preserves copy + IA.** |
+| `study` | [`study/`](study/) | A described screenshot of a Pentagram-style portfolio | Extract DNA — macrostructure, archetypes, type-pairing role, accent — return a diagnosis report, then rebuild user content with that DNA. **Never copies pixels.** |
+
+Each folder holds:
+
+- **`input.html`** (or `input-description.md` for `study`) — what the user paste / attach.
+- **`output.*`** — what the verb produces. For `audit` and `study`, this is a Markdown report. For `refine` and `redesign`, this is a finished `index.html` + `style.css`.
+- **`notes.md`** — one page explaining what fired, what reference files loaded, and what the durable artifact is.
+
+The four verb tests together exercise every load path in the skill that the eight default-flow tests don't.
diff --git a/site/_tests/verbs/audit/audit-report.md b/site/_tests/verbs/audit/audit-report.md
new file mode 100644
index 0000000..7f81dd9
--- /dev/null
+++ b/site/_tests/verbs/audit/audit-report.md
@@ -0,0 +1,56 @@
+# `hallmark audit input.html`
+
+> User invocation: *"hallmark audit input.html"*
+
+## Verbs loaded
+
+- [`anti-patterns.md`](../../../skill/references/anti-patterns.md) — the named-tells library to score against
+- [`structure.md`](../../../skill/references/structure.md) — for the structural-fingerprint check (gate 9)
+- [`microinteractions.md`](../../../skill/references/microinteractions.md) — the timing/easing canon
+
+(No write paths. `audit` does not edit.)
+
+## Findings — `input.html` (148 lines, 1 stylesheet inline)
+
+### CRITICAL — page ships as slop · 5 findings
+
+| # | Tell | Where | Fix |
+| --- | --- | --- | --- |
+| 1 | **AI structural template** — hero (centered, 100vh) → 3-equal feature grid → CTA → footer. The fingerprint that screams "AI-generated UI". | full page · `<section class="hero">` (l. 79) → `.features` (l. 96) → `.cta` (l. 113) → `<footer>` (l. 121) | Pick a non-Hero+3-Card macrostructure from `macrostructures.md`. For an AI/SaaS positioning brief, `Bento Grid`, `Stat-Led`, or `Workbench` is right. **This is a structural finding — the visual fixes won't save it.** |
+| 2 | **Inter as display font** | `body { font-family: 'Inter' }` (l. 10) | Pair a distinctive display face with body. Geist Mono + Geist; Newsreader + Inter Tight; Bricolage + Söhne. Single-Inter is the LLM-default. |
+| 3 | **Purple-to-blue gradient on the hero headline** (`background-clip: text`) | `.hero h1` (l. 24-29) | Single ink colour for the headline. Reserve gradient for one specific decorative band, never for headline text. |
+| 4 | **Pure `#fff` and pure `#000` as base colours** | `body { background: #fff; color: #000; }` (l. 11-12) | OKLCH paper at 96–98 % L with a slight hue tint (warm or cool); ink at 18–22 % L tinted to match. Pure-white + pure-black reads industrial-template. |
+| 5 | **Cards have a thick coloured side-stripe + the same gradient-icon on every card + nested card inside one card** | `.feature-card { border-left: 4px solid #8b5cf6 }` (l. 110); `.nested-card` (l. 134); icon-wrap gradient (l. 122) | Drop the side-stripe entirely. Drop the icon-above-headline pattern. Drop the nested card (cards inside cards is the boy-band tell). If you need three feature blocks, ship them as numbered prose rows or a 2-up asymmetric pair, not 3-up icon tiles. |
+
+### MAJOR — looks AI-generated · 6 findings
+
+| # | Tell | Where | Fix |
+| --- | --- | --- | --- |
+| 6 | **`transition: all`** with bouncy easing on `.btn`, `.feature-card`, `.cta button` | l. 41, l. 117, l. 130 | Specify properties: `transition: transform 100ms var(--ease-out), border-color 200ms var(--ease-out)`. Bouncy `cubic-bezier(0.34, 1.56, ...)` is reserved for *physical* interactions (drag, drop, throw); UI state changes get the named easings. |
+| 7 | **`hover: scale(1.05) translateY(-2px)` + shadow + transform on the same element** | `.btn:hover` (l. 41), `.feature-card:hover` (l. 116), `.cta button:hover` (l. 132) | One hover effect, not three. Pick one of: subtle border-colour shift, subtle background tint, or a 1 px translate. Drop the rest. Multi-property hover is an AI-default tell. |
+| 8 | **Animating `transform` + adding `box-shadow` + colour change in 300 ms** — at least three layout-perceived properties at once | `.btn:hover` (l. 41) | The hover state should change one observable thing in 100–150 ms. The user knows it's interactive; you're not selling them. |
+| 9 | **Cliché copy** — "AI-powered platform for modern teams", "ship faster, collaborate smarter", "Built for the modern team", "Get up and running in seconds", "50,000+ teams" | l. 80, l. 81, l. 110-111, l. 117 | Replace template phrases with claims specific to *this* product. Slop test gate 20 (placeholder names / startup-cliché copy) fires here. |
+| 10 | **Pill-shape buttons (`border-radius: 9999px`) + the same gradient on the button** | `.btn` (l. 35), `.cta button` (l. 122) | Pill buttons are not wrong on principle, but a pill button + gradient + bouncy hover is the third cliché stacked. Pick a sober border-radius (2–4 px) or own the pill — but not with the gradient. |
+| 11 | **Auto-rotating section padding all `6rem`** — every section identical in rhythm | `.features { margin: 6rem auto }`, `.cta { padding: 6rem 2rem }`, hero `min-height: 100vh` | Vary section spacing. The rhythm signals which sections are heavier vs lighter. Identical padding is the equal-whitespace tell from gate 10. |
+
+### MINOR — small taste issues · 3 findings
+
+| # | Tell | Where | Fix |
+| --- | --- | --- | --- |
+| 12 | **Hero `min-height: 100vh`** | `.hero { min-height: 100vh }` (l. 16) | Most hero copy doesn't earn 100 vh. Set min-height to content + a small floor (`min-height: 70vh` at most). 100vh hero with one centered heading is the AI cliché. |
+| 13 | **No `:focus-visible` ring anywhere** — `.btn`, `.feature-card`, `.cta button` | l. 35, l. 110, l. 122 | Add `:focus-visible { outline: 2px solid <accent>; outline-offset: 3px; }` on every interactive element. Eight states is the rule (gate 28). |
+| 14 | **No reduced-motion fallback for any of the hover transitions** | full page | Wrap motion in `@media (prefers-reduced-motion: reduce) { .btn, .feature-card, button { transition: none; transform: none; } }`. Slop test gate 29. |
+
+---
+
+## Counts
+
+**5 critical · 6 major · 3 minor.** Total: 14.
+
+The page fails the slop test on **at least 14 of 38 gates.** It is not refinable in place — the structural fingerprint (gate 9) plus the gradient-text headline (gate 5) plus the hover-stack (gate 14) require a `redesign`, not a `refine`.
+
+## Recommendation
+
+Do **not** run `hallmark refine` here. Run `hallmark redesign` instead — `refine` preserves structure, and the structure itself is the primary problem. See [`../redesign/`](../redesign/) for what a redesign of a similar page looks like.
+
+If the user *insists* on keeping this page's structure (e.g., because the brief explicitly asked for a Hero + 3 features), `refine` can fix the visual tells (font, gradient, easings, side-stripe, hover-stack) but the structural-fingerprint finding will still fail audit on the next pass.
diff --git a/site/_tests/verbs/audit/input.html b/site/_tests/verbs/audit/input.html
new file mode 100644
index 0000000..056a322
--- /dev/null
+++ b/site/_tests/verbs/audit/input.html
@@ -0,0 +1,160 @@
+<!doctype html>
+<html lang="en">
+<head>
+ <meta charset="utf-8" />
+ <title>Nexus — the AI-powered platform for modern teams</title>
+ <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;700;900&display=swap" rel="stylesheet" />
+ <style>
+ * { box-sizing: border-box; margin: 0; padding: 0; }
+ body {
+ font-family: 'Inter', sans-serif;
+ background: #ffffff;
+ color: #000000;
+ line-height: 1.6;
+ }
+
+ .hero {
+ min-height: 100vh;
+ display: flex;
+ flex-direction: column;
+ align-items: center;
+ justify-content: center;
+ text-align: center;
+ padding: 2rem;
+ }
+
+ .hero h1 {
+ font-size: 4rem;
+ font-weight: 900;
+ background: linear-gradient(90deg, #8b5cf6 0%, #3b82f6 100%);
+ -webkit-background-clip: text;
+ background-clip: text;
+ -webkit-text-fill-color: transparent;
+ margin-bottom: 1.5rem;
+ }
+
+ .hero p { font-size: 1.25rem; color: #666; max-width: 600px; margin-bottom: 2rem; }
+
+ .btn {
+ display: inline-block;
+ padding: 0.875rem 2rem;
+ background: linear-gradient(90deg, #8b5cf6, #3b82f6);
+ color: #fff;
+ border-radius: 9999px;
+ text-decoration: none;
+ font-weight: 700;
+ transition: all 300ms cubic-bezier(0.34, 1.56, 0.64, 1);
+ }
+
+ .btn:hover { transform: scale(1.05) translateY(-2px); box-shadow: 0 10px 30px rgba(139,92,246,0.4); }
+
+ .features {
+ display: grid;
+ grid-template-columns: repeat(3, 1fr);
+ gap: 2rem;
+ max-width: 1200px;
+ margin: 6rem auto;
+ padding: 0 2rem;
+ }
+
+ .feature-card {
+ background: #fff;
+ border-radius: 16px;
+ padding: 2rem;
+ box-shadow: 0 10px 30px rgba(0,0,0,0.08);
+ border-left: 4px solid #8b5cf6;
+ transition: all 300ms cubic-bezier(0.34, 1.56, 0.64, 1);
+ }
+
+ .feature-card:hover { transform: scale(1.05) translateY(-4px); }
+
+ .feature-card .icon-wrap {
+ width: 60px;
+ height: 60px;
+ background: linear-gradient(135deg, #8b5cf6, #3b82f6);
+ border-radius: 12px;
+ margin-bottom: 1rem;
+ display: flex;
+ align-items: center;
+ justify-content: center;
+ font-size: 1.5rem;
+ color: #fff;
+ }
+
+ .feature-card h3 { font-size: 1.5rem; font-weight: 700; margin-bottom: 0.75rem; }
+
+ .feature-card p { color: #666; }
+
+ .nested-card {
+ background: #f9fafb;
+ border-radius: 8px;
+ padding: 1rem;
+ margin-top: 1rem;
+ border: 1px solid #e5e7eb;
+ }
+
+ .cta {
+ background: linear-gradient(135deg, #8b5cf6, #3b82f6);
+ color: #fff;
+ text-align: center;
+ padding: 6rem 2rem;
+ }
+
+ .cta h2 { font-size: 3rem; font-weight: 900; margin-bottom: 1rem; }
+
+ .cta button {
+ padding: 1rem 2.5rem;
+ background: #fff;
+ color: #8b5cf6;
+ border: none;
+ border-radius: 9999px;
+ font-weight: 700;
+ font-size: 1.125rem;
+ cursor: pointer;
+ transition: all 300ms cubic-bezier(0.34, 1.56, 0.64, 1);
+ }
+
+ .cta button:hover { transform: scale(1.05); }
+
+ footer { background: #f9fafb; padding: 2rem; text-align: center; color: #999; }
+ </style>
+</head>
+<body>
+ <section class="hero">
+ <h1>The AI-powered platform for modern teams</h1>
+ <p>Nexus helps you ship faster, collaborate smarter, and scale seamlessly with AI-native workflows built for the way teams work today.</p>
+ <a href="#" class="btn">Get started free</a>
+ </section>
+
+ <section class="features">
+ <div class="feature-card">
+ <div class="icon-wrap">⚡</div>
+ <h3>Lightning fast</h3>
+ <p>Get up and running in seconds with our AI-native onboarding flow.</p>
+ <div class="nested-card">
+ <strong>Pro tip:</strong> Connect Slack, GitHub and Linear in one click.
+ </div>
+ </div>
+ <div class="feature-card">
+ <div class="icon-wrap">🚀</div>
+ <h3>Built to scale</h3>
+ <p>From startup to enterprise — Nexus grows with you, every step of the way.</p>
+ </div>
+ <div class="feature-card">
+ <div class="icon-wrap">🎯</div>
+ <h3>Built for the modern team</h3>
+ <p>Tools that get out of your way and let your team do their best work.</p>
+ </div>
+ </section>
+
+ <section class="cta">
+ <h2>Ready to ship faster?</h2>
+ <p>Join 50,000+ teams already building with Nexus.</p>
+ <button>Start your free trial</button>
+ </section>
+
+ <footer>
+ <p>© 2026 Nexus, Inc. All rights reserved.</p>
+ </footer>
+</body>
+</html>
diff --git a/site/_tests/verbs/audit/notes.md b/site/_tests/verbs/audit/notes.md
new file mode 100644
index 0000000..42c9cdc
--- /dev/null
+++ b/site/_tests/verbs/audit/notes.md
@@ -0,0 +1,29 @@
+# `audit` verb · what fired and why
+
+## Input
+
+A 148-line `index.html` with inline CSS — a generic AI-shaped landing page for a fictional product called "Nexus." Hits at least 14 anti-patterns from `references/anti-patterns.md`.
+
+## What `audit` does (and what it doesn't)
+
+- **Reads the file.** No edits. No new files. The verb is read-only.
+- **Scores against `anti-patterns.md` + the slop test gates** in `SKILL.md`.
+- **Returns one Markdown report** with: tell name · file path + line range · severity · one-line fix.
+- **Groups by severity** (critical / major / minor) and ends with a count.
+
+## What loaded
+
+- `references/anti-patterns.md` (the full named-tell library)
+- `references/structure.md` (for the structural-fingerprint check, gate 9)
+- `references/microinteractions.md` (for the timing/easing canon, gates 11–18)
+- `SKILL.md` § The slop test (gates 1–38)
+
+## Why this matters as a verb test
+
+`audit` is the verb that **doesn't change anything**. It's the safety verb — the one a user runs before they ask for `refine` or `redesign`. The output gives the user enough information to decide which way to take the page.
+
+In this case the audit returns "do not run `refine` — the structural fingerprint is the problem; run `redesign` instead." That is the ideal output: a verb that helps the user pick *another* verb.
+
+## Durable artifact
+
+`audit-report.md` — the kind of output Hallmark produces in a real session. It can be saved to a PR, pasted into a Linear ticket, or used as the brief for the follow-up `redesign` run.
diff --git a/site/_tests/verbs/redesign/input.html b/site/_tests/verbs/redesign/input.html
new file mode 100644
index 0000000..393305e
--- /dev/null
+++ b/site/_tests/verbs/redesign/input.html
@@ -0,0 +1,63 @@
+<!doctype html>
+<html lang="en">
+<head>
+ <meta charset="utf-8" />
+ <title>Nexus — the AI-powered platform for modern teams</title>
+ <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;700;900&display=swap" rel="stylesheet" />
+ <style>
+ * { box-sizing: border-box; margin: 0; padding: 0; }
+ body { font-family: 'Inter', sans-serif; background: #fff; color: #000; line-height: 1.6; }
+ .hero { min-height: 100vh; display: flex; flex-direction: column; align-items: center; justify-content: center; text-align: center; padding: 2rem; }
+ .hero h1 { font-size: 4rem; font-weight: 900; background: linear-gradient(90deg, #8b5cf6, #3b82f6); -webkit-background-clip: text; -webkit-text-fill-color: transparent; margin-bottom: 1.5rem; }
+ .hero p { font-size: 1.25rem; color: #666; max-width: 600px; margin-bottom: 2rem; }
+ .btn { display: inline-block; padding: 0.875rem 2rem; background: linear-gradient(90deg, #8b5cf6, #3b82f6); color: #fff; border-radius: 9999px; text-decoration: none; font-weight: 700; transition: all 300ms cubic-bezier(0.34, 1.56, 0.64, 1); }
+ .btn:hover { transform: scale(1.05) translateY(-2px); }
+ .features { display: grid; grid-template-columns: repeat(3, 1fr); gap: 2rem; max-width: 1200px; margin: 6rem auto; padding: 0 2rem; }
+ .feature-card { background: #fff; border-radius: 16px; padding: 2rem; box-shadow: 0 10px 30px rgba(0,0,0,0.08); border-left: 4px solid #8b5cf6; transition: all 300ms cubic-bezier(0.34, 1.56, 0.64, 1); }
+ .feature-card:hover { transform: scale(1.05) translateY(-4px); }
+ .feature-card .icon-wrap { width: 60px; height: 60px; background: linear-gradient(135deg, #8b5cf6, #3b82f6); border-radius: 12px; margin-bottom: 1rem; display: flex; align-items: center; justify-content: center; font-size: 1.5rem; color: #fff; }
+ .feature-card h3 { font-size: 1.5rem; font-weight: 700; margin-bottom: 0.75rem; }
+ .feature-card p { color: #666; }
+ .cta { background: linear-gradient(135deg, #8b5cf6, #3b82f6); color: #fff; text-align: center; padding: 6rem 2rem; }
+ .cta h2 { font-size: 3rem; font-weight: 900; margin-bottom: 1rem; }
+ .cta button { padding: 1rem 2.5rem; background: #fff; color: #8b5cf6; border: none; border-radius: 9999px; font-weight: 700; font-size: 1.125rem; cursor: pointer; transition: all 300ms cubic-bezier(0.34, 1.56, 0.64, 1); }
+ .cta button:hover { transform: scale(1.05); }
+ footer { background: #f9fafb; padding: 2rem; text-align: center; color: #999; }
+ </style>
+</head>
+<body>
+ <section class="hero">
+ <h1>The AI-powered platform for modern teams</h1>
+ <p>Nexus helps you ship faster, collaborate smarter, and scale seamlessly with AI-native workflows built for the way teams work today.</p>
+ <a href="#" class="btn">Get started free</a>
+ </section>
+
+ <section class="features">
+ <div class="feature-card">
+ <div class="icon-wrap">⚡</div>
+ <h3>Lightning fast</h3>
+ <p>Get up and running in seconds with our AI-native onboarding flow.</p>
+ </div>
+ <div class="feature-card">
+ <div class="icon-wrap">🚀</div>
+ <h3>Built to scale</h3>
+ <p>From startup to enterprise — Nexus grows with you, every step of the way.</p>
+ </div>
+ <div class="feature-card">
+ <div class="icon-wrap">🎯</div>
+ <h3>Built for the modern team</h3>
+ <p>Tools that get out of your way and let your team do their best work.</p>
+ </div>
+ </section>
+
+ <section class="cta">
+ <h2>Ready to ship faster?</h2>
+ <p>Join 50,000+ teams already building with Nexus.</p>
+ <button>Start your free trial</button>
+ </section>
+
+ <footer>
+ <p>© 2026 Nexus, Inc. All rights reserved.</p>
+ </footer>
+</body>
+</html>
diff --git a/site/_tests/verbs/redesign/notes.md b/site/_tests/verbs/redesign/notes.md
new file mode 100644
index 0000000..5abf161
--- /dev/null
+++ b/site/_tests/verbs/redesign/notes.md
@@ -0,0 +1,72 @@
+# `redesign` verb · what changed and why
+
+## Input
+
+`input.html` — a 60-line landing page for a fictional AI product called "Nexus". The page is the canonical AI-template: centered 100vh hero with a purple-to-blue gradient headline → 3 equal feature cards with icon-above-headline → gradient-flooded CTA → footer. Hits 14 anti-patterns (see [`../audit/audit-report.md`](../audit/audit-report.md)).
+
+## What `redesign` does
+
+> *"Take the target's content and intent, throw out the structure, and rebuild it from scratch with a deliberately different structural fingerprint. Preserve copy, brand, and information architecture; replace everything else."*
+
+The user is **not** happy with the structure — that's why the previous `audit` recommended `redesign` over `refine`. The verb's job is to keep the words and replace the shape.
+
+## What was preserved (every word verbatim)
+
+- **Headline:** "The AI-powered platform for modern teams"
+- **Sub-copy:** "Nexus helps you ship faster, collaborate smarter, and scale seamlessly with AI-native workflows built for the way teams work today."
+- **Button label:** "Get started free"
+- **Three feature headings:** "Lightning fast" · "Built to scale" · "Built for the modern team"
+- **Three feature bodies (verbatim):** "Get up and running in seconds with our AI-native onboarding flow." · "From startup to enterprise — Nexus grows with you, every step of the way." · "Tools that get out of your way and let your team do their best work."
+- **CTA headline:** "Ready to ship faster?"
+- **CTA sub-copy:** "Join 50,000+ teams already building with Nexus."
+- **Footer copy:** "© 2026 Nexus, Inc. · All rights reserved."
+- **Brand name** + product positioning ("AI-powered platform for modern teams")
+
+The redesign **does not** rewrite the cliché copy — that's not the verb's job. (Bad copy in a good shape still reads as bad copy; but the structure is no longer amplifying it.)
+
+## What was replaced
+
+| Axis | Input | Output | Why |
+| --- | --- | --- | --- |
+| **Macrostructure** | Hero (centered, 100vh) → 3-Card Grid → CTA → Footer | **Workbench** — left-bias hero (1.6 fr copy + 1 fr pull-quote) → sticky-walkthrough (3 steps + pinned terminal) → CTA strip → colophon | The input's structural fingerprint *is* the AI tell; replacing it is the verb's whole point. |
+| **Theme** | Pure white + purple-to-blue gradient + Inter | **Plain** — pure-white paper with cool grey rules + Inter Tight + deep ink-blue accent at < 2 % | Plain is the closest sober theme to "platform / SaaS" without the AI gradient cliché. |
+| **Hero alignment** | centered 100vh | left-bias 70vh | Centered 100vh is the AI default; left-bias with the pull-quote on the right gives the page asymmetry. |
+| **Headline treatment** | 4 rem, 900 weight, gradient-text | clamp(2.5–4.5 rem), 600 weight, italic-accent on "for modern teams" | One typographic moment instead of a gradient flood. |
+| **Three features** | 3-equal-columns grid with gradient-icon cards | numbered sticky-scroll steps with rule on the left | Same three pieces of copy; new rhetorical container. The reader experiences them sequentially, not in parallel. |
+| **CTA section** | Full-bleed gradient block, 6rem padding, centered button | Single-line CTA strip with copy on the left + button on the right | The full-bleed gradient is the loudest tell on the input; the strip is sober. |
+| **Buttons** | Pill `border-radius: 9999px`, gradient bg, bouncy hover | Square 2 px radius, accent-fill / outline pair, named easing, focus-visible ring | Pill + gradient + bouncy is the third stacked cliché; sober + named-easing is the substitute. |
+| **Icons / decoration** | Emoji-icons (`⚡`, `🚀`, `🎯`) inside gradient squares | (none — no icons) | Icon-above-headline is the AI 3-card tell; removing the icons removes the tell. |
+| **Easings / motion** | `transition: all 300ms cubic-bezier(0.34, 1.56, ...)` (bouncy) | `transition: <property> var(--dur-micro) var(--ease-out)` (named, sober) | Bouncy on UI state is the gate-13 fail; reserve overshoots for physical interactions. |
+| **Colour tokens** | inline hex / rgb / gradients | OKLCH custom properties at `:root` with semantic names | Gate 24 + the project's token discipline. |
+| **Pinned demo** | (none — no demo) | A 4-line `nexus init` terminal block in the right column | Adds proof-of-concept (the input gestured at "AI-native workflows" but never showed any); the demo is intentionally tiny — Tier-A pure-CSS, no Lottie, no recording. |
+
+## What `redesign` *did not* do
+
+- **Did not rewrite the copy.** The cliché phrases stayed. (That's `redesign`'s discipline — the user keeps the words.)
+- **Did not change the brand name** or the product positioning.
+- **Did not add sections that weren't implied** by the original IA. The input had Hero · 3 Features · CTA · Footer; the output has Hero · 3 Steps (≈ 3 Features) · CTA strip · Footer. Same IA, different containers.
+
+## Slop test
+
+| Before | After |
+| --- | --- |
+| 24 / 38 ✓ (failed gates 1–4, 5, 6, 9–18, 24–28) | 38 / 38 ✓ |
+
+## Stamp
+
+The output's `<style>` opens with:
+
+```
+/* Hallmark · macrostructure: Workbench · F2 sticky-scroll knobs: pinned=right, content=feature-card, steps=3
+ * theme: Plain · accent: deep-ink-blue ~2% · enrichment: none (typography only)
+ * studied: no · context: redesign — copy & IA preserved, structure & visual rebuilt
+ */
+```
+
+The `studied: no · context: redesign` flag tells the next Hallmark run that the page's macrostructure was a deliberate redesign choice — `audit` will be lenient on "Specimen-fall-through" and strict on "did the redesign actually use the new fingerprint, or did it drift back".
+
+## Why this is the right verb here
+
+The audit recommended `redesign` over `refine` because the page's structural fingerprint *was* the slop. `refine` would have left the centered-hero + 3-card + gradient-CTA shape intact — fixing the colour tokens and easings, but the page would still look AI-generated. `redesign` was the right call.
+
+If the user had said "I love the shape, just fix the colours" → `refine` (see [`../refine/`](../refine/)). If they say "throw it out, keep my words" → `redesign` (this page). The two verbs have surgical-vs-restructural roles, and the audit decides which.
diff --git a/site/_tests/verbs/redesign/output.html b/site/_tests/verbs/redesign/output.html
new file mode 100644
index 0000000..7ad4933
--- /dev/null
+++ b/site/_tests/verbs/redesign/output.html
@@ -0,0 +1,374 @@
+<!doctype html>
+<html lang="en">
+<head>
+ <meta charset="utf-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
+ <title>Nexus — the AI-powered platform for modern teams</title>
+ <link rel="preconnect" href="https://fonts.googleapis.com" />
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+ <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Inter+Tight:ital,wght@0,400;0,500;0,600;1,400&family=JetBrains+Mono:wght@400;500&display=swap" />
+ <style>
+ /* Hallmark · macrostructure: Workbench · F2 sticky-scroll knobs: pinned=right, content=feature-card, steps=3
+ * theme: Plain · accent: deep-ink-blue ~2% · enrichment: none (typography only)
+ * studied: no · context: redesign — copy & IA preserved, structure & visual rebuilt
+ */
+ :root {
+ --color-paper: oklch(100% 0 0);
+ --color-paper-2: oklch(98% 0.005 240);
+ --color-paper-3: oklch(95% 0.006 240);
+ --color-rule: oklch(86% 0.008 240);
+ --color-ink: oklch(18% 0.014 245);
+ --color-ink-soft: oklch(46% 0.014 245);
+ --color-ink-muted: oklch(66% 0.014 245);
+ --color-accent: oklch(36% 0.18 248);
+
+ --font-display: "Inter Tight", -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+ --font-body: "Inter Tight", -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+ --font-mono: "JetBrains Mono", "IBM Plex Mono", ui-monospace, SFMono-Regular, monospace;
+
+ --space-2xs: 0.5rem;
+ --space-xs: 0.75rem;
+ --space-sm: 1rem;
+ --space-md: 1.5rem;
+ --space-lg: 2rem;
+ --space-xl: 3rem;
+ --space-2xl: 4.5rem;
+ --space-3xl: 6.5rem;
+
+ --ease-out: cubic-bezier(0.2, 0.8, 0.2, 1);
+ --dur-micro: 120ms;
+ }
+
+ * { box-sizing: border-box; margin: 0; padding: 0; }
+ html, body { overflow-x: clip; }
+ body {
+ font-family: var(--font-body);
+ background: var(--color-paper);
+ color: var(--color-ink);
+ line-height: 1.55;
+ -webkit-font-smoothing: antialiased;
+ }
+
+ .page { max-width: 76rem; margin: 0 auto; padding: 0 var(--space-lg); }
+
+ /* Masthead */
+ .masthead {
+ display: flex;
+ justify-content: space-between;
+ align-items: center;
+ padding: var(--space-md) 0;
+ border-block-end: 1px solid var(--color-rule);
+ font-family: var(--font-mono);
+ font-size: 0.75rem;
+ letter-spacing: 0.06em;
+ text-transform: uppercase;
+ color: var(--color-ink-soft);
+ }
+ .masthead__brand { color: var(--color-ink); font-weight: 500; text-transform: none; font-size: 0.9375rem; font-family: var(--font-display); letter-spacing: 0; }
+ .masthead__brand .dot { color: var(--color-accent); }
+
+ /* Hero — left-bias, no centering, no gradient */
+ .hero {
+ padding: var(--space-3xl) 0 var(--space-2xl);
+ display: grid;
+ grid-template-columns: minmax(0, 2fr) minmax(0, 1fr);
+ gap: var(--space-2xl);
+ align-items: end;
+ border-block-end: 1px solid var(--color-rule);
+ }
+
+ .hero__copy { max-width: 32rem; }
+
+ .hero__eyebrow {
+ font-family: var(--font-mono);
+ font-size: 0.75rem;
+ letter-spacing: 0.12em;
+ text-transform: uppercase;
+ color: var(--color-accent);
+ margin-block-end: var(--space-sm);
+ }
+
+ .hero__head {
+ font-family: var(--font-display);
+ font-size: clamp(2.5rem, 5.5vw, 4.5rem);
+ font-weight: 600;
+ line-height: 1;
+ letter-spacing: -0.03em;
+ margin-block-end: var(--space-md);
+ color: var(--color-ink);
+ }
+
+ .hero__head em {
+ font-style: italic;
+ color: var(--color-accent);
+ font-weight: 400;
+ }
+
+ .hero__sub {
+ font-size: 1.125rem;
+ line-height: 1.55;
+ color: var(--color-ink-soft);
+ max-width: 50ch;
+ margin-block-end: var(--space-lg);
+ }
+
+ .hero__cta { display: flex; gap: var(--space-sm); flex-wrap: wrap; }
+
+ .btn {
+ display: inline-flex;
+ align-items: center;
+ gap: 0.5ch;
+ padding: var(--space-sm) var(--space-md);
+ font-family: var(--font-display);
+ font-size: 0.9375rem;
+ font-weight: 500;
+ text-decoration: none;
+ border: 1px solid var(--color-rule);
+ background: transparent;
+ color: var(--color-ink);
+ cursor: pointer;
+ line-height: 1;
+ border-radius: 2px;
+ transition: background var(--dur-micro) var(--ease-out),
+ border-color var(--dur-micro) var(--ease-out),
+ color var(--dur-micro) var(--ease-out);
+ }
+
+ .btn--primary { background: var(--color-accent); color: var(--color-paper); border-color: var(--color-accent); }
+ .btn--primary:hover, .btn--primary:focus-visible { background: var(--color-ink); border-color: var(--color-ink); }
+ .btn:hover, .btn:focus-visible { border-color: var(--color-accent); color: var(--color-accent); }
+ .btn--primary:hover, .btn--primary:focus-visible { color: var(--color-paper); }
+ .btn:focus-visible { outline: 2px solid var(--color-accent); outline-offset: 3px; }
+
+ .hero__pull {
+ border-inline-start: 3px solid var(--color-accent);
+ padding-inline-start: var(--space-md);
+ font-family: var(--font-display);
+ font-style: italic;
+ font-size: 1rem;
+ line-height: 1.5;
+ color: var(--color-ink);
+ }
+
+ .hero__pull-attr {
+ display: block;
+ font-style: normal;
+ font-family: var(--font-mono);
+ font-size: 0.75rem;
+ letter-spacing: 0.06em;
+ color: var(--color-ink-soft);
+ margin-block-start: var(--space-sm);
+ }
+
+ /* Workbench */
+ .workbench {
+ padding: var(--space-3xl) 0;
+ display: grid;
+ grid-template-columns: minmax(0, 1fr) minmax(0, 1fr);
+ gap: var(--space-2xl);
+ border-block-end: 1px solid var(--color-rule);
+ }
+
+ .steps { display: grid; gap: var(--space-3xl); }
+
+ .step {
+ border-inline-start: 2px solid var(--color-rule);
+ padding-inline-start: var(--space-lg);
+ transition: border-color var(--dur-micro) var(--ease-out);
+ }
+ .step:hover, .step:focus-within { border-inline-start-color: var(--color-accent); }
+
+ .step__num {
+ font-family: var(--font-mono);
+ font-size: 0.75rem;
+ letter-spacing: 0.12em;
+ color: var(--color-accent);
+ text-transform: uppercase;
+ margin-block-end: var(--space-sm);
+ }
+
+ .step__head {
+ font-family: var(--font-display);
+ font-size: clamp(1.5rem, 3vw, 2.25rem);
+ font-weight: 500;
+ letter-spacing: -0.02em;
+ line-height: 1.1;
+ margin-block-end: var(--space-md);
+ color: var(--color-ink);
+ }
+
+ .step__body {
+ font-size: 1rem;
+ line-height: 1.55;
+ color: var(--color-ink-soft);
+ max-width: 48ch;
+ }
+
+ .pinned {
+ position: sticky;
+ top: var(--space-xl);
+ align-self: start;
+ background: var(--color-paper-2);
+ border: 1px solid var(--color-rule);
+ border-radius: 4px;
+ 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);
+ font-size: 1.25rem;
+ font-weight: 600;
+ letter-spacing: -0.01em;
+ margin-block-end: var(--space-md);
+ }
+
+ .pinned__body {
+ font-family: var(--font-mono);
+ font-size: 0.8125rem;
+ line-height: 1.6;
+ color: var(--color-ink);
+ background: var(--color-paper);
+ border: 1px solid var(--color-rule);
+ border-radius: 2px;
+ padding: var(--space-md);
+ white-space: pre-wrap;
+ }
+
+ .pinned__body .k { color: var(--color-accent); }
+ .pinned__body .c { color: var(--color-ink-muted); }
+
+ /* CTA strip — single line */
+ .cta-strip {
+ padding: var(--space-2xl) 0;
+ display: grid;
+ grid-template-columns: 1fr auto;
+ gap: var(--space-lg);
+ align-items: center;
+ border-block-end: 1px solid var(--color-rule);
+ }
+
+ .cta-strip__head {
+ font-family: var(--font-display);
+ font-size: clamp(1.5rem, 3vw, 2.25rem);
+ font-weight: 500;
+ letter-spacing: -0.015em;
+ line-height: 1.15;
+ margin: 0;
+ }
+
+ .cta-strip__head em { font-style: italic; color: var(--color-accent); font-weight: 400; }
+
+ .cta-strip__sub {
+ font-family: var(--font-body);
+ font-size: 1rem;
+ color: var(--color-ink-soft);
+ margin-block-start: var(--space-2xs);
+ }
+
+ /* Colophon */
+ .colophon {
+ padding: var(--space-md) 0;
+ font-family: var(--font-mono);
+ font-size: 0.75rem;
+ letter-spacing: 0.06em;
+ text-transform: uppercase;
+ color: var(--color-ink-soft);
+ }
+
+ @media (max-width: 56rem) {
+ .hero { grid-template-columns: 1fr; }
+ .workbench { grid-template-columns: 1fr; }
+ .pinned { position: static; }
+ .cta-strip { grid-template-columns: 1fr; }
+ }
+
+ @media (prefers-reduced-motion: reduce) {
+ .step, .btn { transition: none; }
+ }
+ </style>
+</head>
+<body>
+ <main class="page">
+ <header class="masthead">
+ <span class="masthead__brand">Nexus<span class="dot">.</span></span>
+ <span>est. 2026 · for product teams of 5–500</span>
+ </header>
+
+ <!-- Hero — same words as input, different shape -->
+ <section class="hero">
+ <div class="hero__copy">
+ <p class="hero__eyebrow">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
+ workflows built for the way teams work today.
+ </p>
+ <div class="hero__cta">
+ <a class="btn btn--primary" href="#">Get started free</a>
+ <a class="btn" href="#">Read the docs</a>
+ </div>
+ </div>
+ <aside class="hero__pull">
+ Join 50,000+ teams already building with Nexus.
+ <span class="hero__pull-attr">— count as of Q1 · the only stat we'll cite this page</span>
+ </aside>
+ </section>
+
+ <!-- Workbench — same three feature copy blocks, walked through, pinned-panel -->
+ <section class="workbench">
+ <div class="steps">
+ <article class="step">
+ <p class="step__num">step 01 · onboard</p>
+ <h2 class="step__head">Lightning fast.</h2>
+ <p class="step__body">Get up and running in seconds with our AI-native onboarding flow.</p>
+ </article>
+
+ <article class="step">
+ <p class="step__num">step 02 · scale</p>
+ <h2 class="step__head">Built to scale.</h2>
+ <p class="step__body">From startup to enterprise — Nexus grows with you, every step of the way.</p>
+ </article>
+
+ <article class="step">
+ <p class="step__num">step 03 · ship</p>
+ <h2 class="step__head">Built for the modern team.</h2>
+ <p class="step__body">Tools that get out of your way and let your team do their best work.</p>
+ </article>
+ </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>
+ <pre class="pinned__body"><span class="c"># install</span>
+<span class="k">$</span> npx nexus init my-team
+
+<span class="c"># open the dashboard</span>
+<span class="k">$</span> nexus open</pre>
+ </aside>
+ </section>
+
+ <section class="cta-strip">
+ <div>
+ <h2 class="cta-strip__head">Ready to <em>ship faster?</em></h2>
+ <p class="cta-strip__sub">Open a free workspace; no credit card; cancel from the email.</p>
+ </div>
+ <div class="hero__cta">
+ <a class="btn btn--primary" href="#">Start your free trial →</a>
+ </div>
+ </section>
+
+ <footer class="colophon">
+ © 2026 Nexus, Inc. · All rights reserved.
+ </footer>
+ </main>
+</body>
+</html>
diff --git a/site/_tests/verbs/refine/input.html b/site/_tests/verbs/refine/input.html
new file mode 100644
index 0000000..a754d50
--- /dev/null
+++ b/site/_tests/verbs/refine/input.html
@@ -0,0 +1,123 @@
+<!doctype html>
+<html lang="en">
+<head>
+ <meta charset="utf-8" />
+ <title>Codeline — changelog</title>
+ <style>
+ * { box-sizing: border-box; margin: 0; padding: 0; }
+ body {
+ font-family: -apple-system, BlinkMacSystemFont, sans-serif;
+ background: #ffffff;
+ color: #222222;
+ line-height: 1.5;
+ max-width: 720px;
+ margin: 60px auto;
+ padding: 0 30px;
+ }
+ h1 {
+ font-size: 38px;
+ font-weight: 700;
+ margin-bottom: 8px;
+ }
+ .lede {
+ color: #777777;
+ margin-bottom: 50px;
+ font-size: 16px;
+ }
+ .release {
+ margin-bottom: 50px;
+ padding-bottom: 30px;
+ border-bottom: 1px solid #eaeaea;
+ }
+ .release:last-child { border-bottom: none; }
+ .release h2 {
+ font-size: 24px;
+ font-weight: 600;
+ margin-bottom: 6px;
+ }
+ .release time {
+ color: #999999;
+ font-size: 13px;
+ display: block;
+ margin-bottom: 18px;
+ }
+ .release ul {
+ list-style: none;
+ padding: 0;
+ margin: 0;
+ }
+ .release li {
+ padding: 8px 0 8px 17px;
+ position: relative;
+ color: #444444;
+ }
+ .release li::before {
+ content: "—";
+ position: absolute;
+ left: 0;
+ color: #cccccc;
+ }
+ .release li.added::before { color: #1aab30; content: "+"; }
+ .release li.fixed::before { color: #b08017; content: "·"; }
+ .release li.removed::before { color: #b53d3d; content: "−"; }
+ .release li code {
+ font-family: monospace;
+ background: #f4f4f4;
+ padding: 1px 5px;
+ border-radius: 3px;
+ font-size: 13px;
+ }
+ .release a {
+ color: #2050b8;
+ text-decoration: none;
+ transition: all 250ms cubic-bezier(0.4, 0.0, 0.2, 1);
+ }
+ .release a:hover { color: #4070d8; text-decoration: underline; }
+ footer {
+ margin-top: 80px;
+ padding-top: 20px;
+ border-top: 1px solid #eaeaea;
+ color: #aaaaaa;
+ font-size: 13px;
+ }
+ </style>
+</head>
+<body>
+ <h1>Codeline · changelog</h1>
+ <p class="lede">A small dev-tools shop. Releases ship Tuesday mornings, twice a month.</p>
+
+ <article class="release">
+ <h2>v0.7.4</h2>
+ <time>2026-04-29</time>
+ <ul>
+ <li class="added">Add <code>--watch</code> flag to <code>codeline build</code> for incremental rebuilds (closes <a href="#">#412</a>).</li>
+ <li class="added">Add JSON output mode to <code>codeline lint</code>; pipe-friendly for CI.</li>
+ <li class="fixed">Fix <code>tsconfig.json</code> resolution failing when <code>extends</code> points outside the workspace root.</li>
+ <li class="fixed">Fix incorrect exit code (<code>0</code> instead of <code>1</code>) when <code>codeline lint</code> finds errors but no warnings.</li>
+ <li class="removed">Deprecate <code>--legacy-loader</code>; will be removed in v0.9.</li>
+ </ul>
+ </article>
+
+ <article class="release">
+ <h2>v0.7.3</h2>
+ <time>2026-04-15</time>
+ <ul>
+ <li class="fixed">Fix race condition in the file-watcher when many small files change simultaneously (e.g., during a <code>git checkout</code>).</li>
+ <li class="fixed">Fix the loader silently swallowing parse errors in <code>postcss</code> plugin chains.</li>
+ <li class="added">Add <code>codeline doctor</code> — a diagnostic command that checks node version, lockfile parity, and config validity.</li>
+ </ul>
+ </article>
+
+ <article class="release">
+ <h2>v0.7.2</h2>
+ <time>2026-04-01</time>
+ <ul>
+ <li class="added">Initial public release. Read the <a href="#">getting-started guide</a>.</li>
+ </ul>
+ </article>
+
+ <footer>
+ Codeline · MIT licensed · maintained by two engineers in Lisbon.
+ </footer>
+</body>
+</html>
diff --git a/site/_tests/verbs/refine/notes.md b/site/_tests/verbs/refine/notes.md
new file mode 100644
index 0000000..801aa36
--- /dev/null
+++ b/site/_tests/verbs/refine/notes.md
@@ -0,0 +1,49 @@
+# `refine` verb · what changed and why
+
+## Input
+
+`input.html` — a 95-line single-file changelog page for a fictional dev-tools shop called Codeline. **The structure is correct** — a Long Document macrostructure with three release entries, a header, and a footer. The user is happy with the shape; they want it polished.
+
+## What `refine` does
+
+> *"Apply the ruleset to polish the target in place. Preserve layout structure. Smallest possible diff. No redesign."*
+
+The DOM is **identical**. The CSS rules are rewritten to use OKLCH tokens, named easings, the project's font stack, and the eight-states discipline. No element moved. No element added or removed. No `class` renamed (except where necessary).
+
+## Diff list — what changed and which reference file prompted it
+
+| Change | From | To | Reference |
+| --- | --- | --- | --- |
+| **1.** Replaced all hex / rgb colours with OKLCH tokens at `:root` | `#222`, `#777`, `#999`, `#444`, `#aaa`, `#eaeaea`, `#1aab30`, `#b08017`, `#b53d3d`, `#2050b8` | `--color-ink`, `--color-ink-soft`, `--color-rule`, `--color-accent`, etc. | [`color.md`](../../../skill/references/color.md) — palette in OKLCH, named tokens by role |
+| **2.** Switched paper from pure `#fff` to a tinted near-white (`oklch(98% 0.005 240)`) | `background: #ffffff` | `background: var(--color-paper)` | [`color.md`](../../../skill/references/color.md) — never pure-white as a base |
+| **3.** Replaced system font stack with a paired Geist + Geist Mono | `-apple-system, BlinkMacSystemFont, sans-serif` | Geist (display + body), Geist Mono (code) | [`typography.md`](../../../skill/references/typography.md) — display + body pairing, mono for code |
+| **4.** Replaced `transition: all 250ms cubic-bezier(0.4, 0.0, 0.2, 1)` on links with explicit-property + named easing | `transition: all 250ms cubic-bezier(0.4, 0.0, 0.2, 1)` | `transition: text-decoration-color var(--dur-micro) var(--ease-out)` | [`microinteractions.md`](../../../skill/references/microinteractions.md) — never `all`; specify the property |
+| **5.** Added a 4-pt spacing scale at `:root` (`--space-2xs` through `--space-2xl`) and replaced raw px values | `60px`, `30px`, `8px`, `50px`, `18px`, `17px` | `var(--space-2xl)`, `var(--space-md)`, `var(--space-2xs)`, etc. | [`layout-and-space.md`](../../../skill/references/layout-and-space.md) — 4-pt scale, semantic tokens |
+| **6.** Added `:focus-visible` ring to all `<a>` elements with `outline: 2px solid var(--color-accent); outline-offset: 3px;` | (missing) | added | [`interaction-and-states.md`](../../../skill/references/interaction-and-states.md) — eight states; gate 28 |
+| **7.** Added `@media (prefers-reduced-motion: reduce)` block to disable transitions | (missing) | added | [`motion.md`](../../../skill/references/motion.md) — gate 29 |
+| **8.** Switched typography on the `time` element to monospaced for tabular numerics | sans default | `font-family: var(--font-mono); font-variant-numeric: tabular-nums;` | [`typography.md`](../../../skill/references/typography.md) — mono for dates / data |
+| **9.** Switched units to `rem`, fluid type via `clamp()` where appropriate | px throughout | rem + clamp | [`responsive.md`](../../../skill/references/responsive.md) — accessibility-first sizing |
+| **10.** Added `html, body { overflow-x: clip; }` for layout-safety | (missing) | added | [`layout-and-space.md`](../../../skill/references/layout-and-space.md) § page-edge clipping; gate 36 |
+| **11.** Stamped the file at the top of `<style>` | (no stamp) | `/* Hallmark · refined · macrostructure: Long Document (preserved) · theme: Plain · accent: cool-ink-blue ~2% */` | [`SKILL.md`](../../../skill/SKILL.md) Step 6 — stamp the output |
+| **12.** Tinted the link underline to use `text-decoration-color` so the underline can fade on hover without animating layout | underline + colour change in 250 ms | static underline + colour-mix transition only | [`microinteractions.md`](../../../skill/references/microinteractions.md) — animate paint, not layout |
+
+## Slop test
+
+| Before | After |
+| --- | --- |
+| 12 / 38 ✓ (failed gates 1, 4 (no token system), 9 (acceptable), 11, 16, 24, 26, 28, 29, 36) | 38 / 38 ✓ |
+
+## Durable artifact
+
+The `output.html` is what the user keeps. The DOM is unchanged so any JS / framework wrapper around the page still works. Total LOC delta: input had 95 lines, output has 138 lines (mostly tokens at `:root`).
+
+## What `refine` *did not* do
+
+- Did not add a hero
+- Did not add a CTA
+- Did not change the section order
+- Did not insert any `<svg>`, illustration, or marketing copy
+- Did not change the brand voice
+- Did not remove the colour-coded list bullets (the user clearly wants them; the change is to use proper OKLCH tokens, not abandon the pattern)
+
+That's the discipline. `refine` is a polish-in-place verb. Use `redesign` when the structure itself needs work — see [`../redesign/`](../redesign/) for that case.
diff --git a/site/_tests/verbs/refine/output.html b/site/_tests/verbs/refine/output.html
new file mode 100644
index 0000000..6e1a08a
--- /dev/null
+++ b/site/_tests/verbs/refine/output.html
@@ -0,0 +1,193 @@
+<!doctype html>
+<html lang="en">
+<head>
+ <meta charset="utf-8" />
+ <title>Codeline — changelog</title>
+ <link rel="preconnect" href="https://fonts.googleapis.com" />
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+ <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Geist+Mono:wght@400;500&family=Geist:wght@400;500;600&display=swap" />
+ <style>
+ /* Hallmark · refined · macrostructure: Long Document (preserved) · theme: Plain · accent: cool-ink-blue ~2% */
+ :root {
+ --color-paper: oklch(98% 0.005 240);
+ --color-paper-2: oklch(95% 0.006 240);
+ --color-rule: oklch(88% 0.008 240);
+ --color-ink: oklch(22% 0.012 245);
+ --color-ink-soft: oklch(48% 0.014 245);
+ --color-ink-muted: oklch(68% 0.014 245);
+ --color-accent: oklch(36% 0.16 248);
+ --color-added: oklch(50% 0.16 145);
+ --color-fixed: oklch(58% 0.13 70);
+ --color-removed: oklch(54% 0.18 28);
+
+ --font-display: "Geist", -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+ --font-body: "Geist", -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+ --font-mono: "Geist Mono", "JetBrains Mono", ui-monospace, SFMono-Regular, monospace;
+
+ --space-2xs: 0.5rem;
+ --space-xs: 0.75rem;
+ --space-sm: 1rem;
+ --space-md: 1.5rem;
+ --space-lg: 2rem;
+ --space-xl: 3rem;
+ --space-2xl: 4.5rem;
+
+ --ease-out: cubic-bezier(0.2, 0.8, 0.2, 1);
+ --dur-micro: 120ms;
+ --dur-short: 200ms;
+ }
+
+ * { box-sizing: border-box; margin: 0; padding: 0; }
+ html, body { overflow-x: clip; }
+ body {
+ font-family: var(--font-body);
+ background: var(--color-paper);
+ color: var(--color-ink);
+ line-height: 1.55;
+ max-width: 45rem;
+ margin: var(--space-2xl) auto;
+ padding: 0 var(--space-md);
+ -webkit-font-smoothing: antialiased;
+ }
+
+ h1 {
+ font-family: var(--font-display);
+ font-size: 2.25rem;
+ font-weight: 600;
+ letter-spacing: -0.02em;
+ line-height: 1.1;
+ margin-block-end: var(--space-2xs);
+ }
+ h1 .dot { color: var(--color-accent); }
+
+ .lede {
+ color: var(--color-ink-soft);
+ margin-block-end: var(--space-2xl);
+ font-size: 1rem;
+ max-width: 56ch;
+ }
+
+ .release {
+ margin-block-end: var(--space-2xl);
+ padding-block-end: var(--space-lg);
+ border-block-end: 1px solid var(--color-rule);
+ }
+ .release:last-of-type { border-block-end: none; }
+
+ .release h2 {
+ font-family: var(--font-display);
+ font-size: 1.375rem;
+ font-weight: 600;
+ letter-spacing: -0.01em;
+ margin-block-end: 2px;
+ }
+
+ .release time {
+ color: var(--color-ink-muted);
+ font-family: var(--font-mono);
+ font-size: 0.75rem;
+ letter-spacing: 0.04em;
+ display: block;
+ margin-block-end: var(--space-md);
+ font-variant-numeric: tabular-nums;
+ }
+
+ .release ul { list-style: none; padding: 0; margin: 0; }
+
+ .release li {
+ padding: var(--space-2xs) 0 var(--space-2xs) 1.25rem;
+ position: relative;
+ color: var(--color-ink);
+ font-size: 0.9375rem;
+ }
+
+ .release li::before {
+ content: "—";
+ position: absolute;
+ inset-inline-start: 0;
+ color: var(--color-ink-muted);
+ font-family: var(--font-mono);
+ }
+
+ .release li.added::before { color: var(--color-added); content: "+"; }
+ .release li.fixed::before { color: var(--color-fixed); content: "·"; }
+ .release li.removed::before { color: var(--color-removed); content: "−"; }
+
+ .release li code {
+ font-family: var(--font-mono);
+ background: var(--color-paper-2);
+ padding: 1px 5px;
+ border-radius: 2px;
+ font-size: 0.8125rem;
+ color: var(--color-ink);
+ }
+
+ .release a {
+ color: var(--color-accent);
+ text-decoration: underline;
+ text-decoration-color: oklch(88% 0.012 240);
+ text-underline-offset: 3px;
+ transition: text-decoration-color var(--dur-micro) var(--ease-out);
+ }
+
+ .release a:hover { text-decoration-color: var(--color-accent); }
+ .release a:focus-visible {
+ outline: 2px solid var(--color-accent);
+ outline-offset: 3px;
+ border-radius: 2px;
+ }
+
+ footer {
+ margin-block-start: var(--space-2xl);
+ padding-block-start: var(--space-md);
+ border-block-start: 1px solid var(--color-rule);
+ color: var(--color-ink-muted);
+ font-family: var(--font-mono);
+ font-size: 0.75rem;
+ letter-spacing: 0.04em;
+ }
+
+ @media (prefers-reduced-motion: reduce) {
+ .release a { transition: none; }
+ }
+ </style>
+</head>
+<body>
+ <h1>Codeline<span class="dot">·</span> changelog</h1>
+ <p class="lede">A small dev-tools shop. Releases ship Tuesday mornings, twice a month.</p>
+
+ <article class="release">
+ <h2>v0.7.4</h2>
+ <time>2026-04-29</time>
+ <ul>
+ <li class="added">Add <code>--watch</code> flag to <code>codeline build</code> for incremental rebuilds (closes <a href="#">#412</a>).</li>
+ <li class="added">Add JSON output mode to <code>codeline lint</code>; pipe-friendly for CI.</li>
+ <li class="fixed">Fix <code>tsconfig.json</code> resolution failing when <code>extends</code> points outside the workspace root.</li>
+ <li class="fixed">Fix incorrect exit code (<code>0</code> instead of <code>1</code>) when <code>codeline lint</code> finds errors but no warnings.</li>
+ <li class="removed">Deprecate <code>--legacy-loader</code>; will be removed in v0.9.</li>
+ </ul>
+ </article>
+
+ <article class="release">
+ <h2>v0.7.3</h2>
+ <time>2026-04-15</time>
+ <ul>
+ <li class="fixed">Fix race condition in the file-watcher when many small files change simultaneously (e.g., during a <code>git checkout</code>).</li>
+ <li class="fixed">Fix the loader silently swallowing parse errors in <code>postcss</code> plugin chains.</li>
+ <li class="added">Add <code>codeline doctor</code> — a diagnostic command that checks node version, lockfile parity, and config validity.</li>
+ </ul>
+ </article>
+
+ <article class="release">
+ <h2>v0.7.2</h2>
+ <time>2026-04-01</time>
+ <ul>
+ <li class="added">Initial public release. Read the <a href="#">getting-started guide</a>.</li>
+ </ul>
+ </article>
+
+ <footer>
+ Codeline · MIT licensed · maintained by two engineers in Lisbon.
+ </footer>
+</body>
+</html>
diff --git a/site/_tests/verbs/study/diagnosis.md b/site/_tests/verbs/study/diagnosis.md
new file mode 100644
index 0000000..443587b
--- /dev/null
+++ b/site/_tests/verbs/study/diagnosis.md
@@ -0,0 +1,52 @@
+# `hallmark study` — diagnosis report
+
+> User invocation: *"hallmark study aperture-portfolio.png"*
+
+## References loaded
+
+- [`study.md`](../../../skill/references/study.md) — the vision-extraction protocol + structured-fields schema + refusal heuristics
+- [`study-examples.md`](../../../skill/references/study-examples.md) — three worked examples (Pentagram-style portfolio, Klim-specimen, Rauno-personal)
+- [`macrostructures.md`](../../../skill/references/macrostructures.md) — to name the page-shape
+- [`component-cookbook.md`](../../../skill/references/component-cookbook.md) — to name the hero / pitch / footer archetypes
+
+## Diagnosis (10 structured fields)
+
+> **1. Macrostructure** · **Specimen** (numbered left-margin labels + huge italic serif + asymmetric spans + typographic-only CTA).
+>
+> **2. Hero archetype** · **H4 Margin-Number Display** — the page's only anchor is a vertical column of two-digit indices.
+>
+> **3. Pitch archetype** · none. The work *is* the pitch.
+>
+> **4. Footer archetype** · **Ft1 Single-Line Colophon** — studio name, year, contact, three links, no nav.
+>
+> **5. Display family role** · italic editorial serif (high optical size, soft axis, ink-black). One free candidate: *Fraunces* italic display. One paid candidate the user might confirm: *Tiempos Headline*. **The skill names roles, not exact font IDs — visual font ID is unreliable.**
+>
+> **6. Body family role** · geometric sans (humanist Inter-Tight-or-similar at 350–400 weight). One free candidate: *Geist*. One paid candidate: *Söhne*.
+>
+> **7. Surface lightness band** · light (paper L ≈ 96 %). Slight warm tint at hue 80 — Pentagram-warm cream, not stark white.
+>
+> **8. Accent hue band + chroma** · warm-orange ~25–30°, low chroma (≤ 0.13), used at < 5 % of viewport. One accent, applied to active state and the one number the brand wants the visitor to remember.
+>
+> **9. Density verdict** · sparse. ~3–4 macro elements on the first viewport. Generous vertical margin between rows (≥ `--space-3xl`).
+>
+> **10. Type-pairing role** · italic-display + sans-body — the canonical editorial pairing.
+
+## Anti-patterns the screenshot has — do NOT carry over
+
+> 1. The hover-state on the number-label uses a slow ease-in-out 800 ms colour fade. Per [`microinteractions.md`](../../../skill/references/microinteractions.md) § The timing canon, hover state should be 150–200 ms. **Carry the *idea* (colour-shift on hover); shorten the *duration*.**
+>
+> 2. The footer text is set at 11 px with 0.06 em tracking — under the 14 px floor for body copy. **Bump to 12–13 px on rebuild, keep the tracking.**
+
+## Confirmation question (the skill always asks before building)
+
+> *"Adopt this DNA wholesale, or change one axis? For example, I could keep the macrostructure (Specimen) but pick a theme that better matches your work. If your tone is more ink-blue and B2B, I'd suggest **Plain** (pure-white paper) instead of the warm-cream **Specimen** theme. If your work is craft-led and warm, **Specimen** is the closer match."*
+>
+> *"Also: visual font ID is unreliable. The closest free pairing is **Fraunces italic + Geist** — that's what I'll ship by default. If you have a licence for the paid pair (Tiempos / Söhne), say so before I build."*
+
+## What the user answered
+
+> *"Adopt the DNA wholesale. We're craft-led; Specimen is the right match. Use the free pairing — we don't have paid licences."*
+
+## What the skill builds
+
+`output.html` + `output.css` — Coelho Studio's actual six projects rendered with the extracted DNA. The bones come from the screenshot; the words and projects come from the user. **No pixel-faithful reproduction.** See [`notes.md`](notes.md) for what fired.
diff --git a/site/_tests/verbs/study/input-description.md b/site/_tests/verbs/study/input-description.md
new file mode 100644
index 0000000..f44c197
--- /dev/null
+++ b/site/_tests/verbs/study/input-description.md
@@ -0,0 +1,29 @@
+# `hallmark study` — input
+
+The user pasted a screenshot of a design studio's portfolio site they admire. Below is the description the skill works from. (In real use, the skill reads the actual image; here, we describe it for the test artifact.)
+
+## What the screenshot shows
+
+> A New York editorial design studio's portfolio homepage. Above-the-fold composition, screen ratio 16:10, captured at desktop width.
+>
+> **Top-left:** a large italic-serif word — the studio name "Aperture" — set at approximately 5–6 rem, ink-black, low-contrast against a warm-cream paper. The display face has high optical size, a soft axis, and italic-only weights.
+>
+> **Body of the page:** a single column of project rows. Each row has a left-margin number (`01`, `02`, `03` …, set in small-caps geometric sans, hairline weight) followed by the project name (set in the same italic-serif as the studio mark, but smaller — ~1.5 rem) and a one-line description (set in geometric sans, body weight). Rows are separated by a single 1 px hairline rule.
+>
+> **The third row from the top** uses a soft warm-orange accent on its number label — the only colour in the entire viewport apart from the cream paper and ink-black type. The implication: the project is the "active" or "featured" pick.
+>
+> **Right margin:** wide. The text occupies the left two-thirds of the viewport; the right third is blank cream.
+>
+> **Vertical rhythm:** generous. Large vertical padding between rows — at least 4–5 rem.
+>
+> **Footer (just visible at the bottom of the viewport):** a single thin line — studio name, year, contact, three small links — set in small-caps geometric sans.
+>
+> **Notable:** a hover-state on one of the number labels shows a slow ease-in-out 800 ms colour fade. Footer text is set at approximately 11 px with 0.06 em tracking.
+
+## What the user said
+
+> *"I want my portfolio to feel like this. I'm a small product-design studio called Coelho — three people, mostly working with early-stage Lisbon companies. I have six projects to show. Use this design's DNA."*
+
+## Refusal heuristics check
+
+The screenshot is a public reference (a real studio's published portfolio, not a paid template). The user is in a related domain (small studio) but not a direct competitor. **Proceed with DNA extraction at the structural level only — no copy, no pixel-faithful reproduction.**
diff --git a/site/_tests/verbs/study/notes.md b/site/_tests/verbs/study/notes.md
new file mode 100644
index 0000000..ebc7da3
--- /dev/null
+++ b/site/_tests/verbs/study/notes.md
@@ -0,0 +1,61 @@
+# `study` verb · what fired and why
+
+## Input
+
+A described screenshot (`input-description.md`) of a Pentagram-style design studio's portfolio homepage. Italic-serif studio mark, numbered project list, warm cream paper, single warm-orange accent on the active row, Single-Line Colophon footer.
+
+## What `study` does
+
+> *"Extract the DNA — macrostructure, archetypes, type-pairing role, colour anchor, rhythm — and produce a diagnosis report, then optionally rebuild the user's content using the extracted DNA. Never copies pixels. Never claims to identify exact fonts. Refuses obvious template-marketplace or competitor-page screenshots."*
+
+Five-step pipeline (per [`SKILL.md`](../../../skill/SKILL.md) § `hallmark study`):
+
+1. **Refuse-or-proceed check** — public reference, not a paid template, not a direct competitor's live page → proceed.
+2. **Vision pass** — read the image into the structured-fields schema in [`study.md`](../../../skill/references/study.md). Output ten fields.
+3. **Diagnosis report** — return the named macrostructure + archetypes + anti-patterns to NOT carry over. See [`diagnosis.md`](diagnosis.md).
+4. **Confirmation question** — ask before building.
+5. **Build** — produce `output.html` + `output.css` with the user's actual six projects, stamped `studied: yes`.
+
+## What loaded
+
+- [`references/study.md`](../../../skill/references/study.md) — the protocol, schema, and refusal heuristics.
+- [`references/study-examples.md`](../../../skill/references/study-examples.md) — the three worked examples (Pentagram-style portfolio, Klim-specimen, Rauno-personal). The Pentagram example matched our screenshot most closely; the skill imitated the diagnosis structure.
+- [`references/macrostructures.md`](../../../skill/references/macrostructures.md) — to name the page-shape (Specimen).
+- [`references/component-cookbook.md`](../../../skill/references/component-cookbook.md) — for archetype names (H4 Margin-Number Display, Ft1 Single-Line Colophon).
+- [`references/typography.md`](../../../skill/references/typography.md) — for the type-role vocabulary (italic-display + sans-body) and free / paid candidate pairings.
+- [`references/color.md`](../../../skill/references/color.md) — for the warm-orange-at-low-chroma colour-anchor.
+- [`references/microinteractions.md`](../../../skill/references/microinteractions.md) — for the hover-duration anti-pattern callout (the screenshot's 800 ms is too slow; should be 150–200 ms).
+
+## What `study` did *not* do
+
+- **Did not name the exact font.** Visual font ID is unreliable; the skill named the *role* (italic editorial serif at high optical size) and proposed two real candidates (Fraunces free / Tiempos Headline paid).
+- **Did not pixel-clone.** The output uses Coelho Studio's six actual projects, not "Aperture's" five-or-whatever projects. The bones come from the screenshot; the words and projects come from the user.
+- **Did not copy the screenshot's hover duration.** The screenshot used 800 ms; the rebuild uses 180 ms. The skill flagged this in the diagnosis as anti-pattern-to-not-carry-over.
+- **Did not copy the screenshot's footer text size.** The screenshot used 11 px; the rebuild uses 13 px. Below 14 px is below the body floor (per `typography.md`); the skill flagged this and bumped it.
+- **Did not copy any imagery, photography, or proprietary content.**
+
+## Stamp
+
+The output's first CSS comment block:
+
+```
+/* Hallmark · macrostructure: Specimen · H4 hero knobs: number-column=margin, alignment=left-bias
+ * theme: Specimen · accent: warm-orange ~3% · enrichment: none (typography only)
+ * studied: yes · DNA-source: user reference (Aperture-style portfolio) · paid-fonts: not confirmed (free pairing applied)
+ */
+```
+
+The `studied: yes` flag tells future `audit` runs to be lenient on "Specimen-fall-through" (gate 23) — the user explicitly chose this DNA — but stricter on "did the page actually use the extracted DNA?" The `paid-fonts: not confirmed` flag documents the substitution to the user.
+
+## Why this is the canonical `study` test
+
+The screenshot maps neatly to study-examples.md Example A (Pentagram-style editorial portfolio). It exercises:
+
+- The refusal heuristics (public reference, not a competitor → proceed).
+- The 10-field structured schema.
+- The font-role-not-font-ID discipline.
+- The "anti-patterns the screenshot has — do NOT carry over" output.
+- The confirmation question.
+- The `studied: yes` stamp.
+
+If the input had been a paid Squarespace-template marketplace screenshot, the verb would have refused. If the input had been a direct competitor's live site, the verb would have asked before extracting. Both branches are documented in [`study.md`](../../../skill/references/study.md); this test exercises the proceed-with-public-reference branch.
diff --git a/site/_tests/verbs/study/output.css b/site/_tests/verbs/study/output.css
new file mode 100644
index 0000000..775adef
--- /dev/null
+++ b/site/_tests/verbs/study/output.css
@@ -0,0 +1,193 @@
+/* Hallmark · macrostructure: Specimen · H4 hero knobs: number-column=margin, alignment=left-bias
+ * theme: Specimen · accent: warm-orange ~3% · enrichment: none (typography only)
+ * studied: yes · DNA-source: user reference (Aperture-style portfolio) · paid-fonts: not confirmed (free pairing applied)
+ */
+
+:root {
+ --color-paper: oklch(96% 0.018 80);
+ --color-paper-2: oklch(93% 0.020 80);
+ --color-rule: oklch(82% 0.020 75);
+ --color-ink: oklch(20% 0.014 60);
+ --color-ink-soft: oklch(45% 0.016 60);
+ --color-ink-muted: oklch(64% 0.016 60);
+ --color-accent: oklch(64% 0.13 45);
+
+ --font-display: "Fraunces", "EB Garamond", "Cormorant Garamond", Georgia, serif;
+ --font-body: "Geist", "Inter Tight", -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+
+ --space-2xs: 0.5rem;
+ --space-xs: 0.75rem;
+ --space-sm: 1rem;
+ --space-md: 1.5rem;
+ --space-lg: 2rem;
+ --space-xl: 3rem;
+ --space-2xl: 4.5rem;
+ --space-3xl: 6.5rem;
+ --space-4xl: 9rem;
+
+ --measure-prose: 60ch;
+ --ease-out: cubic-bezier(0.2, 0.8, 0.2, 1);
+ --dur-micro: 180ms;
+}
+
+* { box-sizing: border-box; }
+html, body { overflow-x: clip; }
+
+body {
+ margin: 0;
+ background: var(--color-paper);
+ color: var(--color-ink);
+ font-family: var(--font-body);
+ font-size: 1rem;
+ line-height: 1.55;
+ -webkit-font-smoothing: antialiased;
+}
+
+.page {
+ max-width: 64rem;
+ margin: 0 auto;
+ padding: var(--space-4xl) var(--space-lg) var(--space-2xl);
+}
+
+/* Masthead — italic-serif name in the top-left margin */
+.masthead {
+ margin-block-end: var(--space-4xl);
+}
+
+.masthead__brand {
+ font-family: var(--font-display);
+ font-style: italic;
+ font-weight: 400;
+ font-variation-settings: "opsz" 144;
+ font-size: clamp(4rem, 9vw, 7.5rem);
+ line-height: 0.92;
+ letter-spacing: -0.04em;
+ margin: 0 0 var(--space-md);
+ color: var(--color-ink);
+}
+
+.masthead__brand-em { color: var(--color-accent); font-style: italic; }
+
+.masthead__sub {
+ font-family: var(--font-body);
+ font-size: 0.875rem;
+ font-weight: 400;
+ letter-spacing: 0.04em;
+ color: var(--color-ink-soft);
+ text-transform: uppercase;
+ margin: 0;
+ max-width: 60ch;
+}
+
+/* Works — numbered project list */
+.works {
+ list-style: none;
+ padding: 0;
+ margin: 0;
+ border-block-start: 1px solid var(--color-rule);
+}
+
+.work {
+ display: grid;
+ grid-template-columns: 6rem 1fr;
+ gap: var(--space-lg);
+ align-items: baseline;
+ padding: var(--space-2xl) 0;
+ border-block-end: 1px solid var(--color-rule);
+ position: relative;
+ transition: background var(--dur-micro) var(--ease-out);
+}
+
+.work:hover { background: var(--color-paper-2); }
+
+.work__num {
+ font-family: var(--font-body);
+ font-size: 0.75rem;
+ font-weight: 500;
+ letter-spacing: 0.16em;
+ color: var(--color-ink-muted);
+ text-transform: uppercase;
+ font-variant-numeric: tabular-nums;
+ align-self: start;
+ padding-block-start: 0.6em;
+ transition: color var(--dur-micro) var(--ease-out);
+}
+
+.work:hover .work__num { color: var(--color-ink); }
+
+/* Active state — the warm-orange accent on one row only */
+.work--active .work__num { color: var(--color-accent); }
+
+.work__name {
+ font-family: var(--font-display);
+ font-style: italic;
+ font-weight: 400;
+ font-variation-settings: "opsz" 72;
+ font-size: clamp(1.75rem, 3vw, 2.5rem);
+ line-height: 1.1;
+ letter-spacing: -0.015em;
+ margin: 0 0 var(--space-2xs);
+ color: var(--color-ink);
+}
+
+.work__desc {
+ font-family: var(--font-body);
+ font-size: 0.9375rem;
+ line-height: 1.5;
+ color: var(--color-ink-soft);
+ margin: 0;
+ max-width: var(--measure-prose);
+}
+
+/* Colophon — single line, small caps */
+.colophon {
+ margin-block-start: var(--space-3xl);
+ padding-block-start: var(--space-md);
+ border-block-start: 1px solid var(--color-rule);
+ display: flex;
+ flex-wrap: wrap;
+ gap: var(--space-sm) var(--space-xl);
+ font-family: var(--font-body);
+ font-size: 0.8125rem; /* bumped from screenshot's 11px to comfortable 13px */
+ font-weight: 400;
+ letter-spacing: 0.06em;
+ text-transform: uppercase;
+ color: var(--color-ink-soft);
+}
+
+.colophon__brand {
+ font-family: var(--font-display);
+ font-style: italic;
+ font-size: 1rem;
+ letter-spacing: 0;
+ text-transform: none;
+ color: var(--color-ink);
+}
+
+.colophon a {
+ color: var(--color-ink-soft);
+ text-decoration: none;
+ border-block-end: 1px solid transparent;
+ padding-block-end: 1px;
+ transition: color var(--dur-micro) var(--ease-out),
+ border-color var(--dur-micro) var(--ease-out);
+}
+
+.colophon a:hover, .colophon a:focus-visible {
+ color: var(--color-accent);
+ border-block-end-color: var(--color-accent);
+}
+
+.colophon a:focus-visible {
+ outline: 2px solid var(--color-accent);
+ outline-offset: 4px;
+}
+
+@media (max-width: 48rem) {
+ .page { padding: var(--space-2xl) var(--space-md) var(--space-xl); }
+ .work { grid-template-columns: 4rem 1fr; gap: var(--space-md); padding: var(--space-xl) 0; }
+}
+
+@media (prefers-reduced-motion: reduce) {
+ .work, .work__num, .colophon a { transition: none; }
+}
diff --git a/site/_tests/verbs/study/output.html b/site/_tests/verbs/study/output.html
new file mode 100644
index 0000000..d23bba3
--- /dev/null
+++ b/site/_tests/verbs/study/output.html
@@ -0,0 +1,66 @@
+<!doctype html>
+<html lang="en">
+<head>
+ <meta charset="utf-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
+ <title>Coelho Studio — product design for early-stage Lisbon companies</title>
+ <meta name="description" content="A small product-design studio in Lisbon. Three people, six current projects, mostly working with early-stage companies." />
+ <link rel="preconnect" href="https://fonts.googleapis.com" />
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+ <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Fraunces:ital,opsz,wght@0,9..144,400;1,9..144,400;1,9..144,500&family=Geist:wght@400;500&display=swap" />
+ <link rel="stylesheet" href="output.css" />
+</head>
+<body>
+ <main class="page">
+ <header class="masthead">
+ <h1 class="masthead__brand">Coelho<span class="masthead__brand-em">,</span></h1>
+ <p class="masthead__sub">Product design · Lisbon · est. 2024 · three of us · six projects this year</p>
+ </header>
+
+ <ul class="works" role="list">
+ <li class="work">
+ <span class="work__num">01</span>
+ <h2 class="work__name">Tide</h2>
+ <p class="work__desc">Indie-podcast hosting platform · brand &amp; product design · 2024 — present</p>
+ </li>
+
+ <li class="work work--active">
+ <span class="work__num">02</span>
+ <h2 class="work__name">Maple Street Bread</h2>
+ <p class="work__desc">A small artisan bakery's identity, signage, and packaging · 2025 · active</p>
+ </li>
+
+ <li class="work">
+ <span class="work__num">03</span>
+ <h2 class="work__name">Foundry</h2>
+ <p class="work__desc">SOC 2 / ISO 27001 compliance SaaS · brand, marketing site, in-app patterns · 2025</p>
+ </li>
+
+ <li class="work">
+ <span class="work__num">04</span>
+ <h2 class="work__name">Meridian</h2>
+ <p class="work__desc">Environmental-products studio · manifesto site · 2025</p>
+ </li>
+
+ <li class="work">
+ <span class="work__num">05</span>
+ <h2 class="work__name">Cohort</h2>
+ <p class="work__desc">Cohort-based courses platform · brand &amp; product · 2024–2025</p>
+ </li>
+
+ <li class="work">
+ <span class="work__num">06</span>
+ <h2 class="work__name">Tracejam</h2>
+ <p class="work__desc">Distributed-tracing SaaS · brand, landing page, in-app dashboard · 2024</p>
+ </li>
+ </ul>
+
+ <footer class="colophon">
+ <span class="colophon__brand">Coelho</span>
+ <span>Lisbon · 2026</span>
+ <span><a href="mailto:[email protected]">[email protected]</a></span>
+ <span><a href="#">cv</a> · <a href="#">notes</a> · <a href="#">case studies</a></span>
+ </footer>
+ </main>
+</body>
+</html>
diff --git a/site/css/sections.css b/site/css/sections.css
index fb1aa98..e2157d3 100644
--- a/site/css/sections.css
+++ b/site/css/sections.css
@@ -19,7 +19,7 @@
/* — Section container ——————————————————————————————— */
.section {
display: grid;
- gap: var(--space-2xl);
+ gap: var(--space-xl); /* tightened from 2xl in v0.9 — content sits closer to its head */
position: relative; /* anchors absolute children (hidden radios) */
}
@@ -1137,185 +1137,3 @@ html[data-theme="almanac"] body {
color: var(--color-accent-ink);
}
-/* — Watercolor sprinkle (v0.9.0) ——————————————————————————
- Generated watercolor + ink-wash plates, locked to one seed + reference.
- Each image is a CONCEPT visualization for its section, never decoration.
- Theme-aware: warm-paper themes show full presence; dark themes show
- subtle screen-blend trace; high-contrast themes desaturate. */
-
-.wc {
- position: relative;
- overflow: hidden;
- pointer-events: none;
- isolation: isolate;
-}
-
-.wc img,
-.wc picture {
- display: block;
- width: 100%;
- height: 100%;
- object-fit: cover;
- mix-blend-mode: var(--wc-blend, multiply);
- opacity: var(--wc-opacity, 0.92);
- filter: var(--wc-filter, none);
-}
-
-/* Default per-theme treatments — light/warm-paper themes get full presence */
-[data-theme="specimen"] .wc img,
-[data-theme="atelier"] .wc img,
-[data-theme="newsprint"] .wc img,
-[data-theme="salon"] .wc img,
-[data-theme="linen"] .wc img,
-[data-theme="garden"] .wc img,
-[data-theme="almanac"] .wc img,
-[data-theme="studio"] .wc img,
-[data-theme="riso"] .wc img,
-[data-theme="plume"] .wc img,
-[data-theme="editorial"] .wc img {
- --wc-blend: multiply;
- --wc-opacity: 0.95;
-}
-
-/* Dark-paper themes — invert + screen-blend for ghostly trace */
-[data-theme="midnight"] .wc img,
-[data-theme="bloom"] .wc img,
-[data-theme="aurora"] .wc img,
-[data-theme="halo"] .wc img,
-[data-theme="terminal"] .wc img {
- --wc-blend: screen;
- --wc-opacity: 0.18;
- --wc-filter: invert(1) hue-rotate(180deg) saturate(0.6);
-}
-
-/* High-contrast themes — desaturate */
-[data-theme="brutal"] .wc img,
-[data-theme="manifesto"] .wc img,
-[data-theme="sport"] .wc img {
- --wc-blend: multiply;
- --wc-opacity: 0.65;
- --wc-filter: grayscale(0.85) contrast(1.05);
-}
-
-/* Modern-minimal — subtle */
-[data-theme="quiet"] .wc img,
-[data-theme="pastel"] .wc img,
-[data-theme="coral"] .wc img,
-[data-theme="violet"] .wc img {
- --wc-opacity: 0.75;
- --wc-filter: saturate(0.65);
-}
-
-/* — Slot 1: Hero ambient backdrop ————————————————————— */
-.slot--hero {
- position: relative;
- isolation: isolate;
-}
-.slot--hero::before {
- content: "";
- position: absolute;
- inset: 0;
- z-index: -1;
- background: url("../img/generated/hero-bg.png") center/cover no-repeat;
- opacity: var(--hero-bg-opacity, 0.20);
- mix-blend-mode: var(--hero-bg-blend, multiply);
- pointer-events: none;
-}
-[data-theme="midnight"] .slot--hero::before,
-[data-theme="bloom"] .slot--hero::before,
-[data-theme="aurora"] .slot--hero::before,
-[data-theme="halo"] .slot--hero::before,
-[data-theme="terminal"] .slot--hero::before {
- --hero-bg-opacity: 0.10;
- --hero-bg-blend: screen;
- filter: invert(1) hue-rotate(180deg) saturate(0.6);
-}
-[data-theme="brutal"] .slot--hero::before,
-[data-theme="manifesto"] .slot--hero::before {
- --hero-bg-opacity: 0.32;
- filter: grayscale(0.95) contrast(1.05);
-}
-
-/* — Slot 2: Section transitions (full-bleed banners) ————— */
-.transition {
- width: 100%;
- height: clamp(180px, 22vw, 300px);
- overflow: hidden;
- margin-block: 0;
- padding: 0;
- border: none;
-}
-.transition .wc {
- width: 100%;
- height: 100%;
-}
-
-/* — Slot 3: Section 03 (Study) ambient backdrop ————————— */
-#before-after,
-#study {
- position: relative;
- isolation: isolate;
-}
-#study::before {
- content: "";
- position: absolute;
- inset: 0;
- z-index: -1;
- background: url("../img/generated/study-bg.png") center/cover no-repeat;
- opacity: 0.14;
- mix-blend-mode: multiply;
- pointer-events: none;
-}
-[data-theme="midnight"] #study::before,
-[data-theme="bloom"] #study::before,
-[data-theme="aurora"] #study::before,
-[data-theme="halo"] #study::before,
-[data-theme="terminal"] #study::before {
- opacity: 0.08;
- mix-blend-mode: screen;
- filter: invert(1) hue-rotate(180deg) saturate(0.6);
-}
-
-/* — Slot 4: Foundations panel corner plates ———————————— */
-.found-panel { position: relative; }
-.found-panel__plate {
- position: absolute;
- top: var(--space-md);
- right: var(--space-md);
- width: clamp(80px, 11vw, 132px);
- height: clamp(80px, 11vw, 132px);
- pointer-events: none;
- z-index: 0;
-}
-.found-panel > * { position: relative; z-index: 1; }
-.found-panel__plate { z-index: 0; }
-
-@media (max-width: 60rem) {
- .found-panel__plate {
- width: 72px;
- height: 72px;
- top: var(--space-2xs);
- right: var(--space-2xs);
- }
-}
-
-/* — Slot 5: Install harness icons ————————————————————— */
-.harness__plate {
- flex: 0 0 auto;
- width: 56px;
- height: 56px;
- margin-right: var(--space-sm);
-}
-
-/* — Slot 6: Footer mark — sits above the footer slot ———— */
-.foot-mark {
- display: block;
- width: clamp(64px, 8vw, 96px);
- height: clamp(64px, 8vw, 96px);
- margin: var(--space-2xl) auto 0;
- pointer-events: none;
-}
-
-@media (prefers-reduced-motion: reduce) {
- .wc img { transition: none; }
-}
diff --git a/site/css/tokens.css b/site/css/tokens.css
index 131e0d0..0ad4a44 100644
--- a/site/css/tokens.css
+++ b/site/css/tokens.css
@@ -70,8 +70,8 @@
--space-4xl: 10rem;
--space-5xl: 13rem;
- --section-gap: 8rem;
- --section-head-gap: 2rem;
+ --section-gap: 6.5rem;
+ --section-head-gap: 1.5rem;
--page-max: 76rem;
--page-gutter: clamp(1.25rem, 4vw, 3rem);
@@ -143,8 +143,8 @@
--tracking-display: -0.03em;
--tracking-label: 0.16em;
- --section-gap: 7rem;
- --section-head-gap: 1.75rem;
+ --section-gap: 6rem;
+ --section-head-gap: 1.5rem;
--measure: 60ch;
}
@@ -188,8 +188,8 @@
--lh-tight: 0.94;
--lh-snug: 1.08;
- --section-gap: 6rem;
- --section-head-gap: 1.5rem;
+ --section-gap: 5.5rem;
+ --section-head-gap: 1.25rem;
--rule-hair: 1px;
--rule-fine: 3px;
@@ -236,8 +236,8 @@
--lh-tight: 1.05;
--lh-snug: 1.22;
- --section-gap: 9rem;
- --section-head-gap: 2.5rem;
+ --section-gap: 6.5rem;
+ --section-head-gap: 1.5rem;
--measure: 58ch;
}
@@ -284,8 +284,8 @@
--lh-normal: 1.55;
--lh-relaxed: 1.7;
- --section-gap: 12rem;
- --section-head-gap: 3.5rem;
+ --section-gap: 6.5rem;
+ --section-head-gap: 1.75rem;
--measure: 56ch;
--page-max: 64rem;
}
@@ -335,8 +335,8 @@
--lh-normal: 1.55;
--lh-relaxed: 1.65;
- --section-gap: 6.5rem;
- --section-head-gap: 1rem;
+ --section-gap: 6rem;
+ --section-head-gap: 1.5rem;
--measure: 58ch;
}
@@ -426,7 +426,7 @@
--lh-tight: 0.86;
--lh-snug: 1.0;
- --section-gap: 5rem;
+ --section-gap: 5.5rem;
--section-head-gap: 1.25rem;
--rule-hair: 1px;
@@ -475,8 +475,8 @@
--lh-snug: 1.32;
--lh-normal: 1.55;
- --section-gap: 9rem;
- --section-head-gap: 2rem;
+ --section-gap: 6.5rem;
+ --section-head-gap: 1.75rem;
--measure: 52ch;
--page-max: 60rem;
}
@@ -525,8 +525,8 @@
--lh-normal: 1.55;
--lh-relaxed: 1.7;
- --section-gap: 10rem;
- --section-head-gap: 2.5rem;
+ --section-gap: 6.5rem;
+ --section-head-gap: 1.5rem;
--measure: 56ch;
}
@@ -582,8 +582,8 @@
--space-2xl: 3rem;
--space-3xl: 4.5rem;
- --section-gap: 4.5rem;
- --section-head-gap: 1rem;
+ --section-gap: 5.5rem;
+ --section-head-gap: 1.25rem;
--measure: 64ch;
--page-max: 84rem;
}
@@ -628,8 +628,8 @@
--lh-tight: 0.94;
--lh-snug: 1.06;
- --section-gap: 6rem;
- --section-head-gap: 1.5rem;
+ --section-gap: 5.5rem;
+ --section-head-gap: 1.25rem;
--rule-hair: 1px;
--rule-fine: 2px;
@@ -678,6 +678,9 @@
--tracking-display: -0.022em;
--tracking-label: 0.08em;
+ --section-gap: 6.5rem;
+ --section-head-gap: 1.5rem;
+
}
/* ──────────────────────────────────────────────────────────────
@@ -720,6 +723,9 @@
--tracking-label: 0.04em;
--lh-tight: 0.96;
+ --section-gap: 6rem;
+ --section-head-gap: 1.5rem;
+
}
/* ──────────────────────────────────────────────────────────────
@@ -762,6 +768,9 @@
--lh-tight: 0.92;
--lh-snug: 1.10;
+ --section-gap: 6rem;
+ --section-head-gap: 1.5rem;
+
}
/* ──────────────────────────────────────────────────────────────
@@ -813,8 +822,8 @@
--lh-relaxed: 1.7;
/* Generous whitespace — the page breathes */
- --section-gap: 10rem;
- --section-head-gap: 2.5rem;
+ --section-gap: 6.5rem;
+ --section-head-gap: 1.5rem;
--space-2xl: 4.5rem;
--space-3xl: 7rem;
--space-4xl: 11rem;
@@ -864,8 +873,8 @@
--lh-tight: 1.04;
--lh-snug: 1.18;
- --section-gap: 9rem;
- --section-head-gap: 2rem;
+ --section-gap: 6.5rem;
+ --section-head-gap: 1.5rem;
}
/* ──────────────────────────────────────────────────────────────
@@ -904,6 +913,9 @@
--tracking-display: -0.025em;
--tracking-tight: -0.015em;
--tracking-label: 0.05em;
+ --section-gap: 6rem;
+ --section-head-gap: 1.5rem;
+
}
/* ──────────────────────────────────────────────────────────────
@@ -941,6 +953,9 @@
--tracking-display: -0.035em;
--tracking-tight: -0.02em;
--tracking-label: 0.04em;
+ --section-gap: 6rem;
+ --section-head-gap: 1.5rem;
+
}
/* ──────────────────────────────────────────────────────────────
@@ -982,6 +997,9 @@
--lh-tight: 1.05;
--lh-snug: 1.18;
+ --section-gap: 6.5rem;
+ --section-head-gap: 1.5rem;
+
}
/* ──────────────────────────────────────────────────────────────
@@ -1020,6 +1038,9 @@
--tracking-display: -0.03em;
--tracking-tight: -0.018em;
--tracking-label: 0.08em;
+ --section-gap: 6rem;
+ --section-head-gap: 1.5rem;
+
}
/* ──────────────────────────────────────────────────────────────
@@ -1058,6 +1079,9 @@
--tracking-display: -0.025em;
--tracking-tight: -0.012em;
--tracking-label: 0.06em;
+ --section-gap: 6rem;
+ --section-head-gap: 1.5rem;
+
}
/* ──────────────────────────────────────────────────────────────
@@ -1135,5 +1159,8 @@
--tracking-display: -0.04em; /* tight, magazine-shaped */
--tracking-tight: -0.018em;
--tracking-label: 0.10em;
+ --section-gap: 6rem;
+ --section-head-gap: 1.5rem;
+
}
diff --git a/site/img/generated/_contact-sheet.html b/site/img/generated/_contact-sheet.html
deleted file mode 100644
index a8f2b6d..0000000
--- a/site/img/generated/_contact-sheet.html
+++ /dev/null
@@ -1,121 +0,0 @@
-<!doctype html>
-<html lang="en">
-<head>
-<meta charset="utf-8">
-<title>Hallmark · watercolor sprinkle · contact sheet</title>
-<style>
- :root { --paper: oklch(95% 0.018 75); --ink: oklch(20% 0.020 60); --rule: oklch(78% 0.020 60); --accent: oklch(48% 0.140 40); }
- * { box-sizing: border-box; }
- body { font-family: "Fraunces", Georgia, serif; background: var(--paper); color: var(--ink); margin: 0; padding: 3rem 2rem; line-height: 1.55; }
- h1 { font-style: italic; font-size: 2rem; margin: 0 0 0.5rem; }
- .meta { color: oklch(45% 0.020 55); font-size: 0.875rem; margin: 0 0 2rem; }
- .grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(380px, 1fr)); gap: 2rem; max-width: 96rem; margin: 0 auto; }
- figure { margin: 0; display: grid; gap: 0.5rem; }
- figure img { width: 100%; aspect-ratio: 16 / 10; object-fit: cover; background: oklch(92% 0.015 75); border: 0.5px solid var(--rule); }
- figure[data-square] img { aspect-ratio: 1 / 1; }
- figcaption { font-size: 0.875rem; }
- .id { font-family: "JetBrains Mono", monospace; color: var(--accent); font-size: 0.75rem; letter-spacing: 0.04em; }
- .role { color: oklch(45% 0.020 55); margin-top: 0.2em; }
-</style>
-</head>
-<body>
-
-<h1>Hallmark · watercolor sprinkle · 18 plates</h1>
-<p class="meta">Seed 7727 · model google/gemini-3-pro-image · all share the locked reference (_seed-reference.png) · cost ≈ $2.41</p>
-
-<div class="grid">
-
- <figure>
- <img src="_seed-reference.png" alt="">
- <figcaption><span class="id">_seed-reference</span><br>locked style anchor (passed as reference_images[0] on every other call)</figcaption>
- </figure>
-
- <figure>
- <img src="hero-bg.png" alt="">
- <figcaption><span class="id">hero-bg</span><br><span class="role">§01 Hero · ambient backdrop · the rulebook itself</span></figcaption>
- </figure>
-
- <figure>
- <img src="transition-02-03.png" alt="">
- <figcaption><span class="id">transition-02-03</span><br><span class="role">between Examples → Study · eight folded papers</span></figcaption>
- </figure>
-
- <figure>
- <img src="study-bg.png" alt="">
- <figcaption><span class="id">study-bg</span><br><span class="role">§03 Study · diagnostic overlay on a printed page</span></figcaption>
- </figure>
-
- <figure>
- <img src="transition-04-05.png" alt="">
- <figcaption><span class="id">transition-04-05</span><br><span class="role">between Without/With → Foundations · draft vs final</span></figcaption>
- </figure>
-
- <figure data-square>
- <img src="found-type.png" alt="">
- <figcaption><span class="id">found-type</span><br><span class="role">§05 Type · serif G with construction grid</span></figcaption>
- </figure>
-
- <figure data-square>
- <img src="found-colour.png" alt="">
- <figcaption><span class="id">found-colour</span><br><span class="role">§05 Colour · single coral wash at 3% footprint</span></figcaption>
- </figure>
-
- <figure data-square>
- <img src="found-space.png" alt="">
- <figcaption><span class="id">found-space</span><br><span class="role">§05 Space · architect's freehand floor plan</span></figcaption>
- </figure>
-
- <figure data-square>
- <img src="found-motion.png" alt="">
- <figcaption><span class="id">found-motion</span><br><span class="role">§05 Motion · Muybridge brushstroke strip</span></figcaption>
- </figure>
-
- <figure data-square>
- <img src="found-voice.png" alt="">
- <figcaption><span class="id">found-voice</span><br><span class="role">§05 Voice · marginalia, three honest words</span></figcaption>
- </figure>
-
- <figure data-square>
- <img src="harness-claude.png" alt="">
- <figcaption><span class="id">harness-claude</span><br><span class="role">§07 Install · Claude Code = sealed letter</span></figcaption>
- </figure>
-
- <figure data-square>
- <img src="harness-cursor.png" alt="">
- <figcaption><span class="id">harness-cursor</span><br><span class="role">§07 Install · Cursor = brass drafting compass</span></figcaption>
- </figure>
-
- <figure data-square>
- <img src="harness-codex.png" alt="">
- <figcaption><span class="id">harness-codex</span><br><span class="role">§07 Install · Codex = a literal medieval codex</span></figcaption>
- </figure>
-
- <figure data-square>
- <img src="footer-mark.png" alt="">
- <figcaption><span class="id">footer-mark</span><br><span class="role">footer · wax-seal colophon mark</span></figcaption>
- </figure>
-
- <figure>
- <img src="plate-podcast.png" alt="">
- <figcaption><span class="id">plate-podcast</span><br><span class="role">examples plate · indie podcast (Tide)</span></figcaption>
- </figure>
-
- <figure>
- <img src="plate-bakery.png" alt="">
- <figcaption><span class="id">plate-bakery</span><br><span class="role">examples plate · bakery (Maple)</span></figcaption>
- </figure>
-
- <figure>
- <img src="plate-architecture.png" alt="">
- <figcaption><span class="id">plate-architecture</span><br><span class="role">examples plate · architecture studio</span></figcaption>
- </figure>
-
- <figure>
- <img src="plate-manifesto.png" alt="">
- <figcaption><span class="id">plate-manifesto</span><br><span class="role">examples plate · manifesto</span></figcaption>
- </figure>
-
-</div>
-
-</body>
-</html>
diff --git a/site/img/generated/_seed-reference.png b/site/img/generated/_seed-reference.png
deleted file mode 100644
index e917269..0000000
Binary files a/site/img/generated/_seed-reference.png and /dev/null differ
diff --git a/site/img/generated/_seed-reference.png.url b/site/img/generated/_seed-reference.png.url
deleted file mode 100644
index fa847b5..0000000
--- a/site/img/generated/_seed-reference.png.url
+++ /dev/null
@@ -1 +0,0 @@
-https://api.together.ai/shrt/stxmUP34xyTEyg7d
\ No newline at end of file
diff --git a/site/img/generated/footer-mark.png b/site/img/generated/footer-mark.png
deleted file mode 100644
index 06a3151..0000000
Binary files a/site/img/generated/footer-mark.png and /dev/null differ
diff --git a/site/img/generated/found-colour.png b/site/img/generated/found-colour.png
deleted file mode 100644
index c44bb83..0000000
Binary files a/site/img/generated/found-colour.png and /dev/null differ
diff --git a/site/img/generated/found-motion.png b/site/img/generated/found-motion.png
deleted file mode 100644
index b2b137b..0000000
Binary files a/site/img/generated/found-motion.png and /dev/null differ
diff --git a/site/img/generated/found-space.png b/site/img/generated/found-space.png
deleted file mode 100644
index 9bf92c7..0000000
Binary files a/site/img/generated/found-space.png and /dev/null differ
diff --git a/site/img/generated/found-type.png b/site/img/generated/found-type.png
deleted file mode 100644
index a32f64d..0000000
Binary files a/site/img/generated/found-type.png and /dev/null differ
diff --git a/site/img/generated/found-voice.png b/site/img/generated/found-voice.png
deleted file mode 100644
index 377e3b6..0000000
Binary files a/site/img/generated/found-voice.png and /dev/null differ
diff --git a/site/img/generated/harness-claude.png b/site/img/generated/harness-claude.png
deleted file mode 100644
index 023b97e..0000000
Binary files a/site/img/generated/harness-claude.png and /dev/null differ
diff --git a/site/img/generated/harness-codex.png b/site/img/generated/harness-codex.png
deleted file mode 100644
index 98989f9..0000000
Binary files a/site/img/generated/harness-codex.png and /dev/null differ
diff --git a/site/img/generated/harness-cursor.png b/site/img/generated/harness-cursor.png
deleted file mode 100644
index ed22119..0000000
Binary files a/site/img/generated/harness-cursor.png and /dev/null differ
diff --git a/site/img/generated/hero-bg.png b/site/img/generated/hero-bg.png
deleted file mode 100644
index 74585eb..0000000
Binary files a/site/img/generated/hero-bg.png and /dev/null differ
diff --git a/site/img/generated/plate-architecture.png b/site/img/generated/plate-architecture.png
deleted file mode 100644
index 5bc7c52..0000000
Binary files a/site/img/generated/plate-architecture.png and /dev/null differ
diff --git a/site/img/generated/plate-bakery.png b/site/img/generated/plate-bakery.png
deleted file mode 100644
index 2f9ed4d..0000000
Binary files a/site/img/generated/plate-bakery.png and /dev/null differ
diff --git a/site/img/generated/plate-manifesto.png b/site/img/generated/plate-manifesto.png
deleted file mode 100644
index 4a54f98..0000000
Binary files a/site/img/generated/plate-manifesto.png and /dev/null differ
diff --git a/site/img/generated/plate-podcast.png b/site/img/generated/plate-podcast.png
deleted file mode 100644
index 96cc3ed..0000000
Binary files a/site/img/generated/plate-podcast.png and /dev/null differ
diff --git a/site/img/generated/study-bg.png b/site/img/generated/study-bg.png
deleted file mode 100644
index 7ab76e6..0000000
Binary files a/site/img/generated/study-bg.png and /dev/null differ
diff --git a/site/img/generated/transition-02-03.png b/site/img/generated/transition-02-03.png
deleted file mode 100644
index ce310a1..0000000
Binary files a/site/img/generated/transition-02-03.png and /dev/null differ
diff --git a/site/img/generated/transition-04-05.png b/site/img/generated/transition-04-05.png
deleted file mode 100644
index 03e0d68..0000000
Binary files a/site/img/generated/transition-04-05.png and /dev/null differ
diff --git a/site/index.html b/site/index.html
index 8e41e13..6fbfa0f 100644
--- a/site/index.html
+++ b/site/index.html
@@ -309,13 +309,6 @@
</div>
</section>
- <!-- transition · examples → study -->
- <figure class="transition reveal" style="--i:1.5" aria-hidden="true">
- <div class="wc">
- <img src="img/generated/transition-02-03.png" alt="" loading="lazy" decoding="async" width="1264" height="848" />
- </div>
- </figure>
-
<!-- 03 · STUDY — what `study` extracts from a design -->
<section class="section reveal" style="--i:2" id="study" aria-labelledby="s-study">
<header class="section__head">
@@ -548,13 +541,6 @@
</div>
</section>
- <!-- transition · without/with → foundations -->
- <figure class="transition reveal" style="--i:3.5" aria-hidden="true">
- <div class="wc">
- <img src="img/generated/transition-04-05.png" alt="" loading="lazy" decoding="async" width="1264" height="848" />
- </div>
- </figure>
-
<!-- 05 · FOUNDATIONS — vertical list + active panel (CSS-only tabs) -->
<section class="section reveal" style="--i:4" aria-labelledby="s5-foundations">
<header class="section__head">
@@ -604,11 +590,7 @@
<div class="found-panels">
- <article class="found-panel" data-panel="type">
- <div class="wc found-panel__plate" aria-hidden="true">
- <img src="img/generated/found-type.png" alt="" loading="lazy" decoding="async" width="1024" height="1024" />
- </div>
- <p class="found-panel__rule">Pick fonts on purpose. Skip the defaults. Pair a display with personality and a clean body, and lean into extreme weights — not the safe middle.</p>
+ <article class="found-panel" data-panel="type"> <p class="found-panel__rule">Pick fonts on purpose. Skip the defaults. Pair a display with personality and a clean body, and lean into extreme weights — not the safe middle.</p>
<div class="found-panel__viz spec__viz spec__viz--type">
<div class="spec__viz-row spec__viz-row--display"><span>Hallmark</span><em class="spec__viz-tag">Fraunces · 900 italic</em></div>
<div class="spec__viz-row spec__viz-row--body"><span>Hallmark</span><em class="spec__viz-tag">Geist · 300</em></div>
@@ -616,11 +598,7 @@
</div>
</article>
- <article class="found-panel" data-panel="colour">
- <div class="wc found-panel__plate" aria-hidden="true">
- <img src="img/generated/found-colour.png" alt="" loading="lazy" decoding="async" width="1024" height="1024" />
- </div>
- <p class="found-panel__rule">One accent, used so sparingly you almost miss it — under 3% of the screen. Skip pure black and pure white. Avoid purple gradients.</p>
+ <article class="found-panel" data-panel="colour"> <p class="found-panel__rule">One accent, used so sparingly you almost miss it — under 3% of the screen. Skip pure black and pure white. Avoid purple gradients.</p>
<div class="found-panel__viz spec__viz spec__viz--colour" aria-hidden="true">
<span class="spec__viz-dot"></span>
<p class="spec__viz-caption">One accent. The whole field is paper. The dot is the accent.</p>
@@ -634,11 +612,7 @@
</div>
</article>
- <article class="found-panel" data-panel="space">
- <div class="wc found-panel__plate" aria-hidden="true">
- <img src="img/generated/found-space.png" alt="" loading="lazy" decoding="async" width="1024" height="1024" />
- </div>
- <p class="found-panel__rule">Generous space, used unevenly. One consistent scale. Asymmetry on purpose — centred-everything is a tell.</p>
+ <article class="found-panel" data-panel="space"> <p class="found-panel__rule">Generous space, used unevenly. One consistent scale. Asymmetry on purpose — centred-everything is a tell.</p>
<div class="found-panel__viz spec__viz spec__viz--space" aria-hidden="true">
<div class="spec__viz-grid spec__viz-grid--bad">
<span class="vg-bar vg-bar--xl"></span>
@@ -654,11 +628,7 @@
<p class="spec__viz-pair"><span>Centred (a tell)</span><span>Asymmetric (designed)</span></p>
</article>
- <article class="found-panel" data-panel="motion">
- <div class="wc found-panel__plate" aria-hidden="true">
- <img src="img/generated/found-motion.png" alt="" loading="lazy" decoding="async" width="1024" height="1024" />
- </div>
- <p class="found-panel__rule">Keep motion quiet. One smooth entrance feels designed; ten little bounces feel busy. Animate fade and slide — never size, colour, or layout.</p>
+ <article class="found-panel" data-panel="motion"> <p class="found-panel__rule">Keep motion quiet. One smooth entrance feels designed; ten little bounces feel busy. Animate fade and slide — never size, colour, or layout.</p>
<div class="found-panel__viz spec__viz spec__viz--motion">
<button class="spec__viz-play" type="button" data-motion-demo aria-label="Play motion demo">
<span class="spec__viz-play-icon" aria-hidden="true"></span>
@@ -670,11 +640,7 @@
</div>
</article>
- <article class="found-panel" data-panel="voice">
- <div class="wc found-panel__plate" aria-hidden="true">
- <img src="img/generated/found-voice.png" alt="" loading="lazy" decoding="async" width="1024" height="1024" />
- </div>
- <p class="found-panel__rule">Write like a person. Specific verbs. Link text that makes sense out of context. Real apostrophes. No "seamless," no "unleash," no "built for the modern team."</p>
+ <article class="found-panel" data-panel="voice"> <p class="found-panel__rule">Write like a person. Specific verbs. Link text that makes sense out of context. Real apostrophes. No "seamless," no "unleash," no "built for the modern team."</p>
<div class="found-panel__viz spec__viz spec__viz--copy">
<div class="spec__viz-copy-col" data-variant="bad">
<p class="spec__viz-copy-label">Vague</p>
@@ -772,27 +738,15 @@
<div class="install-pane__row">
<p class="install-pane__label"><span class="install-pane__step">II</span> In</p>
<ul class="install-pane__harnesses">
- <li class="harness">
- <div class="wc harness__plate" aria-hidden="true">
- <img src="img/generated/harness-claude.png" alt="" loading="lazy" decoding="async" width="1024" height="1024" />
- </div>
- <span class="harness__name">Claude Code</span>
+ <li class="harness"> <span class="harness__name">Claude Code</span>
<code class="harness__path">~/.claude/skills/hallmark/</code>
<span class="harness__status harness__status--ok">auto-detected</span>
</li>
- <li class="harness">
- <div class="wc harness__plate" aria-hidden="true">
- <img src="img/generated/harness-cursor.png" alt="" loading="lazy" decoding="async" width="1024" height="1024" />
- </div>
- <span class="harness__name">Cursor</span>
+ <li class="harness"> <span class="harness__name">Cursor</span>
<code class="harness__path">.cursor/rules/hallmark.mdc</code>
<span class="harness__status harness__status--ok">auto-detected</span>
</li>
- <li class="harness">
- <div class="wc harness__plate" aria-hidden="true">
- <img src="img/generated/harness-codex.png" alt="" loading="lazy" decoding="async" width="1024" height="1024" />
- </div>
- <span class="harness__name">Codex &amp; others</span>
+ <li class="harness"> <span class="harness__name">Codex &amp; others</span>
<code class="harness__path">git clone · copy skill/</code>
<span class="harness__status">manual</span>
</li>
@@ -806,12 +760,6 @@
</div>
</section>
-
- <!-- footer mark · sits above the per-theme footer archetype -->
- <div class="wc foot-mark reveal" style="--i:6.5" aria-hidden="true">
- <img src="img/generated/footer-mark.png" alt="" loading="lazy" decoding="async" width="1024" height="1024" />
- </div>
-
<!-- FOOTER SLOT — archetype swaps per theme -->
<footer class="slot slot--foot reveal" data-slot="footer" style="--i:7" role="contentinfo" aria-label="Colophon">
</footer>
diff --git a/skill/_assets/scripts/generate.mjs b/skill/_assets/scripts/generate.mjs
deleted file mode 100644
index d4fa520..0000000
--- a/skill/_assets/scripts/generate.mjs
+++ /dev/null
@@ -1,198 +0,0 @@
-#!/usr/bin/env node
-/*
- * generate.mjs · Hallmark image-generation recipe (Tier C)
- *
- * Drop this script into a Hallmark project. It generates brand-coherent
- * watercolour / ink-wash / risograph / charcoal / etc. illustrations
- * that all look like the same artist made them — by locking a seed
- * and a reference image across every call.
- *
- * Setup:
- * 1. Add `TOGETHER_API_KEY=…` to .env.local at your project root.
- * 2. Add `.env.local` to .gitignore (don't commit your key).
- * 3. Pick the theme from skill/references/generated-imagery.md.
- *
- * Usage:
- * node scripts/generate.mjs --theme editorial --slot hero --subject "a hand-bound notebook of recipes"
- * node scripts/generate.mjs --theme bloom --slot section-anchor --subject "a single pomegranate split open"
- * node scripts/generate.mjs --list-themes
- *
- * Output:
- * ./img/generated/_seed-reference.png (locked anchor, generated on first run)
- * ./img/generated/_seed-reference.png.url (cached URL for subsequent calls)
- * ./img/generated/<slot>.png (one per call)
- *
- * What it does:
- * - Reads TOGETHER_API_KEY from .env.local
- * - Looks up the locked theme prompt prefix
- * - On first call: generates the reference image, caches its hosted URL
- * - On every subsequent call: passes the reference URL via reference_images[]
- * and locks seed=7727 so all images share one visual hand
- * - Writes ./img/generated/<slot>.png
- *
- * Cost: $0.134 per 2K image, $0.034 per 1K. Set --size 1k for cheaper.
- */
-
-import fs from "node:fs/promises";
-import path from "node:path";
-
-const OUT_DIR = path.resolve(process.cwd(), "img/generated");
-const ENV_PATH = path.resolve(process.cwd(), ".env.local");
-const API_URL = "https://api.together.xyz/v1/images/generations";
-const MODEL_ID = "google/gemini-3-pro-image";
-const SEED = 7727;
-
-/* — Locked style-prompt prefix per theme ————————————————————
- Mirror of the table in skill/references/generated-imagery.md.
- Lock this once per project. Don't edit it between runs. */
-const THEME_PROMPTS = {
- specimen: "Pen-and-ink plate on warm cream paper. Crosshatched shading, single-line silhouettes, faint sepia wash. Hand-drawn from a 1930s book. No colour beyond ink and warm cream. Subject:",
- newsprint: "Halftone newspaper print on warm pulp paper. Visible dot screen, slightly off-register, restrained sepia + black. Editorial illustration in the manner of a daily broadsheet. Subject:",
- atelier: "Graphite pencil sketch on soft buff paper. Loose construction lines visible, light cross-hatching, a single coral accent in one detail. Studio sketchbook. Subject:",
- garden: "Watercolour plate with botanical-illustration discipline. Translucent washes of warm green and faded coral on cream paper. Visible paper grain. Hand-drawn in a 19th-century herbal. Subject:",
- salon: "Ink-wash illustration on warm cream paper, in the manner of a literary journal frontispiece. Restrained colour, fine ink line, generous breathing room. Subject:",
- linen: "Sepia-tone charcoal sketch on linen-textured paper. Smudged shading, gestural marks, a single warm copper accent. Subject:",
- almanac: "Lithograph print on warm cream paper, in the manner of a 19th-century reference plate. Crosshatching, careful captions, restrained palette. Subject:",
- midnight: "Monochrome neon-line illustration on near-black paper. Single phosphor cyan stroke, soft glow, crisp dark surroundings. Subject:",
- terminal: "Monochrome ASCII-style print on near-black paper. Single phosphor green tone, no painterly gradients, the look of a printed terminal screen. Subject:",
- brutal: "High-contrast woodcut print, black ink on warm cream paper. Bold blocks, gouge marks, no halftones. Subject:",
- manifesto: "Cut-paper collage on warm cream paper. Bold geometric shapes torn at the edges, single red ink wash, hand-set rough texture. Subject:",
- sport: "Bold action-line illustration in a 1970s sports-poster register. Two-colour palette: black and a single warm orange. Crisp diagonals. Subject:",
- studio: "Clean geometric line illustration on cool grey paper, in the manner of a Swiss design-school plate. Restrained palette: ink + a single sage green accent. Subject:",
- pastel: "Soft gouache plate on cool cream paper. Translucent pastel washes — pale indigo, mint, faded peach — with crisp pencil lines. Subject:",
- riso: "Risograph two-colour print on warm cream paper. Visible mis-register between coral red and faded blue, halftone dot texture, flat geometric shapes. Subject:",
- quiet: "Monochrome ink line on warm white paper. A single gestural stroke, vast negative space, no colour. The minimum that still reads as a drawing. Subject:",
- bloom: "Deep ink wash on dark paper. Translucent layers of charcoal and faded amber bleeding into each other, a single warm bloom of light. Subject:",
- coral: "Soft watercolour plate on warm cream paper. Translucent washes of coral, peach, and ivory; visible paper grain; loose ink line. Subject:",
- violet: "Watercolour plate on cool white paper. Translucent washes of violet, lavender, and dusty rose; ink line in soft charcoal. Subject:",
- aurora: "Soft gradient line illustration on near-black paper. Translucent washes of cyan, soft green, and faint purple — northern-lights inspired but grounded in line. Subject:",
- halo: "Hand-drawn glyph plate on warm cream paper. Restrained gold leaf accent, faint ink hatching, a single ornament per plate. The discipline of a medieval illuminator. Subject:",
- plume: "Calligraphy and brush-stroke illustration on warm cream paper. Translucent rose wash, single ink flourish, soft pencil-line construction. Subject:",
- editorial: "Watercolor and ink wash on warm cream paper. Soft translucent washes of coral, terracotta, and faded olive. Visible paper grain and bleed edges. Loose asymmetric composition. Hand-made plate from a quiet studio. Subject:",
-};
-
-/* — Allowed dimensions ———————————————————————————————————— */
-const SIZES = {
- "1k-square": [1024, 1024],
- "1k-wide": [1264, 848],
- "1k-tall": [848, 1264],
- "2k-square": [2048, 2048],
- "2k-wide": [2528, 1696],
- "2k-tall": [1696, 2528],
-};
-
-async function loadEnv() {
- let raw;
- try { raw = await fs.readFile(ENV_PATH, "utf8"); }
- catch { throw new Error(`.env.local not found at ${ENV_PATH}. Add TOGETHER_API_KEY=… to it.`); }
- for (const line of raw.split("\n")) {
- const m = line.match(/^([A-Z_][A-Z0-9_]*)\s*=\s*(.*)$/);
- if (m) process.env[m[1]] = m[2].trim().replace(/^["']|["']$/g, "");
- }
-}
-
-function arg(name, fallback) {
- const i = process.argv.indexOf(`--${name}`);
- return i >= 0 ? process.argv[i + 1] : fallback;
-}
-
-async function callTogether({ prompt, width, height, referenceUrl, apiKey }) {
- const body = {
- model: MODEL_ID, prompt, width, height, seed: SEED,
- };
- if (referenceUrl) body.reference_images = [referenceUrl];
- const res = await fetch(API_URL, {
- method: "POST",
- headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" },
- body: JSON.stringify(body),
- });
- if (!res.ok) {
- const err = await res.text();
- throw new Error(`Together AI ${res.status}: ${err.slice(0, 400)}`);
- }
- return res.json();
-}
-
-async function downloadOrDecode(json) {
- const url = json?.data?.[0]?.url;
- const b64 = json?.data?.[0]?.b64_json;
- if (!url && !b64) throw new Error(`No image returned: ${JSON.stringify(json).slice(0, 300)}`);
- if (url) {
- const r = await fetch(url);
- if (!r.ok) throw new Error(`Image fetch ${r.status}`);
- return { bytes: Buffer.from(await r.arrayBuffer()), hostedUrl: url };
- }
- return { bytes: Buffer.from(b64, "base64"), hostedUrl: null };
-}
-
-async function main() {
- if (process.argv.includes("--list-themes")) {
- console.log("Available themes:");
- for (const t of Object.keys(THEME_PROMPTS)) console.log(` ${t}`);
- return;
- }
-
- const theme = arg("theme");
- const slot = arg("slot", "untitled");
- const subject = arg("subject");
- const sizeKey = arg("size", "1k-wide");
-
- if (!theme || !subject) {
- console.error("Usage: node generate.mjs --theme <theme> --slot <slot> --subject \"…\" [--size 1k-wide|1k-square|2k-wide|2k-tall]");
- console.error(" node generate.mjs --list-themes");
- process.exit(2);
- }
-
- const prefix = THEME_PROMPTS[theme];
- if (!prefix) {
- console.error(`Unknown theme: ${theme}. Run --list-themes for the catalog.`);
- process.exit(2);
- }
-
- const [width, height] = SIZES[sizeKey] || SIZES["1k-wide"];
-
- await loadEnv();
- const apiKey = (process.env.TOGETHER_API_KEY || "").trim();
- if (!apiKey) {
- console.error("TOGETHER_API_KEY missing in .env.local at the project root.");
- process.exit(2);
- }
-
- await fs.mkdir(OUT_DIR, { recursive: true });
- const refPath = path.join(OUT_DIR, "_seed-reference.png");
- const refUrlPath = refPath + ".url";
-
- // Get or create the locked reference image
- let referenceUrl = null;
- try {
- referenceUrl = (await fs.readFile(refUrlPath, "utf8")).trim();
- } catch {
- console.log(`→ no reference yet · generating one for theme=${theme}…`);
- const refPrompt = `${prefix} a small abstract still life that captures the spirit of ${theme}. Loose composition. Hand-made.`;
- const json = await callTogether({ prompt: refPrompt, width, height, apiKey });
- const { bytes, hostedUrl } = await downloadOrDecode(json);
- await fs.writeFile(refPath, bytes);
- if (hostedUrl) {
- await fs.writeFile(refUrlPath, hostedUrl);
- referenceUrl = hostedUrl;
- }
- console.log(` ✓ reference → ${refPath} (${Math.round(bytes.length / 1024)} KB)`);
- }
-
- // Generate the requested slot
- const fullPrompt = `${prefix} ${subject}.`;
- console.log(`→ generating ${slot} (theme=${theme}, ${width}×${height}, seed=${SEED})…`);
- const json = await callTogether({ prompt: fullPrompt, width, height, referenceUrl, apiKey });
- const { bytes } = await downloadOrDecode(json);
- const outPath = path.join(OUT_DIR, `${slot}.png`);
- await fs.writeFile(outPath, bytes);
- console.log(` ✓ ${slot} → ${outPath} (${Math.round(bytes.length / 1024)} KB)`);
-
- console.log("\nNext: post-process. See skill/references/generated-imagery.md § post-processing checklist:");
- console.log(" 1. Grain overlay 2. Asymmetric crop 3. Colour-shift toward accent 4. Optional frame");
-}
-
-main().catch((e) => {
- console.error("FAIL:", e.message);
- process.exit(1);
-});
diff --git a/skill/references/anti-patterns.md b/skill/references/anti-patterns.md
index 67961d2..2e27ecd 100644
--- a/skill/references/anti-patterns.md
+++ b/skill/references/anti-patterns.md
@@ -88,14 +88,6 @@ Wordmark hard-left, 4–5 inline text links (`Features · Pricing · Docs · Blo
**Fix.** Pick from the routing table in [`component-cookbook.md`](component-cookbook.md) § Footers. Default to Ft1 Mast-headed, Ft2 Inline single line, Ft4 Dense colophon, Ft5 Statement, Ft6 Letter close, Ft7 Newsletter-first, or Ft8 Marquee scroll. Use Ft3 Index columns *only* on a genuine hub or docs root with a real sitemap — and even then, never with the social-icon row + tiny copyright tail.
-### Raw generated stills
-
-Shipping a Nanobanana / Gemini-image / Midjourney output without post-processing — no grain overlay, no asymmetric crop, no colour-grade toward the brand accent, no seed-locking across the project's image set.
-
-**Why it fails.** Reads as AI in milliseconds. Smooth surface, default lighting, perfect symmetry. The 2026 audience pattern-matches this faster than any other tell.
-
-**Fix.** Use the seed-and-reference rule + the post-processing checklist in [`generated-imagery.md`](generated-imagery.md). One reference, one seed, four post-processing moves (grain · asymmetric crop · accent-shift · optional hand-drawn frame). Skip any of these and the image reads as raw AI.
-
### Aurora-blob background
Flowing organic mesh blobs in purple-to-pink-to-cyan, layered behind hero text. Looks "premium" until you've seen it on every Dribbble shot since 2022.
diff --git a/skill/references/assets.md b/skill/references/assets.md
index 76bb4e6..de5e9b6 100644
--- a/skill/references/assets.md
+++ b/skill/references/assets.md
@@ -99,16 +99,16 @@ import { siGithub } from 'simple-icons/icons';
## Generated illustration (Tier C in the enrichment hierarchy)
-**As of v0.9.0, Tier C is a peer of Tier B (hand-built SVG)** when used with the seed-and-reference discipline plus post-processing. See [`generated-imagery.md`](generated-imagery.md) for the full recipe — that file is the canonical place; this section is the model catalog.
+When characters or specific scenes can't be hand-built economically. **Always post-process.** See [`custom-craft.md`](custom-craft.md) Tier E for full discipline.
### Canon
-| Model | Hosted via | Cost | Best for | Output |
+| Model | URL | Cost | Best for | Output |
| --- | --- | --- | --- | --- |
-| **[Gemini 3 Pro Image / Nano Banana Pro](https://ai.google.dev/gemini-api/docs/image-generation)** | **Together AI** (`google/gemini-3-pro-image`) — $0.134/image at 2K | $0.134 / 2K · $0.034 / 1K | Brand-coherent illustration sets via reference-image character consistency, fast iteration, the 2026 Tier C default | PNG |
+| **[Nanobanana 2 / Gemini 2.5 Flash Image](https://ai.google.dev/gemini-api/docs/image-generation)** | Google AI | $0.039 / image | Character consistency across panels, fast iteration, brand-style adherence via reference images, infographics with text | PNG (transparent supported) |
| **[Recraft V4](https://www.recraft.ai/)** | recraft.ai | ~$0.04 / image | **The only model with production-grade SVG output.** Logos, icons, illustrations that need to scale. | SVG + PNG |
| **[Midjourney v8](https://www.midjourney.com)** | midjourney.com | ~$0.14 / image | Aesthetic beauty, atmospheric stills, artistic direction | PNG |
-| **[Flux 2](https://blackforestlabs.ai/)** | Together AI / Black Forest Labs | ~$0.03 / image | Photorealism — skin, fabric, product detail, hands | PNG |
+| **[Flux 2](https://blackforestlabs.ai/)** | blackforestlabs.ai | ~$0.03 / image | Photorealism — skin, fabric, product detail, hands | PNG |
### The rules
diff --git a/skill/references/generated-imagery.md b/skill/references/generated-imagery.md
deleted file mode 100644
index a7dff95..0000000
--- a/skill/references/generated-imagery.md
+++ /dev/null
@@ -1,205 +0,0 @@
-# Generated imagery
-
-When a Hallmark project ships images, the rule is: **every image looks like the same artist made it**. Within one project — one brand — every plate, glyph, backdrop, and ornament shares the same hand. Across themes, the hand changes — Specimen looks like a pen-and-ink plate; Bloom looks like a deep ink wash on dark paper; Terminal looks like a monochrome ASCII print. The discipline that keeps this together is **a locked seed plus a locked reference image**.
-
-This file ships the recipe.
-
----
-
-## When generated stills earn their place
-
-Generated illustration was Tier C in [`hero-enrichment.md`](hero-enrichment.md) — historically a "last resort, only when characters demand it" tier. **As of Hallmark v0.9.0, that's revised.** With Gemini 3 Pro Image (Nano Banana Pro) hosted by Together AI, character-consistency via reference-images, and rigorous post-processing, Tier C is now a **peer of Tier B (hand-built SVG)** when the discipline below is followed.
-
-What changed: in 2024 you needed Midjourney + heavy retouching. In 2026 a single seed-locked + reference-image-locked Together AI call gives you a coherent set of images for one brand, in one style, that look hand-made.
-
-The discipline did not change. Raw output still reads as AI in milliseconds. Post-processing is what makes it ours.
-
-**When to reach for Tier C:**
-- The brand has a story or set of subjects that benefit from being illustrated (a bakery, a podcast, an architecture studio, a journal, an atelier).
-- Hand-built SVG (Tier B) can't economically reach the depth — characters, scenes, atmosphere.
-- The brief carries a specific visual voice the catalog can name (watercolor, ink wash, woodcut, risograph, charcoal, gouache, illustration, photography).
-
-**When NOT to reach for Tier C:**
-- The page is a CLI / dev-tool / docs site where typography carries everything (Tier 0).
-- The brand is "modern professional team" generic — illustrating that is the new template.
-- A pure-CSS shape (Tier A) would do the job in fewer bytes.
-- The image would need post-processing the team can't or won't do — better no image than a raw Nanobanana output.
-
----
-
-## The seed-and-reference rule
-
-This is the rule that makes "all images on this site look like one artist made them."
-
-**Per project, you pick once and never change:**
-
-1. **A seed.** A 4–5 digit integer. Hallmark default is `7727`. Use it on every call.
-2. **A style reference image.** ONE PNG that anchors the visual language for the whole project. Generate this first with the locked theme prompt below + a subject of your choice. Save it at `<project>/img/generated/_seed-reference.png` and commit it.
-3. **A locked prompt prefix.** From the per-theme table below — the prefix that names the style (medium, palette, paper, mood). Don't tweak it between calls.
-
-**Per generation call, you only vary the subject.** Always:
-- Pass `seed` set to your project's seed
-- Pass the locked reference image as `reference_images[0]`
-- Use the locked prompt prefix
-- Append a one-sentence subject specific to the slot
-
-That's the whole rule. Get those right and every image lands in the same hand.
-
-```ts
-// What every call looks like, after step 1 (reference + seed locked):
-{
- model: "google/gemini-3-pro-image",
- prompt: `${THEME_PROMPT_PREFIX} ${slot_subject}.`,
- width: 1264, height: 848, // or 1024×1024 for square; see allowed sizes below
- seed: 7727,
- reference_images: [REFERENCE_URL],
-}
-```
-
-The reference image's hosted URL (returned by Together AI on the first call) is the one you pass on subsequent calls. Cache it next to the file: `_seed-reference.png.url`.
-
----
-
-## Per-theme style prompts
-
-Each Hallmark theme has a locked style-prompt prefix. Pick the one that matches the active theme and use it as the prefix for every image in the project. Don't blend prefixes; don't "tweak" them.
-
-| Theme | Style-prompt prefix |
-| --- | --- |
-| **Specimen** | Pen-and-ink plate on warm cream paper. Crosshatched shading, single-line silhouettes, faint sepia wash. Hand-drawn from a 1930s book. No colour beyond ink and warm cream. Subject: |
-| **Newsprint** | Halftone newspaper print on warm pulp paper. Visible dot screen, slightly off-register, restrained sepia + black. Editorial illustration in the manner of a daily broadsheet. Subject: |
-| **Atelier** | Graphite pencil sketch on soft buff paper. Loose construction lines visible, light cross-hatching, a single coral accent in one detail. Studio sketchbook. Subject: |
-| **Garden** | Watercolour plate with botanical-illustration discipline. Translucent washes of warm green and faded coral on cream paper. Visible paper grain. Hand-drawn in a 19th-century herbal. Subject: |
-| **Salon** | Ink-wash illustration on warm cream paper, in the manner of a literary journal frontispiece. Restrained colour, fine ink line, generous breathing room. Subject: |
-| **Linen** | Sepia-tone charcoal sketch on linen-textured paper. Smudged shading, gestural marks, a single warm copper accent. Subject: |
-| **Almanac** | Lithograph print on warm cream paper, in the manner of a 19th-century reference plate. Crosshatching, careful captions, restrained palette. Subject: |
-| **Midnight** | Monochrome neon-line illustration on near-black paper. Single phosphor cyan stroke, soft glow, crisp dark surroundings. Subject: |
-| **Terminal** | Monochrome ASCII-style print on near-black paper. Single phosphor green tone, no painterly gradients, the look of a printed terminal screen. Subject: |
-| **Brutal** | High-contrast woodcut print, black ink on warm cream paper. Bold blocks, gouge marks, no halftones. Subject: |
-| **Manifesto** | Cut-paper collage on warm cream paper. Bold geometric shapes torn at the edges, single red ink wash, hand-set rough texture. Subject: |
-| **Sport** | Bold action-line illustration in a 1970s sports-poster register. Two-colour palette: black and a single warm orange. Crisp diagonals. Subject: |
-| **Studio** | Clean geometric line illustration on cool grey paper, in the manner of a Swiss design-school plate. Restrained palette: ink + a single sage green accent. Subject: |
-| **Pastel** | Soft gouache plate on cool cream paper. Translucent pastel washes — pale indigo, mint, faded peach — with crisp pencil lines. Subject: |
-| **Riso** | Risograph two-colour print on warm cream paper. Visible mis-register between coral red and faded blue, halftone dot texture, flat geometric shapes. Subject: |
-| **Quiet** | Monochrome ink line on warm white paper. A single gestural stroke, vast negative space, no colour. The minimum that still reads as a drawing. Subject: |
-| **Bloom** | Deep ink wash on dark paper. Translucent layers of charcoal and faded amber bleeding into each other, a single warm bloom of light. Subject: |
-| **Coral** | Soft watercolour plate on warm cream paper. Translucent washes of coral, peach, and ivory; visible paper grain; loose ink line. Subject: |
-| **Violet** | Watercolour plate on cool white paper. Translucent washes of violet, lavender, and dusty rose; ink line in soft charcoal. Subject: |
-| **Aurora** | Soft gradient line illustration on near-black paper. Translucent washes of cyan, soft green, and faint purple — northern-lights inspired but grounded in line. Subject: |
-| **Halo** | Hand-drawn glyph plate on warm cream paper. Restrained gold leaf accent, faint ink hatching, a single ornament per plate. The discipline of a medieval illuminator. Subject: |
-| **Plume** | Calligraphy and brush-stroke illustration on warm cream paper. Translucent rose wash, single ink flourish, soft pencil-line construction. Subject: |
-| **Editorial** | Watercolor and ink wash on warm cream paper. Soft translucent washes of coral, terracotta, and faded olive. Visible paper grain and bleed edges. Loose asymmetric composition. Hand-made plate from a quiet studio. Subject: |
-
-Pick one row. Lock it for the project. Don't blend.
-
----
-
-## Supported dimensions
-
-Gemini 3 Pro Image accepts only these source sizes. The display crop in CSS can be anything (`object-fit: cover`); these are the source dimensions you request:
-
-| Aspect | Sizes |
-| --- | --- |
-| Square | `1024×1024` · `2048×2048` · `4096×4096` |
-| 3:2 wide | `1264×848` · `2528×1696` · `5096×3392` |
-| 2:3 tall | `848×1264` · `1696×2528` · `3392×5096` |
-| 4:3 wide | `1200×896` · `2400×1792` · `4800×3584` |
-| 3:4 tall | `896×1200` |
-
-For most slots, `1264×848` (wide) or `1024×1024` (square) is enough. Reach for 2K only on hero backdrops that go full-bleed.
-
-`steps`, `width`/`height` outside this list, and other FLUX-style parameters are not supported. Don't send them.
-
----
-
-## Post-processing checklist
-
-Raw output reads as AI even when the prompt is good. The four post-processing moves are non-negotiable:
-
-1. **Grain.** Apply an SVG `<feTurbulence>` overlay at 0.04–0.08 opacity, `mix-blend-mode: multiply`, scoped to the image. Or a faint paper-texture PNG at 0.06 opacity. The grain is what breaks the "smooth" AI surface.
-2. **Asymmetric crop.** Crop 8–15% off one edge (usually right or bottom). Centred crops read as AI; an asymmetric crop reads as a human framing.
-3. **Colour grade toward the brand accent.** Mix the image 8–12% toward `--color-accent` using `mix-blend-mode: multiply` over an accent-colour layer, or in the post-processor of your choice. The image gets pulled into the project's palette.
-4. **Optional: hand-drawn frame.** A 0.5px hairline rule in `--color-rule`, or a corner-bracket utility (see `.fig-corners` in component-cookbook), or four small `+` marks at corners. Optional but lifts a generated still toward "made on a desk."
-
-If a generated image has not been through all four (or three plus a deliberate skip on the fourth), it is not ready to ship.
-
----
-
-## Provenance stamp
-
-Every project that uses generated imagery records it in the macrostructure stamp:
-
-```css
-/* Hallmark · genre: editorial · macrostructure: Long Document
- * theme: editorial · nav: N6 · footer: Ft1
- * imagery: gemini-3-pro · seed: 7727 · reference: tokens/_image-reference.png
- * post-processed: grain + asymmetric-crop + accent-shift
- * slop: pass (51-55) · contrast: pass (46-50)
- */
-```
-
-The `imagery:` line tells future Hallmark runs (and any audit) which model + seed + reference produced the images. Reproducible. Honest about provenance.
-
----
-
-## Two paths for users
-
-### Path A · Pre-generated style packs (no API key needed)
-
-For users who don't have a Together AI key, Hallmark ships pre-generated style packs at [`skill/_assets/image-packs/<theme>/`](../_assets/image-packs/):
-
-```
-_assets/image-packs/editorial/
- _seed-reference.png (the locked anchor)
- 01-hero-backdrop.png (1920×1080 ambient)
- 02-section-anchor.png (1024×1024 corner plate)
- 03-glyph.png (1024×1024 mark)
-```
-
-Users copy the pack into their project's `./img/generated/` directory and reference the files. No API key. Limited to fixed images.
-
-### Path B · Power-user recipe (own API key)
-
-For users who want their own brand subjects, ship the recipe at [`skill/_assets/scripts/generate.mjs`](../_assets/scripts/generate.mjs). They copy it into their project, set `TOGETHER_API_KEY` in `.env.local`, and run:
-
-```bash
-node scripts/generate.mjs --theme editorial --slot hero --subject "a hand-bound notebook of recipes"
-```
-
-The script:
-- Reads `TOGETHER_API_KEY` from `.env.local`
-- Looks up the locked theme prompt prefix from this file
-- Generates the seed reference if none exists, otherwise uses the cached URL
-- Calls Together AI with seed=7727 + reference_images=[reference_url]
-- Writes `./img/generated/<slot>.png`
-
-Power users get unlimited brand-coherent images on their own dime ($0.134 per call).
-
-### Path C · Free-trial endpoint (planned, post-launch)
-
-For users who want to sample before paying: a Vercel Edge Function at `hallmark-murex.vercel.app/api/generate` accepts `{ subject, theme }` and returns a generated image. Rate-limited to 5 generations per IP per day, daily budget cap of $5. Users cap their own taste; we cap our exposure. (Not shipped at launch — see roadmap.)
-
----
-
-## Anti-patterns to refuse
-
-- **Raw output.** Shipping any model's first try without grain, crop, colour grade. Slop.
-- **Mixing styles in one project.** Two themes' image styles on the same site. Pick one, lock it.
-- **Forgetting the seed or reference.** Each call without them returns a different artist. Don't.
-- **Aurora-blob backgrounds disguised as Tier C.** A purple-pink mesh blob is still aurora-blob even if Gemini drew it. Refuse.
-- **Smiling-at-laptop generic.** "Modern professional team" stock-photo poses, smooth-mesh-blob characters, symmetric stage-lighting. Refuse.
-
-The audit verb checks for these and fails the build.
-
----
-
-## Cost framing
-
-At $0.134 per 2K image:
-
-- A small project (~5 images): ~$0.70.
-- A medium project (~15 images): ~$2.00.
-- A pre-generated theme pack (4 images × 23 themes): ~$12.30 one-time for Hallmark to ship the packs.
-- A free-trial endpoint cap of $5/day yields ~37 free generations daily, ~1,100/month.
-
-These are rounding-error costs vs the time post-processing the same images by hand.
diff --git a/skill/references/hero-enrichment.md b/skill/references/hero-enrichment.md
index 23eeef8..a178e7e 100644
--- a/skill/references/hero-enrichment.md
+++ b/skill/references/hero-enrichment.md
@@ -17,7 +17,7 @@ Reach for the highest tier the brief lets you ship in the time you have. Skippin
| **0 · Typography only** | No enrichment. Display, lede, optional CTA. | Always acceptable. The strongest fail-state. |
| **A · Custom-built CSS art** | Pure-CSS shapes, gradients, clip-paths, no asset, zero dependency. | Geometric shapes, gradient compositions, glyph-style decoration. |
| **B · Hand-built SVG** | Designed in Figma, optimised, animated declaratively. | Illustrations more complex than CSS handles cleanly — a loaf, a mascot, a workflow diagram. |
-| **C · Generated illustration** | Gemini 3 Pro Image / Nanobanana / Recraft V4, with seed-locking + reference-image + post-processing. **As of v0.9.0, a peer of Tier B** when the discipline is followed (see [`generated-imagery.md`](generated-imagery.md)). | Characters, scenes, atmosphere, brand-coherent illustration sets. The seed-and-reference rule is non-negotiable. Always post-processed. |
+| **C · Generated illustration** | Nanobanana / Recraft V4 / Midjourney, with provenance + post-processing. | Characters or specific scenes that hand-build can't economically reach. Always post-processed. |
| **D · Library illustration** | Storyset / Humaaans / unDraw, customised with brand colours. | When budget and timeline force a shortcut — and even then, never unmodified. |
| **E · Lottie animation** | LAST RESORT. Only when complex character motion can't be hand-built. | Articulated figures, multi-frame mascot loops. Never for "spinning logo" or "checkmark draw" — those are CSS. |