@struq/skill 0.5.2 → 0.5.3

package/skills/struq/SKILL.md

@@ -6,51 +6,58 @@ argument-hint: "[brief] | redesign <path> | audit <path-or-url> | direct <brief>
 
 # Struq
 
-A site looks like a template when every choice is the likeliest one, and like a showreel when every slot gets the
-loudest block. Struq casts studio blocks into one film; your job is the treatment, the copy and the seams, never a
-rebuild of what a block does. `<skill-dir>` is this file's folder; the catalogue is [blocks/CATALOG.md](blocks/CATALOG.md),
-a worked treatment per language [references/film.md](references/film.md), the craft [references/craft.md](references/craft.md).
+You are the director. Struq gives you a catalogue of studio-grade blocks ([blocks/CATALOG.md](blocks/CATALOG.md)),
+a canon of palettes and pairings, a photo library and a self-check. They are a toolbox, not a menu: the site should
+look like it could only belong to this one client, and like nothing Struq built before. `<skill-dir>` is this file's
+folder. Worked treatments: [references/film.md](references/film.md); craft: [references/craft.md](references/craft.md).
 
 | Invocation | Mode |
 |---|---|
-| `/struq <brief>` | **Build**: the checklist below, start to finish. |
-| `/struq redesign <path>` | Keep the brand, copy and components ([references/triage.md](references/triage.md)); write a treatment of the page as it will be (kept sections as own scenes) and stop once as in step 2, then swap in blocks where the page is weakest and run the checklist from step 3. |
-| `/struq audit <path-or-url>` | Change nothing. Run `check.mjs` (and `struq_controle` when connected), report every FAIL and WARN and the three fixes with the most visual payoff. Never a numeric score. |
-| `/struq direct <brief>` | One continuous WebGL experience across chapters: steps 1 to 4, then [cinematic/README.md](cinematic/README.md). |
+| `/struq <brief>` | **Build**: the checklist below. |
+| `/struq redesign <path>` | Keep brand, copy and components ([references/triage.md](references/triage.md)); write the treatment of the page as it will be, stop once, then swap in blocks where it is weakest and run the checklist from step 3. |
+| `/struq audit <path-or-url>` | Change nothing. Run `check.mjs` (or `struq_controle`), report every FAIL and WARN and the three fixes with the most payoff. Never a score. |
+| `/struq direct <brief>` | One continuous WebGL experience: steps 1 to 4, then [cinematic/README.md](cinematic/README.md). |
 
-For a dashboard or product UI keep the tokens, faces and tells; drop the preloader, Lenis and the pinned pieces.
-
-## Three rules that never bend
+## Rules that never bend
 
 1. **Never an empty frame.** Every image slot holds a real photo: the client's, else the beeldbank pack (free, CC0,
-   no permission needed). A photo shows the world around the client, never their own room, team or product unless it
-   is theirs; captions are written from the alt.
-2. **Never invent facts.** No testimonials, logos, stats, awards, prices, addresses, hours, bios or quotes the brief
-   did not give. Leave them out and list them under Assumptions in STRUQ.md.
+   no permission needed). Pack photos are mood: the world around the client, never their own room, team, work or
+   product. So never set one under a first-person claim ("our oven", "every piece we make", "my plates"), and where
+   the work is the product (a portfolio, a shop, a collection) build the frame for their work and ask for it at the
+   stop. A caption is copy you write for this client, never the alt read back.
+2. **Never invent, never stand in.** No testimonials, logos, stats, awards, prices, addresses, hours, bios, quotes,
+   product features, programme, process, equipment (a wood oven) or name the brief did not give. A missing fact
+   leaves no trace: no "to follow", "to be announced", "Your Name", example.com, and no button for an action with no
+   real destination (shop, booking, contact, sign-up), no "come by" without the address. Drop the line, the field or
+   the button and list it under
+   Assumptions in STRUQ.md. With no door (no address, phone, mail, booking or shop link from the brief or the stop) the
+   site ends on the idea, never on an invitation: no "Schuif aan", "Pick up a mug", "Book a class" or "Shop the
+   collection", and Assumptions names the door the client must add. With no name in the brief the header shows no
+   wordmark and the opener and the close carry none (or ask for the name at the one stop); the trade word ("Yoga",
+   "Bakery") is never a name. The self-check fails stand-ins, links to anchors that do not exist, calls with no door
+   and a trade word as the name.
 3. **Never the tells** ([references/tells.md](references/tells.md)): no eyebrows, pills, gradients or gradient text,
    glow, mono on marketing, Inter or the other generator faces, default purple or blue, numbered steps, icon grids,
    stat banners, generic CTAs, em or en dashes.
+4. **Copy in the client's market language**, which may differ from the brief's (a plumber in Utrecht reads Dutch).
+   Say which on the Brief line and under Assumptions. Write it as a native copywriter would, never a translation.
 
-## The MCP, or the skill's own copy
-
-Same blocks, same derivation: use the MCP tool when it is connected, else the offline column from the skill's copy.
+## Tools: the MCP, or the skill's own copy
 
 | Need | MCP connected | Offline |
 |---|---|---|
-| A direction: palette, pairing, photo pack as tokens and fonts | `struq_richting(brief)` (or with `palette`, `type` ids) | `canon.mjs list`, then `canon.mjs palette <id>` and `canon.mjs type <id>`; `images.mjs --brief` |
-| What blocks exist | `struq_blokken(kind?, query?)` | `blocks.mjs list [kind]`, [blocks/CATALOG.md](blocks/CATALOG.md) |
+| Palette, pairing, photo pack as tokens and fonts | `struq_richting(brief)` | `canon.mjs draw` (this site's hand), `canon.mjs palette <id>`, `canon.mjs type <id>`; `images.mjs --brief` |
+| What blocks exist | `struq_blokken(kind?, query?)` | `blocks.mjs list [kind]` |
 | A block as files | `struq_blok(slug, variant?)` | `blocks.mjs add <slug>` |
-| The tell check | `struq_controle()`: run its detectors on your own files | `check.mjs` |
+| The self-check | `struq_controle()` | `check.mjs` |
 
-`struq_richting`'s token block replaces STRUQ TOKENS in `app/globals.css`, its font URLs go in `app/fonts.ts`;
-`struq_blok`'s files go into `components/struq/` at their paths. Log each call:
-`node <skill-dir>/scripts/log.mjs mcp <tool> --note "<what you took>"`. Run `check.mjs` either way.
+Log each MCP call: `node <skill-dir>/scripts/log.mjs mcp <tool> --note "<what you took>"`.
 
 ## Build checklist
 
-Copy this into `STRUQ.md` under the plan and tick each line as you finish it. Keep `STRUQ-LOG.md` from the first
-step: append only, one entry per step (`node <skill-dir>/scripts/log.mjs "Step N Name" "what" "why"`; the scripts log
-their own). `check.mjs` fails while a line is open or a ticked step has no entry.
+Copy this into `STRUQ.md` under the plan and tick each line when done. Log every step in `STRUQ-LOG.md`
+(`node <skill-dir>/scripts/log.mjs "Step N Name" "what" "why"`); `check.mjs` fails while a line is open or a ticked
+step has no entry.
 
 ```
 ## Build checklist
@@ -60,170 +67,166 @@ their own). `check.mjs` fails while a line is open or a ticked step has no entry
 - [ ] 4 Images: images.mjs --brief printed OK; only photos whose alt fits the client
 - [ ] 5 Scenes: frames and the centerpiece installed, every other scene built as the storyboard says, composed in app/page.tsx with real copy
 - [ ] 6 Build: npm run build passes
-- [ ] 7 Look: 390 and 1440 screenshots and one full scroll, fixes made (or "Verify: not seen, no browser")
+- [ ] 7 Look: LOOK: PASS on the served build, its screenshots read; a fresh subagent's asks in .struq/art-direction.md each answered Built: or Refused:, then LOOK: PASS again
 - [ ] 8 Check: check.mjs prints RESULT: PASS
 ```
 
-**1 Project.** Empty folder: `npx create-next-app@latest . --ts --tailwind --app --eslint --yes`, then
-`node <skill-dir>/scripts/blocks.mjs init`: the kit in `components/struq/kit/`, the layout (`sq-js` before paint,
-font links, `data-blocks` on `<body>`, `SmoothScroll`), `globals.css` (kit import, theme names, STRUQ TOKENS),
-`fonts.ts`, gsap, @gsap/react and lenis. It never overwrites your layout or stylesheet: merge from `recipes/app/`.
-
-**2 Treatment and the one stop.** Pick from the canon, never invent a palette or pairing while one fits: palette by
-mood, then sector; a "kept out" palette (blue, purple, teal) only for a brand of that colour, declared as `Cool hue:
-declared because <brand colour>`; the brand's own colours and faces beat the canon, in the same token names. Pairing
-by temperament: Fraunces (serif-editorial) warm and premium, Newsreader literate, Sora calm and architectural,
-Urbanist soft and current, Bodoni Moda for fashion, Big Shoulders (condensed-poster) for a campaign at poster scale,
-Unbounded for a wide agency voice. Pick the language (The film, below), then run
-`node <skill-dir>/scripts/blocks.mjs arc <language>` and paste the Tone arc and Storyboard it prints into the
-treatment at the top of STRUQ.md. Fill every `<...>`, one pick per line (`or:` lists what else fits; swap at most one
-scene; a block the user names goes in first):
+**1 Project.** `npx create-next-app@latest . --ts --tailwind --app --eslint --yes`, then
+`node <skill-dir>/scripts/blocks.mjs init` (the kit, layout, tokens, fonts, gsap and lenis; it never overwrites your
+files, merge from `recipes/app/`).
+
+**2 Treatment, then stop once.** Think like a studio pitching this client. First run
+`node <skill-dir>/scripts/canon.mjs draw`: it deals this site a hand, two languages, two type pairings, two
+palettes (one light, one dark) and three lenses, the way a creative director hands a team its constraints. Every site gets a different hand,
+so no two start from the same place; your craft is choosing well within it. Write three ideas, one from each lens
+(each a point of view on this client, not a description), take the one a rival studio would least expect that still
+fits this client, and note the other two as Passed over. Name the Subject: what the brief is about
+that a visitor must see (the app, the event, the garment, the cup, the bread); the site shows it (step 5). Then
+the Unlike line: the site any agent would build, and Struq's own reflexes, which you must also avoid (a framed photo
+with the name small beside it; one italic word in every headline; a middle of one-word rows, a sentence with a small
+photo and a photo beside text; an echo close over a full-width wordmark). Pick the language from the hand, run
+`node <skill-dir>/scripts/blocks.mjs arc <language>`, and cast every line of the storyboard it prints, each pick with
+its reason after "because": the Opening and the Centerpiece from the five each it deals (look at the photos first,
+step 4), the middle scenes named and designed for this client, the close ending where the idea ends. Invent own scenes wherever the
+idea wants a moment no block gives. Outside the hand only what the client gave: their brand colours or faces, marked
+`(brand)`, or a block they named, marked `(named)`.
 
 ```
 # STRUQ.md: <name>
-Brief: <one line: what, for whom, where>
-Idea: <a point of view in one sentence, never a description of the client: what a visitor believes when they leave>
-Language: <weight | cut | curtain> (<the client's sector, or the brief's own words for another feel>)
+Brief: <one line: what, for whom, where, in which language>
+Hand: <the id canon.mjs draw printed>
+Idea: <lens>: <a point of view in one sentence: what a visitor believes when they leave>
+Passed over: <your two other ideas, one line>
+Subject: <what the visitor must see> -> <shown by: the client's photo, a pack photo that shows it, or drawn in code>
+Unlike: <the likeliest site, and Struq's reflexes> -> <what this one does instead>
+Language: <weight | cut | curtain> (<the tempo the idea needs>; not <each of the other two>, because <why not>; temperament: <the language's default, or its neighbour and why>)
 Motif: <line | frame | aperture | cut | word | field>: <what it is in this client's world and how it changes down the page>
-Lexicon: <three to five working words of the client's trade (a material, a part, a tool, a unit), never the brief repeated; every label, counter and caption uses these, no film or studio jargon the client does not own>
+Lexicon: <three to five working words of the trade; every label and caption uses them>
 Palette: <id> (<mood>)
-Type: <pairing id>: <display> + <body>
+Type: <pairing id>: <display> + <body> (not <the pairing you passed over>, because <why>)
 Images: pack <slug> (or the client's photos, then pack <slug>)
 Centerpiece: <block>: <why this is this site's one moment>
 Tone arc: <as blocks.mjs arc printed it>
-Storyboard:
-1. Arrival   (frame)  <preloader of the language> | lands on: <what>
-2. Opening   (loud)   <block:variant> | on screen: <...> | enters: <...> | hands over: <...>
-3. <scene>   (quiet)  <block:variant or kit scene> | on screen: <...> | enters: <...> | hands over: <...>
-...
-N. Close     (quiet)  <block or kit scene> | echoes the opening: <how> | footer: <block>
-Assumptions: <every drafted line and every fact left out>
+Storyboard: <as blocks.mjs arc printed it, every line cast>
+Assumptions: <every drafted line, every fact left out, the copy language>
 Verify: <filled in at step 7>
 ```
 
-Run `node <skill-dir>/scripts/check.mjs --plan` and fix every FAIL and every `quiet-is-quiet`, `loud-adjacent` and
-`quiet-share` warning until it prints `PLAN: PASS` without them. `canon.mjs` and `blocks.mjs add` refuse until the
-plan passes and the reply is logged. Then **stop once**, in the user's language, and show the treatment, never block
-slugs: idea, language, motif and centerpiece in plain words; the storyboard as numbered lines, one sentence each of
-what the visitor sees; palette, type and pack on one line; then "Akkoord? Heb je een logo, foto's of echte cijfers,
-stuur ze nu." (English: "Approve? If you have a logo, photos or real numbers, send them now."). The build request is
-not the approval. Log the reply word for word: `log.mjs "Step 2 Approval" "Asked: ..." "Reply: \"<their words>\""`.
-Any yes builds the treatment; what they send replaces the matching pick; a veto changes only what it names. Never
-ask twice. No pack shows the client's product? Add: "Ik heb geen foto's van je <product>: stuur ze, dan komen ze in de hero."
-
-**3 Canon.** `canon.mjs palette <id>` and `canon.mjs type <id>` rewrite the one STRUQ TOKENS block and `app/fonts.ts`.
-
-**4 Images.** `node <skill-dir>/scripts/images.mjs --brief "<the brief, in the user's words>"` keeps only the pack's
-photos whose alt fits the client, verifies them into `public/images/` and writes `lib/struq-images.ts` (`images.hero`,
-`.band`, `.card`, `.column`, `.detail`, `.backdrop`, `imageCredit`, `imageFit`). Read the alts before you place a
-photo; with `imageFit` "none" a background block carries the hero. Title and `lang` go in the layout.
-
-**5 Scenes.** Install the frames and the centerpiece first (`blocks.mjs add <slug>:<variant>` or `struq_blok`), then
-each scene as its storyboard line says, the quiet ones with the kit's four (The film, below). Read each file header
-for its props and how it mounts; fill every label, counter and caption from the lexicon; wrap the tone arc's ink or
-field scenes in `scene-inverse` or `scene-field` (a kit scene takes it as `className`). Glue and an own scene use
-`Reveal`, `MediaFrame` and `SplitHeadline`, and an own scene's root carries `data-scene="<name>"`.
-
-**6 to 8.** `npm run build` passes (fix your code; never delete a block for green). View `npx next start -p 4321` at
-390 and 1440, scroll once: the preloader lands on the hero, every frame fills, each pin engages and lets go without a
-jump, nothing overflows, scrolling back reverses. Never claim what you did not see. Then `check.mjs` to `RESULT: PASS`.
+Run `node <skill-dir>/scripts/check.mjs --plan` until `PLAN: PASS` with no `quiet-is-quiet`, `loud-adjacent` or
+`quiet-share` warning. Then stop once, in the user's language: the treatment in plain words (never slugs), the
+storyboard as one sentence per scene, palette, type and pack on one line, and ask for what only the client has and
+the page needs: their name if the brief gave none, how visitors reach them (address, phone or mail; the shop, booking
+or sign-up link), their own photos when the work is the product. End with "Akkoord?" or "Approve?". The build request
+is not the approval. Log the reply word for word: `log.mjs "Step 2 Approval" "Asked: ..." "Reply: \"<their words>\""`.
+Any yes builds it; what they send replaces the matching pick; whatever stays unanswered is left out. Never ask twice.
+
+**3 Canon.** `canon.mjs palette <id>` and `canon.mjs type <id>` write the one STRUQ TOKENS block and `app/fonts.ts`.
+
+**4 Images, done before you cast the Opening.** In step 2, before the storyboard, run
+`node <skill-dir>/scripts/images.mjs --brief "<the user's words>"` and open the hero photos it wrote
+(`public/images/hero-*.webp`) with your image reader. A photo opens the site only if it shows this client's own
+subject: a tap or a bathroom for a plumber, a mug for a mug shop, a city lot for a city garden. A photo that only
+sets a mood (paper for a conference, cloth for a label, a room for a studio you have never seen) never opens a site.
+If none shows the subject, run it again with `--no-hero`, and the Opening is type-led or WebGL (the hand always holds
+one). Never widen the brief to
+make a pack fit; the other photos serve the middle only where they show this client's world, never under a
+first-person claim.
+
+**5 Scenes.** Install the frames, the opening, the centerpiece and the footer (`blocks.mjs add <slug>:<variant>`):
+these are the signatures, hardened blocks. The middle is yours. Compose each middle scene for this client from the
+primitives (`SplitHeadline` for fitted type, `Reveal`, `MediaFrame`, the grid and the tokens), from what only this
+trade has: a price board for a bakery, a tide table for a guesthouse, a joint drawn to scale for a plumber, a menu set
+like a chalkboard for a restaurant. No two middle scenes share a layout, and none is a one-word list, a big sentence
+with a small photo, or a photo beside text unless the idea truly asks for it.
+
+When no photo shows the Subject, design it in code as a scene of its own, often the centerpiece's neighbour: the
+app's real screen or document (the invoice of an invoicing app) built in HTML with the tokens, the event's identity (a
+poster system, a badge, a programme grid with only the slots the brief gives), the label's lookbook frame, a menu
+board. Sample content inside it reads as an example of the trade (an invoice for "Studio Noord, identity, round 2"),
+never as a fact about the client: no customer names, no figures they would quote, no feature the brief did not give.
+Start from the kit's designed pieces in `@/components/struq/kit/subject` before drawing your own: `Document` (an
+invoice, quote, receipt, menu or label), `AppScreen` (a window or phone with the app's real screen), `Ticket` (a
+ticket, badge or poster), `PatternPaper` (a sewing pattern) and `SectionDrawing` (a technical section). Fill them with
+this client's content and palette; read each file header for its props and its scroll motion.
+
+Own scenes may move. Give at least two of them a motion of their own, tied to the scroll and reversing (a line that
+draws as you read, a document that assembles, a grid that sorts itself), never a pin over one screen; mark the root
+`data-scene="<name>" data-energy="2"`, tag it (loud) in the storyboard, and keep the budgets. Compose them from
+`@/components/struq/kit/motion` first (`RevealText`, `MaskWipe`, `ImageCurtain`, `ScrubLine`, `HoverLink`,
+`Pressable`); write `gsap` from `@/components/struq/kit/gsap` only for what they cannot do, timed by `feel()` from
+`@/components/struq/kit/feel`, never a literal ease or duration. A still own scene is `data-scene="<name>"` alone.
+The kit's `Statement`, `PhotoText` and `Rows` (`@/components/struq/kit/quiet`) remain for a plain moment, at most one
+per page. Build the close with `Close`: shape `idea` (the idea's last line and the motif drawn), `echo` (the opening
+returns smaller) or `door` (the brief's real address, phone, mail or booking link, set large). The name at full width
+is never the close; a wordmark there stays at text size. Read each file header for its props. Wrap ink or field scenes in
+`scene-inverse` or `scene-field`. Every section, the hero too, says its ground with `data-bar-tone` ("photo" only
+where the bar sits over the photo); the bar never repeats a name the hero sets at poster scale.
+
+**6 to 8.** `npm run build` passes (fix your code; never delete a block for green). Serve it with
+`npx next start -p 4321` (or a free port when that one is taken, then `look.mjs --url http://localhost:<port>`),
+leave it running, and run `node <skill-dir>/scripts/look.mjs` (the first run installs Playwright into the project).
+Never stop a server you did not start. It scrolls the page at 390 and 1440 with motion on, saves every step to
+`.struq/look/`, and fails on text under the header, the site name twice on the first screen, letters cut by a mask
+or the screen edge, a page wider than the screen, low contrast on a solid ground or measured over a photo, a blank
+screen, a number broken across lines, a font that never loaded, and console or image errors; it warns on a
+screen-high empty stretch. Open the screenshots and crops it names and read
+them as a studio's art director would: the preloader lands, every pin engages and lets go, the first screen is bold
+enough to stop a visitor. Fix, rebuild, restart the server and run it again until `LOOK: PASS`.
+
+**Art direction.** Then hand the site to a fresh pair of eyes: start a subagent (the Agent tool in Claude Code, or your
+host's equivalent) and give it only the brief, the Idea line, the paths of the stills in `.struq/look/` and
+[references/art-direction.md](references/art-direction.md), never your plan or your reasoning. Save its answer to
+`.struq/art-direction.md` as numbered asks, and write an answer line under each: `Built: <what changed>` or
+`Refused: <reason>`. The asks are binding. Build every one. When an ask needs another order, opening or centerpiece,
+rewrite the storyboard in STRUQ.md and swap the blocks (the storyboard serves the site); when it breaks a budget, keep
+the budget by dropping something else. Refuse only an ask that breaks a rule that never bends or a fact of the brief
+(a price, an address, a programme nobody gave), and say which. A refusal that cites the storyboard, the plan, a budget
+or a block is no refusal: `check.mjs` fails it, and fails an ask with no answer. Rebuild, run `look.mjs` again, and ask
+a new subagent once more; two rounds at most, each logged with `log.mjs`. A host without subagents: reread only the
+brief, then read the stills against that file yourself. Then `check.mjs` to
+`RESULT: PASS`; it fails while `.struq/look.json` is missing, failing or older than app/ and components/. A FAIL you
+are sure is false goes in the final report with the reason, never worked around. Stop the server when done.
 
 ## The film
 
-One film, not a showreel: every frame from one language, one arc, one centerpiece, one motif seen at the arrival,
-the opening, the centerpiece and the close. A loud scene moves with the scroll (a pin, a scrub, a reveal to full
-bleed); a quiet scene is type and a photo that enter once and sit still. Two tags only: `(loud)` when the block's
-energy in the catalogue is 2 or more, `(quiet)` at 1 or less, for a kit scene or for an own scene.
-
-| Language | For | Feel | Frames: preloader, page transition, menu | Motif |
-|---|---|---|---|---|
-| weight | architecture, hotels, craft, interiors | photographic and slow; a print grows into place; long holds | `preloader-stack`, `page-transition-stack`, `menu-curtain:stack` | frame |
-| cut | fashion, agencies, portfolios, music | hard cuts, short masks, no fades, short holds | `preloader-slices`, `page-transition-slices`, `menu-curtain:slices` | cut or word |
-| curtain | campaigns, launches, events, culture | a light line, panels part, a long hold before the reveal | `preloader-gate` or `preloader-wordmark:split`, `page-transition-gate`, `menu-curtain:gate` | line or aperture |
-
-Pick the language by the client's sector in the For column. Another language only when the brief asks for that feel
-in its own words; then quote those words on the `Language:` line. The idea may pick another motif of the six.
-`preloader-gate` and `page-transition-gate` show a neutral hairline ring; the film leader (a dial counting 3, 2, 1)
-only for a film client, through `dial="leader"` and `marks`. The header is `header-bar:quiet` or `:settle`; sections
-say their ground with `data-bar-tone`. Each arc is loud only at the opening, the centerpiece and at most one gentle
-scene with a quiet scene on each side. The arcs below are the printed arcs in short; the first pick is the default.
-
-**Quiet scenes** are the kit's four, imported from `@/components/struq/kit/quiet` (props in each file's header):
-- `Statement`: the one sentence and the page's first type moment, with an `accent` word and a margin `label` or a
-  small `image`, so it is composed, never a lone line.
-- `PhotoText`: a photo and a short text side by side on the grid.
-- `Rows`: three to six hairline rows, a term and one sentence each, never numbered.
-- `Close`: the closing line and its one link, echoing the opening; `frame` when the motif is the frame.
-- An own scene only when none of the four fits: your type beside a photo with `SplitHeadline`, `MediaFrame` and
-  `Reveal`, entering once, its root marked `data-scene="<name>"` (the check warns `own-scene-unmarked` without it).
-
-**weight.** Paper throughout, ink at the centerpiece.
-1. Arrival (frame): `preloader-stack`; the print lands on the hero photo.
-2. Opening (loud, short hold): `hero-framed:wand`, `hero-framed:portret` or `hero-still:frame`; calmer, `hero-still:still` (quiet).
-3. Statement (quiet): `Statement`.
-4. About (loud, the gentle one): `about-studio:wandeling` or `about-studio:plaat` (a full-bleed reveal); quiet, `PhotoText`.
-5. Approach (quiet): `approach:schuif` or `Rows`.
-6. Centerpiece (loud, ink): `image-to-fullbleed`, `grid-assembly`, `zoom-through` or `project-stack` (real projects).
-7. Release (quiet): `PhotoText`.
-8. Close (quiet): `Close`, type only after a full-bleed centerpiece. Footer: `wordmark-finale`.
-
-**cut.** Paper and ink in hard alternation, never a fade.
-1. Arrival (frame): `preloader-slices`, its caption from the lexicon.
-2. Opening (loud): `hero-poster`; quiet, `hero-index:lijst`, `hero-index:venster`, `hero-split:naad` or `hero-split:liggend`.
-3. Work (quiet): `hover-list` or `image-trail`; after `hero-index`, already a list, `reveals:clip`.
-4. Statement (quiet): `Statement`.
-5. Centerpiece (loud, ink): `split-pair`, `panel-wipe`, `project-stack`, `fanned-cards` or `film-strip` (film clients).
-6. Release (quiet): `fill-rows` or `Rows`.
-7. Close (quiet): `Close`, type only, or `cta-closing:pointer`. Footer: `footer-contact`.
-
-**curtain.** Field or ink at the opening, paper between, ink at the centerpiece.
-1. Arrival (frame): `preloader-gate`, the ring fills and the gate parts; or `preloader-wordmark:split`.
-2. Opening (loud): `hero-opener`, `background-aurora`, `background-silk` or `background-facets`, the line at poster scale; calmer, `hero-still:horizon` (quiet).
-3. Statement (quiet): `Statement`.
-4. Details (loud, the gentle one): `sticky-chapters`, or quiet `panel-accordion`: the programme, places and dates given.
-5. Build (quiet): `PhotoText`, who makes it.
-6. Centerpiece (loud, ink): `scrub-connector`, `zoom-through`, `manifesto-scrub` or `panel-wipe`.
-7. Release (quiet): `PhotoText`.
-8. Close (quiet): `cta-closing:pointer`, the line returning. Footer: `footer-reveal`, the curtain closing.
-
-**Budgets.** Hard rules: a storyboard that breaks one is rewritten before the stop.
-- Exactly one centerpiece; nothing pins after it. The opening holds at most 1.5 screens, all pins together about 4.5.
-  Screens pinned: `hero-opener` 1, `hero-framed` and `hero-poster` 1.5, `manifesto-scrub` 2, `image-to-fullbleed`
-  2.2, `grid-assembly` 2.5, `panel-wipe` 1.7 (2.6 when it closes), `film-strip` up to 3, `fanned-cards`, `split-pair`,
-  `zoom-through` and `scrub-connector` 3, `project-stack` 1.1 per project after the first. Pinned in one variant, so
-  never quiet: `hero-still:frame`, `hero-split:opening`, `hero-index:doorlopen`, `about-studio:doorkijk`,
-  `approach:zin`, `manifesto:writes` and `:split`.
-- Never two loud scenes side by side. At least four in ten scenes are quiet.
-- Every frame from the site's language. A page transition only when the site has more than one route.
-- Install only what the storyboard names, plus the header and the language's menu.
-- One motif on the page. At most two full-bleed photo reveals, built the same way: `hero-framed:wand` and `:portret`,
-  `hero-poster`, `hero-still:frame`, `image-to-fullbleed`, `zoom-through`, `grid-assembly`, `about-studio:plaat` and
-  `cta-closing:photo` each count one.
-- At most one marquee (`cta-closing:marquee`, `velocity-type`) and one custom cursor. One accent word, set in the
-  accent face through the `accent` prop: in the opening's headline, in `Statement` and again in `Close`.
-- No clock unless the lexicon is about time; then one, turned on by its prop (`clock`, `timeZone` on `wordmark-finale`).
-- Two or three type moments at poster scale (12 to 20vw) on the page; everything else from the scale.
-- Labels: no eyebrows above headings, no mono, no uppercase labels, no numbered steps. A small sentence-case label in
-  the body face may sit beside a headline in the margin column or under a photo, in words from the lexicon.
+One film, not a showreel: one language, one motif (seen at the arrival, the opening, the centerpiece and the close),
+one centerpiece. A loud scene moves with the scroll; a quiet scene enters once and sits still.
+
+| Language | Feel | Temperament | Frames: preloader, page transition, menu |
+|---|---|---|---|
+| weight | slow and settled; a print grows into place; long holds | weighted | `preloader-stack`, `page-transition-stack`, `menu-curtain:stack` |
+| cut | sharp and decisive; hard cuts, short masks, no fades | crisp | `preloader-slices`, `page-transition-slices`, `menu-curtain:slices` |
+| curtain | held, then revealed; panels part after a long hold | slow | `preloader-gate` or `preloader-wordmark:split`, `page-transition-gate`, `menu-curtain:gate` |
+
+Set the temperament once, as `data-temperament` on `<body>` beside `data-blocks`: the language's default, or its
+neighbour (weighted beside crisp or slow) with the reason on the Language line. Every primitive and `feel()` read it.
+
+Pick by the tempo the idea needs, never by trade; calm and the held reveal are both reflexes. The Opening and the
+Centerpiece may come from anywhere in the catalogue: choose the pair that could only be this client's.
+
+Budgets the plan check enforces: exactly one centerpiece and nothing pinned after it; never two loud scenes side by
+side; at least four in ten scenes quiet; pins together about 4.5 screens; every frame from the language; at most two
+full-bleed photo reveals, one marquee, one custom cursor, one accent device (an italic word, a weight shift, a
+coloured word, a jump in scale, or none); two or three type moments at poster scale; no eyebrows, mono, uppercase
+labels or numbered steps.
 
 ## What makes it feel high end
 
 The blocks hold this already; your glue must too. Detail in [references/craft.md](references/craft.md).
 
-- Reveals clip from numbers, never scale a box; whole pixels; photos decoded before they show, cut or swap.
-- Scroll effects are scroll-tied and reverse when the visitor scrolls back; key frames hold.
-- The gate: `sq-js` on `<html>` before paint hides only what will animate, and shows it anyway after 3 s.
-- Type on a photo sits on the measured calm side over the lightest flat veil that reaches 3:1.
-- Display runs light (300, or the poster pairing's weight); fitted lines measured after `document.fonts.ready`.
-- Never clip a descender: the kit's masks already keep them; never `overflow-hidden` on a heading of your own, and
-  look at a line with a g and a j before calling type done.
-- Tokens only, mixes in oklab, a surface step and a hairline instead of a shadow, one accent.
-- Icons: Struq Icons (`@struq/icons`), functional only ([references/iconography.md](references/iconography.md)).
+- Reveals clip from numbers, never scale a box; whole pixels; photos decoded before they show.
+- Scroll effects are scroll-tied and reverse; key frames hold.
+- `sq-js` on `<html>` before paint hides only what will animate, and shows it anyway after 3 s.
+- Type on a photo sits on its calm side over the lightest veil that reaches 3:1.
+- Display runs light unless the pairing says otherwise; fitted lines measured after `document.fonts.ready`.
+- Never clip a descender; never `overflow-hidden` on a heading of your own.
+- Tokens only, a surface step and a hairline instead of a shadow, one accent colour.
+- Icons: `@struq/icons`, functional only ([references/iconography.md](references/iconography.md)).
 
 ## When something goes wrong
 
 - **Nothing scrolls:** an overlay called `getLenis()?.stop()` without `start()`, or `SmoothScroll` is not mounted.
 - **Content stays invisible for 3 s:** the block never set `data-ready`; usually it threw. Read the console.
 - **Wrong colours or faces:** `data-blocks` is missing on `<body>`, or STRUQ TOKENS sits before the kit import.
-- **A fitted line overflows or jumps:** the face did not load (check `app/fonts.ts` and the links in the layout).
+- **A fitted line overflows or jumps:** the face did not load (check `app/fonts.ts` and the layout links).
 - **Vite:** [references/stack-targets.md](references/stack-targets.md).