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.
Files changed (186) hide show
  1. package/.agent/ARCHITECTURE.md +21 -14
  2. package/.agent/agents/swarm-worker-contracts.md +5 -5
  3. package/.agent/agents/ui-ux-auditor.md +292 -0
  4. package/.agent/rules/GEMINI.md +8 -8
  5. package/.agent/scripts/__pycache__/_colors.cpython-311.pyc +0 -0
  6. package/.agent/scripts/__pycache__/_utils.cpython-311.pyc +0 -0
  7. package/.agent/scripts/__pycache__/case_law_manager.cpython-311.pyc +0 -0
  8. package/.agent/scripts/_colors.js +18 -0
  9. package/.agent/scripts/_utils.js +42 -0
  10. package/.agent/scripts/auto_preview.js +197 -0
  11. package/.agent/scripts/bundle_analyzer.js +290 -0
  12. package/.agent/scripts/case_law_manager.js +684 -0
  13. package/.agent/scripts/checklist.js +266 -0
  14. package/.agent/scripts/colors.js +17 -0
  15. package/.agent/scripts/compress_skills.js +141 -0
  16. package/.agent/scripts/consolidate_skills.js +149 -0
  17. package/.agent/scripts/context_broker.js +609 -0
  18. package/.agent/scripts/deep_compress.js +150 -0
  19. package/.agent/scripts/dependency_analyzer.js +272 -0
  20. package/.agent/scripts/graph_builder.js +199 -0
  21. package/.agent/scripts/graph_zoom.js +154 -0
  22. package/.agent/scripts/inner_loop_validator.js +465 -0
  23. package/.agent/scripts/lint_runner.js +187 -0
  24. package/.agent/scripts/minify_context.js +100 -0
  25. package/.agent/scripts/patch_skills_meta.js +156 -0
  26. package/.agent/scripts/patch_skills_output.js +244 -0
  27. package/.agent/scripts/schema_validator.js +297 -0
  28. package/.agent/scripts/security_scan.js +303 -0
  29. package/.agent/scripts/session_manager.js +276 -0
  30. package/.agent/scripts/skill_evolution.js +644 -0
  31. package/.agent/scripts/skill_integrator.js +313 -0
  32. package/.agent/scripts/strengthen_skills.js +193 -0
  33. package/.agent/scripts/strip_tribunal.js +47 -0
  34. package/.agent/scripts/swarm_dispatcher.js +360 -0
  35. package/.agent/scripts/test_runner.js +193 -0
  36. package/.agent/scripts/utils.js +32 -0
  37. package/.agent/scripts/verify_all.js +256 -0
  38. package/.agent/skills/agent-organizer/SKILL.md +12 -4
  39. package/.agent/skills/agentic-patterns/SKILL.md +12 -4
  40. package/.agent/skills/ai-prompt-injection-defense/SKILL.md +12 -4
  41. package/.agent/skills/api-patterns/SKILL.md +209 -201
  42. package/.agent/skills/api-security-auditor/SKILL.md +12 -4
  43. package/.agent/skills/app-builder/SKILL.md +12 -4
  44. package/.agent/skills/app-builder/templates/SKILL.md +76 -68
  45. package/.agent/skills/app-builder/templates/astro-static/TEMPLATE.md +1 -1
  46. package/.agent/skills/app-builder/templates/chrome-extension/TEMPLATE.md +1 -1
  47. package/.agent/skills/app-builder/templates/cli-tool/TEMPLATE.md +1 -1
  48. package/.agent/skills/app-builder/templates/electron-desktop/TEMPLATE.md +1 -1
  49. package/.agent/skills/app-builder/templates/express-api/TEMPLATE.md +1 -1
  50. package/.agent/skills/app-builder/templates/flutter-app/TEMPLATE.md +1 -1
  51. package/.agent/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +1 -1
  52. package/.agent/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +1 -1
  53. package/.agent/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +1 -1
  54. package/.agent/skills/app-builder/templates/nextjs-static/TEMPLATE.md +1 -1
  55. package/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md +1 -1
  56. package/.agent/skills/app-builder/templates/python-fastapi/TEMPLATE.md +1 -1
  57. package/.agent/skills/app-builder/templates/react-native-app/TEMPLATE.md +1 -1
  58. package/.agent/skills/appflow-wireframe/SKILL.md +12 -4
  59. package/.agent/skills/architecture/SKILL.md +12 -4
  60. package/.agent/skills/authentication-best-practices/SKILL.md +12 -4
  61. package/.agent/skills/bash-linux/SKILL.md +12 -4
  62. package/.agent/skills/behavioral-modes/SKILL.md +12 -4
  63. package/.agent/skills/brainstorming/SKILL.md +12 -4
  64. package/.agent/skills/building-native-ui/SKILL.md +12 -4
  65. package/.agent/skills/clean-code/SKILL.md +12 -4
  66. package/.agent/skills/code-review-checklist/SKILL.md +12 -4
  67. package/.agent/skills/config-validator/SKILL.md +12 -4
  68. package/.agent/skills/csharp-developer/SKILL.md +12 -4
  69. package/.agent/skills/data-validation-schemas/SKILL.md +290 -282
  70. package/.agent/skills/database-design/SKILL.md +202 -194
  71. package/.agent/skills/deployment-procedures/SKILL.md +12 -4
  72. package/.agent/skills/devops-engineer/SKILL.md +12 -4
  73. package/.agent/skills/devops-incident-responder/SKILL.md +12 -4
  74. package/.agent/skills/doc.md +1 -1
  75. package/.agent/skills/documentation-templates/SKILL.md +12 -4
  76. package/.agent/skills/edge-computing/SKILL.md +12 -4
  77. package/.agent/skills/error-resilience/SKILL.md +390 -382
  78. package/.agent/skills/extract-design-system/SKILL.md +12 -4
  79. package/.agent/skills/framer-motion-expert/SKILL.md +206 -199
  80. package/.agent/skills/frontend-design/SKILL.md +163 -155
  81. package/.agent/skills/game-design-expert/SKILL.md +12 -4
  82. package/.agent/skills/game-engineering-expert/SKILL.md +12 -4
  83. package/.agent/skills/geo-fundamentals/SKILL.md +12 -4
  84. package/.agent/skills/github-operations/SKILL.md +12 -4
  85. package/.agent/skills/gsap-core/SKILL.md +54 -48
  86. package/.agent/skills/gsap-frameworks/SKILL.md +54 -48
  87. package/.agent/skills/gsap-performance/SKILL.md +54 -48
  88. package/.agent/skills/gsap-plugins/SKILL.md +54 -48
  89. package/.agent/skills/gsap-react/SKILL.md +54 -48
  90. package/.agent/skills/gsap-scrolltrigger/SKILL.md +54 -48
  91. package/.agent/skills/gsap-timeline/SKILL.md +54 -48
  92. package/.agent/skills/gsap-utils/SKILL.md +54 -48
  93. package/.agent/skills/i18n-localization/SKILL.md +12 -4
  94. package/.agent/skills/intelligent-routing/SKILL.md +41 -33
  95. package/.agent/skills/knowledge-graph/SKILL.md +36 -0
  96. package/.agent/skills/lint-and-validate/SKILL.md +12 -4
  97. package/.agent/skills/llm-engineering/SKILL.md +12 -4
  98. package/.agent/skills/local-first/SKILL.md +12 -4
  99. package/.agent/skills/mcp-builder/SKILL.md +12 -4
  100. package/.agent/skills/mobile-design/SKILL.md +225 -217
  101. package/.agent/skills/monorepo-management/SKILL.md +296 -288
  102. package/.agent/skills/motion-engineering/SKILL.md +195 -187
  103. package/.agent/skills/nextjs-react-expert/SKILL.md +196 -188
  104. package/.agent/skills/nodejs-best-practices/SKILL.md +12 -4
  105. package/.agent/skills/observability/SKILL.md +12 -4
  106. package/.agent/skills/parallel-agents/SKILL.md +12 -4
  107. package/.agent/skills/performance-profiling/SKILL.md +12 -4
  108. package/.agent/skills/plan-writing/SKILL.md +12 -4
  109. package/.agent/skills/platform-engineer/SKILL.md +12 -4
  110. package/.agent/skills/playwright-best-practices/SKILL.md +12 -4
  111. package/.agent/skills/powershell-windows/SKILL.md +12 -4
  112. package/.agent/skills/project-idioms/SKILL.md +12 -4
  113. package/.agent/skills/python-patterns/SKILL.md +12 -4
  114. package/.agent/skills/python-pro/SKILL.md +285 -277
  115. package/.agent/skills/react-specialist/SKILL.md +239 -231
  116. package/.agent/skills/readme-builder/SKILL.md +12 -4
  117. package/.agent/skills/realtime-patterns/SKILL.md +12 -4
  118. package/.agent/skills/red-team-tactics/SKILL.md +12 -4
  119. package/.agent/skills/rust-pro/SKILL.md +12 -4
  120. package/.agent/skills/seo-fundamentals/SKILL.md +12 -4
  121. package/.agent/skills/server-management/SKILL.md +12 -4
  122. package/.agent/skills/shadcn-ui-expert/SKILL.md +12 -4
  123. package/.agent/skills/skill-creator/SKILL.md +12 -4
  124. package/.agent/skills/sql-pro/SKILL.md +12 -4
  125. package/.agent/skills/supabase-postgres-best-practices/SKILL.md +12 -4
  126. package/.agent/skills/swiftui-expert/SKILL.md +12 -4
  127. package/.agent/skills/systematic-debugging/SKILL.md +12 -4
  128. package/.agent/skills/tailwind-patterns/SKILL.md +12 -4
  129. package/.agent/skills/tdd-workflow/SKILL.md +12 -4
  130. package/.agent/skills/test-result-analyzer/SKILL.md +12 -4
  131. package/.agent/skills/testing-patterns/SKILL.md +12 -4
  132. package/.agent/skills/trend-researcher/SKILL.md +12 -4
  133. package/.agent/skills/typescript-advanced/SKILL.md +297 -289
  134. package/.agent/skills/ui-ux-pro-max/SKILL.md +12 -4
  135. package/.agent/skills/ui-ux-researcher/SKILL.md +12 -4
  136. package/.agent/skills/vue-expert/SKILL.md +237 -229
  137. package/.agent/skills/vulnerability-scanner/SKILL.md +12 -4
  138. package/.agent/skills/web-accessibility-auditor/SKILL.md +12 -4
  139. package/.agent/skills/web-design-guidelines/SKILL.md +12 -4
  140. package/.agent/skills/webapp-testing/SKILL.md +12 -4
  141. package/.agent/skills/whimsy-injector/SKILL.md +12 -4
  142. package/.agent/skills/workflow-optimizer/SKILL.md +12 -4
  143. package/.agent/workflows/audit.md +6 -6
  144. package/.agent/workflows/deploy.md +1 -1
  145. package/.agent/workflows/generate.md +23 -6
  146. package/.agent/workflows/session.md +5 -5
  147. package/.agent/workflows/swarm.md +2 -2
  148. package/README.md +242 -186
  149. package/bin/tribunal-kit.js +297 -57
  150. package/package.json +81 -77
  151. package/scripts/changelog.js +167 -0
  152. package/scripts/sync-version.js +81 -0
  153. package/scripts/validate-payload.js +73 -0
  154. package/.agent/scripts/__pycache__/auto_preview.cpython-311.pyc +0 -0
  155. package/.agent/scripts/__pycache__/bundle_analyzer.cpython-311.pyc +0 -0
  156. package/.agent/scripts/__pycache__/checklist.cpython-311.pyc +0 -0
  157. package/.agent/scripts/__pycache__/dependency_analyzer.cpython-311.pyc +0 -0
  158. package/.agent/scripts/__pycache__/security_scan.cpython-311.pyc +0 -0
  159. package/.agent/scripts/__pycache__/session_manager.cpython-311.pyc +0 -0
  160. package/.agent/scripts/__pycache__/skill_integrator.cpython-311.pyc +0 -0
  161. package/.agent/scripts/__pycache__/swarm_dispatcher.cpython-311.pyc +0 -0
  162. package/.agent/scripts/__pycache__/test_runner.cpython-311.pyc +0 -0
  163. package/.agent/scripts/__pycache__/verify_all.cpython-311.pyc +0 -0
  164. package/.agent/scripts/auto_preview.py +0 -180
  165. package/.agent/scripts/bundle_analyzer.py +0 -259
  166. package/.agent/scripts/case_law_manager.py +0 -755
  167. package/.agent/scripts/checklist.py +0 -209
  168. package/.agent/scripts/compress_skills.py +0 -167
  169. package/.agent/scripts/consolidate_skills.py +0 -173
  170. package/.agent/scripts/deep_compress.py +0 -202
  171. package/.agent/scripts/dependency_analyzer.py +0 -247
  172. package/.agent/scripts/lint_runner.py +0 -188
  173. package/.agent/scripts/minify_context.py +0 -80
  174. package/.agent/scripts/patch_skills_meta.py +0 -177
  175. package/.agent/scripts/patch_skills_output.py +0 -285
  176. package/.agent/scripts/schema_validator.py +0 -279
  177. package/.agent/scripts/security_scan.py +0 -224
  178. package/.agent/scripts/session_manager.py +0 -261
  179. package/.agent/scripts/skill_evolution.py +0 -563
  180. package/.agent/scripts/skill_integrator.py +0 -234
  181. package/.agent/scripts/strengthen_skills.py +0 -220
  182. package/.agent/scripts/strip_tribunal.py +0 -41
  183. package/.agent/scripts/swarm_dispatcher.py +0 -350
  184. package/.agent/scripts/test_runner.py +0 -192
  185. package/.agent/scripts/test_swarm_dispatcher.py +0 -163
  186. 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
- ## πŸ€– LLM-Specific Traps
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
- ## πŸ›οΈ Tribunal Integration (Anti-Hallucination)
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
- ### βœ… Pre-Flight Self-Audit
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
- ## πŸ€– LLM-Specific Traps
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
- ## πŸ›οΈ Tribunal Integration (Anti-Hallucination)
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
- ### βœ… Pre-Flight Self-Audit
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
- ## πŸ€– LLM-Specific Traps
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
- ## πŸ›οΈ Tribunal Integration (Anti-Hallucination)
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
- ### βœ… Pre-Flight Self-Audit
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
- ## πŸ€– LLM-Specific Traps
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
- ## πŸ›οΈ Tribunal Integration (Anti-Hallucination)
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
- ### βœ… Pre-Flight Self-Audit
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
- ## πŸ€– LLM-Specific Traps
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
- ## πŸ›οΈ Tribunal Integration (Anti-Hallucination)
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
- ### βœ… Pre-Flight Self-Audit
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
- ## πŸ›οΈ Tribunal Integration (Anti-Hallucination)
259
-
260
- **Slash command: `/review` or `/tribunal-full`**
261
- **Active reviewers: `logic-reviewer` Β· `security-auditor`**
262
-
263
- ### ❌ Forbidden AI Tropes
264
-
265
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
266
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
267
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
268
-
269
- ---
270
-
271
- ## 🚨 LLM Trap Table
272
-
273
- |Pattern|What AI Does Wrong|What Is Actually Correct|
274
- |:---|:---|:---|
275
- |gsap-core|Animate width, height, top, left|x, y, scale, rotation, opacity (GPU composited)|
276
- |gsap-core|gsap.to(el, 1, {x: 100}) (GSAP 2)|gsap.to(el, {duration: 1, x: 100}) (GSAP 3)|
277
- |gsap-core|Power2.easeOut (GSAP 2 format)|"power2.out" (GSAP 3 string format)|
278
-
279
- ---
280
-
281
- ## βœ… Pre-Flight Self-Audit
282
-
283
- Before producing any output, verify:
284
- ```
285
- βœ… Did I read the actual files before making claims about them?
286
- βœ… Did I verify all method names against official GSAP documentation?
287
- βœ… Did I add // VERIFY: on any uncertain API calls?
288
- βœ… Are all imports from packages that actually exist in package.json?
289
- βœ… Did I test my logic with edge cases (null, empty, 0, max)?
290
- βœ… Did I avoid generating code for more than one module at a time?
291
- βœ… Am I working from evidence, not assumption?
292
- ```
293
-
294
- ---
295
-
296
- ## πŸ” VBC Protocol (Verify β†’ Build β†’ Confirm)
297
-
298
- ```
299
- VERIFY: Read the actual codebase before writing anything
300
- BUILD: Generate the smallest meaningful unit of code
301
- CONFIRM: Verify the output is correct before presenting
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.