tribunal-kit 4.2.0 β 4.3.1
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.
- package/.agent/ARCHITECTURE.md +21 -14
- package/.agent/agents/swarm-worker-contracts.md +5 -5
- package/.agent/agents/ui-ux-auditor.md +292 -0
- package/.agent/rules/GEMINI.md +8 -8
- package/.agent/scripts/__pycache__/_colors.cpython-311.pyc +0 -0
- package/.agent/scripts/__pycache__/_utils.cpython-311.pyc +0 -0
- package/.agent/scripts/__pycache__/case_law_manager.cpython-311.pyc +0 -0
- package/.agent/scripts/_colors.js +18 -0
- package/.agent/scripts/_utils.js +42 -0
- package/.agent/scripts/auto_preview.js +197 -0
- package/.agent/scripts/bundle_analyzer.js +290 -0
- package/.agent/scripts/case_law_manager.js +684 -0
- package/.agent/scripts/checklist.js +266 -0
- package/.agent/scripts/colors.js +17 -0
- package/.agent/scripts/compress_skills.js +141 -0
- package/.agent/scripts/consolidate_skills.js +149 -0
- package/.agent/scripts/context_broker.js +609 -0
- package/.agent/scripts/deep_compress.js +150 -0
- package/.agent/scripts/dependency_analyzer.js +272 -0
- package/.agent/scripts/graph_builder.js +199 -0
- package/.agent/scripts/graph_zoom.js +154 -0
- package/.agent/scripts/inner_loop_validator.js +465 -0
- package/.agent/scripts/lint_runner.js +187 -0
- package/.agent/scripts/minify_context.js +100 -0
- package/.agent/scripts/patch_skills_meta.js +156 -0
- package/.agent/scripts/patch_skills_output.js +244 -0
- package/.agent/scripts/schema_validator.js +297 -0
- package/.agent/scripts/security_scan.js +303 -0
- package/.agent/scripts/session_manager.js +276 -0
- package/.agent/scripts/skill_evolution.js +644 -0
- package/.agent/scripts/skill_integrator.js +313 -0
- package/.agent/scripts/strengthen_skills.js +193 -0
- package/.agent/scripts/strip_tribunal.js +47 -0
- package/.agent/scripts/swarm_dispatcher.js +360 -0
- package/.agent/scripts/test_runner.js +193 -0
- package/.agent/scripts/utils.js +32 -0
- package/.agent/scripts/verify_all.js +256 -0
- package/.agent/skills/agent-organizer/SKILL.md +12 -4
- package/.agent/skills/agentic-patterns/SKILL.md +12 -4
- package/.agent/skills/ai-prompt-injection-defense/SKILL.md +12 -4
- package/.agent/skills/api-patterns/SKILL.md +209 -201
- package/.agent/skills/api-security-auditor/SKILL.md +12 -4
- package/.agent/skills/app-builder/SKILL.md +12 -4
- package/.agent/skills/app-builder/templates/SKILL.md +76 -68
- package/.agent/skills/app-builder/templates/astro-static/TEMPLATE.md +1 -1
- package/.agent/skills/app-builder/templates/chrome-extension/TEMPLATE.md +1 -1
- package/.agent/skills/app-builder/templates/cli-tool/TEMPLATE.md +1 -1
- package/.agent/skills/app-builder/templates/electron-desktop/TEMPLATE.md +1 -1
- package/.agent/skills/app-builder/templates/express-api/TEMPLATE.md +1 -1
- package/.agent/skills/app-builder/templates/flutter-app/TEMPLATE.md +1 -1
- package/.agent/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +1 -1
- package/.agent/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +1 -1
- package/.agent/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +1 -1
- package/.agent/skills/app-builder/templates/nextjs-static/TEMPLATE.md +1 -1
- package/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md +1 -1
- package/.agent/skills/app-builder/templates/python-fastapi/TEMPLATE.md +1 -1
- package/.agent/skills/app-builder/templates/react-native-app/TEMPLATE.md +1 -1
- package/.agent/skills/appflow-wireframe/SKILL.md +12 -4
- package/.agent/skills/architecture/SKILL.md +12 -4
- package/.agent/skills/authentication-best-practices/SKILL.md +12 -4
- package/.agent/skills/bash-linux/SKILL.md +12 -4
- package/.agent/skills/behavioral-modes/SKILL.md +12 -4
- package/.agent/skills/brainstorming/SKILL.md +12 -4
- package/.agent/skills/building-native-ui/SKILL.md +12 -4
- package/.agent/skills/clean-code/SKILL.md +12 -4
- package/.agent/skills/code-review-checklist/SKILL.md +12 -4
- package/.agent/skills/config-validator/SKILL.md +12 -4
- package/.agent/skills/csharp-developer/SKILL.md +12 -4
- package/.agent/skills/data-validation-schemas/SKILL.md +290 -282
- package/.agent/skills/database-design/SKILL.md +202 -194
- package/.agent/skills/deployment-procedures/SKILL.md +12 -4
- package/.agent/skills/devops-engineer/SKILL.md +12 -4
- package/.agent/skills/devops-incident-responder/SKILL.md +12 -4
- package/.agent/skills/doc.md +1 -1
- package/.agent/skills/documentation-templates/SKILL.md +12 -4
- package/.agent/skills/edge-computing/SKILL.md +12 -4
- package/.agent/skills/error-resilience/SKILL.md +390 -382
- package/.agent/skills/extract-design-system/SKILL.md +12 -4
- package/.agent/skills/framer-motion-expert/SKILL.md +206 -199
- package/.agent/skills/frontend-design/SKILL.md +163 -155
- package/.agent/skills/game-design-expert/SKILL.md +12 -4
- package/.agent/skills/game-engineering-expert/SKILL.md +12 -4
- package/.agent/skills/geo-fundamentals/SKILL.md +12 -4
- package/.agent/skills/github-operations/SKILL.md +12 -4
- package/.agent/skills/gsap-core/SKILL.md +54 -48
- package/.agent/skills/gsap-frameworks/SKILL.md +54 -48
- package/.agent/skills/gsap-performance/SKILL.md +54 -48
- package/.agent/skills/gsap-plugins/SKILL.md +54 -48
- package/.agent/skills/gsap-react/SKILL.md +54 -48
- package/.agent/skills/gsap-scrolltrigger/SKILL.md +54 -48
- package/.agent/skills/gsap-timeline/SKILL.md +54 -48
- package/.agent/skills/gsap-utils/SKILL.md +54 -48
- package/.agent/skills/i18n-localization/SKILL.md +12 -4
- package/.agent/skills/intelligent-routing/SKILL.md +41 -33
- package/.agent/skills/knowledge-graph/SKILL.md +36 -0
- package/.agent/skills/lint-and-validate/SKILL.md +12 -4
- package/.agent/skills/llm-engineering/SKILL.md +12 -4
- package/.agent/skills/local-first/SKILL.md +12 -4
- package/.agent/skills/mcp-builder/SKILL.md +12 -4
- package/.agent/skills/mobile-design/SKILL.md +225 -217
- package/.agent/skills/monorepo-management/SKILL.md +296 -288
- package/.agent/skills/motion-engineering/SKILL.md +195 -187
- package/.agent/skills/nextjs-react-expert/SKILL.md +196 -188
- package/.agent/skills/nodejs-best-practices/SKILL.md +12 -4
- package/.agent/skills/observability/SKILL.md +12 -4
- package/.agent/skills/parallel-agents/SKILL.md +12 -4
- package/.agent/skills/performance-profiling/SKILL.md +12 -4
- package/.agent/skills/plan-writing/SKILL.md +12 -4
- package/.agent/skills/platform-engineer/SKILL.md +12 -4
- package/.agent/skills/playwright-best-practices/SKILL.md +12 -4
- package/.agent/skills/powershell-windows/SKILL.md +12 -4
- package/.agent/skills/project-idioms/SKILL.md +12 -4
- package/.agent/skills/python-patterns/SKILL.md +12 -4
- package/.agent/skills/python-pro/SKILL.md +285 -277
- package/.agent/skills/react-specialist/SKILL.md +239 -231
- package/.agent/skills/readme-builder/SKILL.md +12 -4
- package/.agent/skills/realtime-patterns/SKILL.md +12 -4
- package/.agent/skills/red-team-tactics/SKILL.md +12 -4
- package/.agent/skills/rust-pro/SKILL.md +12 -4
- package/.agent/skills/seo-fundamentals/SKILL.md +12 -4
- package/.agent/skills/server-management/SKILL.md +12 -4
- package/.agent/skills/shadcn-ui-expert/SKILL.md +12 -4
- package/.agent/skills/skill-creator/SKILL.md +12 -4
- package/.agent/skills/sql-pro/SKILL.md +12 -4
- package/.agent/skills/supabase-postgres-best-practices/SKILL.md +12 -4
- package/.agent/skills/swiftui-expert/SKILL.md +12 -4
- package/.agent/skills/systematic-debugging/SKILL.md +12 -4
- package/.agent/skills/tailwind-patterns/SKILL.md +12 -4
- package/.agent/skills/tdd-workflow/SKILL.md +12 -4
- package/.agent/skills/test-result-analyzer/SKILL.md +12 -4
- package/.agent/skills/testing-patterns/SKILL.md +12 -4
- package/.agent/skills/trend-researcher/SKILL.md +12 -4
- package/.agent/skills/typescript-advanced/SKILL.md +297 -289
- package/.agent/skills/ui-ux-pro-max/SKILL.md +12 -4
- package/.agent/skills/ui-ux-researcher/SKILL.md +12 -4
- package/.agent/skills/vue-expert/SKILL.md +237 -229
- package/.agent/skills/vulnerability-scanner/SKILL.md +12 -4
- package/.agent/skills/web-accessibility-auditor/SKILL.md +12 -4
- package/.agent/skills/web-design-guidelines/SKILL.md +12 -4
- package/.agent/skills/webapp-testing/SKILL.md +12 -4
- package/.agent/skills/whimsy-injector/SKILL.md +12 -4
- package/.agent/skills/workflow-optimizer/SKILL.md +12 -4
- package/.agent/workflows/audit.md +6 -6
- package/.agent/workflows/deploy.md +1 -1
- package/.agent/workflows/generate.md +23 -6
- package/.agent/workflows/session.md +5 -5
- package/.agent/workflows/swarm.md +2 -2
- package/README.md +242 -186
- package/bin/tribunal-kit.js +297 -57
- package/package.json +81 -77
- package/scripts/changelog.js +167 -0
- package/scripts/sync-version.js +81 -0
- package/scripts/validate-payload.js +73 -0
- package/.agent/scripts/__pycache__/auto_preview.cpython-311.pyc +0 -0
- package/.agent/scripts/__pycache__/bundle_analyzer.cpython-311.pyc +0 -0
- package/.agent/scripts/__pycache__/checklist.cpython-311.pyc +0 -0
- package/.agent/scripts/__pycache__/dependency_analyzer.cpython-311.pyc +0 -0
- package/.agent/scripts/__pycache__/security_scan.cpython-311.pyc +0 -0
- package/.agent/scripts/__pycache__/session_manager.cpython-311.pyc +0 -0
- package/.agent/scripts/__pycache__/skill_integrator.cpython-311.pyc +0 -0
- package/.agent/scripts/__pycache__/swarm_dispatcher.cpython-311.pyc +0 -0
- package/.agent/scripts/__pycache__/test_runner.cpython-311.pyc +0 -0
- package/.agent/scripts/__pycache__/verify_all.cpython-311.pyc +0 -0
- package/.agent/scripts/auto_preview.py +0 -180
- package/.agent/scripts/bundle_analyzer.py +0 -259
- package/.agent/scripts/case_law_manager.py +0 -755
- package/.agent/scripts/checklist.py +0 -209
- package/.agent/scripts/compress_skills.py +0 -167
- package/.agent/scripts/consolidate_skills.py +0 -173
- package/.agent/scripts/deep_compress.py +0 -202
- package/.agent/scripts/dependency_analyzer.py +0 -247
- package/.agent/scripts/lint_runner.py +0 -188
- package/.agent/scripts/minify_context.py +0 -80
- package/.agent/scripts/patch_skills_meta.py +0 -177
- package/.agent/scripts/patch_skills_output.py +0 -285
- package/.agent/scripts/schema_validator.py +0 -279
- package/.agent/scripts/security_scan.py +0 -224
- package/.agent/scripts/session_manager.py +0 -261
- package/.agent/scripts/skill_evolution.py +0 -563
- package/.agent/scripts/skill_integrator.py +0 -234
- package/.agent/scripts/strengthen_skills.py +0 -220
- package/.agent/scripts/strip_tribunal.py +0 -41
- package/.agent/scripts/swarm_dispatcher.py +0 -350
- package/.agent/scripts/test_runner.py +0 -192
- package/.agent/scripts/test_swarm_dispatcher.py +0 -163
- package/.agent/scripts/verify_all.py +0 -195
|
@@ -1,159 +1,159 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: frontend-design
|
|
3
|
-
description: Design thinking for web UI. Micro-interactions, visual hierarchy, typography scaling, HSL color palettes, spacing systems, and CSS-first UI logic. Avoid generic AI aesthetics.
|
|
4
|
-
allowed-tools: Read, Write, Edit, Glob, Grep
|
|
5
|
-
version: 3.1.0
|
|
6
|
-
last-updated: 2026-04-06
|
|
7
|
-
applies-to-model: gemini-3-1-pro, claude-3-7-sonnet
|
|
8
|
-
---
|
|
9
|
-
|
|
10
|
-
# Frontend Design β Dense Reference
|
|
11
|
-
|
|
12
|
-
## Hallucination Traps (Read First)
|
|
13
|
-
- β Purple gradient backgrounds (`from-purple-500 to-blue-500`) β β
The worst AI UI clichΓ©. Use high-contrast solid colors, grain, or sophisticated HSL mono-palettes.
|
|
14
|
-
- β Hardcoded pixels (`font-size: 14px`) β β
Use `rem` for accessibility and scaling (`1rem = 16px`).
|
|
15
|
-
- β Gray text (`#888`) on white β β
Fails WCAG contrast. Text must be `4.5:1` ratio.
|
|
16
|
-
- β Generic sans-serif β β
Inter, Geist, Roboto Mono, or system-ui. Typography is 80% of design.
|
|
17
|
-
- β "Bento Box" grids for everything β β
Overused pattern. Use directional flow or asymmetric layouts.
|
|
18
|
-
- β Symmetrical layouts out of laziness β β
Tension and blank space (negative space) drive premium feel.
|
|
19
|
-
- β Infinite scrolling without context β β
Provide clear footers or logical pagination markers.
|
|
20
|
-
- β Over-animating everything (`all elements fade in`) β β
Animate state changes (hover, focus, submit), not static entry layout unless scrollytelling.
|
|
21
|
-
|
|
22
|
-
---
|
|
23
|
-
|
|
24
|
-
## 1. Color Theory (HSL over HEX)
|
|
25
|
-
|
|
26
|
-
Never use raw flat HEX colors. Use HSL to build cohesive scales.
|
|
27
|
-
|
|
28
|
-
```css
|
|
29
|
-
:root {
|
|
30
|
-
/* HSL allows programmatic adjustment of lightness/saturation */
|
|
31
|
-
--hue: 220;
|
|
32
|
-
--sat: 80%;
|
|
33
|
-
|
|
34
|
-
--bg-base: hsl(var(--hue), 15%, 98%);
|
|
35
|
-
--bg-surface: hsl(var(--hue), 20%, 100%);
|
|
36
|
-
|
|
37
|
-
--text-main: hsl(var(--hue), 40%, 10%);
|
|
38
|
-
--text-muted: hsl(var(--hue), 20%, 40%);
|
|
39
|
-
|
|
40
|
-
--primary: hsl(var(--hue), var(--sat), 50%);
|
|
41
|
-
--primary-hover: hsl(var(--hue), var(--sat), 40%); /* Darken via L */
|
|
42
|
-
}
|
|
43
|
-
|
|
44
|
-
/* OLED Dark Mode */
|
|
45
|
-
@media (prefers-color-scheme: dark) {
|
|
46
|
-
:root {
|
|
47
|
-
--bg-base: hsl(var(--hue), 10%, 2%);
|
|
48
|
-
--bg-surface: hsl(var(--hue), 10%, 6%);
|
|
49
|
-
--text-main: hsl(var(--hue), 20%, 95%);
|
|
50
|
-
--text-muted: hsl(var(--hue), 10%, 60%);
|
|
51
|
-
}
|
|
52
|
-
}
|
|
53
|
-
```
|
|
54
|
-
|
|
55
|
-
## 2. Spatial Systems & Grid Mathematics
|
|
56
|
-
|
|
57
|
-
Design relies on structural rhythm. Use an **8px base system**.
|
|
58
|
-
|
|
59
|
-
- **Micro padding**: `4px`, `8px` (Tags, List items)
|
|
60
|
-
- **Component padding**: `16px`, `24px` (Cards, Inputs, Modals)
|
|
61
|
-
- **Section spacing**: `48px`, `64px`, `96px` (Page sections)
|
|
62
|
-
- **Line height**: Body `1.5`, Headings `1.1` or `1.2`.
|
|
63
|
-
|
|
64
|
-
```css
|
|
65
|
-
/* Fluid Typography (Clamp) */
|
|
66
|
-
h1 {
|
|
67
|
-
/* Min 2rem, fluidly scale between 480px-1200px, Max 4rem */
|
|
68
|
-
font-size: clamp(2rem, 5vw, 4rem);
|
|
69
|
-
letter-spacing: -0.02em; /* Tighten large text */
|
|
70
|
-
}
|
|
71
|
-
|
|
72
|
-
p {
|
|
73
|
-
font-size: 1rem;
|
|
74
|
-
max-width: 65ch; /* Optimal reading length */
|
|
75
|
-
}
|
|
76
|
-
```
|
|
77
|
-
|
|
78
|
-
---
|
|
79
|
-
|
|
80
|
-
## 3. Interaction & "Juice" (Micro-interactions)
|
|
81
|
-
|
|
82
|
-
A premium UI reacts to the user instantly and smoothly. Focus on state transitions.
|
|
83
|
-
|
|
84
|
-
```css
|
|
85
|
-
/* Smooth generic transition */
|
|
86
|
-
.btn {
|
|
87
|
-
transition: all 0.2s cubic-bezier(0.25, 0.46, 0.45, 0.94);
|
|
88
|
-
}
|
|
89
|
-
|
|
90
|
-
/* Active Depth - The physical button push */
|
|
91
|
-
.btn:active {
|
|
92
|
-
transform: scale(0.97);
|
|
93
|
-
}
|
|
94
|
-
|
|
95
|
-
/* Hardware-Accelerated Shadows */
|
|
96
|
-
.card {
|
|
97
|
-
box-shadow: 0 4px 6px -1px rgba(0,0,0, 0.1), 0 2px 4px -1px rgba(0,0,0, 0.06);
|
|
98
|
-
transition: transform 0.3s ease, box-shadow 0.3s ease;
|
|
99
|
-
}
|
|
100
|
-
.card:hover {
|
|
101
|
-
transform: translateY(-4px); /* Float effect */
|
|
102
|
-
box-shadow: 0 20px 25px -5px rgba(0,0,0, 0.1), 0 10px 10px -5px rgba(0,0,0, 0.04);
|
|
103
|
-
}
|
|
104
|
-
```
|
|
105
|
-
|
|
106
|
-
---
|
|
107
|
-
|
|
108
|
-
## 4. Modern Glassmorphism & Depth
|
|
109
|
-
|
|
110
|
-
Flat design is dead. Modern UI uses depth, layering, and blur.
|
|
111
|
-
|
|
112
|
-
```css
|
|
113
|
-
/* Frosted Glass */
|
|
114
|
-
.glass {
|
|
115
|
-
background: rgba(255, 255, 255, 0.7);
|
|
116
|
-
backdrop-filter: blur(16px);
|
|
117
|
-
-webkit-backdrop-filter: blur(16px);
|
|
118
|
-
border: 1px solid rgba(255, 255, 255, 0.2);
|
|
119
|
-
border-radius: 16px;
|
|
120
|
-
}
|
|
121
|
-
```
|
|
122
|
-
|
|
123
|
-
---
|
|
124
|
-
|
|
125
|
-
## 5. Forms and High-Friction UI
|
|
126
|
-
|
|
127
|
-
Forms are where users drop off. They must be flawless.
|
|
128
|
-
|
|
129
|
-
- **Auto-focus** the first input on modal open.
|
|
130
|
-
- **Labels** must be visible outside the input (not just placeholders).
|
|
131
|
-
- **Validation** happens `onBlur` (when leaving), NOT `onChange` (typing).
|
|
132
|
-
- **Submit buttons** show loading spinners, disable inputs, and prevent double-clicks.
|
|
133
|
-
|
|
134
|
-
```css
|
|
135
|
-
/* Focus-visible: Only show ring for keyboard nav, not mouse clicks */
|
|
136
|
-
button:focus-visible {
|
|
137
|
-
outline: 2px solid var(--primary);
|
|
138
|
-
outline-offset: 2px;
|
|
139
|
-
}
|
|
140
|
-
```
|
|
141
|
-
|
|
142
|
-
---
|
|
143
|
-
|
|
144
|
-
## 6. Accessibility (WCAG 2.2 AA)
|
|
145
|
-
|
|
146
|
-
Design is fundamentally broken if it excludes users.
|
|
147
|
-
|
|
148
|
-
- β
Interactive elements need `aria-label` if not visually labeled.
|
|
149
|
-
- β
Custom dropdowns/selects must support Arrow Keys and Escape.
|
|
150
|
-
- β
Color alone cannot convey state (Error text must have an icon too `β Password invalid`).
|
|
151
|
-
- β
Hide decorative SVG/icons from screen readers `aria-hidden="true"`.
|
|
1
|
+
---
|
|
2
|
+
name: frontend-design
|
|
3
|
+
description: Design thinking for web UI. Micro-interactions, visual hierarchy, typography scaling, HSL color palettes, spacing systems, and CSS-first UI logic. Avoid generic AI aesthetics.
|
|
4
|
+
allowed-tools: Read, Write, Edit, Glob, Grep
|
|
5
|
+
version: 3.1.0
|
|
6
|
+
last-updated: 2026-04-06
|
|
7
|
+
applies-to-model: gemini-3-1-pro, claude-3-7-sonnet
|
|
8
|
+
---
|
|
152
9
|
|
|
10
|
+
# Frontend Design β Dense Reference
|
|
11
|
+
|
|
12
|
+
## Hallucination Traps (Read First)
|
|
13
|
+
- β Purple gradient backgrounds (`from-purple-500 to-blue-500`) β β
The worst AI UI clichΓ©. Use high-contrast solid colors, grain, or sophisticated HSL mono-palettes.
|
|
14
|
+
- β Hardcoded pixels (`font-size: 14px`) β β
Use `rem` for accessibility and scaling (`1rem = 16px`).
|
|
15
|
+
- β Gray text (`#888`) on white β β
Fails WCAG contrast. Text must be `4.5:1` ratio.
|
|
16
|
+
- β Generic sans-serif β β
Inter, Geist, Roboto Mono, or system-ui. Typography is 80% of design.
|
|
17
|
+
- β "Bento Box" grids for everything β β
Overused pattern. Use directional flow or asymmetric layouts.
|
|
18
|
+
- β Symmetrical layouts out of laziness β β
Tension and blank space (negative space) drive premium feel.
|
|
19
|
+
- β Infinite scrolling without context β β
Provide clear footers or logical pagination markers.
|
|
20
|
+
- β Over-animating everything (`all elements fade in`) β β
Animate state changes (hover, focus, submit), not static entry layout unless scrollytelling.
|
|
153
21
|
|
|
154
22
|
---
|
|
155
23
|
|
|
156
|
-
##
|
|
24
|
+
## 1. Color Theory (HSL over HEX)
|
|
25
|
+
|
|
26
|
+
Never use raw flat HEX colors. Use HSL to build cohesive scales.
|
|
27
|
+
|
|
28
|
+
```css
|
|
29
|
+
:root {
|
|
30
|
+
/* HSL allows programmatic adjustment of lightness/saturation */
|
|
31
|
+
--hue: 220;
|
|
32
|
+
--sat: 80%;
|
|
33
|
+
|
|
34
|
+
--bg-base: hsl(var(--hue), 15%, 98%);
|
|
35
|
+
--bg-surface: hsl(var(--hue), 20%, 100%);
|
|
36
|
+
|
|
37
|
+
--text-main: hsl(var(--hue), 40%, 10%);
|
|
38
|
+
--text-muted: hsl(var(--hue), 20%, 40%);
|
|
39
|
+
|
|
40
|
+
--primary: hsl(var(--hue), var(--sat), 50%);
|
|
41
|
+
--primary-hover: hsl(var(--hue), var(--sat), 40%); /* Darken via L */
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/* OLED Dark Mode */
|
|
45
|
+
@media (prefers-color-scheme: dark) {
|
|
46
|
+
:root {
|
|
47
|
+
--bg-base: hsl(var(--hue), 10%, 2%);
|
|
48
|
+
--bg-surface: hsl(var(--hue), 10%, 6%);
|
|
49
|
+
--text-main: hsl(var(--hue), 20%, 95%);
|
|
50
|
+
--text-muted: hsl(var(--hue), 10%, 60%);
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
## 2. Spatial Systems & Grid Mathematics
|
|
56
|
+
|
|
57
|
+
Design relies on structural rhythm. Use an **8px base system**.
|
|
58
|
+
|
|
59
|
+
- **Micro padding**: `4px`, `8px` (Tags, List items)
|
|
60
|
+
- **Component padding**: `16px`, `24px` (Cards, Inputs, Modals)
|
|
61
|
+
- **Section spacing**: `48px`, `64px`, `96px` (Page sections)
|
|
62
|
+
- **Line height**: Body `1.5`, Headings `1.1` or `1.2`.
|
|
63
|
+
|
|
64
|
+
```css
|
|
65
|
+
/* Fluid Typography (Clamp) */
|
|
66
|
+
h1 {
|
|
67
|
+
/* Min 2rem, fluidly scale between 480px-1200px, Max 4rem */
|
|
68
|
+
font-size: clamp(2rem, 5vw, 4rem);
|
|
69
|
+
letter-spacing: -0.02em; /* Tighten large text */
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
p {
|
|
73
|
+
font-size: 1rem;
|
|
74
|
+
max-width: 65ch; /* Optimal reading length */
|
|
75
|
+
}
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
---
|
|
79
|
+
|
|
80
|
+
## 3. Interaction & "Juice" (Micro-interactions)
|
|
81
|
+
|
|
82
|
+
A premium UI reacts to the user instantly and smoothly. Focus on state transitions.
|
|
83
|
+
|
|
84
|
+
```css
|
|
85
|
+
/* Smooth generic transition */
|
|
86
|
+
.btn {
|
|
87
|
+
transition: all 0.2s cubic-bezier(0.25, 0.46, 0.45, 0.94);
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
/* Active Depth - The physical button push */
|
|
91
|
+
.btn:active {
|
|
92
|
+
transform: scale(0.97);
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
/* Hardware-Accelerated Shadows */
|
|
96
|
+
.card {
|
|
97
|
+
box-shadow: 0 4px 6px -1px rgba(0,0,0, 0.1), 0 2px 4px -1px rgba(0,0,0, 0.06);
|
|
98
|
+
transition: transform 0.3s ease, box-shadow 0.3s ease;
|
|
99
|
+
}
|
|
100
|
+
.card:hover {
|
|
101
|
+
transform: translateY(-4px); /* Float effect */
|
|
102
|
+
box-shadow: 0 20px 25px -5px rgba(0,0,0, 0.1), 0 10px 10px -5px rgba(0,0,0, 0.04);
|
|
103
|
+
}
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
---
|
|
107
|
+
|
|
108
|
+
## 4. Modern Glassmorphism & Depth
|
|
109
|
+
|
|
110
|
+
Flat design is dead. Modern UI uses depth, layering, and blur.
|
|
111
|
+
|
|
112
|
+
```css
|
|
113
|
+
/* Frosted Glass */
|
|
114
|
+
.glass {
|
|
115
|
+
background: rgba(255, 255, 255, 0.7);
|
|
116
|
+
backdrop-filter: blur(16px);
|
|
117
|
+
-webkit-backdrop-filter: blur(16px);
|
|
118
|
+
border: 1px solid rgba(255, 255, 255, 0.2);
|
|
119
|
+
border-radius: 16px;
|
|
120
|
+
}
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
---
|
|
124
|
+
|
|
125
|
+
## 5. Forms and High-Friction UI
|
|
126
|
+
|
|
127
|
+
Forms are where users drop off. They must be flawless.
|
|
128
|
+
|
|
129
|
+
- **Auto-focus** the first input on modal open.
|
|
130
|
+
- **Labels** must be visible outside the input (not just placeholders).
|
|
131
|
+
- **Validation** happens `onBlur` (when leaving), NOT `onChange` (typing).
|
|
132
|
+
- **Submit buttons** show loading spinners, disable inputs, and prevent double-clicks.
|
|
133
|
+
|
|
134
|
+
```css
|
|
135
|
+
/* Focus-visible: Only show ring for keyboard nav, not mouse clicks */
|
|
136
|
+
button:focus-visible {
|
|
137
|
+
outline: 2px solid var(--primary);
|
|
138
|
+
outline-offset: 2px;
|
|
139
|
+
}
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
---
|
|
143
|
+
|
|
144
|
+
## 6. Accessibility (WCAG 2.2 AA)
|
|
145
|
+
|
|
146
|
+
Design is fundamentally broken if it excludes users.
|
|
147
|
+
|
|
148
|
+
- β
Interactive elements need `aria-label` if not visually labeled.
|
|
149
|
+
- β
Custom dropdowns/selects must support Arrow Keys and Escape.
|
|
150
|
+
- β
Color alone cannot convey state (Error text must have an icon too `β Password invalid`).
|
|
151
|
+
- β
Hide decorative SVG/icons from screen readers `aria-hidden="true"`.
|
|
152
|
+
|
|
153
|
+
|
|
154
|
+
---
|
|
155
|
+
|
|
156
|
+
|
|
157
157
|
|
|
158
158
|
AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
|
|
159
159
|
|
|
@@ -165,7 +165,7 @@ AI coding assistants often fall into specific bad habits when dealing with this
|
|
|
165
165
|
|
|
166
166
|
---
|
|
167
167
|
|
|
168
|
-
|
|
168
|
+
|
|
169
169
|
|
|
170
170
|
**Slash command: `/review` or `/tribunal-full`**
|
|
171
171
|
**Active reviewers: `logic-reviewer` Β· `security-auditor`**
|
|
@@ -176,7 +176,7 @@ AI coding assistants often fall into specific bad habits when dealing with this
|
|
|
176
176
|
2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
|
|
177
177
|
3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
|
|
178
178
|
|
|
179
|
-
|
|
179
|
+
|
|
180
180
|
|
|
181
181
|
Review these questions before confirming output:
|
|
182
182
|
```
|
|
@@ -190,4 +190,12 @@ Review these questions before confirming output:
|
|
|
190
190
|
|
|
191
191
|
**CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
|
|
192
192
|
- β **Forbidden:** Declaring a task complete because the output "looks correct."
|
|
193
|
-
- β
**Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
|
|
193
|
+
- β
**Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
|
|
194
|
+
|
|
195
|
+
|
|
196
|
+
## Pre-Flight Checklist
|
|
197
|
+
- [ ] Have I reviewed the user's specific constraints and requests?
|
|
198
|
+
- [ ] Have I checked the environment for relevant existing implementations?
|
|
199
|
+
|
|
200
|
+
## VBC Protocol (Verification-Before-Completion)
|
|
201
|
+
You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
|
|
@@ -81,7 +81,7 @@ Never rely on developers "feeling" the game. You must systematically log death c
|
|
|
81
81
|
|
|
82
82
|
---
|
|
83
83
|
|
|
84
|
-
|
|
84
|
+
|
|
85
85
|
|
|
86
86
|
AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
|
|
87
87
|
|
|
@@ -93,7 +93,7 @@ AI coding assistants often fall into specific bad habits when dealing with this
|
|
|
93
93
|
|
|
94
94
|
---
|
|
95
95
|
|
|
96
|
-
|
|
96
|
+
|
|
97
97
|
|
|
98
98
|
**Slash command: `/review` or `/tribunal-full`**
|
|
99
99
|
**Active reviewers: `logic-reviewer` Β· `security-auditor`**
|
|
@@ -104,7 +104,7 @@ AI coding assistants often fall into specific bad habits when dealing with this
|
|
|
104
104
|
2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
|
|
105
105
|
3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
|
|
106
106
|
|
|
107
|
-
|
|
107
|
+
|
|
108
108
|
|
|
109
109
|
Review these questions before confirming output:
|
|
110
110
|
```
|
|
@@ -118,4 +118,12 @@ Review these questions before confirming output:
|
|
|
118
118
|
|
|
119
119
|
**CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
|
|
120
120
|
- β **Forbidden:** Declaring a task complete because the output "looks correct."
|
|
121
|
-
- β
**Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
|
|
121
|
+
- β
**Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
|
|
122
|
+
|
|
123
|
+
|
|
124
|
+
## Pre-Flight Checklist
|
|
125
|
+
- [ ] Have I reviewed the user's specific constraints and requests?
|
|
126
|
+
- [ ] Have I checked the environment for relevant existing implementations?
|
|
127
|
+
|
|
128
|
+
## VBC Protocol (Verification-Before-Completion)
|
|
129
|
+
You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
|
|
@@ -98,7 +98,7 @@ Never trust the client. A multiplayer architecture dictates latency fundamentall
|
|
|
98
98
|
|
|
99
99
|
---
|
|
100
100
|
|
|
101
|
-
|
|
101
|
+
|
|
102
102
|
|
|
103
103
|
AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
|
|
104
104
|
|
|
@@ -110,7 +110,7 @@ AI coding assistants often fall into specific bad habits when dealing with this
|
|
|
110
110
|
|
|
111
111
|
---
|
|
112
112
|
|
|
113
|
-
|
|
113
|
+
|
|
114
114
|
|
|
115
115
|
**Slash command: `/review` or `/tribunal-full`**
|
|
116
116
|
**Active reviewers: `logic-reviewer` Β· `security-auditor`**
|
|
@@ -121,7 +121,7 @@ AI coding assistants often fall into specific bad habits when dealing with this
|
|
|
121
121
|
2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
|
|
122
122
|
3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
|
|
123
123
|
|
|
124
|
-
|
|
124
|
+
|
|
125
125
|
|
|
126
126
|
Review these questions before confirming output:
|
|
127
127
|
```
|
|
@@ -135,4 +135,12 @@ Review these questions before confirming output:
|
|
|
135
135
|
|
|
136
136
|
**CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
|
|
137
137
|
- β **Forbidden:** Declaring a task complete because the output "looks correct."
|
|
138
|
-
- β
**Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
|
|
138
|
+
- β
**Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
|
|
139
|
+
|
|
140
|
+
|
|
141
|
+
## Pre-Flight Checklist
|
|
142
|
+
- [ ] Have I reviewed the user's specific constraints and requests?
|
|
143
|
+
- [ ] Have I checked the environment for relevant existing implementations?
|
|
144
|
+
|
|
145
|
+
## VBC Protocol (Verification-Before-Completion)
|
|
146
|
+
You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
|
|
@@ -99,7 +99,7 @@ When an AI tries to write code using your product, it scrapes your API documenta
|
|
|
99
99
|
|
|
100
100
|
---
|
|
101
101
|
|
|
102
|
-
|
|
102
|
+
|
|
103
103
|
|
|
104
104
|
AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
|
|
105
105
|
|
|
@@ -111,7 +111,7 @@ AI coding assistants often fall into specific bad habits when dealing with this
|
|
|
111
111
|
|
|
112
112
|
---
|
|
113
113
|
|
|
114
|
-
|
|
114
|
+
|
|
115
115
|
|
|
116
116
|
**Slash command: `/review` or `/tribunal-full`**
|
|
117
117
|
**Active reviewers: `logic-reviewer` Β· `security-auditor`**
|
|
@@ -122,7 +122,7 @@ AI coding assistants often fall into specific bad habits when dealing with this
|
|
|
122
122
|
2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
|
|
123
123
|
3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
|
|
124
124
|
|
|
125
|
-
|
|
125
|
+
|
|
126
126
|
|
|
127
127
|
Review these questions before confirming output:
|
|
128
128
|
```
|
|
@@ -136,4 +136,12 @@ Review these questions before confirming output:
|
|
|
136
136
|
|
|
137
137
|
**CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
|
|
138
138
|
- β **Forbidden:** Declaring a task complete because the output "looks correct."
|
|
139
|
-
- β
**Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
|
|
139
|
+
- β
**Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
|
|
140
|
+
|
|
141
|
+
|
|
142
|
+
## Pre-Flight Checklist
|
|
143
|
+
- [ ] Have I reviewed the user's specific constraints and requests?
|
|
144
|
+
- [ ] Have I checked the environment for relevant existing implementations?
|
|
145
|
+
|
|
146
|
+
## VBC Protocol (Verification-Before-Completion)
|
|
147
|
+
You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
|
|
@@ -281,7 +281,7 @@ export default {
|
|
|
281
281
|
|
|
282
282
|
---
|
|
283
283
|
|
|
284
|
-
|
|
284
|
+
|
|
285
285
|
|
|
286
286
|
AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
|
|
287
287
|
|
|
@@ -293,7 +293,7 @@ AI coding assistants often fall into specific bad habits when dealing with this
|
|
|
293
293
|
|
|
294
294
|
---
|
|
295
295
|
|
|
296
|
-
|
|
296
|
+
|
|
297
297
|
|
|
298
298
|
**Slash command: `/review` or `/tribunal-full`**
|
|
299
299
|
**Active reviewers: `logic-reviewer` Β· `security-auditor`**
|
|
@@ -304,7 +304,7 @@ AI coding assistants often fall into specific bad habits when dealing with this
|
|
|
304
304
|
2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
|
|
305
305
|
3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
|
|
306
306
|
|
|
307
|
-
|
|
307
|
+
|
|
308
308
|
|
|
309
309
|
Review these questions before confirming output:
|
|
310
310
|
```
|
|
@@ -318,4 +318,12 @@ Review these questions before confirming output:
|
|
|
318
318
|
|
|
319
319
|
**CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
|
|
320
320
|
- β **Forbidden:** Declaring a task complete because the output "looks correct."
|
|
321
|
-
- β
**Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
|
|
321
|
+
- β
**Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
|
|
322
|
+
|
|
323
|
+
|
|
324
|
+
## Pre-Flight Checklist
|
|
325
|
+
- [ ] Have I reviewed the user's specific constraints and requests?
|
|
326
|
+
- [ ] Have I checked the environment for relevant existing implementations?
|
|
327
|
+
|
|
328
|
+
## VBC Protocol (Verification-Before-Completion)
|
|
329
|
+
You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
|
|
@@ -252,51 +252,57 @@ Full docs: [gsap.matchMedia()](https://gsap.com/docs/v3/GSAP/gsap.matchMedia/).
|
|
|
252
252
|
- β Rely on the default **immediateRender: true** when stacking multiple **from()** or **fromTo()** tweens on the same property of the same target; set **immediateRender: false** on the later tweens so they animate correctly.
|
|
253
253
|
- β Use invalid or non-existent ease names; stick to documented eases.
|
|
254
254
|
- β Forget that **gsap.from()** uses the elementβs current state as the end state; the initial values in the tween will be applied immediately unless `immediateRender: false` is in the `vars`.
|
|
255
|
-
|
|
256
|
-
---
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
|
274
|
-
|
|
275
|
-
|gsap-core|
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
β
Did I
|
|
286
|
-
β
|
|
287
|
-
β
Did I
|
|
288
|
-
β
|
|
289
|
-
β
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
255
|
+
|
|
256
|
+
---
|
|
257
|
+
|
|
258
|
+
**Slash command: `/review` or `/tribunal-full`**
|
|
259
|
+
**Active reviewers: `logic-reviewer` Β· `security-auditor`**
|
|
260
|
+
|
|
261
|
+
### β Forbidden AI Tropes
|
|
262
|
+
|
|
263
|
+
1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
|
|
264
|
+
2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
|
|
265
|
+
3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
|
|
266
|
+
|
|
267
|
+
---
|
|
268
|
+
|
|
269
|
+
## π¨ LLM Trap Table
|
|
270
|
+
|
|
271
|
+
|Pattern|What AI Does Wrong|What Is Actually Correct|
|
|
272
|
+
|:---|:---|:---|
|
|
273
|
+
|gsap-core|Animate width, height, top, left|x, y, scale, rotation, opacity (GPU composited)|
|
|
274
|
+
|gsap-core|gsap.to(el, 1, {x: 100}) (GSAP 2)|gsap.to(el, {duration: 1, x: 100}) (GSAP 3)|
|
|
275
|
+
|gsap-core|Power2.easeOut (GSAP 2 format)|"power2.out" (GSAP 3 string format)|
|
|
276
|
+
|
|
277
|
+
---
|
|
278
|
+
|
|
279
|
+
## β
Pre-Flight Self-Audit
|
|
280
|
+
|
|
281
|
+
Before producing any output, verify:
|
|
282
|
+
```
|
|
283
|
+
β
Did I read the actual files before making claims about them?
|
|
284
|
+
β
Did I verify all method names against official GSAP documentation?
|
|
285
|
+
β
Did I add // VERIFY: on any uncertain API calls?
|
|
286
|
+
β
Are all imports from packages that actually exist in package.json?
|
|
287
|
+
β
Did I test my logic with edge cases (null, empty, 0, max)?
|
|
288
|
+
β
Did I avoid generating code for more than one module at a time?
|
|
289
|
+
β
Am I working from evidence, not assumption?
|
|
290
|
+
```
|
|
291
|
+
|
|
292
|
+
---
|
|
293
|
+
|
|
294
|
+
## π VBC Protocol (Verify β Build β Confirm)
|
|
295
|
+
|
|
296
|
+
```
|
|
297
|
+
VERIFY: Read the actual codebase before writing anything
|
|
298
|
+
BUILD: Generate the smallest meaningful unit of code
|
|
299
|
+
CONFIRM: Verify the output is correct before presenting
|
|
300
|
+
```
|
|
301
|
+
|
|
302
|
+
|
|
303
|
+
## Pre-Flight Checklist
|
|
304
|
+
- [ ] Have I reviewed the user's specific constraints and requests?
|
|
305
|
+
- [ ] Have I checked the environment for relevant existing implementations?
|
|
306
|
+
|
|
307
|
+
## VBC Protocol (Verification-Before-Completion)
|
|
308
|
+
You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
|