@jaimevalasek/aioson 1.5.1 → 1.6.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 (131) hide show
  1. package/README.md +6 -0
  2. package/docs/design-previews/aurora-command-ui-website.html +884 -0
  3. package/docs/design-previews/aurora-command-ui.html +682 -0
  4. package/docs/design-previews/bold-editorial-ui-website.html +658 -0
  5. package/docs/design-previews/bold-editorial-ui.html +717 -0
  6. package/docs/design-previews/clean-saas-ui-website.html +1202 -0
  7. package/docs/design-previews/clean-saas-ui.html +549 -0
  8. package/docs/design-previews/cognitive-core-ui-website.html +1009 -0
  9. package/docs/design-previews/cognitive-core-ui.html +463 -0
  10. package/docs/design-previews/glassmorphism-ui-website.html +572 -0
  11. package/docs/design-previews/glassmorphism-ui.html +886 -0
  12. package/docs/design-previews/index.html +699 -0
  13. package/docs/design-previews/interface-design-website.html +1187 -0
  14. package/docs/design-previews/interface-design.html +513 -0
  15. package/docs/design-previews/neo-brutalist-ui-website.html +621 -0
  16. package/docs/design-previews/neo-brutalist-ui.html +797 -0
  17. package/docs/design-previews/premium-command-center-ui-website.html +1217 -0
  18. package/docs/design-previews/premium-command-center-ui.html +552 -0
  19. package/docs/design-previews/warm-craft-ui-website.html +684 -0
  20. package/docs/design-previews/warm-craft-ui.html +739 -0
  21. package/docs/en/cli-reference.md +20 -9
  22. package/docs/pt/README.md +7 -0
  23. package/docs/pt/agent-sharding.md +132 -0
  24. package/docs/pt/agentes.md +8 -2
  25. package/docs/pt/busca-de-contexto.md +129 -0
  26. package/docs/pt/cache-de-contexto.md +156 -0
  27. package/docs/pt/comandos-cli.md +28 -0
  28. package/docs/pt/design-hybrid-forge.md +107 -0
  29. package/docs/pt/inicio-rapido.md +54 -3
  30. package/docs/pt/inteligencia-adaptativa.md +324 -0
  31. package/docs/pt/monitor-de-contexto.md +104 -0
  32. package/docs/pt/recuperacao-de-sessao.md +125 -0
  33. package/docs/pt/sandbox.md +125 -0
  34. package/docs/pt/skills.md +98 -6
  35. package/package.json +1 -1
  36. package/src/agent-loader.js +280 -0
  37. package/src/cli.js +94 -0
  38. package/src/commands/agent-loader.js +85 -0
  39. package/src/commands/context-cache.js +90 -0
  40. package/src/commands/context-monitor.js +92 -0
  41. package/src/commands/context-search.js +66 -0
  42. package/src/commands/design-hybrid-options.js +385 -0
  43. package/src/commands/health.js +214 -0
  44. package/src/commands/init.js +54 -13
  45. package/src/commands/install.js +52 -13
  46. package/src/commands/learning-evolve.js +355 -0
  47. package/src/commands/live.js +34 -0
  48. package/src/commands/recovery.js +43 -0
  49. package/src/commands/sandbox.js +37 -0
  50. package/src/commands/setup-context.js +22 -2
  51. package/src/commands/setup.js +178 -0
  52. package/src/commands/skill.js +79 -32
  53. package/src/commands/tool-registry-cmd.js +232 -0
  54. package/src/commands/update.js +7 -0
  55. package/src/constants.js +9 -0
  56. package/src/context-cache.js +159 -0
  57. package/src/context-search.js +326 -0
  58. package/src/design-variation-catalog.js +503 -0
  59. package/src/i18n/messages/en.js +32 -2
  60. package/src/i18n/messages/es.js +30 -2
  61. package/src/i18n/messages/fr.js +30 -2
  62. package/src/i18n/messages/pt-BR.js +32 -2
  63. package/src/install-animation.js +260 -0
  64. package/src/install-profile.js +143 -0
  65. package/src/install-wizard.js +474 -0
  66. package/src/installer.js +38 -10
  67. package/src/parser.js +7 -1
  68. package/src/recovery-context-session.js +154 -0
  69. package/src/runtime-store.js +97 -1
  70. package/src/sandbox.js +177 -0
  71. package/src/tool-executor.js +94 -0
  72. package/src/updater.js +11 -3
  73. package/template/.aioson/agents/analyst.md +58 -3
  74. package/template/.aioson/agents/architect.md +38 -0
  75. package/template/.aioson/agents/design-hybrid-forge.md +127 -0
  76. package/template/.aioson/agents/dev.md +103 -0
  77. package/template/.aioson/agents/deyvin.md +57 -0
  78. package/template/.aioson/agents/pm.md +58 -0
  79. package/template/.aioson/agents/product.md +28 -0
  80. package/template/.aioson/agents/qa.md +79 -0
  81. package/template/.aioson/agents/setup.md +65 -3
  82. package/template/.aioson/agents/sheldon.md +107 -6
  83. package/template/.aioson/agents/tester.md +156 -0
  84. package/template/.aioson/config.md +15 -0
  85. package/template/.aioson/context/forensics/.gitkeep +0 -0
  86. package/template/.aioson/context/seeds/seed-example.md +27 -0
  87. package/template/.aioson/context/user-profile.md +42 -0
  88. package/template/.aioson/locales/en/agents/setup.md +33 -1
  89. package/template/.aioson/locales/es/agents/setup.md +33 -1
  90. package/template/.aioson/locales/fr/agents/setup.md +33 -1
  91. package/template/.aioson/locales/pt-BR/agents/setup.md +33 -1
  92. package/template/.aioson/skills/design/aurora-command-ui/SKILL.md +243 -0
  93. package/template/.aioson/skills/design/aurora-command-ui/references/art-direction.md +293 -0
  94. package/template/.aioson/skills/design/aurora-command-ui/references/components.md +827 -0
  95. package/template/.aioson/skills/design/aurora-command-ui/references/dashboards.md +250 -0
  96. package/template/.aioson/skills/design/aurora-command-ui/references/design-tokens.md +585 -0
  97. package/template/.aioson/skills/design/aurora-command-ui/references/motion.md +365 -0
  98. package/template/.aioson/skills/design/aurora-command-ui/references/patterns.md +482 -0
  99. package/template/.aioson/skills/design/aurora-command-ui/references/websites.md +387 -0
  100. package/template/.aioson/skills/design/glassmorphism-ui/SKILL.md +222 -0
  101. package/template/.aioson/skills/design/glassmorphism-ui/references/art-direction.md +159 -0
  102. package/template/.aioson/skills/design/glassmorphism-ui/references/components.md +498 -0
  103. package/template/.aioson/skills/design/glassmorphism-ui/references/dashboards.md +236 -0
  104. package/template/.aioson/skills/design/glassmorphism-ui/references/design-tokens.md +274 -0
  105. package/template/.aioson/skills/design/glassmorphism-ui/references/motion.md +355 -0
  106. package/template/.aioson/skills/design/glassmorphism-ui/references/patterns.md +198 -0
  107. package/template/.aioson/skills/design/glassmorphism-ui/references/websites.md +307 -0
  108. package/template/.aioson/skills/design/neo-brutalist-ui/SKILL.md +213 -0
  109. package/template/.aioson/skills/design/neo-brutalist-ui/references/art-direction.md +228 -0
  110. package/template/.aioson/skills/design/neo-brutalist-ui/references/components.md +855 -0
  111. package/template/.aioson/skills/design/neo-brutalist-ui/references/dashboards.md +334 -0
  112. package/template/.aioson/skills/design/neo-brutalist-ui/references/design-tokens.md +342 -0
  113. package/template/.aioson/skills/design/neo-brutalist-ui/references/motion.md +286 -0
  114. package/template/.aioson/skills/design/neo-brutalist-ui/references/patterns.md +458 -0
  115. package/template/.aioson/skills/design/neo-brutalist-ui/references/websites.md +723 -0
  116. package/template/.aioson/skills/process/aioson-spec-driven/SKILL.md +45 -0
  117. package/template/.aioson/skills/process/aioson-spec-driven/references/approval-gates.md +109 -0
  118. package/template/.aioson/skills/process/aioson-spec-driven/references/artifact-map.md +44 -0
  119. package/template/.aioson/skills/process/aioson-spec-driven/references/classification-map.md +37 -0
  120. package/template/.aioson/skills/process/aioson-spec-driven/references/hardening-lane.md +49 -0
  121. package/template/.aioson/skills/process/aioson-spec-driven/references/maintenance-and-state.md +66 -0
  122. package/template/.aioson/skills/process/aioson-spec-driven/references/ui-language.md +75 -0
  123. package/template/.aioson/skills/process/design-hybrid-forge/SKILL.md +144 -0
  124. package/template/.aioson/skills/process/design-hybrid-forge/references/crossover-protocol.md +221 -0
  125. package/template/.aioson/skills/process/design-hybrid-forge/references/naming-registry.md +88 -0
  126. package/template/.aioson/skills/process/design-hybrid-forge/references/output-contract.md +291 -0
  127. package/template/.aioson/skills/process/design-hybrid-forge/references/pair-compatibility.md +117 -0
  128. package/template/.aioson/skills/process/design-hybrid-forge/references/quality-gates.md +188 -0
  129. package/template/.aioson/skills/process/design-hybrid-forge/references/variation-library.md +125 -0
  130. package/template/AGENTS.md +23 -1
  131. package/template/CLAUDE.md +1 -0
@@ -31,7 +31,15 @@ Comportamento obrigatorio para projetos existentes com contexto inconsistente:
31
31
  NAO refazer o onboarding completo a menos que o usuario solicite explicitamente ou que a ambiguidade restante realmente exija respostas de onboarding.
32
32
 
33
33
  **Primeiro acesso (arquivo nao existe):**
34
- Prosseguir com a deteccao e onboarding completo abaixo.
34
+ Verificar se o template AIOSON esta instalado (diretorio `.aioson/` existe). Se o template nao estiver instalado, orientar o usuario a executar o comando de setup:
35
+
36
+ ```bash
37
+ npx @jaimevalasek/aioson setup .
38
+ ```
39
+
40
+ Este unico comando instala o template, detecta automaticamente o framework, infere o idioma do sistema e gera um `project.context.md` inicial. Apos executar, o usuario ativa `@setup` para confirmar ou ajustar o contexto gerado.
41
+
42
+ Se o template ja estiver instalado mas `project.context.md` nao existir, prosseguir com a deteccao e onboarding completo abaixo.
35
43
 
36
44
  ## Sequencia obrigatoria
37
45
  1. **Verificacao de entrada** (acima) — exibir resumo se project.context.md existir e estiver valido; fazer auto-reparo primeiro se existir mas estiver inconsistente; fluxo completo caso nao exista.
@@ -95,6 +103,30 @@ Se o framework nao for detectado:
95
103
 
96
104
  ## Onboarding por perfil
97
105
 
106
+ ### Etapa 0 — Varrer o workspace antes de qualquer pergunta
107
+
108
+ Antes de qualquer pergunta, executar:
109
+ ```bash
110
+ aioson setup:context . --defaults --json
111
+ ```
112
+
113
+ Isso retorna os valores auto-inferidos (framework, idioma do sistema, nome do projeto pelo diretorio, classificacao). Mostrar ao usuario como bloco de confirmacao:
114
+
115
+ > **Auto-detectado:**
116
+ > - Nome: `{projectName}` (do diretorio)
117
+ > - Framework: `{framework}` (detectado no workspace: `{frameworkInstalled}`)
118
+ > - Tipo: `{projectType}` (inferido do framework)
119
+ > - Classificacao: `{classification}` (pontuacao automatica)
120
+ > - Idioma: `{conversationLanguage}` (do locale do sistema)
121
+ >
122
+ > "Esta correto? Me diga o que mudar ou confirme para continuar."
123
+
124
+ Aguardar a resposta. Aplicar as correcoes como flags explicitas `--option=value` ao chamar o comando final `aioson setup:context` na Etapa 6.
125
+
126
+ Se `aioson` nao estiver disponivel (modo direto sem CLI), pular esta etapa e ir direto para a Etapa 1 com inferencia manual do workspace.
127
+
128
+ > **Observacao:** Se o usuario ja executou `aioson setup .` antes de ativar este agente, `project.context.md` ja foi gerado com os valores auto-detectados. Nesse caso, tratar a Etapa 0 como passagem de confirmacao — mostrar o contexto existente e perguntar apenas o que precisa ser corrigido.
129
+
98
130
  ### Etapa 1 — Entender o projeto
99
131
  Fazer UMA pergunta aberta. Nao mostrar formulario:
100
132
  > "Descreva o projeto em uma ou duas frases — o que faz e para quem e?"
@@ -0,0 +1,243 @@
1
+ ---
2
+ name: aurora-command-ui
3
+ description: Aurora Command UI is a hybrid design system fusing command-center structure with dark glass surfaces over a mandatory aurora gradient substrate. Use it when `design_skill: aurora-command-ui` is set in project.context.md OR when the user explicitly asks for "aurora command", "dark glass dashboard", "glass command center", "aurora dark UI", "teal violet glass", "dark frosted panels", "aurora infra dashboard", or similar. Ideal for SOC platforms, AI tools, security dashboards, dev platforms, CRM with presence, and any product where operational authority and visual depth must coexist. Dark by default with a light aurora option. Do NOT use this skill unless explicitly selected.
4
+ ---
5
+
6
+ # Aurora Command UI
7
+
8
+ Aurora Command UI lives at the intersection of **military-grade data command center** and **layered glass depth**. It is built from the structural DNA of Cognitive Core (mono rails, dense stat numbers, section zones, command shell) fused with the glass substrate engine of Glassmorphism (backdrop-filter surfaces, aurora gradient, luminous borders, ::before reflections).
9
+
10
+ The result: a dark glass shell where every panel reveals the aurora gradient underneath, operational data reads with precision, and the interface feels simultaneously tactical and premium.
11
+
12
+ **This is one visual system.** Never combine it with another design skill.
13
+
14
+ ## Package structure
15
+
16
+ ```text
17
+ .aioson/skills/design/aurora-command-ui/
18
+ SKILL.md ← you are here (load this first)
19
+ references/
20
+ art-direction.md ← intent, 5 expression modes, signature library, anti-generic tests
21
+ design-tokens.md ← CSS variables dark + light, glass tokens, typography, spacing, shadows
22
+ components.md ← 22+ components (glass variants + command structure)
23
+ patterns.md ← Page layouts: aurora app shell, dashboard, detail, settings, auth, list-detail
24
+ dashboards.md ← 5 dashboard presets + chart palette + glass panel rules
25
+ websites.md ← Aurora landing page patterns, hero variants, section patterns
26
+ motion.md ← Animations: glass entrances, aurora-aware motion, command transitions
27
+ ```
28
+
29
+ ## Activation rules
30
+
31
+ - Apply this package **only** when `project.context.md` contains `design_skill: "aurora-command-ui"` or the user explicitly chooses it.
32
+ - If another design skill is selected, do **not** load this package.
33
+ - Never auto-select this skill — always require explicit confirmation.
34
+ - If no skill is set yet, the active agent must ask or confirm before applying.
35
+
36
+ ## Responsibility boundary
37
+
38
+ This skill defines:
39
+ - Visual direction and aesthetic DNA (dark glass over aurora gradient, command structure)
40
+ - Design tokens (glass surfaces, accent fusion, shadows, typography, spacing, radius)
41
+ - Component vocabulary and anatomy (22+ components — glass shell + command mono rails)
42
+ - Page composition patterns (aurora substrate → glass shell → glass panels → mono section rails → content)
43
+ - Theme switching behavior (dark default / light aurora option)
44
+
45
+ This skill does **not** decide:
46
+ - Stack (React, Vue, Blade, HTML, etc.)
47
+ - Output format (single file, multi-file, CSS modules, Tailwind, etc.)
48
+ - Icon library choice
49
+ - Whether a theme toggle exists in the product (the agent decides)
50
+ - Animation library (CSS or JS — motion.md is stack-agnostic)
51
+
52
+ ## Loading guide
53
+
54
+ Always load only what the current task needs:
55
+
56
+ | Task | Load |
57
+ |---|---|
58
+ | Any UI work | `references/design-tokens.md` |
59
+ | Reusable components | `references/design-tokens.md` + `references/components.md` |
60
+ | Dashboard or admin panel | `references/art-direction.md` + `references/design-tokens.md` + `references/components.md` + `references/patterns.md` + `references/dashboards.md` |
61
+ | Detail / profile page | `references/art-direction.md` + `references/design-tokens.md` + `references/components.md` + `references/patterns.md` |
62
+ | Landing page or website | `references/art-direction.md` + `references/design-tokens.md` + `references/components.md` + `references/websites.md` |
63
+ | Motion / animation | add `references/motion.md` when animation materially improves the result |
64
+ | Full UI build | all seven reference files |
65
+
66
+ ## Visual signature — three pillars
67
+
68
+ 1. **Aurora depth** — A dark aurora gradient (`linear-gradient(135deg, #060910 0%, #0A0818 30%, #060C1A 70%, #08060F 100%)`) is the mandatory substrate. Dark glass panels (`rgba(10,14,26,0.65)` with `backdrop-filter`) float over it, revealing the aurora below. The gradient is not decoration — it is structurally required. Remove it and the glass has nothing to reveal.
69
+ 2. **Command authority** — Mono uppercase rails on every section. Dense stat numbers. Compact density that communicates operational mastery. The information structure feels like a mission control panel: labeled zones, one focal block per viewport, restrained accent usage.
70
+ 3. **Teal-violet fusion** — A single accent gradient `linear-gradient(135deg, #00C8E8, #7C3AED)` used on CTAs, active states, stat numbers, borders, and glow shadows. Teal-electric (`#00C8E8`) is the operational signal. Violet (`#7C3AED`) is the highlight and CTA. They only appear as a gradient pair — never in isolation except for semantic purposes.
71
+
72
+ ## Hybrid DNA
73
+
74
+ **From cognitive-core-ui (structure side):**
75
+ - Command center shell with mono section rails
76
+ - Dense stat numbers (text-4xl, tabular-nums)
77
+ - Top bar + sidebar + tab navigation structure
78
+ - Compact density system for dashboards and admin
79
+ - Section headers with mono labels and icon rails
80
+ - Sidebar active item: border-left 3px accent + elevated surface
81
+
82
+ **From glassmorphism-ui (glass side):**
83
+ - `backdrop-filter: blur()` on all major surfaces
84
+ - Aurora gradient substrate — mandatory, not decorative
85
+ - Luminous borders: `rgba(255,255,255,0.10)` on dark glass
86
+ - Top reflection `::before` on every glass card
87
+ - `@supports (backdrop-filter: blur(1px))` fallback always required
88
+ - Glass levels: shell → surface → elevated (3 distinct opacity layers)
89
+
90
+ **New in aurora-command-ui (hybrid elements):**
91
+ - Dark tinted glass: panels use `rgba(10,14,26,0.65)` — NOT white-transparent. The aurora shows through dark glass, not bright glass.
92
+ - Accent gradient on stat numbers, not just CTAs
93
+ - Teal-electric glow shadows: `0 0 30px rgba(0,200,232,0.12)`
94
+ - Aurora glow behind hero metric panels: `radial-gradient(circle at 50% 0%, rgba(0,200,232,0.08), transparent 70%)`
95
+
96
+ ## Theme system
97
+
98
+ ```html
99
+ <div data-theme="dark"> <!-- or data-theme="light" -->
100
+ ```
101
+
102
+ - **Dark (default)**: All operational products — dashboards, monitoring, security, AI tools, dev platforms. The aurora gradient is deep navy + deep violet. Glass is dark tinted.
103
+ - **Light**: Client-facing apps, institutional variants, content-heavy pages. The aurora gradient is soft lavender-gray. Glass is white tinted.
104
+
105
+ If the user does not specify: default to **dark with a theme toggle** in the top bar.
106
+
107
+ ## Visual DNA — dark theme
108
+
109
+ ### Aurora substrate (mandatory)
110
+ ```css
111
+ background: linear-gradient(135deg, #060910 0%, #0A0818 30%, #060C1A 70%, #08060F 100%);
112
+ background-attachment: fixed;
113
+ ```
114
+
115
+ ### Dark glass surfaces
116
+ - Shell (sidebar, top bar): `rgba(8, 12, 22, 0.75)` + `backdrop-filter: blur(24px)`
117
+ - Surface cards: `rgba(10, 14, 26, 0.65)` + `backdrop-filter: blur(16px)`
118
+ - Elevated (hover, nested): `rgba(14, 20, 36, 0.75)` + `backdrop-filter: blur(16px)`
119
+
120
+ ### Accents
121
+ - Teal-electric: `#00C8E8` (operational signals, active states, glow)
122
+ - Violet: `#7C3AED` (CTAs, highlights, gradient endpoint)
123
+ - Accent gradient: `linear-gradient(135deg, #00C8E8, #7C3AED)`
124
+ - Glow shadow: `0 0 30px rgba(0,200,232,0.12), 0 8px 24px rgba(0,0,0,0.40)`
125
+
126
+ ### Typography
127
+ - Headings: `Inter`, weight 700, `letter-spacing: -0.02em`
128
+ - Body: `Inter`, weight 400, `line-height: 1.6`
129
+ - Mono rails: `JetBrains Mono`, weight 600, uppercase, `letter-spacing: 0.12em`, `font-size: 0.675rem`
130
+ - Stats: `Inter`, weight 700, `font-size: var(--text-4xl)`, gradient text on hero metric
131
+
132
+ ## Layout structure (aurora app shell)
133
+
134
+ ```
135
+ ┌─────────────────────────────────────────────────────────────────┐
136
+ │ AURORA GRADIENT BACKGROUND (substrate, fixed) │
137
+ │ ┌──────────────────────────────────────────────────────────┐ │
138
+ │ │ GLASS TOP BAR — backdrop-blur-lg, glass-shell │ │
139
+ │ │ [Logo] ─── [Tab Nav Center] ─── [Actions + Toggle] │ │
140
+ │ ├─────────────────┬────────────────────────────────────────┤ │
141
+ │ │ GLASS SIDEBAR │ CONTENT AREA │ │
142
+ │ │ 200-220px │ [MONO SECTION HEADER] │ │
143
+ │ │ backdrop-blur │ [GLASS STAT CARDS — aurora showing] │ │
144
+ │ │ glass-shell │ [GLASS DATA TABLE] │ │
145
+ │ │ glass-border │ [GLASS CHART CONTAINER] │ │
146
+ │ │ aurora visible │ │ │
147
+ │ │ │ │ │
148
+ │ └─────────────────┴────────────────────────────────────────┘ │
149
+ └─────────────────────────────────────────────────────────────────┘
150
+ ```
151
+
152
+ ### Signature details
153
+ - Glass cards always have `::before` top reflection: `linear-gradient(180deg, rgba(255,255,255,0.07) 0%, transparent 50%)`
154
+ - Teal-electric bottom border on active tabs: `3px solid #00C8E8`
155
+ - Sidebar active item: `border-left: 3px solid var(--accent-primary)` + `background: var(--glass-elevated)`
156
+ - Mono section headers always precede content zones
157
+ - Hero stat card: gradient text on main number (`background: var(--accent-gradient); -webkit-background-clip: text`)
158
+ - Every glass container uses `@supports (backdrop-filter: blur(1px))` fallback
159
+
160
+ ## Application rules
161
+
162
+ - Treat `references/design-tokens.md` as the source of truth for ALL tokens.
163
+ - Treat `references/art-direction.md` as the source of truth for expression, signature, and anti-generic decisions.
164
+ - The aurora gradient substrate is **non-negotiable** — never place glass panels over a solid background.
165
+ - Dark glass opacity must be enough to reveal the aurora. If panels are too opaque, reduce `rgba` alpha toward 0.55.
166
+ - Limit glass nesting to 3 levels max. Each `backdrop-filter` is a composite layer.
167
+ - Always include `@supports (backdrop-filter: blur(1px))` fallbacks.
168
+ - Mono rails are the structural backbone — use them for section headers, stat labels, and metadata rails ONLY. Do not mono-label paragraphs, nav links, or body copy.
169
+ - The teal-violet gradient is the single accent family. Do not introduce secondary accent colors.
170
+ - Never combine this package with `cognitive-core-ui`, `glassmorphism-ui`, `interface-design`, or any other design skill.
171
+ - Adapt code examples to the active stack. Reference snippets are design specifications, not copy-paste code.
172
+ - Accessibility, responsiveness, and production semantics are the agent's responsibility (not this skill).
173
+
174
+ ## Intent before visuals
175
+
176
+ Before choosing layout, answer all three:
177
+
178
+ 1. Who is the human using this page right now?
179
+ 2. What is the main action or decision they must complete?
180
+ 3. How should this interface feel in concrete words, not generic labels?
181
+
182
+ Bad answers:
183
+ - "for users"
184
+ - "manage data"
185
+ - "dark and cool"
186
+
187
+ Good answers:
188
+ - "security analyst identifying active threats during a live incident"
189
+ - "AI platform admin comparing agent performance across production workloads"
190
+ - "surgical, atmospheric, authoritative — the aurora background communicates depth, the mono rails communicate precision"
191
+
192
+ ## Workflow discipline
193
+
194
+ 1. Confirm the aurora gradient substrate is in place before building any component.
195
+ 2. Choose one expression mode from `references/art-direction.md`.
196
+ 3. Name one signature glass+command move and repeat it intentionally across the page.
197
+ 4. Run the Glass Test: remove `backdrop-filter` from all cards — if the UI looks fine without it, glass is decorative, not structural. Fix: reduce dark glass opacity so the aurora is clearly visible behind panels.
198
+ 5. Build from tokens first, then components, then page composition.
199
+ 6. Validate state parity: default, hover, active, focus, disabled — all glass token transitions.
200
+ 7. Validate contrast: dark glass surfaces must meet WCAG AA. Increase opacity on body text surfaces if needed.
201
+
202
+ ## Non-negotiable quality gates
203
+
204
+ - The aurora gradient substrate is non-negotiable. No gradient = no glass system.
205
+ - Dark glass must reveal the aurora — opacity must stay at or below 0.75. Do not "solidify" panels.
206
+ - Never use saturated neon colors. Teal-electric is at the saturation limit — do not push beyond it.
207
+ - Never nest more than 3 glass layers (performance + visual confusion).
208
+ - Shadows must be tinted with teal-electric, not plain black. `rgba(0,200,232,0.12)` is the glow baseline.
209
+ - Fallback without `backdrop-filter` must be tested: use `rgba(8,12,22,0.95)` solid for dark, `rgba(255,255,255,0.95)` for light.
210
+ - Every page must pass the **Glass Test**: backdrop-blur is structural, aurora is visible behind panels.
211
+ - Every page must pass the **Command Test**: mono rails appear on section headers, stat labels, and metadata only — not overused.
212
+ - Every page must pass the **Depth Test**: squinting reveals at least 3 depth layers (substrate → glass panel → content).
213
+ - Sameness is failure. If the result looks like a default dark admin with blur added, iterate on composition before finishing.
214
+
215
+ ## Positioning vs parent skills
216
+
217
+ | Aspect | aurora-command-ui | cognitive-core-ui | glassmorphism-ui |
218
+ |--------|------------------|-------------------|-----------------|
219
+ | Surfaces | Dark glass (rgba dark tinted) | Solid surfaces (bg-surface) | White glass (rgba light tinted) |
220
+ | Background | Aurora gradient (mandatory) | Solid void/base | Lavender aurora gradient |
221
+ | Accent | Teal-electric + Violet gradient | Teal/cyan only | Violet-blue |
222
+ | Default theme | Dark | Dark | Light |
223
+ | Depth model | Blur layers (dark) | Border/shadow depth | Blur layers (light) |
224
+ | Mono usage | Section rails + stats | Section rails + stats | None (uses plain sans) |
225
+ | Best for | SOC, AI platforms, dev tools | Command centers, SaaS | Fintech, mobile, media |
226
+
227
+ ## Delivery modes
228
+
229
+ ### Greenfield
230
+ 1. Choose expression mode (Eclipse Command, Deep Analytics, Void Editorial, Quantum Workspace, Crystal Intelligence)
231
+ 2. Establish aurora gradient background substrate first
232
+ 3. Load relevant references
233
+ 4. Apply token scope from `design-tokens.md` (glass tokens are the foundation)
234
+ 5. Compose layout from `patterns.md` or `websites.md`
235
+ 6. Build components from `components.md`
236
+
237
+ ### Brownfield
238
+ 1. Audit existing UI before rewriting
239
+ 2. Check if the aurora gradient background can be introduced without breaking existing work
240
+ 3. Map Aurora Command tokens onto the existing component library
241
+ 4. Add glass surfaces progressively: start with top bar + sidebar, then cards
242
+ 5. Consolidate duplicate variants before introducing new ones
243
+ 6. Prefer targeted upgrades over full rewrites unless the user asks for a redesign
@@ -0,0 +1,293 @@
1
+ # Art Direction — Aurora Command UI
2
+
3
+ Read this file for any page-level work where differentiation matters: dashboards, apps, landing pages, detail pages, and major flows.
4
+
5
+ This file exists to stop Aurora Command UI from collapsing into the same "dark blur dashboard" every time. The glass system and command structure stay coherent, but the expression must change with the product, the user, and the dominant task.
6
+
7
+ ---
8
+
9
+ ## Core Rule
10
+
11
+ **Same hybrid system, different expressions.**
12
+
13
+ Keep the Aurora Command DNA:
14
+ - aurora gradient substrate (always — non-negotiable)
15
+ - dark glass surfaces revealing the aurora below
16
+ - teal-electric + violet accent fusion
17
+ - mono section rails (section headers, stat labels, metadata only)
18
+ - command center structural discipline
19
+
20
+ But do **not** keep the exact same layout, stat row, sidebar density, or glass intensity from product to product.
21
+
22
+ ---
23
+
24
+ ## Mandatory Pre-Build Outputs
25
+
26
+ Before designing a full page, produce all of these:
27
+
28
+ 1. **Human**
29
+ The real person using this page right now. Not a persona category — a specific human in a specific moment.
30
+
31
+ 2. **Main action**
32
+ The one decision, action, or question that matters most on this screen.
33
+
34
+ 3. **Felt quality**
35
+ Concrete words such as `surgical`, `atmospheric`, `immersive`, `authoritative`, `precise`, `cold`, `elevated`, `focused`.
36
+ Never use empty labels like `dark and modern`, `clean`, or `glassmorphic`.
37
+
38
+ 4. **Domain vocabulary**
39
+ At least 5 concepts from the product's world.
40
+ Example for security: `threat vector`, `signal`, `incident`, `triage`, `posture`.
41
+ Example for AI platforms: `agent`, `token budget`, `inference`, `pipeline`, `hallucination rate`.
42
+
43
+ 5. **Material world**
44
+ At least 5 tones or materials that belong to that product world.
45
+ Example for infra/ops: deep void black, aurora teal glow, electrical violet pulse, graphite panel, amber alert.
46
+ Example for AI tools: obsidian depth, charged teal, spectral violet, crystalline white, signal amber.
47
+
48
+ 6. **Defaults to avoid**
49
+ Name 3 obvious choices that would make the result generic.
50
+ Example: "blur everything at the same opacity", "four equal KPI cards as the opening statement", "teal glow on every surface equally".
51
+
52
+ 7. **Signature move**
53
+ One memorable glass+command detail that appears in at least 5 places on the page.
54
+ Example: "gradient stat numbers (teal → violet) in the hero metric card, repeated in chart highlights, progress bar fills, active badge text, and the primary CTA."
55
+
56
+ If you cannot produce these seven, you are not ready to compose the page.
57
+
58
+ ---
59
+
60
+ ## Expression Modes
61
+
62
+ Choose **one primary mode** per screen. You may borrow small traits from a secondary mode only after the main expression is clear.
63
+
64
+ ### 1. Eclipse Command
65
+
66
+ **For:** SOC platforms, infra monitoring, security operations, network command centers, incident response tools.
67
+
68
+ **Feel:** cold, surgical, exact, high-trust, atmospheric authority.
69
+
70
+ **User:** security analyst or infra engineer making rapid triage decisions under pressure.
71
+
72
+ **Composition:**
73
+ - Aurora substrate at deep navy-black end of the spectrum
74
+ - Glass panels dense with real-time signals — alert clusters, live metrics, service health maps
75
+ - Mono section rails everywhere — ACTIVE THREATS / SIGNAL FEED / SERVICE STATUS
76
+ - One dominant threat/signal surface above the fold
77
+ - Sidebar is narrow and utilitarian — icon labels, no decorative padding
78
+ - Teal-electric accent for alert signals, status dots, and live indicators
79
+ - Violet accent for severity escalation, CTA actions, and critical alerts
80
+
81
+ **Visual cues:**
82
+ - `--glass-blur-md` (16px) on panels — crisp, not atmospheric
83
+ - Tight vertical rhythm (compact density)
84
+ - Alert tape or live status strip as section opener
85
+ - Mono IDs and timestamps as primary metadata rails
86
+ - Semantic red/amber/green for operational health (never for decoration)
87
+
88
+ **Signature ideas:**
89
+ - Status tape across the top of the main panel showing live signal counts
90
+ - Inset command strip for rapid actions (acknowledge, escalate, assign)
91
+ - Threat heat row with severity-color glass chips
92
+ - Live pulse animation on active threat metrics (glow-pulse at low amplitude)
93
+
94
+ **Blur level:** `--glass-blur-md` (16px) for panels — visibility over atmosphere.
95
+
96
+ ---
97
+
98
+ ### 2. Deep Analytics
99
+
100
+ **For:** BI platforms, data warehouses, revenue analytics, financial intelligence, performance reporting.
101
+
102
+ **Feel:** precise, dense, trustworthy, data-rich, controlled.
103
+
104
+ **User:** analyst or finance director extracting insight from structured data to support a decision.
105
+
106
+ **Composition:**
107
+ - Aurora substrate at the deeper indigo/violet end of the spectrum
108
+ - Glass chart containers are the hero — full-width area charts, donut breakdowns, ranked tables
109
+ - Stat row with gradient numbers as the credibility anchor above charts
110
+ - Sidebar holds dimension filters and saved views — compact glass list
111
+ - Gradient fills in all chart areas (teal → transparent area, violet → transparent for secondary)
112
+ - One dominant trend chart above the fold as the main analytical narrative
113
+
114
+ **Visual cues:**
115
+ - `--glass-blur-md` for chart containers, `--glass-blur-sm` for data rows (visibility)
116
+ - Tabular-nums throughout — numbers must align
117
+ - Chart tooltips as small glass cards (not white boxes)
118
+ - Section headers over every major data zone
119
+ - Gradient accent on the "hero" metric only — not all four stats
120
+
121
+ **Signature ideas:**
122
+ - Metric strip glass bar (one full-width glass strip with 4-5 metrics inline, dividers glass-border)
123
+ - Hero trend chart with gradient fill revealing aurora below
124
+ - Gradient text only on the principal metric (revenue total, pipeline value, key KPI)
125
+ - Chart area fills that echo the aurora gradient — teal to transparent, not flat fill
126
+
127
+ **Blur level:** `--glass-blur-md` (16px) for containers, `--glass-blur-sm` (8px) for rows.
128
+
129
+ ---
130
+
131
+ ### 3. Void Editorial
132
+
133
+ **For:** Dark aurora landing pages, product websites, developer tool marketing, AI company home pages, premium SaaS marketing.
134
+
135
+ **Feel:** atmospheric, premium, intelligent, aspirational, technically credible.
136
+
137
+ **User:** prospect or evaluator scanning for whether this product belongs in their world.
138
+
139
+ **Composition:**
140
+ - Full-viewport aurora hero — gradient pushed toward the deepest end
141
+ - Glass hero card or glass content strip floating over the aurora
142
+ - Asymmetric or split narrative sections — not centered text on every section
143
+ - Gradient text on key headline words
144
+ - Glass feature cards with stagger entrance
145
+ - Mono overlines above hero heading and section titles
146
+ - Proof rail, testimonial glass card, stats strip
147
+
148
+ **Visual cues:**
149
+ - `--glass-blur-lg` (24px) for hero card and featured glass elements
150
+ - More whitespace between sections than dashboards — `var(--space-20)` to `var(--space-24)`
151
+ - Aurora gradient orbs (decorative blobs, absolute positioned, extreme blur) behind the hero
152
+ - Glass nav that becomes more opaque on scroll
153
+ - One gradient CTA button — primary, large, confident
154
+
155
+ **Signature ideas:**
156
+ - Aurora orbs visible behind the glass hero card (4 blobs, deep navy → teal → violet)
157
+ - Gradient text only on the power words in the hero headline
158
+ - Glass proof strip (full-width glass bar with social proof metrics)
159
+ - Product theater frame in a glass card with slight rotation
160
+
161
+ **Blur level:** `--glass-blur-lg` (24px) for hero, `--glass-blur-md` (16px) for feature cards.
162
+
163
+ ---
164
+
165
+ ### 4. Quantum Workspace
166
+
167
+ **For:** AI development platforms, code editors with AI, ML training dashboards, developer workspace tools, API playgrounds.
168
+
169
+ **Feel:** immersive, focused, intelligent, enabling, technically saturated.
170
+
171
+ **User:** developer or ML engineer spending extended time working inside the platform.
172
+
173
+ **Composition:**
174
+ - Aurora substrate as the persistent atmosphere for a full-screen workspace
175
+ - Glass app shell: top bar + glass sidebar + main work surface + right context panel
176
+ - Main work surface dominates — not a grid of cards but a primary editor/output/canvas area
177
+ - Context panels (metrics, logs, agent status) as glass panels flanking the work surface
178
+ - Mono labels for context rails: MODEL / TOKENS / LATENCY / PIPELINE STEP
179
+ - Violet accent for model selection and primary actions; teal for runtime signals and live status
180
+
181
+ **Visual cues:**
182
+ - `--glass-blur-sm` (8px) for non-primary panels (performance — this is a working environment)
183
+ - `--glass-blur-md` (16px) for sidebar and top bar
184
+ - Compact density throughout — this is not a marketing dashboard
185
+ - Code/mono typography for output areas and configuration rails
186
+ - Gradient only on active model indicator and primary CTA
187
+
188
+ **Signature ideas:**
189
+ - Token budget progress bar (teal fill, width animates as tokens consumed)
190
+ - Live inference latency gauge as a glass instrument panel chip
191
+ - Active pipeline step indicator: mono step number + teal border on active step card
192
+ - Status ribbon: RUNNING / IDLE / ERROR / QUEUED — teal/amber/red/gray chips in a glass strip
193
+
194
+ **Blur level:** `--glass-blur-sm` (8px) primary panels, `--glass-blur-md` (16px) shell elements.
195
+
196
+ ---
197
+
198
+ ### 5. Crystal Intelligence
199
+
200
+ **For:** AI agent CRM, sales intelligence platforms, contact management with AI enrichment, talent intelligence, account management.
201
+
202
+ **Feel:** curated, intelligent, elevated, dimensional, trustworthy.
203
+
204
+ **User:** account manager or analyst working within a rich entity profile — a person, company, or deal.
205
+
206
+ **Composition:**
207
+ - Aurora substrate at moderate depth — not the deepest void, slightly more luminous
208
+ - Profile header glass card as the focal anchor: avatar + name + stat cards + badge chips
209
+ - Tab navigation within the profile — Properties / Activity / Intelligence / History
210
+ - Detail sections as glass cards in a structured 2-column layout
211
+ - DNA/trait panels with progress bars and tag clusters
212
+ - Relation cards (linked entities) as compact glass mini-cards in a grid
213
+
214
+ **Visual cues:**
215
+ - `--glass-blur-md` (16px) for all containers
216
+ - Avatar with glass border (luminous rgba white)
217
+ - Gradient text on the "lead stat" (score, value, rank)
218
+ - Progress bars with teal fill for positive metrics, amber/red for risk
219
+ - Mono section headers: INTELLIGENCE PROFILE / ENGAGEMENT SIGNALS / RELATIONS
220
+
221
+ **Signature ideas:**
222
+ - Profile header glass card with aurora peeking through — identity panel with depth
223
+ - Trait/DNA panel as a visual signature — labeled progress rows with color semantic fills
224
+ - Relation network: compact glass cards in auto-fill grid, each with status badge
225
+ - "Intelligence score" as a circular progress indicator or large gradient stat
226
+
227
+ **Blur level:** `--glass-blur-md` (16px) throughout — consistency reinforces trust.
228
+
229
+ ---
230
+
231
+ ## Signature Library
232
+
233
+ These are immediately available for any Aurora Command composition. Pick at least 2 per screen.
234
+
235
+ | Detail | Usage |
236
+ |--------|-------|
237
+ | Gradient stat numbers (teal → violet) | Hero metrics, KPI cards, principal report numbers |
238
+ | Mono section rail (uppercase, text-xs, tracking-widest) | Every section header, stat label, metadata zone |
239
+ | Top reflection `::before` | Every glass card, modal, sidebar |
240
+ | Teal glow shadow | Active states, featured cards, hero containers |
241
+ | Glass sidebar revealing aurora | App shell, always |
242
+ | Accent gradient on primary CTA | Buttons, key actions, active badges |
243
+ | Status tape above main panel | Ops/monitoring dashboards |
244
+ | Compact alert chip row | Incident feeds, urgency signals |
245
+ | DNA/trait panel with progress rows | Profile pages, entity detail |
246
+ | Aurora orbs behind hero | Landing pages, auth pages |
247
+ | Live pulse on active metric | Real-time dashboards, monitoring |
248
+ | Glass nav deepening on scroll | All website navigation |
249
+
250
+ ---
251
+
252
+ ## Anti-Generic Tests
253
+
254
+ Run all five before presenting the result.
255
+
256
+ ### Aurora Glass Test
257
+ Remove `backdrop-filter: blur()` from all glass panels. If the UI still looks fine without it, glass is decorative — the aurora is not showing through the panels. Fix: reduce dark glass alpha so the aurora gradient is clearly visible behind every major panel. The aurora must be the "floor" the glass rests on, not just a background hidden behind solid panels.
258
+
259
+ ### Command Test
260
+ Remove all mono labels. If the section structure collapses without them, they are load-bearing. If nothing changes, mono was decorative noise — remove the overuse. Mono rails should appear 4-8 times on a typical dashboard page, not on every text element.
261
+
262
+ ### Depth Test
263
+ Squint your eyes. Can you distinguish: (1) the aurora substrate, (2) the glass panels, (3) the content within panels? If everything blurs into the same dark soup, increase the opacity contrast between the aurora background and the glass panels, or increase blur intensity.
264
+
265
+ ### Gradient Test
266
+ Does the accent gradient appear in a meaningful structural place — not just buttons? It should appear in at least: stat numbers (hero metric), one CTA, one active state (tab underline or sidebar indicator), and a chart fill or progress bar. If it only appears on one button, it's a decoration token, not a signature.
267
+
268
+ ### Domain Test
269
+ Hide the product name. Does the page still feel like it belongs to a specific operational world — security, analytics, AI workspace, or sales intelligence? Or does it feel like "dark SaaS with teal"? If domain identity is absent, push the composition to reflect the product's operational vocabulary.
270
+
271
+ ---
272
+
273
+ ## What Makes Each Mode Distinct
274
+
275
+ | | Eclipse Command | Deep Analytics | Void Editorial | Quantum Workspace | Crystal Intelligence |
276
+ |---|---|---|---|---|---|
277
+ | Aurora depth | Deepest void (almost black) | Deep indigo | Deep, atmospheric | Moderate (work surface) | Moderate + luminous |
278
+ | Glass blur | blur-md (crisp) | blur-md / blur-sm | blur-lg (atmospheric) | blur-sm / blur-md | blur-md (consistent) |
279
+ | Opening move | Alert/signal cluster | Hero trend chart | Aurora hero + glass card | Work surface dominates | Profile header card |
280
+ | Mono usage | Dense — all metadata rails | Data labels + stats | Hero overline + sections | Context rails | Section headers |
281
+ | Density | High (compact) | High (data-rich) | Low (marketing) | Medium-high (workspace) | Medium |
282
+ | Signature element | Status tape / live signals | Gradient stat numbers | Aurora orbs + glass hero | Token budget / pipeline steps | DNA trait panel |
283
+
284
+ ---
285
+
286
+ ## Non-Negotiable Expression Rules
287
+
288
+ 1. One aurora depth tone, one expression mode, one signature move per page.
289
+ 2. The teal-violet gradient belongs to the structural vocabulary — not scattered as decoration.
290
+ 3. Mono rails signal operational zone boundaries — overuse destroys the signal.
291
+ 4. The aurora substrate must show through the glass — this is the proof of craft.
292
+ 5. Background atmosphere supports the operational narrative; it does not replace it.
293
+ 6. If the design feels like "dark dashboard with blur filter", push the composition until the aurora and glass relationship is structurally evident.