@nurix/etna 0.19.42 → 0.19.44

package/data/harnesses/apollo/skills/design/data/motion/stagger-arrive.md

@@ -0,0 +1,18 @@
+---
+id: stagger-arrive
+class: a6
+sourced: 2026-07-12
+source: "emilkowalski.skills/skills/review-animations/STANDARDS.md (stagger — 30-80ms, decorative, never blocks interaction)"
+license: open
+feel: "a ~50ms cascade with a small upward drift reads considered; everything landing at once reads dumped, and gaps above 80ms read slow"
+aliases: { dumped: "no stagger at all on a multi-item entrance", draggy: "per-item stagger delay above the 80ms budget" }
+---
+List and grid entrances for freshly-loaded content within a task (search results, new rows) — never on initial page load or route arrival (no orchestrated load sequences). Purely decorative — must never delay the list becoming interactive; keep the per-item delay inside 30-80ms so a ten-row list finishes well under half a second.
+
+```yaml values
+duration: 300ms
+easing: cubic-bezier(0.23, 1, 0.32, 1)
+element-class: list-item
+interruptible: n/a
+budget: { list-item: 250-350ms }
+```

package/data/harnesses/apollo/skills/design/data/motion/toast-enter-stack.md

@@ -0,0 +1,18 @@
+---
+id: toast-enter-stack
+class: a6
+sourced: 2026-07-12
+source: "emilkowalski.skills/skills/review-animations/STANDARDS.md (interruptibility — toast transition example; cohesion — the Sonner register)"
+license: open
+feel: "a 400ms transition-based stack reads calm even when toasts pile up fast; a keyframe stack reads jumpy every time a new one lands"
+aliases: { jumpy: "@keyframes restarting already-stacked toasts instead of one continuous transition retargeting them", jarring: "no @starting-style/mount fallback, so the first toast snaps in with no entrance" }
+---
+Toast/notification stacks. A new arrival must not restart the position transition of toasts already stacked — everything reflows on one continuous transition, never per-toast keyframes.
+
+```yaml values
+duration: 400ms
+easing: ease
+element-class: overlay
+interruptible: required
+budget: { overlay: 300-450ms }
+```

package/data/harnesses/apollo/skills/design/data/motion/tooltip-chain-instant.md

@@ -0,0 +1,18 @@
+---
+id: tooltip-chain-instant
+class: a6
+sourced: 2026-07-12
+source: "emilkowalski.skills/skills/emil-design-eng/SKILL.md (tooltip-chaining example) + review-animations/STANDARDS.md (duration table, tooltip row; perceived performance)"
+license: open
+feel: "the first tooltip's 125ms fade-and-lift reads considered; every later tooltip in the same toolbar should read instant, with zero animation"
+aliases: { "laggy-toolbar": "every tooltip in a group replaying the full delay+animation instead of chaining to instant after the first", floaty: "duration above the small-popover budget" }
+---
+Tooltips, especially adjacent ones in a toolbar. First open: full delay + animation. While the pointer stays within the tooltip group, later tooltips switch to 0ms — this is the frequency law being satisfied, not an exception to it.
+
+```yaml values
+duration: 125ms
+easing: cubic-bezier(0.23, 1, 0.32, 1)
+element-class: control
+interruptible: n/a
+budget: { control: 0-200ms }
+```

package/data/harnesses/apollo/skills/design/data/motion/trigger-anchored-reveal.md

@@ -0,0 +1,18 @@
+---
+id: trigger-anchored-reveal
+class: a6
+sourced: 2026-07-12
+source: "emilkowalski.skills/skills/review-animations/STANDARDS.md (physicality — origin-aware popovers; duration table, dropdown row) + improve-animations/AUDIT.md §3"
+license: open
+feel: "growing out of the trigger at ~200ms reads anchored and native; center-scale or scale(0) reads like a random popup"
+aliases: { disconnected: "transform-origin left at center instead of the trigger element", glitchy: "scale(0) start instead of scale(0.9-0.97) + opacity" }
+---
+Popovers, dropdowns, select menus, tooltips. `transform-origin` follows the trigger (Radix/Base UI expose it as a CSS var); never centers. Rapid open/close/open must retarget, not restart.
+
+```yaml values
+duration: 200ms
+easing: cubic-bezier(0.23, 1, 0.32, 1)
+element-class: overlay
+interruptible: required
+budget: { overlay: 150-250ms }
+```

package/data/harnesses/apollo/skills/design/data/tells.csv

@@ -0,0 +1,34 @@
+id,tell,category,provenance,sourced,status
+tell-001,"every shadow set to zero and every border the same 1px gray — structure without a single elevation decision",wireframe-smell,"design-skill 01 §E5; impeccable detector registry",2026-07-12,active
+tell-002,"rounded-square icon tile stacked above the heading on every card — the universal generated feature-card template",template,"impeccable detector registry (icon-tile-stack)",2026-07-12,active
+tell-003,"cards nested inside cards — double borders and stacked radii standing in for hierarchy",card-abuse,"impeccable detector registry (nested-cards); design-skill 01 §E5",2026-07-12,active
+tell-004,"thick colored stripe down one edge of a card as the accent device",accent-abuse,"impeccable detector registry (side-tab); design-skill 01 §E5",2026-07-12,active
+tell-005,"accent border wrapped around a rounded card — the stripe fighting the corner radius",accent-abuse,"impeccable detector registry (border-accent-on-rounded)",2026-07-12,active
+tell-006,"hero-metric template — a row of identical stat tiles each icon + label + big number, with no comparison, trend, state, or door",template,"design-skill 01 §E5; b2b-ux-patterns dashboards chapter",2026-07-12,active
+tell-007,"cream or warm-beige page surface reached by reflex as the tasteful default",palette,"impeccable detector registry (cream-palette); taste-skill §9.A; design-skill 01 §A2 anti-cream guardband",2026-07-12,active
+tell-008,"ghost cards — bordered or shadowed containers wrapping a single short text run or nothing at all",card-abuse,"design-skill 01 §E5",2026-07-12,active
+tell-009,"purple-violet gradients and cyan-on-dark as the default accent scheme",palette,"impeccable detector registry (ai-color-palette)",2026-07-12,active
+tell-010,"dark theme expressed as colored box-shadow glows instead of a surface-lightness ladder",palette,"impeccable detector registry (dark-glow); design-skill 01 §A3 dark ladder",2026-07-12,active
+tell-011,"gradient fills on heading or metric text",typography,"impeccable detector registry (gradient-text)",2026-07-12,active
+tell-012,"flat type ramp — adjacent sizes too close together to carry hierarchy anywhere on the surface",typography,"impeccable detector registry (flat-type-hierarchy)",2026-07-12,active
+tell-013,"one spacing value everywhere — no tight grouping of related controls, no generous seams between sections",layout,"impeccable detector registry (monotonous-spacing)",2026-07-12,active
+tell-014,"hairline border and a wide diffuse shadow on the same container — two elevation systems at once",elevation,"impeccable detector registry (generated-UI signature set)",2026-07-12,active
+tell-015,"decorative two-axis hairline grid background behind a surface that is not a canvas, map, or measurement view",template,"impeccable detector registry (generated-UI signature set)",2026-07-12,active
+tell-016,"numbered section markers (01 / 02 / 03) as structural scaffolding",template,"impeccable detector registry (numbered-section-markers); taste-skill §9.F",2026-07-12,active
+tell-017,"tiny uppercase letter-spaced kicker label repeated above every section heading",template,"impeccable detector registry (repeated-section-kickers)",2026-07-12,active
+tell-018,"colored status dots decorating every nav item, row, or badge with no real state behind them",chrome,"taste-skill §9.F production-observed tells",2026-07-12,active
+tell-019,"middle-dot chains as the default separator for every metadata strip",chrome,"taste-skill §9.F production-observed tells",2026-07-12,active
+tell-020,"top and bottom hairline borders on every row of a long table or spec list",wireframe-smell,"taste-skill §9.F production-observed tells",2026-07-12,active
+tell-021,"fake build or version strings as decoration where no real build data exists",demo-content,"taste-skill §9.F production-observed tells",2026-07-12,active
+tell-022,"placeholder-generic person names in demo data (the John Doe class)",demo-content,"taste-skill §9.D (Jane Doe effect); design-skill 01 §E5",2026-07-12,active
+tell-023,"the same gray egg or user-icon avatar on every person row",demo-content,"taste-skill §9.D production-observed tells",2026-07-12,active
+tell-024,"fake-perfect numbers — round percentages, sequential IDs, totals that reconcile too neatly",demo-content,"taste-skill §9.D; design-skill 01 §E5",2026-07-12,active
+tell-025,"startup-slop company names in demo data (the Acme / Nexus / Cloudly class)",demo-content,"taste-skill §9.D production-observed tells",2026-07-12,active
+tell-026,"marketing buzzwords in interface copy (streamline, empower, supercharge, enterprise-grade)",copy,"impeccable detector registry (marketing-buzzword); taste-skill §9.D",2026-07-12,active
+tell-027,"em-dash-heavy microcopy — the character recurring across labels, empty states, and tooltips",copy,"taste-skill §9.G; impeccable detector registry (em-dash-overuse)",2026-07-12,active
+tell-028,"transition: all on interactive elements",motion,"design-skill 02 ship-gate Tier-2 motion tells",2026-07-12,active
+tell-029,"ease-in easing on an entrance",motion,"design-skill 02 ship-gate Tier-2 motion tells; emilkowalski motion canon",2026-07-12,active
+tell-030,"animation attached to a keyboard-triggered action",motion,"design-skill 02 ship-gate Tier-2 motion tells; emilkowalski frequency law",2026-07-12,active
+tell-031,"bounce or elastic easing on product chrome",motion,"impeccable detector registry (bounce-easing)",2026-07-12,active
+tell-032,"width, height, padding, or margin animated instead of transform and opacity",motion,"impeccable detector registry (layout-transition)",2026-07-12,active
+tell-033,"orchestrated staggered entrance choreography on a work surface — a product loads into a task",motion,"design-skill 01 §A6 admission criteria; emilkowalski motion canon",2026-07-12,active

package/data/harnesses/apollo/skills/design/data/typography/anton-work-sans.md

@@ -0,0 +1,17 @@
+---
+id: anton-work-sans
+class: a1
+sourced: 2026-07-12
+source: "Fontpair.co bold/brutalist list; Google Fonts; families verified live against fonts.google.com/metadata/fonts"
+license: open
+feel: "loud condensed poster headline against a quiet neutral body — maximum contrast"
+---
+Anton is a single static weight built for shouting — a handful of words at most, never a sentence; Work Sans absorbs every remaining functional role at a calm, neutral register.
+
+```yaml values
+display: { family: "Anton", fallback: "\"Helvetica Neue\", Arial, sans-serif", weights: [400] }
+sans: { family: "Work Sans Variable", fallback: "\"Helvetica Neue\", Arial, sans-serif", weights: [400, 500, 600] }
+mono: { family: "Roboto Mono Variable", fallback: "\"SFMono-Regular\", Consolas, \"Liberation Mono\", Menlo, monospace", weights: [400, 500] }
+register-scope: { display: ["poster headlines", "hero words", "cover moments"], sans: ["body copy", "buttons", "form labels", "table cells", "nav"], mono: ["code", "data values"] }
+oracle-verified: 2026-07-12
+```

package/data/harnesses/apollo/skills/design/data/typography/archivo-black-archivo.md

@@ -0,0 +1,17 @@
+---
+id: archivo-black-archivo
+class: a1
+sourced: 2026-07-12
+source: "Fontpair.co brutalist list; Google Fonts (Omnibus-Type superfamily); families verified live against fonts.google.com/metadata/fonts"
+license: open
+feel: "brutalist poster energy tempered by a disciplined variable-width grotesque body"
+---
+Archivo Black is a single static 900-weight cut reserved for shock headlines; Archivo Variable (same foundry, wdth+wght axes) runs everything else, including a condensed width option for dense tables.
+
+```yaml values
+display: { family: "Archivo Black", fallback: "\"Helvetica Neue\", Arial, sans-serif", weights: [400] }
+sans: { family: "Archivo Variable", fallback: "\"Helvetica Neue\", Arial, sans-serif", weights: [400, 500, 600] }
+mono: { family: "JetBrains Mono Variable", fallback: "\"SFMono-Regular\", Consolas, \"Liberation Mono\", Menlo, monospace", weights: [400, 500] }
+register-scope: { display: ["poster headlines", "hero statements", "cover moments"], sans: ["body copy", "buttons", "form labels", "table cells", "nav"], mono: ["code", "data"] }
+oracle-verified: 2026-07-12
+```

package/data/harnesses/apollo/skills/design/data/typography/bitter-karla.md

@@ -0,0 +1,17 @@
+---
+id: bitter-karla
+class: a1
+sourced: 2026-07-12
+source: "Google Fonts featured pairings; Fontpair.co warm-approachable list; families verified live against fonts.google.com/metadata/fonts"
+license: open
+feel: "friendly slab warmth over a soft, low-contrast grotesque"
+---
+A gentle, approachable pairing for product blogs and onboarding flows that want warmth without going fully editorial; both faces are fully variable so weight can carry hierarchy inside each role too.
+
+```yaml values
+display: { family: "Bitter Variable", fallback: "Georgia, Cambria, \"Times New Roman\", serif", weights: [400, 600, 700] }
+sans: { family: "Karla Variable", fallback: "\"Helvetica Neue\", Arial, sans-serif", weights: [400, 500, 600, 700] }
+mono: { family: "JetBrains Mono Variable", fallback: "\"SFMono-Regular\", Consolas, \"Liberation Mono\", Menlo, monospace", weights: [400, 500] }
+register-scope: { display: ["headlines", "hero banners", "cover cards"], sans: ["body copy", "buttons", "form labels", "table cells", "nav"], mono: ["code", "IDs"] }
+oracle-verified: 2026-07-12
+```

package/data/harnesses/apollo/skills/design/data/typography/dm-serif-dm-sans.md

@@ -0,0 +1,17 @@
+---
+id: dm-serif-dm-sans
+class: a1
+sourced: 2026-07-12
+source: "Google Fonts featured pairings (Colophon Foundry twin release); Fontpair.co; families verified live against fonts.google.com/metadata/fonts"
+license: open
+feel: "quiet warmth from two faces drawn by the same studio in one release"
+---
+The shared authorship keeps x-heights and rhythm aligned without matching stroke contrast — a low-friction pairing for blogs, newsletters, and about-pages that want a soft editorial voice. DM Serif Display ships as a single static weight; treat it as a display voice, not a workhorse.
+
+```yaml values
+display: { family: "DM Serif Display", fallback: "Georgia, Cambria, \"Times New Roman\", serif", weights: [400] }
+sans: { family: "DM Sans Variable", fallback: "\"Helvetica Neue\", Arial, sans-serif", weights: [400, 500, 600, 700] }
+mono: { family: "JetBrains Mono Variable", fallback: "\"SFMono-Regular\", Consolas, \"Liberation Mono\", Menlo, monospace", weights: [400, 500] }
+register-scope: { display: ["pull quotes", "hero statements", "identity lockups"], sans: ["body copy", "nav", "buttons", "form labels", "table cells"], mono: ["code samples", "technical asides"] }
+oracle-verified: 2026-07-12
+```

package/data/harnesses/apollo/skills/design/data/typography/fraunces-inter.md

@@ -0,0 +1,17 @@
+---
+id: fraunces-inter
+class: a1
+sourced: 2026-07-12
+source: "Fontpair.co warm-editorial list; Fonts In Use case studies tagged Fraunces; families verified live against fonts.google.com/metadata/fonts"
+license: open
+feel: "expressive, ink-trap warmth over a clean, quiet product sans"
+---
+Fraunces carries optical-size (opsz) and WONK/SOFT axes — dial WONK toward 0 and keep opsz high for a calmer display cut in dense layouts; Inter runs the rest of the interface untouched.
+
+```yaml values
+display: { family: "Fraunces Variable", fallback: "Georgia, Cambria, \"Times New Roman\", serif", weights: [400, 500, 600, 900] }
+sans: { family: "Inter Variable", fallback: "\"Helvetica Neue\", Arial, sans-serif", weights: [400, 500, 600, 700] }
+mono: { family: "JetBrains Mono Variable", fallback: "\"SFMono-Regular\", Consolas, \"Liberation Mono\", Menlo, monospace", weights: [400, 500] }
+register-scope: { display: ["hero headlines", "cover moments", "editorial pull quotes"], sans: ["body copy", "UI labels", "buttons", "form fields", "table cells"], mono: ["code blocks", "data/IDs"] }
+oracle-verified: 2026-07-12
+```

package/data/harnesses/apollo/skills/design/data/typography/geist-geist-mono.md

@@ -0,0 +1,17 @@
+---
+id: geist-geist-mono
+class: a1
+sourced: 2026-07-12
+source: "Vercel's production type system, Geist Sans + Geist Mono (Vercel with Basement Studio, OFL, added to Google Fonts Oct/Nov 2024); families verified live against fonts.google.com/metadata/fonts"
+license: open
+feel: "quiet, engineered product register — a single studio's sans and mono built as one system"
+---
+Dense-operator-adjacent: Geist Variable carries both identity moments (heavier weight) and body/UI (regular weight) as the same family, exactly as Vercel ships it on vercel.com and in Next.js docs; Geist Mono is the real sibling mono, not a substitution.
+
+```yaml values
+display: { family: "Geist Variable", fallback: "\"Helvetica Neue\", Arial, sans-serif", weights: [600, 700] }
+sans: { family: "Geist Variable", fallback: "\"Helvetica Neue\", Arial, sans-serif", weights: [400, 500] }
+mono: { family: "Geist Mono Variable", fallback: "\"SFMono-Regular\", Consolas, \"Liberation Mono\", Menlo, monospace", weights: [400, 500] }
+register-scope: { display: ["hero headlines", "page titles", "top-nav wordmark"], sans: ["body copy", "buttons", "form labels", "table cells", "nav"], mono: ["code blocks", "terminal output", "IDs"] }
+oracle-verified: 2026-07-12
+```

package/data/harnesses/apollo/skills/design/data/typography/hubot-sans-mona-sans.md

@@ -0,0 +1,17 @@
+---
+id: hubot-sans-mona-sans
+class: a1
+sourced: 2026-07-12
+source: "GitHub's production brand/UI system, Hubot Sans + Mona Sans (GitHub with Degarism Studio, OFL, added to Google Fonts Nov 2024); families verified live against fonts.google.com/metadata/fonts"
+license: open
+feel: "friendly technical brand voice — an expressive geometric display over a workhorse variable UI face"
+---
+Hubot Sans is GitHub's display/wordmark face (wide, geometric, confident); Mona Sans is the UI workhorse (wdth+wght axes) for everything functional. Note: GitHub's real code font, Monaspace, is OFL-licensed but not published to Google Fonts — JetBrains Mono is substituted here and should be swapped for Monaspace directly from GitHub's own distribution if code-block authenticity matters.
+
+```yaml values
+display: { family: "Hubot Sans Variable", fallback: "\"Helvetica Neue\", Arial, sans-serif", weights: [500, 700] }
+sans: { family: "Mona Sans Variable", fallback: "\"Helvetica Neue\", Arial, sans-serif", weights: [400, 500, 600] }
+mono: { family: "JetBrains Mono Variable", fallback: "\"SFMono-Regular\", Consolas, \"Liberation Mono\", Menlo, monospace", weights: [400, 500] }
+register-scope: { display: ["brand lockups", "hero headlines", "cover moments"], sans: ["body copy", "buttons", "form labels", "table cells", "nav"], mono: ["code blocks", "terminal output", "diffs"] }
+oracle-verified: 2026-07-12
+```

package/data/harnesses/apollo/skills/design/data/typography/ibm-plex-sans-operator-single-family.md

@@ -0,0 +1,17 @@
+---
+id: ibm-plex-sans-operator-single-family
+class: a1
+sourced: 2026-07-12
+source: "IBM's own Plex type system (Mike Abbink / Bold Monday); Typ.io; families verified live against fonts.google.com/metadata/fonts"
+license: open
+feel: "humanist technical register, one family carrying the entire hierarchy by weight and width"
+---
+Dense-operator entry: IBM Plex Sans Variable (wdth+wght axes) covers both display and sans roles — use 600 weight or a narrower width cut for identity moments only, never for table cells or buttons. Plex Mono (static, same foundry) completes the trio for code and data.
+
+```yaml values
+display: { family: "IBM Plex Sans Variable", fallback: "\"Helvetica Neue\", Arial, sans-serif", weights: [600, 700] }
+sans: { family: "IBM Plex Sans Variable", fallback: "\"Helvetica Neue\", Arial, sans-serif", weights: [400, 500] }
+mono: { family: "IBM Plex Mono", fallback: "\"SFMono-Regular\", Consolas, \"Liberation Mono\", Menlo, monospace", weights: [400, 500, 600] }
+register-scope: { display: ["page titles", "dashboard section headers", "empty states"], sans: ["body copy", "buttons", "form labels", "table cells", "nav"], mono: ["code", "logs", "data/IDs"] }
+oracle-verified: 2026-07-12
+```

package/data/harnesses/apollo/skills/design/data/typography/instrument-serif-instrument-sans.md

@@ -0,0 +1,17 @@
+---
+id: instrument-serif-instrument-sans
+class: a1
+sourced: 2026-07-12
+source: "Google Fonts (Instrument design agency twin release, 2023); Fonts In Use recent uploads; families verified live against fonts.google.com/metadata/fonts"
+license: open
+feel: "bright, high-contrast serif flashes against a friendly variable-width grotesque"
+---
+Instrument Serif ships one weight and an italic only — treat it as a flourish face for a handful of words, never a paragraph; Instrument Sans carries every functional role including its own width axis for compact table headers.
+
+```yaml values
+display: { family: "Instrument Serif", fallback: "Georgia, Cambria, \"Times New Roman\", serif", weights: [400] }
+sans: { family: "Instrument Sans Variable", fallback: "\"Helvetica Neue\", Arial, sans-serif", weights: [400, 500, 600, 700] }
+mono: { family: "JetBrains Mono Variable", fallback: "\"SFMono-Regular\", Consolas, \"Liberation Mono\", Menlo, monospace", weights: [400, 500] }
+register-scope: { display: ["hero words", "short pull quotes", "identity lockups"], sans: ["body copy", "buttons", "form labels", "table cells", "dense UI"], mono: ["code", "data values"] }
+oracle-verified: 2026-07-12
+```

package/data/harnesses/apollo/skills/design/data/typography/inter-operator-single-family.md

@@ -0,0 +1,17 @@
+---
+id: inter-operator-single-family
+class: a1
+sourced: 2026-07-12
+source: "Linear's production UI stack (Inter, confirmed — Linear does not ship a custom typeface); Google Fonts; family verified live against fonts.google.com/metadata/fonts"
+license: open
+feel: "precise, restrained SaaS operator surface carried entirely by weight"
+---
+Dense-operator entry: display and sans are the same registered family — identity moments (page titles, top-nav wordmark) take weight 600–700 of Inter Variable itself rather than a separate face; body/UI stays at 400–500. No display face touches table cells or buttons.
+
+```yaml values
+display: { family: "Inter Variable", fallback: "\"Helvetica Neue\", Arial, sans-serif", weights: [600, 700] }
+sans: { family: "Inter Variable", fallback: "\"Helvetica Neue\", Arial, sans-serif", weights: [400, 500] }
+mono: { family: "JetBrains Mono Variable", fallback: "\"SFMono-Regular\", Consolas, \"Liberation Mono\", Menlo, monospace", weights: [400, 500] }
+register-scope: { display: ["page titles", "top-nav wordmark", "empty-state headlines"], sans: ["body copy", "buttons", "form labels", "table cells", "nav items"], mono: ["code", "IDs", "timestamps", "numeric data"] }
+oracle-verified: 2026-07-12
+```

package/data/harnesses/apollo/skills/design/data/typography/libre-baskerville-libre-franklin.md

@@ -0,0 +1,17 @@
+---
+id: libre-baskerville-libre-franklin
+class: a1
+sourced: 2026-07-12
+source: "Fontpair.co classic-serif list; Google Fonts (both by Impallari Type); families verified live against fonts.google.com/metadata/fonts"
+license: open
+feel: "quiet civic literary register, restrained by shared foundry discipline"
+---
+Libre Baskerville is a classic-book face with no variable axis and only three cuts — use it sparingly for titles; Libre Franklin's full variable range does the rest of the civic/documentation work.
+
+```yaml values
+display: { family: "Libre Baskerville", fallback: "Georgia, Cambria, \"Times New Roman\", serif", weights: [400, 700] }
+sans: { family: "Libre Franklin Variable", fallback: "\"Helvetica Neue\", Arial, sans-serif", weights: [400, 500, 600, 700] }
+mono: { family: "IBM Plex Mono", fallback: "\"SFMono-Regular\", Consolas, \"Liberation Mono\", Menlo, monospace", weights: [400, 500] }
+register-scope: { display: ["report titles", "cover pages", "section headers"], sans: ["body copy", "buttons", "form labels", "table cells"], mono: ["citations", "reference codes"] }
+oracle-verified: 2026-07-12
+```

package/data/harnesses/apollo/skills/design/data/typography/newsreader-inter.md

@@ -0,0 +1,17 @@
+---
+id: newsreader-inter
+class: a1
+sourced: 2026-07-12
+source: "Google Fonts (Production Type, built for a Google News reading initiative); Typ.io case-study tag; families verified live against fonts.google.com/metadata/fonts"
+license: open
+feel: "hushed, long-form literary register that shrinks gracefully at small sizes"
+---
+Newsreader's opsz axis is the point — let it size itself down for dense captions and up for display; pair only with a body sans that disappears, which Inter is built to do.
+
+```yaml values
+display: { family: "Newsreader Variable", fallback: "Georgia, Cambria, \"Times New Roman\", serif", weights: [400, 500, 600] }
+sans: { family: "Inter Variable", fallback: "\"Helvetica Neue\", Arial, sans-serif", weights: [400, 500, 600] }
+mono: { family: "Roboto Mono Variable", fallback: "\"SFMono-Regular\", Consolas, \"Liberation Mono\", Menlo, monospace", weights: [400, 500] }
+register-scope: { display: ["article headlines", "pull quotes", "cover text"], sans: ["body copy", "nav", "buttons", "form labels", "table cells"], mono: ["timestamps", "citations", "code refs"] }
+oracle-verified: 2026-07-12
+```

package/data/harnesses/apollo/skills/design/data/typography/playfair-display-source-sans.md

@@ -0,0 +1,17 @@
+---
+id: playfair-display-source-sans
+class: a1
+sourced: 2026-07-12
+source: "Fontpair.co classic-pairings list; Typ.io Adobe-fonts popularity data; families verified live against fonts.google.com/metadata/fonts"
+license: open
+feel: "broadsheet gravity meeting a disciplined newsroom reading face"
+---
+Use for long-form editorial and reports where headlines need didone drama but body copy must stay quiet and legible; the mono is a substitution note, not part of the source pairing — bring it in only if the surface needs inline code or IDs.
+
+```yaml values
+display: { family: "Playfair Display Variable", fallback: "Georgia, Cambria, \"Times New Roman\", serif", weights: [400, 600, 700, 900] }
+sans: { family: "Source Sans 3 Variable", fallback: "\"Helvetica Neue\", Arial, sans-serif", weights: [400, 500, 600, 700] }
+mono: { family: "IBM Plex Mono", fallback: "\"SFMono-Regular\", Consolas, \"Liberation Mono\", Menlo, monospace", weights: [400, 500, 600] }
+register-scope: { display: ["cover titles", "hero headlines", "section dividers"], sans: ["body copy", "captions", "buttons", "form labels", "table cells"], mono: ["figure references", "dataset IDs", "code snippets"] }
+oracle-verified: 2026-07-12
+```

package/data/harnesses/apollo/skills/design/data/typography/public-sans-operator-single-family.md

@@ -0,0 +1,17 @@
+---
+id: public-sans-operator-single-family
+class: a1
+sourced: 2026-07-12
+source: "U.S. Web Design System (USWDS) production typeface, Public Sans (18F/USWDS, Google Fonts); families verified live against fonts.google.com/metadata/fonts"
+license: open
+feel: "quiet civic register, weight-carried hierarchy built for dense government data tables"
+---
+Dense-operator entry: Public Sans Variable is the entire system — no separate display face. Identity moments take 600-700 weight; every table cell, form label, and button stays at 400-500. Built explicitly for accessibility-first government services, so it is the most conservative entry in this set.
+
+```yaml values
+display: { family: "Public Sans Variable", fallback: "\"Helvetica Neue\", Arial, sans-serif", weights: [600, 700] }
+sans: { family: "Public Sans Variable", fallback: "\"Helvetica Neue\", Arial, sans-serif", weights: [400, 500] }
+mono: { family: "Roboto Mono Variable", fallback: "\"SFMono-Regular\", Consolas, \"Liberation Mono\", Menlo, monospace", weights: [400, 500] }
+register-scope: { display: ["page titles", "section headers", "identity moments"], sans: ["body copy", "buttons", "form labels", "table cells", "nav"], mono: ["reference codes", "data values"] }
+oracle-verified: 2026-07-12
+```

package/data/harnesses/apollo/skills/design/data/typography/sohne-inter-fintech.md

@@ -0,0 +1,17 @@
+---
+id: sohne-inter-fintech
+class: a1
+sourced: 2026-07-12
+source: "Stripe's production marketing/dashboard stack — Söhne, a commercial Klim Type Foundry license (released 2019), reported via industry SaaS-typography surveys; open substitutes verified live against fonts.google.com/metadata/fonts"
+license: licensed
+feel: "fintech institutional precision — a paid grotesque for identity, an open workhorse for everything else"
+---
+Söhne is a commercial Klim Type Foundry release, NOT distributed via Google Fonts — license it directly from Klim (or use the system-font fallback stack as a placeholder) before shipping; Inter Variable is the open substitute carrying every UI, table, and form role so the licensed face never has to.
+
+```yaml values
+display: { family: "Söhne", fallback: "system-ui, -apple-system, \"Segoe UI\", sans-serif", weights: [400, 500, 700] }
+sans: { family: "Inter Variable", fallback: "\"Helvetica Neue\", Arial, sans-serif", weights: [400, 500, 600] }
+mono: { family: "JetBrains Mono Variable", fallback: "\"SFMono-Regular\", Consolas, \"Liberation Mono\", Menlo, monospace", weights: [400, 500] }
+register-scope: { display: ["marketing hero type", "brand lockups", "cover moments"], sans: ["body copy", "buttons", "form labels", "table cells", "dashboard UI"], mono: ["code", "API examples", "numeric data"] }
+oracle-verified: 2026-07-12
+```

package/data/harnesses/apollo/skills/design/data/typography/source-serif-source-sans.md

@@ -0,0 +1,17 @@
+---
+id: source-serif-source-sans
+class: a1
+sourced: 2026-07-12
+source: "Adobe/Google Fonts superfamily (Source series); Typ.io Adobe-fonts popularity list; families verified live against fonts.google.com/metadata/fonts"
+license: open
+feel: "quiet institutional register — one design lineage front to back"
+---
+Both faces share a metrics philosophy from the same Adobe type team, so swapping serif-for-sans mid-document (report body to callout) never jars; good for documentation, legal, and internal-tool surfaces that want restraint over personality.
+
+```yaml values
+display: { family: "Source Serif 4 Variable", fallback: "Georgia, Cambria, \"Times New Roman\", serif", weights: [400, 500, 600] }
+sans: { family: "Source Sans 3 Variable", fallback: "\"Helvetica Neue\", Arial, sans-serif", weights: [400, 500, 600, 700] }
+mono: { family: "IBM Plex Mono", fallback: "\"SFMono-Regular\", Consolas, \"Liberation Mono\", Menlo, monospace", weights: [400, 500] }
+register-scope: { display: ["document titles", "section headers", "cover pages"], sans: ["body copy", "buttons", "form labels", "table cells", "nav"], mono: ["reference IDs", "code", "version strings"] }
+oracle-verified: 2026-07-12
+```

package/data/harnesses/apollo/skills/design/data/typography/space-grotesk-work-sans-space-mono.md

@@ -0,0 +1,17 @@
+---
+id: space-grotesk-work-sans-space-mono
+class: a1
+sourced: 2026-07-12
+source: "Fontpair.co technical/startup list; Google Fonts; families verified live against fonts.google.com/metadata/fonts"
+license: open
+feel: "geometric technical display over a neutral working body, monospace for code accents"
+---
+A three-role technical system: Space Grotesk's squarish geometry announces sections, Work Sans stays out of the way for body copy, and its Colophon Foundry sibling Space Mono (static, 4 cuts) marks code — a common indie-SaaS combination.
+
+```yaml values
+display: { family: "Space Grotesk Variable", fallback: "\"Helvetica Neue\", Arial, sans-serif", weights: [500, 700] }
+sans: { family: "Work Sans Variable", fallback: "\"Helvetica Neue\", Arial, sans-serif", weights: [400, 500, 600] }
+mono: { family: "Space Mono", fallback: "\"SFMono-Regular\", Consolas, \"Liberation Mono\", Menlo, monospace", weights: [400, 700] }
+register-scope: { display: ["section headers", "hero headlines", "feature callouts"], sans: ["body copy", "buttons", "form labels", "table cells"], mono: ["code", "terminal output", "data values"] }
+oracle-verified: 2026-07-12
+```

package/data/harnesses/apollo/skills/design/data/typography/spectral-manrope.md

@@ -0,0 +1,17 @@
+---
+id: spectral-manrope
+class: a1
+sourced: 2026-07-12
+source: "Fontpair.co editorial-meets-product list; Google Fonts (Production Type / Mikhail Sharanda); families verified live against fonts.google.com/metadata/fonts"
+license: open
+feel: "literary display warmth set against a crisp geometric grotesque body"
+---
+Spectral has no variable axis — pick static weights deliberately (400 for long text, 600/700 for emphasis); Manrope is fully variable and should absorb every UI weight need.
+
+```yaml values
+display: { family: "Spectral", fallback: "Georgia, Cambria, \"Times New Roman\", serif", weights: [400, 600, 700] }
+sans: { family: "Manrope Variable", fallback: "\"Helvetica Neue\", Arial, sans-serif", weights: [400, 500, 600, 700] }
+mono: { family: "Space Mono", fallback: "\"SFMono-Regular\", Consolas, \"Liberation Mono\", Menlo, monospace", weights: [400, 700] }
+register-scope: { display: ["headlines", "cover statements", "section dividers"], sans: ["body copy", "buttons", "form labels", "table cells"], mono: ["code", "data labels"] }
+oracle-verified: 2026-07-12
+```

package/data/harnesses/apollo/skills/design/data/voices/bright-collaborator.md

@@ -0,0 +1,29 @@
+---
+id: bright-collaborator
+class: c2
+sourced: 2026-07-12
+source: "Distilled from Slack's voice & tone guidance (api.slack.com/best-practices/voice-and-tone) — confident not cocky, witty not silly, clear-concise-human, tone as seasoning not the dish."
+license: open
+---
+# Voice: bright-collaborator
+
+**Feel:** Confident and a little playful, but the point always lands first.
+
+Conversational rhythm — short sentences mixed with one longer one for cadence, contractions standard, second person throughout. Personality is seasoning: light wit is reserved for confirmations and empty states, never for errors. Actions open with a verb. Numbers are digits. One idea per sentence — never two clauses competing for attention.
+
+## Tone map
+
+Voice is constant; tone dials by situation.
+
+- **routine action:** verb-first with a light conversational lift
+- **error:** personality drops out entirely — plain statement, then the fix
+- **success:** wit is allowed, one line, never stacked
+- **destructive confirmation:** playfulness fully off, states the stakes plainly
+
+## Examples
+
+- **button:** "Invite teammate"
+- **empty state (heading + motivation):** "Quiet in here" / "Invite a teammate and this space starts filling up."
+- **error:** "That invite didn't go through. Check the email and send it again."
+- **tooltip:** "Only workspace admins can see this."
+- **confirmation:** "Teammate invited — welcome aboard."

package/data/harnesses/apollo/skills/design/data/voices/direct-operator.md

@@ -0,0 +1,29 @@
+---
+id: direct-operator
+class: c2
+sourced: 2026-07-12
+source: "Distilled from Atlassian's 'bold, optimistic, practical' brevity mandate (atlassian.design/content/voice-and-tone-principles) and Material Design's clarity-to-anyone standard (m3.material.io/foundations/content-design)."
+license: open
+---
+# Voice: direct-operator
+
+**Feel:** Brisk and task-first — reads like a command line, not a conversation.
+
+Imperative mood by default; sentence fragments are acceptable where a full sentence adds nothing ("Upload failed. Retry."). No adjectives unless load-bearing. Numerals are always digits, units abbreviated once established. No exclamation points, no rhetorical questions, no throat-clearing openers ("Please note that…"). Density over politeness — every word has to justify its presence.
+
+## Tone map
+
+Voice is constant; tone dials by situation.
+
+- **routine action:** imperative, fragments allowed
+- **error:** states failure plus count or reason, no softening
+- **success:** single clipped phrase, no embellishment
+- **destructive confirmation:** same flat register as everything else — no added urgency language, the plainness is the safeguard
+
+## Examples
+
+- **button:** "Create workspace"
+- **empty state (heading + motivation):** "No records" / "Import a file or add one manually to begin."
+- **error:** "Save failed. 3 fields are invalid."
+- **tooltip:** "Locks the row for editing by others."
+- **confirmation:** "Workspace created."

package/data/harnesses/apollo/skills/design/data/voices/earnest-helper.md

@@ -0,0 +1,29 @@
+---
+id: earnest-helper
+class: c2
+sourced: 2026-07-12
+source: "Distilled from Intercom's PREACH framework (intercom.com/blog/preach-framework-for-customer-support-tone) — Proud, Responsible, Empathetic, Articulate, Concise, Human."
+license: open
+---
+# Voice: earnest-helper
+
+**Feel:** Owns the failure, states the fix, never grovels.
+
+First-person-plural ownership when the product is at fault ("we couldn't…"), second person when guiding the user's next step. Sentences are short and declarative; empathy is shown through precision and a clear next step rather than apology words ("sorry," "oops" are avoided). No exclamation points, even on success — confidence doesn't need punctuation. Numbers are digits throughout.
+
+## Tone map
+
+Voice is constant; tone dials by situation.
+
+- **routine action:** second person, concise, no flourish
+- **error:** first-person-plural ownership ("we couldn't…"), immediate next step
+- **success:** short, no exclamation, confidence without decoration
+- **destructive confirmation:** states irreversibility explicitly, still no apology language
+
+## Examples
+
+- **button:** "Submit request"
+- **empty state (heading + motivation):** "No requests yet" / "Submit one and track its progress here."
+- **error:** "We couldn't submit that request. Reconnect and try again."
+- **tooltip:** "Requests are visible to your whole team once submitted."
+- **confirmation:** "Request submitted."

package/data/harnesses/apollo/skills/design/data/voices/editorial-composed.md

@@ -0,0 +1,29 @@
+---
+id: editorial-composed
+class: c2
+sourced: 2026-07-12
+source: "Distilled from Material Design's AP-style clarity standard (m3.material.io/foundations/content-design/style-guide/ux-writing-best-practices) and Atlassian's 'practical, with a wink' brand register (atlassian.design/content/writing-style), slowed to an editorial cadence."
+license: open
+---
+# Voice: editorial-composed
+
+**Feel:** Measured and literate — composed sentences, unhurried but exact.
+
+Longer, fully-formed sentences that favor a subordinate clause over a fragment; still one idea per sentence, but the idea is given room. Verbs remain the engine of the sentence rather than being buried under nominalizations. Numbers under ten are spelled out even in most UI text; digits are reserved for data-dense contexts (tables, counters, timestamps). Restraint reads as taste, not coldness — warmth comes from word choice, never from exclamation.
+
+## Tone map
+
+Voice is constant; tone dials by situation.
+
+- **routine action:** a fuller sentence, still verb-led
+- **error:** composed, no blame, the fix named in a complete sentence
+- **success:** a complete, satisfying sentence rather than a clipped label
+- **destructive confirmation:** the most fully-formed of the four — consequence and reversibility spelled out in full
+
+## Examples
+
+- **button:** "Add collection"
+- **empty state (heading + motivation):** "Nothing archived yet" / "Items you archive will be kept here, in order, for as long as you need them."
+- **error:** "The collection couldn't be saved. Review the highlighted fields and try again."
+- **tooltip:** "Determines the order collections appear in for every viewer."
+- **confirmation:** "Collection added and ready to share."

package/data/harnesses/apollo/skills/design/data/voices/quiet-concierge.md

@@ -0,0 +1,29 @@
+---
+id: quiet-concierge
+class: c2
+sourced: 2026-07-12
+source: "Distilled from Shopify Polaris content fundamentals (polaris-react.shopify.com — verb-first directness, plain language, 'remove until it breaks') and Atlassian voice & tone (atlassian.design — say it once, then get out of the way)."
+license: open
+---
+# Voice: quiet-concierge
+
+**Feel:** Understated and precise — says the necessary thing once, then steps back.
+
+Short-to-medium declarative sentences, verb-first for any instruction ("Add," "Move," "Archive"). Warmth comes from precision, not adjectives — no exclamation points, no stacked modifiers, no filler words ("just," "simply," "easily"). Numbers render as digits even under ten, to keep the eye moving. Contractions are allowed ("it's," "can't") to keep the register human. If a sentence can be cut without losing meaning, cut it.
+
+## Tone map
+
+Voice is constant; tone dials by situation.
+
+- **routine action:** plain, verb-first, no ornament
+- **error:** flat statement of what happened, then the fix — no apology
+- **success:** states the fact and stops there
+- **destructive confirmation:** names exactly what's lost, in the same even register — precision is the only warning
+
+## Examples
+
+- **button:** "Add customer"
+- **empty state (heading + motivation):** "No reports yet" / "Reports appear here once your first one is generated."
+- **error:** "The file didn't upload. Check your connection and try again."
+- **tooltip:** "Archives the record without deleting its history."
+- **confirmation:** "Customer added."