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.mdindex 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.mjsdeleted file mode 100644index 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.pngnew file mode 100644index 0000000..13a0a59Binary files /dev/null and b/site/_tests/_thumbs/verb-audit.png differdiff --git a/site/_tests/_thumbs/verb-redesign.png b/site/_tests/_thumbs/verb-redesign.pngnew file mode 100644index 0000000..284360eBinary files /dev/null and b/site/_tests/_thumbs/verb-redesign.png differdiff --git a/site/_tests/_thumbs/verb-refine.png b/site/_tests/_thumbs/verb-refine.pngnew file mode 100644index 0000000..a07a16fBinary files /dev/null and b/site/_tests/_thumbs/verb-refine.png differdiff --git a/site/_tests/_thumbs/verb-study.png b/site/_tests/_thumbs/verb-study.pngnew file mode 100644index 0000000..0523934Binary files /dev/null and b/site/_tests/_thumbs/verb-study.png differdiff --git a/site/_tests/verbs/README.md b/site/_tests/verbs/README.mdnew file mode 100644index 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.mdnew file mode 100644index 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.htmlnew file mode 100644index 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.mdnew file mode 100644index 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.htmlnew file mode 100644index 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.mdnew file mode 100644index 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.htmlnew file mode 100644index 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.htmlnew file mode 100644index 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.mdnew file mode 100644index 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.htmlnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.cssnew file mode 100644index 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.htmlnew file mode 100644index 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 & 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 & 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.cssindex 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.cssindex 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.htmldeleted file mode 100644index 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.pngdeleted file mode 100644index e917269..0000000Binary files a/site/img/generated/_seed-reference.png and /dev/null differdiff --git a/site/img/generated/_seed-reference.png.url b/site/img/generated/_seed-reference.png.urldeleted file mode 100644index 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 filediff --git a/site/img/generated/footer-mark.png b/site/img/generated/footer-mark.pngdeleted file mode 100644index 06a3151..0000000Binary files a/site/img/generated/footer-mark.png and /dev/null differdiff --git a/site/img/generated/found-colour.png b/site/img/generated/found-colour.pngdeleted file mode 100644index c44bb83..0000000Binary files a/site/img/generated/found-colour.png and /dev/null differdiff --git a/site/img/generated/found-motion.png b/site/img/generated/found-motion.pngdeleted file mode 100644index b2b137b..0000000Binary files a/site/img/generated/found-motion.png and /dev/null differdiff --git a/site/img/generated/found-space.png b/site/img/generated/found-space.pngdeleted file mode 100644index 9bf92c7..0000000Binary files a/site/img/generated/found-space.png and /dev/null differdiff --git a/site/img/generated/found-type.png b/site/img/generated/found-type.pngdeleted file mode 100644index a32f64d..0000000Binary files a/site/img/generated/found-type.png and /dev/null differdiff --git a/site/img/generated/found-voice.png b/site/img/generated/found-voice.pngdeleted file mode 100644index 377e3b6..0000000Binary files a/site/img/generated/found-voice.png and /dev/null differdiff --git a/site/img/generated/harness-claude.png b/site/img/generated/harness-claude.pngdeleted file mode 100644index 023b97e..0000000Binary files a/site/img/generated/harness-claude.png and /dev/null differdiff --git a/site/img/generated/harness-codex.png b/site/img/generated/harness-codex.pngdeleted file mode 100644index 98989f9..0000000Binary files a/site/img/generated/harness-codex.png and /dev/null differdiff --git a/site/img/generated/harness-cursor.png b/site/img/generated/harness-cursor.pngdeleted file mode 100644index ed22119..0000000Binary files a/site/img/generated/harness-cursor.png and /dev/null differdiff --git a/site/img/generated/hero-bg.png b/site/img/generated/hero-bg.pngdeleted file mode 100644index 74585eb..0000000Binary files a/site/img/generated/hero-bg.png and /dev/null differdiff --git a/site/img/generated/plate-architecture.png b/site/img/generated/plate-architecture.pngdeleted file mode 100644index 5bc7c52..0000000Binary files a/site/img/generated/plate-architecture.png and /dev/null differdiff --git a/site/img/generated/plate-bakery.png b/site/img/generated/plate-bakery.pngdeleted file mode 100644index 2f9ed4d..0000000Binary files a/site/img/generated/plate-bakery.png and /dev/null differdiff --git a/site/img/generated/plate-manifesto.png b/site/img/generated/plate-manifesto.pngdeleted file mode 100644index 4a54f98..0000000Binary files a/site/img/generated/plate-manifesto.png and /dev/null differdiff --git a/site/img/generated/plate-podcast.png b/site/img/generated/plate-podcast.pngdeleted file mode 100644index 96cc3ed..0000000Binary files a/site/img/generated/plate-podcast.png and /dev/null differdiff --git a/site/img/generated/study-bg.png b/site/img/generated/study-bg.pngdeleted file mode 100644index 7ab76e6..0000000Binary files a/site/img/generated/study-bg.png and /dev/null differdiff --git a/site/img/generated/transition-02-03.png b/site/img/generated/transition-02-03.pngdeleted file mode 100644index ce310a1..0000000Binary files a/site/img/generated/transition-02-03.png and /dev/null differdiff --git a/site/img/generated/transition-04-05.png b/site/img/generated/transition-04-05.pngdeleted file mode 100644index 03e0d68..0000000Binary files a/site/img/generated/transition-04-05.png and /dev/null differdiff --git a/site/index.html b/site/index.htmlindex 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 & others</span>+ <li class="harness"> <span class="harness__name">Codex & 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.mjsdeleted file mode 100644index 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.mdindex 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 backgroundFlowing 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.mdindex 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 rulesdiff --git a/skill/references/generated-imagery.md b/skill/references/generated-imagery.mddeleted file mode 100644index 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.mdindex 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. |