tribunal-kit 9.2.4 → 9.2.5

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 (1037) 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 +18 -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/api-architect.md +89 -89
  11. package/.agent/agents/architecture-auditor.md +195 -0
  12. package/.agent/agents/backend-specialist.md +242 -242
  13. package/.agent/agents/cloud-engineer.md +120 -120
  14. package/.agent/agents/code-archaeologist.md +186 -186
  15. package/.agent/agents/complexity-reviewer.md +76 -76
  16. package/.agent/agents/database-architect.md +206 -206
  17. package/.agent/agents/db-latency-auditor.md +237 -237
  18. package/.agent/agents/debugger.md +215 -215
  19. package/.agent/agents/dependency-reviewer.md +124 -124
  20. package/.agent/agents/devops-engineer.md +240 -240
  21. package/.agent/agents/documentation-writer.md +228 -228
  22. package/.agent/agents/explorer-agent.md +186 -186
  23. package/.agent/agents/frontend-reviewer.md +195 -195
  24. package/.agent/agents/frontend-specialist.md +122 -122
  25. package/.agent/agents/game-developer.md +68 -68
  26. package/.agent/agents/harness-manager.md +49 -49
  27. package/.agent/agents/human-gate-negotiator.md +22 -22
  28. package/.agent/agents/interaction-reviewer.md +123 -123
  29. package/.agent/agents/kernel-scheduler.md +56 -56
  30. package/.agent/agents/logic-reviewer.md +147 -147
  31. package/.agent/agents/memory-archivist.md +37 -37
  32. package/.agent/agents/minimalist-reviewer.md +104 -104
  33. package/.agent/agents/mobile-developer.md +216 -216
  34. package/.agent/agents/mobile-reviewer.md +180 -180
  35. package/.agent/agents/orchestrator.md +268 -268
  36. package/.agent/agents/penetration-tester.md +180 -180
  37. package/.agent/agents/performance-optimizer.md +202 -202
  38. package/.agent/agents/performance-reviewer.md +180 -180
  39. package/.agent/agents/pipeline-reviewer.md +144 -144
  40. package/.agent/agents/precedence-reviewer.md +266 -266
  41. package/.agent/agents/product-manager.md +167 -167
  42. package/.agent/agents/product-owner.md +103 -103
  43. package/.agent/agents/product-reviewer.md +103 -103
  44. package/.agent/agents/project-planner.md +181 -181
  45. package/.agent/agents/qa-automation-engineer.md +244 -244
  46. package/.agent/agents/resilience-reviewer.md +108 -108
  47. package/.agent/agents/schema-reviewer.md +87 -87
  48. package/.agent/agents/security-auditor.md +204 -204
  49. package/.agent/agents/seo-specialist.md +213 -213
  50. package/.agent/agents/sql-reviewer.md +180 -180
  51. package/.agent/agents/supervisor-agent.md +202 -202
  52. package/.agent/agents/swarm-worker-contracts.md +170 -170
  53. package/.agent/agents/swarm-worker-registry.md +99 -99
  54. package/.agent/agents/system-architect.md +260 -105
  55. package/.agent/agents/test-coverage-reviewer.md +181 -181
  56. package/.agent/agents/test-engineer.md +138 -138
  57. package/.agent/agents/throughput-optimizer.md +316 -316
  58. package/.agent/agents/type-safety-reviewer.md +202 -202
  59. package/.agent/agents/ui-ux-auditor.md +80 -80
  60. package/.agent/agents/ui-visual-auditor.md +102 -102
  61. package/.agent/agents/ux-reviewer.md +109 -109
  62. package/.agent/agents/visual-reviewer.md +103 -103
  63. package/.agent/agents/vitals-reviewer.md +245 -245
  64. package/.agent/config/claude.json +18 -18
  65. package/.agent/config/plugin.json +102 -102
  66. package/.agent/config/slash-commands.json +115 -115
  67. package/.agent/config/specialist-registry.json +415 -415
  68. package/.agent/config/system-prompt.md +258 -258
  69. package/.agent/history/arch-mapper-cache.json +6712 -0
  70. package/.agent/history/architecture.idx.json +5746 -0
  71. package/.agent/mcp_config.json +32 -32
  72. package/.agent/patterns/generator.md +11 -11
  73. package/.agent/patterns/inversion.md +14 -14
  74. package/.agent/patterns/pipeline.md +11 -11
  75. package/.agent/patterns/reviewer.md +15 -15
  76. package/.agent/patterns/tool-wrapper.md +11 -11
  77. package/.agent/plans/implementation_plan.md +48 -0
  78. package/.agent/plans/task.md +35 -0
  79. package/.agent/routing_index.json +2060 -2060
  80. package/.agent/rules/GEMINI.md +437 -437
  81. package/.agent/rules/GEMINI_PLANNER.md +82 -82
  82. package/.agent/rules/kernel.md +86 -86
  83. package/.agent/scripts/_colors.js +210 -210
  84. package/.agent/scripts/_utils.js +373 -377
  85. package/.agent/scripts/architecture_mapper.js +625 -0
  86. package/.agent/scripts/ast_context_loader.js +137 -137
  87. package/.agent/scripts/auto_preview.js +203 -203
  88. package/.agent/scripts/browser_audit.js +102 -102
  89. package/.agent/scripts/bundle_analyzer.js +287 -287
  90. package/.agent/scripts/case_law_manager.js +887 -887
  91. package/.agent/scripts/checklist.js +300 -300
  92. package/.agent/scripts/cicd_validator.js +305 -305
  93. package/.agent/scripts/context_broker.js +962 -962
  94. package/.agent/scripts/context_compiler.js +1143 -1112
  95. package/.agent/scripts/contract_engine.js +402 -402
  96. package/.agent/scripts/dependency_analyzer.js +313 -313
  97. package/.agent/scripts/graph_builder.js +384 -384
  98. package/.agent/scripts/graph_visualizer.js +390 -390
  99. package/.agent/scripts/graph_zoom.js +181 -181
  100. package/.agent/scripts/guardrail_engine.js +785 -785
  101. package/.agent/scripts/harness_manager.js +60 -60
  102. package/.agent/scripts/impact_classifier.js +192 -192
  103. package/.agent/scripts/inner_loop_validator.js +472 -472
  104. package/.agent/scripts/integrity_manifest.js +484 -484
  105. package/.agent/scripts/lint_runner.js +218 -218
  106. package/.agent/scripts/marathon_harness.js +986 -986
  107. package/.agent/scripts/mcp_server.js +181 -181
  108. package/.agent/scripts/memory_archivist.js +97 -97
  109. package/.agent/scripts/memory_consolidator.js +37 -37
  110. package/.agent/scripts/memory_engine.js +782 -782
  111. package/.agent/scripts/minify_context.js +111 -111
  112. package/.agent/scripts/minimal_change_engine.js +445 -445
  113. package/.agent/scripts/mutation_runner.js +307 -305
  114. package/.agent/scripts/payload_schemas.js +164 -164
  115. package/.agent/scripts/pipeline_engine.js +906 -906
  116. package/.agent/scripts/prompt_compiler.js +272 -272
  117. package/.agent/scripts/schema_validator.js +326 -326
  118. package/.agent/scripts/security_scan.js +390 -390
  119. package/.agent/scripts/session_logger.js +115 -115
  120. package/.agent/scripts/session_manager.js +299 -299
  121. package/.agent/scripts/signal_detector.js +175 -175
  122. package/.agent/scripts/skill_evolution.js +997 -997
  123. package/.agent/scripts/skill_integrator.js +304 -304
  124. package/.agent/scripts/socratic_gate_policy.js +63 -63
  125. package/.agent/scripts/strengthen_skills.js +199 -199
  126. package/.agent/scripts/swarm_dispatcher.js +983 -979
  127. package/.agent/scripts/syscall_registry.js +105 -105
  128. package/.agent/scripts/test_runner.js +209 -209
  129. package/.agent/scripts/token_budget_broker.js +165 -165
  130. package/.agent/scripts/trace_engine.js +126 -126
  131. package/.agent/scripts/verify_all.js +276 -276
  132. package/.agent/scripts/visual_audit.js +87 -87
  133. package/.agent/skill_topic_map.json +314 -314
  134. package/.agent/skills/12-principles-of-animation/SKILL.md +51 -51
  135. package/.agent/skills/60fps-animation/SKILL.md +91 -91
  136. package/.agent/skills/accessible-animation/SKILL.md +189 -189
  137. package/.agent/skills/adapt/SKILL.md +56 -56
  138. package/.agent/skills/adr-generation/SKILL.md +57 -0
  139. package/.agent/skills/advanced-rag-pipelines/SKILL.md +94 -94
  140. package/.agent/skills/agent-organizer/SKILL.md +117 -117
  141. package/.agent/skills/agent-syscall-guidelines/SKILL.md +25 -25
  142. package/.agent/skills/agentic-patterns/SKILL.md +281 -281
  143. package/.agent/skills/agentic-workflows-2026/SKILL.md +91 -91
  144. package/.agent/skills/agentshield-security/SKILL.md +26 -26
  145. package/.agent/skills/ai-app-hardening/SKILL.md +51 -51
  146. package/.agent/skills/ai-prompt-injection-defense/SKILL.md +162 -162
  147. package/.agent/skills/animation-on-scroll/SKILL.md +196 -196
  148. package/.agent/skills/animation-systems/SKILL.md +198 -198
  149. package/.agent/skills/antfu-conventions/SKILL.md +54 -54
  150. package/.agent/skills/api-patterns/SKILL.md +218 -218
  151. package/.agent/skills/api-security-auditor/SKILL.md +155 -155
  152. package/.agent/skills/app-builder/SKILL.md +535 -535
  153. package/.agent/skills/app-builder/templates/SKILL.md +108 -108
  154. package/.agent/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -76
  155. package/.agent/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -92
  156. package/.agent/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -88
  157. package/.agent/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -88
  158. package/.agent/skills/app-builder/templates/express-api/TEMPLATE.md +83 -83
  159. package/.agent/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -90
  160. package/.agent/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -90
  161. package/.agent/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +126 -126
  162. package/.agent/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +127 -127
  163. package/.agent/skills/app-builder/templates/nextjs-static/TEMPLATE.md +172 -172
  164. package/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md +139 -139
  165. package/.agent/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -83
  166. package/.agent/skills/app-builder/templates/react-native-app/TEMPLATE.md +122 -122
  167. package/.agent/skills/appflow-wireframe/SKILL.md +96 -96
  168. package/.agent/skills/apple-design/SKILL.md +89 -89
  169. package/.agent/skills/architecture/SKILL.md +188 -188
  170. package/.agent/skills/architecture-drift/SKILL.md +45 -0
  171. package/.agent/skills/audit-and-fix/SKILL.md +100 -100
  172. package/.agent/skills/authentication-best-practices/SKILL.md +157 -157
  173. package/.agent/skills/autonomous-execution/SKILL.md +76 -0
  174. package/.agent/skills/backend-security-expert/SKILL.md +73 -73
  175. package/.agent/skills/baseline-ui/SKILL.md +55 -55
  176. package/.agent/skills/bash-linux/SKILL.md +139 -139
  177. package/.agent/skills/behavioral-modes/SKILL.md +200 -200
  178. package/.agent/skills/better-colors/SKILL.md +116 -116
  179. package/.agent/skills/better-typography/SKILL.md +90 -90
  180. package/.agent/skills/better-ui/SKILL.md +130 -130
  181. package/.agent/skills/bolder/SKILL.md +49 -49
  182. package/.agent/skills/brainstorming/SKILL.md +460 -460
  183. package/.agent/skills/browser-audit/SKILL.md +102 -102
  184. package/.agent/skills/browser-native-ai/SKILL.md +72 -72
  185. package/.agent/skills/build-primitive/SKILL.md +50 -50
  186. package/.agent/skills/building-native-ui/SKILL.md +162 -162
  187. package/.agent/skills/cicd-pro/SKILL.md +412 -412
  188. package/.agent/skills/clarify/SKILL.md +55 -55
  189. package/.agent/skills/clean-code/SKILL.md +367 -367
  190. package/.agent/skills/cloud-architect/SKILL.md +409 -409
  191. package/.agent/skills/cobejs/SKILL.md +70 -70
  192. package/.agent/skills/code-review-checklist/SKILL.md +163 -163
  193. package/.agent/skills/codebase-design/SKILL.md +76 -76
  194. package/.agent/skills/colorize/SKILL.md +57 -57
  195. package/.agent/skills/compact-landing/SKILL.md +50 -50
  196. package/.agent/skills/company-logos/SKILL.md +54 -54
  197. package/.agent/skills/config-validator/SKILL.md +125 -125
  198. package/.agent/skills/containerization-pro/SKILL.md +422 -422
  199. package/.agent/skills/context-engineering-pro/SKILL.md +69 -69
  200. package/.agent/skills/create-design-md/SKILL.md +92 -92
  201. package/.agent/skills/critique/SKILL.md +79 -79
  202. package/.agent/skills/csharp-developer/SKILL.md +478 -478
  203. package/.agent/skills/data-validation-schemas/SKILL.md +297 -297
  204. package/.agent/skills/database-design/SKILL.md +219 -219
  205. package/.agent/skills/delight/SKILL.md +46 -46
  206. package/.agent/skills/deployment-procedures/SKILL.md +132 -132
  207. package/.agent/skills/design-lab/SKILL.md +42 -42
  208. package/.agent/skills/devops-engineer/SKILL.md +305 -305
  209. package/.agent/skills/devops-incident-responder/SKILL.md +103 -103
  210. package/.agent/skills/diagnosing-bugs/SKILL.md +172 -172
  211. package/.agent/skills/distill/SKILL.md +45 -45
  212. package/.agent/skills/documentation-templates/SKILL.md +251 -251
  213. package/.agent/skills/domain-modeling/SKILL.md +61 -61
  214. package/.agent/skills/duckdb-analytical-sql/SKILL.md +51 -51
  215. package/.agent/skills/edge-ai-mobile/SKILL.md +42 -42
  216. package/.agent/skills/edge-computing/SKILL.md +143 -143
  217. package/.agent/skills/emil-design-eng/SKILL.md +134 -134
  218. package/.agent/skills/error-resilience/SKILL.md +403 -403
  219. package/.agent/skills/expo-router-v4/SKILL.md +72 -72
  220. package/.agent/skills/extract-design-system/SKILL.md +120 -120
  221. package/.agent/skills/fabel-protocol/SKILL.md +282 -282
  222. package/.agent/skills/failure-mode-analysis/SKILL.md +48 -0
  223. package/.agent/skills/fixing-accessibility/SKILL.md +87 -87
  224. package/.agent/skills/fixing-metadata/SKILL.md +83 -83
  225. package/.agent/skills/fixing-motion-performance/SKILL.md +78 -78
  226. package/.agent/skills/framer-motion-expert/SKILL.md +237 -237
  227. package/.agent/skills/frontend-design/SKILL.md +103 -103
  228. package/.agent/skills/frontend-security-expert/SKILL.md +56 -56
  229. package/.agent/skills/game-design-expert/SKILL.md +92 -92
  230. package/.agent/skills/game-engineering-expert/SKILL.md +108 -108
  231. package/.agent/skills/generative-ui-expert/SKILL.md +100 -100
  232. package/.agent/skills/geo-fundamentals/SKILL.md +108 -108
  233. package/.agent/skills/git-pro/SKILL.md +401 -401
  234. package/.agent/skills/github-operations/SKILL.md +295 -295
  235. package/.agent/skills/gpt-taste/SKILL.md +50 -50
  236. package/.agent/skills/graph-engineering/SKILL.md +28 -28
  237. package/.agent/skills/gsap-core/SKILL.md +277 -277
  238. package/.agent/skills/gsap-frameworks/SKILL.md +168 -168
  239. package/.agent/skills/gsap-performance/SKILL.md +94 -94
  240. package/.agent/skills/gsap-plugins/SKILL.md +441 -441
  241. package/.agent/skills/gsap-react/SKILL.md +213 -213
  242. package/.agent/skills/gsap-scrolltrigger/SKILL.md +312 -312
  243. package/.agent/skills/gsap-timeline/SKILL.md +122 -122
  244. package/.agent/skills/gsap-utils/SKILL.md +299 -299
  245. package/.agent/skills/harden/SKILL.md +55 -55
  246. package/.agent/skills/harness-protocol/SKILL.md +48 -48
  247. package/.agent/skills/huggingface-spaces/SKILL.md +1 -1
  248. package/.agent/skills/human-gate-negotiation/SKILL.md +30 -30
  249. package/.agent/skills/i18n-localization/SKILL.md +134 -134
  250. package/.agent/skills/impeccable/SKILL.md +52 -52
  251. package/.agent/skills/improve-codebase-architecture/SKILL.md +48 -48
  252. package/.agent/skills/improve-ui/SKILL.md +70 -70
  253. package/.agent/skills/intelligent-routing/SKILL.md +204 -204
  254. package/.agent/skills/knowledge-graph/SKILL.md +71 -71
  255. package/.agent/skills/landing-page/SKILL.md +65 -65
  256. package/.agent/skills/lint-and-validate/SKILL.md +224 -224
  257. package/.agent/skills/llm-engineering/SKILL.md +360 -360
  258. package/.agent/skills/local-first/SKILL.md +138 -138
  259. package/.agent/skills/local-first-architecture/SKILL.md +62 -62
  260. package/.agent/skills/lottie-animation/SKILL.md +62 -62
  261. package/.agent/skills/marquee-loop/SKILL.md +72 -72
  262. package/.agent/skills/masked-reveal/SKILL.md +230 -230
  263. package/.agent/skills/mcp-builder/SKILL.md +105 -105
  264. package/.agent/skills/micro-interaction/SKILL.md +253 -253
  265. package/.agent/skills/mobile-design/SKILL.md +245 -245
  266. package/.agent/skills/monorepo-management/SKILL.md +295 -295
  267. package/.agent/skills/morphing-icons/SKILL.md +348 -348
  268. package/.agent/skills/motion-engineering/SKILL.md +197 -197
  269. package/.agent/skills/nextjs-react-expert/SKILL.md +218 -218
  270. package/.agent/skills/nodejs-best-practices/SKILL.md +542 -542
  271. package/.agent/skills/observability/SKILL.md +303 -303
  272. package/.agent/skills/opentelemetry-observability/SKILL.md +51 -51
  273. package/.agent/skills/page-transition-animation/SKILL.md +86 -86
  274. package/.agent/skills/parallel-agents/SKILL.md +110 -110
  275. package/.agent/skills/performance-profiling/SKILL.md +230 -230
  276. package/.agent/skills/plan-writing/SKILL.md +127 -127
  277. package/.agent/skills/platform-engineer/SKILL.md +108 -108
  278. package/.agent/skills/platform-engineering-opentofu/SKILL.md +59 -59
  279. package/.agent/skills/playwright-ai-e2e/SKILL.md +52 -52
  280. package/.agent/skills/playwright-best-practices/SKILL.md +149 -149
  281. package/.agent/skills/polish/SKILL.md +39 -39
  282. package/.agent/skills/powershell-windows/SKILL.md +122 -122
  283. package/.agent/skills/pricing-page/SKILL.md +48 -48
  284. package/.agent/skills/product-aware-heuristics/SKILL.md +390 -390
  285. package/.agent/skills/progressive-blur/SKILL.md +80 -80
  286. package/.agent/skills/project-idioms/SKILL.md +91 -91
  287. package/.agent/skills/property-based-testing/SKILL.md +50 -50
  288. package/.agent/skills/python-patterns/SKILL.md +220 -220
  289. package/.agent/skills/python-pro/SKILL.md +305 -305
  290. package/.agent/skills/quieter/SKILL.md +49 -49
  291. package/.agent/skills/react-doctor/SKILL.md +51 -51
  292. package/.agent/skills/react-specialist/SKILL.md +280 -280
  293. package/.agent/skills/readme-builder/SKILL.md +270 -270
  294. package/.agent/skills/realtime-patterns/SKILL.md +283 -283
  295. package/.agent/skills/red-team-tactics/SKILL.md +191 -191
  296. package/.agent/skills/redesign-skill/SKILL.md +46 -46
  297. package/.agent/skills/review-animations/SKILL.md +45 -45
  298. package/.agent/skills/review-animations/STANDARDS.md +87 -87
  299. package/.agent/skills/rust-pro/SKILL.md +652 -652
  300. package/.agent/skills/semantic-filesystem-navigation/SKILL.md +24 -24
  301. package/.agent/skills/seo-fundamentals/SKILL.md +139 -139
  302. package/.agent/skills/server-management/SKILL.md +178 -178
  303. package/.agent/skills/session-log-interrogation/SKILL.md +29 -29
  304. package/.agent/skills/shadcn-ui-expert/SKILL.md +196 -196
  305. package/.agent/skills/shape/SKILL.md +56 -56
  306. package/.agent/skills/skill-creator/SKILL.md +177 -177
  307. package/.agent/skills/soft-skill/SKILL.md +53 -53
  308. package/.agent/skills/sounds-on-the-web/SKILL.md +76 -76
  309. package/.agent/skills/sql-pro/SKILL.md +624 -624
  310. package/.agent/skills/subagent-driven-development/SKILL.md +32 -32
  311. package/.agent/skills/supabase-postgres-best-practices/SKILL.md +57 -57
  312. package/.agent/skills/svg-animation/SKILL.md +356 -356
  313. package/.agent/skills/swiftui-expert/SKILL.md +164 -164
  314. package/.agent/skills/swiss-design/SKILL.md +44 -44
  315. package/.agent/skills/system-design-pro/SKILL.md +188 -318
  316. package/.agent/skills/systematic-debugging/SKILL.md +129 -129
  317. package/.agent/skills/systematic-debugging/condition-based-waiting.md +120 -120
  318. package/.agent/skills/systematic-debugging/defense-in-depth.md +128 -128
  319. package/.agent/skills/systematic-debugging/root-cause-tracing.md +183 -183
  320. package/.agent/skills/tailwind-patterns/SKILL.md +583 -583
  321. package/.agent/skills/taste-skill/SKILL.md +52 -52
  322. package/.agent/skills/tdd-workflow/SKILL.md +105 -105
  323. package/.agent/skills/test-result-analyzer/SKILL.md +270 -270
  324. package/.agent/skills/testing-patterns/SKILL.md +534 -534
  325. package/.agent/skills/thermo-nuclear-code-quality-review/SKILL.md +62 -62
  326. package/.agent/skills/thinking-protocol/SKILL.md +21 -21
  327. package/.agent/skills/to-spring-or-not-to-spring/SKILL.md +43 -43
  328. package/.agent/skills/transformers-js/references/CONFIGURATION.md +1 -1
  329. package/.agent/skills/transitions-dev/SKILL.md +90 -90
  330. package/.agent/skills/trend-researcher/SKILL.md +198 -198
  331. package/.agent/skills/tribunal-instincts-memory/SKILL.md +31 -31
  332. package/.agent/skills/typescript-advanced/SKILL.md +306 -306
  333. package/.agent/skills/typeset/SKILL.md +60 -60
  334. package/.agent/skills/ui-reasoning-engine/SKILL.md +155 -155
  335. package/.agent/skills/ui-skill-packs/SKILL.md +57 -57
  336. package/.agent/skills/ui-skills-root/SKILL.md +69 -69
  337. package/.agent/skills/ui-ux-pro-max/SKILL.md +110 -110
  338. package/.agent/skills/ui-ux-researcher/SKILL.md +199 -199
  339. package/.agent/skills/vector-search-pgvector/SKILL.md +70 -70
  340. package/.agent/skills/verification-before-completion/SKILL.md +107 -107
  341. package/.agent/skills/vue-expert/SKILL.md +259 -259
  342. package/.agent/skills/vulnerability-scanner/SKILL.md +378 -378
  343. package/.agent/skills/web-accessibility-auditor/SKILL.md +179 -179
  344. package/.agent/skills/web-design-guidelines/SKILL.md +49 -49
  345. package/.agent/skills/web-quality-audit/SKILL.md +47 -47
  346. package/.agent/skills/webapp-testing/SKILL.md +128 -128
  347. package/.agent/skills/webgpu-performance/SKILL.md +88 -88
  348. package/.agent/skills/whimsy-injector/SKILL.md +305 -305
  349. package/.agent/skills/workflow-optimizer/SKILL.md +188 -188
  350. package/.agent/skills/zero-trust-passkeys/SKILL.md +82 -82
  351. package/.agent/templates/DESIGN.md +843 -843
  352. package/.agent/templates/design-tokens.json +140 -140
  353. package/.agent/templates/sdd/implementer-prompt.md +62 -62
  354. package/.agent/templates/sdd/re-review-prompt.md +36 -36
  355. package/.agent/templates/sdd/task-reviewer-prompt.md +78 -78
  356. package/.agent/workflows/acf.md +153 -153
  357. package/.agent/workflows/api-tester.md +189 -189
  358. package/.agent/workflows/assimilate.md +21 -21
  359. package/.agent/workflows/audit-live.md +53 -53
  360. package/.agent/workflows/audit.md +172 -172
  361. package/.agent/workflows/brainstorm.md +157 -157
  362. package/.agent/workflows/changelog.md +152 -152
  363. package/.agent/workflows/compare-web.md +35 -35
  364. package/.agent/workflows/context.md +102 -102
  365. package/.agent/workflows/contract.md +79 -79
  366. package/.agent/workflows/create.md +182 -182
  367. package/.agent/workflows/debug.md +201 -201
  368. package/.agent/workflows/deploy.md +215 -215
  369. package/.agent/workflows/enhance.md +165 -165
  370. package/.agent/workflows/fix-ci.md +94 -94
  371. package/.agent/workflows/fix.md +149 -149
  372. package/.agent/workflows/generate.md +216 -216
  373. package/.agent/workflows/htop.md +22 -22
  374. package/.agent/workflows/marathon.md +291 -291
  375. package/.agent/workflows/migrate.md +198 -198
  376. package/.agent/workflows/minimal.md +101 -101
  377. package/.agent/workflows/orchestrate.md +205 -205
  378. package/.agent/workflows/performance-benchmarker.md +148 -148
  379. package/.agent/workflows/pipeline.md +165 -165
  380. package/.agent/workflows/plan.md +206 -206
  381. package/.agent/workflows/preview.md +116 -116
  382. package/.agent/workflows/refactor.md +207 -207
  383. package/.agent/workflows/resume.md +20 -20
  384. package/.agent/workflows/review-ai.md +139 -139
  385. package/.agent/workflows/review.md +155 -155
  386. package/.agent/workflows/sdd.md +137 -137
  387. package/.agent/workflows/session.md +135 -135
  388. package/.agent/workflows/skill-enhancement-engine.md +84 -84
  389. package/.agent/workflows/status.md +112 -112
  390. package/.agent/workflows/strengthen-skills.md +174 -174
  391. package/.agent/workflows/super-prompt.md +146 -146
  392. package/.agent/workflows/swarm.md +218 -218
  393. package/.agent/workflows/team-mode.md +22 -22
  394. package/.agent/workflows/test.md +224 -224
  395. package/.agent/workflows/tribunal-backend.md +149 -149
  396. package/.agent/workflows/tribunal-cicd.md +109 -109
  397. package/.agent/workflows/tribunal-database.md +142 -142
  398. package/.agent/workflows/tribunal-frontend.md +157 -157
  399. package/.agent/workflows/tribunal-full.md +156 -156
  400. package/.agent/workflows/tribunal-mobile.md +142 -142
  401. package/.agent/workflows/tribunal-performance.md +149 -149
  402. package/.agent/workflows/tribunal-speed.md +222 -222
  403. package/.agent/workflows/tribunal-ui.md +97 -97
  404. package/.agent/workflows/ui-ux-pro-max.md +103 -103
  405. package/.agents/skills/12-principles-of-animation/SKILL.md +51 -51
  406. package/.agents/skills/60fps-animation/SKILL.md +91 -91
  407. package/.agents/skills/accessible-animation/SKILL.md +189 -189
  408. package/.agents/skills/adapt/SKILL.md +56 -56
  409. package/.agents/skills/adr-generation/SKILL.md +57 -0
  410. package/.agents/skills/advanced-rag-pipelines/SKILL.md +94 -94
  411. package/.agents/skills/agent-organizer/SKILL.md +117 -117
  412. package/.agents/skills/agent-syscall-guidelines/SKILL.md +25 -25
  413. package/.agents/skills/agentic-patterns/SKILL.md +281 -281
  414. package/.agents/skills/agentic-workflows-2026/SKILL.md +91 -91
  415. package/.agents/skills/agentshield-security/SKILL.md +26 -26
  416. package/.agents/skills/ai-app-hardening/SKILL.md +51 -51
  417. package/.agents/skills/ai-prompt-injection-defense/SKILL.md +162 -162
  418. package/.agents/skills/animation-on-scroll/SKILL.md +196 -196
  419. package/.agents/skills/animation-systems/SKILL.md +198 -198
  420. package/.agents/skills/antfu-conventions/SKILL.md +54 -54
  421. package/.agents/skills/api-patterns/SKILL.md +218 -218
  422. package/.agents/skills/api-security-auditor/SKILL.md +155 -155
  423. package/.agents/skills/app-builder/SKILL.md +535 -535
  424. package/.agents/skills/app-builder/templates/SKILL.md +108 -108
  425. package/.agents/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -76
  426. package/.agents/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -92
  427. package/.agents/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -88
  428. package/.agents/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -88
  429. package/.agents/skills/app-builder/templates/express-api/TEMPLATE.md +83 -83
  430. package/.agents/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -90
  431. package/.agents/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -90
  432. package/.agents/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +126 -126
  433. package/.agents/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +127 -127
  434. package/.agents/skills/app-builder/templates/nextjs-static/TEMPLATE.md +172 -172
  435. package/.agents/skills/app-builder/templates/nuxt-app/TEMPLATE.md +139 -139
  436. package/.agents/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -83
  437. package/.agents/skills/app-builder/templates/react-native-app/TEMPLATE.md +122 -122
  438. package/.agents/skills/appflow-wireframe/SKILL.md +96 -96
  439. package/.agents/skills/apple-design/SKILL.md +89 -89
  440. package/.agents/skills/architecture/SKILL.md +188 -188
  441. package/.agents/skills/architecture-drift/SKILL.md +45 -0
  442. package/.agents/skills/audit-and-fix/SKILL.md +100 -100
  443. package/.agents/skills/authentication-best-practices/SKILL.md +157 -157
  444. package/.agents/skills/autonomous-execution/SKILL.md +76 -0
  445. package/.agents/skills/backend-security-expert/SKILL.md +73 -73
  446. package/.agents/skills/baseline-ui/SKILL.md +55 -55
  447. package/.agents/skills/bash-linux/SKILL.md +139 -139
  448. package/.agents/skills/behavioral-modes/SKILL.md +200 -200
  449. package/.agents/skills/better-colors/SKILL.md +116 -116
  450. package/.agents/skills/better-typography/SKILL.md +90 -90
  451. package/.agents/skills/better-ui/SKILL.md +130 -130
  452. package/.agents/skills/bolder/SKILL.md +49 -49
  453. package/.agents/skills/brainstorming/SKILL.md +460 -460
  454. package/.agents/skills/browser-audit/SKILL.md +102 -102
  455. package/.agents/skills/browser-native-ai/SKILL.md +72 -72
  456. package/.agents/skills/build-primitive/SKILL.md +50 -50
  457. package/.agents/skills/building-native-ui/SKILL.md +162 -162
  458. package/.agents/skills/cicd-pro/SKILL.md +412 -412
  459. package/.agents/skills/clarify/SKILL.md +55 -55
  460. package/.agents/skills/clean-code/SKILL.md +367 -367
  461. package/.agents/skills/cloud-architect/SKILL.md +409 -409
  462. package/.agents/skills/cobejs/SKILL.md +70 -70
  463. package/.agents/skills/code-review-checklist/SKILL.md +163 -163
  464. package/.agents/skills/codebase-design/SKILL.md +76 -76
  465. package/.agents/skills/colorize/SKILL.md +57 -57
  466. package/.agents/skills/compact-landing/SKILL.md +50 -50
  467. package/.agents/skills/company-logos/SKILL.md +54 -54
  468. package/.agents/skills/config-validator/SKILL.md +125 -125
  469. package/.agents/skills/containerization-pro/SKILL.md +422 -422
  470. package/.agents/skills/context-engineering-pro/SKILL.md +69 -69
  471. package/.agents/skills/create-design-md/SKILL.md +92 -92
  472. package/.agents/skills/critique/SKILL.md +79 -79
  473. package/.agents/skills/csharp-developer/SKILL.md +478 -478
  474. package/.agents/skills/data-validation-schemas/SKILL.md +297 -297
  475. package/.agents/skills/database-design/SKILL.md +219 -219
  476. package/.agents/skills/delight/SKILL.md +46 -46
  477. package/.agents/skills/deployment-procedures/SKILL.md +132 -132
  478. package/.agents/skills/design-lab/SKILL.md +42 -42
  479. package/.agents/skills/devops-engineer/SKILL.md +305 -305
  480. package/.agents/skills/devops-incident-responder/SKILL.md +103 -103
  481. package/.agents/skills/diagnosing-bugs/SKILL.md +172 -172
  482. package/.agents/skills/distill/SKILL.md +45 -45
  483. package/.agents/skills/documentation-templates/SKILL.md +251 -251
  484. package/.agents/skills/domain-modeling/SKILL.md +61 -61
  485. package/.agents/skills/duckdb-analytical-sql/SKILL.md +51 -51
  486. package/.agents/skills/edge-ai-mobile/SKILL.md +42 -42
  487. package/.agents/skills/edge-computing/SKILL.md +143 -143
  488. package/.agents/skills/emil-design-eng/SKILL.md +134 -134
  489. package/.agents/skills/error-resilience/SKILL.md +403 -403
  490. package/.agents/skills/expo-router-v4/SKILL.md +72 -72
  491. package/.agents/skills/extract-design-system/SKILL.md +120 -120
  492. package/.agents/skills/fabel-protocol/SKILL.md +282 -282
  493. package/.agents/skills/failure-mode-analysis/SKILL.md +48 -0
  494. package/.agents/skills/fixing-accessibility/SKILL.md +87 -87
  495. package/.agents/skills/fixing-metadata/SKILL.md +83 -83
  496. package/.agents/skills/fixing-motion-performance/SKILL.md +78 -78
  497. package/.agents/skills/framer-motion-expert/SKILL.md +237 -237
  498. package/.agents/skills/frontend-design/SKILL.md +103 -103
  499. package/.agents/skills/frontend-security-expert/SKILL.md +56 -56
  500. package/.agents/skills/game-design-expert/SKILL.md +92 -92
  501. package/.agents/skills/game-engineering-expert/SKILL.md +108 -108
  502. package/.agents/skills/generative-ui-expert/SKILL.md +100 -100
  503. package/.agents/skills/geo-fundamentals/SKILL.md +108 -108
  504. package/.agents/skills/git-pro/SKILL.md +401 -401
  505. package/.agents/skills/github-operations/SKILL.md +295 -295
  506. package/.agents/skills/gpt-taste/SKILL.md +50 -50
  507. package/.agents/skills/graph-engineering/SKILL.md +28 -28
  508. package/.agents/skills/gsap-core/SKILL.md +277 -277
  509. package/.agents/skills/gsap-frameworks/SKILL.md +168 -168
  510. package/.agents/skills/gsap-performance/SKILL.md +94 -94
  511. package/.agents/skills/gsap-plugins/SKILL.md +441 -441
  512. package/.agents/skills/gsap-react/SKILL.md +213 -213
  513. package/.agents/skills/gsap-scrolltrigger/SKILL.md +312 -312
  514. package/.agents/skills/gsap-timeline/SKILL.md +122 -122
  515. package/.agents/skills/gsap-utils/SKILL.md +299 -299
  516. package/.agents/skills/harden/SKILL.md +55 -55
  517. package/.agents/skills/harness-protocol/SKILL.md +48 -48
  518. package/.agents/skills/huggingface-spaces/SKILL.md +1 -1
  519. package/.agents/skills/human-gate-negotiation/SKILL.md +30 -30
  520. package/.agents/skills/i18n-localization/SKILL.md +134 -134
  521. package/.agents/skills/impeccable/SKILL.md +52 -52
  522. package/.agents/skills/improve-codebase-architecture/SKILL.md +48 -48
  523. package/.agents/skills/improve-ui/SKILL.md +70 -70
  524. package/.agents/skills/intelligent-routing/SKILL.md +204 -204
  525. package/.agents/skills/knowledge-graph/SKILL.md +71 -71
  526. package/.agents/skills/landing-page/SKILL.md +65 -65
  527. package/.agents/skills/lint-and-validate/SKILL.md +224 -224
  528. package/.agents/skills/llm-engineering/SKILL.md +360 -360
  529. package/.agents/skills/local-first/SKILL.md +138 -138
  530. package/.agents/skills/local-first-architecture/SKILL.md +62 -62
  531. package/.agents/skills/lottie-animation/SKILL.md +62 -62
  532. package/.agents/skills/marquee-loop/SKILL.md +72 -72
  533. package/.agents/skills/masked-reveal/SKILL.md +230 -230
  534. package/.agents/skills/mcp-builder/SKILL.md +105 -105
  535. package/.agents/skills/micro-interaction/SKILL.md +253 -253
  536. package/.agents/skills/mobile-design/SKILL.md +245 -245
  537. package/.agents/skills/monorepo-management/SKILL.md +295 -295
  538. package/.agents/skills/morphing-icons/SKILL.md +348 -348
  539. package/.agents/skills/motion-engineering/SKILL.md +197 -197
  540. package/.agents/skills/nextjs-react-expert/SKILL.md +218 -218
  541. package/.agents/skills/nodejs-best-practices/SKILL.md +542 -542
  542. package/.agents/skills/observability/SKILL.md +303 -303
  543. package/.agents/skills/opentelemetry-observability/SKILL.md +51 -51
  544. package/.agents/skills/page-transition-animation/SKILL.md +86 -86
  545. package/.agents/skills/parallel-agents/SKILL.md +110 -110
  546. package/.agents/skills/performance-profiling/SKILL.md +230 -230
  547. package/.agents/skills/plan-writing/SKILL.md +127 -127
  548. package/.agents/skills/platform-engineer/SKILL.md +108 -108
  549. package/.agents/skills/platform-engineering-opentofu/SKILL.md +59 -59
  550. package/.agents/skills/playwright-ai-e2e/SKILL.md +52 -52
  551. package/.agents/skills/playwright-best-practices/SKILL.md +149 -149
  552. package/.agents/skills/polish/SKILL.md +39 -39
  553. package/.agents/skills/powershell-windows/SKILL.md +122 -122
  554. package/.agents/skills/pricing-page/SKILL.md +48 -48
  555. package/.agents/skills/product-aware-heuristics/SKILL.md +390 -390
  556. package/.agents/skills/progressive-blur/SKILL.md +80 -80
  557. package/.agents/skills/project-idioms/SKILL.md +91 -91
  558. package/.agents/skills/property-based-testing/SKILL.md +50 -50
  559. package/.agents/skills/python-patterns/SKILL.md +220 -220
  560. package/.agents/skills/python-pro/SKILL.md +305 -305
  561. package/.agents/skills/quieter/SKILL.md +49 -49
  562. package/.agents/skills/react-doctor/SKILL.md +51 -51
  563. package/.agents/skills/react-specialist/SKILL.md +280 -280
  564. package/.agents/skills/readme-builder/SKILL.md +270 -270
  565. package/.agents/skills/realtime-patterns/SKILL.md +283 -283
  566. package/.agents/skills/red-team-tactics/SKILL.md +191 -191
  567. package/.agents/skills/redesign-skill/SKILL.md +46 -46
  568. package/.agents/skills/review-animations/SKILL.md +45 -45
  569. package/.agents/skills/review-animations/STANDARDS.md +87 -87
  570. package/.agents/skills/rust-pro/SKILL.md +652 -652
  571. package/.agents/skills/semantic-filesystem-navigation/SKILL.md +24 -24
  572. package/.agents/skills/seo-fundamentals/SKILL.md +139 -139
  573. package/.agents/skills/server-management/SKILL.md +178 -178
  574. package/.agents/skills/session-log-interrogation/SKILL.md +29 -29
  575. package/.agents/skills/shadcn-ui-expert/SKILL.md +196 -196
  576. package/.agents/skills/shape/SKILL.md +56 -56
  577. package/.agents/skills/skill-creator/SKILL.md +177 -177
  578. package/.agents/skills/soft-skill/SKILL.md +53 -53
  579. package/.agents/skills/sounds-on-the-web/SKILL.md +76 -76
  580. package/.agents/skills/sql-pro/SKILL.md +624 -624
  581. package/.agents/skills/subagent-driven-development/SKILL.md +32 -32
  582. package/.agents/skills/supabase-postgres-best-practices/SKILL.md +57 -57
  583. package/.agents/skills/svg-animation/SKILL.md +356 -356
  584. package/.agents/skills/swiftui-expert/SKILL.md +164 -164
  585. package/.agents/skills/swiss-design/SKILL.md +44 -44
  586. package/.agents/skills/system-design-pro/SKILL.md +188 -318
  587. package/.agents/skills/systematic-debugging/SKILL.md +129 -129
  588. package/.agents/skills/systematic-debugging/condition-based-waiting.md +120 -120
  589. package/.agents/skills/systematic-debugging/defense-in-depth.md +128 -128
  590. package/.agents/skills/systematic-debugging/root-cause-tracing.md +183 -183
  591. package/.agents/skills/tailwind-patterns/SKILL.md +583 -583
  592. package/.agents/skills/taste-skill/SKILL.md +52 -52
  593. package/.agents/skills/tdd-workflow/SKILL.md +105 -105
  594. package/.agents/skills/test-result-analyzer/SKILL.md +270 -270
  595. package/.agents/skills/testing-patterns/SKILL.md +534 -534
  596. package/.agents/skills/thermo-nuclear-code-quality-review/SKILL.md +62 -62
  597. package/.agents/skills/thinking-protocol/SKILL.md +21 -21
  598. package/.agents/skills/to-spring-or-not-to-spring/SKILL.md +43 -43
  599. package/.agents/skills/transformers-js/references/CONFIGURATION.md +1 -1
  600. package/.agents/skills/transitions-dev/SKILL.md +90 -90
  601. package/.agents/skills/trend-researcher/SKILL.md +198 -198
  602. package/.agents/skills/tribunal-instincts-memory/SKILL.md +31 -31
  603. package/.agents/skills/typescript-advanced/SKILL.md +306 -306
  604. package/.agents/skills/typeset/SKILL.md +60 -60
  605. package/.agents/skills/ui-reasoning-engine/SKILL.md +155 -155
  606. package/.agents/skills/ui-skill-packs/SKILL.md +57 -57
  607. package/.agents/skills/ui-skills-root/SKILL.md +69 -69
  608. package/.agents/skills/ui-ux-pro-max/SKILL.md +110 -110
  609. package/.agents/skills/ui-ux-researcher/SKILL.md +199 -199
  610. package/.agents/skills/vector-search-pgvector/SKILL.md +70 -70
  611. package/.agents/skills/verification-before-completion/SKILL.md +107 -107
  612. package/.agents/skills/vue-expert/SKILL.md +259 -259
  613. package/.agents/skills/vulnerability-scanner/SKILL.md +378 -378
  614. package/.agents/skills/web-accessibility-auditor/SKILL.md +179 -179
  615. package/.agents/skills/web-design-guidelines/SKILL.md +49 -49
  616. package/.agents/skills/web-quality-audit/SKILL.md +47 -47
  617. package/.agents/skills/webapp-testing/SKILL.md +128 -128
  618. package/.agents/skills/webgpu-performance/SKILL.md +88 -88
  619. package/.agents/skills/whimsy-injector/SKILL.md +305 -305
  620. package/.agents/skills/workflow-optimizer/SKILL.md +188 -188
  621. package/.agents/skills/zero-trust-passkeys/SKILL.md +82 -82
  622. package/AGENTS.md +93 -93
  623. package/CLAUDE.md +444 -444
  624. package/CONTRIBUTING.md +134 -134
  625. package/README.md +242 -242
  626. package/SECURITY.md +58 -52
  627. package/bin/adapter-install.js +264 -264
  628. package/bin/global-store.js +48 -48
  629. package/bin/mcp-server.js +1653 -1653
  630. package/bin/proxy-server.js +122 -122
  631. package/bin/spawn-agent.js +45 -45
  632. package/bin/tk-proxy.js +34 -34
  633. package/bin/tribunal-kit.js +113 -113
  634. package/bin/wrapper.js +209 -211
  635. package/hooks/hooks-cursor.json +10 -10
  636. package/hooks/hooks.json +10 -10
  637. package/hooks/session-start.js +77 -77
  638. package/mcp_config.json +18 -18
  639. package/package.json +169 -179
  640. package/{.claude-plugin → plugins/claude}/marketplace.json +14 -14
  641. package/{.claude-plugin → plugins/claude}/plugin.json +26 -26
  642. package/{.codex-plugin → plugins/codex}/plugin.json +41 -41
  643. package/{plugin.json → plugins/core-plugin.json} +26 -26
  644. package/{.cursor-plugin → plugins/cursor}/plugin.json +26 -26
  645. package/{.devin-plugin → plugins/devin}/plugin.json +14 -14
  646. package/{gemini-extension.json → plugins/gemini/extension.json} +6 -6
  647. package/{.hermes-plugin → plugins/hermes}/__init__.py +102 -102
  648. package/{.hermes-plugin → plugins/hermes}/plugin.yaml +6 -6
  649. package/{.kimi-plugin → plugins/kimi}/plugin.json +34 -34
  650. package/{marketplace.json → plugins/marketplace.json} +14 -14
  651. package/{.opencode → plugins/opencode}/INSTALL.md +42 -42
  652. package/{.opencode → plugins/opencode}/plugins/tribunal.js +110 -110
  653. package/{.opencode → plugins/opencode}/rules.md +258 -258
  654. package/{.pi → plugins/pi}/extensions/tribunal.ts +130 -130
  655. package/scripts/apply-version.js +57 -57
  656. package/scripts/audit_skill_sdo.js +89 -89
  657. package/scripts/benchmark.js +231 -231
  658. package/scripts/build-graph.js +71 -71
  659. package/scripts/changelog.js +190 -190
  660. package/scripts/clean-pycache.js +42 -42
  661. package/scripts/context_compiler.js +1143 -1117
  662. package/scripts/fix-vbc.js +96 -96
  663. package/scripts/fix-vbc.ps1 +3 -3
  664. package/scripts/modernize_skills.js +268 -268
  665. package/scripts/package-cores.js +116 -116
  666. package/scripts/skill_enhancement_engine.js +608 -608
  667. package/scripts/stress_benchmark.js +358 -358
  668. package/scripts/sync-skills.js +61 -61
  669. package/scripts/sync-version.js +177 -177
  670. package/scripts/telemetry_gc.js +156 -156
  671. package/scripts/validate-payload.js +73 -73
  672. package/scripts/visual_audit.js +136 -136
  673. package/skills/12-principles-of-animation/SKILL.md +51 -51
  674. package/skills/60fps-animation/SKILL.md +91 -91
  675. package/skills/accessible-animation/SKILL.md +189 -189
  676. package/skills/adapt/SKILL.md +56 -56
  677. package/skills/adr-generation/SKILL.md +57 -0
  678. package/skills/advanced-rag-pipelines/SKILL.md +94 -94
  679. package/skills/agent-organizer/SKILL.md +117 -117
  680. package/skills/agent-syscall-guidelines/SKILL.md +25 -25
  681. package/skills/agentic-patterns/SKILL.md +281 -281
  682. package/skills/agentic-workflows-2026/SKILL.md +91 -91
  683. package/skills/agentshield-security/SKILL.md +26 -26
  684. package/skills/ai-app-hardening/SKILL.md +51 -51
  685. package/skills/ai-prompt-injection-defense/SKILL.md +162 -162
  686. package/skills/animation-on-scroll/SKILL.md +196 -196
  687. package/skills/animation-systems/SKILL.md +198 -198
  688. package/skills/antfu-conventions/SKILL.md +54 -54
  689. package/skills/api-patterns/SKILL.md +218 -218
  690. package/skills/api-security-auditor/SKILL.md +155 -155
  691. package/skills/app-builder/SKILL.md +535 -535
  692. package/skills/app-builder/templates/SKILL.md +108 -108
  693. package/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -76
  694. package/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -92
  695. package/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -88
  696. package/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -88
  697. package/skills/app-builder/templates/express-api/TEMPLATE.md +83 -83
  698. package/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -90
  699. package/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -90
  700. package/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +126 -126
  701. package/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +127 -127
  702. package/skills/app-builder/templates/nextjs-static/TEMPLATE.md +172 -172
  703. package/skills/app-builder/templates/nuxt-app/TEMPLATE.md +139 -139
  704. package/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -83
  705. package/skills/app-builder/templates/react-native-app/TEMPLATE.md +122 -122
  706. package/skills/appflow-wireframe/SKILL.md +96 -96
  707. package/skills/apple-design/SKILL.md +89 -89
  708. package/skills/architecture/SKILL.md +188 -188
  709. package/skills/architecture-drift/SKILL.md +45 -0
  710. package/skills/audit-and-fix/SKILL.md +100 -100
  711. package/skills/authentication-best-practices/SKILL.md +157 -157
  712. package/skills/autonomous-execution/SKILL.md +76 -0
  713. package/skills/backend-security-expert/SKILL.md +73 -73
  714. package/skills/baseline-ui/SKILL.md +55 -55
  715. package/skills/bash-linux/SKILL.md +139 -139
  716. package/skills/behavioral-modes/SKILL.md +200 -200
  717. package/skills/better-colors/SKILL.md +116 -116
  718. package/skills/better-typography/SKILL.md +90 -90
  719. package/skills/better-ui/SKILL.md +130 -130
  720. package/skills/bolder/SKILL.md +49 -49
  721. package/skills/brainstorming/SKILL.md +460 -460
  722. package/skills/browser-audit/SKILL.md +102 -102
  723. package/skills/browser-native-ai/SKILL.md +72 -72
  724. package/skills/build-primitive/SKILL.md +50 -50
  725. package/skills/building-native-ui/SKILL.md +162 -162
  726. package/skills/cicd-pro/SKILL.md +412 -412
  727. package/skills/clarify/SKILL.md +55 -55
  728. package/skills/clean-code/SKILL.md +367 -367
  729. package/skills/cloud-architect/SKILL.md +409 -409
  730. package/skills/cobejs/SKILL.md +70 -70
  731. package/skills/code-review-checklist/SKILL.md +163 -163
  732. package/skills/codebase-design/SKILL.md +76 -76
  733. package/skills/colorize/SKILL.md +57 -57
  734. package/skills/compact-landing/SKILL.md +50 -50
  735. package/skills/company-logos/SKILL.md +54 -54
  736. package/skills/config-validator/SKILL.md +125 -125
  737. package/skills/containerization-pro/SKILL.md +422 -422
  738. package/skills/context-engineering-pro/SKILL.md +69 -69
  739. package/skills/create-design-md/SKILL.md +92 -92
  740. package/skills/critique/SKILL.md +79 -79
  741. package/skills/csharp-developer/SKILL.md +478 -478
  742. package/skills/data-validation-schemas/SKILL.md +297 -297
  743. package/skills/database-design/SKILL.md +219 -219
  744. package/skills/delight/SKILL.md +46 -46
  745. package/skills/deployment-procedures/SKILL.md +132 -132
  746. package/skills/design-lab/SKILL.md +42 -42
  747. package/skills/devops-engineer/SKILL.md +305 -305
  748. package/skills/devops-incident-responder/SKILL.md +103 -103
  749. package/skills/diagnosing-bugs/SKILL.md +172 -172
  750. package/skills/distill/SKILL.md +45 -45
  751. package/skills/documentation-templates/SKILL.md +251 -251
  752. package/skills/domain-modeling/SKILL.md +61 -61
  753. package/skills/duckdb-analytical-sql/SKILL.md +51 -51
  754. package/skills/edge-ai-mobile/SKILL.md +42 -42
  755. package/skills/edge-computing/SKILL.md +143 -143
  756. package/skills/emil-design-eng/SKILL.md +134 -134
  757. package/skills/error-resilience/SKILL.md +403 -403
  758. package/skills/expo-router-v4/SKILL.md +72 -72
  759. package/skills/extract-design-system/SKILL.md +120 -120
  760. package/skills/fabel-protocol/SKILL.md +282 -282
  761. package/skills/failure-mode-analysis/SKILL.md +48 -0
  762. package/skills/fixing-accessibility/SKILL.md +87 -87
  763. package/skills/fixing-metadata/SKILL.md +83 -83
  764. package/skills/fixing-motion-performance/SKILL.md +78 -78
  765. package/skills/framer-motion-expert/SKILL.md +237 -237
  766. package/skills/frontend-design/SKILL.md +103 -103
  767. package/skills/frontend-security-expert/SKILL.md +56 -56
  768. package/skills/game-design-expert/SKILL.md +92 -92
  769. package/skills/game-engineering-expert/SKILL.md +108 -108
  770. package/skills/generative-ui-expert/SKILL.md +100 -100
  771. package/skills/geo-fundamentals/SKILL.md +108 -108
  772. package/skills/git-pro/SKILL.md +401 -401
  773. package/skills/github-operations/SKILL.md +295 -295
  774. package/skills/gpt-taste/SKILL.md +50 -50
  775. package/skills/graph-engineering/SKILL.md +28 -28
  776. package/skills/gsap-core/SKILL.md +277 -277
  777. package/skills/gsap-frameworks/SKILL.md +168 -168
  778. package/skills/gsap-performance/SKILL.md +94 -94
  779. package/skills/gsap-plugins/SKILL.md +441 -441
  780. package/skills/gsap-react/SKILL.md +213 -213
  781. package/skills/gsap-scrolltrigger/SKILL.md +312 -312
  782. package/skills/gsap-timeline/SKILL.md +122 -122
  783. package/skills/gsap-utils/SKILL.md +299 -299
  784. package/skills/harden/SKILL.md +55 -55
  785. package/skills/harness-protocol/SKILL.md +48 -48
  786. package/skills/huggingface-spaces/SKILL.md +1 -1
  787. package/skills/human-gate-negotiation/SKILL.md +30 -30
  788. package/skills/i18n-localization/SKILL.md +134 -134
  789. package/skills/impeccable/SKILL.md +52 -52
  790. package/skills/improve-codebase-architecture/SKILL.md +48 -48
  791. package/skills/improve-ui/SKILL.md +70 -70
  792. package/skills/intelligent-routing/SKILL.md +204 -204
  793. package/skills/knowledge-graph/SKILL.md +71 -71
  794. package/skills/landing-page/SKILL.md +65 -65
  795. package/skills/lint-and-validate/SKILL.md +224 -224
  796. package/skills/llm-engineering/SKILL.md +360 -360
  797. package/skills/local-first/SKILL.md +138 -138
  798. package/skills/local-first-architecture/SKILL.md +62 -62
  799. package/skills/lottie-animation/SKILL.md +62 -62
  800. package/skills/marquee-loop/SKILL.md +72 -72
  801. package/skills/masked-reveal/SKILL.md +230 -230
  802. package/skills/mcp-builder/SKILL.md +105 -105
  803. package/skills/micro-interaction/SKILL.md +253 -253
  804. package/skills/mobile-design/SKILL.md +245 -245
  805. package/skills/monorepo-management/SKILL.md +295 -295
  806. package/skills/morphing-icons/SKILL.md +348 -348
  807. package/skills/motion-engineering/SKILL.md +197 -197
  808. package/skills/nextjs-react-expert/SKILL.md +218 -218
  809. package/skills/nodejs-best-practices/SKILL.md +542 -542
  810. package/skills/observability/SKILL.md +303 -303
  811. package/skills/opentelemetry-observability/SKILL.md +51 -51
  812. package/skills/page-transition-animation/SKILL.md +86 -86
  813. package/skills/parallel-agents/SKILL.md +110 -110
  814. package/skills/performance-profiling/SKILL.md +230 -230
  815. package/skills/plan-writing/SKILL.md +127 -127
  816. package/skills/platform-engineer/SKILL.md +108 -108
  817. package/skills/platform-engineering-opentofu/SKILL.md +59 -59
  818. package/skills/playwright-ai-e2e/SKILL.md +52 -52
  819. package/skills/playwright-best-practices/SKILL.md +149 -149
  820. package/skills/polish/SKILL.md +39 -39
  821. package/skills/powershell-windows/SKILL.md +122 -122
  822. package/skills/pricing-page/SKILL.md +48 -48
  823. package/skills/product-aware-heuristics/SKILL.md +390 -390
  824. package/skills/progressive-blur/SKILL.md +80 -80
  825. package/skills/project-idioms/SKILL.md +91 -91
  826. package/skills/property-based-testing/SKILL.md +50 -50
  827. package/skills/python-patterns/SKILL.md +220 -220
  828. package/skills/python-pro/SKILL.md +305 -305
  829. package/skills/quieter/SKILL.md +49 -49
  830. package/skills/react-doctor/SKILL.md +51 -51
  831. package/skills/react-specialist/SKILL.md +280 -280
  832. package/skills/readme-builder/SKILL.md +270 -270
  833. package/skills/realtime-patterns/SKILL.md +283 -283
  834. package/skills/red-team-tactics/SKILL.md +191 -191
  835. package/skills/redesign-skill/SKILL.md +46 -46
  836. package/skills/review-animations/SKILL.md +45 -45
  837. package/skills/review-animations/STANDARDS.md +87 -87
  838. package/skills/rust-pro/SKILL.md +652 -652
  839. package/skills/semantic-filesystem-navigation/SKILL.md +24 -24
  840. package/skills/seo-fundamentals/SKILL.md +139 -139
  841. package/skills/server-management/SKILL.md +178 -178
  842. package/skills/session-log-interrogation/SKILL.md +29 -29
  843. package/skills/shadcn-ui-expert/SKILL.md +196 -196
  844. package/skills/shape/SKILL.md +56 -56
  845. package/skills/skill-creator/SKILL.md +177 -177
  846. package/skills/soft-skill/SKILL.md +53 -53
  847. package/skills/sounds-on-the-web/SKILL.md +76 -76
  848. package/skills/sql-pro/SKILL.md +624 -624
  849. package/skills/subagent-driven-development/SKILL.md +32 -32
  850. package/skills/supabase-postgres-best-practices/SKILL.md +57 -57
  851. package/skills/svg-animation/SKILL.md +356 -356
  852. package/skills/swiftui-expert/SKILL.md +164 -164
  853. package/skills/swiss-design/SKILL.md +44 -44
  854. package/skills/system-design-pro/SKILL.md +188 -318
  855. package/skills/systematic-debugging/SKILL.md +129 -129
  856. package/skills/systematic-debugging/condition-based-waiting.md +120 -120
  857. package/skills/systematic-debugging/defense-in-depth.md +128 -128
  858. package/skills/systematic-debugging/root-cause-tracing.md +183 -183
  859. package/skills/tailwind-patterns/SKILL.md +583 -583
  860. package/skills/taste-skill/SKILL.md +52 -52
  861. package/skills/tdd-workflow/SKILL.md +105 -105
  862. package/skills/test-result-analyzer/SKILL.md +270 -270
  863. package/skills/testing-patterns/SKILL.md +534 -534
  864. package/skills/thermo-nuclear-code-quality-review/SKILL.md +62 -62
  865. package/skills/thinking-protocol/SKILL.md +21 -21
  866. package/skills/to-spring-or-not-to-spring/SKILL.md +43 -43
  867. package/skills/transformers-js/references/CONFIGURATION.md +1 -1
  868. package/skills/transitions-dev/SKILL.md +90 -90
  869. package/skills/trend-researcher/SKILL.md +198 -198
  870. package/skills/tribunal-instincts-memory/SKILL.md +31 -31
  871. package/skills/typescript-advanced/SKILL.md +306 -306
  872. package/skills/typeset/SKILL.md +60 -60
  873. package/skills/ui-reasoning-engine/SKILL.md +155 -155
  874. package/skills/ui-skill-packs/SKILL.md +57 -57
  875. package/skills/ui-skills-root/SKILL.md +69 -69
  876. package/skills/ui-ux-pro-max/SKILL.md +110 -110
  877. package/skills/ui-ux-researcher/SKILL.md +199 -199
  878. package/skills/vector-search-pgvector/SKILL.md +70 -70
  879. package/skills/verification-before-completion/SKILL.md +107 -107
  880. package/skills/vue-expert/SKILL.md +259 -259
  881. package/skills/vulnerability-scanner/SKILL.md +378 -378
  882. package/skills/web-accessibility-auditor/SKILL.md +179 -179
  883. package/skills/web-design-guidelines/SKILL.md +49 -49
  884. package/skills/web-quality-audit/SKILL.md +47 -47
  885. package/skills/webapp-testing/SKILL.md +128 -128
  886. package/skills/webgpu-performance/SKILL.md +88 -88
  887. package/skills/whimsy-injector/SKILL.md +305 -305
  888. package/skills/workflow-optimizer/SKILL.md +188 -188
  889. package/skills/zero-trust-passkeys/SKILL.md +82 -82
  890. package/{dist → src}/browser/audit.js +229 -229
  891. package/{dist → src}/browser/case_bridge.js +189 -189
  892. package/{dist → src}/browser/cdp.js +513 -513
  893. package/{dist → src}/browser/compare.js +110 -110
  894. package/{dist → src}/browser/discovery.js +140 -140
  895. package/{dist → src}/browser/idpi.js +142 -142
  896. package/{dist → src}/browser/index.js +89 -89
  897. package/{dist → src}/browser/launcher.js +154 -154
  898. package/{dist → src}/browser/sentinel.js +202 -202
  899. package/{dist → src}/browser/synapse.js +251 -251
  900. package/{dist → src}/browser/trimmer.js +210 -210
  901. package/{dist → src}/commands/align.js +201 -201
  902. package/{dist → src}/commands/audit-web.js +112 -112
  903. package/{dist → src}/commands/browse.js +56 -56
  904. package/{dist → src}/commands/case.js +71 -73
  905. package/{dist → src}/commands/compare-web.js +61 -61
  906. package/{dist → src}/commands/compile.js +91 -91
  907. package/{dist → src}/commands/context.js +71 -71
  908. package/{dist → src}/commands/contract.js +440 -440
  909. package/{dist → src}/commands/deconstruct.js +58 -58
  910. package/{dist → src}/commands/graph.js +44 -44
  911. package/{dist → src}/commands/guardrail.js +275 -275
  912. package/{dist → src}/commands/heal.js +99 -99
  913. package/{dist → src}/commands/hook.js +28 -28
  914. package/{dist → src}/commands/init.js +393 -393
  915. package/{dist → src}/commands/learn.js +119 -117
  916. package/{dist → src}/commands/marathon.js +45 -45
  917. package/{dist → src}/commands/memory.js +508 -508
  918. package/{dist → src}/commands/minimal.js +71 -71
  919. package/{dist → src}/commands/mutate.js +30 -30
  920. package/{dist → src}/commands/native.js +264 -264
  921. package/{dist → src}/commands/optimize.js +332 -328
  922. package/{dist → src}/commands/sdd.js +265 -229
  923. package/{dist → src}/commands/status.js +66 -66
  924. package/{dist → src}/commands/sync.js +25 -25
  925. package/{dist → src}/commands/uninstall.js +54 -54
  926. package/{dist → src}/commands/update.js +37 -37
  927. package/{dist → src}/commands/validate.js +58 -58
  928. package/{dist → src}/esm/index.mjs +1 -1
  929. package/{dist → src}/mcp/server.js +8 -8
  930. package/{dist → src}/tui/banner.js +1 -1
  931. package/{dist → src}/tui/index.js +21 -21
  932. package/{dist → src}/tui/reviewer-grid.js +90 -90
  933. package/{dist → src}/tui/shimmer.js +91 -91
  934. package/{dist → src}/tui/theme.js +130 -130
  935. package/{dist → src}/tui/tree.js +93 -93
  936. package/{dist → src}/tui/wizard.js +148 -148
  937. package/{dist → src}/types.js +8 -8
  938. package/{dist → src}/utils/fs.js +102 -102
  939. package/{dist → src}/utils/hasher.js +142 -142
  940. package/{dist → src}/utils/helpers.js +53 -53
  941. package/{dist → src}/utils/logger.js +54 -54
  942. package/{dist → src}/utils/version.js +157 -157
  943. package/.agent/history/README.md +0 -53
  944. package/.agent/history/architecture-explorer.html +0 -352
  945. package/.agent/history/architecture-graph.yaml +0 -619
  946. package/.agent/history/case-law/cases/template-case.json +0 -19
  947. package/.agent/history/graph-cache.json +0 -1042
  948. package/.agent/history/integrity_manifest.json +0 -4694
  949. package/.agent/history/memory/.memory.idx +0 -7596
  950. package/.agent/history/memory/MEMORY.md +0 -512
  951. package/.agent/history/memory.db +0 -0
  952. package/.agent/history/snapshots/.opencode__plugins__tribunal.js.json +0 -12
  953. package/.agent/history/snapshots/.pi__extensions__tribunal.ts.json +0 -12
  954. package/.agent/history/snapshots/bin__adapter-install.js.json +0 -13
  955. package/.agent/history/snapshots/bin__global-store.js.json +0 -15
  956. package/.agent/history/snapshots/bin__mcp-server.js.json +0 -21
  957. package/.agent/history/snapshots/bin__proxy-server.js.json +0 -20
  958. package/.agent/history/snapshots/bin__spawn-agent.js.json +0 -12
  959. package/.agent/history/snapshots/bin__tk-proxy.js.json +0 -21
  960. package/.agent/history/snapshots/bin__tribunal-kit.js.json +0 -21
  961. package/.agent/history/snapshots/bin__wrapper.js.json +0 -14
  962. package/.agent/history/snapshots/eslint.config.js.json +0 -8
  963. package/.agent/history/snapshots/hooks__session-start.js.json +0 -11
  964. package/.agent/history/snapshots/scripts__apply-version.js.json +0 -11
  965. package/.agent/history/snapshots/scripts__audit_skill_sdo.js.json +0 -11
  966. package/.agent/history/snapshots/scripts__benchmark.js.json +0 -14
  967. package/.agent/history/snapshots/scripts__changelog.js.json +0 -12
  968. package/.agent/history/snapshots/scripts__clean-pycache.js.json +0 -11
  969. package/.agent/history/snapshots/scripts__context_compiler.js.json +0 -17
  970. package/.agent/history/snapshots/scripts__fix-vbc.js.json +0 -11
  971. package/.agent/history/snapshots/scripts__modernize_skills.js.json +0 -11
  972. package/.agent/history/snapshots/scripts__package-cores.js.json +0 -12
  973. package/.agent/history/snapshots/scripts__skill_enhancement_engine.js.json +0 -11
  974. package/.agent/history/snapshots/scripts__stress_benchmark.js.json +0 -15
  975. package/.agent/history/snapshots/scripts__sync-skills.js.json +0 -11
  976. package/.agent/history/snapshots/scripts__sync-version.js.json +0 -11
  977. package/.agent/history/snapshots/scripts__telemetry_gc.js.json +0 -11
  978. package/.agent/history/snapshots/scripts__validate-payload.js.json +0 -11
  979. package/.agent/history/snapshots/scripts__visual_audit.js.json +0 -11
  980. package/.agent/history/snapshots/test__integration__bridges.test.js.json +0 -13
  981. package/.agent/history/snapshots/test__integration__browser_cli.test.js.json +0 -12
  982. package/.agent/history/snapshots/test__integration__graceful_degradation.test.js.json +0 -12
  983. package/.agent/history/snapshots/test__integration__init.test.js.json +0 -13
  984. package/.agent/history/snapshots/test__integration__minimal_change_pipeline.test.js.json +0 -13
  985. package/.agent/history/snapshots/test__integration__parallel_tribunal.test.js.json +0 -12
  986. package/.agent/history/snapshots/test__integration__routing.test.js.json +0 -11
  987. package/.agent/history/snapshots/test__integration__swarm_dispatcher.test.js.json +0 -13
  988. package/.agent/history/snapshots/test__integration__sync_status.test.js.json +0 -13
  989. package/.agent/history/snapshots/test__integration__wave2.test.js.json +0 -13
  990. package/.agent/history/snapshots/test__integration__wrapper.test.js.json +0 -13
  991. package/.agent/history/snapshots/test__unit__align.test.js.json +0 -10
  992. package/.agent/history/snapshots/test__unit__args.test.js.json +0 -20
  993. package/.agent/history/snapshots/test__unit__ast_context_loader.test.js.json +0 -12
  994. package/.agent/history/snapshots/test__unit__audit_release.test.js.json +0 -16
  995. package/.agent/history/snapshots/test__unit__browser_case_bridge.test.js.json +0 -11
  996. package/.agent/history/snapshots/test__unit__browser_discovery.test.js.json +0 -10
  997. package/.agent/history/snapshots/test__unit__browser_idpi.test.js.json +0 -10
  998. package/.agent/history/snapshots/test__unit__browser_sentinel.test.js.json +0 -11
  999. package/.agent/history/snapshots/test__unit__browser_synapse.test.js.json +0 -10
  1000. package/.agent/history/snapshots/test__unit__browser_trimmer.test.js.json +0 -10
  1001. package/.agent/history/snapshots/test__unit__case_law_manager.test.js.json +0 -10
  1002. package/.agent/history/snapshots/test__unit__cicd_validator.test.js.json +0 -12
  1003. package/.agent/history/snapshots/test__unit__compile.test.js.json +0 -10
  1004. package/.agent/history/snapshots/test__unit__context_broker.test.js.json +0 -10
  1005. package/.agent/history/snapshots/test__unit__context_compiler.test.js.json +0 -26
  1006. package/.agent/history/snapshots/test__unit__contract_engine.test.js.json +0 -13
  1007. package/.agent/history/snapshots/test__unit__copyDir.test.js.json +0 -23
  1008. package/.agent/history/snapshots/test__unit__graph_tools.test.js.json +0 -11
  1009. package/.agent/history/snapshots/test__unit__guardrail_engine.test.js.json +0 -10
  1010. package/.agent/history/snapshots/test__unit__impact_classifier.test.js.json +0 -12
  1011. package/.agent/history/snapshots/test__unit__init.test.js.json +0 -14
  1012. package/.agent/history/snapshots/test__unit__inner_loop_validator.test.js.json +0 -10
  1013. package/.agent/history/snapshots/test__unit__integrity_manifest.test.js.json +0 -13
  1014. package/.agent/history/snapshots/test__unit__learn.test.js.json +0 -11
  1015. package/.agent/history/snapshots/test__unit__marathon.test.js.json +0 -22
  1016. package/.agent/history/snapshots/test__unit__mcp_server.test.js.json +0 -16
  1017. package/.agent/history/snapshots/test__unit__memory.test.js.json +0 -13
  1018. package/.agent/history/snapshots/test__unit__minimal_change.test.js.json +0 -10
  1019. package/.agent/history/snapshots/test__unit__native.test.js.json +0 -10
  1020. package/.agent/history/snapshots/test__unit__optimize.test.js.json +0 -13
  1021. package/.agent/history/snapshots/test__unit__path_resolution.test.js.json +0 -14
  1022. package/.agent/history/snapshots/test__unit__platform_download_audit.test.js.json +0 -11
  1023. package/.agent/history/snapshots/test__unit__production_readiness_evidence.test.js.json +0 -21
  1024. package/.agent/history/snapshots/test__unit__prompt_compiler.test.js.json +0 -10
  1025. package/.agent/history/snapshots/test__unit__sdd_integration.test.js.json +0 -12
  1026. package/.agent/history/snapshots/test__unit__selfInstall.test.js.json +0 -23
  1027. package/.agent/history/snapshots/test__unit__semver.test.js.json +0 -20
  1028. package/.agent/history/snapshots/test__unit__skill_evolution.test.js.json +0 -11
  1029. package/.agent/history/snapshots/test__unit__stress.test.js.json +0 -15
  1030. package/.agent/history/snapshots/test__unit__swarm_dispatcher.test.js.json +0 -12
  1031. package/.agent/history/snapshots/test__unit__token_budget_broker.test.js.json +0 -10
  1032. package/.agent/history/snapshots/test__unit__tui.test.js.json +0 -10
  1033. package/.agent/history/snapshots/test__unit__utils.test.js.json +0 -10
  1034. package/.agents/plugins/marketplace.json +0 -20
  1035. package/.claude/CLAUDE.md +0 -442
  1036. /package/{dist → src}/cli.js +0 -0
  1037. /package/{dist → src}/index.d.ts +0 -0
@@ -1,583 +1,583 @@
1
- ---
2
- name: tailwind-patterns
3
- description: "Use when Tailwind CSS v4+ mastery. CSS-first configuration, @theme directive, container queries, scroll-driven animations, logical properties, clamp(), fluid typography, responsive design, dark mode, custom variants, component extraction, and performance optimization. Use when styling with Tailwind, building design systems, or optimizing CSS output."
4
- version: 5.0.0
5
- last-updated: 2026-09-13
6
- skills:
7
- - baseline-ui
8
- - better-colors
9
- - shadcn-ui-expert
10
- tools: Read, Grep, Glob, Bash, Edit, Write
11
- scripts-binding:
12
- - .agent/scripts/lint_runner.js
13
- - .agent/scripts/verify_all.js
14
- ---
15
-
16
- # Tailwind CSS v4+ — CSS-First Mastery
17
-
18
- ---
19
-
20
- ## 🛠️ Technical Architecture & Reference Recipes
21
-
22
- ---
23
-
24
- ---
25
-
26
- ## v4 Configuration (CSS-First)
27
-
28
- ### The @theme Directive
29
-
30
- ```css
31
- /* app.css — THE configuration file in Tailwind v4 */
32
- @import 'tailwindcss';
33
-
34
- @theme {
35
- /* Colors */
36
- --color-primary-50: oklch(0.97 0.02 250);
37
- --color-primary-100: oklch(0.93 0.04 250);
38
- --color-primary-500: oklch(0.55 0.18 250);
39
- --color-primary-600: oklch(0.48 0.18 250);
40
- --color-primary-700: oklch(0.4 0.16 250);
41
- --color-primary-900: oklch(0.25 0.1 250);
42
-
43
- --color-surface: oklch(0.99 0 0);
44
- --color-surface-alt: oklch(0.96 0 0);
45
- --color-text: oklch(0.15 0 0);
46
- --color-text-muted: oklch(0.45 0 0);
47
-
48
- /* Typography */
49
- --font-sans: 'Inter', 'system-ui', sans-serif;
50
- --font-mono: 'JetBrains Mono', monospace;
51
-
52
- /* Spacing (extends the default scale) */
53
- --spacing-18: 4.5rem;
54
- --spacing-88: 22rem;
55
-
56
- /* Border radius */
57
- --radius-pill: 9999px;
58
- --radius-card: 1rem;
59
-
60
- /* Shadows */
61
- --shadow-card: 0 1px 3px oklch(0 0 0 / 0.08), 0 1px 2px oklch(0 0 0 / 0.06);
62
- --shadow-elevated: 0 10px 25px oklch(0 0 0 / 0.1), 0 4px 10px oklch(0 0 0 / 0.05);
63
-
64
- /* Animations */
65
- --animate-fade-in: fade-in 0.3s ease-out;
66
- --animate-slide-up: slide-up 0.4s cubic-bezier(0.16, 1, 0.3, 1);
67
- }
68
-
69
- @keyframes fade-in {
70
- from {
71
- opacity: 0;
72
- }
73
- to {
74
- opacity: 1;
75
- }
76
- }
77
-
78
- @keyframes slide-up {
79
- from {
80
- opacity: 0;
81
- transform: translateY(12px);
82
- }
83
- to {
84
- opacity: 1;
85
- transform: translateY(0);
86
- }
87
- }
88
-
89
- /* ❌ HALLUCINATION TRAP: Tailwind v4 does NOT use tailwind.config.js
90
- ❌ module.exports = { theme: { extend: { ... } } } ← REMOVED in v4
91
- ✅ Use @theme { } directive in your CSS file
92
- ✅ @import "tailwindcss" replaces the three @tailwind directives */
93
- ```
94
-
95
- ### Dark Mode
96
-
97
- ```css
98
- /* Tailwind v4 dark mode with @theme */
99
- @theme {
100
- --color-surface: oklch(0.99 0 0);
101
- --color-text: oklch(0.15 0 0);
102
- }
103
-
104
- /* Dark variant — override variables */
105
- @variant dark {
106
- @theme {
107
- --color-surface: oklch(0.13 0.02 260);
108
- --color-text: oklch(0.93 0 0);
109
- }
110
- }
111
-
112
- /* Usage in HTML: */
113
- /* <div class="bg-surface text-text dark:bg-surface dark:text-text"> */
114
- /* With the @variant dark override, classes "just work" in dark mode */
115
- ```
116
-
117
- ```html
118
- <!-- Dark mode toggle pattern -->
119
- <html class="dark">
120
- <body class="bg-surface text-text transition-colors duration-300">
121
- <!-- Automatically uses dark @theme values -->
122
- </body>
123
- </html>
124
- ```
125
-
126
- ### Custom Variants
127
-
128
- ```css
129
- /* @variant — custom selector-based variants */
130
- @variant scrolled (&:where([data-scrolled]));
131
- @variant hocus (&:hover, &:focus-visible);
132
-
133
- /* Usage: */
134
- /* <nav class="scrolled:shadow-elevated hocus:ring-2"> */
135
- ```
136
-
137
- ---
138
-
139
- ## Layout Patterns
140
-
141
- ### Flexbox
142
-
143
- ```html
144
- <!-- Centered hero -->
145
- <section class="flex min-h-svh flex-col items-center justify-center gap-6 px-6">
146
- <h1 class="text-5xl font-bold tracking-tight">Hero Title</h1>
147
- <p class="max-w-2xl text-center text-lg text-text-muted">Subtitle text</p>
148
- <div class="flex gap-3">
149
- <button class="rounded-pill bg-primary-600 px-6 py-3 text-white">Primary</button>
150
- <button class="rounded-pill border border-primary-600 px-6 py-3 text-primary-600">
151
- Secondary
152
- </button>
153
- </div>
154
- </section>
155
-
156
- <!-- Sidebar layout -->
157
- <div class="flex min-h-svh">
158
- <aside class="w-64 shrink-0 border-r border-gray-200 p-4">Sidebar</aside>
159
- <main class="flex-1 overflow-y-auto p-6">Content</main>
160
- </div>
161
-
162
- <!-- ❌ HALLUCINATION TRAP: Use min-h-svh (small viewport height), NOT min-h-screen
163
- min-h-screen = 100vh (broken on mobile — includes browser chrome)
164
- min-h-svh = 100svh (accounts for mobile browser chrome)
165
- min-h-dvh = 100dvh (dynamic — updates as chrome shows/hides) -->
166
- ```
167
-
168
- ### CSS Grid
169
-
170
- ```html
171
- <!-- Auto-fit responsive grid (no breakpoints needed) -->
172
- <div class="grid grid-cols-[repeat(auto-fit,minmax(280px,1fr))] gap-6">
173
- <div class="rounded-card bg-surface p-6 shadow-card">Card 1</div>
174
- <div class="rounded-card bg-surface p-6 shadow-card">Card 2</div>
175
- <div class="rounded-card bg-surface p-6 shadow-card">Card 3</div>
176
- </div>
177
-
178
- <!-- Dashboard grid with named areas -->
179
- <div class="grid grid-cols-[240px_1fr] grid-rows-[64px_1fr] min-h-svh">
180
- <header class="col-span-2 border-b">Header</header>
181
- <aside class="border-r p-4">Sidebar</aside>
182
- <main class="overflow-y-auto p-6">Content</main>
183
- </div>
184
-
185
- <!-- Bento grid -->
186
- <div class="grid auto-rows-[180px] grid-cols-3 gap-4">
187
- <div class="col-span-2 row-span-2 rounded-2xl bg-primary-100">Large</div>
188
- <div class="rounded-2xl bg-surface-alt">Small 1</div>
189
- <div class="rounded-2xl bg-surface-alt">Small 2</div>
190
- <div class="col-span-3 rounded-2xl bg-primary-50">Full width</div>
191
- </div>
192
- ```
193
-
194
- ### Container Queries
195
-
196
- ```html
197
- <!-- Container queries — component-level responsiveness -->
198
- <div class="@container">
199
- <div class="flex flex-col gap-3 @sm:flex-row @sm:items-center @lg:gap-6">
200
- <img class="size-16 rounded-full @sm:size-20" src="avatar.jpg" alt="" />
201
- <div>
202
- <h3 class="text-lg font-semibold @lg:text-xl">User Name</h3>
203
- <p class="text-sm text-text-muted @lg:text-base">Description</p>
204
- </div>
205
- </div>
206
- </div>
207
-
208
- <!-- Named container -->
209
- <div class="@container/card">
210
- <div class="@md/card:grid @md/card:grid-cols-2">
211
- <!-- Responds to the card container's width, not viewport -->
212
- </div>
213
- </div>
214
-
215
- <!-- ❌ HALLUCINATION TRAP: Container queries use @sm, @md, @lg (with @ prefix)
216
- NOT sm:, md:, lg: — those are VIEWPORT breakpoints
217
- @sm = container >= 320px (component-level)
218
- sm: = viewport >= 640px (page-level) -->
219
- ```
220
-
221
- ---
222
-
223
- ## Typography
224
-
225
- ### Fluid Typography with clamp()
226
-
227
- ```html
228
- <!-- Fluid heading — scales smoothly from 2rem to 4rem -->
229
- <h1 class="text-[clamp(2rem,5vw,4rem)] font-bold leading-tight tracking-tight">
230
- Responsive Heading
231
- </h1>
232
-
233
- <!-- Fluid body text -->
234
- <p class="text-[clamp(1rem,1.2vw,1.25rem)] leading-relaxed text-text-muted">
235
- Body text that scales with viewport
236
- </p>
237
-
238
- <!-- Prose (for long-form content) -->
239
- <article class="prose prose-lg mx-auto max-w-3xl dark:prose-invert">
240
- <!-- @tailwindcss/typography plugin handles all typography -->
241
- <h1>Article Title</h1>
242
- <p>Paragraph with <a href="#">links</a> and <code>code</code>.</p>
243
- </article>
244
- ```
245
-
246
- ### Font Loading
247
-
248
- ```css
249
- /* @font-face in your CSS (Tailwind v4 approach) */
250
- @font-face {
251
- font-family: 'Inter';
252
- font-weight: 100 900;
253
- font-display: swap;
254
- src: url('/fonts/inter-variable.woff2') format('woff2');
255
- }
256
-
257
- @theme {
258
- --font-sans: 'Inter', system-ui, sans-serif;
259
- }
260
- ```
261
-
262
- ---
263
-
264
- ## Component Patterns
265
-
266
- ### Button System
267
-
268
- ```html
269
- <!-- Base button with variants -->
270
- <button
271
- class="inline-flex items-center justify-center gap-2 rounded-lg px-4 py-2.5
272
- text-sm font-medium transition-all duration-150
273
- focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary-500
274
- active:scale-[0.98] disabled:pointer-events-none disabled:opacity-50"
275
- >
276
- Button Text
277
- </button>
278
-
279
- <!-- Primary variant -->
280
- <button class="... bg-primary-600 text-white shadow-sm hover:bg-primary-700">Primary</button>
281
-
282
- <!-- Ghost variant -->
283
- <button class="... text-text hover:bg-gray-100 dark:hover:bg-gray-800">Ghost</button>
284
-
285
- <!-- Destructive variant -->
286
- <button class="... bg-red-600 text-white hover:bg-red-700">Delete</button>
287
-
288
- <!-- Icon button -->
289
- <button class="grid size-10 place-items-center rounded-lg hover:bg-gray-100" aria-label="Settings">
290
- <svg class="size-5" ...></svg>
291
- </button>
292
- ```
293
-
294
- ### Input System
295
-
296
- ```html
297
- <!-- Text input -->
298
- <div class="space-y-1.5">
299
- <label for="email" class="text-sm font-medium text-text">Email</label>
300
- <input
301
- id="email"
302
- type="email"
303
- placeholder="you@example.com"
304
- class="w-full rounded-lg border border-gray-300 bg-surface px-3.5 py-2.5
305
- text-sm text-text placeholder:text-text-muted
306
- transition-colors duration-150
307
- focus:border-primary-500 focus:outline-none focus:ring-2 focus:ring-primary-500/20
308
- disabled:cursor-not-allowed disabled:bg-gray-50 disabled:opacity-60"
309
- />
310
- <p class="text-xs text-red-500">Error message here</p>
311
- </div>
312
-
313
- <!-- Checkbox -->
314
- <label class="flex items-center gap-2.5 text-sm">
315
- <input
316
- type="checkbox"
317
- class="size-4 rounded border-gray-300 text-primary-600
318
- focus:ring-2 focus:ring-primary-500/20"
319
- />
320
- Remember me
321
- </label>
322
- ```
323
-
324
- ### Card Pattern
325
-
326
- ```html
327
- <div
328
- class="group overflow-hidden rounded-card bg-surface shadow-card
329
- transition-shadow duration-200 hover:shadow-elevated"
330
- >
331
- <div class="aspect-video overflow-hidden bg-gray-100">
332
- <img
333
- src="cover.jpg"
334
- alt="Cover"
335
- class="size-full object-cover transition-transform duration-300
336
- group-hover:scale-105"
337
- />
338
- </div>
339
- <div class="space-y-2 p-5">
340
- <span
341
- class="inline-block rounded-full bg-primary-100 px-2.5 py-0.5
342
- text-xs font-medium text-primary-700"
343
- >Category</span
344
- >
345
- <h3 class="text-lg font-semibold text-text line-clamp-2">Card Title</h3>
346
- <p class="text-sm text-text-muted line-clamp-3">Description text...</p>
347
- </div>
348
- </div>
349
- ```
350
-
351
- ### Modal / Dialog
352
-
353
- ```html
354
- <!-- Backdrop -->
355
- <div
356
- class="fixed inset-0 z-50 flex items-center justify-center bg-black/50
357
- backdrop-blur-sm animate-fade-in"
358
- >
359
- <!-- Modal -->
360
- <div
361
- class="w-full max-w-md rounded-2xl bg-surface p-6 shadow-elevated animate-slide-up"
362
- role="dialog"
363
- aria-modal="true"
364
- aria-labelledby="modal-title"
365
- >
366
- <h2 id="modal-title" class="text-lg font-semibold">Dialog Title</h2>
367
- <p class="mt-2 text-sm text-text-muted">Dialog description.</p>
368
-
369
- <div class="mt-6 flex justify-end gap-3">
370
- <button class="rounded-lg px-4 py-2 text-sm hover:bg-gray-100">Cancel</button>
371
- <button
372
- class="rounded-lg bg-primary-600 px-4 py-2 text-sm text-white
373
- hover:bg-primary-700"
374
- >
375
- Confirm
376
- </button>
377
- </div>
378
- </div>
379
- </div>
380
- ```
381
-
382
- ---
383
-
384
- ## Responsive Design Rules
385
-
386
- ```html
387
- <!-- Tailwind breakpoints (mobile-first) -->
388
- <!-- sm: 640px │ md: 768px │ lg: 1024px │ xl: 1280px │ 2xl: 1536px -->
389
-
390
- <!-- Stack on mobile, row on tablet+ -->
391
- <div class="flex flex-col gap-4 md:flex-row md:items-center">
392
- <div class="md:w-1/2">Left</div>
393
- <div class="md:w-1/2">Right</div>
394
- </div>
395
-
396
- <!-- Hide/show at breakpoints -->
397
- <nav class="hidden lg:flex">Desktop nav</nav>
398
- <button class="lg:hidden">☰ Mobile menu</button>
399
-
400
- <!-- Responsive padding -->
401
- <section class="px-4 py-12 sm:px-6 lg:px-8 lg:py-24">
402
- <div class="mx-auto max-w-7xl">Content</div>
403
- </section>
404
-
405
- <!-- Responsive grid -->
406
- <div class="grid grid-cols-1 gap-6 sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4">
407
- <!-- Cards -->
408
- </div>
409
- ```
410
-
411
- ---
412
-
413
- ## Animations & Transitions
414
-
415
- ### Transition Utilities
416
-
417
- ```html
418
- <!-- Smooth hover transitions -->
419
- <a class="text-text-muted transition-colors duration-150 hover:text-primary-600">Link</a>
420
-
421
- <!-- Transform transitions -->
422
- <div class="transition-transform duration-300 hover:-translate-y-1 hover:scale-105">Hover me</div>
423
-
424
- <!-- Combined transition -->
425
- <button
426
- class="rounded-lg bg-primary-600 px-4 py-2 text-white
427
- transition-all duration-200
428
- hover:bg-primary-700 hover:shadow-lg
429
- active:scale-95"
430
- >
431
- Click me
432
- </button>
433
- ```
434
-
435
- ### Custom Keyframe Animations
436
-
437
- ```css
438
- @theme {
439
- --animate-bounce-in: bounce-in 0.5s cubic-bezier(0.68, -0.55, 0.265, 1.55);
440
- --animate-spin-slow: spin 3s linear infinite;
441
- --animate-pulse-soft: pulse-soft 2s ease-in-out infinite;
442
- }
443
-
444
- @keyframes bounce-in {
445
- 0% {
446
- opacity: 0;
447
- transform: scale(0.3);
448
- }
449
- 50% {
450
- transform: scale(1.05);
451
- }
452
- 70% {
453
- transform: scale(0.9);
454
- }
455
- 100% {
456
- opacity: 1;
457
- transform: scale(1);
458
- }
459
- }
460
-
461
- @keyframes pulse-soft {
462
- 0%,
463
- 100% {
464
- opacity: 1;
465
- }
466
- 50% {
467
- opacity: 0.7;
468
- }
469
- }
470
- ```
471
-
472
- ### Scroll-Driven Animations (CSS Native)
473
-
474
- ```css
475
- /* Progress bar that fills as user scrolls */
476
- .scroll-progress {
477
- animation: grow-width linear;
478
- animation-timeline: scroll();
479
- }
480
-
481
- @keyframes grow-width {
482
- from {
483
- transform: scaleX(0);
484
- }
485
- to {
486
- transform: scaleX(1);
487
- }
488
- }
489
- ```
490
-
491
- ```html
492
- <div class="scroll-progress fixed top-0 left-0 z-50 h-1 w-full origin-left bg-primary-600"></div>
493
- ```
494
-
495
- ---
496
-
497
- ## Performance
498
-
499
- ### Purging & Bundle Size
500
-
501
- ```css
502
- /* Tailwind v4 automatically tree-shakes unused CSS at build time */
503
- /* No manual purge configuration needed */
504
-
505
- /* @source — explicitly add content paths for scanning */
506
- @source "../components/**/*.tsx";
507
- @source "../pages/**/*.tsx";
508
-
509
- /* ❌ HALLUCINATION TRAP: Tailwind v4 does NOT use purge: [] config
510
- ❌ purge: ['./src/**/*.{html,tsx}'] ← REMOVED in v4
511
- ✅ Uses automatic content detection based on your project structure
512
- ✅ Use @source directive for custom paths */
513
- ```
514
-
515
- ### Avoiding Bloat
516
-
517
- ```html
518
- <!-- ✅ GOOD: Use component extraction for repeated patterns -->
519
- <!-- Create a .btn class in CSS instead of repeating 15 utilities -->
520
-
521
- <!-- ❌ BAD: One-off arbitrary values everywhere -->
522
- <div class="mt-[13px] mr-[7px] p-[11px] text-[15px]">
523
- <!-- Every arbitrary value = unique CSS rule = bundle bloat -->
524
- </div>
525
-
526
- <!-- ✅ GOOD: Use your design scale -->
527
- <div class="mt-3 mr-2 p-3 text-sm">
528
- <!-- Maps to existing utilities = zero extra CSS -->
529
- </div>
530
- ```
531
-
532
- ### Component Extraction (When to @apply)
533
-
534
- ```css
535
- /* Use @apply ONLY for highly reused component patterns */
536
- /* Do NOT @apply everything — it defeats Tailwind's purpose */
537
-
538
- .btn {
539
- @apply inline-flex items-center justify-center gap-2 rounded-lg px-4 py-2.5
540
- text-sm font-medium transition-all duration-150
541
- focus-visible:outline-2 focus-visible:outline-offset-2
542
- active:scale-[0.98] disabled:pointer-events-none disabled:opacity-50;
543
- }
544
-
545
- .btn-primary {
546
- @apply btn bg-primary-600 text-white shadow-sm hover:bg-primary-700
547
- focus-visible:outline-primary-500;
548
- }
549
-
550
- /* ❌ HALLUCINATION TRAP: @apply is for component patterns shared across files
551
- If a pattern appears in only 1-2 places, just use inline utilities
552
- Over-extracting with @apply = recreating regular CSS with extra steps */
553
- ```
554
-
555
- ---
556
-
557
- ## Accessibility with Tailwind
558
-
559
- ```html
560
- <!-- Focus visible (keyboard only, not mouse click) -->
561
- <a
562
- class="rounded-lg focus-visible:outline-2 focus-visible:outline-primary-500
563
- focus-visible:outline-offset-2"
564
- >
565
- Keyboard accessible link
566
- </a>
567
-
568
- <!-- Screen reader only text -->
569
- <button>
570
- <svg class="size-5" aria-hidden="true"></svg>
571
- <span class="sr-only">Close menu</span>
572
- </button>
573
-
574
- <!-- Motion-safe / motion-reduce -->
575
- <div class="motion-safe:animate-bounce-in motion-reduce:animate-none">
576
- <!-- Only animates if user hasn't enabled "reduce motion" -->
577
- </div>
578
-
579
- <!-- Forced colors mode (high contrast) -->
580
- <button class="bg-primary-600 forced-colors:bg-[Highlight] forced-colors:text-[HighlightText]">
581
- Accessible button
582
- </button>
583
- ```
1
+ ---
2
+ name: tailwind-patterns
3
+ description: "Use when Tailwind CSS v4+ mastery. CSS-first configuration, @theme directive, container queries, scroll-driven animations, logical properties, clamp(), fluid typography, responsive design, dark mode, custom variants, component extraction, and performance optimization. Use when styling with Tailwind, building design systems, or optimizing CSS output."
4
+ version: 5.0.0
5
+ last-updated: 2026-09-13
6
+ skills:
7
+ - baseline-ui
8
+ - better-colors
9
+ - shadcn-ui-expert
10
+ tools: Read, Grep, Glob, Bash, Edit, Write
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
14
+ ---
15
+
16
+ # Tailwind CSS v4+ — CSS-First Mastery
17
+
18
+ ---
19
+
20
+ ## 🛠️ Technical Architecture & Reference Recipes
21
+
22
+ ---
23
+
24
+ ---
25
+
26
+ ## v4 Configuration (CSS-First)
27
+
28
+ ### The @theme Directive
29
+
30
+ ```css
31
+ /* app.css — THE configuration file in Tailwind v4 */
32
+ @import 'tailwindcss';
33
+
34
+ @theme {
35
+ /* Colors */
36
+ --color-primary-50: oklch(0.97 0.02 250);
37
+ --color-primary-100: oklch(0.93 0.04 250);
38
+ --color-primary-500: oklch(0.55 0.18 250);
39
+ --color-primary-600: oklch(0.48 0.18 250);
40
+ --color-primary-700: oklch(0.4 0.16 250);
41
+ --color-primary-900: oklch(0.25 0.1 250);
42
+
43
+ --color-surface: oklch(0.99 0 0);
44
+ --color-surface-alt: oklch(0.96 0 0);
45
+ --color-text: oklch(0.15 0 0);
46
+ --color-text-muted: oklch(0.45 0 0);
47
+
48
+ /* Typography */
49
+ --font-sans: 'Inter', 'system-ui', sans-serif;
50
+ --font-mono: 'JetBrains Mono', monospace;
51
+
52
+ /* Spacing (extends the default scale) */
53
+ --spacing-18: 4.5rem;
54
+ --spacing-88: 22rem;
55
+
56
+ /* Border radius */
57
+ --radius-pill: 9999px;
58
+ --radius-card: 1rem;
59
+
60
+ /* Shadows */
61
+ --shadow-card: 0 1px 3px oklch(0 0 0 / 0.08), 0 1px 2px oklch(0 0 0 / 0.06);
62
+ --shadow-elevated: 0 10px 25px oklch(0 0 0 / 0.1), 0 4px 10px oklch(0 0 0 / 0.05);
63
+
64
+ /* Animations */
65
+ --animate-fade-in: fade-in 0.3s ease-out;
66
+ --animate-slide-up: slide-up 0.4s cubic-bezier(0.16, 1, 0.3, 1);
67
+ }
68
+
69
+ @keyframes fade-in {
70
+ from {
71
+ opacity: 0;
72
+ }
73
+ to {
74
+ opacity: 1;
75
+ }
76
+ }
77
+
78
+ @keyframes slide-up {
79
+ from {
80
+ opacity: 0;
81
+ transform: translateY(12px);
82
+ }
83
+ to {
84
+ opacity: 1;
85
+ transform: translateY(0);
86
+ }
87
+ }
88
+
89
+ /* ❌ HALLUCINATION TRAP: Tailwind v4 does NOT use tailwind.config.js
90
+ ❌ module.exports = { theme: { extend: { ... } } } ← REMOVED in v4
91
+ ✅ Use @theme { } directive in your CSS file
92
+ ✅ @import "tailwindcss" replaces the three @tailwind directives */
93
+ ```
94
+
95
+ ### Dark Mode
96
+
97
+ ```css
98
+ /* Tailwind v4 dark mode with @theme */
99
+ @theme {
100
+ --color-surface: oklch(0.99 0 0);
101
+ --color-text: oklch(0.15 0 0);
102
+ }
103
+
104
+ /* Dark variant — override variables */
105
+ @variant dark {
106
+ @theme {
107
+ --color-surface: oklch(0.13 0.02 260);
108
+ --color-text: oklch(0.93 0 0);
109
+ }
110
+ }
111
+
112
+ /* Usage in HTML: */
113
+ /* <div class="bg-surface text-text dark:bg-surface dark:text-text"> */
114
+ /* With the @variant dark override, classes "just work" in dark mode */
115
+ ```
116
+
117
+ ```html
118
+ <!-- Dark mode toggle pattern -->
119
+ <html class="dark">
120
+ <body class="bg-surface text-text transition-colors duration-300">
121
+ <!-- Automatically uses dark @theme values -->
122
+ </body>
123
+ </html>
124
+ ```
125
+
126
+ ### Custom Variants
127
+
128
+ ```css
129
+ /* @variant — custom selector-based variants */
130
+ @variant scrolled (&:where([data-scrolled]));
131
+ @variant hocus (&:hover, &:focus-visible);
132
+
133
+ /* Usage: */
134
+ /* <nav class="scrolled:shadow-elevated hocus:ring-2"> */
135
+ ```
136
+
137
+ ---
138
+
139
+ ## Layout Patterns
140
+
141
+ ### Flexbox
142
+
143
+ ```html
144
+ <!-- Centered hero -->
145
+ <section class="flex min-h-svh flex-col items-center justify-center gap-6 px-6">
146
+ <h1 class="text-5xl font-bold tracking-tight">Hero Title</h1>
147
+ <p class="max-w-2xl text-center text-lg text-text-muted">Subtitle text</p>
148
+ <div class="flex gap-3">
149
+ <button class="rounded-pill bg-primary-600 px-6 py-3 text-white">Primary</button>
150
+ <button class="rounded-pill border border-primary-600 px-6 py-3 text-primary-600">
151
+ Secondary
152
+ </button>
153
+ </div>
154
+ </section>
155
+
156
+ <!-- Sidebar layout -->
157
+ <div class="flex min-h-svh">
158
+ <aside class="w-64 shrink-0 border-r border-gray-200 p-4">Sidebar</aside>
159
+ <main class="flex-1 overflow-y-auto p-6">Content</main>
160
+ </div>
161
+
162
+ <!-- ❌ HALLUCINATION TRAP: Use min-h-svh (small viewport height), NOT min-h-screen
163
+ min-h-screen = 100vh (broken on mobile — includes browser chrome)
164
+ min-h-svh = 100svh (accounts for mobile browser chrome)
165
+ min-h-dvh = 100dvh (dynamic — updates as chrome shows/hides) -->
166
+ ```
167
+
168
+ ### CSS Grid
169
+
170
+ ```html
171
+ <!-- Auto-fit responsive grid (no breakpoints needed) -->
172
+ <div class="grid grid-cols-[repeat(auto-fit,minmax(280px,1fr))] gap-6">
173
+ <div class="rounded-card bg-surface p-6 shadow-card">Card 1</div>
174
+ <div class="rounded-card bg-surface p-6 shadow-card">Card 2</div>
175
+ <div class="rounded-card bg-surface p-6 shadow-card">Card 3</div>
176
+ </div>
177
+
178
+ <!-- Dashboard grid with named areas -->
179
+ <div class="grid grid-cols-[240px_1fr] grid-rows-[64px_1fr] min-h-svh">
180
+ <header class="col-span-2 border-b">Header</header>
181
+ <aside class="border-r p-4">Sidebar</aside>
182
+ <main class="overflow-y-auto p-6">Content</main>
183
+ </div>
184
+
185
+ <!-- Bento grid -->
186
+ <div class="grid auto-rows-[180px] grid-cols-3 gap-4">
187
+ <div class="col-span-2 row-span-2 rounded-2xl bg-primary-100">Large</div>
188
+ <div class="rounded-2xl bg-surface-alt">Small 1</div>
189
+ <div class="rounded-2xl bg-surface-alt">Small 2</div>
190
+ <div class="col-span-3 rounded-2xl bg-primary-50">Full width</div>
191
+ </div>
192
+ ```
193
+
194
+ ### Container Queries
195
+
196
+ ```html
197
+ <!-- Container queries — component-level responsiveness -->
198
+ <div class="@container">
199
+ <div class="flex flex-col gap-3 @sm:flex-row @sm:items-center @lg:gap-6">
200
+ <img class="size-16 rounded-full @sm:size-20" src="avatar.jpg" alt="" />
201
+ <div>
202
+ <h3 class="text-lg font-semibold @lg:text-xl">User Name</h3>
203
+ <p class="text-sm text-text-muted @lg:text-base">Description</p>
204
+ </div>
205
+ </div>
206
+ </div>
207
+
208
+ <!-- Named container -->
209
+ <div class="@container/card">
210
+ <div class="@md/card:grid @md/card:grid-cols-2">
211
+ <!-- Responds to the card container's width, not viewport -->
212
+ </div>
213
+ </div>
214
+
215
+ <!-- ❌ HALLUCINATION TRAP: Container queries use @sm, @md, @lg (with @ prefix)
216
+ NOT sm:, md:, lg: — those are VIEWPORT breakpoints
217
+ @sm = container >= 320px (component-level)
218
+ sm: = viewport >= 640px (page-level) -->
219
+ ```
220
+
221
+ ---
222
+
223
+ ## Typography
224
+
225
+ ### Fluid Typography with clamp()
226
+
227
+ ```html
228
+ <!-- Fluid heading — scales smoothly from 2rem to 4rem -->
229
+ <h1 class="text-[clamp(2rem,5vw,4rem)] font-bold leading-tight tracking-tight">
230
+ Responsive Heading
231
+ </h1>
232
+
233
+ <!-- Fluid body text -->
234
+ <p class="text-[clamp(1rem,1.2vw,1.25rem)] leading-relaxed text-text-muted">
235
+ Body text that scales with viewport
236
+ </p>
237
+
238
+ <!-- Prose (for long-form content) -->
239
+ <article class="prose prose-lg mx-auto max-w-3xl dark:prose-invert">
240
+ <!-- @tailwindcss/typography plugin handles all typography -->
241
+ <h1>Article Title</h1>
242
+ <p>Paragraph with <a href="#">links</a> and <code>code</code>.</p>
243
+ </article>
244
+ ```
245
+
246
+ ### Font Loading
247
+
248
+ ```css
249
+ /* @font-face in your CSS (Tailwind v4 approach) */
250
+ @font-face {
251
+ font-family: 'Inter';
252
+ font-weight: 100 900;
253
+ font-display: swap;
254
+ src: url('/fonts/inter-variable.woff2') format('woff2');
255
+ }
256
+
257
+ @theme {
258
+ --font-sans: 'Inter', system-ui, sans-serif;
259
+ }
260
+ ```
261
+
262
+ ---
263
+
264
+ ## Component Patterns
265
+
266
+ ### Button System
267
+
268
+ ```html
269
+ <!-- Base button with variants -->
270
+ <button
271
+ class="inline-flex items-center justify-center gap-2 rounded-lg px-4 py-2.5
272
+ text-sm font-medium transition-all duration-150
273
+ focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary-500
274
+ active:scale-[0.98] disabled:pointer-events-none disabled:opacity-50"
275
+ >
276
+ Button Text
277
+ </button>
278
+
279
+ <!-- Primary variant -->
280
+ <button class="... bg-primary-600 text-white shadow-sm hover:bg-primary-700">Primary</button>
281
+
282
+ <!-- Ghost variant -->
283
+ <button class="... text-text hover:bg-gray-100 dark:hover:bg-gray-800">Ghost</button>
284
+
285
+ <!-- Destructive variant -->
286
+ <button class="... bg-red-600 text-white hover:bg-red-700">Delete</button>
287
+
288
+ <!-- Icon button -->
289
+ <button class="grid size-10 place-items-center rounded-lg hover:bg-gray-100" aria-label="Settings">
290
+ <svg class="size-5" ...></svg>
291
+ </button>
292
+ ```
293
+
294
+ ### Input System
295
+
296
+ ```html
297
+ <!-- Text input -->
298
+ <div class="space-y-1.5">
299
+ <label for="email" class="text-sm font-medium text-text">Email</label>
300
+ <input
301
+ id="email"
302
+ type="email"
303
+ placeholder="you@example.com"
304
+ class="w-full rounded-lg border border-gray-300 bg-surface px-3.5 py-2.5
305
+ text-sm text-text placeholder:text-text-muted
306
+ transition-colors duration-150
307
+ focus:border-primary-500 focus:outline-none focus:ring-2 focus:ring-primary-500/20
308
+ disabled:cursor-not-allowed disabled:bg-gray-50 disabled:opacity-60"
309
+ />
310
+ <p class="text-xs text-red-500">Error message here</p>
311
+ </div>
312
+
313
+ <!-- Checkbox -->
314
+ <label class="flex items-center gap-2.5 text-sm">
315
+ <input
316
+ type="checkbox"
317
+ class="size-4 rounded border-gray-300 text-primary-600
318
+ focus:ring-2 focus:ring-primary-500/20"
319
+ />
320
+ Remember me
321
+ </label>
322
+ ```
323
+
324
+ ### Card Pattern
325
+
326
+ ```html
327
+ <div
328
+ class="group overflow-hidden rounded-card bg-surface shadow-card
329
+ transition-shadow duration-200 hover:shadow-elevated"
330
+ >
331
+ <div class="aspect-video overflow-hidden bg-gray-100">
332
+ <img
333
+ src="cover.jpg"
334
+ alt="Cover"
335
+ class="size-full object-cover transition-transform duration-300
336
+ group-hover:scale-105"
337
+ />
338
+ </div>
339
+ <div class="space-y-2 p-5">
340
+ <span
341
+ class="inline-block rounded-full bg-primary-100 px-2.5 py-0.5
342
+ text-xs font-medium text-primary-700"
343
+ >Category</span
344
+ >
345
+ <h3 class="text-lg font-semibold text-text line-clamp-2">Card Title</h3>
346
+ <p class="text-sm text-text-muted line-clamp-3">Description text...</p>
347
+ </div>
348
+ </div>
349
+ ```
350
+
351
+ ### Modal / Dialog
352
+
353
+ ```html
354
+ <!-- Backdrop -->
355
+ <div
356
+ class="fixed inset-0 z-50 flex items-center justify-center bg-black/50
357
+ backdrop-blur-sm animate-fade-in"
358
+ >
359
+ <!-- Modal -->
360
+ <div
361
+ class="w-full max-w-md rounded-2xl bg-surface p-6 shadow-elevated animate-slide-up"
362
+ role="dialog"
363
+ aria-modal="true"
364
+ aria-labelledby="modal-title"
365
+ >
366
+ <h2 id="modal-title" class="text-lg font-semibold">Dialog Title</h2>
367
+ <p class="mt-2 text-sm text-text-muted">Dialog description.</p>
368
+
369
+ <div class="mt-6 flex justify-end gap-3">
370
+ <button class="rounded-lg px-4 py-2 text-sm hover:bg-gray-100">Cancel</button>
371
+ <button
372
+ class="rounded-lg bg-primary-600 px-4 py-2 text-sm text-white
373
+ hover:bg-primary-700"
374
+ >
375
+ Confirm
376
+ </button>
377
+ </div>
378
+ </div>
379
+ </div>
380
+ ```
381
+
382
+ ---
383
+
384
+ ## Responsive Design Rules
385
+
386
+ ```html
387
+ <!-- Tailwind breakpoints (mobile-first) -->
388
+ <!-- sm: 640px │ md: 768px │ lg: 1024px │ xl: 1280px │ 2xl: 1536px -->
389
+
390
+ <!-- Stack on mobile, row on tablet+ -->
391
+ <div class="flex flex-col gap-4 md:flex-row md:items-center">
392
+ <div class="md:w-1/2">Left</div>
393
+ <div class="md:w-1/2">Right</div>
394
+ </div>
395
+
396
+ <!-- Hide/show at breakpoints -->
397
+ <nav class="hidden lg:flex">Desktop nav</nav>
398
+ <button class="lg:hidden">☰ Mobile menu</button>
399
+
400
+ <!-- Responsive padding -->
401
+ <section class="px-4 py-12 sm:px-6 lg:px-8 lg:py-24">
402
+ <div class="mx-auto max-w-7xl">Content</div>
403
+ </section>
404
+
405
+ <!-- Responsive grid -->
406
+ <div class="grid grid-cols-1 gap-6 sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4">
407
+ <!-- Cards -->
408
+ </div>
409
+ ```
410
+
411
+ ---
412
+
413
+ ## Animations & Transitions
414
+
415
+ ### Transition Utilities
416
+
417
+ ```html
418
+ <!-- Smooth hover transitions -->
419
+ <a class="text-text-muted transition-colors duration-150 hover:text-primary-600">Link</a>
420
+
421
+ <!-- Transform transitions -->
422
+ <div class="transition-transform duration-300 hover:-translate-y-1 hover:scale-105">Hover me</div>
423
+
424
+ <!-- Combined transition -->
425
+ <button
426
+ class="rounded-lg bg-primary-600 px-4 py-2 text-white
427
+ transition-all duration-200
428
+ hover:bg-primary-700 hover:shadow-lg
429
+ active:scale-95"
430
+ >
431
+ Click me
432
+ </button>
433
+ ```
434
+
435
+ ### Custom Keyframe Animations
436
+
437
+ ```css
438
+ @theme {
439
+ --animate-bounce-in: bounce-in 0.5s cubic-bezier(0.68, -0.55, 0.265, 1.55);
440
+ --animate-spin-slow: spin 3s linear infinite;
441
+ --animate-pulse-soft: pulse-soft 2s ease-in-out infinite;
442
+ }
443
+
444
+ @keyframes bounce-in {
445
+ 0% {
446
+ opacity: 0;
447
+ transform: scale(0.3);
448
+ }
449
+ 50% {
450
+ transform: scale(1.05);
451
+ }
452
+ 70% {
453
+ transform: scale(0.9);
454
+ }
455
+ 100% {
456
+ opacity: 1;
457
+ transform: scale(1);
458
+ }
459
+ }
460
+
461
+ @keyframes pulse-soft {
462
+ 0%,
463
+ 100% {
464
+ opacity: 1;
465
+ }
466
+ 50% {
467
+ opacity: 0.7;
468
+ }
469
+ }
470
+ ```
471
+
472
+ ### Scroll-Driven Animations (CSS Native)
473
+
474
+ ```css
475
+ /* Progress bar that fills as user scrolls */
476
+ .scroll-progress {
477
+ animation: grow-width linear;
478
+ animation-timeline: scroll();
479
+ }
480
+
481
+ @keyframes grow-width {
482
+ from {
483
+ transform: scaleX(0);
484
+ }
485
+ to {
486
+ transform: scaleX(1);
487
+ }
488
+ }
489
+ ```
490
+
491
+ ```html
492
+ <div class="scroll-progress fixed top-0 left-0 z-50 h-1 w-full origin-left bg-primary-600"></div>
493
+ ```
494
+
495
+ ---
496
+
497
+ ## Performance
498
+
499
+ ### Purging & Bundle Size
500
+
501
+ ```css
502
+ /* Tailwind v4 automatically tree-shakes unused CSS at build time */
503
+ /* No manual purge configuration needed */
504
+
505
+ /* @source — explicitly add content paths for scanning */
506
+ @source "../components/**/*.tsx";
507
+ @source "../pages/**/*.tsx";
508
+
509
+ /* ❌ HALLUCINATION TRAP: Tailwind v4 does NOT use purge: [] config
510
+ ❌ purge: ['./src/**/*.{html,tsx}'] ← REMOVED in v4
511
+ ✅ Uses automatic content detection based on your project structure
512
+ ✅ Use @source directive for custom paths */
513
+ ```
514
+
515
+ ### Avoiding Bloat
516
+
517
+ ```html
518
+ <!-- ✅ GOOD: Use component extraction for repeated patterns -->
519
+ <!-- Create a .btn class in CSS instead of repeating 15 utilities -->
520
+
521
+ <!-- ❌ BAD: One-off arbitrary values everywhere -->
522
+ <div class="mt-[13px] mr-[7px] p-[11px] text-[15px]">
523
+ <!-- Every arbitrary value = unique CSS rule = bundle bloat -->
524
+ </div>
525
+
526
+ <!-- ✅ GOOD: Use your design scale -->
527
+ <div class="mt-3 mr-2 p-3 text-sm">
528
+ <!-- Maps to existing utilities = zero extra CSS -->
529
+ </div>
530
+ ```
531
+
532
+ ### Component Extraction (When to @apply)
533
+
534
+ ```css
535
+ /* Use @apply ONLY for highly reused component patterns */
536
+ /* Do NOT @apply everything — it defeats Tailwind's purpose */
537
+
538
+ .btn {
539
+ @apply inline-flex items-center justify-center gap-2 rounded-lg px-4 py-2.5
540
+ text-sm font-medium transition-all duration-150
541
+ focus-visible:outline-2 focus-visible:outline-offset-2
542
+ active:scale-[0.98] disabled:pointer-events-none disabled:opacity-50;
543
+ }
544
+
545
+ .btn-primary {
546
+ @apply btn bg-primary-600 text-white shadow-sm hover:bg-primary-700
547
+ focus-visible:outline-primary-500;
548
+ }
549
+
550
+ /* ❌ HALLUCINATION TRAP: @apply is for component patterns shared across files
551
+ If a pattern appears in only 1-2 places, just use inline utilities
552
+ Over-extracting with @apply = recreating regular CSS with extra steps */
553
+ ```
554
+
555
+ ---
556
+
557
+ ## Accessibility with Tailwind
558
+
559
+ ```html
560
+ <!-- Focus visible (keyboard only, not mouse click) -->
561
+ <a
562
+ class="rounded-lg focus-visible:outline-2 focus-visible:outline-primary-500
563
+ focus-visible:outline-offset-2"
564
+ >
565
+ Keyboard accessible link
566
+ </a>
567
+
568
+ <!-- Screen reader only text -->
569
+ <button>
570
+ <svg class="size-5" aria-hidden="true"></svg>
571
+ <span class="sr-only">Close menu</span>
572
+ </button>
573
+
574
+ <!-- Motion-safe / motion-reduce -->
575
+ <div class="motion-safe:animate-bounce-in motion-reduce:animate-none">
576
+ <!-- Only animates if user hasn't enabled "reduce motion" -->
577
+ </div>
578
+
579
+ <!-- Forced colors mode (high contrast) -->
580
+ <button class="bg-primary-600 forced-colors:bg-[Highlight] forced-colors:text-[HighlightText]">
581
+ Accessible button
582
+ </button>
583
+ ```