@nurix/etna 0.19.11 → 0.19.12

package/data/harnesses/code/skills/design/data/motion/number-ticker-roll.md

@@ -0,0 +1,18 @@
+---
+id: number-ticker-roll
+class: a6
+sourced: 2026-07-12
+source: "emilkowalski.skills/skills/animation-vocabulary/SKILL.md (Number ticker; Tabular numbers) + review-animations/STANDARDS.md (sub-300ms rule; interruptibility)"
+license: open
+feel: "digits rolling to the new value at ~250ms read like a live counter; an instant jump-cut reads like the number just glitched"
+aliases: { glitched: "value changes with no roll/interpolation at all", "tabular-drift": "digits set without tabular figures, so the number visibly shifts width as it rolls", janky: "keyframe roll restarting from zero on each rapid update instead of retargeting" }
+---
+Live counters, stat tiles, KPI cards, running totals — system-driven value changes, so the sub-300ms UI rule applies. Requires tabular figures so surrounding layout doesn't shift while digits roll. Rapid successive updates retarget the roll (transition, not keyframes), never restart from zero.
+
+```yaml values
+duration: 250ms
+easing: cubic-bezier(0.23, 1, 0.32, 1)
+element-class: control
+interruptible: required
+budget: { control: 200-300ms }
+```

package/data/harnesses/code/skills/design/data/motion/onboarding-bounce.md

@@ -0,0 +1,18 @@
+---
+id: onboarding-bounce
+class: a6
+sourced: 2026-07-12
+source: "emilkowalski.skills/skills/review-animations/STANDARDS.md (springs — bounce 0.1-0.3, reserved for playful moments) + improve-animations/AUDIT.md §1 (rare/first-time → delight)"
+license: open
+feel: "a springy overshoot on a first-run welcome card reads warm and considered; the same bounce on anything seen daily reads gimmicky"
+aliases: { gimmicky: "spring bounce applied outside a rare/first-time identity moment — the same overshoot on a daily-use control", overdone: "bounce pushed above the 0.1-0.3 range into cartoonish territory" }
+---
+Onboarding welcome screens, first-run tours — rare, high-emotion, seen once or a handful of times ever. The scoped exception where springy/physical vocabulary is admissible; it does not license bounce anywhere else.
+
+```yaml values
+duration: 500ms (spring; no fixed duration)
+easing: spring(bounce 0.3)
+element-class: identity-moment
+interruptible: n/a
+budget: { identity-moment: 400-600ms }
+```

package/data/harnesses/code/skills/design/data/motion/panel-slide.md

@@ -0,0 +1,18 @@
+---
+id: panel-slide
+class: a6
+sourced: 2026-07-12
+source: "emilkowalski.skills/skills/review-animations/STANDARDS.md (--ease-drawer curve; duration table, modal/drawer row) + apple-design/SKILL.md §3 (interruption; velocity continuity)"
+license: open
+feel: "a 260ms slide on the iOS drawer curve reads native and grabbable; a keyframe slide that restarts on repeated taps reads broken"
+aliases: { broken: "keyframes restarting from zero instead of a transition/spring retargeting mid-slide", floaty: "duration pushed past the panel budget" }
+---
+Side panels, drawers, bottom sheets. Must be interruptible and carry velocity on a gesture-driven close — grabbing a closing panel should follow the pointer, not fight it.
+
+```yaml values
+duration: 260ms
+easing: cubic-bezier(0.32, 0.72, 0, 1)
+element-class: panel
+interruptible: required
+budget: { panel: 200-500ms }
+```

package/data/harnesses/code/skills/design/data/motion/press-feedback.md

@@ -0,0 +1,18 @@
+---
+id: press-feedback
+class: a6
+sourced: 2026-07-12
+source: "emilkowalski.skills/skills/review-animations/STANDARDS.md (physicality — press feedback; duration table) + improve-animations/AUDIT.md §2-3"
+license: open
+feel: "160ms scale-to-0.97 on pointer-down reads tactile and instant; slower or absent reads dead under the finger"
+aliases: { dead: "no press feedback at all, or duration pushed above the 160ms control budget", mushy: "an easing softer than ease-out, delaying the visible response" }
+---
+Any pressable control — buttons, icon buttons, tap-target rows. The canon prescribes this on every pressable element while forbidding animation on keyboard-initiated actions: it fires on pointer-down only (a tap affordance, not a state transition), and keyboard activation (Enter/Space) never replays it.
+
+```yaml values
+duration: 160ms
+easing: cubic-bezier(0.23, 1, 0.32, 1)
+element-class: control
+interruptible: n/a
+budget: { control: 100-160ms }
+```

package/data/harnesses/code/skills/design/data/motion/progress-linear-loop.md

@@ -0,0 +1,18 @@
+---
+id: progress-linear-loop
+class: a6
+sourced: 2026-07-12
+source: "emilkowalski.skills/skills/review-animations/STANDARDS.md (easing decision order — constant motion → linear) + animation-vocabulary/SKILL.md (Loop; Marquee); Material's linear token agrees as secondary"
+license: open
+feel: "a constant linear sweep reads honest about an unknown wait; any easing that speeds up and slows down reads like a fake promise"
+aliases: { "fake-promise": "eased (non-linear) motion on an indeterminate progress indicator, implying a completion point that doesn't exist", twitchy: "loop cycle faster than ~1s, reading anxious rather than calm" }
+---
+Indeterminate progress bars, loading spinners, marquees. Constant-speed motion only — the one place `linear` is correct and `ease` curves are wrong.
+
+```yaml values
+duration: 1200ms (loop)
+easing: linear
+element-class: control
+interruptible: n/a
+budget: { control: 1000-1500ms }
+```

package/data/harnesses/code/skills/design/data/motion/route-crossfade.md

@@ -0,0 +1,18 @@
+---
+id: route-crossfade
+class: a6
+sourced: 2026-07-12
+source: "emilkowalski.skills/skills/animation-vocabulary/SKILL.md (Crossfade; Page transition) + review-animations/STANDARDS.md (sub-300ms rule; masking imperfect crossfades; easing decision order — opacity/color → ease)"
+license: open
+feel: "a single ~250ms crossfade between views reads like one continuous product; a staggered reveal of each panel on arrival reads like a slideshow"
+aliases: { slideshow: "child elements staggering in individually on route arrival instead of one crossfade", "double-exposed": "old and new view both fully visible mid-transition — mask with a subtle blur (~2px, never above 20px)" }
+---
+Navigating between routes or top-level views — a same-place opacity morph, not a spatial entrance, so `ease` rather than the entrance curve. One crossfade only; never an orchestrated sequence of the destination's own elements arriving one by one. A product loads into a task, not a reveal.
+
+```yaml values
+duration: 250ms
+easing: ease
+element-class: page
+interruptible: n/a
+budget: { page: 200-300ms }
+```

package/data/harnesses/code/skills/design/data/motion/rubber-band-overscroll.md

@@ -0,0 +1,18 @@
+---
+id: rubber-band-overscroll
+class: a6
+sourced: 2026-07-12
+source: "emilkowalski.skills/skills/animation-vocabulary/SKILL.md (Rubber-banding) + apple-design/SKILL.md §8 (boundary resistance) and spring cheat-sheet (critically-damped default)"
+license: open
+feel: "resistance that grows the further you pull, then a quick snap-back, reads alive and physical; a hard stop at the edge reads frozen"
+aliases: { frozen: "a hard stop at the scroll boundary instead of progressive resistance", overshoot: "snap-back overshoots past the origin instead of settling cleanly" }
+---
+Scrollable containers and pull-to-refresh regions at their boundary. Resistance increases continuously with drag distance past the edge; release animates back with a critically-damped spring, never a linear tween.
+
+```yaml values
+duration: 300ms (snap-back)
+easing: spring(damping increases near boundary)
+element-class: page
+interruptible: required
+budget: { page: 200-400ms }
+```

package/data/harnesses/code/skills/design/data/motion/skeleton-shimmer.md

@@ -0,0 +1,18 @@
+---
+id: skeleton-shimmer
+class: a6
+sourced: 2026-07-12
+source: "emilkowalski.skills/skills/animation-vocabulary/SKILL.md (Skeleton/Shimmer) + review-animations/STANDARDS.md (easing decision order — constant motion → linear)"
+license: open
+feel: "a slow, continuous sheen reads like content is genuinely on its way; a fast or jittery shimmer reads anxious"
+aliases: { anxious: "shimmer cycle faster than ~1s, reading twitchy instead of calm", stuck: "a static placeholder with no shimmer at all, giving no sense of progress" }
+---
+Loading placeholders for cards, rows, and detail panes before content resolves. Runs as a continuous ambient loop, exempt from the sub-300ms UI budget (constant-motion class); swap to real content with a quick crossfade, not a hard cut.
+
+```yaml values
+duration: 1400ms (loop)
+easing: linear
+element-class: list-item
+interruptible: n/a
+budget: { list-item: 1200-1600ms }
+```

package/data/harnesses/code/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/code/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/code/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/code/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/code/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/code/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/code/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/code/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/code/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/code/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/code/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/code/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/code/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/code/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/code/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/code/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/code/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/code/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/code/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/code/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/code/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/code/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
+```