@nurix/etna 0.19.42 → 0.19.43

package/data/harnesses/apollo/skills/design/design-md/variants/terse-dense-operator.md

@@ -0,0 +1,212 @@
+---
+schema: design-md/v2
+id: terse-dense-operator
+tier: variant
+segments: [ops, fintech, monitoring]
+keywords: [dense, terminal, mono, utilitarian, dark-first, cyan, cockpit]
+sourced: 2026-07-12
+sources: "authored for the v2 variant roster; JetBrains Mono specimen"
+license: open
+---
+
+# terse-dense-operator — an engine control room at 03:00
+
+## 1 Visual Theme
+A container ship's engine control room at 03:00: black consoles bolted in
+rows, cyan phosphor readouts, hairline-etched panel labels, not one surface
+that reflects. Dark is the primary mood and is authored first; light is the
+daylight bridge — the same instruments with the sun on. Maximum data per
+pixel: 0–2px radius, hairlines as the only ornament, mono-forward type, no
+shadows pretending to be depth. One cyan accent marks the live thing; all
+else is instrument gray-blue.
+
+## 2 Color Roles
+Pale instrument `foreground` on near-black `background` (dark-first). Cyan
+`primary` marks the one live element — primary action, active nav, the
+`ring` — and nothing else; `accent` is its dim panel-glow tint for the
+selected row. Status hues are signal lamps: `destructive` red, `success`
+green, `warning` amber — on chips, cell states, and thresholds only, and
+they outrank the cyan when lit. The `sidebar` drops a step darker than the
+canvas; every separator is the hairline `border`, never contrast blocks.
+
+## 3 Typography
+JetBrains Mono (display and data) / IBM Plex Sans (chrome). The cockpit
+speaks mono: page titles are JetBrains Mono 700 at 20px — a stencil on a
+panel, not a headline — and every figure, ID, timestamp, and log line is
+mono with `tabular-nums`. IBM Plex Sans carries controls, labels, and body
+where mono would tire the eye. The ramp is compressed (body 13px, data 12px);
+weight changes are the only emphasis. Nothing exceeds 20px anywhere.
+
+## 4 Component Stylings
+Buttons `radius-sm` (0px), `primary` fill only on the single commit action;
+everything else is hairline-outlined `secondary` or ghost. Inputs are flat
+`background` fill with hairline `border`, focus a 2px cyan `ring` — no glow,
+no lift. Cards are hairline-bounded regions of the panel, never shadowed.
+Table rows run at maximum density with `muted` hover, `accent` selection,
+and mono numerals; column dividers are hairlines. Detail opens in a narrow
+side panel; modals confirm destructive acts and do nothing else.
+
+## 5 Layout
+4px base, spent sparingly. Sidebar 224/48px; topbar 44px; side panel
+400/560px; content runs full-bleed to 1920px — a cockpit wastes no glass.
+Gutters stay at 8–12px; density is compressed by default and never relaxes
+below standard even on empty states. Forms are narrow, label-left, built for
+the tab key.
+
+## 6 Depth
+None faked. Light theme: hairlines only; the two declared shadows are
+1px-ring outlines (tinted, near-invisible) that keep overlays legible on
+white, not elevation. Dark theme: the surface ladder is the only depth —
+`background` 0.14 L, `surface-raised` +0.04, `surface-overlay` +0.09, hue
+held at 230. Focus is the 2px `ring`; z-levels: content, sticky chrome,
+overlay. Nothing floats, nothing glows.
+
+## 7 Motion
+Near zero. Named moments: `panel-snap` (side panel, 160ms, interruptible),
+`fade-arrive` (page content, 90ms), `press` (60ms). Row hover, selection,
+sort, and every keyboard-initiated action render instantly — 0ms, by policy.
+Physicality is granted to auth alone, as a single 160ms fade. If a motion is
+noticed twice in a shift, it is too long.
+
+## 8 Iconography & Charts
+Lucide, 1.5px stroke, on a compact 14/16px grid, `muted-foreground` default;
+icons label systems, never decorate. Charts are instruments: hairline axes,
+no gridline fills, no area washes, the cyan-led categorical ramp
+(`chart-1..5`), tooltips on `surface-overlay` with mono numerals, thresholds
+drawn as hairline rules in status hues.
+
+## 9 Voice
+Log-terse: imperative verbs, no pleasantries, values before prose.
+"Ack alert" · "Queue empty — 0 pending, last drain 03:12:47Z" · "Write
+failed: partition 7 read-only since 02:58; retry blocked."
+
+## 10 Do's & Don'ts
+Do put a figure where prose could go. Do keep every radius at 0–2px and
+every separator a hairline. Do let status lamps outrank the cyan when lit.
+Don't shadow anything; the ladder is the only depth. Don't animate hover,
+sort, selection, or anything keyboard-initiated. Don't let mono display type
+grow past 20px — a cockpit has no headlines. Don't relax density for
+aesthetics; whitespace here is unread telemetry.
+
+## 11 Responsive
+375: sidebar → off-canvas rail, side panel → full sheet, tables keep mono
+figures and horizontal scroll — never card-ify telemetry. 768: sidebar holds
+at the 48px icon rail. 1024: two-pane queue+detail holds. 1440–1920:
+columns multiply; the grid fills all available glass, no centering cap
+below 1920px.
+
+## 12 Agent Prompt Guide
+Author dark first; light is the daylight variant of the same panel, not a
+separate look. Every surface leads with its densest useful table. Cyan on
+exactly one live element; when a status lamp lights, cyan yields. No motion
+on anything an operator repeats; 0ms is the default answer. Read the ladder
+from the block — never derive dark, never add a shadow.
+
+```yaml design-values
+color:
+  light:
+    background: oklch(0.965 0.006 230)
+    foreground: oklch(0.2 0.02 235)
+    card: oklch(0.975 0.005 230)
+    card-foreground: oklch(0.2 0.02 235)
+    popover: oklch(0.98 0.005 230)
+    popover-foreground: oklch(0.2 0.02 235)
+    primary: oklch(0.42 0.09 210)
+    primary-foreground: oklch(0.97 0.006 220)
+    secondary: oklch(0.93 0.009 230)
+    secondary-foreground: oklch(0.24 0.02 233)
+    muted: oklch(0.935 0.008 230)
+    muted-foreground: oklch(0.44 0.02 233)
+    accent: oklch(0.9 0.03 210)
+    accent-foreground: oklch(0.33 0.06 215)
+    destructive: oklch(0.53 0.19 27)
+    destructive-foreground: oklch(0.97 0.006 27)
+    success: oklch(0.55 0.12 155)
+    warning: oklch(0.62 0.13 75)
+    border: oklch(0.885 0.01 230)
+    input: oklch(0.885 0.01 230)
+    ring: oklch(0.42 0.09 210)
+    surface-raised: oklch(0.975 0.005 230)
+    surface-overlay: oklch(0.98 0.005 230)
+    chart-1: oklch(0.48 0.1 210)
+    chart-2: oklch(0.55 0.12 150)
+    chart-3: oklch(0.62 0.13 75)
+    chart-4: oklch(0.52 0.12 300)
+    chart-5: oklch(0.5 0.08 255)
+    sidebar: oklch(0.945 0.007 230)
+    sidebar-foreground: oklch(0.2 0.02 235)
+    sidebar-primary: oklch(0.42 0.09 210)
+    sidebar-primary-foreground: oklch(0.97 0.006 220)
+    sidebar-accent: oklch(0.9 0.03 210)
+    sidebar-accent-foreground: oklch(0.33 0.06 215)
+    sidebar-border: oklch(0.885 0.01 230)
+    sidebar-ring: oklch(0.42 0.09 210)
+  dark:
+    background: oklch(0.14 0.01 230)
+    foreground: oklch(0.89 0.012 220)
+    card: oklch(0.17 0.011 230)
+    card-foreground: oklch(0.89 0.012 220)
+    popover: oklch(0.23 0.013 230)
+    popover-foreground: oklch(0.89 0.012 220)
+    primary: oklch(0.8 0.12 200)
+    primary-foreground: oklch(0.14 0.02 225)
+    secondary: oklch(0.22 0.012 230)
+    secondary-foreground: oklch(0.86 0.014 220)
+    muted: oklch(0.2 0.012 230)
+    muted-foreground: oklch(0.68 0.02 225)
+    accent: oklch(0.25 0.035 210)
+    accent-foreground: oklch(0.85 0.08 200)
+    destructive: oklch(0.64 0.2 25)
+    destructive-foreground: oklch(0.11 0.02 25)
+    success: oklch(0.74 0.15 155)
+    warning: oklch(0.78 0.14 75)
+    border: oklch(0.25 0.013 230)
+    input: oklch(0.25 0.013 230)
+    ring: oklch(0.8 0.12 200)
+    surface-raised: oklch(0.18 0.012 230)
+    surface-overlay: oklch(0.23 0.013 230)
+    chart-1: oklch(0.8 0.12 200)
+    chart-2: oklch(0.72 0.13 150)
+    chart-3: oklch(0.78 0.13 75)
+    chart-4: oklch(0.7 0.12 300)
+    chart-5: oklch(0.68 0.1 255)
+    sidebar: oklch(0.12 0.009 230)
+    sidebar-foreground: oklch(0.86 0.014 220)
+    sidebar-primary: oklch(0.8 0.12 200)
+    sidebar-primary-foreground: oklch(0.14 0.02 225)
+    sidebar-accent: oklch(0.19 0.015 230)
+    sidebar-accent-foreground: oklch(0.87 0.014 220)
+    sidebar-border: oklch(0.22 0.012 230)
+    sidebar-ring: oklch(0.8 0.12 200)
+typography:
+  display: { family: "JetBrains Mono Variable", fallback: "ui-monospace, monospace", weights: [700] }
+  sans: { family: "IBM Plex Sans", fallback: "system-ui, sans-serif", weights: [400, 600] }
+  mono: { family: "JetBrains Mono Variable", fallback: "ui-monospace, monospace", weights: [400, 700] }
+  ramp:
+    display: { size: 20px, line: 26px, weight: 700, family: display, tracking: 0em }
+    h1: { size: 18px, line: 24px, weight: 600, family: sans }
+    h2: { size: 15px, line: 20px, weight: 600, family: sans }
+    body: { size: 13px, line: 18px, weight: 400, family: sans }
+    small: { size: 12px, line: 16px, weight: 400, family: sans }
+    caption: { size: 11px, line: 14px, weight: 500, family: sans, tracking: 0.02em }
+    data: { size: 12px, line: 18px, weight: 400, family: mono, features: [tnum] }
+  register-scope: { display: [page-title], sans: [chrome, controls, body], mono: [data, ids, timestamps] }
+elevation:
+  radius: { sm: 0px, md: 2px, lg: 2px }
+  hairline: border
+  shadow:
+    overlay: "0 0 0 1px oklch(0.32 0.015 230 / 0.55)"
+    popover: "0 0 0 1px oklch(0.32 0.015 230 / 0.55)"
+  dark-ladder: { background: 0.14, raised: 0.18, overlay: 0.23, hue-held: 230 }
+motion:
+  duration: { press: 60ms, fade: 90ms, panel: 160ms }
+  easing: { standard: "cubic-bezier(0.2, 0, 0, 1)", exit: "cubic-bezier(0.4, 0, 1, 1)" }
+  entrance-never: ease-in
+  identity-moments: [auth]
+iconography: { set: lucide, stroke: 1.5px, grid: [14px, 16px] }
+charts:
+  categorical: [chart-1, chart-2, chart-3, chart-4, chart-5]
+  sequential: { from: background, to: chart-1 }
+  diverging: { negative: destructive, mid: muted, positive: success }
+layout: { base: 4px, sidebar: [224px, 48px], topbar: 44px, side-panel: [400px, 560px], content-max: 1920px }
+```

package/data/harnesses/apollo/skills/design/design-md/variants/warm-approachable.md

@@ -0,0 +1,216 @@
+---
+schema: design-md/v2
+id: warm-approachable
+tier: variant
+segments: [smb, hr, support]
+keywords: [warm, human, soft, rounded, terracotta, humanist, friendly]
+sourced: 2026-07-12
+sources: "authored for the v2 variant roster; Bricolage Grotesque and Nunito Sans specimens"
+license: open
+---
+
+# warm-approachable — a neighborhood credit union at opening
+
+## 1 Visual Theme
+A neighborhood credit union at opening time: terracotta tile, an oak counter
+worn smooth at the corner, a hand-lettered welcome card beside the bell,
+coffee already on. Handshake software — light default, neutrals tinted
+toward clay (warm, never cream), one terracotta accent that greets rather
+than commands, gentle radius on everything you touch. The counter is still a
+counter: tables, forms, and figures stay crisp, dense-capable, and honest.
+Dark is the branch after close, lamps amber — an authored ladder, never an
+inversion.
+
+## 2 Color Roles
+Warm graphite `foreground` on a clay-washed `background` — the wash sits at
+the warm-white edge, deliberately clear of the cream band. `primary` is the
+terracotta — primary actions, active nav, the `ring`; `accent` is its peach
+wash for selection and hover. Status hues are conventional but softened:
+`destructive` red for real danger only, `success` leaf green, `warning`
+honey amber — chips and validation, never chrome. The `sidebar` warms a
+half-step below the canvas; nothing on it competes with the counter.
+
+## 3 Typography
+Bricolage Grotesque (display) / Nunito Sans (text) / Red Hat Mono (data).
+Bricolage speaks in page titles, empty states, and auth — a warm,
+characterful voice that never touches cells, buttons, labels, or form
+chrome. Nunito Sans, a humanist sans, carries all chrome and body at a
+comfortable 15px with generous line-height. Red Hat Mono owns figures, IDs,
+and timestamps with `tabular-nums`. Emphasis bumps weight, never size.
+
+## 4 Component Stylings
+Buttons `radius-md`, `primary` fill, comfortable padding — soft-cornered,
+never pill. Inputs are `background` fill with hairline `border` and
+`radius-md`; focus draws the 2px terracotta `ring`, no glow. Cards sit on
+`card` behind a hairline with the faintest clay-tinted shadow. Table rows
+run standard height with `muted` hover and `accent` selection; numerals stay
+mono. Detail opens in the side panel with a warm rule at its head; modals
+confirm, they don't host work.
+
+## 5 Layout
+4px base. Sidebar 260/64px; topbar 56px; side panel 440/680px; content caps
+at 1360px. Comfortable gutters (16–24px); density is standard, stepping
+denser on queue and table archetypes without ever feeling like a terminal.
+Forms run single-column with roomy field spacing — a form here is a
+conversation, not an interrogation.
+
+## 6 Depth
+Soft but honest: hairlines structure everything; cards may carry one faint
+clay-tinted shadow; overlays carry a slightly deeper one. Never gray-black
+shadows, never stacked elevation. Focus is the 2px `ring`. Dark expresses
+depth as the surface ladder: `background` 0.16 L, `surface-raised` +0.05,
+`surface-overlay` +0.10, hue held at 35 — the lamps get warmer, not the
+shadows deeper.
+
+## 7 Motion
+Gentle and brief. Named moments: `panel-slide` (side panel, 260ms,
+interruptible), `fade-arrive` (page content, 180ms), `press` (130ms), and
+`welcome-fade` (first-run empty state, 260ms, the one indulgence). Easing is
+a soft ease-out; nothing springs or bounces. No animation on
+keyboard-initiated or high-frequency actions — friendliness is never
+latency.
+
+## 8 Iconography & Charts
+Lucide at 1.75px stroke — slightly rounded presence to match the humanist
+type — 16/20px grid, `muted-foreground` default; nav and empty states always
+carry icons. Charts: hairline axes, no gridline fills, a warm five-hue
+categorical ramp led by terracotta (`chart-1..5`), tooltips on
+`surface-overlay` with mono numerals.
+
+## 9 Voice
+Front-desk neighborly: plain words, first person welcome, no corporate
+distance, numbers stated honestly. "Add a member" · "No requests waiting —
+enjoy the quiet, or invite your team" · "We couldn't save that: the start
+date is after the end date."
+
+## 10 Do's & Don'ts
+Do keep the warmth in the neutrals and the type, not in extra color — one
+terracotta, spent once per surface. Do give forms room to breathe. Do keep
+figures mono and tables crisp — warm is not vague. Don't drift the
+background into cream; the wash stays at the clay edge, above the band.
+Don't pill buttons or inflate radius past the scale. Don't let Bricolage
+near a cell, button, or label. Don't soften error states into ambiguity —
+kindness is clarity.
+
+## 11 Responsive
+375: sidebar → sheet, side panel → full sheet, tables → stacked cards with
+mono figures; type holds at 15px — small screens get no less warmth. 768:
+sidebar collapses to the icon rail. 1024: two-pane queue+detail holds. 1440:
+content centers under the 1360px cap; empty states earn the full display
+treatment.
+
+## 12 Agent Prompt Guide
+Greet, then serve: every surface opens with its work object in Bricolage,
+then gets out of the way. Terracotta on exactly one action per surface. Keep
+the counter honest — dense tables, mono figures, clear errors — and the
+warmth in surfaces, corners, and copy. Dark is authored — consult the block,
+never derive.
+
+```yaml design-values
+color:
+  light:
+    background: oklch(0.977 0.008 30)
+    foreground: oklch(0.27 0.025 35)
+    card: oklch(0.984 0.006 30)
+    card-foreground: oklch(0.27 0.025 35)
+    popover: oklch(0.984 0.006 30)
+    popover-foreground: oklch(0.27 0.025 35)
+    primary: oklch(0.5 0.13 35)
+    primary-foreground: oklch(0.975 0.008 30)
+    secondary: oklch(0.94 0.012 30)
+    secondary-foreground: oklch(0.31 0.03 35)
+    muted: oklch(0.945 0.01 30)
+    muted-foreground: oklch(0.46 0.025 35)
+    accent: oklch(0.92 0.025 30)
+    accent-foreground: oklch(0.38 0.08 35)
+    destructive: oklch(0.53 0.19 27)
+    destructive-foreground: oklch(0.975 0.008 27)
+    success: oklch(0.57 0.12 150)
+    warning: oklch(0.65 0.13 70)
+    border: oklch(0.905 0.013 30)
+    input: oklch(0.905 0.013 30)
+    ring: oklch(0.55 0.13 35)
+    surface-raised: oklch(0.984 0.006 30)
+    surface-overlay: oklch(0.988 0.005 30)
+    chart-1: oklch(0.55 0.13 35)
+    chart-2: oklch(0.55 0.1 160)
+    chart-3: oklch(0.55 0.09 250)
+    chart-4: oklch(0.68 0.13 85)
+    chart-5: oklch(0.55 0.12 350)
+    sidebar: oklch(0.958 0.01 30)
+    sidebar-foreground: oklch(0.27 0.025 35)
+    sidebar-primary: oklch(0.5 0.13 35)
+    sidebar-primary-foreground: oklch(0.975 0.008 30)
+    sidebar-accent: oklch(0.92 0.025 30)
+    sidebar-accent-foreground: oklch(0.38 0.08 35)
+    sidebar-border: oklch(0.905 0.013 30)
+    sidebar-ring: oklch(0.55 0.13 35)
+  dark:
+    background: oklch(0.16 0.012 35)
+    foreground: oklch(0.91 0.012 35)
+    card: oklch(0.19 0.014 35)
+    card-foreground: oklch(0.91 0.012 35)
+    popover: oklch(0.26 0.016 35)
+    popover-foreground: oklch(0.91 0.012 35)
+    primary: oklch(0.72 0.13 40)
+    primary-foreground: oklch(0.15 0.02 35)
+    secondary: oklch(0.24 0.016 35)
+    secondary-foreground: oklch(0.88 0.014 35)
+    muted: oklch(0.23 0.015 35)
+    muted-foreground: oklch(0.7 0.02 38)
+    accent: oklch(0.29 0.035 35)
+    accent-foreground: oklch(0.86 0.05 40)
+    destructive: oklch(0.63 0.19 25)
+    destructive-foreground: oklch(0.12 0.02 25)
+    success: oklch(0.7 0.12 150)
+    warning: oklch(0.77 0.13 75)
+    border: oklch(0.28 0.016 35)
+    input: oklch(0.28 0.016 35)
+    ring: oklch(0.72 0.13 40)
+    surface-raised: oklch(0.21 0.015 35)
+    surface-overlay: oklch(0.26 0.016 35)
+    chart-1: oklch(0.72 0.13 40)
+    chart-2: oklch(0.7 0.1 160)
+    chart-3: oklch(0.68 0.09 250)
+    chart-4: oklch(0.8 0.12 85)
+    chart-5: oklch(0.7 0.11 350)
+    sidebar: oklch(0.14 0.011 35)
+    sidebar-foreground: oklch(0.89 0.013 35)
+    sidebar-primary: oklch(0.72 0.13 40)
+    sidebar-primary-foreground: oklch(0.15 0.02 35)
+    sidebar-accent: oklch(0.22 0.02 35)
+    sidebar-accent-foreground: oklch(0.89 0.013 35)
+    sidebar-border: oklch(0.26 0.015 35)
+    sidebar-ring: oklch(0.72 0.13 40)
+typography:
+  display: { family: "Bricolage Grotesque Variable", fallback: "system-ui, sans-serif", weights: [600] }
+  sans: { family: "Nunito Sans Variable", fallback: "system-ui, sans-serif", weights: [400, 700] }
+  mono: { family: "Red Hat Mono", fallback: "ui-monospace, monospace", weights: [400] }
+  ramp:
+    display: { size: 30px, line: 38px, weight: 600, family: display, tracking: -0.01em }
+    h1: { size: 24px, line: 32px, weight: 600, family: display }
+    h2: { size: 18px, line: 26px, weight: 700, family: sans }
+    body: { size: 15px, line: 24px, weight: 400, family: sans }
+    small: { size: 13px, line: 20px, weight: 400, family: sans }
+    caption: { size: 12px, line: 16px, weight: 700, family: sans }
+    data: { size: 14px, line: 21px, weight: 400, family: mono, features: [tnum] }
+  register-scope: { display: [page-title, empty-state, auth], sans: [chrome, controls, body], mono: [data, ids, timestamps] }
+elevation:
+  radius: { sm: 6px, md: 10px, lg: 16px }
+  hairline: border
+  shadow:
+    overlay: "0 10px 30px oklch(0.35 0.05 35 / 0.12)"
+    popover: "0 3px 12px oklch(0.35 0.05 35 / 0.09)"
+  dark-ladder: { background: 0.16, raised: 0.21, overlay: 0.26, hue-held: 35 }
+motion:
+  duration: { press: 130ms, fade: 180ms, panel: 260ms }
+  easing: { standard: "cubic-bezier(0.25, 0, 0, 1)", exit: "cubic-bezier(0.4, 0, 1, 1)" }
+  entrance-never: ease-in
+  identity-moments: [auth, first-run-empty]
+iconography: { set: lucide, stroke: 1.75px, grid: [16px, 20px] }
+charts:
+  categorical: [chart-1, chart-2, chart-3, chart-4, chart-5]
+  sequential: { from: background, to: chart-1 }
+  diverging: { negative: destructive, mid: muted, positive: success }
+layout: { base: 4px, sidebar: [260px, 64px], topbar: 56px, side-panel: [440px, 680px], content-max: 1360px }
+```

package/data/harnesses/apollo/skills/design/references/compose.md

@@ -0,0 +1,23 @@
+# Step 4 — Compose: one mind, whole canvas
+
+Build the app — all surfaces in one continuous context, the chosen package's design.md in view throughout. This step is never decomposed into per-surface handoffs with frozen intermediate artifacts; the composing mind holds the whole canvas.
+
+## Chrome
+
+Per the primitives switch recorded in the project's `design.md`:
+
+- **`nurix`** — compose chrome from `@nurix/components`. The chrome recipes (`data/chrome/`) carry composition, states, and when-to-use; the component reference folder (`components/`) carries props, imports, and usage — consult the index for what exists, and open the touched category's API reference on need.
+- **`native`** — the recipes are *specifications*: anatomy, the eight states, keyboard behavior, token reach — implement them with the incumbent stack's own components. The index's shadcn/fallback columns carry the composition; category API references never load.
+
+Recipes are starting points, not jails: restyle or extend them in place when the package demands it.
+
+## Composition rules
+
+- **Every surface starts from a chosen layout blueprint** (`data/blueprints/<archetype>.md`) — pick the shape reading the brief, record it in one line. Structural variety, not visual variety, is what reads as designed.
+- **Values come from the token artifact** — components consume the emitted custom properties and never invent raw values ([emission.md](emission.md) has the pipe rules). Switching packages must re-skin the whole app.
+- **Positive obligations apply** — load the surface's archetype checklist (`data/checklists/<archetype>.md`); the checklists are ceilings: a sidebar ships with brand block, icons, and user context; a dashboard tile ships with number + comparison + trend + state + door; every surface ships its state matrix.
+- **The register scope holds**: the display face never touches cells, buttons, labels, or form chrome; data numerals run the mono face with `tabular-nums`.
+- **Motion follows the package's §7** and the frequency law: actions performed 100+ times a day, and any keyboard-initiated action, get no animation, ever; panel/drawer motion is interruptible; entrances never `ease-in`.
+- **No ownership jails.** Any file may be edited at any time, including generated ones and library compositions.
+- **No paper-trail bureaucracy.** Decision-log lines only; attention goes to pixels.
+- **A finishing pass with authority over everything is part of this step** — walk the whole canvas once at the end: rhythm, alignment, density, identity-consistency across surfaces, the one-accent discipline.

package/data/harnesses/apollo/skills/design/references/content.md

@@ -0,0 +1,28 @@
+# Step 3 — Content: the believable book
+
+Author the demo data **before composing surfaces**. Data credibility is the single largest scoring dimension in blind judging; this step is where builds are won.
+
+## From the corpus
+
+Load the chosen domain's corpus (`data/corpora/<domain>/`): `corpus.md` (vocabulary, number-shape recipes, the invariants block) plus `people.csv` and `companies.csv`.
+
+- Names come from the corpus roster; emails derive from names; roles are domain-correct.
+- Activity strings use the corpus vocabulary — a CRM logs "Intro call with Elena — pricing discussion", never webhook noise.
+- Numbers follow the corpus's shape recipes (log-normal deal values, plausible deltas); dates vary around the corpus's **fixed reference instant**, never around "now".
+- **Acceptance is rendered plausibility against the declared invariants**: aggregates reconcile with their rows; legal ranges hold; forbidden repetition (same surname clusters, identical amounts) never shows. The ship gate checks these mechanically — author to them now.
+- **Edge-case rows (nulls, zeros, outliers) go only into dedicated state fixtures** (`empty*`, `degraded*`), never into the primary dataset.
+
+## Voice
+
+Load the package-bound voice pack (`data/voices/<id>.md` — the package's §9 names it). All authored strings — buttons, empty states, errors, tooltips, confirmations — speak in that voice, with tone varying by situation per the pack's tone map.
+
+## Chart choice
+
+Every data-bearing surface consults the chart-selection engine — **one graph question per consult**:
+
+1. Author the data signature (the judgment half): the question, measures, dimensions, semantic flags (temporal, parts-form-whole, target-exists, …), constraints. Decompose multi-question asks first.
+2. Run `node scripts/select-chart.mjs <signature.json>` and read the typed output: admissible set, eliminations with reason codes, ranking, recommendation, or a refusal code.
+3. **Honor refusals** — a refusal means the question isn't chartable as posed (often: it's a table). Never invent a measure to force a chart.
+4. Record the pick in one line in `decisions.md`. Taking a non-recommended admissible option needs a reason on that line; taking an eliminated option is out of contract.
+
+Chart *styling* is not this step's concern — the package's §8 and the chart-styling axis own it at composition.

package/data/harnesses/apollo/skills/design/references/emission.md

@@ -0,0 +1,21 @@
+# Package emission — design.md → token artifact
+
+One source, one derivation: the project's `design.md` is canonical; the token artifact is compiled from it and **never hand-edited**. Emit with `node scripts/validate-design-md.mjs <project design.md> --emit > design.tokens.css` (the artifact lives beside `design.md` at the repo base; the app's global stylesheet imports it). Re-emit on every design.md change; the ship gate's drift check byte-compares a fresh emission against the committed artifact.
+
+## Coverage
+
+The artifact is complete by construction — the validator fails the design.md before emission otherwise: every one of the 36 color roles in **both** themes, the full type ramp, the elevation system, the motion base, layout dimensions. Composition consumes tokens and never invents values; switching packages re-skins the whole app.
+
+## Emission constraints
+
+Each prevents a known silent-failure class:
+
+- **Specificity armor.** Theme blocks are `:root, :root[data-theme="light"]` and `:root[data-theme="dark"]` — both specificity (0,2,0) — so a component library's later bare `:root` block cannot silently defeat a theme.
+- **Font binding by derivation.** Font stacks bind to installed packages under **registered family names** (`"Inter Variable"`, not `"Inter"`), each with its declared fallback stack — otherwise the flagship font silently never renders. Install the font packages the design.md declares (e.g. Fontsource) and verify the name matches what the package registers.
+- **Every authored token group reaches a named consumer.** An authored ramp with no emitter vanishes without a trace — wire each group (colors → theme classes/utilities, ramp → text styles, elevation → radius/shadow utilities, motion → duration/easing vars) and let the ship gate's reach check prove it.
+- **Compile the emitted CSS once per change** — a stray utility string inside a CSS comment can defeat a fully green byte-level check.
+- **One linear precedence, later wins:** package defaults → brief bindings → recorded deviations. Values resolve at emission; the runtime cascade carries only contexts (theme, density).
+
+## Stack neutrality
+
+The artifact is plain CSS custom properties — every stack consumes it. Under `primitives: nurix`, Tailwind maps the properties through the theme config; under `native`, the incumbent styling layer reads the same variables. No emission step is React-specific.

package/data/harnesses/apollo/skills/design/references/existing-apps.md

@@ -0,0 +1,27 @@
+# Improve, judge, and extract on existing apps
+
+The same machinery runs on existing UIs, under a preservation contract.
+
+## Judge — a user-invoked service
+
+A critique of an existing UI against the brief, the project's `design.md`, the archetype checklists, and `taste.md`, producing a **severity-ranked (never scored) report**. Judge is a service the user asks for — never a self-check the skill runs on its own output. Read the actual rendered state (screenshots the user provides, or captures the user asks for); refuse to critique from source alone when the ask is "does it look right", and never imagine what unrendered code looks like. Each finding: severity, the on-screen element, what's wrong, the exact fix.
+
+## Improve — judge + the fix pass
+
+Whole-canvas authority holds, under the **preservation contract**:
+
+1. **Pre-flight findings block** — record the incumbent system with file citations: tokens, fonts, framework, component conventions. When the product already lives on an official design system, that system is respected, never replaced. The primitives switch reads `native` on these runs unless the incumbent already uses `@nurix/components`.
+2. **Preserve/introduce declaration** precedes any change: what stays, what enters, in one block.
+3. **The never-silently-change list** holds regardless of authority: routes and slugs, nav labels, form field names and IDs, brand marks, legal copy. The no-jails law is about *our* generated files; a user's existing brand and IA are theirs. Changing anything on this list requires the user's explicit ask.
+
+Improve runs then proceed through the standard steps as scoped: intake (against the incumbent — the package choice may be "extract", below), structure only where surfaces change, content only where data is fake, compose with the finishing pass, and the ship gate on what was touched.
+
+## Extract — reading an identity package out of a foreign UI
+
+A supported entry path, under **attestation and provenance**:
+
+- Record what the source is and whose it is: own product / public reference / third party.
+- Extract **structure and system, never pixels or assets**: roles, ramps, spacing, elevation, motion posture — into a `tier: project` design.md in the package schema, validator-checked.
+- Write a provenance block into the extracted file (`source-package: extracted@<date>` plus the attestation lines).
+- Record what **is**, never what should be — extraction is documentation, not improvement; the improve pass comes after, separately, if asked.
+- Admission of an extracted package into the shared roster later requires the provenance check to pass; third-party extractions stay project-local.

package/data/harnesses/apollo/skills/design/references/intake.md

@@ -0,0 +1,36 @@
+# Step 1 — Intake: brief → recorded choices
+
+Read the brief and choose from the menus: one identity package (the design.md system), any axis overrides the brief demands, layout blueprints per surface, and the product domain for content. Every choice is one recorded line.
+
+## Rules
+
+- **The brief's own words outrank any database default.** "Beautiful" means the ceiling, not the safe row.
+- **Adjectives become referents.** When the brief speaks in adjectives ("premium", "editorial"), name the 2–3 real products the brief is pointing at and pick the package whose recorded identity sits in that class — unnamed ambition becomes beige.
+- **The index is a retrieval aid, never a router.** Load `design-md/index.csv` whole (it is small), shortlist 2–3 rows by segment/keyword resemblance, read only the shortlisted files' §1 Visual Theme, then choose reading the brief. After the choice, the chosen package's **full design.md enters context and stays in view through step 4**; unchosen candidates are dropped.
+- **The escape hatch fires mechanically.** No index hit, plus a recorded one-line reason why the closest package fails → author a one-off project design.md in the package schema (`design-md/SCHEMA.md`), `tier: project`, validator-checked like any library entry. This path is expected to be common; flag the file as a curation candidate for the roster.
+- **Set the primitives switch** — write one `primitives: nurix | native` line into the project's `design.md`. Default by the probe: the project resolves `@nurix/components` (check package.json / lockfile / node_modules) → `nurix`; otherwise — existing apps, foreign stacks, no library access — → `native`. Set once here; nothing downstream re-asks. Also write `source-package: <id>@<date>` (or `authored` for escape-hatch one-offs).
+- **Write or update `product.md`**: users and their jobs, roles/permissions, action frequency, risk level, accessibility commitments, brand anti-references. Package choice, UX decisions, motion intensity, and demo data all cite it.
+- **Consult `taste.md`** — its feel/avoid lines bias every choice; user reactions to shipped output update it in place. Missing file = no bias, never a block.
+- **Stated-choice awareness:** if prior package picks are visible in the workspace, name them and say in one line why this pick repeats or differs — awareness, never forced rotation.
+- **Questions go to the user only when the answer changes the design** (theme, audience, density); everything else is inferred and marked inferred.
+
+## The preview block
+
+Step 1 ends with a preview block:
+
+- chosen package + one-line reason
+- the primitives switch position
+- axis overrides (each: axis → entry id → one-line reason)
+- blueprints per surface
+- domain corpus
+- surface map with archetypes
+- planned deviations
+
+When a user is present, pause here **once** for confirm-or-redirect — a wrong pick costs one message now instead of a full build. Autonomous runs proceed. Either way the block becomes the durable header of this run's dated section in `decisions.md`.
+
+## Outputs
+
+- `design.md` (project fork: chosen package + switch line + provenance + brief bindings; deviations accrue as they are recorded)
+- `product.md` written/updated; `taste.md` consulted
+- the preview block, appended to `decisions.md`
+- the chosen package's full design.md held in context

package/data/harnesses/apollo/skills/design/references/object-pass.md

@@ -0,0 +1,24 @@
+# Step 2 — Structure: the object pass
+
+Derive the object model and surface map using the UX-pattern decision layer (`references/ux-patterns/`). Load **one pass file at a time**, in this order, consulting only the passes the brief makes material:
+
+1. `object-model` — the domain objects and their relationships
+2. `attributes-lifecycle` — attributes, lifecycle states, history requirements
+3. `verbs` — actions per object × state × role
+4. `viewer-context` — how rendering changes by viewer
+5. `modes` — modal contexts the product runs in
+6. `promotion-demotion` — surface prominence by frequency × criticality
+7. `page-archetype` — each surface's archetype from the pinned roster: **browse, queue, grid, record-detail, dashboard, creation-flow, settings**. View-types (table, board, cards, calendar) are projections of an archetype, never archetypes.
+8. `container-choice` — container by workflow (duration, interruption, comparison need), never by size
+9. `creation-paths` — form, import, conversion, clone, recurrence
+10. `table-mechanics` — where tables project a surface
+11. `state-matrix` — loading, the three empties (first-use, no-results, cleared), degraded, stale — per surface
+12. `standard-pages` / `ai-layer` / `dashboards` / `settings` — when the brief has them
+
+Each pass file carries its rule as prose plus a machine-readable decision table; **follow the table's answer**. Disagreement is legitimate craft only when recorded — one line in `decisions.md` naming the pass, the table's answer, yours, and why. An unrecorded divergence is the violation.
+
+When a pass fires a clarification code (an input the table needs that the brief doesn't give), resolve it: infer-and-mark when the answer doesn't change the design, ask when it does.
+
+## Output: the structure document
+
+A single document — entities, surfaces, archetype per surface, projections, container choices, creation paths, and the state matrix per surface. It is an **input** to composition, never a jail: no file it implies is ever marked do-not-edit, and step 4 may revise it with a one-line record.

package/data/harnesses/apollo/skills/design/references/ship-gate.md

@@ -0,0 +1,29 @@
+# Step 5 — The ship gate
+
+The project ships with its four project-local artifacts — `design.md` (the resolved fork, with provenance line, brief bindings, recorded deviations), `product.md`, `taste.md`, and `decisions.md`. The gate has two tiers, both objective: this is the only runtime check the skill performs, permitted precisely because it is automated and needs no judgment. Nothing here grades taste — anything that needs grading was the build-time harness's burden, not the run's.
+
+## Tier 1 — fails closed
+
+Every check a binary predicate. Run the validator (`node scripts/validate-design-md.mjs <project design.md> --mode ship`) plus the build itself; all of these must hold:
+
+- **No placeholder text or scaffold stubs** anywhere (lorem, TODO, "Coming soon", empty `href="#"` walls).
+- **Data plausibility** against the corpus's declared invariants: aggregates reconcile with their visible rows; legal ranges hold; no degenerate repetition in visible rows (surname clusters, identical amounts).
+- **Accessibility floor, mechanical**: contrast computed on the emitted token pairs in *both* themes; focus visible on every interactive element; `prefers-reduced-motion` respected.
+- **Every declared surface reachable** — each surface in the structure doc has a live route/nav path.
+- **`design.md` present at the repo base** and the token artifact recompiles from it to a byte-match (the validator's drift check).
+- **The pipe checks**:
+  - the token artifact carries 100% coverage and components consume tokens — no raw color/size literals in component code;
+  - fonts bound to installed packages under registered family names (a family that never resolves is a fail);
+  - every authored token group reaches a named consumer — an emitted ramp nobody consumes is a fail;
+  - the emitted CSS actually compiles;
+  - charts and status surfaces consume the package's tokens (a dark dashboard with hardcoded light charts fails here).
+
+A Tier-1 failure blocks the ship; fix and re-run. Binary phrasing is the contract — anything that would need "use sparingly" grading does not belong in this tier.
+
+## Tier 2 — flags, never gates
+
+Sweep `data/tells.csv` (the operator tell list) plus the motion tells (`transition: all`; `ease-in` on an entrance; animation attached to a keyboard-triggered action). Flags cannot fail the build and trigger no in-run judging: each is **fixed or dismissed with one recorded line** in `decisions.md`, and every flag appears in the ship report for the human's eyes — numbers point eyes; they do not replace them. The validator may run this sweep warn-only after compose-step edits; nothing new ever fails the build mid-composition.
+
+## The ship report
+
+Close the run with a compact report: surfaces shipped, the recorded choices (from the run's `decisions.md` section), Tier-1 results, every Tier-2 flag with its disposition, and the validator's warn list. No scores, no self-grades.