@nurix/etna 0.18.19 → 0.18.21

package/data/harnesses/code/skills/design/data/design-md/library/minimax.md

@@ -0,0 +1,139 @@
+---
+schema: design-md/v1
+product: MiniMax
+provenance: library
+sourced: 2026-07-04
+---
+
+# MiniMax — operator reading of the AI-infrastructure brand
+
+The design a project wears when it names or resembles MiniMax and the user confirms the match. A
+*deliberate* operator reading, not a marketing transcription: MiniMax's public surfaces are stark
+monochrome broken open by vibrant gradient product cards and an oversized 80px hero display. An
+operator surface keeps the monochrome bones, the near-black signature action, and the DM Sans voice
+— and leaves the gradients, the pill-everything CTA, and the hero-scale type behind.
+
+## 1 Visual Theme
+
+Light by default; dark is opt-in. Stark and flat: hierarchy comes from hairline `border`, type weight,
+and near-black ink on a white canvas — never heavy shadow. The single most important action wears the
+brand's signature near-black fill (`primary`, `#0a0a0a`) — the black pill is MiniMax's most recognizable
+element, though in operator work it takes the rectangular `radius`, not the marketing pill. One chromatic
+accent — a deep blue (`ring`, `#1d4ed8`) — is reserved for focus, links, and form activation; chrome
+otherwise stays monochrome. The vibrant product palette (coral, magenta, blue, purple, cyan) never
+touches chrome — it reappears only in charts. The anchor surface is a white content canvas beside a
+faintly tinted `sidebar`. Density is `standard`.
+
+## 2 Color Roles
+
+Light values first. One chromatic accent — deep blue carries interactivity, near-black `primary` carries
+the primary action, status hues speak only status, and the brand's saturated palette lives in `chart-*`
+and nowhere else in the chrome.
+
+| Role | Value | Allowed where |
+| --- | --- | --- |
+| `background` / `card` / `popover` | canvas white `#ffffff` | page, cards, overlays — the dominant surface |
+| `foreground` | near-black ink `#0a0a0a` | all primary ink, headlines, the primary CTA fill |
+| `muted` / `secondary` | surface `#f7f8fa` | subtle fills, secondary buttons, hover rows |
+| `muted-foreground` | steel `#5f5f5f` | labels, captions, table headers, inactive nav |
+| `border` / `input` | hairline `#e5e7eb` | every separator, grid line, and field edge |
+| `primary` / `primary-foreground` | near-black `#0a0a0a` on white `#ffffff` | the one primary action; active nav marker |
+| `accent` | surface-soft `#f2f3f5` | selected/active rows and nav — neutral, never chromatic |
+| `ring` | deep blue `#1d4ed8` | the focus outline; also links and form activation |
+| `destructive` | soft red `#d45656` | destructive actions and error state only |
+| `success` / `warning` | green `#1ba673` / amber `#d97706` | status signalling only, never chrome |
+
+The vibrant brand colors — coral `#ff5530`, magenta `#ea5ec1`, blue `#1456f0`, purple `#a855f7`, cyan
+`#3daeff` — are product-identity graces on marketing; here they seed only the `chart-*` ramp (§7).
+
+## 3 Typography
+
+One sans, one mono. `font-sans` is DM Sans — UI, body, and headings all ride it; the brand mixes no
+second sans, and emphasis comes from weight (400 / 500 / 600 / 700). `font-mono` is a system monospace
+for IDs, codes, timestamps, and log lines (the brand ships no dedicated mono). Numeric columns render
+`tabular-nums` so figures align down a column (floor P4).
+
+| Step | Role | Size · line | Weight · tracking |
+| --- | --- | --- | --- |
+| h1 | page title | 24px / 1.3 | `font-weight-strong` · `heading-tracking` |
+| h2 | section head | 20px / 1.4 | `font-weight-strong` · `heading-tracking` |
+| h3 | card / group head | 16px / 1.5 | `font-weight-strong` |
+| body | UI + prose | 14px / 1.5 | `font-weight-normal` |
+| small | labels, meta, dense | 13px / 1.5 | `font-weight-normal` |
+| caption | uppercase eyebrow | 12px / 1.5 | `font-weight-strong`, `+0.02em`, uppercase |
+
+The display voice is aggressive negative tracking (-2px at 80px); at operator heading sizes that becomes
+a mild `heading-tracking`. Bump weight one step for emphasis; never change size.
+
+## 4 Component Stylings
+
+Every recurring operator component composes from the primitives — no literal values.
+- **Button** — `primary`: filled near-black `primary` on `primary-foreground`, rectangular `radius`, no
+  pill. Secondary: transparent with a `foreground` `border`. Tertiary: `card` fill with hairline `border`.
+- **Input** — `background` fill, 1px `border`, `radius`; focus switches the edge to a 2px `ring` (deep
+  blue), no glow.
+- **Card** — `card` surface, 1px `border`, `radius`, shadow only when lifted; inset by `density-inset`.
+- **Table row** — height `table-row-height`; `border` grid lines; `muted` on hover; `tabular-nums` on
+  numeric columns; selection tints `accent` (neutral, not blue).
+- **Side panel** — detail and edit open in the side panel (`side-panel-width`, `side-panel-width-rich`),
+  beside the work, not over it (floor P3).
+- **Badge** — the one place the pill survives: `radius-scale` full (9999), `muted`/status fill, uppercase
+  caption. Status badges take `success` / `warning` / `destructive`, never `primary`.
+
+## 5 Layout
+
+Base spacing unit 4px; the on-scale ramp is `2 · 4 · 8 · 12 · 16 · 20 · 24 · 32 · 48 · 64` (MiniMax
+uniquely carries the 20 step). Shell dimensions map one-to-one to the layout primitives: sidebar
+`sidebar-width-expanded` / `sidebar-width-collapsed`, topbar `topbar-height`, side panel
+`side-panel-width` / `side-panel-width-rich`, modal `modal-width-max`, forms `form-max-width`, tables
+full-width. Density is governed globally by `density-tier`, stepped per archetype by the surface catalog.
+
+## 6 Depth
+
+Flat; hierarchy comes from the surface ladder and hairlines, not shadow:
+
+- **0 — canvas** `background`, no border.
+- **1 — panel / card** `card` on a 1px `border`; a whisper of `sm` shadow only when it must lift.
+- **2 — overlay** `popover` / side panel / modal — the one place `shadow-intensity` earns a soft `md`
+  shadow. Rank is border and position, never a heavier shadow.
+
+Focus is a 2px `ring` outline in deep blue (never a glow), on every interactive element (floor P6). Three
+z-levels: content, sticky chrome, overlay.
+
+## 7 Do's & Don'ts
+
+- **Do** reserve near-black `primary` for the single most important action; everything else is neutral
+  or status. Carry hierarchy with hairlines, weight, and whitespace — the brand is predominantly flat.
+- **Do** apply `tabular-nums` to every numeric column and `font-mono` to IDs, codes, and timestamps.
+- **Do** send the vibrant brand palette to charts — the one operator place it belongs.
+- **Don't** put a brand color on a button, badge, or large surface — off charts it breaks the monochrome discipline.
+- **Don't** pill the operator CTA — the pill is a marketing signature; operator buttons take the
+  rectangular `radius` (badges keep the pill). Don't introduce a second display typeface.
+- **Don't** tint selected rows or active nav with the accent blue — active states stay neutral `accent`;
+  blue is reserved for focus, links, and form activation. Don't signal elevation with heavy shadows.
+
+## 8 Responsive
+
+The operator sweep is 375 / 768 / 1024 / 1440.
+
+| Breakpoint | What changes |
+| --- | --- |
+| 375 | sidebar → off-canvas drawer; two-pane list+detail stacks; side panel → full sheet; density holds |
+| 768 | sidebar collapses to the icon rail (`sidebar-width-collapsed`); tables scroll their overflow |
+| 1024 | sidebar expands; two-pane queue+detail holds side by side |
+| 1440 | content caps at `form-max-width` for forms; tables and dashboards use the full width |
+
+## 9 Agent Prompt Guide
+
+Directives the emitting agent follows verbatim:
+
+- **Carries:** the monochrome bones (near-black ink on white canvas, hairline borders, flat), near-black
+  `primary` as the one signature action, the deep-blue accent for focus/links, DM Sans as the single
+  family, and the vibrant palette — but only as `chart-*`.
+- **Stays behind:** the gradient product cards, the pill-everything CTA, and the hero-scale 80px display
+  type with -2px tracking. None of it enters operator chrome.
+- Lead every list surface with its table; lead every entity with its primary read, not its chrome. Detail
+  and edit go in the side panel; a modal is a confirmation, not a workspace (P3).
+- Accent only the primary action; the one chromatic accent (blue) is for focus and links.
+- Every numeric column is `tabular-nums`; every ID / code / timestamp is `font-mono` (P4). Keyboard
+  completes every workflow; the `ring` focus outline is always visible (P6). Stay flat — hairline before shadow.

package/data/harnesses/code/skills/design/data/design-md/library/mintlify.md

@@ -0,0 +1,139 @@
+---
+schema: design-md/v1
+product: Mintlify
+provenance: library
+sourced: 2026-07-04
+---
+
+# Mintlify — the mint-accent documentation-platform operator design
+
+Mintlify's site is dual-mode: atmospheric sky-gradient marketing heroes float above dense,
+developer-grade documentation surfaces. This entry is the *operator* reading — an internal tool
+(docs-ops console, project queue, usage dashboard, log stream) in Mintlify's language — and it keeps
+the docs side. What carries: the white canvas with cool-gray neutrals and near-black ink, the single
+Mintlify mint accent held scarce, the dark charcoal code inlay, the Inter + Geist Mono pairing, flat
+hairline depth, and the 8px control radius. What stays behind: the sky-to-cream and teal-to-mint
+gradient hero bands, the 72px hero display, the full-pill buttons, the bright testimonial-orange card,
+and the 96/120px marketing section rhythm.
+
+**Light holds cleanly.** The white canvas (`#ffffff`) *is* the brand's documentation surface — no
+categorically-dark exception; the light-default floor stands as-is.
+
+## 1 Visual Theme
+
+Light by default; dark is opt-in. The UI floats on a white `background` (`#ffffff`); cards sit on the
+same white and read by their hairline `border`, not brightness. Emphatically flat: hierarchy is carried
+by the light-gray hairline (`#e5e5e5`), type weight, and cool-neutral surface tints — never a drop
+shadow. A single chromatic accent, Mintlify mint `primary` (`#00d4a4`), is held scarce: the one primary
+action (ink text on mint, exactly as the brand's green button renders), the focus `ring`, and the
+active-nav indicator. Ink is near-black `foreground` (`#0a0a0a`) — the color the marketing site spends
+on its black-pill button, spent here as text. Density is `standard` — layout-dense, readable prose.
+
+## 2 Color Roles
+
+Light values. One accent — mint `primary` is the only chromatic hue that carries UI meaning;
+tag-blue, warn-amber, and testimonial-orange are chart/status graces (see §7), status hues speak
+only status.
+
+| Role | Value | Allowed where |
+| --- | --- | --- |
+| `background` / `card` / `popover` | white `#ffffff` | page, cards, and overlays — the dominant surface, differentiated by hairline not brightness |
+| `foreground` | near-black ink `#0a0a0a` | headlines and all primary ink |
+| `muted` / `secondary` | cool surface `#f7f7f7` | hover rows, quiet band tints, secondary-button fill, inline-code wells |
+| `muted-foreground` | steel gray `#5a5a5c` | labels, captions, table headers, secondary text |
+| `border` / `input` | light hairline `#e5e5e5` | every separator, grid line, and field edge |
+| `primary` | Mintlify mint `#00d4a4` | the one primary action; the focus `ring`; the active-nav indicator |
+| `primary-foreground` | near-black ink `#0a0a0a` | text on the mint action — the brand's green-button pairing |
+| `accent` | neutral lift `#ededed` | selected / hovered rows and nav — a neutral step; mint stays the indicator, never the fill |
+| `ring` | `primary` mint | the focus outline — mint focuses inputs in the brand, unmistakable because keyboard-first |
+| `destructive` | brand error red `#d45656` | destructive actions and error state only |
+| `success` / `warning` | annotate green `#1ba673` / warn amber `#c37d0d` | status signalling only, never chrome |
+
+Mint's power is its scarcity at element scale; the corpus warns against mint on body text or large
+surfaces — it loses signal (see §7).
+
+## 3 Typography
+
+One sans, one mono — no third face. `font-sans` is Inter — body, UI, labels, and headings all ride
+it; weight (500/600) and color, never italics, carry emphasis. `font-mono` is Geist Mono for IDs,
+codes, timestamps, log lines, type signatures, and every code surface; numeric columns render
+`tabular-nums`. The Inter/Geist-Mono contrast is the brand's developer-respect signal. The marketing
+display scale (72/56/48px) stays behind — an operator surface tops out at a 24px page title, and
+long-form docs prose holds 16px/1.5 (the brand's "never compress reading copy" rule).
+
+| Step | Role | Size · line | Weight · tracking |
+| --- | --- | --- | --- |
+| h1 | page title | 24px / 1.3 | `font-weight-strong` (600) · `heading-tracking` |
+| h2 | section head | 18px / 1.35 | `font-weight-strong` (600) · `heading-tracking` |
+| h3 | card / group head | 15px / 1.4 | `font-weight-strong` (600) · 0 |
+| body | UI + prose | 14px / 1.5 | `font-weight-normal` (400) |
+| small | labels, meta, dense table | 13px / 1.4 | `font-weight-normal` (400) |
+| caption | uppercase eyebrow | 11px / 1.4 | `font-weight-strong`, `+0.05em`, uppercase |
+| code | IDs, logs, amounts | mono 13px / 1.5 | `font-weight-normal` (400) |
+
+Long-form docs prose holds 16px/1.5 — never denser; emphasise by weight or color, never italics (the brand ships none).
+
+## 4 Component Stylings
+
+Every recurring operator component composes from the primitives — no literal values.
+
+- **Button** — primary: filled mint `primary` on ink `primary-foreground`, `radius` (8px), never a pill (the marketing full-pill stays behind). Secondary: `secondary` gray fill, 1px `border`, `foreground`. Ghost: transparent, `accent` on hover.
+- **Input** — `background` fill, 1px `border` (`border-weight`), `radius`; focus draws the mint `ring` at full 2px, no glow — the brand focuses fields in mint.
+- **Card** — white `card` on a 1px `border`; panels read by their hairline, not brightness (nothing sits lighter than white); cards step to 12px `radius`; shadow only when a true overlay must lift; inset by `density-inset`.
+- **Table row** — height `table-row-height`; `border` grid lines; `muted` on hover; `tabular-nums` on numeric columns; row selection tints `accent` with a mint left-indicator.
+- **Side panel** — detail and edit open in the side panel (`side-panel-width`, `side-panel-width-rich` for content-heavy), beside the work, not over it.
+- **Badge** — pill radius (badges and pill-tabs only), `muted`/status fill, uppercase caption; status badges take `success` / `warning` / `destructive`, never `primary`.
+- **Code / log / terminal** — the dark charcoal inlay (`#1c1c1e`) with on-dark text and `font-mono`; the brand's own doc chrome, carried even in a light UI (see §6).
+
+## 5 Layout
+
+Base spacing unit 4px; the on-scale ramp is `2 · 4 · 8 · 12 · 16 · 24 · 32 · 48 · 64` — the marketing
+96/120px section rhythm stays behind. Shell dimensions map one-to-one to the layout primitives: sidebar
+`sidebar-width-expanded` (240px, the corpus docs sidebar) / `sidebar-width-collapsed` (56px), topbar
+`topbar-height` (56px, the docs top nav), side panel `side-panel-width` (420px) / `side-panel-width-rich`
+(640px), modal cap `modal-width-max`, forms `form-max-width`, tables full-width. Density is governed
+globally by `density-tier` and stepped per archetype by the surface catalog — never by absolute overrides.
+
+## 6 Depth
+
+Flat and hairline-first. Depth comes from the hairline and cool-neutral surface tints, not shadow:
+
+- **0 — canvas** `background` (`#ffffff`), no border.
+- **1 — panel / card** white `card` on a 1px `border`; the hairline carries the lift — panels read by their edge, not by a brighter fill. Selected / hover rows step to `accent` (`#ededed`).
+- **2 — overlay** `popover` / side panel / modal — the one place `shadow-intensity` earns a soft `md` shadow, enough to float an overlay above the canvas. Rank is border and position — never a heavier shadow.
+- **inlay — code / log / terminal** dark charcoal `#1c1c1e` with on-dark text and `font-mono` — Mintlify's product chrome, carried even in a light UI (the code-block wrapper).
+
+Focus is a 2px mint `ring` outline (never a glow), visible on every interactive element; three z-levels: content, sticky chrome, overlay.
+
+## 7 Do's & Don'ts
+
+- **Do** anchor every surface on the white canvas with cool-gray neutrals and near-black ink.
+- **Do** reserve mint `primary` for the single primary action, the focus `ring`, and the active-nav indicator — its scarcity at element scale is what reads as brand voltage.
+- **Do** pair Inter (UI and prose) with Geist Mono (code) — never introduce a third typeface; the assignment *is* the brand voice.
+- **Do** dress code, log, and terminal panels in the dark charcoal inlay (`#1c1c1e`, `font-mono`), and keep long-form docs prose at 16px/1.5.
+- **Don't** set mint on body text or large fills — it loses signal; keep it to the primary action, ring, and indicator.
+- **Don't** promote a second chromatic accent — tag-blue, warn-amber, error-red, and testimonial-orange are chart/status graces, not UI accents.
+- **Don't** pill the controls — buttons and inputs are 8px `radius`; the marketing full-pill is left behind, pill radius is badges and tabs only.
+- **Don't** signal elevation with heavy shadows, or reach for the atmospheric gradient heroes — hairlines and surface carry depth.
+
+## 8 Responsive
+
+The operator sweep is 375 / 768 / 1024 / 1440.
+
+| Breakpoint | What changes |
+| --- | --- |
+| 375 | sidebar → off-canvas drawer; two-pane list+detail stacks; side panel → full sheet; density holds |
+| 768 | sidebar collapses to the icon rail (`sidebar-width-collapsed`); tables scroll their overflow |
+| 1024 | sidebar expands; two-pane queue+detail holds side by side |
+| 1440 | forms cap at `form-max-width`; tables and dashboards use the full width |
+
+## 9 Agent Prompt Guide
+
+Directives the emitting agent follows verbatim:
+
+- Reach for the white canvas with cool-gray neutrals and near-black ink; the quiet palette is Mintlify's docs surface, not its marketing hero.
+- Spend mint once per surface: the primary action, the focus `ring`, the active-nav indicator. If two things want the mint, one of them is not primary. Color otherwise belongs to data and status — never mint on body text or a large fill.
+- Pair Inter (UI and prose) with Geist Mono (code) — never a third face. Render every code, log, and terminal panel in the dark charcoal inlay (`#1c1c1e`), real product chrome, not a light mockup of it.
+- Every numeric column is `tabular-nums`; every ID / code / timestamp / type-signature is `font-mono` (Geist Mono). Keep long-form docs prose at 16px/1.5; operator chrome at 14px.
+- Depth is hairlines and surface tints, never shadow; reach for the faint overlay lift only for a true modal or popover. Detail and edit go in the side panel beside the work; keyboard-first, the mint `ring` focus outline always visible.
+- Leave behind: the sky/teal gradient hero bands, the 72px hero display, the full-pill buttons, the testimonial-orange card, and the 96/120px section rhythm — marketing presentation, not operator chrome.

package/data/harnesses/code/skills/design/data/design-md/library/miro.md

@@ -0,0 +1,153 @@
+---
+schema: design-md/v1
+product: Miro
+provenance: library
+sourced: 2026-07-04
+---
+
+# Miro — the operator reading
+
+Miro's marketing canvas is a confident, playful frame: a canary-yellow wordmark on stark white,
+black-pill CTAs, and oversized pastel feature cards echoing the live whiteboard's sticky-note
+palette. The 80px Roobert display, the 120px hero rhythm, the real-board mockups, and the exuberant
+pastels stay on the marketing site. An operator surface inherits the *spine*: black ink on white,
+one chromatic accent (Miro brand blue), the friendly geometric Roobert type voice at its elegant
+medium weight, and a roomy rounded radius — a friendly tool made by people who like color, the joy
+demoted to chart encodings.
+
+## 1 Visual Theme
+
+Light by default; dark is not documented and stays opt-in. Flat: hierarchy is carried by hairline
+`border`, type weight, and the black/white contrast — never by heavy shadow, and where a true overlay
+lifts, the shadow is soft and **navy-tinted** (`rgba(5,0,56,…)`), never a hard black drop. The primary
+action fills black — Miro's own primary is the black pill, so `primary` is achromatic and the one
+chromatic accent, Miro brand blue, stays a scarce single-shot. Canary yellow is a brand grace for one
+moment (the wordmark lockup), no operator role. The anchor surface is a white content canvas beside a
+faintly cool `sidebar`. Density is `standard`, leaning roomy — the airy rhythm read into an operator
+tier, stepping denser per archetype.
+
+## 2 Color Roles
+
+Light values first. One chromatic accent — brand blue carries interactive meaning; the sticky-note
+pastels appear only as chart series; yellow is a grace.
+
+| Role | Value | Allowed where |
+| --- | --- | --- |
+| `background` / `card` / `popover` | white `#ffffff` | page, cards, and overlays — the dominant surface |
+| `foreground` | Miro ink `#1c1c1e` | all primary ink — headlines, body, labels |
+| `muted` / `secondary` | cool surface `#f7f8fa` | hover rows, tile fills, secondary buttons, the sidebar ground |
+| `muted-foreground` | slate `#555a6a` | labels, captions, table meta — the secondary ink role |
+| `border` | hairline `#e0e2e8` | every separator, grid line, and divider |
+| `input` | stronger hairline `#c7cad5` | field edges — Miro deliberately gives inputs a heavier edge than dividers |
+| `primary` | black `#1c1c1e` | the one primary action; active-nav fill; selected tab |
+| `accent` | pale lavender `#f5f3ff` | selected / hovered rows and nav — a tint, never a fill (Miro's featured-tier wash) |
+| `accent-foreground` / `ring` | brand blue `#4262ff` | inline links, the focus outline, active indicators — the single chromatic pop |
+| `destructive` | red `#e5484d` | destructive actions and error state only |
+| `success` / `warning` | green `#00b473` / amber `#fcb900` | status signalling only, never chrome |
+
+The pastels — coral `#ff9999`, teal `#0fbcb0`, rose, orange — are marketing surfaces with no operator
+role, reappearing only as `chart-*` encodings (§7). Canary yellow `#ffd02f` is the wordmark grace,
+never a CTA, status hue, or background fill.
+
+## 3 Typography
+
+One sans, one mono. `font-sans` is **Roobert PRO** — Miro's geometric, slightly-rounded custom face
+(fallbacks Noto Sans, -apple-system, BlinkMacSystemFont) — carrying UI, body, and headings by weight
+and size, never a second family. Its irreducible trait is the **elegant medium weight**: headings run
+500, not 700 — the brand has no 700 — so hierarchy comes from size and the geometric face, not
+heaviness. `font-mono` substitutes for the mono the corpus never ships, reserved for IDs, codes,
+timestamps, and log lines; numeric columns render `tabular-nums`.
+
+| Step | Role | Size · line | Weight · tracking |
+| --- | --- | --- | --- |
+| h1 | page title | 24px / 1.25 | `font-weight-strong` (500) · `heading-tracking` |
+| h2 | section head | 18px / 1.35 | `font-weight-strong` (500) · -0.01em |
+| h3 | card / group head | 16px / 1.45 | `font-weight-strong` (500) · 0 |
+| body | UI + prose | 14px / 1.5 | `font-weight-normal` (400) |
+| small | labels, meta, dense table | 13px / 1.4 | `font-weight-normal` (400) |
+| eyebrow / caption | uppercase table divider | 11px / 1.4 | 600, `+0.05em`, uppercase |
+
+Emphasis bumps weight one step (400 → 500); the 600 weight is reserved for uppercase eyebrows and badge
+chips. Never change size to emphasise. The 80px hero display, 64px stat-display, and the aggressive
+-2px display tracking stay on the marketing site.
+
+## 4 Component Stylings
+
+Every recurring operator component composes from the primitives — no literal values.
+
+- **Button** — `primary`: filled black `primary` on white `primary-foreground`, base `radius` (8px) —
+  the marketing full-pill relaxes to the functional radius in dense chrome; the pill (9999) stays on
+  icon-only buttons, filter chips, and badges. Secondary: `secondary` fill, 1px `border`, `foreground`.
+  Ghost: transparent, `accent` on hover.
+- **Input** — `background` fill, 1px `border` at the stronger `input` edge, `radius`; focus draws the
+  brand-blue `ring` at 2px, no fill change and no glow.
+- **Card** — `card` surface, 1px `border`, `radius`, inset by `density-inset`; shadow only when it must
+  lift (`shadow-intensity`); larger panels may take the 12px radius step.
+- **Table row** — height `table-row-height`; `border` grid lines; `muted` on hover; `tabular-nums` on
+  numeric columns; selection tints the pale-lavender `accent` with a brand-blue indicator.
+- **Side panel** — detail and edit open beside the work (`side-panel-width`, `side-panel-width-rich`
+  for content-heavy), not over it.
+- **Badge** — pill radius, `muted`/status fill, uppercase caption; status badges take `success` /
+  `warning` / `destructive`, never `primary` or brand blue.
+
+## 5 Layout
+
+Base spacing unit 4px (8px the primary increment); the on-scale ramp is `4 · 8 · 12 · 16 · 20 · 24 ·
+32 · 40 · 48 · 64` — Miro's distinctive 20px step is kept. Shell dimensions map one-to-one to the
+layout primitives: sidebar `sidebar-width-expanded` / `sidebar-width-collapsed`, topbar `topbar-height`
+(64px — Miro's own nav height), side panel `side-panel-width` / `side-panel-width-rich`, modal
+`modal-width-max`, forms `form-max-width`, tables full-width. Density is governed globally by
+`density-tier` and stepped per archetype by the surface catalog. The 96px and 120px marketing rhythms
+stay behind.
+
+## 6 Depth
+
+Flat, with strategic soft depth on true overlays only. Hierarchy is the surface ladder and hairlines,
+not shadow:
+
+- **0 — canvas** `background`, no border.
+- **1 — panel / card** `card` on a 1px `border`; shadow only when it must lift off the canvas.
+- **2 — overlay** `popover` / side panel / modal — the one place `shadow-intensity` earns a soft `md`
+  shadow, navy-tinted (`rgba(5,0,56,0.08)`), never a hard black drop. Rank is border and position.
+
+Focus is a 2px brand-blue `ring` outline (never a glow), visible on every interactive element. Three
+z-levels: content, chrome, overlay.
+
+## 7 Do's & Don'ts
+
+- **Do** fill black `primary` for the single most important action; everything else is neutral or status.
+- **Do** keep brand blue scarce — inline links, the focus `ring`, and active indicators only; it is a
+  single-shot accent, not a fill or a body-text color.
+- **Do** carry hierarchy with size, the geometric Roobert face, hairlines, and whitespace — never heavy
+  weight; there is no 700. Apply `tabular-nums` to numeric columns and `font-mono` to IDs and timestamps.
+- **Don't** reach for the sticky-note pastels as UI chrome; they are marketing surfaces and appear
+  operator-side only as `chart-*` series.
+- **Don't** spend canary yellow on a CTA, status hue, or background — it is the wordmark grace, nothing more.
+- **Don't** introduce a second chromatic accent, or signal elevation with heavy or hard-black shadows —
+  Miro's shadows are soft and navy-tinted.
+
+## 8 Responsive
+
+The operator sweep is 375 / 768 / 1024 / 1440.
+
+| Breakpoint | What changes |
+| --- | --- |
+| 375 | sidebar → off-canvas drawer; two-pane list+detail stacks; side panel → full sheet; density holds |
+| 768 | sidebar collapses to the icon rail (`sidebar-width-collapsed`); tables scroll their overflow |
+| 1024 | sidebar expands; two-pane list+detail holds side by side |
+| 1440 | content caps at `form-max-width` for forms; tables and dashboards use the full width |
+
+## 9 Agent Prompt Guide
+
+Directives the emitting agent follows verbatim:
+
+- Wear the spine, not the marketing: black ink on white, the friendly rounded radius, hairline depth.
+  The 80px hero display, the pastel feature cards, the real-board mockups, and the 120px rhythm stay behind.
+- Primary action fills black. If two things want the black fill, one of them is not primary. Brand blue
+  is single-shot — inline links, the focus `ring`, active indicators — never a fill or body text; canary
+  yellow is the wordmark grace, never a UI color.
+- Buttons sit at the base `radius`; the full pill (9999) is for icon-only buttons, filter chips, and
+  badges. Hierarchy is size and the geometric face, never heavy weight — there is no 700; emphasise 400 → 500.
+- Every numeric column is `tabular-nums`; every ID / code / timestamp is `font-mono`.
+- The sticky-note pastels live only in charts (`chart-1..5`); stay flat — hairline and weight before
+  shadow, and reach past a hairline only for a real, soft, navy-tinted overlay.

package/data/harnesses/code/skills/design/data/design-md/library/mistral-ai.md

@@ -0,0 +1,140 @@
+---
+schema: design-md/v1
+product: Mistral AI
+provenance: library
+sourced: 2026-07-04
+---
+
+# Mistral AI — the operator reading
+
+Mistral's public brand is cinematographic: sunset gradients over mountain photography, a
+red-to-cream "stripe" closing every page, hero-scale near-serif display type. This is the *operator*
+reading — the palette temperature, the single saturated-orange accent, the sober editorial geometry,
+and the type voice carry across; the gradients, photographic heroes, and hero-scale display face
+stay behind. An internal tool wearing Mistral is a warm, cream-panelled console with one orange
+action, not a landing page.
+
+## 1 Visual Theme
+
+Light by default; dark is opt-in. Flat — hierarchy rides hairline `border`, type weight, and the warm
+surface ladder, never heavy shadow. A single accent, Mistral Orange `primary` (`#fa520f`), for the one
+action that matters. The neutrals are true grays, but the *surfaces* run warm — a white canvas beside a
+cream-tinted `sidebar` with cream panels, the operator signature that carries Mistral's temperature
+without a gradient. Density is `standard`, leaning comfortable (44px rows), dense-capable.
+
+## 2 Color Roles
+
+Light values; hex is the brand's native format. One accent — `primary` orange is the only chromatic
+hue that carries meaning; status hues speak only status.
+
+| Role | Value | Allowed where |
+| --- | --- | --- |
+| `background` / `card` / `popover` | canvas white `#ffffff` | page, cards, and overlays — the dominant surface |
+| `foreground` | ink `#1f1f1f` | all primary ink |
+| `muted` | warm-white `#fffaeb` | hover rows, quiet fills, subtle sections |
+| `secondary` | cream `#fff8e0` | secondary buttons, grouped panels |
+| `muted-foreground` | steel `#6a6a6a` | labels, captions, secondary text |
+| `border` | hairline `#e5e5e5` | separators and grid lines on white |
+| `input` | hairline-strong `#c7c7c7` | field edges — a firmer edge than the grid, per brand |
+| `primary` | Mistral Orange `#fa520f` | the one primary action; active nav; key interactive detail |
+| `accent` | cream-deeper `#fff0c2` | selected/hovered rows and nav, on-accent surfaces only |
+| `ring` | `primary` `#fa520f` | the focus outline — unmistakable, keyboard-first |
+| `destructive` | red `#d92d20` | destructive actions and error state only |
+| `success` / `warning` | green `#16a34a` / amber `#d97706` | status signalling only, never chrome |
+
+The sunset yellows (`#ffd900`, the sunshine ramp) and gradient bands are brand graces, not operator
+tokens (see §7). The source palette ships no semantic red or green, so status red/green/amber are
+derived functional imports, kept muted.
+
+## 3 Typography
+
+One sans, one mono. `font-sans` is Inter — body, UI, and headings all ride it; heading weight and
+tracking, not a second family, carry the voice. `font-mono` is JetBrains Mono for IDs, codes,
+timestamps, and log lines. Numeric columns render `tabular-nums` so figures align down a column.
+
+| Step | Role | Size · line | Weight · tracking |
+| --- | --- | --- | --- |
+| h1 | page title | 24px / 1.25 | `font-weight-strong` · `heading-tracking` |
+| h2 | section head | 18px / 1.3 | `font-weight-strong` · `heading-tracking` |
+| h3 | card / group head | 15px / 1.35 | `font-weight-strong` |
+| body | UI + prose | 14px / 1.5 | `font-weight-normal` |
+| small | labels, meta, dense table | 13px / 1.4 | `font-weight-normal` |
+| caption | uppercase eyebrow | 11px / 1.4 | 600, `+0.09em`, uppercase |
+
+Heading emphasis is `font-weight-strong` = **500**, not 600 — a deliberately lighter, editorial emphasis
+is the brand's tell (the marketing heads run 500); 600 is reserved for the uppercase eyebrow. Emphasize
+by weight, never size. The near-serif PP Editorial Old is a hero-display grace and stays behind —
+operator surfaces have no hero, so Inter carries every head.
+
+## 4 Component Stylings
+
+Every recurring operator component composes from the primitives — no literal values.
+- **Button** — `primary`: filled orange on `primary-foreground`, `radius` (8px), no pill. Secondary:
+  `secondary` (cream) fill, `border`, `foreground`. Ghost: transparent, `accent` on hover.
+- **Input** — `background` fill, 1px `input` border (firmer than the grid), `radius`; focus draws the
+  `ring` at 2px, no glow; field height rides `table-row-height` (44px).
+- **Card** — `card` surface, 1px `border`, 12px corner (one step up from the 8px button), shadow only
+  when lifted; the cream variant uses `secondary` fill with a warm `sidebar-border` edge, not gray.
+- **Table row** — `table-row-height` (44px); `border` grid lines; `muted` on hover; `tabular-nums` on
+  numerics; selection tints `accent`.
+- **Side panel** — detail and edit open in the panel (`side-panel-width`/`-rich`), beside the work.
+- **Badge** — hairline `border`, `muted`/status fill, uppercase caption; pill radius (9999) is for
+  badges only. Status badges take `success` / `warning` / `destructive`, never `primary`.
+
+## 5 Layout
+
+Base spacing unit 4px; the on-scale ramp is the brand's own `4 · 8 · 12 · 16 · 20 · 24 · 32 · 40 · 48 ·
+64` (capped below the hero-scale 96/120 that stays behind). Shell dimensions map one-to-one to the
+layout primitives: sidebar `sidebar-width-expanded` / `sidebar-width-collapsed`, topbar `topbar-height`,
+side panel `side-panel-width` / `side-panel-width-rich`, modal `modal-width-max`, forms `form-max-width`,
+tables full-width. Density is governed globally by `density-tier`, stepped per archetype by the catalog.
+
+## 6 Depth
+
+Flat. Hierarchy comes from the warm surface ladder and hairlines, not shadow:
+
+- **0 — canvas** `background`, no border.
+- **1 — panel / card** `card` or cream `secondary` on a 1px border; `sm` shadow only to lift off canvas.
+- **2 — overlay** `popover` / side panel / modal — the one place `shadow-intensity` earns a soft `md`
+  shadow. Rank is border, surface, and position, never a heavier drop shadow.
+
+Focus is a 2px `ring` outline (never a glow), visible on every interactive element. Three z-levels:
+content, sticky chrome, overlay — the marketing photographic and gradient depth does not carry.
+
+## 7 Do's & Don'ts
+
+- **Do** reserve `primary` orange for the single most important action on a surface; everything else is
+  neutral or status.
+- **Do** carry warmth with cream surfaces — the `sidebar` and grouped panels — against a white canvas.
+- **Do** apply `tabular-nums` to every numeric column and `font-mono` to IDs, codes, and timestamps.
+- **Do** keep the sober editorial geometry — 8px buttons, 12px cards; emphasize heads with weight-500.
+- **Don't** pill the primary CTA — Mistral's button geometry is sober, not playful; 9999 is for badges.
+- **Don't** promote the sunset yellows, a gradient, or the near-serif display into chrome — the stripe
+  band, sunshine ramp, hero photography, and display face are marketing signatures that stay behind.
+- **Don't** open detail or edit in a modal when the side panel fits — modals are for confirmations.
+
+## 8 Responsive
+
+The operator sweep is 375 / 768 / 1024 / 1440.
+
+| Breakpoint | What changes |
+| --- | --- |
+| 375 | sidebar → off-canvas drawer; two-pane list+detail stacks; side panel → full sheet; density holds |
+| 768 | sidebar collapses to the icon rail (`sidebar-width-collapsed`); tables scroll their overflow |
+| 1024 | sidebar expands; two-pane queue+detail holds side by side |
+| 1440 | content caps at `form-max-width` for forms; tables and dashboards use the full width |
+
+## 9 Agent Prompt Guide
+
+This entry dresses an internal tool — CRM, queue, dashboard, console — in Mistral's design language.
+Carries: the warm temperature (white canvas + cream `sidebar` and panels), the single orange accent,
+the sober 8px/12px radius, the Inter voice with editorial weight-500 heads, JetBrains Mono. Stays
+behind: the sunset gradient bands, the hero-scale PP Editorial Old display face, the photographic heroes.
+
+- Lead every list surface with its table; lead every entity with its primary read, not its chrome.
+- Accent only the primary action with orange. If two things want the accent, one is not primary.
+- Anchor warmth in the surface ladder, not the ink — grays stay gray; cream carries the brand.
+- Detail and edit go in the side panel; a modal is a confirmation, not a workspace.
+- Every numeric column is `tabular-nums`; every ID / code / timestamp is `font-mono`.
+- Every workflow completes from the keyboard; the orange `ring` focus outline is always visible.
+- Stay flat and sober — hairline and weight before shadow, no pills, no gradient chrome.