arkaos 4.29.0 → 4.30.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (127) hide show
  1. package/THE-ARKAOS-GUIDE.md +1 -1
  2. package/VERSION +1 -1
  3. package/config/claude-agents/conversion-strategist.md +1 -1
  4. package/config/claude-agents/extraction-script-writer.md +1 -1
  5. package/config/claude-agents/frontend-dev.md +1 -1
  6. package/config/claude-agents/landing-cro-specialist.md +1 -1
  7. package/config/claude-agents/visual-designer.md +1 -1
  8. package/config/skills-provenance.yaml +17 -3
  9. package/departments/brand/agents/design-ops/extraction-script-writer.yaml +1 -0
  10. package/departments/brand/agents/visual-designer.yaml +1 -0
  11. package/departments/brand/references/uiux-knowledge-and-tools.md +13 -1
  12. package/departments/brand/skills/colors/SKILL.md +9 -1
  13. package/departments/brand/skills/colors/references/hallmark.LICENSE +21 -0
  14. package/departments/brand/skills/colors/references/impeccable.LICENSE +191 -0
  15. package/departments/brand/skills/colors/references/oklch-theme.md +563 -0
  16. package/departments/brand/skills/design-system/SKILL.md +34 -0
  17. package/departments/brand/skills/design-system/references/design-dna-study.md +512 -0
  18. package/departments/brand/skills/design-system/references/design-md-spec.md +454 -0
  19. package/departments/brand/skills/design-system/references/hallmark.LICENSE +21 -0
  20. package/departments/brand/skills/design-system/references/impeccable.LICENSE +191 -0
  21. package/departments/brand/skills/design-system/references/interaction-states.md +306 -0
  22. package/departments/brand/skills/design-system/references/themes/carnival.md +303 -0
  23. package/departments/brand/skills/design-system/references/themes/cobalt.md +148 -0
  24. package/departments/brand/skills/design-system/references/themes/hum.md +405 -0
  25. package/departments/brand/skills/design-system/references/themes/lumen.md +480 -0
  26. package/departments/brand/skills/design-system/references/typography-craft.md +319 -0
  27. package/departments/brand/skills/mockup-generate/SKILL.md +4 -1
  28. package/departments/brand/skills/wireframe/SKILL.md +5 -0
  29. package/departments/dev/agents/frontend-dev.yaml +1 -0
  30. package/departments/dev/skills/animated-website/SKILL.md +10 -0
  31. package/departments/dev/skills/animated-website/references/hallmark.LICENSE +21 -0
  32. package/departments/dev/skills/animated-website/references/impeccable.LICENSE +191 -0
  33. package/departments/dev/skills/animated-website/references/motion-recipes.md +546 -0
  34. package/departments/dev/skills/evaluator-build-loop/SKILL.md +5 -0
  35. package/departments/landing/agents/conversion-strategist.yaml +1 -0
  36. package/departments/landing/agents/cro-specialist.yaml +1 -0
  37. package/departments/landing/skills/landing-gen/SKILL.md +16 -5
  38. package/departments/landing/skills/page-architect/SKILL.md +25 -1
  39. package/departments/landing/skills/page-architect/references/component-cookbook.md +265 -0
  40. package/departments/landing/skills/page-architect/references/components/c1-outlined-chip.md +14 -0
  41. package/departments/landing/skills/page-architect/references/components/c2-inline-form-as-cta.md +19 -0
  42. package/departments/landing/skills/page-architect/references/components/c3-typographic-link.md +11 -0
  43. package/departments/landing/skills/page-architect/references/components/c4-sticky-bottom-bar.md +17 -0
  44. package/departments/landing/skills/page-architect/references/components/f1-bento-grid.md +22 -0
  45. package/departments/landing/skills/page-architect/references/components/f2-sticky-scroll-stack.md +23 -0
  46. package/departments/landing/skills/page-architect/references/components/f3-tabular-spec-sheet.md +14 -0
  47. package/departments/landing/skills/page-architect/references/components/f4-step-sequence.md +14 -0
  48. package/departments/landing/skills/page-architect/references/components/f5-annotated-screenshot.md +14 -0
  49. package/departments/landing/skills/page-architect/references/components/f6-product-card-grid.md +42 -0
  50. package/departments/landing/skills/page-architect/references/components/ft1-mast-headed.md +15 -0
  51. package/departments/landing/skills/page-architect/references/components/ft2-inline-rule-single-line.md +13 -0
  52. package/departments/landing/skills/page-architect/references/components/ft3-index-style-category-list.md +15 -0
  53. package/departments/landing/skills/page-architect/references/components/ft4-dense-typographic.md +13 -0
  54. package/departments/landing/skills/page-architect/references/components/ft5-statement.md +24 -0
  55. package/departments/landing/skills/page-architect/references/components/ft6-letter-close.md +22 -0
  56. package/departments/landing/skills/page-architect/references/components/ft7-newsletter-first.md +30 -0
  57. package/departments/landing/skills/page-architect/references/components/ft8-marquee-scroll.md +26 -0
  58. package/departments/landing/skills/page-architect/references/components/h1-marquee.md +17 -0
  59. package/departments/landing/skills/page-architect/references/components/h2-split-diptych.md +18 -0
  60. package/departments/landing/skills/page-architect/references/components/h3-quote-led.md +14 -0
  61. package/departments/landing/skills/page-architect/references/components/h4-stat-led.md +17 -0
  62. package/departments/landing/skills/page-architect/references/components/h5-letter-hero.md +14 -0
  63. package/departments/landing/skills/page-architect/references/components/h6-photographic-fold.md +19 -0
  64. package/departments/landing/skills/page-architect/references/components/h7-demo-video-clipped-by-viewport-edge.md +30 -0
  65. package/departments/landing/skills/page-architect/references/components/h8-mockup-split-browser-framed.md +26 -0
  66. package/departments/landing/skills/page-architect/references/components/h9-custom-illustration-centerpiece.md +28 -0
  67. package/departments/landing/skills/page-architect/references/components/n1-wordmark-2-links.md +14 -0
  68. package/departments/landing/skills/page-architect/references/components/n10-floating-on-scroll-morph.md +20 -0
  69. package/departments/landing/skills/page-architect/references/components/n11-mega-menu.md +43 -0
  70. package/departments/landing/skills/page-architect/references/components/n12-banner-retract.md +37 -0
  71. package/departments/landing/skills/page-architect/references/components/n13-inline-cmdk-pill.md +42 -0
  72. package/departments/landing/skills/page-architect/references/components/n1b-saas-three-section.md +38 -0
  73. package/departments/landing/skills/page-architect/references/components/n2-floating-chip.md +17 -0
  74. package/departments/landing/skills/page-architect/references/components/n3-side-rail.md +17 -0
  75. package/departments/landing/skills/page-architect/references/components/n4-hidden-behind-k.md +12 -0
  76. package/departments/landing/skills/page-architect/references/components/n5-floating-pill.md +31 -0
  77. package/departments/landing/skills/page-architect/references/components/n6-newspaper-masthead.md +27 -0
  78. package/departments/landing/skills/page-architect/references/components/n7-brutal-slab.md +25 -0
  79. package/departments/landing/skills/page-architect/references/components/n8-terminal-command.md +24 -0
  80. package/departments/landing/skills/page-architect/references/components/n9-edge-aligned-minimal.md +20 -0
  81. package/departments/landing/skills/page-architect/references/components/s1-left-margin-numbered.md +17 -0
  82. package/departments/landing/skills/page-architect/references/components/s2-hanging.md +16 -0
  83. package/departments/landing/skills/page-architect/references/components/s3-sticky-pinned.md +22 -0
  84. package/departments/landing/skills/page-architect/references/components/s4-inline-no-break.md +14 -0
  85. package/departments/landing/skills/page-architect/references/components/s5-bottom-anchored.md +14 -0
  86. package/departments/landing/skills/page-architect/references/components/t1-pull-quote-with-marginalia.md +14 -0
  87. package/departments/landing/skills/page-architect/references/components/t2-logo-wall-hairline.md +22 -0
  88. package/departments/landing/skills/page-architect/references/components/t3-single-huge-quote.md +14 -0
  89. package/departments/landing/skills/page-architect/references/components/t4-numbered-stat-strip.md +15 -0
  90. package/departments/landing/skills/page-architect/references/floating-nav.md +91 -0
  91. package/departments/landing/skills/page-architect/references/hallmark.LICENSE +21 -0
  92. package/departments/landing/skills/page-architect/references/hero-enrichment.md +477 -0
  93. package/departments/landing/skills/page-architect/references/impeccable.LICENSE +191 -0
  94. package/departments/landing/skills/page-architect/references/layout-craft.md +236 -0
  95. package/departments/landing/skills/page-architect/references/macrostructures/01-bento-grid.md +37 -0
  96. package/departments/landing/skills/page-architect/references/macrostructures/02-long-document.md +36 -0
  97. package/departments/landing/skills/page-architect/references/macrostructures/03-marquee-hero.md +33 -0
  98. package/departments/landing/skills/page-architect/references/macrostructures/04-stat-led.md +36 -0
  99. package/departments/landing/skills/page-architect/references/macrostructures/05-workbench.md +34 -0
  100. package/departments/landing/skills/page-architect/references/macrostructures/06-conversational-faq.md +35 -0
  101. package/departments/landing/skills/page-architect/references/macrostructures/07-manifesto.md +34 -0
  102. package/departments/landing/skills/page-architect/references/macrostructures/08-photographic.md +36 -0
  103. package/departments/landing/skills/page-architect/references/macrostructures/09-quote-led.md +34 -0
  104. package/departments/landing/skills/page-architect/references/macrostructures/10-specimen.md +34 -0
  105. package/departments/landing/skills/page-architect/references/macrostructures/11-catalogue.md +25 -0
  106. package/departments/landing/skills/page-architect/references/macrostructures/12-letter.md +25 -0
  107. package/departments/landing/skills/page-architect/references/macrostructures/13-index-first.md +25 -0
  108. package/departments/landing/skills/page-architect/references/macrostructures/14-narrative-workflow.md +25 -0
  109. package/departments/landing/skills/page-architect/references/macrostructures/15-split-studio.md +25 -0
  110. package/departments/landing/skills/page-architect/references/macrostructures/16-feature-stack.md +25 -0
  111. package/departments/landing/skills/page-architect/references/macrostructures/17-type-specimen.md +25 -0
  112. package/departments/landing/skills/page-architect/references/macrostructures/18-portfolio-grid.md +25 -0
  113. package/departments/landing/skills/page-architect/references/macrostructures/19-map-diagram.md +25 -0
  114. package/departments/landing/skills/page-architect/references/macrostructures/20-ecosystem-index.md +25 -0
  115. package/departments/landing/skills/page-architect/references/macrostructures/21-component-playground.md +25 -0
  116. package/departments/landing/skills/page-architect/references/macrostructures.md +91 -0
  117. package/departments/landing/skills/page-architect/references/ui-copy.md +75 -0
  118. package/harness/codex/AGENTS.md +1 -1
  119. package/harness/copilot/copilot-instructions.md +1 -1
  120. package/harness/cursor/rules/arkaos.mdc +2 -2
  121. package/harness/gemini/GEMINI.md +1 -1
  122. package/harness/opencode/AGENTS.md +1 -1
  123. package/harness/zed/.rules +1 -1
  124. package/knowledge/agents-registry-v2.json +9 -4
  125. package/knowledge/skills-manifest.json +10 -4
  126. package/package.json +1 -1
  127. package/pyproject.toml +1 -1
@@ -0,0 +1,480 @@
1
+ # Theme — Lumen
2
+
3
+ > Source: verbatim port of `references/themes/lumen.md` from the **hallmark** skill repo (MIT — see `hallmark.LICENSE` one directory up, in the references root). Sanitized for ArkaOS: diversification-log path under `.arka/design/`, design stamps rendered as `[arka:design-dna]`, exemplar-list cleanup. Upstream cross-references (`site/css/tokens.css`, `site/examples/*`, `custom-theme.md`, `layout-and-space.md`, slop-test gate numbers) name hallmark repo files that are not bundled here and travel as plain text.
4
+
5
+ Premium AI-tool register, built around a **hand-engineered apparatus** rather than a glowing orb. One precision SVG/CSS object per page, with leader-line callouts in mono micro-type, set against dead space alongside a **lowercase classical-serif headline** and a technical mono eyebrow. Three font families. Two palette drops (Night Foundry / Day Foundry) with different physics — Night emits, Day refracts — and entirely different visual languages, not the same shape in two colours.
6
+
7
+ Lumen runs a strict **two-register typography system**: all prose is **lowercase** (hero titles, section titles, lede, body, buttons, nav, brand, footer copy — even acronyms when they appear in body text); all mono labels are **UPPERCASE** (eyebrows, callouts, meter labels, stat labels). The contrast between quiet lowercase prose and loud UPPERCASE machine-readout is the typographic signature.
8
+
9
+ Loaded eagerly by the design-system skill whenever the catalog pick is `lumen`. Palettes + font stack live in `site/css/tokens.css` (upstream hallmark repo — not bundled here) under `[data-theme="lumen"]` (Night, default) and `[data-theme="lumen"][data-drop="day"]` (Day). This file carries the drops + apparatus family + signature moves + motion + anti-patterns.
10
+
11
+ ## Axes (diversification)
12
+
13
+ - **Paper band** — Night: dark cool-violet (`L 13%, H 265`). Day: light cool bone with violet pull (`L 97%, H 265`). The 265° hue is deliberate — sits 25° from Midnight's 250 and 65° from Aurora's 200, so a Lumen page is not confusable with either neighbour at a glance.
14
+ - **Display style** — **classical-serif-lowercase** (Instrument Serif 400, upright, **all-lowercase**, with verb landmark via accent colour + draw-in underline). No italic anywhere. Distinct from italic-serif (Specimen/Studio/Atelier ship italic as default) and from roman-serif (Newsprint uses sentence case). Lumen is the catalog's only lowercase-headline theme.
15
+ - **Accent hue** — Night: **molten brass** (`H 50`, not amber). Day: **deep indigo with violet tilt** (`H 268`). Coral chord (`H 18`) sits behind both as the secondary chromatic.
16
+
17
+ ## Reference register
18
+
19
+ Modal · Anthropic (Claude product surfaces) · ElevenLabs · Cluely · Adept · Granola · Cohere · Inflection · Linear (premium pricing pages) · Vercel (design guidelines, frontier-AI sections) · Cursor (high-fidelity product mockup heroes).
20
+
21
+ The aesthetic to match: a single hand-engineered artefact in dead space; a lowercase classical-serif headline with one accent-coloured verb; mono UPPERCASE technical labels that read as if pulled from an internal docs site; tabular numerals everywhere a number appears. The combination is what AI-tool defaults do not ship — and exactly the combination that breaks every default the model was trained on.
22
+
23
+ **Patron-saint reference (internal):** *Modal homepage rate sheet* (the receipt is the artwork) + *an annotated hero apparatus diagram* (leader lines + labelled callouts) + *Anthropic Claude landing typography* (transitional serif + humanist sans). When in doubt about restraint, ask "would Modal ship this much chrome?" If yes, you've gone too far.
24
+
25
+ ## Palette drops
26
+
27
+ A Lumen drop is a named palette + apparatus-physics pair. The structural signature (italic-pivot headline + mono eyebrow + apparatus + leader callouts + meter strip + blueprint grid + hairline cards + three-stat row) is constant; the drop rotates the canvas, the accent, and what the apparatus *does*.
28
+
29
+ ### Drop 01 · Night Foundry *(default · canonical)*
30
+
31
+ Cool-violet near-black canvas. Molten-brass accent that *emits*. The apparatus is an instrument — a filament-in-chamber, a circuit topology, a precision indicator — and it generates the light. Halos and inner-emit washes use `--color-glow` at 42% opacity.
32
+
33
+ - `--color-paper: oklch(13% 0.014 265)` — late-night studio, violet tilt
34
+ - `--color-ink: oklch(96% 0.006 262)` — near-white headlines
35
+ - `--color-accent: oklch(76% 0.17 50)` — molten brass
36
+ - `--color-accent-2: oklch(68% 0.16 18)` — coral chord
37
+ - `--color-glow: oklch(80% 0.16 50 / 0.42)` — dense halo
38
+ - `--color-paper-emit: oklch(76% 0.17 50 / 0.04)` — inner-emit canvas wash
39
+ - `--rule-blueprint: oklch(96% 0.006 262 / 0.04)` — grid hairline
40
+
41
+ **Apparatus physics — emission.** The focal element is a built object (filament, circuit, indicator dial, layered lens stack) that *contains* the light source. Subtle pulse animation (`--dur-pulse: 4s`) suggests the instrument is *running*. Card shadows are soft depth (`0 24px 60px -28px oklch(0% 0 0 / 0.55)`), not glows — the apparatus is the only thing that emits.
42
+
43
+ **When to pick:** inference platforms · serverless GPU · model APIs · AI coding agents · voice synthesis · agentic tools · developer infra · anything that wants to feel "after hours" and "instrument-grade." Default.
44
+
45
+ ### Drop 02 · Day Foundry
46
+
47
+ Cool-bone canvas with a violet pull. Deep indigo accent that *refracts*. The apparatus is a transparent prism / lens stack / chromatic dispersion element — light passes through and is *separated*, not generated. Spectrum exit-fan + measurement annotations + scale bar give it the feel of a calibrated optical instrument, not a vibey gradient.
48
+
49
+ - `--color-paper: oklch(97% 0.008 265)` — cool bone, violet pull
50
+ - `--color-ink: oklch(18% 0.014 265)` — near-black, cool
51
+ - `--color-accent: oklch(46% 0.24 268)` — deep violet-indigo
52
+ - `--color-accent-2: oklch(68% 0.16 18)` — coral chord (red end of spectrum)
53
+ - `--color-glow: oklch(58% 0.22 268 / 0.28)` — indigo halo through prism
54
+ - `--color-paper-emit: oklch(46% 0.24 268 / 0.03)` — canvas wash, faint
55
+
56
+ **Apparatus physics — refraction.** The focal element is *static at rest* with a 320ms reveal on first paint (the prism appears, the spectrum fans, both settle). No perpetual motion. The light is captured, not generated. Annotations carry mono micro-labels: `λ = 612 nm`, `θ_out = 38°`, etc. — the prism reads as a *measurement instrument*, not decoration.
57
+
58
+ **When to pick:** AI for science · climate / research labs · document AI · typography / design tools · daytime productivity · briefs that want "considered" and "clear" rather than "after-dark and intense."
59
+
60
+ ### Drop rotation rule
61
+
62
+ The diversification log records `"theme": "lumen", "drop": "night"` (or `"day"`). Two consecutive Lumen builds must use different drops unless the brief contains a strong drop signal.
63
+
64
+ ### Why two drops, not five
65
+
66
+ Lumen's identity is the apparatus, not the palette. Adding more drops would dilute what makes the theme legible. Two drops with *different physics* (emission vs refraction) carry more variety than five drops with the same artefact in different colours.
67
+
68
+ ## The apparatus family
69
+
70
+ Lumen's central commitment: **never a generic glowing orb**. The orb is the most overworked AI-tool tell of 2024–2025; every inference platform ships one. Lumen builds a *specific* hand-engineered object per page, chosen to reflect what the product *does*.
71
+
72
+ The canonical family (pick one per build, in the order of preference for the brief):
73
+
74
+ ### Apparatus type · Filament chamber *(Night Foundry, instrument-grade)*
75
+
76
+ A vertical glowing rod inside a rounded-rect cylindrical chamber, crossed by 3–4 horizontal hairline "electrodes." Subtle pulse on the filament (3% intensity oscillation, 4s period). References vacuum tubes, Tesla coils, fusion experiments, mass spectrometers. Reads as a *machine*.
77
+
78
+ **When to pick:** inference, runtime, model serving, anything that *produces* output. Brand verbs: think, run, generate, infer, render, execute.
79
+
80
+ **SVG/CSS skeleton:**
81
+
82
+ ```html
83
+ <figure class="apparatus apparatus--filament" aria-hidden="true">
84
+ <div class="chamber">
85
+ <span class="chamber__wall"></span>
86
+ <span class="chamber__electrode" style="--y: 22%"></span>
87
+ <span class="chamber__electrode" style="--y: 42%"></span>
88
+ <span class="chamber__electrode" style="--y: 62%"></span>
89
+ <span class="chamber__electrode" style="--y: 82%"></span>
90
+ <span class="chamber__filament"></span>
91
+ <span class="chamber__glow"></span>
92
+ <span class="chamber__stencil">RX-04</span>
93
+ </div>
94
+ <ul class="callouts">
95
+ <li class="callout" style="--side: left; --y: 18%"><span>P50 · 28 ms</span></li>
96
+ <li class="callout" style="--side: right; --y: 36%"><span>cold-start · 0.4 s</span></li>
97
+ <li class="callout" style="--side: left; --y: 62%"><span>rps · 12 k</span></li>
98
+ <li class="callout" style="--side: right; --y: 80%"><span>RX-04 · h100 80gb</span></li>
99
+ </ul>
100
+ </figure>
101
+ ```
102
+
103
+ ```css
104
+ .chamber {
105
+ position: relative; width: clamp(180px, 22vw, 280px); aspect-ratio: 0.55;
106
+ border: 1px solid var(--color-rule-2);
107
+ border-radius: 999px;
108
+ background: oklch(17% 0.016 265 / 0.8);
109
+ overflow: hidden;
110
+ }
111
+ .chamber__filament {
112
+ position: absolute; top: 8%; bottom: 8%; left: 50%;
113
+ width: 2px; margin-left: -1px;
114
+ background: linear-gradient(to bottom,
115
+ oklch(96% 0.05 50) 0%,
116
+ oklch(80% 0.17 50) 50%,
117
+ oklch(96% 0.05 50) 100%);
118
+ box-shadow:
119
+ 0 0 16px 4px var(--color-glow),
120
+ 0 0 48px 12px oklch(80% 0.16 50 / 0.22);
121
+ animation: filament-pulse var(--dur-pulse) ease-in-out infinite;
122
+ }
123
+ .chamber__electrode {
124
+ position: absolute; left: 0; right: 0; top: var(--y);
125
+ height: 1px; background: var(--color-rule-2);
126
+ }
127
+ .chamber__glow {
128
+ position: absolute; inset: 0;
129
+ background: radial-gradient(ellipse 60% 50% at 50% 50%, var(--color-glow-2) 0%, transparent 70%);
130
+ pointer-events: none;
131
+ }
132
+ @keyframes filament-pulse {
133
+ 0%, 100% { opacity: 1; }
134
+ 50% { opacity: 0.86; }
135
+ }
136
+ .callout {
137
+ font-family: var(--font-mono);
138
+ font-size: 10.5px;
139
+ letter-spacing: var(--tracking-micro);
140
+ text-transform: uppercase;
141
+ color: var(--color-muted);
142
+ position: absolute;
143
+ /* leader-line drawn as ::before pseudo */
144
+ }
145
+ .callout::before {
146
+ content: ""; position: absolute;
147
+ top: 50%; height: 1px;
148
+ background: var(--color-rule-2);
149
+ }
150
+ ```
151
+
152
+ ### Apparatus type · Codebase graph / topology *(Night Foundry)*
153
+
154
+ An annotated SVG graph: one central node + 5–7 satellite nodes connected by hairlines, each satellite labelled with a mono filename or symbol. Light "flows" along the connecting lines at a slow walk (subtle gradient dot moving along each path). References CAD schematics, dependency graphs, electrical circuits, knowledge graphs.
155
+
156
+ **When to pick:** AI coding agents, knowledge tools, anything that *traverses* a structured space. Brand verbs: read, trace, explore, connect.
157
+
158
+ ### Apparatus type · Indicator dial / spectrum *(either drop)*
159
+
160
+ A circular dial (Night) or a horizontal spectrum bar with annotated wavelength labels (Day). Includes scale ticks at known increments, a moving needle or active band, and mono callouts at boundaries. References analogue gauges, oscilloscopes, audio meters.
161
+
162
+ **When to pick:** voice synthesis, audio AI, anything measuring a continuous quantity. Brand verbs: tune, measure, listen.
163
+
164
+ ### Apparatus type · Prism + measurement *(Day Foundry canonical)*
165
+
166
+ A clip-path triangle (the prism) + an incoming beam from the left + a chromatic spectrum fan emerging from the right edge + leader-line annotations with wavelength labels and exit-angle measurements. References optical-bench experiments, atmospheric refraction diagrams, the cover of Pink Floyd's *Dark Side of the Moon* re-read as a calibrated instrument.
167
+
168
+ **When to pick:** Day Foundry default. AI for science, climate, research, document AI.
169
+
170
+ ### Building rules across the family
171
+
172
+ - **Pure CSS + SVG.** Never `<img>`, never icon fonts, never SVG paths copied from Figma. The apparatus is *constructed*, not *placed*.
173
+ - **One per page.** Never two apparatus objects on a single Lumen build.
174
+ - **Leader-line callouts.** Every apparatus carries 3–5 mono micro-type annotations (`P50 · 28 ms`, `λ = 612 nm`, `→ refunds.ts`) on horizontal leader lines. The callouts MUST contain real values from the brief — never `LOREM · 000`.
175
+ - **Size.** 240–480 px max dimension on desktop. Scales down to ~180 px on mobile but never disappears.
176
+ - **Pulse, not rotation.** Night apparatus *pulses* (3% intensity oscillation, 4s period). It does *not* rotate. Rotation was the orb's signature; the apparatus's signature is that it's clearly machined.
177
+ - **Day Foundry: no perpetual motion.** Day apparatus reveals once on first paint (320ms) and stays static. The light is captured.
178
+ - **`prefers-reduced-motion: reduce`:** all pulses freeze at maximum intensity, all reveals collapse to final state.
179
+
180
+ ## The seven signature moves
181
+
182
+ A Lumen build must exhibit **all seven**. Skipping any single one is what makes the page slip back into generic-dark-AI territory.
183
+
184
+ ### 1. Hand-built apparatus (no orb)
185
+
186
+ See § The apparatus family above. The single most important move.
187
+
188
+ ### 2. Lowercase headline with verb-landmark (no italics)
189
+
190
+ Classical Instrument Serif at `--text-display`, **all-lowercase, upright**, with **exactly one word** rendered in `--color-accent-2` (coral chord) — and that word is the verb. A 1px underline in the same accent draws in over 320ms on first paint and stays. **No `font-style: italic` is used anywhere** in Lumen — the verb landmark is built from colour + line, not from a glyph variation.
191
+
192
+ ```html
193
+ <h1 class="hero__title">built to&nbsp;<em>think</em>&nbsp;in real time.</h1>
194
+ ```
195
+
196
+ ```css
197
+ .hero__title {
198
+ text-transform: lowercase; /* defensive — also applied at the prose level */
199
+ }
200
+ .hero__title em {
201
+ font-style: normal; /* explicit — em is repurposed as the verb landmark */
202
+ color: var(--color-accent-2);
203
+ position: relative;
204
+ white-space: nowrap;
205
+ }
206
+ .hero__title em::after {
207
+ content: ""; position: absolute;
208
+ left: 0.05em; right: 0.05em; bottom: 0.04em;
209
+ height: 1px;
210
+ background: var(--color-accent-2);
211
+ transform-origin: left;
212
+ animation: pivot-underline 320ms var(--ease-soft) 900ms backwards;
213
+ }
214
+ @keyframes pivot-underline {
215
+ from { transform: scaleX(0); }
216
+ to { transform: scaleX(1); }
217
+ }
218
+ @media (prefers-reduced-motion: reduce) {
219
+ .hero__title em::after { animation: none; }
220
+ }
221
+ ```
222
+
223
+ **Rules:** the coloured word is the verb, never a noun. One word per headline, never two. The underline is the persistent landmark — once drawn, never animates again. `<em>` is repurposed semantically (still emphasis), but renders without italic.
224
+
225
+ ### 3. Mono eyebrow above every section
226
+
227
+ `01 · INFERENCE` style — JetBrains Mono, uppercase, 11px, tracking `0.10em`, half-opacity. Numbered roman ordinal (01, 02, 03), middle-dot separator, then the section role. Sits directly above the heading on its own line. Cap at 6 per page.
228
+
229
+ ### 4. Blueprint grid background (4% opacity)
230
+
231
+ The hero `<section>` and the meter strip both carry a **ruled grid background** at 4% opacity — 32px or 48px square cells, single hairline in `--rule-blueprint`. This is the "engineered, not vibed" signal. Aurora has blooms; Lumen has the grid. The grid sits beneath `--color-paper-emit` so the canvas appears to emit *through* the grid lines.
232
+
233
+ ```css
234
+ .hero {
235
+ background:
236
+ linear-gradient(var(--rule-blueprint) 1px, transparent 1px) 0 0 / 48px 48px,
237
+ linear-gradient(90deg, var(--rule-blueprint) 1px, transparent 1px) 0 0 / 48px 48px,
238
+ radial-gradient(60% 50% at 78% 30%, var(--color-paper-emit) 0%, transparent 65%),
239
+ var(--color-paper);
240
+ }
241
+ ```
242
+
243
+ ### 5. Meter strip (below the hero)
244
+
245
+ A full-bleed 32–48px band beneath the hero showing 60–80 thin vertical ticks (1px wide, varying height/opacity). Mono labels at each end name the readout (`SIGNAL · 12.4 KHZ` left, `DRIFT · 0.04 σ` right). Reads as spectrum analyser / oscilloscope output. The values match the brief — never invented.
246
+
247
+ ```html
248
+ <aside class="meter" aria-label="Signal readout">
249
+ <p class="meter__label meter__label--left">SIGNAL · 12.4 KHZ</p>
250
+ <div class="meter__bars">
251
+ <!-- 64 spans, height + opacity per index -->
252
+ </div>
253
+ <p class="meter__label meter__label--right">DRIFT · 0.04 σ</p>
254
+ </aside>
255
+ ```
256
+
257
+ ```css
258
+ .meter {
259
+ display: grid;
260
+ grid-template-columns: auto 1fr auto;
261
+ gap: 1.5rem;
262
+ align-items: center;
263
+ padding: 0.75rem var(--page-gutter);
264
+ border-block: 1px solid var(--color-rule);
265
+ font-family: var(--font-mono);
266
+ }
267
+ .meter__bars { display: flex; gap: 2px; align-items: end; height: 28px; }
268
+ .meter__bars > span {
269
+ flex: 1; min-width: 1px;
270
+ background: var(--color-accent);
271
+ border-radius: 0.5px;
272
+ }
273
+ ```
274
+
275
+ The meter MUST be procedurally varied — never a flat row of equal ticks. Heights drawn from a clean envelope (sine, gaussian, log) so the strip reads as a *measurement*, not a decorative pattern.
276
+
277
+ ### 6. Hairline cards with inner emission
278
+
279
+ Cards carry a 1px hairline border in `--color-rule` and an inner radial gradient at 4–6% accent opacity — they feel **lit from within**, not dropped. On hover, inner glow brightens to 10–12% and the card lifts 4px. Never drop-shadow cards (the shadow Lumen uses is for elevated chrome only).
280
+
281
+ ### 7. Three-stat row with Instrument Serif numerals + tabular-nums
282
+
283
+ Stats display in Instrument Serif at large size (`clamp(2.5rem, 4vw + 1rem, 4.5rem)`), `font-variant-numeric: tabular-nums`, label in mono uppercase 11px. Hairline vertical dividers. **Always three cells** — never two (reads as comparison), never four (reads as bento). If the brief has fewer than three honest numbers, skip the row entirely.
284
+
285
+ ## Motion direction
286
+
287
+ Lumen's motion stack is **lighter than Hum, heavier than Coral**.
288
+
289
+ | Element | Motion |
290
+ |---|---|
291
+ | Apparatus (Night) | Pulse: 3% intensity oscillation, 4s period. **Never rotates.** |
292
+ | Apparatus (Day) | 320ms reveal on first paint, static thereafter. |
293
+ | Verb landmark | Color set permanently to accent-2; 1px underline draws in 320ms `delay: 900ms`. No font-style change. |
294
+ | Cards | `translateY(-4px)` + inner-glow brighten on hover, 220ms `--ease-soft`. |
295
+ | Section heads | Opacity 0→1 + translateY 12px→0 on view enter, 600ms, 60ms stagger. |
296
+ | Meter strip | Static. No "live" animation — the strip is a printed readout, not a streaming feed. |
297
+ | Scroll | Lenis optional (`duration: 0.7, lerp: 0.08`). |
298
+
299
+ **No magnetic cursors. No bento tile flips. No flashy parallax. No particle systems. No rotating orbs.** If you reach for any of these, you've drifted out of Lumen.
300
+
301
+ `prefers-reduced-motion: reduce` collapses all animations to instant final state.
302
+
303
+ ## Required dependencies
304
+
305
+ ```html
306
+ <link rel="preconnect" href="https://fonts.googleapis.com" />
307
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
308
+ <link href="https://fonts.googleapis.com/css2?family=Instrument+Serif:ital@0;1&family=Geist:wght@400;500;600&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet" />
309
+ ```
310
+
311
+ Three families, three weights each at most. No fourth family.
312
+
313
+ ## Macrostructure affinity
314
+
315
+ **Lumen loves these.**
316
+
317
+ - **Marquee Hero** — canonical: apparatus at hero-right, italic-pivot headline at hero-left, meter strip below
318
+ - **Workbench** — when the page has live product UI to show (used with annotated codebase graph)
319
+ - **Stat-Led** — numbers carry the story (latency, throughput)
320
+ - **Long Document** — technical narrative with the apparatus at hero (Day Foundry canonical)
321
+ - **Specimen** — only when typography is the subject
322
+
323
+ ## Macrostructure rejection
324
+
325
+ **Lumen refuses these.**
326
+
327
+ - **Bento Grid** — too playful; Lumen is one apparatus, not a tile collage
328
+ - **Quote-Led** — too literary
329
+ - **Conversational FAQ** — too soft
330
+ - **Photographic** — Lumen is pure-code; no photographic anchor
331
+ - **Catalogue** — one apparatus, not a grid of products
332
+
333
+ ## Voice fixtures
334
+
335
+ Lumen voice is **direct, technical, slightly aphoristic**. Verbs over nouns. Mono labels read as if from internal docs. No marketing-ese.
336
+
337
+ Headlines — **all lowercase**, with one verb in accent-2 colour (underlined):
338
+
339
+ - "built to **think** in real time."
340
+ - "inference, **rendered**."
341
+ - "a new way to **ship** models."
342
+ - "built for the people who **read** the docs."
343
+ - "models for a **moving** atmosphere."
344
+ - "code that **knows** the codebase."
345
+
346
+ Body patterns — also lowercase, including acronyms:
347
+
348
+ - "p50 latency at 28 ms. p99 at 84. the numbers hold under load."
349
+ - "one primitive. scales down to zero. scales up to a thousand replicas."
350
+ - "three engineers built this in fourteen weeks."
351
+
352
+ Mono eyebrows — UPPERCASE (these are tags, not language):
353
+
354
+ - `00 · INFERENCE`
355
+ - `01 · RUNTIME`
356
+ - `02 · PRICING`
357
+ - `03 · CHANGELOG`
358
+
359
+ Leader-line callouts (real values only) — UPPERCASE:
360
+
361
+ - `P50 · 28 MS`
362
+ - `Λ = 612 NM`
363
+ - `θ_OUT = 38°`
364
+ - `RX-04 · H100 80GB`
365
+ - `INDEXED · 412 FILES`
366
+
367
+ Brand wordmarks — lowercase: `cinder`, `wright`, `stratum`. Legal entity names and person names in fine print also lowercase (`cinder labs, inc.`, `maya okonkwo`). The lowercase commitment is total — only mono labels break it.
368
+
369
+ **Never any of:** experience, journey, elevate, curate, transform, holistic, mindful, ecosystem, platform, leverage, unlock, supercharge, revolutionize, ai-powered, intelligent.
370
+
371
+ ## Anti-patterns (theme-specific)
372
+
373
+ - **NEVER a glowing CSS orb / sphere / ring.** The single most reliable AI-tool tell of 2024–2025. Lumen explicitly refuses it. Pick from the apparatus family or build a new precision object — never a generic ball of light.
374
+ - **NEVER `<img>` for the apparatus.** Pure CSS + SVG. Figma-exported SVG paths fail this — the apparatus is constructed in code.
375
+ - **NEVER sentence-case or title-case prose.** All headlines, lede, body, buttons, nav, captions, brand wordmarks, footer copy, person names, place names, and legal-entity names are lowercase. Mono labels are the ONLY uppercase surface (eyebrows, callouts, meter labels, stat labels). This two-register split is non-negotiable.
376
+ - **NEVER `font-style: italic` anywhere.** The previous italic-pivot signature is retired. The verb landmark is built from colour + a 1px underline, not from a glyph variation. Italic body emphasis, italic founder signatures, italic captions — all banned. `<em>` is repurposed as the verb landmark and renders upright.
377
+ - **Never colour-emphasise a noun.** The verb landmark is the verb. Always.
378
+ - **Never more than one accent-coloured word per headline.** Two is a marketing landing page; one is a design move.
379
+ - **Never invent stats.** If the brief has no real numbers, skip the three-stat row entirely.
380
+ - **Never re-draw browser chrome.** Real screenshots only (design-review slop gate — upstream hallmark gate 47).
381
+ - **Never two apparatus objects on one page.** One per build.
382
+ - **Never a system font for the display.** Instrument Serif or the documented fallback chain (`"Tiempos Headline", ui-serif, Georgia, serif`).
383
+ - **Never rotate the apparatus.** Night apparatus pulses; Day apparatus is static.
384
+ - **Never accent on display text outside the verb landmark.** Headlines are ink colour with one accent-coloured verb.
385
+ - **Never emoji icons in eyebrows.** The mono ordinal + middle-dot + role label IS the eyebrow.
386
+ - **Never two-cell stat rows.** Three only.
387
+ - **Never atmospheric blooms larger than the apparatus.** The grid is the background discipline.
388
+ - **Never blank leader-callouts.** Every annotation carries a real value from the brief.
389
+
390
+ ## Macrostructure pitfalls
391
+
392
+ 1. **Apparatus + embedded chrome on the same side → both fight for the focal point.** Pick one per side. Default: apparatus at hero-right, chrome (if any) in a later section.
393
+ 2. **Italic-pivot word at a line break → the verb hangs alone.** Force `&nbsp;` before and after so it stays mid-line.
394
+ 3. **Stats with two cells → reads as comparison.** Three only.
395
+ 4. **Apparatus glow bleeds into next section → page background looks washed.** Wrap in `overflow: clip` so the halo stays inside the hero.
396
+ 5. **Meter strip with uniform ticks → reads as decorative pattern.** Drive heights from a real envelope (sine, gaussian, log) so the strip looks measured.
397
+ 6. **Card inner-radial > 8% accent opacity → cards read as accent-tinted, not lit.** Cap at 6% rest / 12% hover.
398
+
399
+ ## How Lumen differs from neighbouring themes
400
+
401
+ | vs | difference |
402
+ |---|---|
403
+ | **Midnight** (atmospheric, closest) | Midnight is geometric Geist on cool dark (`H 250`), no apparatus, no italic pivot, no grid. Lumen sits 25° hue away (`H 265`) with classical Instrument Serif, hand-built apparatus + leader callouts, blueprint grid, meter strip. The differentiation is large at every signature axis. |
404
+ | **Aurora** (atmospheric) | Aurora is cool cyan blooms on dark, Sentient serif body. Lumen is brass-on-violet apparatus + Instrument Serif headline. Different temperature, different focal-element philosophy (Aurora: ambient blooms; Lumen: built apparatus). |
405
+ | **Bloom** (atmospheric) | Bloom is warm cream paper, expressive content (Suno/Runway). Lumen is dark or cool-bone, technical content (Modal/Anthropic). Different register entirely. |
406
+ | **Atelier** (editorial) | Atelier is Playfair Display Didone on warm cream — luxury fashion. Lumen's Instrument Serif is a 1960s technical-journal serif. Atelier sells perfume; Lumen sells inference. |
407
+
408
+ ## Test brief expectations
409
+
410
+ Lumen should be a candidate when the brief mentions:
411
+
412
+ - *inference · model · LLM · AI tool · agent · coding agent · voice · synthesis · API · platform · GPU · serverless · runtime · developer experience · DX · the docs · the console · pricing · research lab · atmospheric model · weather · climate*
413
+ - product categories: *AI infrastructure · ML platform · model API · AI dev tool · voice / audio AI · research AI · climate / science AI · agentic coding*
414
+ - emotional tone: *engineered · premium · technical · instrument · after-hours · considered · post-Modal*
415
+
416
+ Briefs that say *bakery / café / atelier / fashion / podcast / record label / hot sauce / agency portfolio* never route to Lumen.
417
+
418
+ ## Build hint
419
+
420
+ The first 22 lines of CSS should establish Lumen's anchor moves:
421
+
422
+ ```css
423
+ body {
424
+ background: var(--color-paper); color: var(--color-ink-2);
425
+ font-family: var(--font-body);
426
+ font-variant-numeric: tabular-nums;
427
+ text-transform: lowercase; /* prose default — the two-register foundation */
428
+ }
429
+
430
+ .eyebrow, .callout, .meter__label, .stat__label, .card__eyebrow {
431
+ font-family: var(--font-label); font-size: 11px; letter-spacing: 0.10em;
432
+ text-transform: uppercase; /* mono labels are the only uppercase surface */
433
+ color: var(--color-ink); opacity: 0.55;
434
+ }
435
+
436
+ .hero__title {
437
+ font-family: var(--font-display); font-weight: 400;
438
+ font-size: var(--text-display); line-height: 1.02;
439
+ letter-spacing: -0.032em; max-width: 16ch;
440
+ }
441
+ .hero__title em {
442
+ font-style: normal; /* italic is RETIRED in Lumen */
443
+ color: var(--color-accent-2);
444
+ position: relative; white-space: nowrap;
445
+ }
446
+
447
+ .hero {
448
+ background:
449
+ linear-gradient(var(--rule-blueprint) 1px, transparent 1px) 0 0 / 48px 48px,
450
+ linear-gradient(90deg, var(--rule-blueprint) 1px, transparent 1px) 0 0 / 48px 48px,
451
+ radial-gradient(60% 50% at 78% 30%, var(--color-paper-emit) 0%, transparent 65%),
452
+ var(--color-paper);
453
+ }
454
+ ```
455
+
456
+ The `text-transform: lowercase` on `<body>` + selective `text-transform: uppercase` on label classes is the typographic foundation. Write your HTML in normal case for accessibility (screen readers); let CSS render the lowercase. Mono labels override back to UPPERCASE.
457
+
458
+ ## What Lumen refuses (restated)
459
+
460
+ Disqualifiers — if any appears in a Lumen build, the build is not Lumen:
461
+
462
+ - No glowing orb / sphere / ring of any kind.
463
+ - No `font-style: italic` anywhere on the page.
464
+ - No sentence-case or title-case prose — headlines, lede, body, buttons, nav, brand are all lowercase.
465
+ - No lowercase mono labels — eyebrows, callouts, meter labels are all UPPERCASE.
466
+ - No bento grids.
467
+ - No glassmorphism / `backdrop-filter` blur.
468
+ - No "trusted by" logo cloud as a full-width band.
469
+ - No three-feature-card row with icon tops.
470
+ - No emoji icons in eyebrows.
471
+ - No invented metrics.
472
+ - No re-drawn browser chrome.
473
+ - No more than one apparatus per page.
474
+ - No more than one accent-coloured word per headline.
475
+ - No system-font fallback for the display.
476
+ - No rotating apparatus (pulse only on Night; static on Day).
477
+ - No accent-coloured display text outside the verb landmark.
478
+ - No two-cell stat rows.
479
+ - No atmospheric blooms larger than the apparatus.
480
+ - No blank leader-line callouts.