Anti-AI-slop design skill for Claude Code, Cursor, and Codex.
CSS
Custom pages grow from the client's own material: an inventory, seven ideas of the form on this page X becomes Y, one move for the idea and plain exact craft for the rest
Youssefbfeffb729fb8
diff --git a/README.md b/README.mdindex ab93b3f..2754f23 100644--- a/README.md+++ b/README.md@@ -72,7 +72,7 @@ A theme is a material, not a plan: paper, ink, faces, rule weight, radius, shado## Custom-When the user asks for **custom** ("derive it", "bespoke", "no theme"), Hallmark leaves the catalog and designs the page from scratch: it names and rejects the category's reflex aesthetics, writes a slate of seven grounded directions, and a deterministic draw (`scripts/seed.mjs`) picks which one gets built while dealing three challengers from a curated atlas of complete design systems, each judged on audience identification and product clarity. A scene sentence sets the light, a colour posture sets how far the palette commits, `theme.mjs check` refuses any coordinate the catalog already occupies, and a five-block direction contract written into the artifact gets audited promise by promise before shipping. The protocol lives in [`direction.md`](skills/hallmark/references/direction.md).+When the user asks for **custom** ("derive it", "bespoke", "no theme"), Hallmark leaves the catalog and designs the page from the client's own material: it lists what only this client has, rejects the category's default page and its predictable opposite, and writes seven ideas of the form *on this page, X becomes Y*, each tested against the nearest competitor. A deterministic draw (`scripts/seed.mjs`) picks which idea gets built and deals one system discipline. The idea owns the palette, the type voice and one signature move; everything else stays plain and exact. Colours are sampled from the subject and argued one by one, pictures appear only where they carry a fact, and a five-line contract is audited promise by promise before shipping. The protocol lives in [`direction.md`](skills/hallmark/references/direction.md).---diff --git a/skills/hallmark/SKILL.md b/skills/hallmark/SKILL.mdindex 0d4b8e9..c4d9055 100644--- a/skills/hallmark/SKILL.md+++ b/skills/hallmark/SKILL.md@@ -84,7 +84,7 @@ Hold all of it; it is said once, at Step 5.Check in order; the first match wins.1. **The user named a theme** → build it (stamp `theme: <name> (by request)`).-2. **The user asked for custom** ("custom", "derive it", "bespoke", "no theme", "a world of its own") → load [`references/direction.md`](references/direction.md) and run the ritual. No deal and nothing from a theme: `theme.mjs check` on the triple, the display face and the accent hue comes back clear before code. Silence never takes this route.+2. **The user asked for custom** ("custom", "derive it", "bespoke", "no theme", "a world of its own") → load [`references/direction.md`](references/direction.md) and run the ritual: no deal and nothing from a theme. Silence never takes this route.3. **Everything else deals a theme:**```@@ -120,7 +120,7 @@ The run's only prose recital of its decisions, and the user's five-second redire- **Sweep** · run after build```-A custom run's rows are in `direction.md` R.7. Then one quiet line: *System portable? Say `lock the system` for a `design.md`.* Skip it in component scope or when `design.md` exists.+A custom run's rows are in `direction.md` R.8. Then one quiet line: *System portable? Say `lock the system` for a `design.md`.* Skip it in component scope or when `design.md` exists.On signal 9, `comp.md` runs here.diff --git a/skills/hallmark/references/brand-truth.md b/skills/hallmark/references/brand-truth.mdindex 2720763..413f77c 100644--- a/skills/hallmark/references/brand-truth.md+++ b/skills/hallmark/references/brand-truth.md@@ -23,7 +23,7 @@ logo: <official asset page URL>attestation: derived from the fetched sources above, not from memory```-5. **Theme from the spec.** Catalog route: the spec's primary anchors the accent conversion (OKLCH clamped per `craft.md` § 2). Custom route: `direction.md` § B.2's anchor accent IS the spec's primary; the ritual otherwise runs unchanged. The stamp records `brand: <name> (spec <date>)`.+5. **Theme from the spec.** Catalog route: the spec's primary anchors the accent conversion (OKLCH clamped per `craft.md` § 2). Custom route: the spec's primary is the anchor `direction.md` § B.1 samples first; the ritual otherwise runs unchanged. The stamp records `brand: <name> (spec <date>)`.## Caching and stalenessdiff --git a/skills/hallmark/references/comp.md b/skills/hallmark/references/comp.mdindex f285745..a391f82 100644--- a/skills/hallmark/references/comp.md+++ b/skills/hallmark/references/comp.md@@ -27,9 +27,9 @@ Two comps, three when the direction genuinely forks. One is not a choice and founode <skill-dir>/scripts/imagegen.mjs "<prompt>" --size 1280x800 --n 1 --out .hallmark/comps/c1.png```-The prompt is built from the direction contract, not from the brief. A prompt that reads like the brief produces the category default in pixels, which is the exact thing R.1 spent its budget refusing. Carry, in this order: the **scene sentence** (R.5), the **direction** in three or four words, the **paper and accent** as plain colour words, the **display class** (not the face name; no generator knows Erode), and the **macrostructure** as a compositional instruction. Then one negative clause naming what the category does, so the generator is pushed off it too.+The prompt is built from the direction contract or the theme line, not from the brief. A prompt that reads like the brief produces the category default in pixels, the rut `direction.md` R.2 refuses. Carry, in this order: the **first viewport** as the contract states it (what sits where, how large), the **idea** in a few plain words, the **ground and accent** as plain colour words, the **display class** (not the face name; no generator knows Erode), and the **macrostructure** as a compositional instruction. Then one negative clause naming what the category does, so the generator is pushed off it too.-> *"Web page hero, top 1280x800 only. A postal sorting office at 4am, one clerk under a single lamp. Warm kraft paper ground, one frank-red mark, deep ink. Huge condensed sans headline set hard against the left margin, three lines, enormous empty right two-thirds. A thin rule under the headline, nothing else above the fold. Flat, printed, no depth. Not a centred hero, no cards, no gradient, no screenshot."*+> *"Web page hero, top 1280x800 only. A rowing club's season set as one large race timetable, the next race the biggest line on the screen. White ground, deep green ink, one signal-yellow mark. Heavy grotesk headline flush left on five columns, two lines; the timetable on the other seven. A thin rule under the headline, nothing else above the fold. Flat, printed, no depth. Not a centred hero, no cards, no gradient, no device mockup."***Vary the comps on one axis only.** Two comps that differ in everything are two briefs, and comparing them tells you nothing about the decision you are actually making. Vary the composition (where the weight sits, symmetry against asymmetry, type-led against image-led) and hold the system fixed.@@ -84,9 +84,9 @@ Two rules on top:Ship the inventory as part of the comp message, under the comps:```-Hero ground raster kraft paper fibre, generated+Timetable code a real table, must reflowHeadline code type, must reflowRule under head code 1px, tokenised-Frank mark code SVG, it animates on scroll-Right two-thirds neither empty; the comp's floating card has no copy behind it+Next-race mark code the accent on one row, it moves once on load+Rower photograph raster library photo; the comp's crew is not a real crew```diff --git a/skills/hallmark/references/direction.md b/skills/hallmark/references/direction.mdindex 1fa107e..b6c829c 100644--- a/skills/hallmark/references/direction.md+++ b/skills/hallmark/references/direction.md@@ -1,90 +1,80 @@-# Direction: deriving the world+# Direction: a world of its own-The opt-in path. A build takes it only when the user asks (**custom**, "derive it", "bespoke", "no theme", "a world of its own"). The direction is made to measure for one brief, written inline into the page's `:root`, never a catalog entry. Two depths: **tuned** (a complete OKLCH palette and a free-font pairing on Hallmark's structures) and **bespoke** (the structure and composition designed from first principles too).+The opt-in path. A build takes it only when the user asks (**custom**, "derive it", "bespoke", "no theme", "a world of its own"). The direction is made for one brief and written into the page's own tokens; it never enters the catalog.-The ritual exists because the model's own taste is an attractor: asked for "something unique", a model ships the same two or three looks per category every time, and letting it choose is letting it repeat itself. The steps below are outside interventions: named rejections, a deterministic draw, a scene the palette must obey, and a contract the build is audited against. Every gate fires unchanged at every depth; the Picks block surfaces the direction, posture, palette and pairing before code so the user can redirect.+Left to its own taste a model ships the same few looks per category, and asked to be unusual it reaches for costume: a world painted onto the page (dials, stamps, paper, engraving) instead of a page that knows its subject. The ritual works against both. The idea comes from the client's own material, a seed picks among the candidates, the idea gets one move, and the rest of the page is plain and exact. Every gate fires unchanged; the Picks block shows the idea, the palette and the pairing before code so the user can redirect.-**Nothing from the catalog.** A custom run never runs the deal, never opens a theme file, and never borrows a theme's faces, palette or surfaces; the catalog's coordinates are the one thing it reads, through `theme.mjs check`, so that it can stay away from them. The test is the reviewer's: if a fresh reader could name the catalog theme this page resembles, the run failed and the world is reworked before the sweep.+**Nothing from the catalog.** A custom run never deals and never opens a theme file, and its display face is one no theme sets. The reviewer's test: if a fresh reader could name the catalog theme this page resembles, rework it before the sweep.-**The catalog takes it back** when the user names a theme ("custom, something like Newsprint" is a theme pick with a mood note), when a `design.md` or a real brand already exists (inherit it), and in component scope. `--fast` on a custom ask is a contradiction: take the catalog and say so.+**The catalog takes it back** when the user names a theme ("custom, something like Newsprint" is a theme pick with a mood note), when a `design.md` or a real brand already exists (inherit it), and in component scope. `--fast` on a custom ask resolves to the catalog; say so.## The ritual-Runs in order before any palette work. Each step is one or two written lines; the whole ritual reads as a short paragraph of decisions, not a form.+In order, before any palette work. Each step is a line or two; the whole reads as a short paragraph of decisions, not a form.-**R.1 Reflex check.** Name the category's obvious aesthetic and its tasteful second-order fallback, then reject both in writing: *Reflex check: rejecting sage-and-cream (the category default) and editorial serif on bone (the tasteful fallback).* The default and its predictable opposite are both the rut. Two more altitudes: would the slate you are about to write fit the category's other products unchanged (then it is category gravity), and could someone guess the aesthetic from the category plus what Hallmark always avoids (then the avoidance is the pattern)? If either is obvious, rework.+**R.1 Inventory.** Eight to twelve things only this client has: the name and what it means, the place and what it looks like, what the product does (one verb), its real numbers, its one constraint, its rituals and hours, the things its world prints, makes or wears, and the material the brief supplies. Mark each *shown* (a photograph of it exists, or it can be built) or *said* (it lives in words).-**R.2 Spent defaults.** Already worn out for the brief family, declared before the slate: warm, bookish, food, family → cream paper, serif display, lamplight amber; tech, developer, AI → near-black, one neon accent, mono labels; editorial, studio, portfolio → bone paper, high-contrast serif, hairlines everywhere; playful, consumer → rounded sans, candy accent on white, blobs; luxury, craft → ivory, letterspaced small caps, no accent; health, science → clinical white, single blue, geometric sans; finance → navy, emerald, tabular mono; events, music → black, duotone photo, condensed caps. Spent in every family: pill buttons, cream or off-white paper, an italic accent word, `01 / 02 / 03` labels and mono labels, the defaults the field's own guides now name. A spent look can still be earned by a draw that demands it; drifting there is what is banned.+**R.2 The rut.** Name the page this category always ships and its predictable opposite; both are out. Spent in every family: cream, off-white or greige paper (warm beige is the same rut one step darker; take it only when the subject's own material is that colour, and say so), near-black with one neon accent, pill buttons, an italic or coloured word in a head, numbered or mono labels, a card grid, a centred head over three features. Your own rendition prior is spent too: a warm, bookish or family subject pulls Claude toward cream, serif and lamplight whatever the draw said, so re-read the idea before code and rework from the subject's own colours if the page drifted.-Your own rendition prior is spent too, and it bites at execution rather than selection. Claude renders warm, bookish and child-facing subjects as cream, serif, italic accents and lamplight whatever the draw said; before writing code, re-read the OWN-WORLD block, and if it says cream, paper, parchment, ivory or lamplight on a brief that never pinned them, rework from the world's saturated materials. Codex renders a tight grotesk at 600 on near-white with one blue accent and a bordered soft-shadow card. Gemini renders gradient ramps as material and hover motion on images. Open-weight models revert mid-build: the first viewport commits, section three becomes a card grid on white.+**R.3 The slate.** Seven candidates, numbered, one line each, written as *on this page, [an inventory item] becomes [a form]*. A form is a way of laying out information that this audience already knows how to read, taken from the client's own world: a document, a sign, a listing, a notation, a publication. Forms carry their restraint with them; an object that would have to be faked in CSS is not a form. Spread the seven across shown and said items, and give the brief's own noun one seat at most. Test each with the nearest real competitor: if the line still fits with their name in it, it belongs to the category, so rewrite it.-The catalog's own coordinates are spent as well: `node <skill-dir>/scripts/theme.mjs check --axes "<paper>/<display>/<accent>"` at § D tells you whether the triple you are about to build already exists.--**R.3 The slate.** Seven grounded directions, numbered, one line each: a concrete visual system, artifact, place or ritual this audience already knows, with the germ of a system grammar. *3. The pharmacy blotter: clinical buff card, one federal-blue rule system, dosage-table typography.* Not adjectives, not moods. Two questions pull the list off the obvious: what would this thing look like as a physical object, and what did its world look like before the web? The audience's graphic traditions count (a notation system, a documentation standard, a school of poster). Spread across at least three material families; the brief's own noun gets at most one seat.--**R.4 The draw and the challengers.** The model never hand-picks from its own slate. Run:+**R.4 The draw.** The model never picks its favourite:```-node <skill-dir>/scripts/seed.mjs --brief "<the brief, as the user wrote it>" --n 7+node <skill-dir>/scripts/seed.mjs --brief "<the brief, as the user wrote it>" --n 7 --material photo|product|words```-It prints a reproducible line (`draw: n/7 (seed <slug>·<date>·r0) · challengers: <a> · <b> · <c>`) and deals three challengers from `scripts/atlas.json`, one from each tier (a graphic system, an instrument language, an atmosphere world), each with a five-line system grammar and one named browser technique. Judge each against the drawn entry on exactly two axes, audience identification and product clarity, one written line per challenger ending in **wins** (it replaces the drawn entry), **competitive** or **declined**. A winning challenger supplies the form and its grammar; the product supplies every fact, name and claim; clarity wins every conflict. A losing challenger still donates: the strongest loser names the one discipline the drawn direction lacks, and the direction is raised to match (*raise: the mixing desk's per-function control colouring, on the pricing tiers*). Every custom run ships a winning challenger or one named raise. Re-roll only when the user asks (`--reroll 1`). Without Node: N = letter count of the brief mod 7, entry N + 1, printed so it is reproducible; skip challengers; stamp `seed: fallback-<letters>·<date>·r<n>`.+It prints `draw: n/7 (seed <slug>·<date>·r0)` (build slate line n), the faces for § C, and one **discipline**: a system rule about how far colour commits, how the grid holds, how the type steps or how pictures sit. Take it unless the material refuses it, and give a refusal one line in the Picks block. Re-roll only when the user asks (`--reroll 1`). Without Node: entry (letters in the brief, mod 7) + 1, no discipline; stamp `seed: fallback-<letters>·<date>·r<n>`.++**R.5 Reach.** The idea owns three things: the palette, the type voice and one signature move, on the first screen and echoed once at most. Everything else is plain and exact: the nav, the buttons, the forms, the section anatomy and every state are conventional, in the idea's colours and faces, and the regions around the signature hold still. Painted physicality (a bevel, an emboss, an engraving, paper or grain as a surface, a knob or a dial as ornament, a stamp) is costume: the page knows its subject, it does not dress up as it.-**R.5 The scene sentence.** One concrete sentence placing a real person at a real time and place with the product: *a subscriber in Vermont, 6:43 am in early January; the kettle just clicked off; one lamp on.* It decides surface lightness and light temperature before any palette work, and which photographs the page asks the library for; write it once.+**R.6 The page plan.** The sections as claims, one line each with the proof it shows and the composition it takes (`layout.md` § 5): no composition twice, the signature in the hero, the strongest real material next. Number stages only when they are a real sequence, and set rows only for a real list; a run of Steps, Rows and a closing Band is the template whatever paints it.-**R.6 Colour posture.** Exactly one, with a one-line reason: Restrained (accent under 5%), Committed (one colour carries 30 to 60% through the field or paper tokens), Full palette (three or four named roles with jobs), Drenched (the surface is the colour). Declared in the stamp and the log; gate 23 reads it.+**R.7 Colour posture.** Exactly one, with a reason: Restrained (accent under 5%), Committed (one colour carries 30 to 60% of the page as whole fields), Full palette (three or four named roles with jobs), Drenched (the ground is the colour). The stamp and the log carry it; gate 23 reads it.-**R.7 The direction contract.** Five blocks, 150 words or fewer, as a comment directly below the stamp and critique line. The Picks block mirrors it and replaces its Theme row with **Direction** (the draw, the challengers, the raise) and **System** (palette, pairing, the catalog coordinates it cleared):+**R.8 The contract.** Five lines, 120 words or fewer, a comment directly below the stamp and critique line:```/* direction contract · seed <key>- * THESIS: the one-sentence position this page takes.- * OWN-WORLD: what makes it not-anyone's-page; the drawn direction, named.- * STORY: the scene sentence.- * FIRST-VIEWPORT: what the fold shows, concretely.- * FORM: structure plus the one signature move a visitor would describe to a friend. */+ * THESIS: the position the page takes, and the category default it refuses.+ * IDEA: on this page, <inventory item> becomes <form>; the signature move.+ * FIRST VIEWPORT: what sits where, how large, and where the action is.+ * SYSTEM: ground, ink and accent with where each came from; display and body; the three sizes.+ * ANTI: the page it must not be mistaken for (a real site or a familiar template) and the two moves that would make it that. */```-If a block reads like a mood ("elegant, premium feel"), the direction is not decided yet. The stamp adds `theme: custom · direction: "<drawn>" · vibe: "<4 to 8 words>" · paper: oklch(…) · accent: oklch(…) · display: <face> · body: <face> · axes: <triple> · posture: <posture> · seed: <key> · challenger: <name> (<verdict or raise>) · contract: kept (5/5)`, the last field written only after the finish review confirms it; the log entry carries the same fields.--## Bespoke depth+A line that reads like a mood is undecided. The stamp adds `theme: custom · idea: "<the drawn line, n/7>" · vibe: "<4 to 8 words>" · paper: oklch(…) · accent: oklch(…) · display: <face> · body: <face> · axes: <triple> · posture: <posture> · seed: <key> · discipline: <the dealt rule, or refused: why> · contract: kept (5/5)`, the last field written only after the finish review; the log entry carries the same fields. The Picks block replaces its Theme row with **Idea** (the drawn line, the discipline) and **System** (the palette with its sources, the pairing).-The brief's structure itself is the ask and no catalog shape fits (a scroll-assembled poem, a ticket-shaped page). The ritual runs identically; the build may drop the shape catalog, the genre routing and the rotation (a one-off must still not clone a recent bespoke run). It keeps every gate, access and contrast, the font discipline, the OKLCH discipline, one orchestrated motion, the Picks block, the stamp and the log. Bespoke is more judgement, not less, and it is rare; reaching for it on a vanilla brief is over-reach.+## A. Pictures-## A. The vibe+They come from R.1, never from a mood. A shown item with a real photograph (the place, the food, the people at the work) leads, as `imagery.md` § 1 says, and one decisive photograph beats five. Software and ideas show the product built, or let type and colour carry the page: a first screen of type alone is a full answer. Every picture passes the deletion test: take it away and the page loses a fact. A city at night, a laptop on a desk or an office building on a software page fails it.-Step 1 already asks for it, with an anchor colour if there is one, never in a second message. Two words are enough to proceed (*archival warmth, hand-set, no varnish*; *moss, lichen, soft pink, herbal*); a paragraph compresses to eight for the stamp.+## B. Palette: sample, converge, argue-## B. Palette construction+1. **Sample.** The first source that exists: the anchor colour the user gave (a real brand's from `.hallmark/brand-spec.md`, never memory); the colours of the photographs the page will show (the hero's dominant and its one strong hue); the subject's own materials (its interface, its paint, its packaging, its landscape). Never a hue for the category, such as blue for software or green for health.+2. **Converge.** A ground, an ink and one accent; under Committed or Drenched, one field colour beside them. Two chromatic colours at most, plus neutrals.+3. **Argue.** One clause per colour in the SYSTEM line saying where it came from. A colour with no source is a default.+4. **Ground.** Its lightness follows when and where the page is read: light L 95 to 99 (white with `surface: absolute` in the stamp, 7b), mid L 30 to 85, dark L 12 to 20. Cream, ivory, parchment and blue-black only when the subject pins them.+5. **Ink and neutrals.** Ink L 16 to 24 on a light ground, 88 to 96 on a dark one; the rule, the muted text and the second ink step toward the ground, tinted toward the accent at chroma 0.005 to 0.012 (22).+6. **Accent.** Chroma 0.12 to 0.20 and a stated role (the actions, focus, the one mark). The focus ring takes its hue at chroma 0.18 to 0.22; accent-ink reaches 4.5:1.+7. **Check** gates 7, 22, 23 and 65 before code. Texture only where a photograph is the ground; never paper, grain or noise as a surface.-1. **Posture and scene set the frame.** The scene fixes the paper's lightness band and light temperature; the posture decides where large colour lives.-2. **Anchor accent first.** Convert the given anchor to OKLCH and clamp chroma to 0.12 to 0.20; a real brand's anchor comes from `.hallmark/brand-spec.md`, never memory. No anchor: derive the hue from the vibe (warmth 30 to 60°, technical 220 to 250°, botanical 130 to 160°, late-night neon 280 to 320°, sun-drenched 60 to 80°), chroma 0.12 to 0.16.-3. **Paper.** From the scene: bright and airy L 95 to 98 warm-tinted; archival L 92 to 95; clinical L 98 to 99 cool-tinted; dark and late-night L 12 to 18 anchor-tinted. Always tinted toward the anchor at chroma 0.005 to 0.020. Committed posture puts the carried colour in `--color-field`; Drenched makes paper the anchor at a usable lightness. Paper-2 steps 2 to 4% L, paper-3 5 to 7%.-4. **Ink.** Paper under 50% L: ink L 88 to 96; over: L 16 to 24; tinted 0.005 to 0.014. Ink-2 sits 4 to 8% L toward paper.-5. **Neutrals.** Rule (L 70 to 82 on light paper, 26 to 34 on dark), rule-2 closer to paper, muted (L 38 to 56), all tinted 0.005 to 0.018.-6. **Focus.** The accent's hue, chroma 0.18 to 0.22, L within 5% of the accent.-7. **Accent-ink.** Ink on an accent lighter than 50% L, paper on a darker one; verify 4.5:1.-8. **Texture** only on a print-lineage draw (riso, letterpress, ticket stock, line printer), one artifact from `texture.md` under its budget.-9. **Verify** against gates 7, 22, 23, 65: paper and ink both carry chroma, every grey is 0.005 or more, the accent has a stated role, and the triple is not cream, high-contrast serif and clay unless the brief pinned it.+## C. Type-## C. Font pairing+One family or two, three with an outlier that carries one role (a wordmark, a figure, code). The display face is one no catalog theme sets: run `node <skill-dir>/scripts/theme.mjs check --face "<face>"`. Take the class the idea calls for from `fonts.md`; the draw's `faces` line deals one face per class and a body face of each kind, so start from those, and swap one only when it fails on the real headline, judged by its shape and never its name (a subject association is not a reason); the Picks block says why. Three sizes carry the page, far apart: the display at least four times the body and the section head between them; titles and leads stay one step from the body. Labels take the body face, sentence case, untracked (64, 67); a head is one weight and one colour (38iii). Free faces only unless the user confirms a licence.-A derived system pulls from `fonts.md` and may mix tones (an editorial display over a technical body, a brutalist display over an editorial body). One display face, one body face, an optional outlier for one role. The display face is one no catalog theme sets (`theme.mjs check --face` refuses the ones in use). Free faces only unless the user confirms licences; the banned defaults stay banned; variable fonts preferred. The drawn direction should be audible in the pairing: a ledger wants tabular figures, a playbill wants wood-type energy. Labels take the body face, sentence case, untracked, unless mono is the world's material (64, 67); a head is one weight and one colour (38iii).+## D. Axes-## D. Axes and posture+Declare the triple so Rotation reads it like a catalog theme's: paper band (dark under 30% L, mid 30 to 85, light over 85), display class (`fonts.md`), accent band (warm 10 to 60°, cool 200 to 300°, neutral under 0.05 chroma, chromatic-<name>), plus the posture. `node <skill-dir>/scripts/theme.mjs check --axes "<triple>" --face "<face>" --hue <h> --log .hallmark/log.json` names any catalog theme or recent build on the same coordinates. Then look at that theme's picture beside the page you are planning: move a coordinate only if the two would read alike, and say which in one line. Specificity, not distance on a chart, is what separates a custom page from the catalog.-Declare the triple so Rotation reads it like a catalog theme's: paper band (dark under 30% L, mid 30 to 85, light over 85), display class (roman-serif, high-contrast-serif, slab-serif, grotesk-sans, grotesk-heavy, geometric-sans, rounded-sans, display-condensed, display-heavy, mono, pixel, handwritten, blackletter), accent band (warm 10 to 60°, cool 200 to 300°, neutral under 0.05 chroma, chromatic-<name>), plus the posture. Then:--```-node <skill-dir>/scripts/theme.mjs check --axes "light/roman-serif/cool" --face "Sentient" --hue 250 --log .hallmark/log.json-```+## Bespoke depth-It refuses a triple a theme owns, a display face a theme sets, and an accent within 20 degrees of a theme that shares the paper band and display class. A collision with a catalog theme or a recent build is a failed reflex check, not a coincidence: move one axis, the one the brief cares least about (usually the accent, occasionally the paper, rarely the display), and say it happened in one line: *Landed on Cobalt's triple; moved accent to chromatic-moss ~145.* Two narrow exceptions: the user asked for that theme's feel (stamp `axes: <triple> (Cobalt, by request)`), or the draw genuinely demands the coordinate, argued in one line. Siblings built side by side in other projects count as occupied too.+The brief's structure itself is the ask and no shape fits (a scroll-assembled poem, an index that is the whole page). The ritual runs as written; the build may drop the shape catalog, the genre routing and the rotation. It keeps every gate, the font and OKLCH discipline, one orchestrated motion, the Picks block, the stamp and the log. It is rare: on a vanilla brief it is over-reach.## The finish review-Before the sweep, re-read the contract promise by promise: is THESIS still the page's position, is OWN-WORLD visible in the shipped surface or did the build drift back toward a spent default, is STORY's light still in the palette, is FIRST-VIEWPORT what the fold shows, is FORM's signature move present and load-bearing? Any unkept promise is a revision, not a ship. Then Step 7 runs as normal, and the fresh-context reviewer in `gates.md` § 6 gets the contract.+The fresh-context reviewer gets the contract (`review-finish.md` has what a custom run adds). Before the sweep, re-read the contract yourself, promise by promise: an unkept promise is a revision, not a ship.## What derivation does not do-It does not lower the floor (a derived page that trips a gate is broken, not expressive). It does not extend the catalog (the system is inline for this page). It does not invent facts (gate 46a binds hardest where a fresh world makes invented proof feel at home). It does not skip the draw (a stamp with no seed line is over-invented; audit it). It does not mean more decoration: a derived system is a tighter argument than a catalog theme, not a louder one.+It does not lower the floor, extend the catalog, invent facts (46a binds hardest where a fresh world makes invented proof feel at home) or skip the draw. It does not mean more decoration: a derived system is a tighter argument than a catalog theme, not a louder one.diff --git a/skills/hallmark/references/fonts.md b/skills/hallmark/references/fonts.mdindex d025634..e9d2c0f 100644--- a/skills/hallmark/references/fonts.md+++ b/skills/hallmark/references/fonts.md@@ -2,17 +2,17 @@Loaded on a custom run. A catalog theme has already named its faces; do not read this to second-guess it.-**Needs before reading:** the drawn direction, the genre, and the tone word from Step 1. **Gives:** a display face, a body face, an optional outlier, and the load rules.+**Needs before reading:** the drawn idea and the material it shows. **Gives:** a display face, a body face, an optional outlier, and the load rules.## The rule-One display face, one body face, an optional outlier that carries exactly one role (a wordmark, a headline figure, code). A custom run picks a display face no catalog theme sets: `node <skill-dir>/scripts/theme.mjs check --face "<face>"` refuses the ones in use, so run it before writing the token. The lists below already leave those faces out. Free faces only unless the user has confirmed a licence; variable fonts preferred; the drawn direction should be audible in the pairing (a ledger wants tabular figures, a playbill wants wood-type energy).+One display face and one body face, or one family for both; an optional outlier carries exactly one role (a wordmark, a headline figure, code). A custom run picks a display face no catalog theme sets: `node <skill-dir>/scripts/theme.mjs check --face "<face>"` refuses the ones in use, so run it before writing the token. The lists below already leave those faces out. Choose the class the idea calls for, then two or three faces from it, and decide on the real headline set in each, by shape and colour on the page; a face's name, its reputation or a subject association is not a reason. Free faces only unless the user has confirmed a licence; variable fonts preferred.## Banned as a defaultEvery model reaches for these first, so they read as unchosen: Inter, Roboto, Open Sans, Lato, Poppins, Source Sans, Nunito, Montserrat, Raleway, Work Sans, DM Sans, Plus Jakarta Sans, system-ui, Arial and Helvetica as a display or body face; Merriweather, Lora and Georgia as the body serif; Courier New or the system mono. A page may still use one of them when the user asks for it or the pre-flight found it in the project; then the stamp says so.-**Saturated** (fine faces, but the first answer, so they want an argument in the Picks block): Playfair Display, Cormorant Garamond, DM Serif Display, Fraunces, Instrument Serif, Recoleta, Space Grotesk, Bebas Neue and Unbounded as display; Geist, Instrument Sans and Mona Sans as the body or the whole page.+**Saturated** (fine faces, but the first answer, so they want an argument in the Picks block): Playfair Display, Cormorant Garamond, DM Serif Display, Fraunces, Instrument Serif, Recoleta, Space Grotesk, Hubot Sans, Bebas Neue and Unbounded as display; Geist, Instrument Sans and Mona Sans as the body or the whole page.## Sources@@ -39,21 +39,6 @@ Every model reaches for these first, so they read as unchosen: Inter, Roboto, OpA body face may be one the catalog uses; bodies are not a theme's signature. Sans: Hanken Grotesk, IBM Plex Sans, Figtree, Onest, Sofia Sans, Golos Text, Karla, Chivo, Albert Sans, Public Sans, Archivo, Manrope (Google); Switzer, General Sans, Satoshi (Fontshare). Serif: Newsreader, Source Serif 4, Literata, Spectral, Crimson Pro, EB Garamond, Piazzolla (Google); Sentient (Fontshare). Mono for code, figures and measurements: Geist Mono, JetBrains Mono, IBM Plex Mono, DM Mono, Fira Code, Azeret Mono, Chivo Mono, Overpass Mono (Google).-## Pairings by tone--Free faces, working out of the box. The display column lists faces no theme sets; take one, not a blend.--| Tone | Display | Body |-| --- | --- | --- |-| Editorial | Gambetta, Castoro, Gloock, Clash Grotesk | IBM Plex Sans, Switzer, Source Serif 4 |-| Technical | Space Mono, Fragment Mono, Rethink Sans 700 | IBM Plex Sans, Switzer, Onest |-| Brutalist | Clash Display 700, Panchang, Alfa Slab One, Teko | Archivo, Switzer, Public Sans |-| Soft | Satoshi, Recia, Alegreya, Chubbo | Figtree, Crimson Pro, Onest |-| Luxury | Erode, Libre Bodoni, Marcellus, Gloock | EB Garamond, Crimson Pro, Source Serif 4 |-| Playful | Comico, Hubot Sans 800, Shantell Sans, Tiny5 | Onest, Karla, Satoshi |-| Austere | Geologica 300, Rethink Sans, Reddit Sans | Switzer, Hanken Grotesk, Public Sans |-| Atmospheric | Melodrama, Supreme 600, Piazzolla, Michroma | Sofia Sans, Sentient, Albert Sans |-## The wordmarkThe wordmark in the nav and footer may take a different face from the body, and on tone-rich pages it should: collapsing it into the body family flattens the hierarchy and the page reads as un-branded. It is the outlier's one role when the page has no other:@@ -63,7 +48,7 @@ The wordmark in the nav and footer may take a different face from the body, and.wordmark { font-family: var(--font-outlier); font-weight: 600; letter-spacing: -0.015em; }```-Collapse to one family only when the body voice is the brand (a letter, a manifesto, a long document). A product page whose wordmark is the body face at 600 is the un-designed default.+Collapse to one family only when the body voice is the brand (a letter, a manifesto, a long document) or a one-family discipline was dealt; then the wordmark takes the family's display cut or its heaviest weight. A product page whose wordmark is the body face at 600 is the un-designed default.## Loadingdiff --git a/skills/hallmark/references/gates.md b/skills/hallmark/references/gates.mdindex 2ca7f26..14a3635 100644--- a/skills/hallmark/references/gates.md+++ b/skills/hallmark/references/gates.md@@ -44,7 +44,7 @@ Before the gate sweep, score the planned page 1 to 5 on six axes. Anything under| **R**estraint | keeps one decoration too many | lost something you liked || **V**ariety | differs from the log on three of six structural axes | shares almost nothing with the last three runs |-Stamp: `/* Hallmark · pre-emit critique: P5 H4 E5 S3 R5 V4 · weakest: S, hero could be any dev tool; added the ledger-rule motif */`. Name the weakest axis and the fix taken; straight 5s name what was cut to earn them. Never invent a weakness to fill the field.+Stamp: `/* Hallmark · pre-emit critique: P5 H4 E5 S3 R5 V4 · weakest: S, hero could be any dev tool; led with the real deploy log instead of a stock dashboard */`. Name the weakest axis and the fix taken; straight 5s name what was cut to earn them. Never invent a weakness to fill the field.## 4. The gates@@ -223,7 +223,7 @@ The gates above that a script cannot settle, with enough to judge them well.## 6. The reviews, in fresh context-The thread that built the page is its weakest reviewer. Two reviews run with no inherited transcript (a subagent in Claude Code): the **hero review** once at Step 6, before any section below the fold exists, and the **finish review** at Step 7. When a subagent can run them, do not read their briefs yourself: start the reviewer with *Read `<skill-dir>/references/review-hero.md` (or `review-finish.md`) and follow it* and pass these, files as paths and lines as quoted text. The hero review: the four `hero-*` screenshots, the stamp's first two lines, the Picks block's Material and Signature rows, the theme's picture. The finish review: the render tier's screenshots, the page's HTML or component source, the stamp's theme line or direction contract, the theme's picture, the hero review's findings with how each was settled, `gates.md` § 4, and on a redesign the `before` screenshots. Wait for it once.+The thread that built the page is its weakest reviewer. Two reviews run with no inherited transcript (a subagent in Claude Code): the **hero review** once at Step 6, before any section below the fold exists, and the **finish review** at Step 7. When a subagent can run them, do not read their briefs yourself: start the reviewer with *Read `<skill-dir>/references/review-hero.md` (or `review-finish.md`) and follow it* and pass these, files as paths and lines as quoted text. The hero review: the four `hero-*` screenshots, the stamp's first two lines, the Picks block's Material and Signature rows, the theme's picture. The finish review: the render tier's screenshots, the page's HTML or component source, the stamp's theme line or direction contract, the theme's picture, the hero review's findings with how each was settled, `gates.md` § 4, and on a redesign the `before` screenshots. Run it in the foreground, since the build waits on its first word (in Claude Code, `run_in_background: false`), never behind a timer or a wake-up.Act on its first word. `recapture` means the screenshots were wrong (a fallback face, a blank frame): retake them and start the review again; it does not use up the one round. Otherwise fix what is real, recapture the same shots (`--stage hero` for the hero), and score each finding yourself against its recapture: `resolved`, `partial` or `unresolved`, with a reason. Send the recaptures back for one scoring round only when the first word was `rebuild` or a finding named a Floor gate; scoring is not a second review. Record the outcome in the stamp, hero first: `hero-review: fix · 4 findings · 4 resolved`, then `finish-review: subagent · 5 findings · 4 resolved 1 unresolved · gap: none`. No subagents: then, and only then, read the brief, re-read the artifact cold, run the brief against yourself, and record `in-thread`.diff --git a/skills/hallmark/references/imagery.md b/skills/hallmark/references/imagery.mdindex f10ea77..8571f38 100644--- a/skills/hallmark/references/imagery.md+++ b/skills/hallmark/references/imagery.md@@ -15,7 +15,7 @@ In order, the first that fits:Which briefs want which:- **A place, a material, food or drink, an object, a craft, the outdoors, an event, people at work** (a bakery, a ski school, a gin, a weaving studio, a venue, a tailor, a farm): photographs lead, as they do on three in four real sites in these trades. The hero's photograph is the largest thing on the first screen (full-bleed behind the head, or beside it at 60 to 75% of the screen tall), and the page carries about one a screen after it, a third of them large, the rest in pairs and sets with a fact each.-- **Software** (SaaS, an app, a developer tool): the product leads, and the hero visual is its interface. One or two photographs may set the scene: where it is used, the material it handles, hands at the work it serves.+- **Software** (SaaS, an app, a developer tool): the product leads, and the hero visual is its interface. One or two photographs may set the scene: where it is used, the material it handles, hands at the work it serves. Each must pass the deletion test (take it away and the page loses a fact); a generic scene (a city at night, a laptop on a desk, an office building) fails it and goes.- **Words** (docs, an API, a CLI, a type specimen, a manifesto or a letter about an idea): type and code carry it; one photograph as a full-bleed band is the most a page takes. A manifesto or a letter about something physical (repair, a river, a street) shows it like any other page.A photograph never stands in for a fact: the brief's numbers, names and claims stay in type, and a picture of a person never stands in for a customer, a teammate or a testimonial (F9).diff --git a/skills/hallmark/references/review-finish.md b/skills/hallmark/references/review-finish.mdindex c7b3dec..d00cc0d 100644--- a/skills/hallmark/references/review-finish.md+++ b/skills/hallmark/references/review-finish.md@@ -10,6 +10,8 @@ Scroll the 1440 full page one screen at a time before ranking: a screen with notThen one answer to the question no gate can: does the stamp's contract or theme describe the page in front of you? Name the largest gap, or say there is none.+On a custom run (`theme: custom`), before you read the contract, write four lines of your own from the screenshots: what the page is about, its palette and type, each section's composition in one word, and the one move a visitor would remember. Then three checks, each a finding when it fails. **Costume:** painted physicality (a bevel, an emboss, an engraving, paper or grain as a surface, a knob or a dial as ornament) or one device repeated more than twice. **Template:** two sections with the same composition, or a run of numbered steps, hairline rows and a closing band. **Swap:** put the nearest competitor's name on the page; if it still works, the idea is the category's, and say which section gives it away. Last, the contract's ANTI line: does the page read as the lookalike it names?+On a redesign you also get the `before` screenshots, and the content is fixed: never ask for copy, an action or a visual the old page did not have. Add one answer: what did the old page do better? Name anything a visitor could do, read or find before that is harder now; if nothing, say so. On a polish you get only the full pages at 1440, before and after: the layout was kept on purpose, so ask one thing, whether anything still reads as machine-made, in at most five findings.On an app screen (the stamp says `shape: app screen`) there is no hero, fold or section rhythm to judge, and the gates `flow.md` § App screens skips are not findings. Read the full screens at 1440 and 375 and ask what someone fluent in the category would: is the hierarchy clear, is the density even, does every control and table work on a phone, are the states there.diff --git a/skills/hallmark/scripts/atlas.json b/skills/hallmark/scripts/atlas.jsondeleted file mode 100644index 3f28342..0000000--- a/skills/hallmark/scripts/atlas.json+++ /dev/null@@ -1,1332 +0,0 @@-[- {- "name": "Basel grid",- "tier": "graphic-system",- "lineage": "Swiss International Style, Basel and Zurich schools, 1950s-70s",- "spark": "The grid is not scaffolding you hide; it is the design, and one red mark does all the emotional work.",- "system": [- "Palette/material: white surface with the column grid exposed as hairlines; ink near-black; exactly one signal red per viewport",- "Type/composition: one neo-grotesque family at two weights; flush-left rag-right; size jumps of 3x, never 1.2x",- "Topology/navigation: content locks to twelve columns with asymmetric spans; nav is a single ruled line of text links",- "Controls/state: buttons are ruled boxes that invert to ink on press; active state is the red mark migrating",- "Responsive/motion: columns collapse by halving; motion is none or a single hard-cut reveal"- ],- "webLeverage": "CSS subgrid keeps nested content on the exposed master grid",- "fits": [- "institutions",- "agencies",- "engineering tools"- ]- },- {- "name": "Bauhaus catalog",- "tier": "graphic-system",- "lineage": "Bauhaus Dessau exhibition catalogs and prospectuses, 1920s",- "spark": "A page that believes geometry is moral: circle, triangle, bar, and a diagonal that earns its angle.",- "system": [- "Palette/material: warm off-white with primary red, blue, yellow as flat geometry, never as tints",- "Type/composition: geometric sans, heavy lowercase; rotated type only along a load-bearing diagonal",- "Topology/navigation: sections keyed by a numbered geometric marker; nav is a horizontal band of numbers",- "Controls/state: hover fills the shape behind the label; pressed swaps figure and ground",- "Responsive/motion: the diagonal flattens to horizontal bands on small screens; one rotation animates once"- ],- "webLeverage": "CSS transform with transform-origin makes the rotated headline settle once on load",- "fits": [- "design tools",- "education",- "manifestos"- ]- },- {- "name": "Constructivist poster",- "tier": "graphic-system",- "lineage": "Rodchenko and El Lissitzky poster work, 1920s",- "spark": "Red wedge, black bar, a shouted word set on the diagonal: the page as agitation.",- "system": [- "Palette/material: bone paper, red and black only; no third colour exists",- "Type/composition: condensed caps stacked and angled; scale contrast does the shouting",- "Topology/navigation: hard wedges and photomontage crops direct the eye along one vector per viewport",- "Controls/state: controls are black bars; hover drives the red wedge through them",- "Responsive/motion: angles reduce to stacked bars on mobile; one wedge translates in, once"- ],- "webLeverage": "clip-path polygons build the wedges and crops without images",- "fits": [- "events",- "campaigns",- "bold launches"- ]- },- {- "name": "Deco travel poster",- "tier": "graphic-system",- "lineage": "Art Deco railway and ocean-liner posters, 1920s-30s",- "spark": "Dusk laid down in flat bands behind one monumental object that owns the page.",- "system": [- "Palette/material: gradient dusk rendered as four flat stepped bands, never a smooth mesh; deep navy ground at the base",- "Type/composition: tall geometric display caps, tight tracking; a small ruled caption footer",- "Topology/navigation: one monumental subject per section, small text yields to it; nav is a slim top rule",- "Controls/state: buttons are lozenges with a metallic-adjacent border; hover deepens the band behind them",- "Responsive/motion: bands stay full-bleed at every width; parallax banned, one slow band-light shift allowed"- ],- "webLeverage": "repeating-linear-gradient with hard colour stops builds the stepped dusk in one declaration",- "fits": [- "travel",- "hospitality",- "events"- ]- },- {- "name": "NASA standards",- "tier": "graphic-system",- "lineage": "NASA Graphics Standards Manual, Danne and Blackburn, 1975",- "spark": "A specification page so confident it numbers its own figures.",- "system": [- "Palette/material: cool white; one federal red accent; grey only as hairline rules",- "Type/composition: wide grotesque caps for headings, tracked no wider than 0.04em; body flush-left under ruled captions",- "Topology/navigation: numbered figures (fig 4.1) anchor every section; nav is a numeric index",- "Controls/state: controls carry spec numbers; active state is the red rule thickening under the number",- "Responsive/motion: figures reflow but keep their numbers; motion limited to a measured underline draw"- ],- "webLeverage": "CSS counters auto-number figures and sections so the numbering never drifts",- "fits": [- "aerospace-adjacent tech",- "developer platforms",- "hardware"- ]- },- {- "name": "Penguin grid",- "tier": "graphic-system",- "lineage": "Penguin paperback covers, Tschichold and Marber grid, 1947-62",- "spark": "Three fixed bands, colour codes the category, and the band line never moves an inch.",- "system": [- "Palette/material: one saturated category colour filling the top band; cream centre band; the colour returns at the base",- "Type/composition: serif title case in the cream band; publisher-mark discipline, nothing decorative",- "Topology/navigation: every section is the same band structure at a fixed ratio; colour changes, structure never does",- "Controls/state: controls live in the colour band and reverse out of it; hover swaps band and text colours",- "Responsive/motion: the ratio holds at every width; the only motion is a band colour cross-fade between sections"- ],- "webLeverage": "CSS custom properties swap the category colour per section while the band geometry stays fixed",- "fits": [- "publishing",- "content platforms",- "catalogs"- ]- },- {- "name": "Riso zine",- "tier": "graphic-system",- "lineage": "Risograph small-press printing, 1980s to now",- "spark": "Two soy inks slightly out of register, and the mistake is the signature.",- "system": [- "Palette/material: uncoated stock tinted pink or blue; two spot inks that overprint to a third colour",- "Type/composition: chunky bold sans, hand-lettered moments allowed; halftone dots stand in for photography",- "Topology/navigation: stapled-spread logic, sections as loose pages; nav set as a typed contents list",- "Controls/state: buttons are ink blocks with visible misregistration; press shifts the second ink 2px",- "Responsive/motion: misregistration settles once on load (under 400ms) and never loops"- ],- "webLeverage": "mix-blend-mode multiply makes the two inks genuinely overprint",- "fits": [- "community",- "events",- "indie products"- ]- },- {- "name": "Whole Earth spread",- "tier": "graphic-system",- "lineage": "Whole Earth Catalog, 1968-74",- "spark": "Dense, ink-heavy conviction: every item reviewed, priced, and argued for in six-point type.",- "system": [- "Palette/material: newsprint cream, ink-dense; no accent colour, emphasis is weight",- "Type/composition: typewriter body under bold serif headers; captions run right up against images",- "Topology/navigation: multi-column item entries with inline prices; an index does the navigating",- "Controls/state: links underlined in ink; visited state is a small check glyph in the margin",- "Responsive/motion: columns drop one at a time; no motion, the density is the energy"- ],- "webLeverage": "CSS multi-column layout with column-rule gives real newsprint flow",- "fits": [- "marketplaces",- "directories",- "tool collections"- ]- },- {- "name": "Specimen broadsheet",- "tier": "graphic-system",- "lineage": "Type-foundry specimen sheets, 19th century",- "spark": "The typeface is the product, shown at every size it owns, waterfall after waterfall.",- "system": [- "Palette/material: cream broadsheet, ink only; a foundry footer in the body face, a step smaller",- "Type/composition: one family at every size as content; waterfall settings, no placeholder text",- "Topology/navigation: sized specimens are the sections; a ruled index of point sizes navigates",- "Controls/state: hover sets the specimen line in the accent weight; controls are ruled boxes",- "Responsive/motion: the waterfall re-breaks by width; one variable-font weight settle on load"- ],- "webLeverage": "variable font axes animated once with font-variation-settings make the waterfall breathe",- "fits": [- "type-adjacent tools",- "portfolios",- "editorial"- ]- },- {- "name": "Letterpress playbill",- "tier": "graphic-system",- "lineage": "Broadside ballads and theatre playbills, 18th-19th century",- "spark": "A different wood type on every line, all centered, and the bill still reads top to bottom like thunder.",- "system": [- "Palette/material: cream rag paper, black ink, one spot red for the star act",- "Type/composition: stacked centered lines, a different display face per line; rule dividers between acts",- "Topology/navigation: strict top-to-bottom bill hierarchy; nav is the bill's own running order",- "Controls/state: controls are ruled bill lines; hover sets the line in spot red",- "Responsive/motion: the stack narrows, never reflows sideways; no motion beyond an ink-in on load"- ],- "webLeverage": "text-wrap balance keeps every centered wood-type line breaking evenly",- "fits": [- "events",- "restaurants",- "launches"- ]- },- {- "name": "Matchbox label",- "tier": "graphic-system",- "lineage": "Japanese matchbox labels, Meiji through Showa eras",- "spark": "One animal in a cartouche is the entire brand, and the border does the rest.",- "system": [- "Palette/material: kraft ground; two flat inks; one tightly cropped photograph is the only image on the page",- "Type/composition: a condensed logotype in a cartouche; supporting text tiny and outward-facing like an edge label",- "Topology/navigation: every section framed by a printed border; the mark recurs small as a wayfinder",- "Controls/state: buttons are bordered chips; hover thickens the border, press fills the cartouche",- "Responsive/motion: the border scales with the container; motion is a single stamp-down of the mark"- ],- "webLeverage": "border-image turns one SVG frame into every container's printed border",- "fits": [- "consumer goods",- "cafes",- "playful brands"- ]- },- {- "name": "Pharma sachet",- "tier": "graphic-system",- "lineage": "Geigy pharmaceutical packaging and literature, 1950s-60s",- "spark": "Clinical calm with one enormous abstract shape carrying all the feeling the copy refuses to.",- "system": [- "Palette/material: clinical white; one large flat geometric figure in a single saturated colour",- "Type/composition: akzidenz-class grotesque, lowercase; dosage-table clarity in the data",- "Topology/navigation: each section pairs a cool table with one warm abstract figure; nav is a thin rule of lowercase links",- "Controls/state: controls are precise 1px-bordered fields; focus is the figure's colour, nothing else is",- "Responsive/motion: the figure crops before it shrinks; it drifts a few pixels over 20s, imperceptibly"- ],- "webLeverage": "SVG shapes with CSS offset-path give the abstract figure its slow drift",- "fits": [- "health",- "science SaaS",- "precision tools"- ]- },- {- "name": "Seed packet",- "tier": "graphic-system",- "lineage": "American seed-packet lithography, 1900s-40s",- "spark": "The tomato on the front is redder than any tomato has ever been, and the planting table on the back is dead honest.",- "system": [- "Palette/material: cream stock; one saturated produce photograph; a banner ribbon in a second colour",- "Type/composition: ornamented display caps in the banner; the back-of-pack table set plain and tabular",- "Topology/navigation: front-of-pack hierarchy (variety, vignette, promise) then the honest table; sections alternate front and back",- "Controls/state: the CTA is the banner ribbon; hover ripples the ribbon ends 2px",- "Responsive/motion: the photograph stays dominant at all widths; one bloom-in on load, then still"- ],- "webLeverage": "an SVG filter posterizes the photograph into genuine lithograph flats",- "fits": [- "food",- "garden",- "subscription boxes"- ]- },- {- "name": "Teletext page",- "tier": "graphic-system",- "lineage": "Ceefax and Minitel broadcast text services, 1970s-80s",- "spark": "Page 302 of a broadcast that never stops: block mosaics, double-height caps, colours with no opinions about taste.",- "system": [- "Palette/material: true black ground; saturated RGB block colours straight from the palette register",- "Type/composition: double-height bitmap caps for headers; body in the same monospace grid",- "Topology/navigation: three-digit page numbers are the nav; a header row carries page and time",- "Controls/state: selection is a colour-block cursor; links are coloured index rows",- "Responsive/motion: the character grid scales as a unit; one row-by-row paint-in on load, top to bottom"- ],- "webLeverage": "ch units and a monospace grid keep every block mosaic cell true to the character cell",- "fits": [- "news",- "data products",- "retro consumer"- ]- },- {- "name": "Transit wayfinding",- "tier": "graphic-system",- "lineage": "Vignelli subway diagram and Calvert-Kinneir motorway signage, 1960s-70s",- "spark": "A sign system that gets you off at the right exit without you noticing you read it.",- "system": [- "Palette/material: high-contrast panel colours (one per line of business) with white reversal; dark charcoal ground",- "Type/composition: one transport grotesque, mixed case, huge x-height; arrows are typography",- "Topology/navigation: destination hierarchy (line, station, exit); coloured discs badge the categories",- "Controls/state: controls are sign panels; active is the white bar under the destination",- "Responsive/motion: panels stack like stacked signs; motion is a panel slide with a hard stop"- ],- "webLeverage": "scroll-driven animations pin the line diagram while stations tick past",- "fits": [- "navigation-heavy apps",- "platforms",- "logistics"- ]- },- {- "name": "Racing livery",- "tier": "graphic-system",- "lineage": "Motorsport liveries and roundel number plates, 1960s-70s",- "spark": "One team colour against white, a giant number in a roundel, and sponsor patches held in strict formation.",- "system": [- "Palette/material: one saturated team colour blocked hard against white; matte black for numerals",- "Type/composition: huge condensed numerals, no italics; small sponsor-grid text disciplined to one zone",- "Topology/navigation: sections read as body panels, colour breaks at panel lines; nav is the number roundel row",- "Controls/state: the roundel is the button; hover rotates the number plate a degree, press stamps it flat",- "Responsive/motion: panel lines re-break at width changes; one chequered wipe on section change"- ],- "webLeverage": "CSS clip-path panel lines let the team colour break exactly where the bodywork would",- "fits": [- "performance tools",- "sports",- "speed-led brands"- ]- },- {- "name": "Bus blind",- "tier": "graphic-system",- "lineage": "London bus destination blinds and roller signs",- "spark": "White and yellow letterforms on black, sized like they have somewhere to be.",- "system": [- "Palette/material: black ground; letterforms in white and one yellow only",- "Type/composition: one grotesque in capitals at extreme size; via-points in a smaller line beneath",- "Topology/navigation: destination stacking is the page structure; each section is a blind frame",- "Controls/state: controls are blind windows; changing state rolls the text vertically like the blind",- "Responsive/motion: type scales to fill the frame edge to edge; the roll is the one motion, stepped not smooth"- ],- "webLeverage": "steps() easing on translateY makes the destination roll land like a real blind",- "fits": [- "transit",- "bold single-message landings",- "events"- ]- },- {- "name": "Blue Note sleeve",- "tier": "graphic-system",- "lineage": "Reid Miles cover design for Blue Note Records, 1955-67",- "spark": "A duotone musician mid-phrase, type slicing across the photograph like a horn line.",- "system": [- "Palette/material: one-colour duotone photography over deep ink ground; a second flat colour for type blocks only",- "Type/composition: tight grotesque set in bars and angles that cut across the image; lowercase confidence",- "Topology/navigation: every section is a sleeve: image field plus one typographic intervention; track-list rows navigate",- "Controls/state: controls are type bars; hover shifts the duotone hue, press knocks the bar out of the photo",- "Responsive/motion: the crop tightens before the type shrinks; one slow duotone shift per viewport"- ],- "webLeverage": "CSS filter plus mix-blend-mode builds real duotones from ordinary photographs",- "fits": [- "music",- "creative platforms",- "portfolio"- ]- },- {- "name": "Bass title card",- "tier": "graphic-system",- "lineage": "Saul Bass film title sequences and posters, 1950s-60s",- "spark": "A torn paper shape on a flat colour field tells you the whole story before a word lands.",- "system": [- "Palette/material: one saturated field colour per act; torn black silhouette shapes; white text only",- "Type/composition: irregular hand-cut display letters or a plain grotesque, nothing between; asymmetric placement",- "Topology/navigation: sections are acts, each a new field colour and one shape; the cast list is the footer",- "Controls/state: controls are cut-out shapes; hover jitters the tear 1px, press inverts shape and field",- "Responsive/motion: shapes rescale as silhouettes; one shape assembles from two pieces per section, once"- ],- "webLeverage": "SVG clip-path with jagged polygon points gives genuine torn edges at any scale",- "fits": [- "storytelling products",- "studios",- "campaign pages"- ]- },- {- "name": "Atelier populaire broadside",- "tier": "graphic-system",- "lineage": "Silkscreened posters of the Paris ateliers, May 1968",- "spark": "One colour, pulled through a screen in a hurry, saying exactly one thing.",- "system": [- "Palette/material: kraft or raw white; a single flat ink (red or black); screen texture where the ink thins",- "Type/composition: hand-cut caps drawn fast, slightly irregular; the slogan is the layout",- "Topology/navigation: one message per section, full width; nav is a strip of small stencilled words",- "Controls/state: buttons are stencil cuts; press pulls a second pass of ink (darker, slightly offset)",- "Responsive/motion: the slogan wraps by hand-set breakpoints; no motion, urgency is static"- ],- "webLeverage": "an SVG feTurbulence filter thins the ink exactly where a squeegee would starve it",- "fits": [- "manifestos",- "community causes",- "single-message pages"- ]- },- {- "name": "Ordnance quadrangle",- "tier": "graphic-system",- "lineage": "USGS and Ordnance Survey topographic sheets, 20th century",- "spark": "A landscape flattened to hairline contours, and the margins full of quiet institutional truth.",- "system": [- "Palette/material: paper white with hairline contour density in brown; water in one blue; a marginalia frame",- "Type/composition: place names in the serif a step smaller, italic reserved for water alone; datum notes in a small sans",- "Topology/navigation: the sheet grid with edge coordinates is the layout; sections are named quadrangles",- "Controls/state: hover raises a contour line's weight; selected areas get the survey's red grid tick",- "Responsive/motion: the frame margins hold at every width; contours draw in once, slowly, on first view"- ],- "webLeverage": "SVG stroke-dashoffset animates the contour draw without a single image asset",- "fits": [- "mapping",- "data platforms",- "field tools"- ]- },- {- "name": "Stamp sheet",- "tier": "graphic-system",- "lineage": "Engraved postage sheets and philatelic presentation packs",- "spark": "Forty identical engravings separated by perforations, and every one of them is treasury-grade.",- "system": [- "Palette/material: pale gum-paper ground; each stamp a one-colour engraving; selvedge margins carry plate numbers",- "Type/composition: engraved-style serif for denominations; country and series in the body face, a step smaller",- "Topology/navigation: content cells are stamps in a perforated sheet grid; the selvedge is the nav rail",- "Controls/state: hover lifts a stamp with a soft paper shadow; selection tears it along the perforation",- "Responsive/motion: the sheet re-grids without breaking perforation rhythm; one lift-and-settle per interaction"- ],- "webLeverage": "a repeating radial-gradient mask cuts true perforated edges on every cell",- "fits": [- "collections",- "membership products",- "archival brands"- ]- },- {- "name": "Banknote engraving",- "tier": "graphic-system",- "lineage": "Intaglio currency engraving and guilloche security lathework",- "spark": "A page that spends its whole budget proving it cannot be forged.",- "system": [- "Palette/material: pale money-green or ochre ground woven with fine guilloche linework; one seal in a second ink",- "Type/composition: engraved serif numerals at denomination scale; microtext rules that read up close",- "Topology/navigation: sections framed like note faces with corner denominations; the seal badges the key claim",- "Controls/state: controls are engraved plaques; hover raises the lattice contrast, press embosses",- "Responsive/motion: guilloche density thins at small sizes instead of shrinking; a 30s lattice shimmer, barely there"- ],- "webLeverage": "layered repeating-conic-gradients generate live guilloche lattices with no artwork",- "fits": [- "fintech",- "security products",- "premium brands"- ]- },- {- "name": "Concrete poem",- "tier": "graphic-system",- "lineage": "Concrete poetry movement, Gomringer and the Noigandres group, 1950s-60s",- "spark": "The words are arranged as the thing they describe, and that arrangement is the whole design.",- "system": [- "Palette/material: bare page, ink only; whitespace is the material being sculpted",- "Type/composition: one sans, one size; placement carries all meaning, no bold, no colour",- "Topology/navigation: each section is one poem-shaped arrangement; nav is a single line of words",- "Controls/state: interactive words are the ones out of place; hover moves a word into its meaning",- "Responsive/motion: arrangements recompose per breakpoint by design, not reflow; one word settles per section"- ],- "webLeverage": "CSS grid template areas hold each hand-placed word exactly where the poem needs it",- "fits": [- "manifestos",- "studios",- "single-idea landings"- ]- },- {- "name": "Airline timetable",- "tier": "instrument",- "lineage": "Mid-century airline timetables and route maps, 1950s-60s",- "spark": "The schedule table is the layout, and the route arcs are the only decoration allowed aboard.",- "system": [- "Palette/material: white with one airline livery colour; buff for the cover panels",- "Type/composition: tabular figures everywhere; city codes as their three letters at the body size, untracked; flight numbers as anchors",- "Topology/navigation: content is departures rows (time, code, destination, note); tabs like ticket stock navigate",- "Controls/state: a row highlights in livery colour on hover; selected flights get the margin arrow",- "Responsive/motion: columns shed politely (note first, code last); rows tick in once like a posted schedule"- ],- "webLeverage": "font-variant-numeric tabular-nums locks every column of times into alignment",- "fits": [- "logistics",- "scheduling tools",- "travel"- ]- },- {- "name": "Card catalog",- "tier": "instrument",- "lineage": "Library card catalogs and drawer indexes",- "spark": "Every fact on its own manila card, typed, stamped, and filed where fingers can walk to it.",- "system": [- "Palette/material: manila and buff cards on a dark oak drawer ground; rubber-stamp red for status",- "Type/composition: typewriter mono with underline emphasis; call numbers top-left, always",- "Topology/navigation: drawer-and-card structure; tabbed dividers are the nav; one card raised per view",- "Controls/state: hover slides a card up 8px from the drawer; selection stamps it in red",- "Responsive/motion: drawers become a single column of tabs; the card slide is the only motion"- ],- "webLeverage": "CSS scroll-snap makes the drawer riffle card by card under the thumb",- "fits": [- "search products",- "archives",- "knowledge tools"- ]- },- {- "name": "Double-entry ledger",- "tier": "instrument",- "lineage": "Bookkeeping ledgers and banker's stationery, 19th-20th century",- "spark": "Pale green ruled paper where every claim has to balance against another, in ink, by hand.",- "system": [- "Palette/material: pale green or buff ruled stock; iron-ink near-black; red reserved for deficit alone",- "Type/composition: copperplate-adjacent headers over mono figures; double rule closes every total",- "Topology/navigation: debit and credit columns structure every section; the running balance is the thread",- "Controls/state: rows confirm with a posted tick; unbalanced states show red in the difference column only",- "Responsive/motion: columns fold to stacked entries that keep their rule lines; a total counts up once and closes"- ],- "webLeverage": "background-image linear-gradient rulings keep the ledger lines pixel-true at any size",- "fits": [- "fintech",- "accounting",- "analytics"- ]- },- {- "name": "Line-printer output",- "tier": "instrument",- "lineage": "Punched-card decks and tractor-feed line-printer reports, 1960s-70s",- "spark": "Greenbar stripes, mono throughout, a job number in the header: the machine's own handwriting.",- "system": [- "Palette/material: greenbar striped paper (alternating pale bands); ink near-black; no accent, emphasis is overstrike",- "Type/composition: mono only, report headers in capitals as the display voice and every label in sentence case; fixed-width report blocks; page headers carry job and date",- "Topology/navigation: content arrives as numbered report sections; the sprocket margin is the scroll rail",- "Controls/state: selection is an overstruck line; errors print as a flagged exception row, never a red banner",- "Responsive/motion: the character grid rewraps at column counts, not pixels; output prints in line by line, once"- ],- "webLeverage": "a steps() typing animation prints the report a full line at a time, never a character",- "fits": [- "developer tools",- "batch and data products",- "retro-tech"- ]- },- {- "name": "Blueprint",- "tier": "instrument",- "lineage": "Cyanotype architectural and engineering blueprints",- "spark": "Prussian blue all the way down, white lines doing all the talking, a revision table that never lies.",- "system": [- "Palette/material: deep prussian-blue ground; pure white linework; one process-yellow highlight for the current revision",- "Type/composition: stencil-adjacent lettering in the title block, sentence case; dimension chains in small mono",- "Topology/navigation: orthographic views structure sections; the title block anchors every page corner",- "Controls/state: hover thickens a dimension chain; approved states get the checker's initials",- "Responsive/motion: drawings crop by viewport like a print table; white lines draw in once on first view"- ],- "webLeverage": "SVG stroke-dashoffset draws the plan's white lines the way a pen plotter would",- "fits": [- "construction",- "architecture tools",- "planning software"- ]- },- {- "name": "Nautical chart",- "tier": "instrument",- "lineage": "Admiralty nautical charts, 19th-20th century",- "spark": "Depth soundings scattered like seed, land in buff, and a compass rose that has earned its ornament.",- "system": [- "Palette/material: pale sea-tint ground with buff landmasses; magenta reserved for lights and warnings",- "Type/composition: italic hydrographic labels for water, upright roman for the coast; soundings as scattered small numerals",- "Topology/navigation: the chart frame with edge scales is the layout; hazards badge in magenta",- "Controls/state: plotted courses are the selected state; hover shows a bearing line from the rose",- "Responsive/motion: the frame holds, the chart pans; one course line draws in per section"- ],- "webLeverage": "SVG textPath curves the coastal labels along the actual coastline",- "fits": [- "maritime",- "exploration products",- "route planning"- ]- },- {- "name": "Observatory logbook",- "tier": "instrument",- "lineage": "Scientific expedition and observatory logbooks",- "spark": "Dated entries in iron-gall ink with the photograph pasted in and the coordinates in the margin.",- "system": [- "Palette/material: ivory ruled pages; iron-gall near-black that browns at the edges; one wax-red seal colour",- "Type/composition: serif entries with upright figures for data; marginal coordinates in the serif's figures, a step smaller",- "Topology/navigation: strictly chronological entries; the margin rail of dates is the nav",- "Controls/state: today's entry is the open page; hover tilts a pasted photograph 1 degree",- "Responsive/motion: margins collapse into inline date stamps; a new entry blots in once"- ],- "webLeverage": "CSS position sticky keeps the date rail fixed while entries scroll like turned pages",- "fits": [- "research tools",- "journals",- "long-form products"- ]- },- {- "name": "Herbarium sheet",- "tier": "instrument",- "lineage": "Botanical herbarium specimen sheets",- "spark": "One pressed specimen centered, and a hundred years of annotation slips accumulating around it.",- "system": [- "Palette/material: aged white sheet; specimen greens gone khaki; accession-stamp violet as the accent",- "Type/composition: typed determinavit labels bottom-right; latin binomials in italic, collectors' names in the body face",- "Topology/navigation: one specimen per section, annotations orbit it; the accession number indexes everything",- "Controls/state: hover lifts an annotation slip; verified state adds the determiner's stamp",- "Responsive/motion: slips reflow around the specimen, never over it; one slip settles per section"- ],- "webLeverage": "CSS shape-outside lets the annotation text wrap the specimen's actual silhouette",- "fits": [- "botanicals",- "archival products",- "collections"- ]- },- {- "name": "Vitrine label",- "tier": "instrument",- "lineage": "Museum object labels and vitrine cards",- "spark": "Object number, title, medium, provenance: four quiet lines doing justice to the thing above them.",- "system": [- "Palette/material: gallery white; ink only; the objects carry all colour",- "Type/composition: one quiet serif at two sizes with generous leading; the number line in old-style figures",- "Topology/navigation: object-and-label pairs structure the page; a numbered checklist navigates",- "Controls/state: hover raises the label's rule; selection adds the loan-collection dot",- "Responsive/motion: labels stay under their objects at every width; no motion, gallery stillness"- ],- "webLeverage": "CSS grid with subgrid keeps every label's four lines aligned across the gallery row",- "fits": [- "luxury",- "portfolios",- "archives"- ]- },- {- "name": "Rams instruction card",- "tier": "instrument",- "lineage": "Braun product literature under Dieter Rams, 1960s-70s",- "spark": "Pale grey calm where colour appears only on the control being explained.",- "system": [- "Palette/material: pale warm grey; ink dark grey; one signal colour appearing only on the referenced control",- "Type/composition: small akzidenz-style labels, numbered; generous silence between figures",- "Topology/navigation: exploded views with index lines structure sections; numbers cross-reference text to diagram",- "Controls/state: hovering text lights its control in the diagram and vice versa; nothing else reacts",- "Responsive/motion: diagrams stack above their text; index lines redraw once per layout"- ],- "webLeverage": "CSS :has() lets the diagram highlight when its matching text row is hovered, no script",- "fits": [- "hardware",- "consumer devices",- "productivity tools"- ]- },- {- "name": "Recipe card",- "tier": "instrument",- "lineage": "Mid-century boxed recipe cards",- "spark": "Ingredients on the left rail, method numbered on the right, a gingham band saying someone cooks here.",- "system": [- "Palette/material: cream card; one gingham or solid tint band; a category tab colour",- "Type/composition: friendly serif title, typewriter body; quantities in tabular figures",- "Topology/navigation: ingredients rail left, numbered method right; index tabs navigate categories",- "Controls/state: steps check off with a pencil tick; the active step's number fills the tab colour",- "Responsive/motion: the rail drops above the method on small cards; one card-flip per section change"- ],- "webLeverage": "CSS counters number the method steps so inserted steps renumber themselves",- "fits": [- "food",- "how-to products",- "home brands"- ]- },- {- "name": "Classifieds page",- "tier": "instrument",- "lineage": "Phone-book yellow pages and newspaper classifieds",- "spark": "Six-point type, column rules, and a bold header shouting PIANO, MUST SELL.",- "system": [- "Palette/material: yellow or newsprint ground, ink-dense; one red stamp for featured entries",- "Type/composition: bold condensed headers over tiny body; ad boxes of mixed sizes earn their borders",- "Topology/navigation: alphabetical tabs and column rules; the boxed ads are the featured tier",- "Controls/state: hover raises an ad box's border weight; placed state adds the red PAID stamp",- "Responsive/motion: columns drop but the rules stay; no motion, the density hums by itself"- ],- "webLeverage": "CSS columns with column-rule reflow the classifieds while keeping the printed rules",- "fits": [- "directories",- "marketplaces",- "local services"- ]- },- {- "name": "Matchbook",- "tier": "instrument",- "lineage": "American matchbook covers, 1930s-60s",- "spark": "Front hook, spine message, back offer: a complete pitch on two square inches.",- "system": [- "Palette/material: one saturated ground colour; foil-adjacent gold accents; the striker strip as a texture band",- "Type/composition: script wordmark over a condensed address line in sentence case; tiny type that stays proud",- "Topology/navigation: tiny-canvas discipline per section (hook, spine, offer); sections snap like a flipped book",- "Controls/state: the CTA is the striker strip; press strikes it with a brief spark of the accent",- "Responsive/motion: the canvas stays small and centered by choice; one flip between faces"- ],- "webLeverage": "CSS 3D transform flips the matchbook face to back on interaction",- "fits": [- "hospitality",- "small brands",- "micro-sites"- ]- },- {- "name": "Mixing desk",- "tier": "instrument",- "lineage": "Inline recording consoles, SSL and Neve channel strips, 1970s-80s",- "spark": "Ninety-six faders in ranks, and the one that matters is under your hand.",- "system": [- "Palette/material: charcoal panel ground; per-function knob colours (red record, green bus, white trim); brushed metal rails",- "Type/composition: engraved labels under every control, sentence case, a step smaller; channel numbers in a larger mono",- "Topology/navigation: vertical channel strips structure content; the master section anchors the page foot",- "Controls/state: faders and knobs are the controls; state reads as physical position plus one LED dot",- "Responsive/motion: strips shed to a bussed summary on small screens; meters move, nothing else does"- ],- "webLeverage": "input type=range restyled with accent-color and a custom track becomes a true fader bank",- "fits": [- "audio products",- "creator tools",- "pro workflows"- ]- },- {- "name": "Split-flap board",- "tier": "instrument",- "lineage": "Solari di Udine departure boards, 1956 onward",- "spark": "The clatter of forty flaps landing on the word you were waiting for.",- "system": [- "Palette/material: near-black board; off-white flap characters; one amber row for delays and exceptions",- "Type/composition: one condensed gothic per flap cell, uppercase as the display voice only; the split line across every character",- "Topology/navigation: ranked rows (time, code, destination, remark) are the content; the header row is fixed",- "Controls/state: updates flip through intermediate characters; the amber row is the alert state",- "Responsive/motion: columns shed right to left; the flap animation is the single signature motion"- ],- "webLeverage": "CSS 3D rotateX at the character midline reproduces the physical flap fall",- "fits": [- "status products",- "logistics",- "live data"- ]- },- {- "name": "Oscilloscope",- "tier": "instrument",- "lineage": "Tektronix cathode-ray oscilloscopes, 1950s-70s",- "spark": "A single green trace on a graticule, telling the truth at the speed of light.",- "system": [- "Palette/material: deep green-black screen with an etched graticule; phosphor green trace; bone control panel around it",- "Type/composition: engraved labels on the panel, sentence case; measurements in mono; the trace is the display type",- "Topology/navigation: one screen per section with its control cluster; V/div and T/div framing as section metadata",- "Controls/state: rotary knobs and toggle states; the trace responds live to the section's data",- "Responsive/motion: the screen stays 4:3 and centered; only the trace moves, everything else is bolted down"- ],- "webLeverage": "an inline SVG polyline driven by requestAnimationFrame draws a live phosphor trace",- "fits": [- "monitoring",- "engineering tools",- "data products"- ]- },- {- "name": "Flight-deck placard",- "tier": "instrument",- "lineage": "Transport-aircraft cockpit placards and annunciator panels",- "spark": "Every switch guarded, every state announced, nothing ambiguous at three in the morning.",- "system": [- "Palette/material: dark grey panel; annunciator lenses in amber, green, white; guarded red for irreversible actions",- "Type/composition: engraved placards in sentence case; checklist items in a stern grotesque with do/verify columns",- "Topology/navigation: panel groups by system; the checklist rail runs the page in order",- "Controls/state: switches show physical position; irreversible controls sit under a lift-guard interaction",- "Responsive/motion: panels stack by system priority; annunciators illuminate, nothing slides"- ],- "webLeverage": "a details/summary lift-guard makes the destructive action take two deliberate gestures",- "fits": [- "ops tooling",- "safety products",- "checklists"- ]- },- {- "name": "Darkroom contact sheet",- "tier": "instrument",- "lineage": "Photographic contact sheets and grease-pencil edits",- "spark": "Thirty-six frames under red light, and the grease pencil circles the only one that matters.",- "system": [- "Palette/material: photo-black ground; silver-print greys; one grease-pencil red-orange for markup",- "Type/composition: frame numbers in film-edge mono; captions typed on slips; the markup is one red-orange circle",- "Topology/navigation: filmstrip rows with sprocket edges; circled frames are the featured tier",- "Controls/state: hover inverts a frame like a loupe check; the pick state is the grease circle",- "Responsive/motion: strips rewrap by frame count; the circle draws in once, hand-speed"- ],- "webLeverage": "SVG stroke-dashoffset animates the grease-pencil circle exactly as a hand would draw it",- "fits": [- "photography",- "review workflows",- "portfolios"- ]- },- {- "name": "Chess scoresheet",- "tier": "instrument",- "lineage": "Tournament scoresheets and dual-face chess clocks",- "spark": "Two columns of algebraic moves and a clock that makes time itself take turns.",- "system": [- "Palette/material: tournament cream sheet; ink black; one arbiter red for flags and illegal states",- "Type/composition: algebraic notation in mono pairs; player names in the serif at the head",- "Topology/navigation: numbered move pairs structure the content; the clock faces anchor two states",- "Controls/state: the active side's clock face is live, the other dimmed; pressing hands turn over",- "Responsive/motion: columns stay paired at every width; the only motion is the clock hand and the flag fall"- ],- "webLeverage": "CSS toggle of two clock faces via :has() keeps the turn state pure markup",- "fits": [- "competitive products",- "turn-based workflows",- "strategy tools"- ]- },- {- "name": "Loom draft",- "tier": "instrument",- "lineage": "Weaving drafts: threading, tie-up, and drawdown grids",- "spark": "Four small grids that together are the complete instruction for a bolt of cloth.",- "system": [- "Palette/material: cream graph ground; thread colours as filled grid cells; the drawdown emerges from them",- "Type/composition: numbered shafts and treadles in small mono; the pattern name in a quiet serif",- "Topology/navigation: threading across the top, treadling down the side, the drawdown filling the field",- "Controls/state: toggling a tie-up cell recomputes the drawdown; hover traces one thread through all grids",- "Responsive/motion: grids scale as units; the drawdown fills row by row, once"- ],- "webLeverage": "CSS grid with cell custom properties recomputes the visible weave without canvas",- "fits": [- "craft brands",- "configuration products",- "pattern tools"- ]- },- {- "name": "Reel-to-reel deck",- "tier": "instrument",- "lineage": "Studer and Revox tape machines, 1960s-70s",- "spark": "Two reels, a counter you trust more than your watch, and tape you can touch.",- "system": [- "Palette/material: brushed aluminium face on charcoal; VU cream dials with red overload wedge; tape brown as the accent",- "Type/composition: engraved labels under every switch, sentence case; the counter in a large odometer mono",- "Topology/navigation: transport controls order the page (rewind, play, record sections); the counter is the progress indicator",- "Controls/state: chunky latching buttons; recording state arms in red and will not be missed",- "Responsive/motion: the deck face stacks; reels turn only while something actually plays"- ],- "webLeverage": "CSS animation-play-state ties reel rotation to the page's real playing state",- "fits": [- "media products",- "recording tools",- "archives"- ]- },- {- "name": "Camera top plate",- "tier": "instrument",- "lineage": "Mechanical rangefinder top plates, 1950s-70s",- "spark": "Shutter, ISO, and a film counter, all machined, all legible, all exactly where thumbs expect them.",- "system": [- "Palette/material: satin chrome and black leatherette; engraved figures ink-filled; one meter-needle orange",- "Type/composition: engraved numerals on dials; settings in a small serif, sentence case; the model name in a restrained script",- "Topology/navigation: dials cluster by function; sections read left to right like the plate itself",- "Controls/state: dials click through detents (real steps, no smooth glide); the needle shows live exposure",- "Responsive/motion: dials become stacked steppers; the needle is the only continuous motion"- ],- "webLeverage": "scroll-snap points on a horizontal dial give real click-stop detents",- "fits": [- "photography",- "precision consumer tools",- "settings-heavy products"- ]- },- {- "name": "Planetarium dome",- "tier": "atmosphere",- "lineage": "Zeiss projection planetariums and star atlases",- "spark": "The house lights sink, the dome fills with stars, and a voice starts naming them.",- "system": [- "Palette/material: deep blue-black dome ground; pinpoint white stars; brass-gold for constellation lines and figures",- "Type/composition: classical serif with star names in italic; captions like a narrated program",- "Topology/navigation: constellation lines literally connect content nodes; a coordinate ring frames sections",- "Controls/state: hover brightens a star and its lines; focus takes the projector's brass ring, instantly",- "Responsive/motion: the dome crops, stars keep their positions; the sky turns a few degrees with scroll, nothing loops"- ],- "webLeverage": "an SVG map of the real sky for the page's date, hairline constellations, no glow",- "fits": [- "AI and science tools",- "night products",- "observability"- ]- },- {- "name": "Midnight diner",- "tier": "atmosphere",- "lineage": "American roadside diners after dark, neon and tungsten",- "spark": "Neon in the window, tungsten on the counter, pie under glass, and nowhere else open for miles.",- "system": [- "Palette/material: night-blue window ground; warm tungsten pools on formica cream; one neon colour, flat, as the only saturation",- "Type/composition: a script wordmark in the neon colour; menu-board lettering at display size with hand-set prices; ticket-stub mono only for order numbers and prices",- "Topology/navigation: the counter is the content rail; menu boards are the sections; the register closes the page",- "Controls/state: specials clip to the board; the neon sign flickers once on hover, steady otherwise",- "Responsive/motion: booths stack, the counter persists; light pools stay put; nothing loops"- ],- "webLeverage": "-webkit-text-stroke over a flat fill draws the neon tube, with no halo",- "fits": [- "late-night products",- "food",- "hospitality"- ]- },- {- "name": "Palm house",- "tier": "atmosphere",- "lineage": "Victorian glasshouses and botanical conservatories",- "spark": "White iron ribs, wet green light, and labels for ten thousand leaves.",- "system": [- "Palette/material: humid green field tones under glass-white structure; terracotta pot accents; condensation softness at edges",- "Type/composition: engraved botanical serif with latin italics; zinc-tag labels in sentence case",- "Topology/navigation: glasshouse bays are the sections, ribs are the dividers; zinc tags navigate species",- "Controls/state: tags tilt on hover like touched labels; selected specimens get a watering ring",- "Responsive/motion: bays narrow with the ribs intact; one slow light shift as if a cloud passed"- ],- "webLeverage": "thin white SVG ribs drawn over the foliage give the glasshouse its structure, with no blur",- "fits": [- "wellness",- "botanical brands",- "growth products"- ]- },- {- "name": "Reading room",- "tier": "atmosphere",- "lineage": "Great library reading rooms, green lamps and oak",- "spark": "A hundred green-glass lamps, each one a small island of permitted light.",- "system": [- "Palette/material: deep oak-brown ground; green-glass lamp pools; brass fittings; paper cream only inside the pools",- "Type/composition: bookish serif with old-style figures; catalog numbers in a quiet mono",- "Topology/navigation: desks-in-rows structure the content; each lamp pool holds one reading; the stacks are the archive nav",- "Controls/state: a lamp switches on to focus its desk; hushed states, nothing blinks",- "Responsive/motion: desks stack in single file; light pools fade up one at a time, then hold"- ],- "webLeverage": "a warm paper tint inside each card is the lamp's pool, with no radial light",- "fits": [- "knowledge tools",- "long-form reading",- "research"- ]- },- {- "name": "Night train",- "tier": "atmosphere",- "lineage": "European sleeper carriages, blue corridor lights",- "spark": "A corridor of blue night-lights, brass handles, and a timetable that will be true at dawn.",- "system": [- "Palette/material: deep railway blue with night-light pools; brass and walnut trims; a linen white for berth cards",- "Type/composition: carriage plates with engraved numerals; the timetable in disciplined tabular type",- "Topology/navigation: compartments are the sections along a corridor scroll; berth numbers navigate",- "Controls/state: a compartment door slides open to its content; the occupied state dims the compartment",- "Responsive/motion: the corridor becomes a vertical run; a slow window-light sweep passes every so often"- ],- "webLeverage": "scroll-driven animations run the passing window lights against the corridor scroll",- "fits": [- "travel",- "night products",- "journey-based onboarding"- ]- },- {- "name": "Lighthouse",- "tier": "atmosphere",- "lineage": "Fresnel-lens lighthouses and keeper's logs",- "spark": "One beam sweeping the dark on schedule, and a keeper who writes the weather down.",- "system": [- "Palette/material: storm blue-black ground; the beam's warm white; signal red banding as the single accent",- "Type/composition: a maritime slab for station names; the keeper's log in a handwriting-adjacent serif",- "Topology/navigation: the light's characteristic (flash pattern) badges sections; the log rail runs the page",- "Controls/state: focus takes the beam's warm white ring, instantly; warnings ring the lamp in red banding",- "Responsive/motion: the tower column becomes the page spine; the beam sweeps on its stated period, 8s or slower, with a pause control; nothing else moves"- ],- "webLeverage": "a conic-gradient rotated by CSS animation is the entire beam, stopped under reduced motion",- "fits": [- "monitoring",- "safety products",- "coastal brands"- ]- },- {- "name": "Public pool",- "tier": "atmosphere",- "lineage": "Municipal pools and lidos, painted lanes and tile",- "spark": "Chlorine-blue water over a grid of tiles, lane ropes in primary colours, rules painted on the wall.",- "system": [- "Palette/material: aqua water field over white tile grid; lane-rope reds and yellows; poolside concrete grey",- "Type/composition: sign-writer lettering for the rules, sentence case; depth markers as big honest numerals",- "Topology/navigation: lanes are the content columns; depth markers stage the page from shallow to deep",- "Controls/state: lane ropes divide interactive zones; hover ripples the water field gently",- "Responsive/motion: lanes merge politely on small screens; the water caustic shimmer is slow and subtle"- ],- "webLeverage": "an SVG feTurbulence displacement map puts real caustic shimmer into the water field",- "fits": [- "fitness",- "community products",- "summer brands"- ]- },- {- "name": "Foundry floor",- "tier": "atmosphere",- "lineage": "Iron foundries and steel pours, soot and molten light",- "spark": "Everything is black with soot except the one thing that is dangerously, gorgeously orange.",- "system": [- "Palette/material: soot-black ground; molten orange-white as the single light source; steel greys between",- "Type/composition: stencilled industrial caps; batch numbers in heavy mono; warnings set exactly as painted",- "Topology/navigation: the pour sequence orders sections; batch plates are the anchors",- "Controls/state: hot states turn molten orange; cooled states go iron-grey and matte",- "Responsive/motion: the floor stacks by process order; one heat shimmer, once, above the one hot element"- ],- "webLeverage": "a stepped fill from white-hot to orange inside an element makes it read as molten, with no outer glow",- "fits": [- "industrial products",- "build tools",- "heavy workflows"- ]- },- {- "name": "Jazz basement",- "tier": "atmosphere",- "lineage": "Basement jazz clubs, one spotlight and a red curtain",- "spark": "The room is dark, the curtain is red, the horn is lit, and nobody is checking their phone.",- "system": [- "Palette/material: near-black room; one warm spotlight pool; deep curtain red as the only saturation",- "Type/composition: a set-list serif with hand-numbered sets; names in lowercase, instruments in italic",- "Topology/navigation: the set list is the nav; sections are sets; the bar menu is the footer",- "Controls/state: the spotlight moves to the active act; applause states are brief and dim back down",- "Responsive/motion: tables clear to a single aisle; the spotlight cross-fade is the one transition"- ],- "webLeverage": "CSS view transitions cross-fade the spotlight between acts like a lighting cue",- "fits": [- "music",- "events",- "evening brands"- ]- },- {- "name": "Aquarium tunnel",- "tier": "atmosphere",- "lineage": "Walk-through aquarium tunnels, deep cyan and silhouettes",- "spark": "You walk on the seafloor, the light does not come from the sun, and something enormous drifts overhead.",- "system": [- "Palette/material: depth as flat bands stepping from teal to navy; silhouette blacks; one bioluminescent accent used sparingly",- "Type/composition: a rounded oceanic sans, untracked, for species; depth readouts in mono",- "Topology/navigation: the tunnel walk orders sections by depth; species tags float at their level",- "Controls/state: tags take the bioluminescent accent on hover; the surface far above is the way back up",- "Responsive/motion: the depth bands persist at any height; a silhouette drifts once as its section arrives"- ],- "webLeverage": "scroll-driven animation steps the depth band and the pressure readout with actual scroll position",- "fits": [- "depth-of-content products",- "science",- "immersive brands"- ]- },- {- "name": "Cinema lobby",- "tier": "atmosphere",- "lineage": "Picture-palace lobbies, marquee bulbs and carpet",- "spark": "Bulb-lit letters spelling tonight's picture over a carpet that has opinions.",- "system": [- "Palette/material: deep red and gold ground; marquee bulb warm-white; a patterned carpet motif kept to bands",- "Type/composition: marquee caps with bulb-dot counters; showtimes in ticket mono; lobby cards in a poster serif",- "Topology/navigation: the marquee headlines, lobby cards are the sections, the ticket booth is the CTA",- "Controls/state: the booth window is the focus; a torn ticket is the confirmed state",- "Responsive/motion: the marquee stacks its lines; bulbs chase once on load and then hold steady"- ],- "webLeverage": "a repeating radial-gradient dot border chases once via background-position animation",- "fits": [- "entertainment",- "launches",- "showcase pages"- ]- },- {- "name": "Night market",- "tier": "atmosphere",- "lineage": "East and Southeast Asian night markets, lantern-lit",- "spark": "Paper lanterns, steam, hand-painted prices, and the certainty that everything here is delicious.",- "system": [- "Palette/material: night ground with lantern reds and ambers as pooled light; hand-painted sign colours per stall",- "Type/composition: brushed display lettering per stall, never uniform; prices big, hand-set, proud",- "Topology/navigation: stalls are the sections in a walkable row; lantern strings connect them overhead",- "Controls/state: a stall brightens as you approach (hover); ordering states stamp a chit",- "Responsive/motion: the market narrows to one walkable lane; lanterns sway centimetres, slowly"- ],- "webLeverage": "CSS transform-origin at the string point lets lanterns sway from where they actually hang",- "fits": [- "food",- "marketplaces",- "festival brands"- ]- },- {- "name": "Thermal baths",- "tier": "atmosphere",- "lineage": "Alpine thermal baths, mineral tile and steam",- "spark": "Grey-green stone, warm water, and architecture that tells you to lower your voice.",- "system": [- "Palette/material: mineral grey-greens; steam-softened whites; brass tap warmth as the accent",- "Type/composition: a serene wide sans in lowercase, untracked; temperatures as quiet large numerals",- "Topology/navigation: pools order the sections by temperature; the changing-room threshold is the entry",- "Controls/state: water states ripple faintly on interaction; occupied pools show a folded towel marker",- "Responsive/motion: pools stack down the temperature scale; steam fades in once, nothing else moves"- ],- "webLeverage": "one SVG wisp fades in once over a flat warm band; nothing drifts",- "fits": [- "wellness",- "premium calm products",- "spa brands"- ]- },- {- "name": "Blue hour rooftop",- "tier": "atmosphere",- "lineage": "City rooftops at dusk, the grid lighting up below",- "spark": "The sky has one colour left in it, and the city answers with ten thousand windows.",- "system": [- "Palette/material: dusk as two flat bands, ember low and deep blue above; window-light amber points; rooftop asphalt greys",- "Type/composition: a confident grotesque set sparse and large against the sky; details in the body face, sentence case",- "Topology/navigation: the skyline is the section divider; content sits on the parapet line",- "Controls/state: window lights flicker on as sections arrive; the lit window is the active state",- "Responsive/motion: the skyline simplifies at small widths; lights come on once, in ones and twos"- ],- "webLeverage": "IntersectionObserver lights the windows section by section exactly once",- "fits": [- "city products",- "evening launches",- "ambitious brands"- ]- },- {- "name": "Polar station",- "tier": "atmosphere",- "lineage": "Antarctic research stations, whiteout and safety orange",- "spark": "White to the horizon in every direction, and everything that matters painted arrest-me orange.",- "system": [- "Palette/material: whiteout field with blue shadow tints; safety orange for everything functional; flag-line reds",- "Type/composition: expedition stencil caps; data in a cold precise mono; coordinates everywhere",- "Topology/navigation: flag lines connect the sections across the white; the station modules are the content",- "Controls/state: orange is interactive by definition; storm states dim the field, never the orange",- "Responsive/motion: modules cluster tighter as the viewport narrows; snow static drifts only at the margins"- ],- "webLeverage": "an SVG feTurbulence grain layer at 3 percent opacity gives the whiteout its texture",- "fits": [- "research tools",- "resilience products",- "outdoor brands"- ]- },- {- "name": "Listening booth",- "tier": "atmosphere",- "lineage": "Record-shop listening booths and crate dividers",- "spark": "Headphones on, world off, a handwritten divider that says STAFF PICKS and means it.",- "system": [- "Palette/material: warm plywood and felt greys; sleeve artwork carries the colour; one marker-pen red for handwritten tags",- "Type/composition: a plain grotesque for the racks; genuine handwriting only on divider tags",- "Topology/navigation: crates are the sections, dividers the nav; the booth is where detail views open",- "Controls/state: flipping to a record tilts it forward; the now-playing state is the booth lamp on",- "Responsive/motion: crates become swipeable rows; the record flip is the single interaction motion"- ],- "webLeverage": "perspective plus rotateX on hover flips records forward like real crate-digging",- "fits": [- "music",- "curation products",- "shops"- ]- },- {- "name": "Scriptorium",- "tier": "atmosphere",- "lineage": "Monastic scriptoria, vellum and gold leaf",- "spark": "One candle, one page, one letter so illuminated it took a week.",- "system": [- "Palette/material: vellum warm-white; iron-gall text ink; one initial in true gold and one in lapis per page",- "Type/composition: a calligraphic-adjacent serif for body; versal initials as the only display type",- "Topology/navigation: pages are the sections; rubricated red lines mark the entries; marginalia hold the asides",- "Controls/state: the illuminated initial is the section's single interactive jewel; hover catches its gilt",- "Responsive/motion: the page column stays book-proportioned; the gold catches light once as it enters"- ],- "webLeverage": "a narrow linear-gradient masked to the initial glints across the gold leaf once, on entry",- "fits": [- "premium editorial",- "craft brands",- "slow products"- ]- },- {- "name": "Telescope array",- "tier": "atmosphere",- "lineage": "Desert radio telescope arrays at dawn",- "spark": "A line of white dishes all turning together toward something nobody can see yet.",- "system": [- "Palette/material: pale dawn-pink sky over desert buff; dish white; one deep-space violet for the data",- "Type/composition: a technical grotesque with array IDs in mono; observations in mono",- "Topology/navigation: dishes are the sections, aligned along the array baseline; azimuth readouts badge them",- "Controls/state: a dish rotates subtly toward the hovered content; locked-on is the tracked state",- "Responsive/motion: the array foreshortens to a single dish; rotations are slow and mechanical"- ],- "webLeverage": "CSS perspective on grouped transforms lets the whole array slew as one rig",- "fits": [- "data platforms",- "search products",- "science brands"- ]- },- {- "name": "Submersible viewport",- "tier": "atmosphere",- "lineage": "Deep-sea research submersibles, one acrylic sphere of light",- "spark": "Six thousand metres of black water, one lit instrument, and something pale drifting past the glass.",- "system": [- "Palette/material: abyssal near-black; instrument amber and green as flat lit segments; the viewport ringed in cold blue",- "Type/composition: instrument mono for depth and heading; species callouts in a pale wide serif",- "Topology/navigation: the dive profile orders sections by depth; the viewport frames each encounter",- "Controls/state: sonar pings mark interactive points; the floodlight reveals detail states",- "Responsive/motion: the viewport circle holds center at all sizes; each encounter drifts in once, glacially"- ],- "webLeverage": "a clip-path circle that widens with scroll is the floodlight, with no glow",- "fits": [- "deep-data products",- "exploration",- "research"- ]- },- {- "name": "Orchard stand",- "tier": "atmosphere",- "lineage": "Roadside fruit stands, painted plywood and sun",- "spark": "HONEYCRISP $4 hand-painted on plywood, and the paint faded exactly where the sun hits.",- "system": [- "Palette/material: sun-bleached plywood buff; hand-paint reds and greens gone chalky; crate-stamp inks",- "Type/composition: sign-painter caps with visible brush confidence; prices enormous and honest",- "Topology/navigation: crates and a hanging scale structure the stall; painted arrows do the pointing",- "Controls/state: the scale needle is the live state; sold-out states get the painted SORRY slat",- "Responsive/motion: crates stack simply; the hanging scale settles once when loaded"- ],- "webLeverage": "an SVG displacement filter roughens the type edges like brush on plywood",- "fits": [- "food",- "local commerce",- "seasonal brands"- ]- },- {- "name": "Press floor",- "tier": "atmosphere",- "lineage": "Working letterpress shops, type cases and proofs",- "spark": "Ink under every fingernail, proofs pinned three deep, and a galley that has to be perfect by six.",- "system": [- "Palette/material: ink-stained wood browns; galley-metal greys; proofing red for corrections only",- "Type/composition: honest workshop caps from the case; proof annotations in a marking pencil style",- "Topology/navigation: type cases and pinned proofs structure the sections; the composing stick holds the featured line",- "Controls/state: proof states show correction marks; approved pulls get the PRINT stamp",- "Responsive/motion: cases stack, proofs re-pin; the press cycle is one heavy, decisive motion"- ],- "webLeverage": "CSS mask-image with a grain texture prints ink coverage unevenly, like a real pull",- "fits": [- "studios",- "publishing tools",- "maker brands"- ]- },- {- "name": "Grand hotel desk",- "tier": "atmosphere",- "lineage": "1930s grand hotel reception, pigeonholes and brass keys",- "spark": "A wall of pigeonholes, a bell that means someone will actually come, and a ledger that knows everyone.",- "system": [- "Palette/material: marble cream and walnut; brass key-plate gold; hotel-livery deep green as the accent",- "Type/composition: an elegant engraved serif; room numbers on brass plates",- "Topology/navigation: the pigeonhole wall is the content grid; the register book is the nav; the bell is the CTA",- "Controls/state: a pigeonhole with mail lights in brass; the checked-in state hangs the key",- "Responsive/motion: pigeonholes reflow as a smaller wall; the bell dips once when pressed"- ],- "webLeverage": "CSS grid dense packing keeps the pigeonhole wall solid at every width",- "fits": [- "hospitality",- "concierge products",- "membership"- ]- },- {- "name": "Ferry terminal",- "tier": "atmosphere",- "lineage": "Working harbour ferry terminals, painted steel and tide boards",- "spark": "Painted steel, coiled rope, a chalked tide board, and a horn you feel in your chest.",- "system": [- "Palette/material: marine-painted steel greens and whites, weathered honestly; safety yellow gangway markings; chalk white",- "Type/composition: harbour stencil caps; the tide board in a chalk-white condensed face; sailing times in tabular figures",- "Topology/navigation: berths order the sections; the tide board is the live data panel; gangway arrows direct",- "Controls/state: boarding states raise the gangway light; cancelled sailings are chalked through, not deleted",- "Responsive/motion: berths stack along the quay; the water line moves, the steel never does"- ],- "webLeverage": "CSS custom-property-driven chalk strikethroughs keep cancellations legible and honest",- "fits": [- "transport",- "schedule products",- "coastal brands"- ]- },- {- "name": "Airship gondola",- "tier": "atmosphere",- "lineage": "Rigid-airship passenger gondolas, wicker and chart tables",- "spark": "Wicker chairs, a chart table, and the Atlantic sliding by underneath at a civilised speed.",- "system": [- "Palette/material: sky silver-blues through slanted windows; wicker and walnut warms; route-map inks",- "Type/composition: a dignified travel serif with engraved numerals; altitude and heading in brass-instrument mono",- "Topology/navigation: the promenade windows sequence the content; the chart table holds the overview",- "Controls/state: instruments show live readings; the moored state brings the gangway out",- "Responsive/motion: windows become a single panoramic band; clouds pass on a very long loop"- ],- "webLeverage": "background-attachment and layered translateZ give the window view its slow parallax depth",- "fits": [- "journey products",- "premium travel",- "roadmap pages"- ]- }-]diff --git a/skills/hallmark/scripts/refcheck.mjs b/skills/hallmark/scripts/refcheck.mjsindex 4a600fc..97869a5 100644--- a/skills/hallmark/scripts/refcheck.mjs+++ b/skills/hallmark/scripts/refcheck.mjs@@ -283,24 +283,13 @@ for (const target of clean) {else if (s.fails || s.reflex || s.warns) add('error', target, 1, 'lint', `must lint clean, has ${s.fails} FAIL, ${s.reflex} REFLEX, ${s.warns} WARN`);}-const ATLAS_BAD = [- [/\b(?:tiny|small)\s+(?:\w+\s+)?caps\b/i, 'labels in small capitals (67)'],- [/\bcaps\s+(?:labels|placards)\b/i, 'labels in capitals (67)'],- [/\b(?:wide|generous)\s+tracking\b/i, 'letter-spaced type (67)'],- [/(?<!\bno |\bno outer )\bglow(?:s|ing)?\b/i, 'a glow (29)'],- [/(?<!\bno )\bhalo\b/i, 'a halo (29)'],- [/backdrop-filter/i, 'glass (29)'],- [/\b(?:cyan|purple|violet)-to-/i, 'a gradient gate 2a refuses'],- [/\bhand-drawn\b|\billustration\b|\bpictogram rows?\b|\bdrawn (?:cord|cable|curtain|check|object)s?\b/i, 'a drawn illustration (80)'],- [/\bone (?:mark|dot|pictogram|tick) (?:per|for each)\b/i, 'a counting device (82)'],-];-const atlasFile = join(ROOT, 'scripts', 'atlas.json');-try {- for (const entry of JSON.parse(read(atlasFile))) {- const text = JSON.stringify(entry);- for (const [re, why] of ATLAS_BAD) if (re.test(text)) add('error', atlasFile, 1, 'atlas', `${entry.name} prescribes ${why}`);- }-} catch (e) { add('error', atlasFile, 1, 'atlas', `atlas.json does not parse (${e.message})`); }+// the custom draw deals its faces from fonts.md's own table; a reformatted table must not empty the deal+{+ const out = spawnSync(process.execPath, [join(ROOT, 'scripts', 'seed.mjs'), '--brief', 'refcheck', '--material', 'photo'], { encoding: 'utf8' }).stdout || '';+ const dealt = ((/^faces: (.*)$/m.exec(out) || [])[1] || '').split(' · ').filter(Boolean);+ if (dealt.length < 10 || !dealt.some((f) => f.startsWith('body sans ')) || !dealt.some((f) => f.startsWith('body serif '))) add('error', join(ROOT, 'scripts', 'seed.mjs'), 1, 'faces', `seed.mjs dealt ${dealt.length} faces from fonts.md; the display table or the body paragraph no longer parses`);+ if (!/^discipline: /m.test(out)) add('error', join(ROOT, 'scripts', 'seed.mjs'), 1, 'faces', 'seed.mjs printed no discipline');+}const FIX = join(ROOT, 'scripts', 'fixtures');const lintJson = (t) => { const r = spawnSync(process.execPath, [join(ROOT, 'scripts', 'sloplint.mjs'), t, '--json'], { encoding: 'utf8' }); try { return JSON.parse(r.stdout); } catch { return null; } };diff --git a/skills/hallmark/scripts/seed.mjs b/skills/hallmark/scripts/seed.mjsindex 2949c65..9557119 100644--- a/skills/hallmark/scripts/seed.mjs+++ b/skills/hallmark/scripts/seed.mjs@@ -1,17 +1,15 @@#!/usr/bin/env node+// The custom path's draw (references/direction.md R.4). From a seed made of the brief, the date and the re-roll count it+// picks which of the model's seven slate lines gets built, so the model never builds its own favourite, and deals one+// discipline: a system rule (colour, grid, type steps, pictures, motion) the page adopts unless its material refuses it.+// A discipline never brings a device, a material or a face: it can only make the page plainer and more exact. It also+// deals one display face per class and one body face of each kind from references/fonts.md, so the model starts from a+// dealt face instead of its favourite (left alone it set four custom pages of eight in the same grotesk).+// node seed.mjs --brief "<the brief>" [--n 7] [--reroll 0] [--material photo|product|words]import { readFileSync } from 'node:fs';import { fileURLToPath } from 'node:url';import { dirname, join } from 'node:path';-const TIERS = ['graphic-system', 'instrument', 'atmosphere'];-const PREFIXES = [- 'Palette/material:',- 'Type/composition:',- 'Topology/navigation:',- 'Controls/state:',- 'Responsive/motion:',-];-function fnv1a(str) {let h = 0x811c9dc5;for (let i = 0; i < str.length; i++) {@@ -21,15 +19,36 @@ function fnv1a(str) {return h >>> 0;}+// [the rule, the material it suits: any, photo, product or words]+const DISCIPLINES = [+ ['One field colour: a single colour carries about a third of the page as whole sections edge to edge, never as boxes; everything else sits on the ground.', 'any'],+ ['The ground is the colour: one deep or saturated ground for the whole page, ink and one accent on it, nothing else.', 'any'],+ ['One family: display and body come from one type family, and hierarchy comes from size and weight alone.', 'any'],+ ['Three sizes carry the page: display, section head and body, far apart (the display at least five times the body); titles take the one small step above the body and nothing else gets a size of its own.', 'any'],+ ['No boxes: no cards and no shadows, and no border except on an input; space and alignment part every group.', 'any'],+ ['Flush left: no centred head and no centred block; every left edge sits on one of three lines down the page.', 'any'],+ ['Dense, then empty: every dense section is followed by one that holds a single line in a lot of air.', 'any'],+ ['One rule system: hairlines are the only structure (under the nav, between rows, above the footer), one weight and one colour.', 'any'],+ ['Still: nothing moves except the signature; no reveal, no lift on hover, only colour changes on hover.', 'any'],+ ['The grid shows: every element starts and ends on the twelve columns, and the page breaks the grid exactly once, on purpose.', 'any'],+ ['Photographs bleed: every picture runs to the edge of its column or of the screen; none is framed, rounded or shadowed.', 'photo'],+ ['One decisive photograph: the page shows a single picture, very large, and lets type carry everything else.', 'photo'],+ ['Pictures in pairs: below the hero, photographs come two at a time at unequal sizes, each pair making one point.', 'photo'],+ ['The product at full width: the interface runs the width of the container with real data, no device frame and no tilt.', 'product'],+ ['The product up close: each section crops one part of the interface large enough to read, with one line beside it.', 'product'],+ ['A reading page: one long measure of 60 to 70 characters, generous leading, few sections, the type doing the work.', 'words'],+ ['Type is the picture: the first screen is set in type alone, and the largest line on it is the offer itself.', 'words'],+];+const args = process.argv.slice(2);const flag = (name, dflt) => {const i = args.indexOf(`--${name}`);return i !== -1 && args[i + 1] !== undefined && !String(args[i + 1]).startsWith('--') ? args[i + 1] : dflt;};-const ASK = new Set(['build', 'make', 'create', 'design', 'need', 'want', 'please', 'page', 'site', 'website', 'landing', 'called', 'for', 'and', 'the', 'with', 'that', 'this', 'our', 'your']);+const ASK = new Set(['build', 'make', 'create', 'design', 'need', 'want', 'please', 'page', 'site', 'website', 'landing', 'called', 'for', 'and', 'the', 'with', 'that', 'this', 'our', 'your', 'custom', 'theme']);const briefFlag = flag('brief', null);if (!briefFlag && (args.length === 0 || args[0].startsWith('--'))) {- console.error('usage: node seed.mjs --brief "<the brief>" [--n 7] [--reroll 0] [--wild 3] [--atlas <path>]');+ console.error('usage: node seed.mjs --brief "<the brief>" [--n 7] [--reroll 0] [--material photo|product|words]');process.exit(2);}const slug = briefFlag@@ -38,69 +57,34 @@ const slug = briefFlagconst n = Math.max(2, parseInt(flag('n', '7'), 10) || 7);const reroll = Math.max(0, parseInt(flag('reroll', '0'), 10) || 0);-const wildRaw = parseInt(flag('wild', '3'), 10);-const wild = Math.max(0, Number.isNaN(wildRaw) ? 3 : wildRaw);+const material = flag('material', '');+if (material && !['photo', 'product', 'words'].includes(material)) { console.error('--material is photo, product or words'); process.exit(2); }const date = new Date().toISOString().slice(0, 10);const seedKey = `${slug}·${date}·r${reroll}`;-const hash = fnv1a(seedKey);-const index = (hash % n) + 1;+const index = (fnv1a(seedKey) % n) + 1;+const pool = DISCIPLINES.filter(([, m]) => m === 'any' || !material || m === material);+const discipline = pool[fnv1a(`${seedKey}·discipline`) % pool.length][0];-function validateEntry(e, i) {- const fail = (msg) => {- console.error(`malformed atlas entry ${i} (${e && e.name ? e.name : 'unnamed'}): ${msg}`);- process.exit(1);- };- if (!e || typeof e !== 'object') fail('not an object');- for (const k of ['name', 'tier', 'lineage', 'spark', 'webLeverage']) {- if (typeof e[k] !== 'string' || !e[k].trim()) fail(`missing or empty "${k}"`);+// fonts.md is the one list: its display table (class | faces) and its body paragraph (Sans: ... Serif: ...)+const names = (txt) => txt.replace(/\([^)]*\)/g, '').split(/[;,]/).map((f) => f.trim()).filter((f) => f && !/only with an argument/.test(f));+let faces = [];+try {+ const src = readFileSync(join(dirname(fileURLToPath(import.meta.url)), '..', 'references', 'fonts.md'), 'utf8');+ const table = (src.split('## Display faces the catalog does not use')[1] || '').split('\n## ')[0];+ for (const line of table.split('\n')) {+ const m = /^\|\s*([^|]+?)\s*\|\s*([^|]+?)\s*\|\s*$/.exec(line);+ if (!m || m[1] === 'Class' || /^-+$/.test(m[1])) continue;+ const list = names(m[2]);+ if (list.length) faces.push(`${m[1].toLowerCase()} ${list[fnv1a(`${seedKey}·${m[1]}`) % list.length]}`);}- if (!TIERS.includes(e.tier)) fail(`tier "${e.tier}" is not one of ${TIERS.join(' / ')}`);- if (!Array.isArray(e.system) || e.system.length !== 5) fail('system must be exactly five lines');- e.system.forEach((line, j) => {- if (typeof line !== 'string' || !line.startsWith(PREFIXES[j])) {- fail(`system line ${j + 1} must start with "${PREFIXES[j]}"`);- }- });- if (!Array.isArray(e.fits) || e.fits.length === 0) fail('fits must be a non-empty array');-}--let challengers = [];-if (wild > 0) {- const atlasPath = flag('atlas', join(dirname(fileURLToPath(import.meta.url)), 'atlas.json'));- try {- const atlas = JSON.parse(readFileSync(atlasPath, 'utf8'));- if (!Array.isArray(atlas) || atlas.length === 0) throw new Error('atlas is empty');- atlas.forEach(validateEntry);-- const byTier = Object.fromEntries(TIERS.map((t) => [t, atlas.filter((e) => e.tier === t)]));- const dealt = new Set();- for (let k = 0; k < wild; k++) {- const tier = TIERS[k % TIERS.length];- const pool = byTier[tier].filter((e) => !dealt.has(e.name));- if (pool.length === 0) continue;- const j = fnv1a(`${seedKey}·t${tier}·k${k}`) % pool.length;- dealt.add(pool[j].name);- challengers.push(pool[j]);- }- } catch (e) {- if (e && e.code === 'ENOENT') {- console.error(`(atlas unavailable at ${atlasPath}; drawing without challengers)`);- } else {- console.error(`atlas error: ${e.message}`);- process.exit(1);- }+ const body = (src.split('## Body faces')[1] || '').split('\n## ')[0];+ for (const [kind, re] of [['sans', /Sans:([^.]*)\./], ['serif', /Serif:([^.]*)\./]]) {+ const list = names((re.exec(body) || [])[1] || '');+ if (list.length) faces.push(`body ${kind} ${list[fnv1a(`${seedKey}·body ${kind}`) % list.length]}`);}-}+} catch { faces = []; }-let line = `draw: ${index}/${n} (seed ${seedKey})`;-if (challengers.length) line += ` · challengers: ${challengers.map((c) => c.name).join(' · ')}`;-console.log(line);--for (const c of challengers) {- console.log(` challenger · ${c.name} [${c.tier}] · lineage: ${c.lineage}`);- console.log(` spark: ${c.spark}`);- for (const s of c.system) console.log(` ${s}`);- console.log(` webLeverage: ${c.webLeverage}`);- console.log(` fits: ${c.fits.join(', ')}`);-}+console.log(`draw: ${index}/${n} (seed ${seedKey})`);+console.log(`discipline: ${discipline}`);+if (faces.length) console.log(`faces: ${faces.join(' · ')}`);diff --git a/skills/hallmark/scripts/theme.mjs b/skills/hallmark/scripts/theme.mjsindex e992d78..b404233 100644--- a/skills/hallmark/scripts/theme.mjs+++ b/skills/hallmark/scripts/theme.mjs@@ -254,9 +254,10 @@ function check() {const hue = flag('hue') != null ? Number(flag('hue')) : null;const themes = loadIndex();const log = readLog(flag('log', '.hallmark/log.json'));- let bad = 0;+ let bad = 0, near = 0;+ const look = (t) => `look at references/themes/${t.slug}.jpg beside your plan and move an axis only if the two would read alike`;if (axes) for (const t of themes) {- if (t.paper.band === pb && t.display.class === dc && t.accent.band === ab) { bad++; console.log(`collision: ${t.name} owns ${triple(t)} · move one axis, accent first`); }+ if (t.paper.band === pb && t.display.class === dc && t.accent.band === ab) { near++; console.log(`near: ${t.name} sits on ${triple(t)} · ${look(t)}`); }}const toks = (x) => x.split(/[\s-]+/).filter(Boolean);const sameFamily = (a, b) => { const A = toks(a), B = toks(b), n = Math.min(A.length, B.length); return n > 0 && A.slice(0, n).join(' ') === B.slice(0, n).join(' '); };@@ -265,12 +266,12 @@ function check() {if (sameFamily(tf, face)) { bad++; console.log(`collision: ${t.name} already sets its display in ${t.display.face} · pick a face no theme uses (fonts.md)`); }}if (hue != null) for (const t of themes) {- if (t.paper.band === pb && t.display.class === dc && hueGap(t.accent.hue, hue) <= 20) { bad++; console.log(`adjacent: ${t.name} is ${triple(t)} at hue ${t.accent.hue} · move the accent hue more than 20 degrees (40 reads as another colour), or change the display class`); }+ if (t.paper.band === pb && t.display.class === dc && hueGap(t.accent.hue, hue) <= 20) { near++; console.log(`near: ${t.name} is ${triple(t)} at hue ${t.accent.hue} · ${look(t)}`); }}const recent = axes ? log.slice(0, 3).filter((r) => r.axes === axes) : [];- for (const r of recent) { bad++; console.log(`recent: ${r.theme || 'a build'} on ${r.date || '?'} used ${axes}`); }- if (!bad) { console.log(axes ? `clear: ${axes}${face ? ` in ${face}` : ''}${hue != null ? ` at hue ${hue}` : ''} lands on no catalog theme and no recent build` : `clear: no catalog theme sets its display in ${flag('face')}`); return; }- process.exitCode = 1;+ for (const r of recent) { near++; console.log(`recent: ${r.theme || 'a build'} on ${r.date || '?'} used ${axes} · vary another decision (the shape, the pictures, the type scale)`); }+ if (!bad && !near) { console.log(axes ? `clear: ${axes}${face ? ` in ${face}` : ''}${hue != null ? ` at hue ${hue}` : ''} lands on no catalog theme and no recent build` : `clear: no catalog theme sets its display in ${flag('face')}`); return; }+ if (bad) process.exitCode = 1;}function list() {@@ -518,7 +519,7 @@ function scaffold() {: brand? `/* Hallmark · shape: <shape, or kept> · genre: <genre> · theme: brand${tail}${made} · hero: <posture, or kept> · nav: <shape, or kept> · footer: <shape, or kept> · signature: <the one move, or kept>\n * axes: ${axes} · contrast: pass · fold: pass · v${VERSION} */`: custom- ? `/* Hallmark · shape: <shape> · genre: <genre> · theme: custom${tail} · direction: "<drawn, n/7>" · vibe: "<4 to 8 words>"${made} · hero: <posture> · nav: <shape> · footer: <shape> · imagery: <photographs, the product, or none> · signature: <the one move>\n * axes: ${axes} · seed: <key> · challenger: <name> (<verdict or raise>) · contract: <after the finish review> · contrast: pass · fold: pass · v${VERSION} */`+ ? `/* Hallmark · shape: <shape> · genre: <genre> · theme: custom${tail} · idea: "<the drawn line, n/7>" · vibe: "<4 to 8 words>"${made} · hero: <posture> · nav: <shape> · footer: <shape> · imagery: <photographs, the product, or none> · signature: <the one move>\n * axes: ${axes} · seed: <key> · discipline: <the dealt rule, or refused: why> · contract: <after the finish review> · contrast: pass · fold: pass · v${VERSION} */`: `/* Hallmark · shape: <shape${kept}> · genre: ${header.genre} · theme: ${theme}${tail}${depth ? '' : ' · draw: <seed>'}\n * hero: <posture${kept}> · nav: <shape${kept}> · footer: <shape${kept}> · imagery: <photographs, the product, or none> · signature: <the one move>${dial ? ` · ${dial[1]}: <the dials>` : ''}\n * axes: ${axes} · contrast: pass · fold: pass · v${VERSION} */`;console.log(`wrote ${out} (${brand ? 'the shared scale; fill every --color-* and --font-* from the palette and faces the pre-flight found' : custom ? 'the shared scale; fill every --color-* and --font-* from direction.md § B and § C before building' : `${name} tokens plus the shared scale`}) and ${baseOut} (the base rules the Floor already decided)${sheet && !flag('dir', '') ? `, beside ${sheet}` : ''}`);if (!custom && !flag('dealt', '')) {