tribunal-kit 9.2.4 → 9.2.6

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 (1208) hide show
  1. package/.agent/.manifest.json +78 -78
  2. package/.agent/.shared/ui-ux-pro-max/README.md +4 -4
  3. package/.agent/.tribunal/session.jsonl +15 -15
  4. package/.agent/ADRs/ADR-001-system-architecture-intelligence.md +49 -0
  5. package/.agent/ARCHITECTURE.md +63 -63
  6. package/.agent/agents/accessibility-reviewer.md +109 -109
  7. package/.agent/agents/agent-shield-auditor.md +21 -18
  8. package/.agent/agents/ai-code-reviewer.md +223 -223
  9. package/.agent/agents/anti-pattern-reviewer.md +104 -104
  10. package/.agent/agents/anti-slop-auditor.md +79 -0
  11. package/.agent/agents/api-architect.md +94 -89
  12. package/.agent/agents/architecture-auditor.md +196 -0
  13. package/.agent/agents/backend-security-architect.md +115 -0
  14. package/.agent/agents/backend-specialist.md +242 -242
  15. package/.agent/agents/cloud-engineer.md +120 -120
  16. package/.agent/agents/code-archaeologist.md +186 -186
  17. package/.agent/agents/complexity-reviewer.md +76 -76
  18. package/.agent/agents/database-architect.md +206 -206
  19. package/.agent/agents/db-latency-auditor.md +237 -237
  20. package/.agent/agents/debugger.md +215 -215
  21. package/.agent/agents/dependency-reviewer.md +124 -124
  22. package/.agent/agents/devops-engineer.md +240 -240
  23. package/.agent/agents/documentation-writer.md +228 -228
  24. package/.agent/agents/explorer-agent.md +186 -186
  25. package/.agent/agents/frontend-reviewer.md +197 -195
  26. package/.agent/agents/frontend-specialist.md +123 -122
  27. package/.agent/agents/game-developer.md +68 -68
  28. package/.agent/agents/harness-manager.md +57 -49
  29. package/.agent/agents/human-gate-negotiator.md +26 -22
  30. package/.agent/agents/interaction-reviewer.md +123 -123
  31. package/.agent/agents/kernel-scheduler.md +60 -56
  32. package/.agent/agents/logic-reviewer.md +147 -147
  33. package/.agent/agents/memory-archivist.md +42 -37
  34. package/.agent/agents/minimalist-reviewer.md +104 -104
  35. package/.agent/agents/mobile-developer.md +216 -216
  36. package/.agent/agents/mobile-reviewer.md +180 -180
  37. package/.agent/agents/orchestrator.md +267 -268
  38. package/.agent/agents/penetration-tester.md +180 -180
  39. package/.agent/agents/performance-optimizer.md +202 -202
  40. package/.agent/agents/performance-reviewer.md +180 -180
  41. package/.agent/agents/pipeline-reviewer.md +144 -144
  42. package/.agent/agents/precedence-reviewer.md +266 -266
  43. package/.agent/agents/product-manager.md +167 -167
  44. package/.agent/agents/product-owner.md +103 -103
  45. package/.agent/agents/product-reviewer.md +103 -103
  46. package/.agent/agents/project-planner.md +180 -181
  47. package/.agent/agents/qa-automation-engineer.md +244 -244
  48. package/.agent/agents/resilience-reviewer.md +108 -108
  49. package/.agent/agents/schema-reviewer.md +87 -87
  50. package/.agent/agents/security-auditor.md +203 -204
  51. package/.agent/agents/seo-specialist.md +213 -213
  52. package/.agent/agents/sql-reviewer.md +180 -180
  53. package/.agent/agents/supervisor-agent.md +202 -202
  54. package/.agent/agents/swarm-worker-contracts.md +170 -170
  55. package/.agent/agents/swarm-worker-registry.md +99 -99
  56. package/.agent/agents/system-architect.md +274 -105
  57. package/.agent/agents/test-coverage-reviewer.md +181 -181
  58. package/.agent/agents/test-engineer.md +138 -138
  59. package/.agent/agents/throughput-optimizer.md +316 -316
  60. package/.agent/agents/type-safety-reviewer.md +202 -202
  61. package/.agent/agents/ui-ux-auditor.md +85 -80
  62. package/.agent/agents/ui-visual-auditor.md +107 -102
  63. package/.agent/agents/ux-reviewer.md +109 -109
  64. package/.agent/agents/visual-reviewer.md +103 -103
  65. package/.agent/agents/vitals-reviewer.md +245 -245
  66. package/.agent/config/claude.json +18 -18
  67. package/.agent/config/plugin.json +102 -102
  68. package/.agent/config/slash-commands.json +115 -115
  69. package/.agent/config/specialist-registry.json +415 -415
  70. package/.agent/config/system-prompt.md +258 -258
  71. package/.agent/history/arch-mapper-cache.json +6712 -0
  72. package/.agent/history/architecture-intelligence.html +794 -0
  73. package/.agent/history/architecture-model.json +16096 -0
  74. package/.agent/history/architecture-verification.json +22 -0
  75. package/.agent/history/architecture.idx.json +5746 -0
  76. package/.agent/history/integrity_manifest.json +369 -3158
  77. package/.agent/mcp_config.json +32 -32
  78. package/.agent/patterns/generator.md +11 -11
  79. package/.agent/patterns/inversion.md +14 -14
  80. package/.agent/patterns/pipeline.md +11 -11
  81. package/.agent/patterns/reviewer.md +15 -15
  82. package/.agent/patterns/tool-wrapper.md +11 -11
  83. package/.agent/plans/implementation_plan.md +55 -0
  84. package/.agent/plans/task.md +41 -0
  85. package/.agent/routing_index.json +1566 -286
  86. package/.agent/rules/GEMINI.md +437 -437
  87. package/.agent/rules/GEMINI_PLANNER.md +82 -82
  88. package/.agent/rules/kernel.md +89 -86
  89. package/.agent/scripts/_colors.js +210 -210
  90. package/.agent/scripts/_utils.js +378 -377
  91. package/.agent/scripts/ab_json_experiment.js +129 -0
  92. package/.agent/scripts/architecture_diff.js +260 -0
  93. package/.agent/scripts/architecture_extractor.js +753 -0
  94. package/.agent/scripts/architecture_health.js +256 -0
  95. package/.agent/scripts/architecture_mapper.js +691 -0
  96. package/.agent/scripts/architecture_verifier.js +270 -0
  97. package/.agent/scripts/architecture_visualizer.js +873 -0
  98. package/.agent/scripts/ast_context_loader.js +137 -137
  99. package/.agent/scripts/auto_preview.js +203 -203
  100. package/.agent/scripts/backend_audit.js +238 -0
  101. package/.agent/scripts/backend_report_generator.js +161 -0
  102. package/.agent/scripts/benchmark_suite.js +493 -0
  103. package/.agent/scripts/blast_radius_engine.js +234 -0
  104. package/.agent/scripts/browser_audit.js +102 -102
  105. package/.agent/scripts/bundle_analyzer.js +287 -287
  106. package/.agent/scripts/case_law_manager.js +887 -887
  107. package/.agent/scripts/checklist.js +304 -300
  108. package/.agent/scripts/cicd_validator.js +305 -305
  109. package/.agent/scripts/consolidation_experiment.js +543 -0
  110. package/.agent/scripts/context_broker.js +962 -962
  111. package/.agent/scripts/context_compiler.js +1174 -1112
  112. package/.agent/scripts/contract_engine.js +402 -402
  113. package/.agent/scripts/cross_agent_correlator.js +223 -0
  114. package/.agent/scripts/dependency_analyzer.js +335 -313
  115. package/.agent/scripts/evidence_verifier.js +171 -0
  116. package/.agent/scripts/finding_schema.js +104 -0
  117. package/.agent/scripts/findings_validator.js +147 -0
  118. package/.agent/scripts/graph_builder.js +384 -384
  119. package/.agent/scripts/graph_visualizer.js +390 -390
  120. package/.agent/scripts/graph_zoom.js +181 -181
  121. package/.agent/scripts/guardrail_engine.js +804 -785
  122. package/.agent/scripts/harness_manager.js +72 -60
  123. package/.agent/scripts/impact_classifier.js +193 -192
  124. package/.agent/scripts/inner_loop_validator.js +472 -472
  125. package/.agent/scripts/integrity_manifest.js +524 -484
  126. package/.agent/scripts/lint_runner.js +220 -218
  127. package/.agent/scripts/live_abc_benchmark.js +452 -0
  128. package/.agent/scripts/marathon_harness.js +986 -986
  129. package/.agent/scripts/mcp_server.js +203 -181
  130. package/.agent/scripts/memory_archivist.js +103 -97
  131. package/.agent/scripts/memory_consolidator.js +37 -37
  132. package/.agent/scripts/memory_engine.js +798 -782
  133. package/.agent/scripts/minify_context.js +111 -111
  134. package/.agent/scripts/minimal_change_engine.js +445 -445
  135. package/.agent/scripts/mutation_runner.js +307 -305
  136. package/.agent/scripts/payload_schemas.js +164 -164
  137. package/.agent/scripts/pipeline_engine.js +921 -906
  138. package/.agent/scripts/prompt_compiler.js +272 -272
  139. package/.agent/scripts/schema_validator.js +326 -326
  140. package/.agent/scripts/secret_redactor.js +119 -0
  141. package/.agent/scripts/security_scan.js +390 -390
  142. package/.agent/scripts/session_logger.js +115 -115
  143. package/.agent/scripts/session_manager.js +304 -299
  144. package/.agent/scripts/signal_detector.js +175 -175
  145. package/.agent/scripts/skill_evolution.js +997 -997
  146. package/.agent/scripts/skill_integrator.js +304 -304
  147. package/.agent/scripts/socratic_gate_policy.js +63 -63
  148. package/.agent/scripts/strengthen_skills.js +199 -199
  149. package/.agent/scripts/swarm_dispatcher.js +992 -979
  150. package/.agent/scripts/syscall_registry.js +110 -105
  151. package/.agent/scripts/test_runner.js +209 -209
  152. package/.agent/scripts/tier3_audit.js +195 -0
  153. package/.agent/scripts/token_budget_broker.js +165 -165
  154. package/.agent/scripts/trace_engine.js +126 -126
  155. package/.agent/scripts/validation_engine.js +236 -0
  156. package/.agent/scripts/verify_all.js +278 -276
  157. package/.agent/scripts/visual_audit.js +87 -87
  158. package/.agent/skill_topic_map.json +123 -96
  159. package/.agent/skills/12-principles-of-animation/SKILL.md +91 -21
  160. package/.agent/skills/60fps-animation/SKILL.md +118 -61
  161. package/.agent/skills/accessible-animation/SKILL.md +214 -152
  162. package/.agent/skills/adapt/SKILL.md +98 -28
  163. package/.agent/skills/adr-generation/SKILL.md +133 -0
  164. package/.agent/skills/advanced-rag-pipelines/SKILL.md +125 -64
  165. package/.agent/skills/agent-organizer/SKILL.md +142 -84
  166. package/.agent/skills/agent-syscall-guidelines/SKILL.md +88 -13
  167. package/.agent/skills/agentic-patterns/SKILL.md +314 -244
  168. package/.agent/skills/agentic-workflows-2026/SKILL.md +137 -65
  169. package/.agent/skills/agentshield-security/SKILL.md +74 -15
  170. package/.agent/skills/ai-app-hardening/SKILL.md +99 -27
  171. package/.agent/skills/ai-prompt-injection-defense/SKILL.md +191 -130
  172. package/.agent/skills/animation-on-scroll/SKILL.md +225 -163
  173. package/.agent/skills/animation-systems/SKILL.md +227 -165
  174. package/.agent/skills/antfu-conventions/SKILL.md +96 -26
  175. package/.agent/skills/anti-slop-enforcement/SKILL.md +118 -0
  176. package/.agent/skills/api-patterns/SKILL.md +247 -186
  177. package/.agent/skills/api-security-auditor/SKILL.md +204 -126
  178. package/.agent/skills/app-builder/SKILL.md +556 -501
  179. package/.agent/skills/app-builder/templates/SKILL.md +108 -108
  180. package/.agent/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -76
  181. package/.agent/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -92
  182. package/.agent/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -88
  183. package/.agent/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -88
  184. package/.agent/skills/app-builder/templates/express-api/TEMPLATE.md +83 -83
  185. package/.agent/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -90
  186. package/.agent/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -90
  187. package/.agent/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +126 -126
  188. package/.agent/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +127 -127
  189. package/.agent/skills/app-builder/templates/nextjs-static/TEMPLATE.md +172 -172
  190. package/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md +139 -139
  191. package/.agent/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -83
  192. package/.agent/skills/app-builder/templates/react-native-app/TEMPLATE.md +122 -122
  193. package/.agent/skills/appflow-wireframe/SKILL.md +129 -69
  194. package/.agent/skills/apple-design/SKILL.md +130 -60
  195. package/.agent/skills/architecture/SKILL.md +216 -155
  196. package/.agent/skills/architecture-drift/SKILL.md +121 -0
  197. package/.agent/skills/architecture-intelligence/SKILL.md +53 -0
  198. package/.agent/skills/audit-and-fix/SKILL.md +133 -63
  199. package/.agent/skills/authentication-best-practices/SKILL.md +191 -121
  200. package/.agent/skills/autonomous-execution/SKILL.md +154 -0
  201. package/.agent/skills/backend-alembic/SKILL.md +91 -0
  202. package/.agent/skills/backend-architecture-auditor/SKILL.md +101 -0
  203. package/.agent/skills/backend-mongodb/SKILL.md +133 -0
  204. package/.agent/skills/backend-mysql/SKILL.md +84 -0
  205. package/.agent/skills/backend-performance-auditor/SKILL.md +100 -0
  206. package/.agent/skills/backend-postgresql/SKILL.md +117 -0
  207. package/.agent/skills/backend-redis/SKILL.md +122 -0
  208. package/.agent/skills/backend-security-expert/SKILL.md +111 -50
  209. package/.agent/skills/backend-sqlalchemy/SKILL.md +107 -0
  210. package/.agent/skills/backend-sqlite/SKILL.md +93 -0
  211. package/.agent/skills/backend-testing-auditor/SKILL.md +113 -0
  212. package/.agent/skills/baseline-ui/SKILL.md +99 -29
  213. package/.agent/skills/bash-linux/SKILL.md +164 -106
  214. package/.agent/skills/behavioral-modes/SKILL.md +235 -165
  215. package/.agent/skills/better-colors/SKILL.md +153 -83
  216. package/.agent/skills/better-typography/SKILL.md +137 -67
  217. package/.agent/skills/better-ui/SKILL.md +160 -99
  218. package/.agent/skills/bolder/SKILL.md +91 -21
  219. package/.agent/skills/brainstorming/SKILL.md +494 -434
  220. package/.agent/skills/browser-audit/SKILL.md +134 -64
  221. package/.agent/skills/browser-native-ai/SKILL.md +111 -41
  222. package/.agent/skills/build-primitive/SKILL.md +93 -23
  223. package/.agent/skills/building-native-ui/SKILL.md +191 -130
  224. package/.agent/skills/cicd-pro/SKILL.md +440 -379
  225. package/.agent/skills/clarify/SKILL.md +98 -28
  226. package/.agent/skills/clean-code/SKILL.md +395 -334
  227. package/.agent/skills/cloud-architect/SKILL.md +437 -376
  228. package/.agent/skills/cobejs/SKILL.md +120 -50
  229. package/.agent/skills/code-review-checklist/SKILL.md +198 -128
  230. package/.agent/skills/codebase-design/SKILL.md +109 -48
  231. package/.agent/skills/colorize/SKILL.md +100 -30
  232. package/.agent/skills/compact-landing/SKILL.md +93 -23
  233. package/.agent/skills/company-logos/SKILL.md +96 -26
  234. package/.agent/skills/config-validator/SKILL.md +151 -93
  235. package/.agent/skills/containerization-pro/SKILL.md +450 -389
  236. package/.agent/skills/context-engineering-pro/SKILL.md +113 -41
  237. package/.agent/skills/create-design-md/SKILL.md +128 -58
  238. package/.agent/skills/critique/SKILL.md +115 -45
  239. package/.agent/skills/csharp-developer/SKILL.md +512 -442
  240. package/.agent/skills/data-validation-schemas/SKILL.md +321 -263
  241. package/.agent/skills/database-design/SKILL.md +247 -186
  242. package/.agent/skills/delight/SKILL.md +88 -18
  243. package/.agent/skills/deployment-procedures/SKILL.md +159 -101
  244. package/.agent/skills/design-lab/SKILL.md +85 -15
  245. package/.agent/skills/devops-engineer/SKILL.md +339 -269
  246. package/.agent/skills/devops-incident-responder/SKILL.md +130 -72
  247. package/.agent/skills/diagnosing-bugs/SKILL.md +208 -138
  248. package/.agent/skills/distill/SKILL.md +88 -18
  249. package/.agent/skills/documentation-templates/SKILL.md +275 -217
  250. package/.agent/skills/domain-modeling/SKILL.md +101 -31
  251. package/.agent/skills/duckdb-analytical-sql/SKILL.md +100 -28
  252. package/.agent/skills/edge-ai-mobile/SKILL.md +92 -20
  253. package/.agent/skills/edge-computing/SKILL.md +168 -110
  254. package/.agent/skills/emil-design-eng/SKILL.md +170 -100
  255. package/.agent/skills/error-resilience/SKILL.md +431 -370
  256. package/.agent/skills/expo-router-v4/SKILL.md +126 -54
  257. package/.agent/skills/extract-design-system/SKILL.md +146 -88
  258. package/.agent/skills/fabel-protocol/SKILL.md +316 -246
  259. package/.agent/skills/failure-mode-analysis/SKILL.md +124 -0
  260. package/.agent/skills/fastapi-pro/SKILL.md +123 -0
  261. package/.agent/skills/fixing-accessibility/SKILL.md +129 -59
  262. package/.agent/skills/fixing-metadata/SKILL.md +130 -60
  263. package/.agent/skills/fixing-motion-performance/SKILL.md +115 -45
  264. package/.agent/skills/framer-motion-expert/SKILL.md +259 -204
  265. package/.agent/skills/frontend-design/SKILL.md +139 -69
  266. package/.agent/skills/frontend-security-expert/SKILL.md +94 -33
  267. package/.agent/skills/game-design-expert/SKILL.md +126 -68
  268. package/.agent/skills/game-engineering-expert/SKILL.md +135 -77
  269. package/.agent/skills/generative-ui-expert/SKILL.md +142 -72
  270. package/.agent/skills/geo-fundamentals/SKILL.md +134 -76
  271. package/.agent/skills/git-pro/SKILL.md +429 -368
  272. package/.agent/skills/github-operations/SKILL.md +329 -259
  273. package/.agent/skills/gpt-taste/SKILL.md +92 -22
  274. package/.agent/skills/graph-engineering/SKILL.md +104 -16
  275. package/.agent/skills/gsap-core/SKILL.md +312 -242
  276. package/.agent/skills/gsap-frameworks/SKILL.md +204 -134
  277. package/.agent/skills/gsap-performance/SKILL.md +130 -60
  278. package/.agent/skills/gsap-plugins/SKILL.md +476 -406
  279. package/.agent/skills/gsap-react/SKILL.md +248 -178
  280. package/.agent/skills/gsap-scrolltrigger/SKILL.md +347 -277
  281. package/.agent/skills/gsap-timeline/SKILL.md +157 -87
  282. package/.agent/skills/gsap-utils/SKILL.md +334 -264
  283. package/.agent/skills/harden/SKILL.md +97 -27
  284. package/.agent/skills/harness-protocol/SKILL.md +91 -21
  285. package/.agent/skills/hf-cli/SKILL.md +86 -6
  286. package/.agent/skills/hf-cloud-aws-context-discovery/SKILL.md +86 -8
  287. package/.agent/skills/hf-cloud-python-env-setup/SKILL.md +86 -8
  288. package/.agent/skills/hf-cloud-sagemaker-deployment-planner/SKILL.md +86 -8
  289. package/.agent/skills/hf-cloud-sagemaker-iam-preflight/SKILL.md +86 -8
  290. package/.agent/skills/hf-cloud-sagemaker-production-defaults/SKILL.md +86 -8
  291. package/.agent/skills/hf-cloud-serving-image-selection/SKILL.md +86 -8
  292. package/.agent/skills/hf-mem/SKILL.md +86 -6
  293. package/.agent/skills/huggingface-best/SKILL.md +86 -16
  294. package/.agent/skills/huggingface-community-evals/SKILL.md +86 -8
  295. package/.agent/skills/huggingface-datasets/SKILL.md +86 -8
  296. package/.agent/skills/huggingface-gradio/SKILL.md +86 -8
  297. package/.agent/skills/huggingface-llm-trainer/SKILL.md +86 -9
  298. package/.agent/skills/huggingface-local-models/SKILL.md +86 -8
  299. package/.agent/skills/huggingface-lora-space-builder/SKILL.md +86 -8
  300. package/.agent/skills/huggingface-paper-publisher/SKILL.md +86 -7
  301. package/.agent/skills/huggingface-papers/SKILL.md +86 -8
  302. package/.agent/skills/huggingface-spaces/SKILL.md +87 -9
  303. package/.agent/skills/huggingface-tool-builder/SKILL.md +86 -8
  304. package/.agent/skills/huggingface-trackio/SKILL.md +77 -8
  305. package/.agent/skills/huggingface-vision-trainer/SKILL.md +86 -8
  306. package/.agent/skills/huggingface-zerogpu/SKILL.md +86 -8
  307. package/.agent/skills/human-gate-negotiation/SKILL.md +83 -17
  308. package/.agent/skills/i18n-localization/SKILL.md +160 -102
  309. package/.agent/skills/impeccable/SKILL.md +95 -25
  310. package/.agent/skills/improve-codebase-architecture/SKILL.md +90 -20
  311. package/.agent/skills/improve-ui/SKILL.md +107 -37
  312. package/.agent/skills/intelligent-routing/SKILL.md +243 -180
  313. package/.agent/skills/knowledge-graph/SKILL.md +109 -39
  314. package/.agent/skills/landing-page/SKILL.md +106 -36
  315. package/.agent/skills/lint-and-validate/SKILL.md +249 -191
  316. package/.agent/skills/llm-engineering/SKILL.md +394 -324
  317. package/.agent/skills/local-first/SKILL.md +163 -105
  318. package/.agent/skills/local-first-architecture/SKILL.md +100 -39
  319. package/.agent/skills/lottie-animation/SKILL.md +109 -39
  320. package/.agent/skills/marquee-loop/SKILL.md +121 -51
  321. package/.agent/skills/masked-reveal/SKILL.md +267 -198
  322. package/.agent/skills/mcp-builder/SKILL.md +131 -73
  323. package/.agent/skills/micro-interaction/SKILL.md +281 -219
  324. package/.agent/skills/mobile-design/SKILL.md +274 -213
  325. package/.agent/skills/monorepo-management/SKILL.md +319 -261
  326. package/.agent/skills/morphing-icons/SKILL.md +379 -310
  327. package/.agent/skills/motion-engineering/SKILL.md +225 -164
  328. package/.agent/skills/nextjs-react-expert/SKILL.md +247 -186
  329. package/.agent/skills/nodejs-best-practices/SKILL.md +570 -509
  330. package/.agent/skills/observability/SKILL.md +337 -267
  331. package/.agent/skills/opentelemetry-observability/SKILL.md +106 -34
  332. package/.agent/skills/page-transition-animation/SKILL.md +130 -60
  333. package/.agent/skills/parallel-agents/SKILL.md +136 -78
  334. package/.agent/skills/performance-profiling/SKILL.md +263 -193
  335. package/.agent/skills/plan-writing/SKILL.md +156 -95
  336. package/.agent/skills/platform-engineer/SKILL.md +134 -76
  337. package/.agent/skills/platform-engineering-opentofu/SKILL.md +114 -42
  338. package/.agent/skills/playwright-ai-e2e/SKILL.md +100 -28
  339. package/.agent/skills/playwright-best-practices/SKILL.md +174 -116
  340. package/.agent/skills/polish/SKILL.md +90 -20
  341. package/.agent/skills/powershell-windows/SKILL.md +156 -86
  342. package/.agent/skills/pricing-page/SKILL.md +91 -21
  343. package/.agent/skills/product-aware-heuristics/SKILL.md +424 -354
  344. package/.agent/skills/progressive-blur/SKILL.md +122 -52
  345. package/.agent/skills/project-idioms/SKILL.md +125 -55
  346. package/.agent/skills/property-based-testing/SKILL.md +104 -32
  347. package/.agent/skills/python-patterns/SKILL.md +245 -187
  348. package/.agent/skills/python-pro/SKILL.md +333 -272
  349. package/.agent/skills/quieter/SKILL.md +91 -21
  350. package/.agent/skills/react-doctor/SKILL.md +93 -23
  351. package/.agent/skills/react-specialist/SKILL.md +309 -248
  352. package/.agent/skills/readme-builder/SKILL.md +294 -236
  353. package/.agent/skills/realtime-patterns/SKILL.md +317 -247
  354. package/.agent/skills/red-team-tactics/SKILL.md +220 -159
  355. package/.agent/skills/redesign-skill/SKILL.md +88 -18
  356. package/.agent/skills/review-animations/SKILL.md +91 -21
  357. package/.agent/skills/review-animations/STANDARDS.md +87 -87
  358. package/.agent/skills/rust-pro/SKILL.md +680 -619
  359. package/.agent/skills/semantic-filesystem-navigation/SKILL.md +69 -14
  360. package/.agent/skills/seo-fundamentals/SKILL.md +165 -107
  361. package/.agent/skills/server-management/SKILL.md +203 -145
  362. package/.agent/skills/session-log-interrogation/SKILL.md +70 -18
  363. package/.agent/skills/shadcn-ui-expert/SKILL.md +221 -163
  364. package/.agent/skills/shape/SKILL.md +96 -26
  365. package/.agent/skills/skill-creator/SKILL.md +213 -145
  366. package/.agent/skills/soft-skill/SKILL.md +95 -25
  367. package/.agent/skills/sounds-on-the-web/SKILL.md +115 -45
  368. package/.agent/skills/sql-pro/SKILL.md +653 -592
  369. package/.agent/skills/subagent-driven-development/SKILL.md +78 -18
  370. package/.agent/skills/supabase-postgres-best-practices/SKILL.md +93 -32
  371. package/.agent/skills/svg-animation/SKILL.md +388 -319
  372. package/.agent/skills/swiftui-expert/SKILL.md +190 -132
  373. package/.agent/skills/swiss-design/SKILL.md +87 -17
  374. package/.agent/skills/system-design-pro/SKILL.md +238 -294
  375. package/.agent/skills/systematic-debugging/SKILL.md +154 -96
  376. package/.agent/skills/systematic-debugging/condition-based-waiting.md +120 -120
  377. package/.agent/skills/systematic-debugging/defense-in-depth.md +128 -128
  378. package/.agent/skills/systematic-debugging/root-cause-tracing.md +183 -183
  379. package/.agent/skills/tailwind-patterns/SKILL.md +617 -547
  380. package/.agent/skills/taste-skill/SKILL.md +94 -24
  381. package/.agent/skills/tdd-workflow/SKILL.md +133 -72
  382. package/.agent/skills/test-result-analyzer/SKILL.md +304 -234
  383. package/.agent/skills/testing-patterns/SKILL.md +567 -497
  384. package/.agent/skills/thermo-nuclear-code-quality-review/SKILL.md +104 -34
  385. package/.agent/skills/thinking-protocol/SKILL.md +65 -7
  386. package/.agent/skills/to-spring-or-not-to-spring/SKILL.md +90 -20
  387. package/.agent/skills/train-sentence-transformers/SKILL.md +86 -8
  388. package/.agent/skills/transformers-js/SKILL.md +86 -15
  389. package/.agent/skills/transformers-js/references/CONFIGURATION.md +1 -1
  390. package/.agent/skills/transitions-dev/SKILL.md +136 -66
  391. package/.agent/skills/trend-researcher/SKILL.md +232 -162
  392. package/.agent/skills/tribunal-instincts-memory/SKILL.md +74 -19
  393. package/.agent/skills/trl-training/SKILL.md +86 -16
  394. package/.agent/skills/typescript-advanced/SKILL.md +334 -273
  395. package/.agent/skills/typeset/SKILL.md +101 -31
  396. package/.agent/skills/ui-reasoning-engine/SKILL.md +191 -121
  397. package/.agent/skills/ui-skill-packs/SKILL.md +95 -25
  398. package/.agent/skills/ui-skills-root/SKILL.md +118 -48
  399. package/.agent/skills/ui-ux-pro-max/SKILL.md +145 -75
  400. package/.agent/skills/ui-ux-researcher/SKILL.md +235 -165
  401. package/.agent/skills/vector-search-pgvector/SKILL.md +118 -46
  402. package/.agent/skills/verification-before-completion/SKILL.md +151 -79
  403. package/.agent/skills/vue-expert/SKILL.md +288 -227
  404. package/.agent/skills/vulnerability-scanner/SKILL.md +409 -342
  405. package/.agent/skills/web-accessibility-auditor/SKILL.md +204 -146
  406. package/.agent/skills/web-design-guidelines/SKILL.md +92 -22
  407. package/.agent/skills/web-quality-audit/SKILL.md +90 -20
  408. package/.agent/skills/webapp-testing/SKILL.md +152 -94
  409. package/.agent/skills/webgpu-performance/SKILL.md +126 -56
  410. package/.agent/skills/whimsy-injector/SKILL.md +339 -269
  411. package/.agent/skills/workflow-optimizer/SKILL.md +222 -152
  412. package/.agent/skills/zero-trust-passkeys/SKILL.md +135 -63
  413. package/.agent/skills_inventory.json +6922 -0
  414. package/.agent/templates/DESIGN.md +843 -843
  415. package/.agent/templates/design-tokens.json +140 -140
  416. package/.agent/templates/sdd/implementer-prompt.md +62 -62
  417. package/.agent/templates/sdd/re-review-prompt.md +36 -36
  418. package/.agent/templates/sdd/task-reviewer-prompt.md +78 -78
  419. package/.agent/workflows/acf.md +153 -153
  420. package/.agent/workflows/api-tester.md +189 -189
  421. package/.agent/workflows/arch.md +80 -0
  422. package/.agent/workflows/assimilate.md +24 -21
  423. package/.agent/workflows/audit-live.md +53 -53
  424. package/.agent/workflows/audit.md +171 -172
  425. package/.agent/workflows/brainstorm.md +157 -157
  426. package/.agent/workflows/changelog.md +152 -152
  427. package/.agent/workflows/compare-web.md +35 -35
  428. package/.agent/workflows/context.md +102 -102
  429. package/.agent/workflows/contract.md +79 -79
  430. package/.agent/workflows/create.md +182 -182
  431. package/.agent/workflows/debug.md +201 -201
  432. package/.agent/workflows/deploy.md +215 -215
  433. package/.agent/workflows/enhance.md +165 -165
  434. package/.agent/workflows/fix-ci.md +94 -94
  435. package/.agent/workflows/fix.md +149 -149
  436. package/.agent/workflows/generate.md +221 -216
  437. package/.agent/workflows/htop.md +26 -22
  438. package/.agent/workflows/marathon.md +290 -291
  439. package/.agent/workflows/migrate.md +198 -198
  440. package/.agent/workflows/minimal.md +101 -101
  441. package/.agent/workflows/orchestrate.md +205 -205
  442. package/.agent/workflows/performance-benchmarker.md +148 -148
  443. package/.agent/workflows/pipeline.md +165 -165
  444. package/.agent/workflows/plan.md +206 -206
  445. package/.agent/workflows/preview.md +116 -116
  446. package/.agent/workflows/refactor.md +207 -207
  447. package/.agent/workflows/resume.md +23 -20
  448. package/.agent/workflows/review-ai.md +139 -139
  449. package/.agent/workflows/review.md +155 -155
  450. package/.agent/workflows/sdd.md +137 -137
  451. package/.agent/workflows/session.md +135 -135
  452. package/.agent/workflows/skill-enhancement-engine.md +84 -84
  453. package/.agent/workflows/status.md +112 -112
  454. package/.agent/workflows/strengthen-skills.md +174 -174
  455. package/.agent/workflows/super-prompt.md +146 -146
  456. package/.agent/workflows/swarm.md +218 -218
  457. package/.agent/workflows/team-mode.md +25 -22
  458. package/.agent/workflows/test.md +224 -224
  459. package/.agent/workflows/tribunal-backend.md +161 -149
  460. package/.agent/workflows/tribunal-cicd.md +109 -109
  461. package/.agent/workflows/tribunal-database.md +142 -142
  462. package/.agent/workflows/tribunal-frontend.md +163 -157
  463. package/.agent/workflows/tribunal-full.md +156 -156
  464. package/.agent/workflows/tribunal-mobile.md +142 -142
  465. package/.agent/workflows/tribunal-performance.md +149 -149
  466. package/.agent/workflows/tribunal-speed.md +222 -222
  467. package/.agent/workflows/tribunal-ui.md +102 -97
  468. package/.agent/workflows/ui-ux-pro-max.md +103 -103
  469. package/.agents/skills/12-principles-of-animation/SKILL.md +91 -21
  470. package/.agents/skills/60fps-animation/SKILL.md +118 -61
  471. package/.agents/skills/accessible-animation/SKILL.md +214 -152
  472. package/.agents/skills/adapt/SKILL.md +98 -28
  473. package/.agents/skills/adr-generation/SKILL.md +133 -0
  474. package/.agents/skills/advanced-rag-pipelines/SKILL.md +125 -64
  475. package/.agents/skills/agent-organizer/SKILL.md +142 -84
  476. package/.agents/skills/agent-syscall-guidelines/SKILL.md +88 -13
  477. package/.agents/skills/agentic-patterns/SKILL.md +314 -244
  478. package/.agents/skills/agentic-workflows-2026/SKILL.md +137 -65
  479. package/.agents/skills/agentshield-security/SKILL.md +74 -15
  480. package/.agents/skills/ai-app-hardening/SKILL.md +99 -27
  481. package/.agents/skills/ai-prompt-injection-defense/SKILL.md +191 -130
  482. package/.agents/skills/animation-on-scroll/SKILL.md +225 -163
  483. package/.agents/skills/animation-systems/SKILL.md +227 -165
  484. package/.agents/skills/antfu-conventions/SKILL.md +96 -26
  485. package/.agents/skills/anti-slop-enforcement/SKILL.md +118 -0
  486. package/.agents/skills/api-patterns/SKILL.md +247 -186
  487. package/.agents/skills/api-security-auditor/SKILL.md +204 -126
  488. package/.agents/skills/app-builder/SKILL.md +556 -501
  489. package/.agents/skills/app-builder/templates/SKILL.md +108 -108
  490. package/.agents/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -76
  491. package/.agents/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -92
  492. package/.agents/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -88
  493. package/.agents/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -88
  494. package/.agents/skills/app-builder/templates/express-api/TEMPLATE.md +83 -83
  495. package/.agents/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -90
  496. package/.agents/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -90
  497. package/.agents/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +126 -126
  498. package/.agents/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +127 -127
  499. package/.agents/skills/app-builder/templates/nextjs-static/TEMPLATE.md +172 -172
  500. package/.agents/skills/app-builder/templates/nuxt-app/TEMPLATE.md +139 -139
  501. package/.agents/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -83
  502. package/.agents/skills/app-builder/templates/react-native-app/TEMPLATE.md +122 -122
  503. package/.agents/skills/appflow-wireframe/SKILL.md +129 -69
  504. package/.agents/skills/apple-design/SKILL.md +130 -60
  505. package/.agents/skills/architecture/SKILL.md +216 -155
  506. package/.agents/skills/architecture-drift/SKILL.md +121 -0
  507. package/.agents/skills/architecture-intelligence/SKILL.md +53 -0
  508. package/.agents/skills/audit-and-fix/SKILL.md +133 -63
  509. package/.agents/skills/authentication-best-practices/SKILL.md +191 -121
  510. package/.agents/skills/autonomous-execution/SKILL.md +154 -0
  511. package/.agents/skills/backend-alembic/SKILL.md +91 -0
  512. package/.agents/skills/backend-architecture-auditor/SKILL.md +101 -0
  513. package/.agents/skills/backend-mongodb/SKILL.md +133 -0
  514. package/.agents/skills/backend-mysql/SKILL.md +84 -0
  515. package/.agents/skills/backend-performance-auditor/SKILL.md +100 -0
  516. package/.agents/skills/backend-postgresql/SKILL.md +117 -0
  517. package/.agents/skills/backend-redis/SKILL.md +122 -0
  518. package/.agents/skills/backend-security-expert/SKILL.md +111 -50
  519. package/.agents/skills/backend-sqlalchemy/SKILL.md +107 -0
  520. package/.agents/skills/backend-sqlite/SKILL.md +93 -0
  521. package/.agents/skills/backend-testing-auditor/SKILL.md +113 -0
  522. package/.agents/skills/baseline-ui/SKILL.md +99 -29
  523. package/.agents/skills/bash-linux/SKILL.md +164 -106
  524. package/.agents/skills/behavioral-modes/SKILL.md +235 -165
  525. package/.agents/skills/better-colors/SKILL.md +153 -83
  526. package/.agents/skills/better-typography/SKILL.md +137 -67
  527. package/.agents/skills/better-ui/SKILL.md +160 -99
  528. package/.agents/skills/bolder/SKILL.md +91 -21
  529. package/.agents/skills/brainstorming/SKILL.md +494 -434
  530. package/.agents/skills/browser-audit/SKILL.md +134 -64
  531. package/.agents/skills/browser-native-ai/SKILL.md +111 -41
  532. package/.agents/skills/build-primitive/SKILL.md +93 -23
  533. package/.agents/skills/building-native-ui/SKILL.md +191 -130
  534. package/.agents/skills/cicd-pro/SKILL.md +440 -379
  535. package/.agents/skills/clarify/SKILL.md +98 -28
  536. package/.agents/skills/clean-code/SKILL.md +395 -334
  537. package/.agents/skills/cloud-architect/SKILL.md +437 -376
  538. package/.agents/skills/cobejs/SKILL.md +120 -50
  539. package/.agents/skills/code-review-checklist/SKILL.md +198 -128
  540. package/.agents/skills/codebase-design/SKILL.md +109 -48
  541. package/.agents/skills/colorize/SKILL.md +100 -30
  542. package/.agents/skills/compact-landing/SKILL.md +93 -23
  543. package/.agents/skills/company-logos/SKILL.md +96 -26
  544. package/.agents/skills/config-validator/SKILL.md +151 -93
  545. package/.agents/skills/containerization-pro/SKILL.md +450 -389
  546. package/.agents/skills/context-engineering-pro/SKILL.md +113 -41
  547. package/.agents/skills/create-design-md/SKILL.md +128 -58
  548. package/.agents/skills/critique/SKILL.md +115 -45
  549. package/.agents/skills/csharp-developer/SKILL.md +512 -442
  550. package/.agents/skills/data-validation-schemas/SKILL.md +321 -263
  551. package/.agents/skills/database-design/SKILL.md +247 -186
  552. package/.agents/skills/delight/SKILL.md +88 -18
  553. package/.agents/skills/deployment-procedures/SKILL.md +159 -101
  554. package/.agents/skills/design-lab/SKILL.md +85 -15
  555. package/.agents/skills/devops-engineer/SKILL.md +339 -269
  556. package/.agents/skills/devops-incident-responder/SKILL.md +130 -72
  557. package/.agents/skills/diagnosing-bugs/SKILL.md +208 -138
  558. package/.agents/skills/distill/SKILL.md +88 -18
  559. package/.agents/skills/documentation-templates/SKILL.md +275 -217
  560. package/.agents/skills/domain-modeling/SKILL.md +101 -31
  561. package/.agents/skills/duckdb-analytical-sql/SKILL.md +100 -28
  562. package/.agents/skills/edge-ai-mobile/SKILL.md +92 -20
  563. package/.agents/skills/edge-computing/SKILL.md +168 -110
  564. package/.agents/skills/emil-design-eng/SKILL.md +170 -100
  565. package/.agents/skills/error-resilience/SKILL.md +431 -370
  566. package/.agents/skills/expo-router-v4/SKILL.md +126 -54
  567. package/.agents/skills/extract-design-system/SKILL.md +146 -88
  568. package/.agents/skills/fabel-protocol/SKILL.md +316 -246
  569. package/.agents/skills/failure-mode-analysis/SKILL.md +124 -0
  570. package/.agents/skills/fastapi-pro/SKILL.md +123 -0
  571. package/.agents/skills/fixing-accessibility/SKILL.md +129 -59
  572. package/.agents/skills/fixing-metadata/SKILL.md +130 -60
  573. package/.agents/skills/fixing-motion-performance/SKILL.md +115 -45
  574. package/.agents/skills/framer-motion-expert/SKILL.md +259 -204
  575. package/.agents/skills/frontend-design/SKILL.md +139 -69
  576. package/.agents/skills/frontend-security-expert/SKILL.md +94 -33
  577. package/.agents/skills/game-design-expert/SKILL.md +126 -68
  578. package/.agents/skills/game-engineering-expert/SKILL.md +135 -77
  579. package/.agents/skills/generative-ui-expert/SKILL.md +142 -72
  580. package/.agents/skills/geo-fundamentals/SKILL.md +134 -76
  581. package/.agents/skills/git-pro/SKILL.md +429 -368
  582. package/.agents/skills/github-operations/SKILL.md +329 -259
  583. package/.agents/skills/gpt-taste/SKILL.md +92 -22
  584. package/.agents/skills/graph-engineering/SKILL.md +104 -16
  585. package/.agents/skills/gsap-core/SKILL.md +312 -242
  586. package/.agents/skills/gsap-frameworks/SKILL.md +204 -134
  587. package/.agents/skills/gsap-performance/SKILL.md +130 -60
  588. package/.agents/skills/gsap-plugins/SKILL.md +476 -406
  589. package/.agents/skills/gsap-react/SKILL.md +248 -178
  590. package/.agents/skills/gsap-scrolltrigger/SKILL.md +347 -277
  591. package/.agents/skills/gsap-timeline/SKILL.md +157 -87
  592. package/.agents/skills/gsap-utils/SKILL.md +334 -264
  593. package/.agents/skills/harden/SKILL.md +97 -27
  594. package/.agents/skills/harness-protocol/SKILL.md +91 -21
  595. package/.agents/skills/hf-cli/SKILL.md +86 -6
  596. package/.agents/skills/hf-cloud-aws-context-discovery/SKILL.md +86 -8
  597. package/.agents/skills/hf-cloud-python-env-setup/SKILL.md +86 -8
  598. package/.agents/skills/hf-cloud-sagemaker-deployment-planner/SKILL.md +86 -8
  599. package/.agents/skills/hf-cloud-sagemaker-iam-preflight/SKILL.md +86 -8
  600. package/.agents/skills/hf-cloud-sagemaker-production-defaults/SKILL.md +86 -8
  601. package/.agents/skills/hf-cloud-serving-image-selection/SKILL.md +86 -8
  602. package/.agents/skills/hf-mem/SKILL.md +86 -6
  603. package/.agents/skills/huggingface-best/SKILL.md +86 -16
  604. package/.agents/skills/huggingface-community-evals/SKILL.md +86 -8
  605. package/.agents/skills/huggingface-datasets/SKILL.md +86 -8
  606. package/.agents/skills/huggingface-gradio/SKILL.md +86 -8
  607. package/.agents/skills/huggingface-llm-trainer/SKILL.md +86 -9
  608. package/.agents/skills/huggingface-local-models/SKILL.md +86 -8
  609. package/.agents/skills/huggingface-lora-space-builder/SKILL.md +86 -8
  610. package/.agents/skills/huggingface-paper-publisher/SKILL.md +86 -7
  611. package/.agents/skills/huggingface-papers/SKILL.md +86 -8
  612. package/.agents/skills/huggingface-spaces/SKILL.md +87 -9
  613. package/.agents/skills/huggingface-tool-builder/SKILL.md +86 -8
  614. package/.agents/skills/huggingface-trackio/SKILL.md +77 -8
  615. package/.agents/skills/huggingface-vision-trainer/SKILL.md +86 -8
  616. package/.agents/skills/huggingface-zerogpu/SKILL.md +86 -8
  617. package/.agents/skills/human-gate-negotiation/SKILL.md +83 -17
  618. package/.agents/skills/i18n-localization/SKILL.md +160 -102
  619. package/.agents/skills/impeccable/SKILL.md +95 -25
  620. package/.agents/skills/improve-codebase-architecture/SKILL.md +90 -20
  621. package/.agents/skills/improve-ui/SKILL.md +107 -37
  622. package/.agents/skills/intelligent-routing/SKILL.md +243 -180
  623. package/.agents/skills/knowledge-graph/SKILL.md +109 -39
  624. package/.agents/skills/landing-page/SKILL.md +106 -36
  625. package/.agents/skills/lint-and-validate/SKILL.md +249 -191
  626. package/.agents/skills/llm-engineering/SKILL.md +394 -324
  627. package/.agents/skills/local-first/SKILL.md +163 -105
  628. package/.agents/skills/local-first-architecture/SKILL.md +100 -39
  629. package/.agents/skills/lottie-animation/SKILL.md +109 -39
  630. package/.agents/skills/marquee-loop/SKILL.md +121 -51
  631. package/.agents/skills/masked-reveal/SKILL.md +267 -198
  632. package/.agents/skills/mcp-builder/SKILL.md +131 -73
  633. package/.agents/skills/micro-interaction/SKILL.md +281 -219
  634. package/.agents/skills/mobile-design/SKILL.md +274 -213
  635. package/.agents/skills/monorepo-management/SKILL.md +319 -261
  636. package/.agents/skills/morphing-icons/SKILL.md +379 -310
  637. package/.agents/skills/motion-engineering/SKILL.md +225 -164
  638. package/.agents/skills/nextjs-react-expert/SKILL.md +247 -186
  639. package/.agents/skills/nodejs-best-practices/SKILL.md +570 -509
  640. package/.agents/skills/observability/SKILL.md +337 -267
  641. package/.agents/skills/opentelemetry-observability/SKILL.md +106 -34
  642. package/.agents/skills/page-transition-animation/SKILL.md +130 -60
  643. package/.agents/skills/parallel-agents/SKILL.md +136 -78
  644. package/.agents/skills/performance-profiling/SKILL.md +263 -193
  645. package/.agents/skills/plan-writing/SKILL.md +156 -95
  646. package/.agents/skills/platform-engineer/SKILL.md +134 -76
  647. package/.agents/skills/platform-engineering-opentofu/SKILL.md +114 -42
  648. package/.agents/skills/playwright-ai-e2e/SKILL.md +100 -28
  649. package/.agents/skills/playwright-best-practices/SKILL.md +174 -116
  650. package/.agents/skills/polish/SKILL.md +90 -20
  651. package/.agents/skills/powershell-windows/SKILL.md +156 -86
  652. package/.agents/skills/pricing-page/SKILL.md +91 -21
  653. package/.agents/skills/product-aware-heuristics/SKILL.md +424 -354
  654. package/.agents/skills/progressive-blur/SKILL.md +122 -52
  655. package/.agents/skills/project-idioms/SKILL.md +125 -55
  656. package/.agents/skills/property-based-testing/SKILL.md +104 -32
  657. package/.agents/skills/python-patterns/SKILL.md +245 -187
  658. package/.agents/skills/python-pro/SKILL.md +333 -272
  659. package/.agents/skills/quieter/SKILL.md +91 -21
  660. package/.agents/skills/react-doctor/SKILL.md +93 -23
  661. package/.agents/skills/react-specialist/SKILL.md +309 -248
  662. package/.agents/skills/readme-builder/SKILL.md +294 -236
  663. package/.agents/skills/realtime-patterns/SKILL.md +317 -247
  664. package/.agents/skills/red-team-tactics/SKILL.md +220 -159
  665. package/.agents/skills/redesign-skill/SKILL.md +88 -18
  666. package/.agents/skills/review-animations/SKILL.md +91 -21
  667. package/.agents/skills/review-animations/STANDARDS.md +87 -87
  668. package/.agents/skills/rust-pro/SKILL.md +680 -619
  669. package/.agents/skills/semantic-filesystem-navigation/SKILL.md +69 -14
  670. package/.agents/skills/seo-fundamentals/SKILL.md +165 -107
  671. package/.agents/skills/server-management/SKILL.md +203 -145
  672. package/.agents/skills/session-log-interrogation/SKILL.md +70 -18
  673. package/.agents/skills/shadcn-ui-expert/SKILL.md +221 -163
  674. package/.agents/skills/shape/SKILL.md +96 -26
  675. package/.agents/skills/skill-creator/SKILL.md +213 -145
  676. package/.agents/skills/soft-skill/SKILL.md +95 -25
  677. package/.agents/skills/sounds-on-the-web/SKILL.md +115 -45
  678. package/.agents/skills/sql-pro/SKILL.md +653 -592
  679. package/.agents/skills/subagent-driven-development/SKILL.md +78 -18
  680. package/.agents/skills/supabase-postgres-best-practices/SKILL.md +93 -32
  681. package/.agents/skills/svg-animation/SKILL.md +388 -319
  682. package/.agents/skills/swiftui-expert/SKILL.md +190 -132
  683. package/.agents/skills/swiss-design/SKILL.md +87 -17
  684. package/.agents/skills/system-design-pro/SKILL.md +238 -294
  685. package/.agents/skills/systematic-debugging/SKILL.md +154 -96
  686. package/.agents/skills/systematic-debugging/condition-based-waiting.md +120 -120
  687. package/.agents/skills/systematic-debugging/defense-in-depth.md +128 -128
  688. package/.agents/skills/systematic-debugging/root-cause-tracing.md +183 -183
  689. package/.agents/skills/tailwind-patterns/SKILL.md +617 -547
  690. package/.agents/skills/taste-skill/SKILL.md +94 -24
  691. package/.agents/skills/tdd-workflow/SKILL.md +133 -72
  692. package/.agents/skills/test-result-analyzer/SKILL.md +304 -234
  693. package/.agents/skills/testing-patterns/SKILL.md +567 -497
  694. package/.agents/skills/thermo-nuclear-code-quality-review/SKILL.md +104 -34
  695. package/.agents/skills/thinking-protocol/SKILL.md +65 -7
  696. package/.agents/skills/to-spring-or-not-to-spring/SKILL.md +90 -20
  697. package/.agents/skills/train-sentence-transformers/SKILL.md +86 -8
  698. package/.agents/skills/transformers-js/SKILL.md +86 -15
  699. package/.agents/skills/transformers-js/references/CONFIGURATION.md +1 -1
  700. package/.agents/skills/transitions-dev/SKILL.md +136 -66
  701. package/.agents/skills/trend-researcher/SKILL.md +232 -162
  702. package/.agents/skills/tribunal-instincts-memory/SKILL.md +74 -19
  703. package/.agents/skills/trl-training/SKILL.md +86 -16
  704. package/.agents/skills/typescript-advanced/SKILL.md +334 -273
  705. package/.agents/skills/typeset/SKILL.md +101 -31
  706. package/.agents/skills/ui-reasoning-engine/SKILL.md +191 -121
  707. package/.agents/skills/ui-skill-packs/SKILL.md +95 -25
  708. package/.agents/skills/ui-skills-root/SKILL.md +118 -48
  709. package/.agents/skills/ui-ux-pro-max/SKILL.md +145 -75
  710. package/.agents/skills/ui-ux-researcher/SKILL.md +235 -165
  711. package/.agents/skills/vector-search-pgvector/SKILL.md +118 -46
  712. package/.agents/skills/verification-before-completion/SKILL.md +151 -79
  713. package/.agents/skills/vue-expert/SKILL.md +288 -227
  714. package/.agents/skills/vulnerability-scanner/SKILL.md +409 -342
  715. package/.agents/skills/web-accessibility-auditor/SKILL.md +204 -146
  716. package/.agents/skills/web-design-guidelines/SKILL.md +92 -22
  717. package/.agents/skills/web-quality-audit/SKILL.md +90 -20
  718. package/.agents/skills/webapp-testing/SKILL.md +152 -94
  719. package/.agents/skills/webgpu-performance/SKILL.md +126 -56
  720. package/.agents/skills/whimsy-injector/SKILL.md +339 -269
  721. package/.agents/skills/workflow-optimizer/SKILL.md +222 -152
  722. package/.agents/skills/zero-trust-passkeys/SKILL.md +135 -63
  723. package/AGENTS.md +93 -93
  724. package/CLAUDE.md +444 -444
  725. package/CONTRIBUTING.md +134 -134
  726. package/README.md +264 -242
  727. package/SECURITY.md +58 -52
  728. package/bin/adapter-install.js +264 -264
  729. package/bin/global-store.js +48 -48
  730. package/bin/mcp-server.js +1662 -1653
  731. package/bin/proxy-server.js +122 -122
  732. package/bin/spawn-agent.js +45 -45
  733. package/bin/tk-proxy.js +34 -34
  734. package/bin/tribunal-kit.js +113 -113
  735. package/bin/wrapper.js +225 -211
  736. package/hooks/hooks-cursor.json +10 -10
  737. package/hooks/hooks.json +10 -10
  738. package/hooks/session-start.js +77 -77
  739. package/mcp_config.json +18 -18
  740. package/package.json +20 -31
  741. package/{.claude-plugin → plugins/claude}/marketplace.json +14 -14
  742. package/{.claude-plugin → plugins/claude}/plugin.json +26 -26
  743. package/{.codex-plugin → plugins/codex}/plugin.json +41 -41
  744. package/{plugin.json → plugins/core-plugin.json} +1 -1
  745. package/{.cursor-plugin → plugins/cursor}/plugin.json +26 -26
  746. package/{.devin-plugin → plugins/devin}/plugin.json +14 -14
  747. package/{gemini-extension.json → plugins/gemini/extension.json} +1 -1
  748. package/{.hermes-plugin → plugins/hermes}/__init__.py +102 -102
  749. package/{.hermes-plugin → plugins/hermes}/plugin.yaml +6 -6
  750. package/{.kimi-plugin → plugins/kimi}/plugin.json +34 -34
  751. package/{marketplace.json → plugins/marketplace.json} +14 -14
  752. package/{.opencode → plugins/opencode}/INSTALL.md +42 -42
  753. package/{.opencode → plugins/opencode}/plugins/tribunal.js +110 -110
  754. package/{.opencode → plugins/opencode}/rules.md +258 -258
  755. package/{.pi → plugins/pi}/extensions/tribunal.ts +130 -130
  756. package/skills/12-principles-of-animation/SKILL.md +91 -21
  757. package/skills/60fps-animation/SKILL.md +118 -61
  758. package/skills/accessible-animation/SKILL.md +214 -152
  759. package/skills/adapt/SKILL.md +98 -28
  760. package/skills/adr-generation/SKILL.md +133 -0
  761. package/skills/advanced-rag-pipelines/SKILL.md +125 -64
  762. package/skills/agent-organizer/SKILL.md +142 -84
  763. package/skills/agent-syscall-guidelines/SKILL.md +88 -13
  764. package/skills/agentic-patterns/SKILL.md +314 -244
  765. package/skills/agentic-workflows-2026/SKILL.md +137 -65
  766. package/skills/agentshield-security/SKILL.md +74 -15
  767. package/skills/ai-app-hardening/SKILL.md +99 -27
  768. package/skills/ai-prompt-injection-defense/SKILL.md +191 -130
  769. package/skills/animation-on-scroll/SKILL.md +225 -163
  770. package/skills/animation-systems/SKILL.md +227 -165
  771. package/skills/antfu-conventions/SKILL.md +96 -26
  772. package/skills/anti-slop-enforcement/SKILL.md +118 -0
  773. package/skills/api-patterns/SKILL.md +247 -186
  774. package/skills/api-security-auditor/SKILL.md +204 -126
  775. package/skills/app-builder/SKILL.md +556 -501
  776. package/skills/app-builder/templates/SKILL.md +108 -108
  777. package/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -76
  778. package/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -92
  779. package/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -88
  780. package/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -88
  781. package/skills/app-builder/templates/express-api/TEMPLATE.md +83 -83
  782. package/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -90
  783. package/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -90
  784. package/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +126 -126
  785. package/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +127 -127
  786. package/skills/app-builder/templates/nextjs-static/TEMPLATE.md +172 -172
  787. package/skills/app-builder/templates/nuxt-app/TEMPLATE.md +139 -139
  788. package/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -83
  789. package/skills/app-builder/templates/react-native-app/TEMPLATE.md +122 -122
  790. package/skills/appflow-wireframe/SKILL.md +129 -69
  791. package/skills/apple-design/SKILL.md +130 -60
  792. package/skills/architecture/SKILL.md +216 -155
  793. package/skills/architecture-drift/SKILL.md +121 -0
  794. package/skills/architecture-intelligence/SKILL.md +53 -0
  795. package/skills/audit-and-fix/SKILL.md +133 -63
  796. package/skills/authentication-best-practices/SKILL.md +191 -121
  797. package/skills/autonomous-execution/SKILL.md +154 -0
  798. package/skills/backend-alembic/SKILL.md +91 -0
  799. package/skills/backend-architecture-auditor/SKILL.md +101 -0
  800. package/skills/backend-mongodb/SKILL.md +133 -0
  801. package/skills/backend-mysql/SKILL.md +84 -0
  802. package/skills/backend-performance-auditor/SKILL.md +100 -0
  803. package/skills/backend-postgresql/SKILL.md +117 -0
  804. package/skills/backend-redis/SKILL.md +122 -0
  805. package/skills/backend-security-expert/SKILL.md +111 -50
  806. package/skills/backend-sqlalchemy/SKILL.md +107 -0
  807. package/skills/backend-sqlite/SKILL.md +93 -0
  808. package/skills/backend-testing-auditor/SKILL.md +113 -0
  809. package/skills/baseline-ui/SKILL.md +99 -29
  810. package/skills/bash-linux/SKILL.md +164 -106
  811. package/skills/behavioral-modes/SKILL.md +235 -165
  812. package/skills/better-colors/SKILL.md +153 -83
  813. package/skills/better-typography/SKILL.md +137 -67
  814. package/skills/better-ui/SKILL.md +160 -99
  815. package/skills/bolder/SKILL.md +91 -21
  816. package/skills/brainstorming/SKILL.md +494 -434
  817. package/skills/browser-audit/SKILL.md +134 -64
  818. package/skills/browser-native-ai/SKILL.md +111 -41
  819. package/skills/build-primitive/SKILL.md +93 -23
  820. package/skills/building-native-ui/SKILL.md +191 -130
  821. package/skills/cicd-pro/SKILL.md +440 -379
  822. package/skills/clarify/SKILL.md +98 -28
  823. package/skills/clean-code/SKILL.md +395 -334
  824. package/skills/cloud-architect/SKILL.md +437 -376
  825. package/skills/cobejs/SKILL.md +120 -50
  826. package/skills/code-review-checklist/SKILL.md +198 -128
  827. package/skills/codebase-design/SKILL.md +109 -48
  828. package/skills/colorize/SKILL.md +100 -30
  829. package/skills/compact-landing/SKILL.md +93 -23
  830. package/skills/company-logos/SKILL.md +96 -26
  831. package/skills/config-validator/SKILL.md +151 -93
  832. package/skills/containerization-pro/SKILL.md +450 -389
  833. package/skills/context-engineering-pro/SKILL.md +113 -41
  834. package/skills/create-design-md/SKILL.md +128 -58
  835. package/skills/critique/SKILL.md +115 -45
  836. package/skills/csharp-developer/SKILL.md +512 -442
  837. package/skills/data-validation-schemas/SKILL.md +321 -263
  838. package/skills/database-design/SKILL.md +247 -186
  839. package/skills/delight/SKILL.md +88 -18
  840. package/skills/deployment-procedures/SKILL.md +159 -101
  841. package/skills/design-lab/SKILL.md +85 -15
  842. package/skills/devops-engineer/SKILL.md +339 -269
  843. package/skills/devops-incident-responder/SKILL.md +130 -72
  844. package/skills/diagnosing-bugs/SKILL.md +208 -138
  845. package/skills/distill/SKILL.md +88 -18
  846. package/skills/documentation-templates/SKILL.md +275 -217
  847. package/skills/domain-modeling/SKILL.md +101 -31
  848. package/skills/duckdb-analytical-sql/SKILL.md +100 -28
  849. package/skills/edge-ai-mobile/SKILL.md +92 -20
  850. package/skills/edge-computing/SKILL.md +168 -110
  851. package/skills/emil-design-eng/SKILL.md +170 -100
  852. package/skills/error-resilience/SKILL.md +431 -370
  853. package/skills/expo-router-v4/SKILL.md +126 -54
  854. package/skills/extract-design-system/SKILL.md +146 -88
  855. package/skills/fabel-protocol/SKILL.md +316 -246
  856. package/skills/failure-mode-analysis/SKILL.md +124 -0
  857. package/skills/fastapi-pro/SKILL.md +123 -0
  858. package/skills/fixing-accessibility/SKILL.md +129 -59
  859. package/skills/fixing-metadata/SKILL.md +130 -60
  860. package/skills/fixing-motion-performance/SKILL.md +115 -45
  861. package/skills/framer-motion-expert/SKILL.md +259 -204
  862. package/skills/frontend-design/SKILL.md +139 -69
  863. package/skills/frontend-security-expert/SKILL.md +94 -33
  864. package/skills/game-design-expert/SKILL.md +126 -68
  865. package/skills/game-engineering-expert/SKILL.md +135 -77
  866. package/skills/generative-ui-expert/SKILL.md +142 -72
  867. package/skills/geo-fundamentals/SKILL.md +134 -76
  868. package/skills/git-pro/SKILL.md +429 -368
  869. package/skills/github-operations/SKILL.md +329 -259
  870. package/skills/gpt-taste/SKILL.md +92 -22
  871. package/skills/graph-engineering/SKILL.md +104 -16
  872. package/skills/gsap-core/SKILL.md +312 -242
  873. package/skills/gsap-frameworks/SKILL.md +204 -134
  874. package/skills/gsap-performance/SKILL.md +130 -60
  875. package/skills/gsap-plugins/SKILL.md +476 -406
  876. package/skills/gsap-react/SKILL.md +248 -178
  877. package/skills/gsap-scrolltrigger/SKILL.md +347 -277
  878. package/skills/gsap-timeline/SKILL.md +157 -87
  879. package/skills/gsap-utils/SKILL.md +334 -264
  880. package/skills/harden/SKILL.md +97 -27
  881. package/skills/harness-protocol/SKILL.md +91 -21
  882. package/skills/hf-cli/SKILL.md +86 -6
  883. package/skills/hf-cloud-aws-context-discovery/SKILL.md +86 -8
  884. package/skills/hf-cloud-python-env-setup/SKILL.md +86 -8
  885. package/skills/hf-cloud-sagemaker-deployment-planner/SKILL.md +86 -8
  886. package/skills/hf-cloud-sagemaker-iam-preflight/SKILL.md +86 -8
  887. package/skills/hf-cloud-sagemaker-production-defaults/SKILL.md +86 -8
  888. package/skills/hf-cloud-serving-image-selection/SKILL.md +86 -8
  889. package/skills/hf-mem/SKILL.md +86 -6
  890. package/skills/huggingface-best/SKILL.md +86 -16
  891. package/skills/huggingface-community-evals/SKILL.md +86 -8
  892. package/skills/huggingface-datasets/SKILL.md +86 -8
  893. package/skills/huggingface-gradio/SKILL.md +86 -8
  894. package/skills/huggingface-llm-trainer/SKILL.md +86 -9
  895. package/skills/huggingface-local-models/SKILL.md +86 -8
  896. package/skills/huggingface-lora-space-builder/SKILL.md +86 -8
  897. package/skills/huggingface-paper-publisher/SKILL.md +86 -7
  898. package/skills/huggingface-papers/SKILL.md +86 -8
  899. package/skills/huggingface-spaces/SKILL.md +87 -9
  900. package/skills/huggingface-tool-builder/SKILL.md +86 -8
  901. package/skills/huggingface-trackio/SKILL.md +77 -8
  902. package/skills/huggingface-vision-trainer/SKILL.md +86 -8
  903. package/skills/huggingface-zerogpu/SKILL.md +86 -8
  904. package/skills/human-gate-negotiation/SKILL.md +83 -17
  905. package/skills/i18n-localization/SKILL.md +160 -102
  906. package/skills/impeccable/SKILL.md +95 -25
  907. package/skills/improve-codebase-architecture/SKILL.md +90 -20
  908. package/skills/improve-ui/SKILL.md +107 -37
  909. package/skills/intelligent-routing/SKILL.md +243 -180
  910. package/skills/knowledge-graph/SKILL.md +109 -39
  911. package/skills/landing-page/SKILL.md +106 -36
  912. package/skills/lint-and-validate/SKILL.md +249 -191
  913. package/skills/llm-engineering/SKILL.md +394 -324
  914. package/skills/local-first/SKILL.md +163 -105
  915. package/skills/local-first-architecture/SKILL.md +100 -39
  916. package/skills/lottie-animation/SKILL.md +109 -39
  917. package/skills/marquee-loop/SKILL.md +121 -51
  918. package/skills/masked-reveal/SKILL.md +267 -198
  919. package/skills/mcp-builder/SKILL.md +131 -73
  920. package/skills/micro-interaction/SKILL.md +281 -219
  921. package/skills/mobile-design/SKILL.md +274 -213
  922. package/skills/monorepo-management/SKILL.md +319 -261
  923. package/skills/morphing-icons/SKILL.md +379 -310
  924. package/skills/motion-engineering/SKILL.md +225 -164
  925. package/skills/nextjs-react-expert/SKILL.md +247 -186
  926. package/skills/nodejs-best-practices/SKILL.md +570 -509
  927. package/skills/observability/SKILL.md +337 -267
  928. package/skills/opentelemetry-observability/SKILL.md +106 -34
  929. package/skills/page-transition-animation/SKILL.md +130 -60
  930. package/skills/parallel-agents/SKILL.md +136 -78
  931. package/skills/performance-profiling/SKILL.md +263 -193
  932. package/skills/plan-writing/SKILL.md +156 -95
  933. package/skills/platform-engineer/SKILL.md +134 -76
  934. package/skills/platform-engineering-opentofu/SKILL.md +114 -42
  935. package/skills/playwright-ai-e2e/SKILL.md +100 -28
  936. package/skills/playwright-best-practices/SKILL.md +174 -116
  937. package/skills/polish/SKILL.md +90 -20
  938. package/skills/powershell-windows/SKILL.md +156 -86
  939. package/skills/pricing-page/SKILL.md +91 -21
  940. package/skills/product-aware-heuristics/SKILL.md +424 -354
  941. package/skills/progressive-blur/SKILL.md +122 -52
  942. package/skills/project-idioms/SKILL.md +125 -55
  943. package/skills/property-based-testing/SKILL.md +104 -32
  944. package/skills/python-patterns/SKILL.md +245 -187
  945. package/skills/python-pro/SKILL.md +333 -272
  946. package/skills/quieter/SKILL.md +91 -21
  947. package/skills/react-doctor/SKILL.md +93 -23
  948. package/skills/react-specialist/SKILL.md +309 -248
  949. package/skills/readme-builder/SKILL.md +294 -236
  950. package/skills/realtime-patterns/SKILL.md +317 -247
  951. package/skills/red-team-tactics/SKILL.md +220 -159
  952. package/skills/redesign-skill/SKILL.md +88 -18
  953. package/skills/review-animations/SKILL.md +91 -21
  954. package/skills/review-animations/STANDARDS.md +87 -87
  955. package/skills/rust-pro/SKILL.md +680 -619
  956. package/skills/semantic-filesystem-navigation/SKILL.md +69 -14
  957. package/skills/seo-fundamentals/SKILL.md +165 -107
  958. package/skills/server-management/SKILL.md +203 -145
  959. package/skills/session-log-interrogation/SKILL.md +70 -18
  960. package/skills/shadcn-ui-expert/SKILL.md +221 -163
  961. package/skills/shape/SKILL.md +96 -26
  962. package/skills/skill-creator/SKILL.md +213 -145
  963. package/skills/soft-skill/SKILL.md +95 -25
  964. package/skills/sounds-on-the-web/SKILL.md +115 -45
  965. package/skills/sql-pro/SKILL.md +653 -592
  966. package/skills/subagent-driven-development/SKILL.md +78 -18
  967. package/skills/supabase-postgres-best-practices/SKILL.md +93 -32
  968. package/skills/svg-animation/SKILL.md +388 -319
  969. package/skills/swiftui-expert/SKILL.md +190 -132
  970. package/skills/swiss-design/SKILL.md +87 -17
  971. package/skills/system-design-pro/SKILL.md +238 -294
  972. package/skills/systematic-debugging/SKILL.md +154 -96
  973. package/skills/systematic-debugging/condition-based-waiting.md +120 -120
  974. package/skills/systematic-debugging/defense-in-depth.md +128 -128
  975. package/skills/systematic-debugging/root-cause-tracing.md +183 -183
  976. package/skills/tailwind-patterns/SKILL.md +617 -547
  977. package/skills/taste-skill/SKILL.md +94 -24
  978. package/skills/tdd-workflow/SKILL.md +133 -72
  979. package/skills/test-result-analyzer/SKILL.md +304 -234
  980. package/skills/testing-patterns/SKILL.md +567 -497
  981. package/skills/thermo-nuclear-code-quality-review/SKILL.md +104 -34
  982. package/skills/thinking-protocol/SKILL.md +65 -7
  983. package/skills/to-spring-or-not-to-spring/SKILL.md +90 -20
  984. package/skills/train-sentence-transformers/SKILL.md +86 -8
  985. package/skills/transformers-js/SKILL.md +86 -15
  986. package/skills/transformers-js/references/CONFIGURATION.md +1 -1
  987. package/skills/transitions-dev/SKILL.md +136 -66
  988. package/skills/trend-researcher/SKILL.md +232 -162
  989. package/skills/tribunal-instincts-memory/SKILL.md +74 -19
  990. package/skills/trl-training/SKILL.md +86 -16
  991. package/skills/typescript-advanced/SKILL.md +334 -273
  992. package/skills/typeset/SKILL.md +101 -31
  993. package/skills/ui-reasoning-engine/SKILL.md +191 -121
  994. package/skills/ui-skill-packs/SKILL.md +95 -25
  995. package/skills/ui-skills-root/SKILL.md +118 -48
  996. package/skills/ui-ux-pro-max/SKILL.md +145 -75
  997. package/skills/ui-ux-researcher/SKILL.md +235 -165
  998. package/skills/vector-search-pgvector/SKILL.md +118 -46
  999. package/skills/verification-before-completion/SKILL.md +151 -79
  1000. package/skills/vue-expert/SKILL.md +288 -227
  1001. package/skills/vulnerability-scanner/SKILL.md +409 -342
  1002. package/skills/web-accessibility-auditor/SKILL.md +204 -146
  1003. package/skills/web-design-guidelines/SKILL.md +92 -22
  1004. package/skills/web-quality-audit/SKILL.md +90 -20
  1005. package/skills/webapp-testing/SKILL.md +152 -94
  1006. package/skills/webgpu-performance/SKILL.md +126 -56
  1007. package/skills/whimsy-injector/SKILL.md +339 -269
  1008. package/skills/workflow-optimizer/SKILL.md +222 -152
  1009. package/skills/zero-trust-passkeys/SKILL.md +135 -63
  1010. package/{dist → src}/browser/audit.js +233 -229
  1011. package/{dist → src}/browser/case_bridge.js +190 -189
  1012. package/{dist → src}/browser/cdp.js +526 -513
  1013. package/{dist → src}/browser/compare.js +110 -110
  1014. package/{dist → src}/browser/discovery.js +150 -140
  1015. package/{dist → src}/browser/idpi.js +145 -142
  1016. package/{dist → src}/browser/index.js +89 -89
  1017. package/{dist → src}/browser/launcher.js +160 -154
  1018. package/{dist → src}/browser/sentinel.js +208 -202
  1019. package/{dist → src}/browser/synapse.js +251 -251
  1020. package/{dist → src}/browser/trimmer.js +219 -210
  1021. package/src/cli.js +430 -0
  1022. package/src/commands/align.js +208 -0
  1023. package/src/commands/arch.js +172 -0
  1024. package/{dist → src}/commands/audit-web.js +126 -112
  1025. package/{dist → src}/commands/browse.js +62 -56
  1026. package/src/commands/case.js +98 -0
  1027. package/{dist → src}/commands/compare-web.js +69 -61
  1028. package/src/commands/compile.js +97 -0
  1029. package/src/commands/context.js +156 -0
  1030. package/{dist → src}/commands/contract.js +423 -440
  1031. package/{dist → src}/commands/deconstruct.js +70 -58
  1032. package/src/commands/graph.js +52 -0
  1033. package/{dist → src}/commands/guardrail.js +247 -275
  1034. package/{dist → src}/commands/heal.js +109 -99
  1035. package/src/commands/hook.js +32 -0
  1036. package/src/commands/init.js +462 -0
  1037. package/src/commands/learn.js +195 -0
  1038. package/src/commands/marathon.js +68 -0
  1039. package/src/commands/memory.js +609 -0
  1040. package/src/commands/minimal.js +85 -0
  1041. package/src/commands/mutate.js +34 -0
  1042. package/src/commands/native.js +409 -0
  1043. package/src/commands/optimize.js +365 -0
  1044. package/src/commands/review.js +971 -0
  1045. package/src/commands/sdd.js +275 -0
  1046. package/{dist → src}/commands/status.js +76 -66
  1047. package/src/commands/sync.js +27 -0
  1048. package/src/commands/system1.js +312 -0
  1049. package/src/commands/uninstall.js +63 -0
  1050. package/src/commands/update.js +44 -0
  1051. package/{dist → src}/commands/validate.js +66 -58
  1052. package/src/context/ranker.js +339 -0
  1053. package/{dist → src}/esm/index.mjs +4 -2
  1054. package/src/evolution/engine.js +295 -0
  1055. package/src/mcp/server.js +8 -0
  1056. package/src/synthesis/claim_check_separator.js +271 -0
  1057. package/src/system1/laya-package-lock.json +303 -0
  1058. package/src/system1/laya-package.json +16 -0
  1059. package/src/system1/provider.js +127 -0
  1060. package/{dist → src}/tui/banner.js +1 -1
  1061. package/{dist → src}/tui/index.js +21 -21
  1062. package/{dist → src}/tui/reviewer-grid.js +86 -90
  1063. package/{dist → src}/tui/shimmer.js +89 -91
  1064. package/{dist → src}/tui/theme.js +130 -130
  1065. package/{dist → src}/tui/tree.js +93 -93
  1066. package/{dist → src}/tui/wizard.js +144 -148
  1067. package/{dist → src}/types.js +8 -8
  1068. package/src/utils/fs.js +103 -0
  1069. package/src/utils/hasher.js +144 -0
  1070. package/src/utils/helpers.js +52 -0
  1071. package/src/utils/logger.js +61 -0
  1072. package/src/utils/version.js +176 -0
  1073. package/.agent/history/README.md +0 -53
  1074. package/.agent/history/architecture-explorer.html +0 -352
  1075. package/.agent/history/architecture-graph.yaml +0 -619
  1076. package/.agent/history/case-law/cases/template-case.json +0 -19
  1077. package/.agent/history/graph-cache.json +0 -1042
  1078. package/.agent/history/memory/.memory.idx +0 -7596
  1079. package/.agent/history/memory/MEMORY.md +0 -512
  1080. package/.agent/history/memory.db +0 -0
  1081. package/.agent/history/snapshots/.opencode__plugins__tribunal.js.json +0 -12
  1082. package/.agent/history/snapshots/.pi__extensions__tribunal.ts.json +0 -12
  1083. package/.agent/history/snapshots/bin__adapter-install.js.json +0 -13
  1084. package/.agent/history/snapshots/bin__global-store.js.json +0 -15
  1085. package/.agent/history/snapshots/bin__mcp-server.js.json +0 -21
  1086. package/.agent/history/snapshots/bin__proxy-server.js.json +0 -20
  1087. package/.agent/history/snapshots/bin__spawn-agent.js.json +0 -12
  1088. package/.agent/history/snapshots/bin__tk-proxy.js.json +0 -21
  1089. package/.agent/history/snapshots/bin__tribunal-kit.js.json +0 -21
  1090. package/.agent/history/snapshots/bin__wrapper.js.json +0 -14
  1091. package/.agent/history/snapshots/eslint.config.js.json +0 -8
  1092. package/.agent/history/snapshots/hooks__session-start.js.json +0 -11
  1093. package/.agent/history/snapshots/scripts__apply-version.js.json +0 -11
  1094. package/.agent/history/snapshots/scripts__audit_skill_sdo.js.json +0 -11
  1095. package/.agent/history/snapshots/scripts__benchmark.js.json +0 -14
  1096. package/.agent/history/snapshots/scripts__changelog.js.json +0 -12
  1097. package/.agent/history/snapshots/scripts__clean-pycache.js.json +0 -11
  1098. package/.agent/history/snapshots/scripts__context_compiler.js.json +0 -17
  1099. package/.agent/history/snapshots/scripts__fix-vbc.js.json +0 -11
  1100. package/.agent/history/snapshots/scripts__modernize_skills.js.json +0 -11
  1101. package/.agent/history/snapshots/scripts__package-cores.js.json +0 -12
  1102. package/.agent/history/snapshots/scripts__skill_enhancement_engine.js.json +0 -11
  1103. package/.agent/history/snapshots/scripts__stress_benchmark.js.json +0 -15
  1104. package/.agent/history/snapshots/scripts__sync-skills.js.json +0 -11
  1105. package/.agent/history/snapshots/scripts__sync-version.js.json +0 -11
  1106. package/.agent/history/snapshots/scripts__telemetry_gc.js.json +0 -11
  1107. package/.agent/history/snapshots/scripts__validate-payload.js.json +0 -11
  1108. package/.agent/history/snapshots/scripts__visual_audit.js.json +0 -11
  1109. package/.agent/history/snapshots/test__integration__bridges.test.js.json +0 -13
  1110. package/.agent/history/snapshots/test__integration__browser_cli.test.js.json +0 -12
  1111. package/.agent/history/snapshots/test__integration__graceful_degradation.test.js.json +0 -12
  1112. package/.agent/history/snapshots/test__integration__init.test.js.json +0 -13
  1113. package/.agent/history/snapshots/test__integration__minimal_change_pipeline.test.js.json +0 -13
  1114. package/.agent/history/snapshots/test__integration__parallel_tribunal.test.js.json +0 -12
  1115. package/.agent/history/snapshots/test__integration__routing.test.js.json +0 -11
  1116. package/.agent/history/snapshots/test__integration__swarm_dispatcher.test.js.json +0 -13
  1117. package/.agent/history/snapshots/test__integration__sync_status.test.js.json +0 -13
  1118. package/.agent/history/snapshots/test__integration__wave2.test.js.json +0 -13
  1119. package/.agent/history/snapshots/test__integration__wrapper.test.js.json +0 -13
  1120. package/.agent/history/snapshots/test__unit__align.test.js.json +0 -10
  1121. package/.agent/history/snapshots/test__unit__args.test.js.json +0 -20
  1122. package/.agent/history/snapshots/test__unit__ast_context_loader.test.js.json +0 -12
  1123. package/.agent/history/snapshots/test__unit__audit_release.test.js.json +0 -16
  1124. package/.agent/history/snapshots/test__unit__browser_case_bridge.test.js.json +0 -11
  1125. package/.agent/history/snapshots/test__unit__browser_discovery.test.js.json +0 -10
  1126. package/.agent/history/snapshots/test__unit__browser_idpi.test.js.json +0 -10
  1127. package/.agent/history/snapshots/test__unit__browser_sentinel.test.js.json +0 -11
  1128. package/.agent/history/snapshots/test__unit__browser_synapse.test.js.json +0 -10
  1129. package/.agent/history/snapshots/test__unit__browser_trimmer.test.js.json +0 -10
  1130. package/.agent/history/snapshots/test__unit__case_law_manager.test.js.json +0 -10
  1131. package/.agent/history/snapshots/test__unit__cicd_validator.test.js.json +0 -12
  1132. package/.agent/history/snapshots/test__unit__compile.test.js.json +0 -10
  1133. package/.agent/history/snapshots/test__unit__context_broker.test.js.json +0 -10
  1134. package/.agent/history/snapshots/test__unit__context_compiler.test.js.json +0 -26
  1135. package/.agent/history/snapshots/test__unit__contract_engine.test.js.json +0 -13
  1136. package/.agent/history/snapshots/test__unit__copyDir.test.js.json +0 -23
  1137. package/.agent/history/snapshots/test__unit__graph_tools.test.js.json +0 -11
  1138. package/.agent/history/snapshots/test__unit__guardrail_engine.test.js.json +0 -10
  1139. package/.agent/history/snapshots/test__unit__impact_classifier.test.js.json +0 -12
  1140. package/.agent/history/snapshots/test__unit__init.test.js.json +0 -14
  1141. package/.agent/history/snapshots/test__unit__inner_loop_validator.test.js.json +0 -10
  1142. package/.agent/history/snapshots/test__unit__integrity_manifest.test.js.json +0 -13
  1143. package/.agent/history/snapshots/test__unit__learn.test.js.json +0 -11
  1144. package/.agent/history/snapshots/test__unit__marathon.test.js.json +0 -22
  1145. package/.agent/history/snapshots/test__unit__mcp_server.test.js.json +0 -16
  1146. package/.agent/history/snapshots/test__unit__memory.test.js.json +0 -13
  1147. package/.agent/history/snapshots/test__unit__minimal_change.test.js.json +0 -10
  1148. package/.agent/history/snapshots/test__unit__native.test.js.json +0 -10
  1149. package/.agent/history/snapshots/test__unit__optimize.test.js.json +0 -13
  1150. package/.agent/history/snapshots/test__unit__path_resolution.test.js.json +0 -14
  1151. package/.agent/history/snapshots/test__unit__platform_download_audit.test.js.json +0 -11
  1152. package/.agent/history/snapshots/test__unit__production_readiness_evidence.test.js.json +0 -21
  1153. package/.agent/history/snapshots/test__unit__prompt_compiler.test.js.json +0 -10
  1154. package/.agent/history/snapshots/test__unit__sdd_integration.test.js.json +0 -12
  1155. package/.agent/history/snapshots/test__unit__selfInstall.test.js.json +0 -23
  1156. package/.agent/history/snapshots/test__unit__semver.test.js.json +0 -20
  1157. package/.agent/history/snapshots/test__unit__skill_evolution.test.js.json +0 -11
  1158. package/.agent/history/snapshots/test__unit__stress.test.js.json +0 -15
  1159. package/.agent/history/snapshots/test__unit__swarm_dispatcher.test.js.json +0 -12
  1160. package/.agent/history/snapshots/test__unit__token_budget_broker.test.js.json +0 -10
  1161. package/.agent/history/snapshots/test__unit__tui.test.js.json +0 -10
  1162. package/.agent/history/snapshots/test__unit__utils.test.js.json +0 -10
  1163. package/.agents/plugins/marketplace.json +0 -20
  1164. package/.claude/CLAUDE.md +0 -442
  1165. package/dist/cli.js +0 -377
  1166. package/dist/commands/align.js +0 -201
  1167. package/dist/commands/case.js +0 -73
  1168. package/dist/commands/compile.js +0 -91
  1169. package/dist/commands/context.js +0 -71
  1170. package/dist/commands/graph.js +0 -44
  1171. package/dist/commands/hook.js +0 -28
  1172. package/dist/commands/init.js +0 -393
  1173. package/dist/commands/learn.js +0 -117
  1174. package/dist/commands/marathon.js +0 -45
  1175. package/dist/commands/memory.js +0 -508
  1176. package/dist/commands/minimal.js +0 -71
  1177. package/dist/commands/mutate.js +0 -30
  1178. package/dist/commands/native.js +0 -264
  1179. package/dist/commands/optimize.js +0 -328
  1180. package/dist/commands/sdd.js +0 -229
  1181. package/dist/commands/sync.js +0 -25
  1182. package/dist/commands/uninstall.js +0 -54
  1183. package/dist/commands/update.js +0 -37
  1184. package/dist/mcp/server.js +0 -8
  1185. package/dist/utils/fs.js +0 -102
  1186. package/dist/utils/hasher.js +0 -142
  1187. package/dist/utils/helpers.js +0 -53
  1188. package/dist/utils/logger.js +0 -54
  1189. package/dist/utils/version.js +0 -157
  1190. package/scripts/apply-version.js +0 -57
  1191. package/scripts/audit_skill_sdo.js +0 -89
  1192. package/scripts/benchmark.js +0 -231
  1193. package/scripts/build-graph.js +0 -71
  1194. package/scripts/changelog.js +0 -190
  1195. package/scripts/clean-pycache.js +0 -42
  1196. package/scripts/context_compiler.js +0 -1117
  1197. package/scripts/fix-vbc.js +0 -96
  1198. package/scripts/fix-vbc.ps1 +0 -3
  1199. package/scripts/modernize_skills.js +0 -268
  1200. package/scripts/package-cores.js +0 -116
  1201. package/scripts/skill_enhancement_engine.js +0 -608
  1202. package/scripts/stress_benchmark.js +0 -358
  1203. package/scripts/sync-skills.js +0 -61
  1204. package/scripts/sync-version.js +0 -177
  1205. package/scripts/telemetry_gc.js +0 -156
  1206. package/scripts/validate-payload.js +0 -73
  1207. package/scripts/visual_audit.js +0 -136
  1208. /package/{dist → src}/index.d.ts +0 -0
@@ -1,843 +1,843 @@
1
- # DESIGN.md — Product Design System
2
-
3
- > **This file is your AI agent's source of truth for premium visual design.**
4
- > Generated by `tribunal-kit init`. Choose and customize one Visual Direction for your brand.
5
- > All coding agents MUST read this file before generating any UI code.
6
-
7
- ---
8
-
9
- ## 1. Chosen Visual Direction: [Enter Chosen Direction Here]
10
-
11
- Choose **ONE** direction from the list below to define the brand visual system. Do not mix directions:
12
-
13
- - **Swiss Precision:** Clean, grid-locked alignment, sans-serif typography, clinical whitespace, neutral OKLCH slates, zero border radii.
14
- - **Brutalist:** Raw, exposed 2px borders, monospace display fonts, high-contrast acid accents, hard 4px offset drop shadows, sharp corners.
15
- - **Editorial:** Magazine-inspired layout, large display serif headings, warm alabaster surfaces, deep terracotta accents, generous margins.
16
- - **Neo-Glassmorphism:** Deep indigo dark base, translucent glass surfaces, high backdrop blur (`blur(20px)`), luminous hairlines, electric cyan accents.
17
- - **Soft Minimal:** Warm tinted grays, graphite slate accents, rounded friendly shapes (`radius: 12px`), whisper-soft diffused shadows.
18
- - **Dark Luxury:** OLED near-black base (`#08080C`), gold/amber accent lines, ultra-fine hairlines, understated typography, subtle animations.
19
- - **Neon Cyberpunk:** Deep space navy base, highly saturated neon green/cyan glow effects, sharp geometry, technical monospace accents.
20
- - **Retro Analog:** Warm grain parchment overlay, muted rust and olive tones, rounded typography, tactile paper-like borders.
21
-
22
- ### Activation Guide
23
-
24
- To activate your chosen identity:
25
-
26
- 1. Replace `[Enter Chosen Direction Here]` above with your chosen theme name (e.g. `Swiss Precision`).
27
- 2. Copy the corresponding tokens into your application's root stylesheet (`:root` or `:root[data-theme="..."]`).
28
- 3. Ensure all components consume `var(--...)` tokens rather than hardcoded hex codes.
29
-
30
- ---
31
-
32
- ## 2. Visual Identities CSS Tokens Definition
33
-
34
- ### 1. Swiss Precision
35
-
36
- _Clean, rational, objective modernist design inspired by Josef Müller-Brockmann and the International Typographic Style._
37
-
38
- ```css
39
- :root {
40
- /* Typography */
41
- --font-display: 'General Sans', 'Helvetica Neue', Arial, sans-serif;
42
- --font-body: 'Satoshi', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
43
- --font-mono: 'JetBrains Mono', 'SF Mono', Consolas, monospace;
44
-
45
- /* Surfaces */
46
- --bg-base: oklch(0.98 0.002 240);
47
- --bg-surface: oklch(1 0 0);
48
- --bg-surface-raised: oklch(0.95 0.003 240);
49
- --bg-surface-overlay: oklch(1 0 0 / 0.95);
50
- --bg-surface-sunken: oklch(0.92 0.004 240);
51
-
52
- /* Foreground & Text */
53
- --text-primary: oklch(0.18 0.01 240);
54
- --text-secondary: oklch(0.42 0.01 240);
55
- --text-muted: oklch(0.6 0.008 240);
56
- --text-inverse: oklch(0.98 0 0);
57
-
58
- /* Accents */
59
- --color-primary: oklch(0.2 0.01 240); /* Deep Graphite */
60
- --color-primary-hover: oklch(0.35 0.01 240);
61
- --color-primary-subtle: oklch(0.94 0.004 240);
62
- --color-accent: oklch(0.55 0.22 25); /* International Klein Blue or Swiss Red */
63
-
64
- /* Functional Status */
65
- --status-success: oklch(0.55 0.16 145);
66
- --status-warning: oklch(0.68 0.16 75);
67
- --status-error: oklch(0.52 0.22 25);
68
- --status-info: oklch(0.52 0.18 245);
69
-
70
- /* Spacing Grid (Strict 8px system) */
71
- --space-2xs: 2px;
72
- --space-xs: 4px;
73
- --space-sm: 8px;
74
- --space-md: 16px;
75
- --space-lg: 24px;
76
- --space-xl: 32px;
77
- --space-2xl: 48px;
78
- --space-3xl: 64px;
79
-
80
- /* Radii (Strict zero radius) */
81
- --radius-xs: 0px;
82
- --radius-sm: 0px;
83
- --radius-md: 0px;
84
- --radius-lg: 0px;
85
- --radius-full: 0px;
86
-
87
- /* Borders & Dividers */
88
- --border-subtle: 1px solid oklch(0.88 0.003 240);
89
- --border-strong: 1px solid oklch(0.18 0.01 240);
90
- --border-focus: 2px solid oklch(0.2 0.01 240);
91
-
92
- /* Elevation */
93
- --shadow-sm: none;
94
- --shadow-md: none;
95
- --shadow-lg: 0 8px 0 oklch(0.18 0.01 240 / 0.15);
96
- }
97
- ```
98
-
99
- ---
100
-
101
- ### 2. Brutalist
102
-
103
- _Uncompromising raw aesthetics, exposed structural outlines, monospace dominance, and hard cast shadows._
104
-
105
- ```css
106
- :root {
107
- /* Typography */
108
- --font-display: 'Space Grotesk', 'Impact', sans-serif;
109
- --font-body: 'General Sans', -apple-system, sans-serif;
110
- --font-mono: 'Space Mono', 'JetBrains Mono', monospace;
111
-
112
- /* Surfaces */
113
- --bg-base: oklch(1 0 0);
114
- --bg-surface: oklch(1 0 0);
115
- --bg-surface-raised: oklch(0.96 0.005 140);
116
- --bg-surface-overlay: oklch(1 0 0);
117
- --bg-surface-sunken: oklch(0.92 0.01 140);
118
-
119
- /* Foreground & Text */
120
- --text-primary: oklch(0.1 0.01 240);
121
- --text-secondary: oklch(0.35 0.01 240);
122
- --text-muted: oklch(0.55 0.01 240);
123
- --text-inverse: oklch(1 0 0);
124
-
125
- /* Accents */
126
- --color-primary: oklch(0.6 0.28 140); /* Acid Lime */
127
- --color-primary-hover: oklch(0.5 0.28 140);
128
- --color-primary-subtle: oklch(0.93 0.1 140);
129
- --color-accent: oklch(0.65 0.25 350); /* Cyber Pink */
130
-
131
- /* Functional Status */
132
- --status-success: oklch(0.6 0.28 140);
133
- --status-warning: oklch(0.75 0.2 85);
134
- --status-error: oklch(0.55 0.25 25);
135
- --status-info: oklch(0.55 0.2 230);
136
-
137
- /* Spacing */
138
- --space-2xs: 2px;
139
- --space-xs: 4px;
140
- --space-sm: 8px;
141
- --space-md: 16px;
142
- --space-lg: 24px;
143
- --space-xl: 32px;
144
- --space-2xl: 48px;
145
- --space-3xl: 64px;
146
-
147
- /* Radii */
148
- --radius-xs: 1px;
149
- --radius-sm: 2px;
150
- --radius-md: 2px;
151
- --radius-lg: 3px;
152
- --radius-full: 9999px;
153
-
154
- /* Borders & Dividers (Heavy outlines) */
155
- --border-subtle: 2px solid oklch(0.1 0.01 240);
156
- --border-strong: 3px solid oklch(0.1 0.01 240);
157
- --border-focus: 3px solid oklch(0.6 0.28 140);
158
-
159
- /* Elevation (Hard drop-shadows with zero blur) */
160
- --shadow-sm: 2px 2px 0px oklch(0.1 0.01 240);
161
- --shadow-md: 4px 4px 0px oklch(0.1 0.01 240);
162
- --shadow-lg: 8px 8px 0px oklch(0.1 0.01 240);
163
- }
164
- ```
165
-
166
- ---
167
-
168
- ### 3. Editorial
169
-
170
- _Sophisticated literary elegance, high editorial serif headings, warm creamy paper textures, and generous margins._
171
-
172
- ```css
173
- :root {
174
- /* Typography */
175
- --font-display: 'Playfair Display', 'Newsreader', Georgia, serif;
176
- --font-body: 'Source Sans 3', 'Satoshi', sans-serif;
177
- --font-mono: 'Courier Prime', 'Courier New', monospace;
178
-
179
- /* Surfaces */
180
- --bg-base: oklch(0.97 0.006 65); /* Warm Alabaster */
181
- --bg-surface: oklch(0.99 0.003 65);
182
- --bg-surface-raised: oklch(0.94 0.009 65);
183
- --bg-surface-overlay: oklch(0.99 0.003 65 / 0.95);
184
- --bg-surface-sunken: oklch(0.91 0.012 65);
185
-
186
- /* Foreground & Text */
187
- --text-primary: oklch(0.2 0.02 55); /* Deep Espresso Charcoal */
188
- --text-secondary: oklch(0.42 0.02 55);
189
- --text-muted: oklch(0.62 0.015 65);
190
- --text-inverse: oklch(0.98 0.005 65);
191
-
192
- /* Accents */
193
- --color-primary: oklch(0.38 0.13 30); /* Terracotta Sienna */
194
- --color-primary-hover: oklch(0.28 0.13 30);
195
- --color-primary-subtle: oklch(0.93 0.03 30);
196
- --color-accent: oklch(0.45 0.1 85); /* Antique Olive Amber */
197
-
198
- /* Functional Status */
199
- --status-success: oklch(0.5 0.12 140);
200
- --status-warning: oklch(0.65 0.14 75);
201
- --status-error: oklch(0.48 0.18 28);
202
- --status-info: oklch(0.48 0.12 230);
203
-
204
- /* Spacing (Generous editorial flow) */
205
- --space-2xs: 3px;
206
- --space-xs: 6px;
207
- --space-sm: 12px;
208
- --space-md: 24px;
209
- --space-lg: 36px;
210
- --space-xl: 48px;
211
- --space-2xl: 72px;
212
- --space-3xl: 96px;
213
-
214
- /* Radii */
215
- --radius-xs: 2px;
216
- --radius-sm: 4px;
217
- --radius-md: 8px;
218
- --radius-lg: 16px;
219
- --radius-full: 9999px;
220
-
221
- /* Borders & Dividers */
222
- --border-subtle: 1px solid oklch(0.88 0.01 65);
223
- --border-strong: 1px solid oklch(0.2 0.02 55);
224
- --border-focus: 2px solid oklch(0.38 0.13 30);
225
-
226
- /* Elevation (Soft paper elevation) */
227
- --shadow-sm: 0 2px 8px oklch(0.2 0.02 55 / 0.05);
228
- --shadow-md: 0 8px 24px oklch(0.2 0.02 55 / 0.08);
229
- --shadow-lg: 0 16px 48px oklch(0.2 0.02 55 / 0.12);
230
- }
231
- ```
232
-
233
- ---
234
-
235
- ### 4. Neo-Glassmorphism
236
-
237
- _Deep luminous indigo backdrops, progressive frosted glass layers, neon cyan accents, and 1px luminous hairlines._
238
-
239
- ```css
240
- :root {
241
- /* Typography */
242
- --font-display: 'Clash Display', 'Plus Jakarta Sans', sans-serif;
243
- --font-body: 'Satoshi', 'Inter', sans-serif;
244
- --font-mono: 'JetBrains Mono', monospace;
245
-
246
- /* Surfaces */
247
- --bg-base: oklch(0.12 0.018 250); /* Midnight Obsidian */
248
- --bg-surface: oklch(1 0 0 / 0.08); /* Translucent Glass */
249
- --bg-surface-raised: oklch(1 0 0 / 0.14);
250
- --bg-surface-overlay: oklch(0.14 0.02 250 / 0.85);
251
- --bg-surface-sunken: oklch(0.08 0.01 250 / 0.5);
252
-
253
- /* Foreground & Text */
254
- --text-primary: oklch(0.98 0.005 240);
255
- --text-secondary: oklch(0.78 0.015 240);
256
- --text-muted: oklch(0.55 0.02 240);
257
- --text-inverse: oklch(0.12 0.02 250);
258
-
259
- /* Accents */
260
- --color-primary: oklch(0.72 0.2 205); /* Luminescent Electric Cyan */
261
- --color-primary-hover: oklch(0.62 0.2 205);
262
- --color-primary-subtle: oklch(0.72 0.2 205 / 0.15);
263
- --color-accent: oklch(0.75 0.18 310); /* Luminescent Orchid */
264
-
265
- /* Functional Status */
266
- --status-success: oklch(0.72 0.2 150);
267
- --status-warning: oklch(0.78 0.18 80);
268
- --status-error: oklch(0.65 0.22 25);
269
- --status-info: oklch(0.72 0.2 220);
270
-
271
- /* Spacing */
272
- --space-2xs: 2px;
273
- --space-xs: 4px;
274
- --space-sm: 8px;
275
- --space-md: 16px;
276
- --space-lg: 24px;
277
- --space-xl: 32px;
278
- --space-2xl: 48px;
279
- --space-3xl: 64px;
280
-
281
- /* Radii */
282
- --radius-xs: 4px;
283
- --radius-sm: 8px;
284
- --radius-md: 16px;
285
- --radius-lg: 28px;
286
- --radius-full: 9999px;
287
-
288
- /* Borders & Glass Filters */
289
- --backdrop-blur: blur(20px) saturate(180%);
290
- --border-subtle: 1px solid oklch(1 0 0 / 0.12);
291
- --border-strong: 1px solid oklch(1 0 0 / 0.24);
292
- --border-focus: 2px solid oklch(0.72 0.2 205);
293
-
294
- /* Elevation (Soft luminous colored glows) */
295
- --shadow-sm: 0 4px 16px oklch(0% 0 0 / 0.25);
296
- --shadow-md: 0 12px 32px oklch(0% 0 0 / 0.4);
297
- --shadow-lg: 0 20px 60px oklch(0% 0 0 / 0.55), 0 0 30px oklch(0.72 0.2 205 / 0.15);
298
- }
299
- ```
300
-
301
- ---
302
-
303
- ### 5. Soft Minimal
304
-
305
- _Understated Nordic restraint, warm organic off-whites, gentle rounded corners, whisper-quiet shadows, and peaceful spacing._
306
-
307
- ```css
308
- :root {
309
- /* Typography */
310
- --font-display: 'Geist Sans', 'Inter', -apple-system, sans-serif;
311
- --font-body: 'Geist Sans', 'Inter', -apple-system, sans-serif;
312
- --font-mono: 'Geist Mono', 'SF Mono', monospace;
313
-
314
- /* Surfaces */
315
- --bg-base: oklch(0.98 0.003 80); /* Warm Parchment Slate */
316
- --bg-surface: oklch(1 0 0);
317
- --bg-surface-raised: oklch(0.96 0.005 80);
318
- --bg-surface-overlay: oklch(1 0 0 / 0.96);
319
- --bg-surface-sunken: oklch(0.93 0.006 80);
320
-
321
- /* Foreground & Text */
322
- --text-primary: oklch(0.24 0.015 240);
323
- --text-secondary: oklch(0.48 0.015 240);
324
- --text-muted: oklch(0.66 0.01 240);
325
- --text-inverse: oklch(0.98 0 0);
326
-
327
- /* Accents */
328
- --color-primary: oklch(0.36 0.05 240); /* Warm Graphite */
329
- --color-primary-hover: oklch(0.26 0.05 240);
330
- --color-primary-subtle: oklch(0.94 0.01 240);
331
- --color-accent: oklch(0.58 0.12 180); /* Sage Teal */
332
-
333
- /* Functional Status */
334
- --status-success: oklch(0.58 0.12 145);
335
- --status-warning: oklch(0.72 0.13 80);
336
- --status-error: oklch(0.56 0.18 25);
337
- --status-info: oklch(0.55 0.14 240);
338
-
339
- /* Spacing */
340
- --space-2xs: 2px;
341
- --space-xs: 4px;
342
- --space-sm: 8px;
343
- --space-md: 16px;
344
- --space-lg: 24px;
345
- --space-xl: 32px;
346
- --space-2xl: 48px;
347
- --space-3xl: 64px;
348
-
349
- /* Radii */
350
- --radius-xs: 4px;
351
- --radius-sm: 6px;
352
- --radius-md: 12px;
353
- --radius-lg: 20px;
354
- --radius-full: 9999px;
355
-
356
- /* Borders & Dividers */
357
- --border-subtle: 1px solid oklch(0.92 0.004 80);
358
- --border-strong: 1px solid oklch(0.78 0.01 80);
359
- --border-focus: 2px solid oklch(0.36 0.05 240);
360
-
361
- /* Elevation (Ultra-diffused feather shadows) */
362
- --shadow-sm: 0 1px 3px oklch(0.2 0.01 240 / 0.03), 0 1px 2px oklch(0.2 0.01 240 / 0.02);
363
- --shadow-md: 0 4px 16px oklch(0.2 0.01 240 / 0.05), 0 2px 6px oklch(0.2 0.01 240 / 0.03);
364
- --shadow-lg: 0 12px 36px oklch(0.2 0.01 240 / 0.08), 0 4px 12px oklch(0.2 0.01 240 / 0.04);
365
- }
366
- ```
367
-
368
- ---
369
-
370
- ### 6. Dark Luxury
371
-
372
- _Private-banking exclusivity, deep OLED black canvas, gold/champagne hairline accents, and razor-sharp typographic precision._
373
-
374
- ```css
375
- :root {
376
- /* Typography */
377
- --font-display: 'Cabinet Grotesk', 'Cormorant Garamond', serif;
378
- --font-body: 'Satoshi', 'Outfit', -apple-system, sans-serif;
379
- --font-mono: 'JetBrains Mono', monospace;
380
-
381
- /* Surfaces */
382
- --bg-base: oklch(0.08 0.005 250); /* OLED Jet Black */
383
- --bg-surface: oklch(0.12 0.008 250);
384
- --bg-surface-raised: oklch(0.16 0.01 250);
385
- --bg-surface-overlay: oklch(0.12 0.008 250 / 0.92);
386
- --bg-surface-sunken: oklch(0.05 0.003 250);
387
-
388
- /* Foreground & Text */
389
- --text-primary: oklch(0.95 0.005 85);
390
- --text-secondary: oklch(0.74 0.015 85);
391
- --text-muted: oklch(0.48 0.015 85);
392
- --text-inverse: oklch(0.08 0.005 250);
393
-
394
- /* Accents */
395
- --color-primary: oklch(0.78 0.12 85); /* Muted Imperial Gold */
396
- --color-primary-hover: oklch(0.68 0.12 85);
397
- --color-primary-subtle: oklch(0.78 0.12 85 / 0.12);
398
- --color-accent: oklch(0.85 0.08 90); /* Champagne Pearl */
399
-
400
- /* Functional Status */
401
- --status-success: oklch(0.65 0.14 145);
402
- --status-warning: oklch(0.78 0.12 85);
403
- --status-error: oklch(0.58 0.2 25);
404
- --status-info: oklch(0.62 0.12 240);
405
-
406
- /* Spacing */
407
- --space-2xs: 2px;
408
- --space-xs: 4px;
409
- --space-sm: 8px;
410
- --space-md: 16px;
411
- --space-lg: 24px;
412
- --space-xl: 32px;
413
- --space-2xl: 48px;
414
- --space-3xl: 64px;
415
-
416
- /* Radii */
417
- --radius-xs: 2px;
418
- --radius-sm: 4px;
419
- --radius-md: 6px;
420
- --radius-lg: 12px;
421
- --radius-full: 9999px;
422
-
423
- /* Borders & Hairlines */
424
- --border-subtle: 1px solid oklch(0.24 0.01 250);
425
- --border-strong: 1px solid oklch(0.78 0.12 85 / 0.4);
426
- --border-focus: 2px solid oklch(0.78 0.12 85);
427
-
428
- /* Elevation */
429
- --shadow-sm: 0 2px 6px oklch(0 0 0 / 0.4);
430
- --shadow-md: 0 8px 24px oklch(0 0 0 / 0.6);
431
- --shadow-lg: 0 16px 48px oklch(0 0 0 / 0.8), 0 0 1px oklch(0.78 0.12 85 / 0.25);
432
- }
433
- ```
434
-
435
- ---
436
-
437
- ### 7. Neon Cyberpunk
438
-
439
- _High-velocity terminal engineering, deep space navy, vivid radiant lasers, chromatic contrast, and angular geometry._
440
-
441
- ```css
442
- :root {
443
- /* Typography */
444
- --font-display: 'Space Grotesk', 'Syne', sans-serif;
445
- --font-body: 'General Sans', 'Inter', sans-serif;
446
- --font-mono: 'JetBrains Mono', 'Fira Code', monospace;
447
-
448
- /* Surfaces */
449
- --bg-base: oklch(0.05 0.012 280); /* Void Navy */
450
- --bg-surface: oklch(0.09 0.018 280);
451
- --bg-surface-raised: oklch(0.14 0.024 280);
452
- --bg-surface-overlay: oklch(0.09 0.018 280 / 0.92);
453
- --bg-surface-sunken: oklch(0.03 0.008 280);
454
-
455
- /* Foreground & Text */
456
- --text-primary: oklch(0.98 0.01 200);
457
- --text-secondary: oklch(0.76 0.03 200);
458
- --text-muted: oklch(0.5 0.04 280);
459
- --text-inverse: oklch(0.05 0.012 280);
460
-
461
- /* Accents */
462
- --color-primary: oklch(0.75 0.28 160); /* Acid Neon Emerald */
463
- --color-primary-hover: oklch(0.85 0.28 160);
464
- --color-primary-subtle: oklch(0.75 0.28 160 / 0.15);
465
- --color-accent: oklch(0.72 0.26 330); /* Plasma Magenta */
466
-
467
- /* Functional Status */
468
- --status-success: oklch(0.75 0.28 160);
469
- --status-warning: oklch(0.82 0.22 95);
470
- --status-error: oklch(0.68 0.28 25);
471
- --status-info: oklch(0.72 0.24 230);
472
-
473
- /* Spacing */
474
- --space-2xs: 2px;
475
- --space-xs: 4px;
476
- --space-sm: 8px;
477
- --space-md: 16px;
478
- --space-lg: 24px;
479
- --space-xl: 32px;
480
- --space-2xl: 48px;
481
- --space-3xl: 64px;
482
-
483
- /* Radii */
484
- --radius-xs: 0px;
485
- --radius-sm: 2px;
486
- --radius-md: 4px;
487
- --radius-lg: 8px;
488
- --radius-full: 9999px;
489
-
490
- /* Borders & Glows */
491
- --border-subtle: 1px solid oklch(0.22 0.04 280);
492
- --border-strong: 1px solid oklch(0.75 0.28 160 / 0.5);
493
- --border-focus: 2px solid oklch(0.75 0.28 160);
494
-
495
- /* Elevation (Neon radiance glows) */
496
- --shadow-sm: 0 0 10px oklch(0.75 0.28 160 / 0.2);
497
- --shadow-md: 0 0 20px oklch(0.75 0.28 160 / 0.35);
498
- --shadow-lg: 0 0 35px oklch(0.75 0.28 160 / 0.5), 0 0 70px oklch(0.72 0.26 330 / 0.25);
499
- }
500
- ```
501
-
502
- ---
503
-
504
- ### 8. Retro Analog
505
-
506
- _Warm archival grain, vintage print craftsmanship, typewriter monospace elements, and physical print textures._
507
-
508
- ```css
509
- :root {
510
- /* Typography */
511
- --font-display: 'Clash Display', 'Cooper Black', serif;
512
- --font-body: 'Switzer', 'Courier Prime', monospace, sans-serif;
513
- --font-mono: 'Courier Prime', 'Courier New', monospace;
514
-
515
- /* Surfaces */
516
- --bg-base: oklch(0.93 0.018 72); /* Archival Newsprint */
517
- --bg-surface: oklch(0.96 0.015 72);
518
- --bg-surface-raised: oklch(0.9 0.022 72);
519
- --bg-surface-overlay: oklch(0.96 0.015 72 / 0.95);
520
- --bg-surface-sunken: oklch(0.87 0.025 72);
521
-
522
- /* Foreground & Text */
523
- --text-primary: oklch(0.22 0.025 50); /* Deep Raw Umber */
524
- --text-secondary: oklch(0.42 0.025 50);
525
- --text-muted: oklch(0.6 0.02 60);
526
- --text-inverse: oklch(0.96 0.015 72);
527
-
528
- /* Accents */
529
- --color-primary: oklch(0.5 0.18 45); /* Burnished Rust Amber */
530
- --color-primary-hover: oklch(0.4 0.18 45);
531
- --color-primary-subtle: oklch(0.9 0.04 45);
532
- --color-accent: oklch(0.48 0.12 120); /* Vintage Forest Olive */
533
-
534
- /* Functional Status */
535
- --status-success: oklch(0.48 0.12 135);
536
- --status-warning: oklch(0.66 0.15 75);
537
- --status-error: oklch(0.46 0.18 30);
538
- --status-info: oklch(0.48 0.1 220);
539
-
540
- /* Spacing */
541
- --space-2xs: 3px;
542
- --space-xs: 5px;
543
- --space-sm: 10px;
544
- --space-md: 20px;
545
- --space-lg: 30px;
546
- --space-xl: 40px;
547
- --space-2xl: 60px;
548
- --space-3xl: 80px;
549
-
550
- /* Radii */
551
- --radius-xs: 2px;
552
- --radius-sm: 4px;
553
- --radius-md: 8px;
554
- --radius-lg: 16px;
555
- --radius-full: 9999px;
556
-
557
- /* Borders & Dividers */
558
- --border-subtle: 1px solid oklch(0.84 0.02 72);
559
- --border-strong: 2px solid oklch(0.22 0.025 50);
560
- --border-focus: 2px solid oklch(0.5 0.18 45);
561
-
562
- /* Elevation (Tactile offset print shadows) */
563
- --shadow-sm: 1px 1px 0px oklch(0.22 0.025 50 / 0.3);
564
- --shadow-md: 3px 3px 0px oklch(0.22 0.025 50 / 0.4);
565
- --shadow-lg: 6px 6px 0px oklch(0.22 0.025 50 / 0.5);
566
- }
567
- ```
568
-
569
- ---
570
-
571
- ## 3. Typographical Architecture & Fluid Scale
572
-
573
- Every interface must use mathematical fluid scaling via CSS `clamp()` to scale seamlessly across viewports without breakpoint jumps.
574
-
575
- ### Fluid Typography Scale
576
-
577
- ```css
578
- :root {
579
- /* Display / Hero */
580
- --text-display: clamp(2.5rem, 1.8rem + 3.5vw, 4.5rem); /* 40px -> 72px */
581
- --line-display: 1.05;
582
- --tracking-display: -0.03em;
583
-
584
- /* Heading 1 */
585
- --text-h1: clamp(2rem, 1.5rem + 2.5vw, 3.25rem); /* 32px -> 52px */
586
- --line-h1: 1.15;
587
- --tracking-h1: -0.025em;
588
-
589
- /* Heading 2 */
590
- --text-h2: clamp(1.5rem, 1.2rem + 1.5vw, 2.25rem); /* 24px -> 36px */
591
- --line-h2: 1.25;
592
- --tracking-h2: -0.02em;
593
-
594
- /* Heading 3 */
595
- --text-h3: clamp(1.25rem, 1.1rem + 0.75vw, 1.625rem); /* 20px -> 26px */
596
- --line-h3: 1.35;
597
- --tracking-h3: -0.015em;
598
-
599
- /* Body Typography */
600
- --text-body-lg: clamp(1.125rem, 1.05rem + 0.35vw, 1.25rem); /* 18px -> 20px */
601
- --text-body: clamp(0.9375rem, 0.9rem + 0.2vw, 1rem); /* 15px -> 16px */
602
- --text-body-sm: clamp(0.8125rem, 0.8rem + 0.1vw, 0.875rem); /* 13px -> 14px */
603
- --text-caption: 0.75rem; /* 12px */
604
-
605
- --line-body: 1.6;
606
- --tracking-body: 0em;
607
- --tracking-caps: 0.06em;
608
- }
609
- ```
610
-
611
- ### Typographic Invariants
612
-
613
- 1. **Headline Balancing:** Always add `text-wrap: balance` on all `h1`, `h2`, `h3` tags to eliminate orphan words.
614
- 2. **Body Text Wrapping:** Add `text-wrap: pretty` on long-form paragraphs to prevent dangling end lines.
615
- 3. **Reading Line Length:** Never exceed `65ch` on prose container widths (`max-width: 65ch`).
616
- 4. **Tabular Numerics:** All numbers, financial metrics, counters, and table data MUST use `font-variant-numeric: tabular-nums` to prevent horizontal jitter during updates.
617
- 5. **Tracking Cadence:** Tighter tracking on larger headings (`-0.025em`), neutral on body (`0em`), and expanded tracking on uppercase labels (`0.06em`).
618
-
619
- ---
620
-
621
- ## 4. Spatial Discipline, Container Queries & Concentric Geometry
622
-
623
- ### The 8-Point Spatial Grid
624
-
625
- All margins, paddings, and layout gaps MUST adhere to multiples of the 8px spatial grid, with 4px half-steps permitted only for dense micro-controls (e.g., chips, tags, inputs):
626
-
627
- - `4px` (xs): Tight component internals, icon-to-text spacing.
628
- - `8px` (sm): Standard intra-component padding, button gaps.
629
- - `16px` (md): Card padding, list item separation.
630
- - `24px` (lg): Section grid gaps, modal content padding.
631
- - `32px` (xl): Page column gutters, card container separation.
632
- - `48px` (2xl): Section breaks on mobile.
633
- - `64px`–`96px` (3xl): Major landing section boundaries on desktop.
634
-
635
- ### Concentric Nested Radius Law
636
-
637
- To avoid visual tension caused by non-concentric curves, the outer radius MUST equal the inner radius plus the inner padding:
638
-
639
- $$\mathbf{R_{\text{outer}} = R_{\text{inner}} + P_{\text{padding}}}$$
640
-
641
- ```css
642
- /* Concentric Example: Card with an internal Button/Image */
643
- .parent-card {
644
- padding: 16px; /* P_padding = 16px */
645
- border-radius: 24px; /* R_outer = 8px + 16px = 24px */
646
- }
647
-
648
- .child-element {
649
- border-radius: 8px; /* R_inner = 8px */
650
- }
651
- ```
652
-
653
- ### Container Queries Architecture
654
-
655
- For modular components that adapt to their container rather than the screen viewport:
656
-
657
- ```css
658
- .card-container {
659
- container-type: inline-size;
660
- container-name: card;
661
- }
662
-
663
- @container card (min-width: 480px) {
664
- .card-layout {
665
- display: grid;
666
- grid-template-columns: 120px 1fr;
667
- gap: var(--space-md);
668
- }
669
- }
670
- ```
671
-
672
- ---
673
-
674
- ## 5. Interaction Physics, Motion & Micro-Interactions
675
-
676
- Every interactive element MUST possess intentional, physical micro-interactions across all five fundamental interaction states.
677
-
678
- ### The 5 Interaction States Matrix
679
-
680
- | State | Visual Behavior | CSS Implementation |
681
- | :------------------- | :---------------------------------------------------- | :---------------------------------------------------------------------- |
682
- | **Default** | Baseline resting surface and border | `background-color: var(--bg-surface); border: var(--border-subtle);` |
683
- | **Hover** | Subtle elevation, background brightness shift (+4% L) | `background-color: var(--color-primary-hover); cursor: pointer;` |
684
- | **Focus-Visible** | High-contrast double ring outline with 2px offset | `outline: var(--border-focus); outline-offset: 2px;` |
685
- | **Active / Pressed** | Tactile physical compression (`scale(0.97)`) | `transform: scale(0.97); transition-duration: var(--duration-instant);` |
686
- | **Disabled** | 50% opacity, desaturated, cursor blocked | `opacity: 0.5; cursor: not-allowed; pointer-events: none;` |
687
-
688
- ### Motion Tokens & Physics Curves
689
-
690
- ```css
691
- :root {
692
- /* Durations */
693
- --duration-instant: 100ms; /* Active press, switches */
694
- --duration-fast: 150ms; /* Hover states, tooltips */
695
- --duration-base: 250ms; /* Dropdowns, dialogs, card expands */
696
- --duration-slow: 400ms; /* Page transitions, drawer slides */
697
-
698
- /* Easing Curves */
699
- --ease-spring: cubic-bezier(0.175, 0.885, 0.32, 1.275); /* Tactile bounce */
700
- --ease-out-expo: cubic-bezier(0.16, 1, 0.3, 1); /* Snappy deceleration */
701
- --ease-smooth: cubic-bezier(0.4, 0, 0.2, 1); /* Natural material curve */
702
- }
703
- ```
704
-
705
- ### Motion Invariants
706
-
707
- 1. **Never Animate Layout Properties:** Only animate compositor-friendly properties (`transform`, `opacity`, `filter`). Never animate `width`, `height`, `margin`, or `top` directly.
708
- 2. **Ban `transition: all`:** Always specify exact properties being transitioned (e.g. `transition: transform var(--duration-fast) var(--ease-spring), opacity var(--duration-fast) ease`).
709
- 3. **Respect Reduced Motion:**
710
-
711
- ```css
712
- @media (prefers-reduced-motion: reduce) {
713
- *,
714
- *::before,
715
- *::after {
716
- animation-duration: 0.01ms !important;
717
- animation-iteration-count: 1 !important;
718
- transition-duration: 0.01ms !important;
719
- scroll-behavior: auto !important;
720
- }
721
- }
722
- ```
723
-
724
- ---
725
-
726
- ## 6. Elevation, Depth & Layering Architecture
727
-
728
- Surfaces must layer cleanly along the Z-axis using dual-shadow illumination (diffuse ambient bounce + sharp contact shadow):
729
-
730
- ```css
731
- :root {
732
- /* Level 0: Canvas Base (flat) */
733
- /* Level 1: Cards & Panels */
734
- --shadow-sm: 0 1px 2px oklch(0 0 0 / 0.06), 0 2px 4px oklch(0 0 0 / 0.04);
735
-
736
- /* Level 2: Menus & Popovers */
737
- --shadow-md: 0 4px 6px -1px oklch(0 0 0 / 0.08), 0 10px 20px -3px oklch(0 0 0 / 0.06);
738
-
739
- /* Level 3: Modals & Drawers */
740
- --shadow-lg: 0 10px 15px -3px oklch(0 0 0 / 0.1), 0 24px 48px -6px oklch(0 0 0 / 0.12);
741
-
742
- /* Level 4: Floating Toasts & Critical Alerts */
743
- --shadow-xl: 0 20px 25px -5px oklch(0 0 0 / 0.14), 0 36px 64px -10px oklch(0 0 0 / 0.16);
744
- }
745
- ```
746
-
747
- ### Progressive Backdrop Blur
748
-
749
- For modern floating headers, modals, and sticky action bars:
750
-
751
- ```css
752
- .frosted-overlay {
753
- background-color: var(--bg-surface-overlay);
754
- backdrop-filter: blur(16px) saturate(160%);
755
- -webkit-backdrop-filter: blur(16px) saturate(160%);
756
- border-bottom: var(--border-subtle);
757
- }
758
- ```
759
-
760
- ---
761
-
762
- ## 7. Core Component Primitives Contract
763
-
764
- All generated UI components must adhere to the following architectural contracts:
765
-
766
- ### 1. Button Primitive
767
-
768
- - **Variants:** `primary`, `secondary`, `outline`, `ghost`, `destructive`.
769
- - **Sizes:** `sm` (32px h, 12px px), `md` (40px h, 16px px), `lg` (48px h, 20px px).
770
- - **Invariants:** Must have `display: inline-flex`, `align-items: center`, `justify-content: center`, `gap: var(--space-xs)`.
771
- - **States:** Active state must use `transform: scale(0.97)` with `--duration-instant`.
772
-
773
- ### 2. Form Control Primitive (Inputs & Selects)
774
-
775
- - **Minimum Target Size:** Minimum height `40px` (desktop), `44px` (touch devices).
776
- - **Resting:** `border: var(--border-subtle); background: var(--bg-surface);`.
777
- - **Focus:** `border-color: var(--color-primary); box-shadow: 0 0 0 3px var(--color-primary-subtle); outline: none;`.
778
- - **Error:** `border-color: var(--status-error); box-shadow: 0 0 0 3px oklch(0.55 0.20 25 / 0.15);`.
779
-
780
- ### 3. Modal / Dialog Primitive
781
-
782
- - **Scrim Backdrop:** `background-color: oklch(0 0 0 / 0.50); backdrop-filter: blur(8px);`.
783
- - **Placement:** Centered with spring scale entrance (`scale(0.95) -> scale(1.00)`).
784
- - **Accessibility:** Must trap keyboard focus (`Tab` navigation constrained inside dialog), `Escape` to close, return focus to trigger on exit.
785
-
786
- ---
787
-
788
- ## 8. Anti-AI Clichés & Tribunal Aesthetic Invariants
789
-
790
- AI models routinely generate bland, template-like interfaces unless strictly constrained. All coding agents MUST comply with the following Anti-Slop Table:
791
-
792
- | Anti-Pattern (AI Slop) | Tribunal Standard | Reason / Rationale |
793
- | :---------------------------------------------- | :----------------------------------------------------------------------------- | :---------------------------------------------------------------- |
794
- | **Generic Purple/Violet Gradients** (`#8B5CF6`) | Use curated brand palette or monochrome slate + high-chroma single accent | Violet gradients are the universal AI cliché stamp. |
795
- | **Stock Split Hero (Text Left / Image Right)** | Asymmetric editorial typography, interactive terminal, or canvas preview | Overused boilerplate looks like a generic 2020 SaaS template. |
796
- | **Unreadable Low-Contrast Gray Text** | Minimum contrast APCA Lc ≥ 60 or WCAG 4.5:1 on all surfaces | Faint gray text harms readability and fails accessibility. |
797
- | **Overuse of Heavy Mesh Gradients** | Crisp solid surfaces, grain texture, or subtle targeted radial spotlight glows | Mesh gradients look noisy, generic, and degrade GPU battery life. |
798
- | **Universal `transition: all 0.3s`** | Declare explicit animated properties with spring or exponential easing curves | Animating `all` causes layout jank and performance degradation. |
799
- | **Nested Rounded Corners Without Math** | Concentric radius formula: $R_{outer} = R_{inner} + P_{padding}$ | Non-concentric nested radii create jarring visual warping. |
800
- | **Empty States with Dead Ends** | Empty states must provide contextual guidance + a primary Call to Action | Prevents confusing drop-offs for first-time users. |
801
-
802
- ---
803
-
804
- ## 9. Accessibility & APCA Contrast Invariants
805
-
806
- Tribunal Kit enforces strict compliance with WCAG 2.2 AA and modern APCA (Accessible Perceptual Contrast Algorithm) standards:
807
-
808
- 1. **APCA Contrast Thresholds:**
809
- - Primary Body Copy: Minimum $L^c \ge 60$ (preferred $L^c \ge 75$).
810
- - Large Headings ($\ge 24\text{px}$): Minimum $L^c \ge 45$.
811
- - Interactive Control Borders & Icons: Minimum $L^c \ge 45$.
812
- 2. **Focus Visibility:**
813
- - Every interactive control must have an unmistakable `:focus-visible` state.
814
- - Never use `outline: none` without providing an equivalent high-contrast focus indicator.
815
- 3. **Touch Targets:**
816
- - Minimum bounding box of $44\text{px} \times 44\text{px}$ on touch viewports (`@media (pointer: coarse)`).
817
- - Minimum bounding box of $36\text{px} \times 36\text{px}$ on desktop viewports.
818
- 4. **Non-Color Dependency:**
819
- - Never convey error, warning, or status strictly through color alone. Always pair status badges with an icon and text label.
820
-
821
- ---
822
-
823
- ## 10. Multi-Platform Synchronization (Web, Tailwind, Tokens JSON)
824
-
825
- ### Using Tokens in Tailwind CSS v4
826
-
827
- ```css
828
- @theme {
829
- --color-primary: var(--color-primary);
830
- --color-primary-hover: var(--color-primary-hover);
831
- --color-bg-base: var(--bg-base);
832
- --color-bg-surface: var(--bg-surface);
833
- --font-display: var(--font-display);
834
- --font-body: var(--font-body);
835
- --radius-sm: var(--radius-sm);
836
- --radius-md: var(--radius-md);
837
- --radius-lg: var(--radius-lg);
838
- }
839
- ```
840
-
841
- ### Synchronization with `design-tokens.json`
842
-
843
- All tokens in `DESIGN.md` have 1:1 representations in `design-tokens.json` following the W3C Design Tokens Community Group standard. Agents generating new components must verify that token variable names match both files.
1
+ # DESIGN.md — Product Design System
2
+
3
+ > **This file is your AI agent's source of truth for premium visual design.**
4
+ > Generated by `tribunal-kit init`. Choose and customize one Visual Direction for your brand.
5
+ > All coding agents MUST read this file before generating any UI code.
6
+
7
+ ---
8
+
9
+ ## 1. Chosen Visual Direction: [Enter Chosen Direction Here]
10
+
11
+ Choose **ONE** direction from the list below to define the brand visual system. Do not mix directions:
12
+
13
+ - **Swiss Precision:** Clean, grid-locked alignment, sans-serif typography, clinical whitespace, neutral OKLCH slates, zero border radii.
14
+ - **Brutalist:** Raw, exposed 2px borders, monospace display fonts, high-contrast acid accents, hard 4px offset drop shadows, sharp corners.
15
+ - **Editorial:** Magazine-inspired layout, large display serif headings, warm alabaster surfaces, deep terracotta accents, generous margins.
16
+ - **Neo-Glassmorphism:** Deep indigo dark base, translucent glass surfaces, high backdrop blur (`blur(20px)`), luminous hairlines, electric cyan accents.
17
+ - **Soft Minimal:** Warm tinted grays, graphite slate accents, rounded friendly shapes (`radius: 12px`), whisper-soft diffused shadows.
18
+ - **Dark Luxury:** OLED near-black base (`#08080C`), gold/amber accent lines, ultra-fine hairlines, understated typography, subtle animations.
19
+ - **Neon Cyberpunk:** Deep space navy base, highly saturated neon green/cyan glow effects, sharp geometry, technical monospace accents.
20
+ - **Retro Analog:** Warm grain parchment overlay, muted rust and olive tones, rounded typography, tactile paper-like borders.
21
+
22
+ ### Activation Guide
23
+
24
+ To activate your chosen identity:
25
+
26
+ 1. Replace `[Enter Chosen Direction Here]` above with your chosen theme name (e.g. `Swiss Precision`).
27
+ 2. Copy the corresponding tokens into your application's root stylesheet (`:root` or `:root[data-theme="..."]`).
28
+ 3. Ensure all components consume `var(--...)` tokens rather than hardcoded hex codes.
29
+
30
+ ---
31
+
32
+ ## 2. Visual Identities CSS Tokens Definition
33
+
34
+ ### 1. Swiss Precision
35
+
36
+ _Clean, rational, objective modernist design inspired by Josef Müller-Brockmann and the International Typographic Style._
37
+
38
+ ```css
39
+ :root {
40
+ /* Typography */
41
+ --font-display: 'General Sans', 'Helvetica Neue', Arial, sans-serif;
42
+ --font-body: 'Satoshi', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
43
+ --font-mono: 'JetBrains Mono', 'SF Mono', Consolas, monospace;
44
+
45
+ /* Surfaces */
46
+ --bg-base: oklch(0.98 0.002 240);
47
+ --bg-surface: oklch(1 0 0);
48
+ --bg-surface-raised: oklch(0.95 0.003 240);
49
+ --bg-surface-overlay: oklch(1 0 0 / 0.95);
50
+ --bg-surface-sunken: oklch(0.92 0.004 240);
51
+
52
+ /* Foreground & Text */
53
+ --text-primary: oklch(0.18 0.01 240);
54
+ --text-secondary: oklch(0.42 0.01 240);
55
+ --text-muted: oklch(0.6 0.008 240);
56
+ --text-inverse: oklch(0.98 0 0);
57
+
58
+ /* Accents */
59
+ --color-primary: oklch(0.2 0.01 240); /* Deep Graphite */
60
+ --color-primary-hover: oklch(0.35 0.01 240);
61
+ --color-primary-subtle: oklch(0.94 0.004 240);
62
+ --color-accent: oklch(0.55 0.22 25); /* International Klein Blue or Swiss Red */
63
+
64
+ /* Functional Status */
65
+ --status-success: oklch(0.55 0.16 145);
66
+ --status-warning: oklch(0.68 0.16 75);
67
+ --status-error: oklch(0.52 0.22 25);
68
+ --status-info: oklch(0.52 0.18 245);
69
+
70
+ /* Spacing Grid (Strict 8px system) */
71
+ --space-2xs: 2px;
72
+ --space-xs: 4px;
73
+ --space-sm: 8px;
74
+ --space-md: 16px;
75
+ --space-lg: 24px;
76
+ --space-xl: 32px;
77
+ --space-2xl: 48px;
78
+ --space-3xl: 64px;
79
+
80
+ /* Radii (Strict zero radius) */
81
+ --radius-xs: 0px;
82
+ --radius-sm: 0px;
83
+ --radius-md: 0px;
84
+ --radius-lg: 0px;
85
+ --radius-full: 0px;
86
+
87
+ /* Borders & Dividers */
88
+ --border-subtle: 1px solid oklch(0.88 0.003 240);
89
+ --border-strong: 1px solid oklch(0.18 0.01 240);
90
+ --border-focus: 2px solid oklch(0.2 0.01 240);
91
+
92
+ /* Elevation */
93
+ --shadow-sm: none;
94
+ --shadow-md: none;
95
+ --shadow-lg: 0 8px 0 oklch(0.18 0.01 240 / 0.15);
96
+ }
97
+ ```
98
+
99
+ ---
100
+
101
+ ### 2. Brutalist
102
+
103
+ _Uncompromising raw aesthetics, exposed structural outlines, monospace dominance, and hard cast shadows._
104
+
105
+ ```css
106
+ :root {
107
+ /* Typography */
108
+ --font-display: 'Space Grotesk', 'Impact', sans-serif;
109
+ --font-body: 'General Sans', -apple-system, sans-serif;
110
+ --font-mono: 'Space Mono', 'JetBrains Mono', monospace;
111
+
112
+ /* Surfaces */
113
+ --bg-base: oklch(1 0 0);
114
+ --bg-surface: oklch(1 0 0);
115
+ --bg-surface-raised: oklch(0.96 0.005 140);
116
+ --bg-surface-overlay: oklch(1 0 0);
117
+ --bg-surface-sunken: oklch(0.92 0.01 140);
118
+
119
+ /* Foreground & Text */
120
+ --text-primary: oklch(0.1 0.01 240);
121
+ --text-secondary: oklch(0.35 0.01 240);
122
+ --text-muted: oklch(0.55 0.01 240);
123
+ --text-inverse: oklch(1 0 0);
124
+
125
+ /* Accents */
126
+ --color-primary: oklch(0.6 0.28 140); /* Acid Lime */
127
+ --color-primary-hover: oklch(0.5 0.28 140);
128
+ --color-primary-subtle: oklch(0.93 0.1 140);
129
+ --color-accent: oklch(0.65 0.25 350); /* Cyber Pink */
130
+
131
+ /* Functional Status */
132
+ --status-success: oklch(0.6 0.28 140);
133
+ --status-warning: oklch(0.75 0.2 85);
134
+ --status-error: oklch(0.55 0.25 25);
135
+ --status-info: oklch(0.55 0.2 230);
136
+
137
+ /* Spacing */
138
+ --space-2xs: 2px;
139
+ --space-xs: 4px;
140
+ --space-sm: 8px;
141
+ --space-md: 16px;
142
+ --space-lg: 24px;
143
+ --space-xl: 32px;
144
+ --space-2xl: 48px;
145
+ --space-3xl: 64px;
146
+
147
+ /* Radii */
148
+ --radius-xs: 1px;
149
+ --radius-sm: 2px;
150
+ --radius-md: 2px;
151
+ --radius-lg: 3px;
152
+ --radius-full: 9999px;
153
+
154
+ /* Borders & Dividers (Heavy outlines) */
155
+ --border-subtle: 2px solid oklch(0.1 0.01 240);
156
+ --border-strong: 3px solid oklch(0.1 0.01 240);
157
+ --border-focus: 3px solid oklch(0.6 0.28 140);
158
+
159
+ /* Elevation (Hard drop-shadows with zero blur) */
160
+ --shadow-sm: 2px 2px 0px oklch(0.1 0.01 240);
161
+ --shadow-md: 4px 4px 0px oklch(0.1 0.01 240);
162
+ --shadow-lg: 8px 8px 0px oklch(0.1 0.01 240);
163
+ }
164
+ ```
165
+
166
+ ---
167
+
168
+ ### 3. Editorial
169
+
170
+ _Sophisticated literary elegance, high editorial serif headings, warm creamy paper textures, and generous margins._
171
+
172
+ ```css
173
+ :root {
174
+ /* Typography */
175
+ --font-display: 'Playfair Display', 'Newsreader', Georgia, serif;
176
+ --font-body: 'Source Sans 3', 'Satoshi', sans-serif;
177
+ --font-mono: 'Courier Prime', 'Courier New', monospace;
178
+
179
+ /* Surfaces */
180
+ --bg-base: oklch(0.97 0.006 65); /* Warm Alabaster */
181
+ --bg-surface: oklch(0.99 0.003 65);
182
+ --bg-surface-raised: oklch(0.94 0.009 65);
183
+ --bg-surface-overlay: oklch(0.99 0.003 65 / 0.95);
184
+ --bg-surface-sunken: oklch(0.91 0.012 65);
185
+
186
+ /* Foreground & Text */
187
+ --text-primary: oklch(0.2 0.02 55); /* Deep Espresso Charcoal */
188
+ --text-secondary: oklch(0.42 0.02 55);
189
+ --text-muted: oklch(0.62 0.015 65);
190
+ --text-inverse: oklch(0.98 0.005 65);
191
+
192
+ /* Accents */
193
+ --color-primary: oklch(0.38 0.13 30); /* Terracotta Sienna */
194
+ --color-primary-hover: oklch(0.28 0.13 30);
195
+ --color-primary-subtle: oklch(0.93 0.03 30);
196
+ --color-accent: oklch(0.45 0.1 85); /* Antique Olive Amber */
197
+
198
+ /* Functional Status */
199
+ --status-success: oklch(0.5 0.12 140);
200
+ --status-warning: oklch(0.65 0.14 75);
201
+ --status-error: oklch(0.48 0.18 28);
202
+ --status-info: oklch(0.48 0.12 230);
203
+
204
+ /* Spacing (Generous editorial flow) */
205
+ --space-2xs: 3px;
206
+ --space-xs: 6px;
207
+ --space-sm: 12px;
208
+ --space-md: 24px;
209
+ --space-lg: 36px;
210
+ --space-xl: 48px;
211
+ --space-2xl: 72px;
212
+ --space-3xl: 96px;
213
+
214
+ /* Radii */
215
+ --radius-xs: 2px;
216
+ --radius-sm: 4px;
217
+ --radius-md: 8px;
218
+ --radius-lg: 16px;
219
+ --radius-full: 9999px;
220
+
221
+ /* Borders & Dividers */
222
+ --border-subtle: 1px solid oklch(0.88 0.01 65);
223
+ --border-strong: 1px solid oklch(0.2 0.02 55);
224
+ --border-focus: 2px solid oklch(0.38 0.13 30);
225
+
226
+ /* Elevation (Soft paper elevation) */
227
+ --shadow-sm: 0 2px 8px oklch(0.2 0.02 55 / 0.05);
228
+ --shadow-md: 0 8px 24px oklch(0.2 0.02 55 / 0.08);
229
+ --shadow-lg: 0 16px 48px oklch(0.2 0.02 55 / 0.12);
230
+ }
231
+ ```
232
+
233
+ ---
234
+
235
+ ### 4. Neo-Glassmorphism
236
+
237
+ _Deep luminous indigo backdrops, progressive frosted glass layers, neon cyan accents, and 1px luminous hairlines._
238
+
239
+ ```css
240
+ :root {
241
+ /* Typography */
242
+ --font-display: 'Clash Display', 'Plus Jakarta Sans', sans-serif;
243
+ --font-body: 'Satoshi', 'Inter', sans-serif;
244
+ --font-mono: 'JetBrains Mono', monospace;
245
+
246
+ /* Surfaces */
247
+ --bg-base: oklch(0.12 0.018 250); /* Midnight Obsidian */
248
+ --bg-surface: oklch(1 0 0 / 0.08); /* Translucent Glass */
249
+ --bg-surface-raised: oklch(1 0 0 / 0.14);
250
+ --bg-surface-overlay: oklch(0.14 0.02 250 / 0.85);
251
+ --bg-surface-sunken: oklch(0.08 0.01 250 / 0.5);
252
+
253
+ /* Foreground & Text */
254
+ --text-primary: oklch(0.98 0.005 240);
255
+ --text-secondary: oklch(0.78 0.015 240);
256
+ --text-muted: oklch(0.55 0.02 240);
257
+ --text-inverse: oklch(0.12 0.02 250);
258
+
259
+ /* Accents */
260
+ --color-primary: oklch(0.72 0.2 205); /* Luminescent Electric Cyan */
261
+ --color-primary-hover: oklch(0.62 0.2 205);
262
+ --color-primary-subtle: oklch(0.72 0.2 205 / 0.15);
263
+ --color-accent: oklch(0.75 0.18 310); /* Luminescent Orchid */
264
+
265
+ /* Functional Status */
266
+ --status-success: oklch(0.72 0.2 150);
267
+ --status-warning: oklch(0.78 0.18 80);
268
+ --status-error: oklch(0.65 0.22 25);
269
+ --status-info: oklch(0.72 0.2 220);
270
+
271
+ /* Spacing */
272
+ --space-2xs: 2px;
273
+ --space-xs: 4px;
274
+ --space-sm: 8px;
275
+ --space-md: 16px;
276
+ --space-lg: 24px;
277
+ --space-xl: 32px;
278
+ --space-2xl: 48px;
279
+ --space-3xl: 64px;
280
+
281
+ /* Radii */
282
+ --radius-xs: 4px;
283
+ --radius-sm: 8px;
284
+ --radius-md: 16px;
285
+ --radius-lg: 28px;
286
+ --radius-full: 9999px;
287
+
288
+ /* Borders & Glass Filters */
289
+ --backdrop-blur: blur(20px) saturate(180%);
290
+ --border-subtle: 1px solid oklch(1 0 0 / 0.12);
291
+ --border-strong: 1px solid oklch(1 0 0 / 0.24);
292
+ --border-focus: 2px solid oklch(0.72 0.2 205);
293
+
294
+ /* Elevation (Soft luminous colored glows) */
295
+ --shadow-sm: 0 4px 16px oklch(0% 0 0 / 0.25);
296
+ --shadow-md: 0 12px 32px oklch(0% 0 0 / 0.4);
297
+ --shadow-lg: 0 20px 60px oklch(0% 0 0 / 0.55), 0 0 30px oklch(0.72 0.2 205 / 0.15);
298
+ }
299
+ ```
300
+
301
+ ---
302
+
303
+ ### 5. Soft Minimal
304
+
305
+ _Understated Nordic restraint, warm organic off-whites, gentle rounded corners, whisper-quiet shadows, and peaceful spacing._
306
+
307
+ ```css
308
+ :root {
309
+ /* Typography */
310
+ --font-display: 'Geist Sans', 'Inter', -apple-system, sans-serif;
311
+ --font-body: 'Geist Sans', 'Inter', -apple-system, sans-serif;
312
+ --font-mono: 'Geist Mono', 'SF Mono', monospace;
313
+
314
+ /* Surfaces */
315
+ --bg-base: oklch(0.98 0.003 80); /* Warm Parchment Slate */
316
+ --bg-surface: oklch(1 0 0);
317
+ --bg-surface-raised: oklch(0.96 0.005 80);
318
+ --bg-surface-overlay: oklch(1 0 0 / 0.96);
319
+ --bg-surface-sunken: oklch(0.93 0.006 80);
320
+
321
+ /* Foreground & Text */
322
+ --text-primary: oklch(0.24 0.015 240);
323
+ --text-secondary: oklch(0.48 0.015 240);
324
+ --text-muted: oklch(0.66 0.01 240);
325
+ --text-inverse: oklch(0.98 0 0);
326
+
327
+ /* Accents */
328
+ --color-primary: oklch(0.36 0.05 240); /* Warm Graphite */
329
+ --color-primary-hover: oklch(0.26 0.05 240);
330
+ --color-primary-subtle: oklch(0.94 0.01 240);
331
+ --color-accent: oklch(0.58 0.12 180); /* Sage Teal */
332
+
333
+ /* Functional Status */
334
+ --status-success: oklch(0.58 0.12 145);
335
+ --status-warning: oklch(0.72 0.13 80);
336
+ --status-error: oklch(0.56 0.18 25);
337
+ --status-info: oklch(0.55 0.14 240);
338
+
339
+ /* Spacing */
340
+ --space-2xs: 2px;
341
+ --space-xs: 4px;
342
+ --space-sm: 8px;
343
+ --space-md: 16px;
344
+ --space-lg: 24px;
345
+ --space-xl: 32px;
346
+ --space-2xl: 48px;
347
+ --space-3xl: 64px;
348
+
349
+ /* Radii */
350
+ --radius-xs: 4px;
351
+ --radius-sm: 6px;
352
+ --radius-md: 12px;
353
+ --radius-lg: 20px;
354
+ --radius-full: 9999px;
355
+
356
+ /* Borders & Dividers */
357
+ --border-subtle: 1px solid oklch(0.92 0.004 80);
358
+ --border-strong: 1px solid oklch(0.78 0.01 80);
359
+ --border-focus: 2px solid oklch(0.36 0.05 240);
360
+
361
+ /* Elevation (Ultra-diffused feather shadows) */
362
+ --shadow-sm: 0 1px 3px oklch(0.2 0.01 240 / 0.03), 0 1px 2px oklch(0.2 0.01 240 / 0.02);
363
+ --shadow-md: 0 4px 16px oklch(0.2 0.01 240 / 0.05), 0 2px 6px oklch(0.2 0.01 240 / 0.03);
364
+ --shadow-lg: 0 12px 36px oklch(0.2 0.01 240 / 0.08), 0 4px 12px oklch(0.2 0.01 240 / 0.04);
365
+ }
366
+ ```
367
+
368
+ ---
369
+
370
+ ### 6. Dark Luxury
371
+
372
+ _Private-banking exclusivity, deep OLED black canvas, gold/champagne hairline accents, and razor-sharp typographic precision._
373
+
374
+ ```css
375
+ :root {
376
+ /* Typography */
377
+ --font-display: 'Cabinet Grotesk', 'Cormorant Garamond', serif;
378
+ --font-body: 'Satoshi', 'Outfit', -apple-system, sans-serif;
379
+ --font-mono: 'JetBrains Mono', monospace;
380
+
381
+ /* Surfaces */
382
+ --bg-base: oklch(0.08 0.005 250); /* OLED Jet Black */
383
+ --bg-surface: oklch(0.12 0.008 250);
384
+ --bg-surface-raised: oklch(0.16 0.01 250);
385
+ --bg-surface-overlay: oklch(0.12 0.008 250 / 0.92);
386
+ --bg-surface-sunken: oklch(0.05 0.003 250);
387
+
388
+ /* Foreground & Text */
389
+ --text-primary: oklch(0.95 0.005 85);
390
+ --text-secondary: oklch(0.74 0.015 85);
391
+ --text-muted: oklch(0.48 0.015 85);
392
+ --text-inverse: oklch(0.08 0.005 250);
393
+
394
+ /* Accents */
395
+ --color-primary: oklch(0.78 0.12 85); /* Muted Imperial Gold */
396
+ --color-primary-hover: oklch(0.68 0.12 85);
397
+ --color-primary-subtle: oklch(0.78 0.12 85 / 0.12);
398
+ --color-accent: oklch(0.85 0.08 90); /* Champagne Pearl */
399
+
400
+ /* Functional Status */
401
+ --status-success: oklch(0.65 0.14 145);
402
+ --status-warning: oklch(0.78 0.12 85);
403
+ --status-error: oklch(0.58 0.2 25);
404
+ --status-info: oklch(0.62 0.12 240);
405
+
406
+ /* Spacing */
407
+ --space-2xs: 2px;
408
+ --space-xs: 4px;
409
+ --space-sm: 8px;
410
+ --space-md: 16px;
411
+ --space-lg: 24px;
412
+ --space-xl: 32px;
413
+ --space-2xl: 48px;
414
+ --space-3xl: 64px;
415
+
416
+ /* Radii */
417
+ --radius-xs: 2px;
418
+ --radius-sm: 4px;
419
+ --radius-md: 6px;
420
+ --radius-lg: 12px;
421
+ --radius-full: 9999px;
422
+
423
+ /* Borders & Hairlines */
424
+ --border-subtle: 1px solid oklch(0.24 0.01 250);
425
+ --border-strong: 1px solid oklch(0.78 0.12 85 / 0.4);
426
+ --border-focus: 2px solid oklch(0.78 0.12 85);
427
+
428
+ /* Elevation */
429
+ --shadow-sm: 0 2px 6px oklch(0 0 0 / 0.4);
430
+ --shadow-md: 0 8px 24px oklch(0 0 0 / 0.6);
431
+ --shadow-lg: 0 16px 48px oklch(0 0 0 / 0.8), 0 0 1px oklch(0.78 0.12 85 / 0.25);
432
+ }
433
+ ```
434
+
435
+ ---
436
+
437
+ ### 7. Neon Cyberpunk
438
+
439
+ _High-velocity terminal engineering, deep space navy, vivid radiant lasers, chromatic contrast, and angular geometry._
440
+
441
+ ```css
442
+ :root {
443
+ /* Typography */
444
+ --font-display: 'Space Grotesk', 'Syne', sans-serif;
445
+ --font-body: 'General Sans', 'Inter', sans-serif;
446
+ --font-mono: 'JetBrains Mono', 'Fira Code', monospace;
447
+
448
+ /* Surfaces */
449
+ --bg-base: oklch(0.05 0.012 280); /* Void Navy */
450
+ --bg-surface: oklch(0.09 0.018 280);
451
+ --bg-surface-raised: oklch(0.14 0.024 280);
452
+ --bg-surface-overlay: oklch(0.09 0.018 280 / 0.92);
453
+ --bg-surface-sunken: oklch(0.03 0.008 280);
454
+
455
+ /* Foreground & Text */
456
+ --text-primary: oklch(0.98 0.01 200);
457
+ --text-secondary: oklch(0.76 0.03 200);
458
+ --text-muted: oklch(0.5 0.04 280);
459
+ --text-inverse: oklch(0.05 0.012 280);
460
+
461
+ /* Accents */
462
+ --color-primary: oklch(0.75 0.28 160); /* Acid Neon Emerald */
463
+ --color-primary-hover: oklch(0.85 0.28 160);
464
+ --color-primary-subtle: oklch(0.75 0.28 160 / 0.15);
465
+ --color-accent: oklch(0.72 0.26 330); /* Plasma Magenta */
466
+
467
+ /* Functional Status */
468
+ --status-success: oklch(0.75 0.28 160);
469
+ --status-warning: oklch(0.82 0.22 95);
470
+ --status-error: oklch(0.68 0.28 25);
471
+ --status-info: oklch(0.72 0.24 230);
472
+
473
+ /* Spacing */
474
+ --space-2xs: 2px;
475
+ --space-xs: 4px;
476
+ --space-sm: 8px;
477
+ --space-md: 16px;
478
+ --space-lg: 24px;
479
+ --space-xl: 32px;
480
+ --space-2xl: 48px;
481
+ --space-3xl: 64px;
482
+
483
+ /* Radii */
484
+ --radius-xs: 0px;
485
+ --radius-sm: 2px;
486
+ --radius-md: 4px;
487
+ --radius-lg: 8px;
488
+ --radius-full: 9999px;
489
+
490
+ /* Borders & Glows */
491
+ --border-subtle: 1px solid oklch(0.22 0.04 280);
492
+ --border-strong: 1px solid oklch(0.75 0.28 160 / 0.5);
493
+ --border-focus: 2px solid oklch(0.75 0.28 160);
494
+
495
+ /* Elevation (Neon radiance glows) */
496
+ --shadow-sm: 0 0 10px oklch(0.75 0.28 160 / 0.2);
497
+ --shadow-md: 0 0 20px oklch(0.75 0.28 160 / 0.35);
498
+ --shadow-lg: 0 0 35px oklch(0.75 0.28 160 / 0.5), 0 0 70px oklch(0.72 0.26 330 / 0.25);
499
+ }
500
+ ```
501
+
502
+ ---
503
+
504
+ ### 8. Retro Analog
505
+
506
+ _Warm archival grain, vintage print craftsmanship, typewriter monospace elements, and physical print textures._
507
+
508
+ ```css
509
+ :root {
510
+ /* Typography */
511
+ --font-display: 'Clash Display', 'Cooper Black', serif;
512
+ --font-body: 'Switzer', 'Courier Prime', monospace, sans-serif;
513
+ --font-mono: 'Courier Prime', 'Courier New', monospace;
514
+
515
+ /* Surfaces */
516
+ --bg-base: oklch(0.93 0.018 72); /* Archival Newsprint */
517
+ --bg-surface: oklch(0.96 0.015 72);
518
+ --bg-surface-raised: oklch(0.9 0.022 72);
519
+ --bg-surface-overlay: oklch(0.96 0.015 72 / 0.95);
520
+ --bg-surface-sunken: oklch(0.87 0.025 72);
521
+
522
+ /* Foreground & Text */
523
+ --text-primary: oklch(0.22 0.025 50); /* Deep Raw Umber */
524
+ --text-secondary: oklch(0.42 0.025 50);
525
+ --text-muted: oklch(0.6 0.02 60);
526
+ --text-inverse: oklch(0.96 0.015 72);
527
+
528
+ /* Accents */
529
+ --color-primary: oklch(0.5 0.18 45); /* Burnished Rust Amber */
530
+ --color-primary-hover: oklch(0.4 0.18 45);
531
+ --color-primary-subtle: oklch(0.9 0.04 45);
532
+ --color-accent: oklch(0.48 0.12 120); /* Vintage Forest Olive */
533
+
534
+ /* Functional Status */
535
+ --status-success: oklch(0.48 0.12 135);
536
+ --status-warning: oklch(0.66 0.15 75);
537
+ --status-error: oklch(0.46 0.18 30);
538
+ --status-info: oklch(0.48 0.1 220);
539
+
540
+ /* Spacing */
541
+ --space-2xs: 3px;
542
+ --space-xs: 5px;
543
+ --space-sm: 10px;
544
+ --space-md: 20px;
545
+ --space-lg: 30px;
546
+ --space-xl: 40px;
547
+ --space-2xl: 60px;
548
+ --space-3xl: 80px;
549
+
550
+ /* Radii */
551
+ --radius-xs: 2px;
552
+ --radius-sm: 4px;
553
+ --radius-md: 8px;
554
+ --radius-lg: 16px;
555
+ --radius-full: 9999px;
556
+
557
+ /* Borders & Dividers */
558
+ --border-subtle: 1px solid oklch(0.84 0.02 72);
559
+ --border-strong: 2px solid oklch(0.22 0.025 50);
560
+ --border-focus: 2px solid oklch(0.5 0.18 45);
561
+
562
+ /* Elevation (Tactile offset print shadows) */
563
+ --shadow-sm: 1px 1px 0px oklch(0.22 0.025 50 / 0.3);
564
+ --shadow-md: 3px 3px 0px oklch(0.22 0.025 50 / 0.4);
565
+ --shadow-lg: 6px 6px 0px oklch(0.22 0.025 50 / 0.5);
566
+ }
567
+ ```
568
+
569
+ ---
570
+
571
+ ## 3. Typographical Architecture & Fluid Scale
572
+
573
+ Every interface must use mathematical fluid scaling via CSS `clamp()` to scale seamlessly across viewports without breakpoint jumps.
574
+
575
+ ### Fluid Typography Scale
576
+
577
+ ```css
578
+ :root {
579
+ /* Display / Hero */
580
+ --text-display: clamp(2.5rem, 1.8rem + 3.5vw, 4.5rem); /* 40px -> 72px */
581
+ --line-display: 1.05;
582
+ --tracking-display: -0.03em;
583
+
584
+ /* Heading 1 */
585
+ --text-h1: clamp(2rem, 1.5rem + 2.5vw, 3.25rem); /* 32px -> 52px */
586
+ --line-h1: 1.15;
587
+ --tracking-h1: -0.025em;
588
+
589
+ /* Heading 2 */
590
+ --text-h2: clamp(1.5rem, 1.2rem + 1.5vw, 2.25rem); /* 24px -> 36px */
591
+ --line-h2: 1.25;
592
+ --tracking-h2: -0.02em;
593
+
594
+ /* Heading 3 */
595
+ --text-h3: clamp(1.25rem, 1.1rem + 0.75vw, 1.625rem); /* 20px -> 26px */
596
+ --line-h3: 1.35;
597
+ --tracking-h3: -0.015em;
598
+
599
+ /* Body Typography */
600
+ --text-body-lg: clamp(1.125rem, 1.05rem + 0.35vw, 1.25rem); /* 18px -> 20px */
601
+ --text-body: clamp(0.9375rem, 0.9rem + 0.2vw, 1rem); /* 15px -> 16px */
602
+ --text-body-sm: clamp(0.8125rem, 0.8rem + 0.1vw, 0.875rem); /* 13px -> 14px */
603
+ --text-caption: 0.75rem; /* 12px */
604
+
605
+ --line-body: 1.6;
606
+ --tracking-body: 0em;
607
+ --tracking-caps: 0.06em;
608
+ }
609
+ ```
610
+
611
+ ### Typographic Invariants
612
+
613
+ 1. **Headline Balancing:** Always add `text-wrap: balance` on all `h1`, `h2`, `h3` tags to eliminate orphan words.
614
+ 2. **Body Text Wrapping:** Add `text-wrap: pretty` on long-form paragraphs to prevent dangling end lines.
615
+ 3. **Reading Line Length:** Never exceed `65ch` on prose container widths (`max-width: 65ch`).
616
+ 4. **Tabular Numerics:** All numbers, financial metrics, counters, and table data MUST use `font-variant-numeric: tabular-nums` to prevent horizontal jitter during updates.
617
+ 5. **Tracking Cadence:** Tighter tracking on larger headings (`-0.025em`), neutral on body (`0em`), and expanded tracking on uppercase labels (`0.06em`).
618
+
619
+ ---
620
+
621
+ ## 4. Spatial Discipline, Container Queries & Concentric Geometry
622
+
623
+ ### The 8-Point Spatial Grid
624
+
625
+ All margins, paddings, and layout gaps MUST adhere to multiples of the 8px spatial grid, with 4px half-steps permitted only for dense micro-controls (e.g., chips, tags, inputs):
626
+
627
+ - `4px` (xs): Tight component internals, icon-to-text spacing.
628
+ - `8px` (sm): Standard intra-component padding, button gaps.
629
+ - `16px` (md): Card padding, list item separation.
630
+ - `24px` (lg): Section grid gaps, modal content padding.
631
+ - `32px` (xl): Page column gutters, card container separation.
632
+ - `48px` (2xl): Section breaks on mobile.
633
+ - `64px`–`96px` (3xl): Major landing section boundaries on desktop.
634
+
635
+ ### Concentric Nested Radius Law
636
+
637
+ To avoid visual tension caused by non-concentric curves, the outer radius MUST equal the inner radius plus the inner padding:
638
+
639
+ $$\mathbf{R_{\text{outer}} = R_{\text{inner}} + P_{\text{padding}}}$$
640
+
641
+ ```css
642
+ /* Concentric Example: Card with an internal Button/Image */
643
+ .parent-card {
644
+ padding: 16px; /* P_padding = 16px */
645
+ border-radius: 24px; /* R_outer = 8px + 16px = 24px */
646
+ }
647
+
648
+ .child-element {
649
+ border-radius: 8px; /* R_inner = 8px */
650
+ }
651
+ ```
652
+
653
+ ### Container Queries Architecture
654
+
655
+ For modular components that adapt to their container rather than the screen viewport:
656
+
657
+ ```css
658
+ .card-container {
659
+ container-type: inline-size;
660
+ container-name: card;
661
+ }
662
+
663
+ @container card (min-width: 480px) {
664
+ .card-layout {
665
+ display: grid;
666
+ grid-template-columns: 120px 1fr;
667
+ gap: var(--space-md);
668
+ }
669
+ }
670
+ ```
671
+
672
+ ---
673
+
674
+ ## 5. Interaction Physics, Motion & Micro-Interactions
675
+
676
+ Every interactive element MUST possess intentional, physical micro-interactions across all five fundamental interaction states.
677
+
678
+ ### The 5 Interaction States Matrix
679
+
680
+ | State | Visual Behavior | CSS Implementation |
681
+ | :------------------- | :---------------------------------------------------- | :---------------------------------------------------------------------- |
682
+ | **Default** | Baseline resting surface and border | `background-color: var(--bg-surface); border: var(--border-subtle);` |
683
+ | **Hover** | Subtle elevation, background brightness shift (+4% L) | `background-color: var(--color-primary-hover); cursor: pointer;` |
684
+ | **Focus-Visible** | High-contrast double ring outline with 2px offset | `outline: var(--border-focus); outline-offset: 2px;` |
685
+ | **Active / Pressed** | Tactile physical compression (`scale(0.97)`) | `transform: scale(0.97); transition-duration: var(--duration-instant);` |
686
+ | **Disabled** | 50% opacity, desaturated, cursor blocked | `opacity: 0.5; cursor: not-allowed; pointer-events: none;` |
687
+
688
+ ### Motion Tokens & Physics Curves
689
+
690
+ ```css
691
+ :root {
692
+ /* Durations */
693
+ --duration-instant: 100ms; /* Active press, switches */
694
+ --duration-fast: 150ms; /* Hover states, tooltips */
695
+ --duration-base: 250ms; /* Dropdowns, dialogs, card expands */
696
+ --duration-slow: 400ms; /* Page transitions, drawer slides */
697
+
698
+ /* Easing Curves */
699
+ --ease-spring: cubic-bezier(0.175, 0.885, 0.32, 1.275); /* Tactile bounce */
700
+ --ease-out-expo: cubic-bezier(0.16, 1, 0.3, 1); /* Snappy deceleration */
701
+ --ease-smooth: cubic-bezier(0.4, 0, 0.2, 1); /* Natural material curve */
702
+ }
703
+ ```
704
+
705
+ ### Motion Invariants
706
+
707
+ 1. **Never Animate Layout Properties:** Only animate compositor-friendly properties (`transform`, `opacity`, `filter`). Never animate `width`, `height`, `margin`, or `top` directly.
708
+ 2. **Ban `transition: all`:** Always specify exact properties being transitioned (e.g. `transition: transform var(--duration-fast) var(--ease-spring), opacity var(--duration-fast) ease`).
709
+ 3. **Respect Reduced Motion:**
710
+
711
+ ```css
712
+ @media (prefers-reduced-motion: reduce) {
713
+ *,
714
+ *::before,
715
+ *::after {
716
+ animation-duration: 0.01ms !important;
717
+ animation-iteration-count: 1 !important;
718
+ transition-duration: 0.01ms !important;
719
+ scroll-behavior: auto !important;
720
+ }
721
+ }
722
+ ```
723
+
724
+ ---
725
+
726
+ ## 6. Elevation, Depth & Layering Architecture
727
+
728
+ Surfaces must layer cleanly along the Z-axis using dual-shadow illumination (diffuse ambient bounce + sharp contact shadow):
729
+
730
+ ```css
731
+ :root {
732
+ /* Level 0: Canvas Base (flat) */
733
+ /* Level 1: Cards & Panels */
734
+ --shadow-sm: 0 1px 2px oklch(0 0 0 / 0.06), 0 2px 4px oklch(0 0 0 / 0.04);
735
+
736
+ /* Level 2: Menus & Popovers */
737
+ --shadow-md: 0 4px 6px -1px oklch(0 0 0 / 0.08), 0 10px 20px -3px oklch(0 0 0 / 0.06);
738
+
739
+ /* Level 3: Modals & Drawers */
740
+ --shadow-lg: 0 10px 15px -3px oklch(0 0 0 / 0.1), 0 24px 48px -6px oklch(0 0 0 / 0.12);
741
+
742
+ /* Level 4: Floating Toasts & Critical Alerts */
743
+ --shadow-xl: 0 20px 25px -5px oklch(0 0 0 / 0.14), 0 36px 64px -10px oklch(0 0 0 / 0.16);
744
+ }
745
+ ```
746
+
747
+ ### Progressive Backdrop Blur
748
+
749
+ For modern floating headers, modals, and sticky action bars:
750
+
751
+ ```css
752
+ .frosted-overlay {
753
+ background-color: var(--bg-surface-overlay);
754
+ backdrop-filter: blur(16px) saturate(160%);
755
+ -webkit-backdrop-filter: blur(16px) saturate(160%);
756
+ border-bottom: var(--border-subtle);
757
+ }
758
+ ```
759
+
760
+ ---
761
+
762
+ ## 7. Core Component Primitives Contract
763
+
764
+ All generated UI components must adhere to the following architectural contracts:
765
+
766
+ ### 1. Button Primitive
767
+
768
+ - **Variants:** `primary`, `secondary`, `outline`, `ghost`, `destructive`.
769
+ - **Sizes:** `sm` (32px h, 12px px), `md` (40px h, 16px px), `lg` (48px h, 20px px).
770
+ - **Invariants:** Must have `display: inline-flex`, `align-items: center`, `justify-content: center`, `gap: var(--space-xs)`.
771
+ - **States:** Active state must use `transform: scale(0.97)` with `--duration-instant`.
772
+
773
+ ### 2. Form Control Primitive (Inputs & Selects)
774
+
775
+ - **Minimum Target Size:** Minimum height `40px` (desktop), `44px` (touch devices).
776
+ - **Resting:** `border: var(--border-subtle); background: var(--bg-surface);`.
777
+ - **Focus:** `border-color: var(--color-primary); box-shadow: 0 0 0 3px var(--color-primary-subtle); outline: none;`.
778
+ - **Error:** `border-color: var(--status-error); box-shadow: 0 0 0 3px oklch(0.55 0.20 25 / 0.15);`.
779
+
780
+ ### 3. Modal / Dialog Primitive
781
+
782
+ - **Scrim Backdrop:** `background-color: oklch(0 0 0 / 0.50); backdrop-filter: blur(8px);`.
783
+ - **Placement:** Centered with spring scale entrance (`scale(0.95) -> scale(1.00)`).
784
+ - **Accessibility:** Must trap keyboard focus (`Tab` navigation constrained inside dialog), `Escape` to close, return focus to trigger on exit.
785
+
786
+ ---
787
+
788
+ ## 8. Anti-AI Clichés & Tribunal Aesthetic Invariants
789
+
790
+ AI models routinely generate bland, template-like interfaces unless strictly constrained. All coding agents MUST comply with the following Anti-Slop Table:
791
+
792
+ | Anti-Pattern (AI Slop) | Tribunal Standard | Reason / Rationale |
793
+ | :---------------------------------------------- | :----------------------------------------------------------------------------- | :---------------------------------------------------------------- |
794
+ | **Generic Purple/Violet Gradients** (`#8B5CF6`) | Use curated brand palette or monochrome slate + high-chroma single accent | Violet gradients are the universal AI cliché stamp. |
795
+ | **Stock Split Hero (Text Left / Image Right)** | Asymmetric editorial typography, interactive terminal, or canvas preview | Overused boilerplate looks like a generic 2020 SaaS template. |
796
+ | **Unreadable Low-Contrast Gray Text** | Minimum contrast APCA Lc ≥ 60 or WCAG 4.5:1 on all surfaces | Faint gray text harms readability and fails accessibility. |
797
+ | **Overuse of Heavy Mesh Gradients** | Crisp solid surfaces, grain texture, or subtle targeted radial spotlight glows | Mesh gradients look noisy, generic, and degrade GPU battery life. |
798
+ | **Universal `transition: all 0.3s`** | Declare explicit animated properties with spring or exponential easing curves | Animating `all` causes layout jank and performance degradation. |
799
+ | **Nested Rounded Corners Without Math** | Concentric radius formula: $R_{outer} = R_{inner} + P_{padding}$ | Non-concentric nested radii create jarring visual warping. |
800
+ | **Empty States with Dead Ends** | Empty states must provide contextual guidance + a primary Call to Action | Prevents confusing drop-offs for first-time users. |
801
+
802
+ ---
803
+
804
+ ## 9. Accessibility & APCA Contrast Invariants
805
+
806
+ Tribunal Kit enforces strict compliance with WCAG 2.2 AA and modern APCA (Accessible Perceptual Contrast Algorithm) standards:
807
+
808
+ 1. **APCA Contrast Thresholds:**
809
+ - Primary Body Copy: Minimum $L^c \ge 60$ (preferred $L^c \ge 75$).
810
+ - Large Headings ($\ge 24\text{px}$): Minimum $L^c \ge 45$.
811
+ - Interactive Control Borders & Icons: Minimum $L^c \ge 45$.
812
+ 2. **Focus Visibility:**
813
+ - Every interactive control must have an unmistakable `:focus-visible` state.
814
+ - Never use `outline: none` without providing an equivalent high-contrast focus indicator.
815
+ 3. **Touch Targets:**
816
+ - Minimum bounding box of $44\text{px} \times 44\text{px}$ on touch viewports (`@media (pointer: coarse)`).
817
+ - Minimum bounding box of $36\text{px} \times 36\text{px}$ on desktop viewports.
818
+ 4. **Non-Color Dependency:**
819
+ - Never convey error, warning, or status strictly through color alone. Always pair status badges with an icon and text label.
820
+
821
+ ---
822
+
823
+ ## 10. Multi-Platform Synchronization (Web, Tailwind, Tokens JSON)
824
+
825
+ ### Using Tokens in Tailwind CSS v4
826
+
827
+ ```css
828
+ @theme {
829
+ --color-primary: var(--color-primary);
830
+ --color-primary-hover: var(--color-primary-hover);
831
+ --color-bg-base: var(--bg-base);
832
+ --color-bg-surface: var(--bg-surface);
833
+ --font-display: var(--font-display);
834
+ --font-body: var(--font-body);
835
+ --radius-sm: var(--radius-sm);
836
+ --radius-md: var(--radius-md);
837
+ --radius-lg: var(--radius-lg);
838
+ }
839
+ ```
840
+
841
+ ### Synchronization with `design-tokens.json`
842
+
843
+ All tokens in `DESIGN.md` have 1:1 representations in `design-tokens.json` following the W3C Design Tokens Community Group standard. Agents generating new components must verify that token variable names match both files.