tribunal-kit 8.0.0 → 9.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (774) hide show
  1. package/.agent/ARCHITECTURE.md +2 -2
  2. package/.agent/agents/backend-specialist.md +1 -1
  3. package/.agent/agents/code-archaeologist.md +1 -1
  4. package/.agent/agents/database-architect.md +1 -1
  5. package/.agent/agents/debugger.md +1 -1
  6. package/.agent/agents/devops-engineer.md +1 -1
  7. package/.agent/agents/documentation-writer.md +1 -1
  8. package/.agent/agents/explorer-agent.md +1 -1
  9. package/.agent/agents/game-developer.md +1 -1
  10. package/.agent/agents/minimalist-reviewer.md +1 -1
  11. package/.agent/agents/mobile-developer.md +1 -1
  12. package/.agent/agents/orchestrator.md +1 -1
  13. package/.agent/agents/penetration-tester.md +1 -1
  14. package/.agent/agents/performance-optimizer.md +1 -1
  15. package/.agent/agents/product-manager.md +1 -1
  16. package/.agent/agents/product-owner.md +1 -1
  17. package/.agent/agents/project-planner.md +1 -1
  18. package/.agent/agents/qa-automation-engineer.md +1 -1
  19. package/.agent/agents/seo-specialist.md +1 -1
  20. package/.agent/agents/test-engineer.md +1 -1
  21. package/.agent/config/plugin.json +4 -4
  22. package/.agent/config/slash-commands.json +13 -1
  23. package/.agent/config/system-prompt.md +75 -8
  24. package/.agent/routing_index.json +1546 -268
  25. package/.agent/scripts/browser_audit.js +94 -0
  26. package/.agent/scripts/context_compiler.js +9 -0
  27. package/.agent/scripts/prompt_compiler.js +105 -13
  28. package/.agent/skill_topic_map.json +2 -1
  29. package/.agent/skills/12-principles-of-animation/SKILL.md +62 -21
  30. package/.agent/skills/60fps-animation/SKILL.md +90 -20
  31. package/.agent/skills/accessible-animation/SKILL.md +207 -40
  32. package/.agent/skills/adapt/SKILL.md +62 -21
  33. package/.agent/skills/advanced-rag-pipelines/SKILL.md +87 -46
  34. package/.agent/skills/agent-organizer/SKILL.md +60 -81
  35. package/.agent/skills/agentic-patterns/SKILL.md +60 -79
  36. package/.agent/skills/agentic-workflows-2026/SKILL.md +92 -15
  37. package/.agent/skills/ai-app-hardening/SKILL.md +81 -15
  38. package/.agent/skills/ai-prompt-injection-defense/SKILL.md +75 -85
  39. package/.agent/skills/animation-on-scroll/SKILL.md +186 -47
  40. package/.agent/skills/animation-systems/SKILL.md +229 -35
  41. package/.agent/skills/antfu-conventions/SKILL.md +62 -23
  42. package/.agent/skills/api-patterns/SKILL.md +59 -79
  43. package/.agent/skills/api-security-auditor/SKILL.md +59 -81
  44. package/.agent/skills/app-builder/SKILL.md +59 -79
  45. package/.agent/skills/appflow-wireframe/SKILL.md +68 -83
  46. package/.agent/skills/apple-design/SKILL.md +65 -19
  47. package/.agent/skills/architecture/SKILL.md +59 -79
  48. package/.agent/skills/audit-and-fix/SKILL.md +62 -21
  49. package/.agent/skills/authentication-best-practices/SKILL.md +59 -81
  50. package/.agent/skills/backend-security-expert/SKILL.md +79 -82
  51. package/.agent/skills/baseline-ui/SKILL.md +65 -19
  52. package/.agent/skills/bash-linux/SKILL.md +59 -81
  53. package/.agent/skills/behavioral-modes/SKILL.md +60 -79
  54. package/.agent/skills/better-colors/SKILL.md +65 -19
  55. package/.agent/skills/better-typography/SKILL.md +70 -31
  56. package/.agent/skills/better-ui/SKILL.md +93 -18
  57. package/.agent/skills/bolder/SKILL.md +62 -21
  58. package/.agent/skills/brainstorming/SKILL.md +60 -78
  59. package/.agent/skills/browser-audit/SKILL.md +170 -0
  60. package/.agent/skills/browser-native-ai/SKILL.md +60 -41
  61. package/.agent/skills/build-primitive/SKILL.md +62 -21
  62. package/.agent/skills/building-native-ui/SKILL.md +59 -81
  63. package/.agent/skills/cicd-pro/SKILL.md +64 -31
  64. package/.agent/skills/clarify/SKILL.md +62 -21
  65. package/.agent/skills/clean-code/SKILL.md +68 -83
  66. package/.agent/skills/cloud-architect/SKILL.md +64 -31
  67. package/.agent/skills/cobejs/SKILL.md +62 -20
  68. package/.agent/skills/code-review-checklist/SKILL.md +59 -81
  69. package/.agent/skills/codebase-design/SKILL.md +74 -23
  70. package/.agent/skills/colorize/SKILL.md +62 -21
  71. package/.agent/skills/compact-landing/SKILL.md +62 -21
  72. package/.agent/skills/company-logos/SKILL.md +62 -21
  73. package/.agent/skills/config-validator/SKILL.md +59 -81
  74. package/.agent/skills/containerization-pro/SKILL.md +64 -31
  75. package/.agent/skills/context-engineering-pro/SKILL.md +81 -15
  76. package/.agent/skills/create-design-md/SKILL.md +65 -19
  77. package/.agent/skills/critique/SKILL.md +67 -19
  78. package/.agent/skills/csharp-developer/SKILL.md +59 -81
  79. package/.agent/skills/data-validation-schemas/SKILL.md +59 -81
  80. package/.agent/skills/database-design/SKILL.md +74 -84
  81. package/.agent/skills/delight/SKILL.md +62 -21
  82. package/.agent/skills/deployment-procedures/SKILL.md +59 -81
  83. package/.agent/skills/design-lab/SKILL.md +63 -21
  84. package/.agent/skills/devops-engineer/SKILL.md +59 -81
  85. package/.agent/skills/devops-incident-responder/SKILL.md +59 -81
  86. package/.agent/skills/diagnosing-bugs/SKILL.md +63 -27
  87. package/.agent/skills/distill/SKILL.md +62 -21
  88. package/.agent/skills/documentation-templates/SKILL.md +59 -81
  89. package/.agent/skills/domain-modeling/SKILL.md +62 -23
  90. package/.agent/skills/duckdb-analytical-sql/SKILL.md +80 -14
  91. package/.agent/skills/edge-ai-mobile/SKILL.md +80 -14
  92. package/.agent/skills/edge-computing/SKILL.md +59 -81
  93. package/.agent/skills/emil-design-eng/SKILL.md +64 -27
  94. package/.agent/skills/error-resilience/SKILL.md +78 -85
  95. package/.agent/skills/expo-router-v4/SKILL.md +79 -14
  96. package/.agent/skills/extract-design-system/SKILL.md +59 -81
  97. package/.agent/skills/fabel-protocol/SKILL.md +72 -15
  98. package/.agent/skills/fixing-accessibility/SKILL.md +65 -19
  99. package/.agent/skills/fixing-metadata/SKILL.md +62 -21
  100. package/.agent/skills/fixing-motion-performance/SKILL.md +65 -19
  101. package/.agent/skills/framer-motion-expert/SKILL.md +67 -77
  102. package/.agent/skills/frontend-design/SKILL.md +73 -15
  103. package/.agent/skills/frontend-security-expert/SKILL.md +59 -79
  104. package/.agent/skills/game-design-expert/SKILL.md +59 -81
  105. package/.agent/skills/game-engineering-expert/SKILL.md +59 -81
  106. package/.agent/skills/generative-ui-expert/SKILL.md +60 -41
  107. package/.agent/skills/geo-fundamentals/SKILL.md +59 -81
  108. package/.agent/skills/git-pro/SKILL.md +62 -33
  109. package/.agent/skills/github-operations/SKILL.md +59 -81
  110. package/.agent/skills/gpt-taste/SKILL.md +62 -21
  111. package/.agent/skills/gsap-core/SKILL.md +59 -89
  112. package/.agent/skills/gsap-frameworks/SKILL.md +59 -89
  113. package/.agent/skills/gsap-performance/SKILL.md +59 -87
  114. package/.agent/skills/gsap-plugins/SKILL.md +59 -87
  115. package/.agent/skills/gsap-react/SKILL.md +60 -32
  116. package/.agent/skills/gsap-scrolltrigger/SKILL.md +59 -89
  117. package/.agent/skills/gsap-timeline/SKILL.md +59 -87
  118. package/.agent/skills/gsap-utils/SKILL.md +59 -87
  119. package/.agent/skills/harden/SKILL.md +62 -21
  120. package/.agent/skills/harness-protocol/SKILL.md +60 -33
  121. package/.agent/skills/i18n-localization/SKILL.md +59 -81
  122. package/.agent/skills/impeccable/SKILL.md +62 -23
  123. package/.agent/skills/improve-codebase-architecture/SKILL.md +62 -22
  124. package/.agent/skills/improve-ui/SKILL.md +65 -19
  125. package/.agent/skills/intelligent-routing/SKILL.md +59 -33
  126. package/.agent/skills/knowledge-graph/SKILL.md +60 -33
  127. package/.agent/skills/landing-page/SKILL.md +62 -21
  128. package/.agent/skills/lint-and-validate/SKILL.md +59 -81
  129. package/.agent/skills/llm-engineering/SKILL.md +59 -81
  130. package/.agent/skills/local-first/SKILL.md +59 -81
  131. package/.agent/skills/local-first-architecture/SKILL.md +77 -20
  132. package/.agent/skills/lottie-animation/SKILL.md +62 -20
  133. package/.agent/skills/marquee-loop/SKILL.md +62 -21
  134. package/.agent/skills/masked-reveal/SKILL.md +245 -50
  135. package/.agent/skills/mcp-builder/SKILL.md +59 -81
  136. package/.agent/skills/micro-interaction/SKILL.md +254 -57
  137. package/.agent/skills/mobile-design/SKILL.md +59 -79
  138. package/.agent/skills/monorepo-management/SKILL.md +59 -81
  139. package/.agent/skills/morphing-icons/SKILL.md +365 -46
  140. package/.agent/skills/motion-engineering/SKILL.md +66 -21
  141. package/.agent/skills/nextjs-react-expert/SKILL.md +82 -84
  142. package/.agent/skills/nodejs-best-practices/SKILL.md +81 -80
  143. package/.agent/skills/observability/SKILL.md +59 -81
  144. package/.agent/skills/opentelemetry-observability/SKILL.md +80 -14
  145. package/.agent/skills/page-transition-animation/SKILL.md +62 -21
  146. package/.agent/skills/parallel-agents/SKILL.md +60 -81
  147. package/.agent/skills/performance-profiling/SKILL.md +60 -81
  148. package/.agent/skills/plan-writing/SKILL.md +83 -88
  149. package/.agent/skills/platform-engineer/SKILL.md +59 -81
  150. package/.agent/skills/platform-engineering-opentofu/SKILL.md +80 -15
  151. package/.agent/skills/playwright-ai-e2e/SKILL.md +81 -15
  152. package/.agent/skills/playwright-best-practices/SKILL.md +60 -81
  153. package/.agent/skills/polish/SKILL.md +62 -21
  154. package/.agent/skills/powershell-windows/SKILL.md +59 -81
  155. package/.agent/skills/pricing-page/SKILL.md +62 -21
  156. package/.agent/skills/product-aware-heuristics/SKILL.md +73 -16
  157. package/.agent/skills/progressive-blur/SKILL.md +62 -21
  158. package/.agent/skills/project-idioms/SKILL.md +58 -84
  159. package/.agent/skills/property-based-testing/SKILL.md +81 -15
  160. package/.agent/skills/python-patterns/SKILL.md +59 -81
  161. package/.agent/skills/python-pro/SKILL.md +81 -83
  162. package/.agent/skills/quieter/SKILL.md +62 -21
  163. package/.agent/skills/react-doctor/SKILL.md +62 -21
  164. package/.agent/skills/react-specialist/SKILL.md +73 -82
  165. package/.agent/skills/readme-builder/SKILL.md +59 -81
  166. package/.agent/skills/realtime-patterns/SKILL.md +59 -81
  167. package/.agent/skills/red-team-tactics/SKILL.md +59 -81
  168. package/.agent/skills/redesign-skill/SKILL.md +62 -21
  169. package/.agent/skills/review-animations/SKILL.md +64 -30
  170. package/.agent/skills/rust-pro/SKILL.md +77 -78
  171. package/.agent/skills/seo-fundamentals/SKILL.md +59 -81
  172. package/.agent/skills/server-management/SKILL.md +59 -81
  173. package/.agent/skills/shadcn-ui-expert/SKILL.md +59 -81
  174. package/.agent/skills/shape/SKILL.md +63 -21
  175. package/.agent/skills/skill-creator/SKILL.md +80 -88
  176. package/.agent/skills/soft-skill/SKILL.md +62 -21
  177. package/.agent/skills/sounds-on-the-web/SKILL.md +62 -21
  178. package/.agent/skills/sql-pro/SKILL.md +93 -80
  179. package/.agent/skills/supabase-postgres-best-practices/SKILL.md +59 -81
  180. package/.agent/skills/svg-animation/SKILL.md +368 -46
  181. package/.agent/skills/swiftui-expert/SKILL.md +59 -81
  182. package/.agent/skills/swiss-design/SKILL.md +62 -21
  183. package/.agent/skills/system-design-pro/SKILL.md +64 -29
  184. package/.agent/skills/systematic-debugging/SKILL.md +70 -82
  185. package/.agent/skills/systematic-debugging/condition-based-waiting.md +115 -0
  186. package/.agent/skills/systematic-debugging/defense-in-depth.md +122 -0
  187. package/.agent/skills/systematic-debugging/root-cause-tracing.md +169 -0
  188. package/.agent/skills/tailwind-patterns/SKILL.md +59 -81
  189. package/.agent/skills/taste-skill/SKILL.md +62 -21
  190. package/.agent/skills/tdd-workflow/SKILL.md +107 -26
  191. package/.agent/skills/test-result-analyzer/SKILL.md +59 -82
  192. package/.agent/skills/testing-patterns/SKILL.md +60 -81
  193. package/.agent/skills/thermo-nuclear-code-quality-review/SKILL.md +62 -23
  194. package/.agent/skills/thinking-protocol/SKILL.md +73 -18
  195. package/.agent/skills/to-spring-or-not-to-spring/SKILL.md +62 -20
  196. package/.agent/skills/transitions-dev/SKILL.md +62 -20
  197. package/.agent/skills/trend-researcher/SKILL.md +58 -82
  198. package/.agent/skills/typescript-advanced/SKILL.md +69 -85
  199. package/.agent/skills/typeset/SKILL.md +62 -21
  200. package/.agent/skills/ui-reasoning-engine/SKILL.md +73 -16
  201. package/.agent/skills/ui-skill-packs/SKILL.md +69 -19
  202. package/.agent/skills/ui-skills-root/SKILL.md +65 -19
  203. package/.agent/skills/ui-ux-pro-max/SKILL.md +81 -15
  204. package/.agent/skills/ui-ux-researcher/SKILL.md +58 -82
  205. package/.agent/skills/vector-search-pgvector/SKILL.md +80 -14
  206. package/.agent/skills/verification-before-completion/SKILL.md +178 -0
  207. package/.agent/skills/vue-expert/SKILL.md +59 -77
  208. package/.agent/skills/vulnerability-scanner/SKILL.md +59 -79
  209. package/.agent/skills/web-accessibility-auditor/SKILL.md +59 -81
  210. package/.agent/skills/web-design-guidelines/SKILL.md +73 -15
  211. package/.agent/skills/web-quality-audit/SKILL.md +62 -21
  212. package/.agent/skills/webapp-testing/SKILL.md +60 -81
  213. package/.agent/skills/webgpu-performance/SKILL.md +60 -41
  214. package/.agent/skills/whimsy-injector/SKILL.md +59 -81
  215. package/.agent/skills/workflow-optimizer/SKILL.md +59 -80
  216. package/.agent/skills/zero-trust-passkeys/SKILL.md +80 -14
  217. package/.agent/templates/DESIGN.md +680 -160
  218. package/.agent/templates/sdd/implementer-prompt.md +62 -0
  219. package/.agent/templates/sdd/re-review-prompt.md +36 -0
  220. package/.agent/templates/sdd/task-reviewer-prompt.md +78 -0
  221. package/.agent/workflows/acf.md +4 -0
  222. package/.agent/workflows/api-tester.md +5 -0
  223. package/.agent/workflows/audit-live.md +52 -0
  224. package/.agent/workflows/audit.md +5 -0
  225. package/.agent/workflows/brainstorm.md +17 -1
  226. package/.agent/workflows/changelog.md +5 -0
  227. package/.agent/workflows/compare-web.md +35 -0
  228. package/.agent/workflows/context.md +100 -0
  229. package/.agent/workflows/contract.md +19 -0
  230. package/.agent/workflows/create.md +6 -1
  231. package/.agent/workflows/debug.md +5 -0
  232. package/.agent/workflows/deploy.md +6 -1
  233. package/.agent/workflows/enhance.md +6 -1
  234. package/.agent/workflows/fix-ci.md +5 -0
  235. package/.agent/workflows/fix.md +5 -0
  236. package/.agent/workflows/generate.md +5 -0
  237. package/.agent/workflows/marathon.md +6 -1
  238. package/.agent/workflows/migrate.md +5 -0
  239. package/.agent/workflows/minimal.md +4 -0
  240. package/.agent/workflows/orchestrate.md +6 -1
  241. package/.agent/workflows/performance-benchmarker.md +6 -1
  242. package/.agent/workflows/pipeline.md +5 -0
  243. package/.agent/workflows/plan.md +7 -2
  244. package/.agent/workflows/preview.md +6 -1
  245. package/.agent/workflows/refactor.md +6 -0
  246. package/.agent/workflows/review-ai.md +5 -0
  247. package/.agent/workflows/review.md +5 -0
  248. package/.agent/workflows/sdd.md +122 -0
  249. package/.agent/workflows/session.md +5 -0
  250. package/.agent/workflows/skill-enhancement-engine.md +88 -0
  251. package/.agent/workflows/status.md +4 -0
  252. package/.agent/workflows/super-prompt.md +103 -19
  253. package/.agent/workflows/swarm.md +6 -1
  254. package/.agent/workflows/test.md +6 -1
  255. package/.agent/workflows/tribunal-backend.md +5 -0
  256. package/.agent/workflows/tribunal-cicd.md +5 -0
  257. package/.agent/workflows/tribunal-database.md +5 -0
  258. package/.agent/workflows/tribunal-full.md +8 -0
  259. package/.agent/workflows/tribunal-mobile.md +5 -0
  260. package/.agent/workflows/tribunal-performance.md +5 -0
  261. package/.agent/workflows/tribunal-speed.md +5 -0
  262. package/.agent/workflows/tribunal-ui.md +7 -0
  263. package/.agents/plugins/marketplace.json +20 -0
  264. package/.agents/skills/12-principles-of-animation/SKILL.md +126 -0
  265. package/.agents/skills/60fps-animation/SKILL.md +164 -0
  266. package/.agents/skills/accessible-animation/SKILL.md +266 -0
  267. package/.agents/skills/adapt/SKILL.md +131 -0
  268. package/.agents/skills/advanced-rag-pipelines/SKILL.md +169 -0
  269. package/.agents/skills/agent-organizer/SKILL.md +192 -0
  270. package/.agents/skills/agentic-patterns/SKILL.md +356 -0
  271. package/.agents/skills/agentic-workflows-2026/SKILL.md +157 -0
  272. package/.agents/skills/ai-app-hardening/SKILL.md +125 -0
  273. package/.agents/skills/ai-prompt-injection-defense/SKILL.md +237 -0
  274. package/.agents/skills/animation-on-scroll/SKILL.md +267 -0
  275. package/.agents/skills/animation-systems/SKILL.md +273 -0
  276. package/.agents/skills/antfu-conventions/SKILL.md +129 -0
  277. package/.agents/skills/api-patterns/SKILL.md +293 -0
  278. package/.agents/skills/api-patterns/scripts/api_validator.py +211 -0
  279. package/.agents/skills/api-security-auditor/SKILL.md +230 -0
  280. package/.agents/skills/app-builder/SKILL.md +610 -0
  281. package/.agents/skills/app-builder/templates/SKILL.md +108 -0
  282. package/.agents/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -0
  283. package/.agents/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -0
  284. package/.agents/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -0
  285. package/.agents/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -0
  286. package/.agents/skills/app-builder/templates/express-api/TEMPLATE.md +83 -0
  287. package/.agents/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -0
  288. package/.agents/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -0
  289. package/.agents/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +126 -0
  290. package/.agents/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +127 -0
  291. package/.agents/skills/app-builder/templates/nextjs-static/TEMPLATE.md +172 -0
  292. package/.agents/skills/app-builder/templates/nuxt-app/TEMPLATE.md +139 -0
  293. package/.agents/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -0
  294. package/.agents/skills/app-builder/templates/react-native-app/TEMPLATE.md +122 -0
  295. package/.agents/skills/appflow-wireframe/SKILL.md +173 -0
  296. package/.agents/skills/apple-design/SKILL.md +164 -0
  297. package/.agents/skills/architecture/SKILL.md +263 -0
  298. package/.agents/skills/audit-and-fix/SKILL.md +136 -0
  299. package/.agents/skills/authentication-best-practices/SKILL.md +232 -0
  300. package/.agents/skills/backend-security-expert/SKILL.md +148 -0
  301. package/.agents/skills/baseline-ui/SKILL.md +130 -0
  302. package/.agents/skills/bash-linux/SKILL.md +214 -0
  303. package/.agents/skills/behavioral-modes/SKILL.md +275 -0
  304. package/.agents/skills/better-colors/SKILL.md +191 -0
  305. package/.agents/skills/better-typography/SKILL.md +164 -0
  306. package/.agents/skills/better-ui/SKILL.md +193 -0
  307. package/.agents/skills/bolder/SKILL.md +124 -0
  308. package/.agents/skills/brainstorming/SKILL.md +534 -0
  309. package/.agents/skills/browser-audit/SKILL.md +170 -0
  310. package/.agents/skills/browser-native-ai/SKILL.md +147 -0
  311. package/.agents/skills/build-primitive/SKILL.md +125 -0
  312. package/.agents/skills/building-native-ui/SKILL.md +237 -0
  313. package/.agents/skills/cicd-pro/SKILL.md +487 -0
  314. package/.agents/skills/clarify/SKILL.md +130 -0
  315. package/.agents/skills/clean-code/SKILL.md +442 -0
  316. package/.agents/skills/cloud-architect/SKILL.md +484 -0
  317. package/.agents/skills/cobejs/SKILL.md +145 -0
  318. package/.agents/skills/code-review-checklist/SKILL.md +238 -0
  319. package/.agents/skills/codebase-design/SKILL.md +151 -0
  320. package/.agents/skills/colorize/SKILL.md +132 -0
  321. package/.agents/skills/compact-landing/SKILL.md +125 -0
  322. package/.agents/skills/company-logos/SKILL.md +129 -0
  323. package/.agents/skills/config-validator/SKILL.md +200 -0
  324. package/.agents/skills/containerization-pro/SKILL.md +497 -0
  325. package/.agents/skills/context-engineering-pro/SKILL.md +136 -0
  326. package/.agents/skills/create-design-md/SKILL.md +167 -0
  327. package/.agents/skills/critique/SKILL.md +154 -0
  328. package/.agents/skills/csharp-developer/SKILL.md +553 -0
  329. package/.agents/skills/data-validation-schemas/SKILL.md +372 -0
  330. package/.agents/skills/database-design/SKILL.md +294 -0
  331. package/.agents/skills/database-design/scripts/schema_validator.py +172 -0
  332. package/.agents/skills/delight/SKILL.md +121 -0
  333. package/.agents/skills/deployment-procedures/SKILL.md +207 -0
  334. package/.agents/skills/design-lab/SKILL.md +117 -0
  335. package/.agents/skills/devops-engineer/SKILL.md +380 -0
  336. package/.agents/skills/devops-incident-responder/SKILL.md +178 -0
  337. package/.agents/skills/diagnosing-bugs/SKILL.md +247 -0
  338. package/.agents/skills/distill/SKILL.md +120 -0
  339. package/.agents/skills/documentation-templates/SKILL.md +326 -0
  340. package/.agents/skills/domain-modeling/SKILL.md +136 -0
  341. package/.agents/skills/duckdb-analytical-sql/SKILL.md +125 -0
  342. package/.agents/skills/edge-ai-mobile/SKILL.md +116 -0
  343. package/.agents/skills/edge-computing/SKILL.md +218 -0
  344. package/.agents/skills/emil-design-eng/SKILL.md +209 -0
  345. package/.agents/skills/error-resilience/SKILL.md +478 -0
  346. package/.agents/skills/expo-router-v4/SKILL.md +146 -0
  347. package/.agents/skills/extract-design-system/SKILL.md +195 -0
  348. package/.agents/skills/fabel-protocol/SKILL.md +352 -0
  349. package/.agents/skills/fixing-accessibility/SKILL.md +162 -0
  350. package/.agents/skills/fixing-metadata/SKILL.md +158 -0
  351. package/.agents/skills/fixing-motion-performance/SKILL.md +153 -0
  352. package/.agents/skills/framer-motion-expert/SKILL.md +312 -0
  353. package/.agents/skills/frontend-design/SKILL.md +178 -0
  354. package/.agents/skills/frontend-design/scripts/accessibility_checker.py +183 -0
  355. package/.agents/skills/frontend-design/scripts/ux_audit.py +722 -0
  356. package/.agents/skills/frontend-security-expert/SKILL.md +131 -0
  357. package/.agents/skills/game-design-expert/SKILL.md +167 -0
  358. package/.agents/skills/game-engineering-expert/SKILL.md +183 -0
  359. package/.agents/skills/generative-ui-expert/SKILL.md +175 -0
  360. package/.agents/skills/geo-fundamentals/SKILL.md +183 -0
  361. package/.agents/skills/geo-fundamentals/scripts/geo_checker.py +289 -0
  362. package/.agents/skills/git-pro/SKILL.md +476 -0
  363. package/.agents/skills/github-operations/SKILL.md +370 -0
  364. package/.agents/skills/gpt-taste/SKILL.md +125 -0
  365. package/.agents/skills/gsap-core/SKILL.md +352 -0
  366. package/.agents/skills/gsap-frameworks/SKILL.md +243 -0
  367. package/.agents/skills/gsap-performance/SKILL.md +169 -0
  368. package/.agents/skills/gsap-plugins/SKILL.md +516 -0
  369. package/.agents/skills/gsap-react/SKILL.md +288 -0
  370. package/.agents/skills/gsap-scrolltrigger/SKILL.md +387 -0
  371. package/.agents/skills/gsap-timeline/SKILL.md +197 -0
  372. package/.agents/skills/gsap-utils/SKILL.md +374 -0
  373. package/.agents/skills/harden/SKILL.md +130 -0
  374. package/.agents/skills/harness-protocol/SKILL.md +115 -0
  375. package/.agents/skills/i18n-localization/SKILL.md +209 -0
  376. package/.agents/skills/i18n-localization/scripts/i18n_checker.py +241 -0
  377. package/.agents/skills/impeccable/SKILL.md +127 -0
  378. package/.agents/skills/improve-codebase-architecture/SKILL.md +123 -0
  379. package/.agents/skills/improve-ui/SKILL.md +145 -0
  380. package/.agents/skills/intelligent-routing/SKILL.md +283 -0
  381. package/.agents/skills/knowledge-graph/SKILL.md +146 -0
  382. package/.agents/skills/landing-page/SKILL.md +140 -0
  383. package/.agents/skills/lint-and-validate/SKILL.md +299 -0
  384. package/.agents/skills/lint-and-validate/scripts/lint_runner.py +184 -0
  385. package/.agents/skills/lint-and-validate/scripts/type_coverage.py +173 -0
  386. package/.agents/skills/llm-engineering/SKILL.md +435 -0
  387. package/.agents/skills/local-first/SKILL.md +213 -0
  388. package/.agents/skills/local-first-architecture/SKILL.md +137 -0
  389. package/.agents/skills/lottie-animation/SKILL.md +137 -0
  390. package/.agents/skills/marquee-loop/SKILL.md +147 -0
  391. package/.agents/skills/masked-reveal/SKILL.md +305 -0
  392. package/.agents/skills/mcp-builder/SKILL.md +180 -0
  393. package/.agents/skills/micro-interaction/SKILL.md +321 -0
  394. package/.agents/skills/mobile-design/SKILL.md +320 -0
  395. package/.agents/skills/mobile-design/scripts/mobile_audit.py +670 -0
  396. package/.agents/skills/monorepo-management/SKILL.md +370 -0
  397. package/.agents/skills/morphing-icons/SKILL.md +423 -0
  398. package/.agents/skills/motion-engineering/SKILL.md +272 -0
  399. package/.agents/skills/nextjs-react-expert/SKILL.md +293 -0
  400. package/.agents/skills/nextjs-react-expert/scripts/convert_rules.py +222 -0
  401. package/.agents/skills/nextjs-react-expert/scripts/react_performance_checker.py +252 -0
  402. package/.agents/skills/nodejs-best-practices/SKILL.md +617 -0
  403. package/.agents/skills/observability/SKILL.md +378 -0
  404. package/.agents/skills/opentelemetry-observability/SKILL.md +125 -0
  405. package/.agents/skills/page-transition-animation/SKILL.md +161 -0
  406. package/.agents/skills/parallel-agents/SKILL.md +185 -0
  407. package/.agents/skills/performance-profiling/SKILL.md +305 -0
  408. package/.agents/skills/performance-profiling/scripts/lighthouse_audit.py +76 -0
  409. package/.agents/skills/plan-writing/SKILL.md +202 -0
  410. package/.agents/skills/platform-engineer/SKILL.md +183 -0
  411. package/.agents/skills/platform-engineering-opentofu/SKILL.md +133 -0
  412. package/.agents/skills/playwright-ai-e2e/SKILL.md +126 -0
  413. package/.agents/skills/playwright-best-practices/SKILL.md +224 -0
  414. package/.agents/skills/polish/SKILL.md +114 -0
  415. package/.agents/skills/powershell-windows/SKILL.md +197 -0
  416. package/.agents/skills/pricing-page/SKILL.md +123 -0
  417. package/.agents/skills/product-aware-heuristics/SKILL.md +465 -0
  418. package/.agents/skills/progressive-blur/SKILL.md +155 -0
  419. package/.agents/skills/project-idioms/SKILL.md +166 -0
  420. package/.agents/skills/property-based-testing/SKILL.md +124 -0
  421. package/.agents/skills/python-patterns/SKILL.md +295 -0
  422. package/.agents/skills/python-pro/SKILL.md +380 -0
  423. package/.agents/skills/quieter/SKILL.md +124 -0
  424. package/.agents/skills/react-doctor/SKILL.md +126 -0
  425. package/.agents/skills/react-specialist/SKILL.md +355 -0
  426. package/.agents/skills/readme-builder/SKILL.md +345 -0
  427. package/.agents/skills/realtime-patterns/SKILL.md +358 -0
  428. package/.agents/skills/red-team-tactics/SKILL.md +266 -0
  429. package/.agents/skills/redesign-skill/SKILL.md +121 -0
  430. package/.agents/skills/review-animations/SKILL.md +120 -0
  431. package/.agents/skills/review-animations/STANDARDS.md +87 -0
  432. package/.agents/skills/rust-pro/SKILL.md +727 -0
  433. package/.agents/skills/seo-fundamentals/SKILL.md +214 -0
  434. package/.agents/skills/seo-fundamentals/scripts/seo_checker.py +219 -0
  435. package/.agents/skills/server-management/SKILL.md +253 -0
  436. package/.agents/skills/shadcn-ui-expert/SKILL.md +271 -0
  437. package/.agents/skills/shape/SKILL.md +131 -0
  438. package/.agents/skills/skill-creator/SKILL.md +136 -0
  439. package/.agents/skills/soft-skill/SKILL.md +128 -0
  440. package/.agents/skills/sounds-on-the-web/SKILL.md +151 -0
  441. package/.agents/skills/sql-pro/SKILL.md +699 -0
  442. package/.agents/skills/supabase-postgres-best-practices/SKILL.md +132 -0
  443. package/.agents/skills/svg-animation/SKILL.md +431 -0
  444. package/.agents/skills/swiftui-expert/SKILL.md +239 -0
  445. package/.agents/skills/swiss-design/SKILL.md +119 -0
  446. package/.agents/skills/system-design-pro/SKILL.md +393 -0
  447. package/.agents/skills/systematic-debugging/SKILL.md +198 -0
  448. package/.agents/skills/systematic-debugging/condition-based-waiting.md +115 -0
  449. package/.agents/skills/systematic-debugging/defense-in-depth.md +122 -0
  450. package/.agents/skills/systematic-debugging/root-cause-tracing.md +169 -0
  451. package/.agents/skills/tailwind-patterns/SKILL.md +658 -0
  452. package/.agents/skills/taste-skill/SKILL.md +127 -0
  453. package/.agents/skills/tdd-workflow/SKILL.md +179 -0
  454. package/.agents/skills/test-result-analyzer/SKILL.md +345 -0
  455. package/.agents/skills/testing-patterns/SKILL.md +609 -0
  456. package/.agents/skills/testing-patterns/scripts/test_runner.py +219 -0
  457. package/.agents/skills/thermo-nuclear-code-quality-review/SKILL.md +137 -0
  458. package/.agents/skills/thinking-protocol/SKILL.md +97 -0
  459. package/.agents/skills/to-spring-or-not-to-spring/SKILL.md +118 -0
  460. package/.agents/skills/transitions-dev/SKILL.md +165 -0
  461. package/.agents/skills/trend-researcher/SKILL.md +273 -0
  462. package/.agents/skills/typescript-advanced/SKILL.md +381 -0
  463. package/.agents/skills/typeset/SKILL.md +135 -0
  464. package/.agents/skills/ui-reasoning-engine/SKILL.md +230 -0
  465. package/.agents/skills/ui-skill-packs/SKILL.md +132 -0
  466. package/.agents/skills/ui-skills-root/SKILL.md +144 -0
  467. package/.agents/skills/ui-ux-pro-max/SKILL.md +185 -0
  468. package/.agents/skills/ui-ux-researcher/SKILL.md +274 -0
  469. package/.agents/skills/vector-search-pgvector/SKILL.md +144 -0
  470. package/.agents/skills/verification-before-completion/SKILL.md +178 -0
  471. package/.agents/skills/vue-expert/SKILL.md +334 -0
  472. package/.agents/skills/vulnerability-scanner/SKILL.md +453 -0
  473. package/.agents/skills/vulnerability-scanner/scripts/security_scan.py +458 -0
  474. package/.agents/skills/web-accessibility-auditor/SKILL.md +254 -0
  475. package/.agents/skills/web-design-guidelines/SKILL.md +124 -0
  476. package/.agents/skills/web-quality-audit/SKILL.md +122 -0
  477. package/.agents/skills/webapp-testing/SKILL.md +203 -0
  478. package/.agents/skills/webapp-testing/scripts/playwright_runner.py +173 -0
  479. package/.agents/skills/webgpu-performance/SKILL.md +163 -0
  480. package/.agents/skills/whimsy-injector/SKILL.md +380 -0
  481. package/.agents/skills/workflow-optimizer/SKILL.md +263 -0
  482. package/.agents/skills/zero-trust-passkeys/SKILL.md +156 -0
  483. package/.claude-plugin/marketplace.json +14 -0
  484. package/.claude-plugin/plugin.json +26 -0
  485. package/.codex-plugin/plugin.json +45 -0
  486. package/.cursor-plugin/plugin.json +26 -0
  487. package/.devin-plugin/plugin.json +14 -0
  488. package/.hermes-plugin/__init__.py +102 -0
  489. package/.hermes-plugin/plugin.yaml +6 -0
  490. package/.kimi-plugin/plugin.json +38 -0
  491. package/.opencode/INSTALL.md +41 -0
  492. package/.opencode/plugins/tribunal.js +101 -0
  493. package/.opencode/rules.md +258 -0
  494. package/.pi/extensions/tribunal.ts +133 -0
  495. package/AGENTS.md +91 -0
  496. package/CLAUDE.md +442 -0
  497. package/CONTRIBUTING.md +1 -1
  498. package/README.md +273 -251
  499. package/bin/adapter-install.js +40 -16
  500. package/bin/mcp-server.js +426 -0
  501. package/bin/proxy-server.js +18 -9
  502. package/bin/spawn-agent.js +9 -3
  503. package/bin/wrapper.js +20 -4
  504. package/dist/browser/audit.js +229 -0
  505. package/dist/browser/case_bridge.js +189 -0
  506. package/dist/browser/cdp.js +513 -0
  507. package/dist/browser/compare.js +110 -0
  508. package/dist/browser/discovery.js +140 -0
  509. package/dist/browser/idpi.js +142 -0
  510. package/dist/browser/index.js +89 -0
  511. package/dist/browser/launcher.js +154 -0
  512. package/dist/browser/sentinel.js +202 -0
  513. package/dist/browser/synapse.js +251 -0
  514. package/dist/browser/trimmer.js +210 -0
  515. package/dist/cli.js +377 -355
  516. package/dist/commands/audit-web.js +112 -0
  517. package/dist/commands/browse.js +56 -0
  518. package/dist/commands/compare-web.js +61 -0
  519. package/dist/commands/deconstruct.js +58 -0
  520. package/dist/commands/heal.js +99 -0
  521. package/dist/commands/init.js +10 -1
  522. package/dist/commands/sdd.js +229 -0
  523. package/dist/commands/uninstall.js +12 -0
  524. package/dist/esm/index.mjs +142 -142
  525. package/dist/index.d.ts +349 -343
  526. package/gemini-extension.json +6 -0
  527. package/hooks/hooks-cursor.json +10 -0
  528. package/hooks/hooks.json +10 -0
  529. package/hooks/session-start.js +77 -0
  530. package/marketplace.json +14 -0
  531. package/package.json +176 -146
  532. package/plugin.json +26 -0
  533. package/scripts/audit_skill_sdo.js +87 -0
  534. package/scripts/clean-pycache.js +42 -0
  535. package/scripts/context_compiler.js +944 -0
  536. package/scripts/modernize_skills.js +254 -0
  537. package/scripts/package-cores.js +113 -0
  538. package/scripts/skill_enhancement_engine.js +473 -0
  539. package/scripts/sync-skills.js +61 -0
  540. package/skills/12-principles-of-animation/SKILL.md +126 -0
  541. package/skills/60fps-animation/SKILL.md +164 -0
  542. package/skills/accessible-animation/SKILL.md +266 -0
  543. package/skills/adapt/SKILL.md +131 -0
  544. package/skills/advanced-rag-pipelines/SKILL.md +169 -0
  545. package/skills/agent-organizer/SKILL.md +192 -0
  546. package/skills/agentic-patterns/SKILL.md +356 -0
  547. package/skills/agentic-workflows-2026/SKILL.md +157 -0
  548. package/skills/ai-app-hardening/SKILL.md +125 -0
  549. package/skills/ai-prompt-injection-defense/SKILL.md +237 -0
  550. package/skills/animation-on-scroll/SKILL.md +267 -0
  551. package/skills/animation-systems/SKILL.md +273 -0
  552. package/skills/antfu-conventions/SKILL.md +129 -0
  553. package/skills/api-patterns/SKILL.md +293 -0
  554. package/skills/api-patterns/scripts/api_validator.py +211 -0
  555. package/skills/api-security-auditor/SKILL.md +230 -0
  556. package/skills/app-builder/SKILL.md +610 -0
  557. package/skills/app-builder/templates/SKILL.md +108 -0
  558. package/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -0
  559. package/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -0
  560. package/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -0
  561. package/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -0
  562. package/skills/app-builder/templates/express-api/TEMPLATE.md +83 -0
  563. package/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -0
  564. package/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -0
  565. package/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +126 -0
  566. package/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +127 -0
  567. package/skills/app-builder/templates/nextjs-static/TEMPLATE.md +172 -0
  568. package/skills/app-builder/templates/nuxt-app/TEMPLATE.md +139 -0
  569. package/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -0
  570. package/skills/app-builder/templates/react-native-app/TEMPLATE.md +122 -0
  571. package/skills/appflow-wireframe/SKILL.md +173 -0
  572. package/skills/apple-design/SKILL.md +164 -0
  573. package/skills/architecture/SKILL.md +263 -0
  574. package/skills/audit-and-fix/SKILL.md +136 -0
  575. package/skills/authentication-best-practices/SKILL.md +232 -0
  576. package/skills/backend-security-expert/SKILL.md +148 -0
  577. package/skills/baseline-ui/SKILL.md +130 -0
  578. package/skills/bash-linux/SKILL.md +214 -0
  579. package/skills/behavioral-modes/SKILL.md +275 -0
  580. package/skills/better-colors/SKILL.md +191 -0
  581. package/skills/better-typography/SKILL.md +164 -0
  582. package/skills/better-ui/SKILL.md +193 -0
  583. package/skills/bolder/SKILL.md +124 -0
  584. package/skills/brainstorming/SKILL.md +534 -0
  585. package/skills/browser-audit/SKILL.md +170 -0
  586. package/skills/browser-native-ai/SKILL.md +147 -0
  587. package/skills/build-primitive/SKILL.md +125 -0
  588. package/skills/building-native-ui/SKILL.md +237 -0
  589. package/skills/cicd-pro/SKILL.md +487 -0
  590. package/skills/clarify/SKILL.md +130 -0
  591. package/skills/clean-code/SKILL.md +442 -0
  592. package/skills/cloud-architect/SKILL.md +484 -0
  593. package/skills/cobejs/SKILL.md +145 -0
  594. package/skills/code-review-checklist/SKILL.md +238 -0
  595. package/skills/codebase-design/SKILL.md +151 -0
  596. package/skills/colorize/SKILL.md +132 -0
  597. package/skills/compact-landing/SKILL.md +125 -0
  598. package/skills/company-logos/SKILL.md +129 -0
  599. package/skills/config-validator/SKILL.md +200 -0
  600. package/skills/containerization-pro/SKILL.md +497 -0
  601. package/skills/context-engineering-pro/SKILL.md +136 -0
  602. package/skills/create-design-md/SKILL.md +167 -0
  603. package/skills/critique/SKILL.md +154 -0
  604. package/skills/csharp-developer/SKILL.md +553 -0
  605. package/skills/data-validation-schemas/SKILL.md +372 -0
  606. package/skills/database-design/SKILL.md +294 -0
  607. package/skills/database-design/scripts/schema_validator.py +172 -0
  608. package/skills/delight/SKILL.md +121 -0
  609. package/skills/deployment-procedures/SKILL.md +207 -0
  610. package/skills/design-lab/SKILL.md +117 -0
  611. package/skills/devops-engineer/SKILL.md +380 -0
  612. package/skills/devops-incident-responder/SKILL.md +178 -0
  613. package/skills/diagnosing-bugs/SKILL.md +247 -0
  614. package/skills/distill/SKILL.md +120 -0
  615. package/skills/documentation-templates/SKILL.md +326 -0
  616. package/skills/domain-modeling/SKILL.md +136 -0
  617. package/skills/duckdb-analytical-sql/SKILL.md +125 -0
  618. package/skills/edge-ai-mobile/SKILL.md +116 -0
  619. package/skills/edge-computing/SKILL.md +218 -0
  620. package/skills/emil-design-eng/SKILL.md +209 -0
  621. package/skills/error-resilience/SKILL.md +478 -0
  622. package/skills/expo-router-v4/SKILL.md +146 -0
  623. package/skills/extract-design-system/SKILL.md +195 -0
  624. package/skills/fabel-protocol/SKILL.md +352 -0
  625. package/skills/fixing-accessibility/SKILL.md +162 -0
  626. package/skills/fixing-metadata/SKILL.md +158 -0
  627. package/skills/fixing-motion-performance/SKILL.md +153 -0
  628. package/skills/framer-motion-expert/SKILL.md +312 -0
  629. package/skills/frontend-design/SKILL.md +178 -0
  630. package/skills/frontend-design/scripts/accessibility_checker.py +183 -0
  631. package/skills/frontend-design/scripts/ux_audit.py +722 -0
  632. package/skills/frontend-security-expert/SKILL.md +131 -0
  633. package/skills/game-design-expert/SKILL.md +167 -0
  634. package/skills/game-engineering-expert/SKILL.md +183 -0
  635. package/skills/generative-ui-expert/SKILL.md +175 -0
  636. package/skills/geo-fundamentals/SKILL.md +183 -0
  637. package/skills/geo-fundamentals/scripts/geo_checker.py +289 -0
  638. package/skills/git-pro/SKILL.md +476 -0
  639. package/skills/github-operations/SKILL.md +370 -0
  640. package/skills/gpt-taste/SKILL.md +125 -0
  641. package/skills/gsap-core/SKILL.md +352 -0
  642. package/skills/gsap-frameworks/SKILL.md +243 -0
  643. package/skills/gsap-performance/SKILL.md +169 -0
  644. package/skills/gsap-plugins/SKILL.md +516 -0
  645. package/skills/gsap-react/SKILL.md +288 -0
  646. package/skills/gsap-scrolltrigger/SKILL.md +387 -0
  647. package/skills/gsap-timeline/SKILL.md +197 -0
  648. package/skills/gsap-utils/SKILL.md +374 -0
  649. package/skills/harden/SKILL.md +130 -0
  650. package/skills/harness-protocol/SKILL.md +115 -0
  651. package/skills/i18n-localization/SKILL.md +209 -0
  652. package/skills/i18n-localization/scripts/i18n_checker.py +241 -0
  653. package/skills/impeccable/SKILL.md +127 -0
  654. package/skills/improve-codebase-architecture/SKILL.md +123 -0
  655. package/skills/improve-ui/SKILL.md +145 -0
  656. package/skills/intelligent-routing/SKILL.md +283 -0
  657. package/skills/knowledge-graph/SKILL.md +146 -0
  658. package/skills/landing-page/SKILL.md +140 -0
  659. package/skills/lint-and-validate/SKILL.md +299 -0
  660. package/skills/lint-and-validate/scripts/lint_runner.py +184 -0
  661. package/skills/lint-and-validate/scripts/type_coverage.py +173 -0
  662. package/skills/llm-engineering/SKILL.md +435 -0
  663. package/skills/local-first/SKILL.md +213 -0
  664. package/skills/local-first-architecture/SKILL.md +137 -0
  665. package/skills/lottie-animation/SKILL.md +137 -0
  666. package/skills/marquee-loop/SKILL.md +147 -0
  667. package/skills/masked-reveal/SKILL.md +305 -0
  668. package/skills/mcp-builder/SKILL.md +180 -0
  669. package/skills/micro-interaction/SKILL.md +321 -0
  670. package/skills/mobile-design/SKILL.md +320 -0
  671. package/skills/mobile-design/scripts/mobile_audit.py +670 -0
  672. package/skills/monorepo-management/SKILL.md +370 -0
  673. package/skills/morphing-icons/SKILL.md +423 -0
  674. package/skills/motion-engineering/SKILL.md +272 -0
  675. package/skills/nextjs-react-expert/SKILL.md +293 -0
  676. package/skills/nextjs-react-expert/scripts/convert_rules.py +222 -0
  677. package/skills/nextjs-react-expert/scripts/react_performance_checker.py +252 -0
  678. package/skills/nodejs-best-practices/SKILL.md +617 -0
  679. package/skills/observability/SKILL.md +378 -0
  680. package/skills/opentelemetry-observability/SKILL.md +125 -0
  681. package/skills/page-transition-animation/SKILL.md +161 -0
  682. package/skills/parallel-agents/SKILL.md +185 -0
  683. package/skills/performance-profiling/SKILL.md +305 -0
  684. package/skills/performance-profiling/scripts/lighthouse_audit.py +76 -0
  685. package/skills/plan-writing/SKILL.md +202 -0
  686. package/skills/platform-engineer/SKILL.md +183 -0
  687. package/skills/platform-engineering-opentofu/SKILL.md +133 -0
  688. package/skills/playwright-ai-e2e/SKILL.md +126 -0
  689. package/skills/playwright-best-practices/SKILL.md +224 -0
  690. package/skills/polish/SKILL.md +114 -0
  691. package/skills/powershell-windows/SKILL.md +197 -0
  692. package/skills/pricing-page/SKILL.md +123 -0
  693. package/skills/product-aware-heuristics/SKILL.md +465 -0
  694. package/skills/progressive-blur/SKILL.md +155 -0
  695. package/skills/project-idioms/SKILL.md +166 -0
  696. package/skills/property-based-testing/SKILL.md +124 -0
  697. package/skills/python-patterns/SKILL.md +295 -0
  698. package/skills/python-pro/SKILL.md +380 -0
  699. package/skills/quieter/SKILL.md +124 -0
  700. package/skills/react-doctor/SKILL.md +126 -0
  701. package/skills/react-specialist/SKILL.md +355 -0
  702. package/skills/readme-builder/SKILL.md +345 -0
  703. package/skills/realtime-patterns/SKILL.md +358 -0
  704. package/skills/red-team-tactics/SKILL.md +266 -0
  705. package/skills/redesign-skill/SKILL.md +121 -0
  706. package/skills/review-animations/SKILL.md +120 -0
  707. package/skills/review-animations/STANDARDS.md +87 -0
  708. package/skills/rust-pro/SKILL.md +727 -0
  709. package/skills/seo-fundamentals/SKILL.md +214 -0
  710. package/skills/seo-fundamentals/scripts/seo_checker.py +219 -0
  711. package/skills/server-management/SKILL.md +253 -0
  712. package/skills/shadcn-ui-expert/SKILL.md +271 -0
  713. package/skills/shape/SKILL.md +131 -0
  714. package/skills/skill-creator/SKILL.md +136 -0
  715. package/skills/soft-skill/SKILL.md +128 -0
  716. package/skills/sounds-on-the-web/SKILL.md +151 -0
  717. package/skills/sql-pro/SKILL.md +699 -0
  718. package/skills/supabase-postgres-best-practices/SKILL.md +132 -0
  719. package/skills/svg-animation/SKILL.md +431 -0
  720. package/skills/swiftui-expert/SKILL.md +239 -0
  721. package/skills/swiss-design/SKILL.md +119 -0
  722. package/skills/system-design-pro/SKILL.md +393 -0
  723. package/skills/systematic-debugging/SKILL.md +198 -0
  724. package/skills/systematic-debugging/condition-based-waiting.md +115 -0
  725. package/skills/systematic-debugging/defense-in-depth.md +122 -0
  726. package/skills/systematic-debugging/root-cause-tracing.md +169 -0
  727. package/skills/tailwind-patterns/SKILL.md +658 -0
  728. package/skills/taste-skill/SKILL.md +127 -0
  729. package/skills/tdd-workflow/SKILL.md +179 -0
  730. package/skills/test-result-analyzer/SKILL.md +345 -0
  731. package/skills/testing-patterns/SKILL.md +609 -0
  732. package/skills/testing-patterns/scripts/test_runner.py +219 -0
  733. package/skills/thermo-nuclear-code-quality-review/SKILL.md +137 -0
  734. package/skills/thinking-protocol/SKILL.md +97 -0
  735. package/skills/to-spring-or-not-to-spring/SKILL.md +118 -0
  736. package/skills/transitions-dev/SKILL.md +165 -0
  737. package/skills/trend-researcher/SKILL.md +273 -0
  738. package/skills/typescript-advanced/SKILL.md +381 -0
  739. package/skills/typeset/SKILL.md +135 -0
  740. package/skills/ui-reasoning-engine/SKILL.md +230 -0
  741. package/skills/ui-skill-packs/SKILL.md +132 -0
  742. package/skills/ui-skills-root/SKILL.md +144 -0
  743. package/skills/ui-ux-pro-max/SKILL.md +185 -0
  744. package/skills/ui-ux-researcher/SKILL.md +274 -0
  745. package/skills/vector-search-pgvector/SKILL.md +144 -0
  746. package/skills/verification-before-completion/SKILL.md +178 -0
  747. package/skills/vue-expert/SKILL.md +334 -0
  748. package/skills/vulnerability-scanner/SKILL.md +453 -0
  749. package/skills/vulnerability-scanner/scripts/security_scan.py +458 -0
  750. package/skills/web-accessibility-auditor/SKILL.md +254 -0
  751. package/skills/web-design-guidelines/SKILL.md +124 -0
  752. package/skills/web-quality-audit/SKILL.md +122 -0
  753. package/skills/webapp-testing/SKILL.md +203 -0
  754. package/skills/webapp-testing/scripts/playwright_runner.py +173 -0
  755. package/skills/webgpu-performance/SKILL.md +163 -0
  756. package/skills/whimsy-injector/SKILL.md +380 -0
  757. package/skills/workflow-optimizer/SKILL.md +263 -0
  758. package/skills/zero-trust-passkeys/SKILL.md +156 -0
  759. package/.agent/skills/api-patterns/scripts/__pycache__/api_validator.cpython-311.pyc +0 -0
  760. package/.agent/skills/database-design/scripts/__pycache__/schema_validator.cpython-311.pyc +0 -0
  761. package/.agent/skills/frontend-design/scripts/__pycache__/accessibility_checker.cpython-311.pyc +0 -0
  762. package/.agent/skills/frontend-design/scripts/__pycache__/ux_audit.cpython-311.pyc +0 -0
  763. package/.agent/skills/geo-fundamentals/scripts/__pycache__/geo_checker.cpython-311.pyc +0 -0
  764. package/.agent/skills/i18n-localization/scripts/__pycache__/i18n_checker.cpython-311.pyc +0 -0
  765. package/.agent/skills/lint-and-validate/scripts/__pycache__/lint_runner.cpython-311.pyc +0 -0
  766. package/.agent/skills/lint-and-validate/scripts/__pycache__/type_coverage.cpython-311.pyc +0 -0
  767. package/.agent/skills/mobile-design/scripts/__pycache__/mobile_audit.cpython-311.pyc +0 -0
  768. package/.agent/skills/nextjs-react-expert/scripts/__pycache__/convert_rules.cpython-311.pyc +0 -0
  769. package/.agent/skills/nextjs-react-expert/scripts/__pycache__/react_performance_checker.cpython-311.pyc +0 -0
  770. package/.agent/skills/performance-profiling/scripts/__pycache__/lighthouse_audit.cpython-311.pyc +0 -0
  771. package/.agent/skills/seo-fundamentals/scripts/__pycache__/seo_checker.cpython-311.pyc +0 -0
  772. package/.agent/skills/testing-patterns/scripts/__pycache__/test_runner.cpython-311.pyc +0 -0
  773. package/.agent/skills/vulnerability-scanner/scripts/__pycache__/security_scan.cpython-311.pyc +0 -0
  774. package/.agent/skills/webapp-testing/scripts/__pycache__/playwright_runner.cpython-311.pyc +0 -0
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  name: quieter
3
- description: Tone down overly loud, noisy, visually aggressive, or distracting designs while maintaining high visual quality. Use when a UI feels cluttered, overwhelming, tacky, or visually hyperactive.
4
- version: 3.0.0
5
- last-updated: 2026-07-30
3
+ description: Use when Tone down overly loud, noisy, visually aggressive, or distracting designs while maintaining high visual quality. Use when a UI feels cluttered, overwhelming, tacky, or visually hyperactive.
4
+ version: 5.0.0
5
+ last-updated: 2026-09-13
6
6
  skills:
7
7
  - distill
8
8
  - swiss-design
@@ -15,17 +15,41 @@ scripts-binding:
15
15
 
16
16
  # Quieter — Visual Restraint & Calm Interface Design
17
17
 
18
- ---
19
-
20
18
  ## Mandatory Pre-Flight Context Inspection
21
19
 
22
- Before subduing visual design elements, you MUST inspect:
20
+ Before generating, refactoring, or reviewing code in the `quieter` domain, inspect these 5 critical parameters:
21
+
22
+ 1. **System Boundaries & Dependencies**: Verify that all required dependencies exist in target package manifests and environment paths.
23
+ 2. **Runtime Context & Platform Invariants**: Confirm target platform constraints (Node.js, Browser, Mobile OS, Edge runtime) before applying APIs.
24
+ 3. **Execution Guardrails**: Identify potential side-effects, state mutations, and unhandled asynchronous exceptions.
25
+ 4. **Validation & Type Contracts**: Validate input data schemas and strict type constraints across all module interfaces.
26
+ 5. **Observability & Proof of Execution**: Ensure execution produces tangible verification signals (terminal output, tests, metrics).
27
+
28
+ ## Activation Boundaries
29
+
30
+ - **Activate when:** Use when Tone down overly loud, noisy, visually aggressive, or distracting designs while maintaining high visual quality. Use when a UI feels cluttered, overwhelming, tacky, or visually hyperactive.
31
+ - **DO NOT activate when:** The task falls outside the `quieter` domain or is managed by a different dedicated specialist.
23
32
 
24
- 1. `DESIGN.md` / `package.json` → Check background surface variables and contrast standards
25
- 2. Palette Subjugation rules (Section 24) → Limit high-saturation colors to single primary actions
26
- 3. Motion Restraint rules (Section 35) Eliminate looping pulsing badges and restrict motion to user-initiated actions
33
+ ## 🔁 Multi-Pass Execution Protocol
34
+
35
+ Execute all non-trivial tasks through this 7-pass cognitive loop:
36
+
37
+ | Pass | Phase | Core Action |
38
+ |:---|:---|:---|
39
+ | **Pass 1** | **Understand** | Deconstruct the user's explicit objective, implicit requirements, and platform constraints. |
40
+ | **Pass 2** | **Plan** | Decompose the task into smallest logical steps; map dependencies and required tool calls. |
41
+ | **Pass 3** | **Execute** | Implement the solution with production-grade craft, zero placeholders, and strict typing. |
42
+ | **Pass 4** | **Verify** | Run linters, unit tests, or compiler checks to validate structural correctness. |
43
+ | **Pass 5** | **Attack** | Perform an adversarial review searching for edge-case failures, race conditions, and traps. |
44
+ | **Pass 6** | **Improve** | Eliminate discovered friction, optimize performance, and harden error boundaries. |
45
+ | **Pass 7** | **Quality Gate** | Enforce Verification-Before-Completion (VBC) with concrete terminal proof before finalizing. |
46
+
47
+ ---
48
+
49
+ ## 🛠️ Technical Architecture & Reference Recipes
50
+
51
+ ---
27
52
 
28
- Reduce visual noise, eliminate unnecessary color competition, and restore calm focus to chaotic interfaces.
29
53
 
30
54
  ---
31
55
 
@@ -56,28 +80,45 @@ Reduce visual noise, eliminate unnecessary color competition, and restore calm f
56
80
 
57
81
  ---
58
82
 
59
- ## 🤖 LLM-Specific Traps
83
+ ## 🚨 Edge-Case & Failure Mode Matrix
84
+
85
+ | Scenario | Risk | Mitigation Strategy |
86
+ |:---|:---|:---|
87
+ | **Empty or Null Inputs** | Unhandled exception or unexpected rendering collapse | Enforce fallback guards, optional chaining, and explicit empty state handlers |
88
+ | **Network Timeout / Latency** | Hanging operations or duplicate side-effects | Implement bounded abort controllers, exponential backoff, and idempotency keys |
89
+ | **Concurrency / Race Conditions** | Stale state overwrite or inconsistent data mutations | Use atomic transactions, mutex locking, or cancel-on-resubmit controls |
90
+ | **Invalid Schema / Malformed Payload** | Downstream runtime errors or security injection | Validate boundary payloads with Zod/Pydantic schemas prior to execution |
91
+ | **Resource / Memory Saturation** | OOM errors, frame drops, or memory leaks | Clean up listeners, cancel active timers, and enforce pagination/virtualization |
92
+
93
+ ---
94
+
95
+ ## 🤖 LLM-Specific Traps Table
60
96
 
61
- 1. **Making Text Unreadable**: Reducing color saturation so much that text fails WCAG AA contrast (below 4.5:1).
62
- 2. **Stripping Functional Indicators**: Removing error/warning colors when reducing palette noise. Keep functional colors crisp.
97
+ | Anti-Pattern | What AI Commonly Does Wrong | What Is Actually Correct |
98
+ |:---|:---|:---|
99
+ | **Uncontrolled Re-render Loop** | Mutating state inside render bodies or omitting hook dependencies | Wrap effects with explicit deps and isolate reactive derivations in useMemo |
100
+ | **Accessibility Neglect** | Interactive <div> without role="button", tabIndex, or onKeyDown | Use semantic <button> or provide ARIA role, keyboard handlers, and focus ring |
101
+ | **Layout Shift Flash** | Images/dynamic content without aspect-ratio or explicit dimensions | Enforce aspect-ratio or skeleton placeholders to guarantee zero CLS |
63
102
 
64
103
  ---
65
104
 
66
- ## 🏛️ Tribunal Integration (Anti-Hallucination)
105
+ ## 🏛️ Tribunal Verification & Guardrails
67
106
 
68
- **Active reviewers: `frontend-reviewer` · `ui-ux-auditor`**
107
+ **Active Reviewers:** `frontend-reviewer` · `type-safety` · `ui-ux-auditor` · `complexity-reviewer`
108
+ **Slash Command:** `/review` or `/tribunal-full`
69
109
 
70
- ### ✅ Pre-Flight Self-Audit
110
+ ### ✅ Pre-Flight Self-Audit Checklist
71
111
 
72
112
  ```
73
- ✅ Are saturated colors restricted to primary actions?
74
- Did I retain minimum 4.5:1 text contrast for all body and label copy?
75
- Has unnecessary layout animation or pulsing been eliminated?
113
+ ✅ Are all component props strictly typed with zero implicit "any"?
114
+ Are responsive breakpoints, fluid typography, and optical balance verified?
115
+ Is accessibility (ARIA labels, keyboard focus, contrast) validated?
116
+ ✅ Are re-renders minimized and state lifecycles cleanly separated?
117
+ ✅ Did I verify all imported UI components and icon sets actually exist?
76
118
  ```
77
119
 
78
120
  ### 🛑 Verification-Before-Completion (VBC) Protocol
79
121
 
80
122
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
81
-
82
123
  - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
83
- - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
124
+ - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing test suites, compiler success, or equivalent operational proof) that your output works as intended.
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  name: react-doctor
3
- description: Scan React and Next.js applications for security, performance, re-render inefficiencies, memory leaks, and correctness issues.
4
- version: 3.0.0
5
- last-updated: 2026-07-30
3
+ description: Use when Scan React and Next.js applications for security, performance, re-render inefficiencies, memory leaks, and correctness issues.
4
+ version: 5.0.0
5
+ last-updated: 2026-09-13
6
6
  skills:
7
7
  - react-specialist
8
8
  - nextjs-react-expert
@@ -15,17 +15,41 @@ scripts-binding:
15
15
 
16
16
  # React Doctor — React Performance & Health Audit
17
17
 
18
- ---
19
-
20
18
  ## Mandatory Pre-Flight Context Inspection
21
19
 
22
- Before auditing React components for performance or health issues, you MUST inspect:
20
+ Before generating, refactoring, or reviewing code in the `react-doctor` domain, inspect these 5 critical parameters:
21
+
22
+ 1. **System Boundaries & Dependencies**: Verify that all required dependencies exist in target package manifests and environment paths.
23
+ 2. **Runtime Context & Platform Invariants**: Confirm target platform constraints (Node.js, Browser, Mobile OS, Edge runtime) before applying APIs.
24
+ 3. **Execution Guardrails**: Identify potential side-effects, state mutations, and unhandled asynchronous exceptions.
25
+ 4. **Validation & Type Contracts**: Validate input data schemas and strict type constraints across all module interfaces.
26
+ 5. **Observability & Proof of Execution**: Ensure execution produces tangible verification signals (terminal output, tests, metrics).
27
+
28
+ ## Activation Boundaries
29
+
30
+ - **Activate when:** Use when Scan React and Next.js applications for security, performance, re-render inefficiencies, memory leaks, and correctness issues.
31
+ - **DO NOT activate when:** The task falls outside the `react-doctor` domain or is managed by a different dedicated specialist.
23
32
 
24
- 1. Re-render triggers (Section 24) → Identify inline object/array props and inline callback handlers breaking memoization
25
- 2. `useEffect` Cleanup (Section 31) → Ensure all event listeners, intervals, and subscriptions return explicit cleanup functions
26
- 3. Derived State Anti-Pattern (Section 41) Ban props duplicated into state (`useState(props.val)`); derive values directly during render
33
+ ## 🔁 Multi-Pass Execution Protocol
34
+
35
+ Execute all non-trivial tasks through this 7-pass cognitive loop:
36
+
37
+ | Pass | Phase | Core Action |
38
+ |:---|:---|:---|
39
+ | **Pass 1** | **Understand** | Deconstruct the user's explicit objective, implicit requirements, and platform constraints. |
40
+ | **Pass 2** | **Plan** | Decompose the task into smallest logical steps; map dependencies and required tool calls. |
41
+ | **Pass 3** | **Execute** | Implement the solution with production-grade craft, zero placeholders, and strict typing. |
42
+ | **Pass 4** | **Verify** | Run linters, unit tests, or compiler checks to validate structural correctness. |
43
+ | **Pass 5** | **Attack** | Perform an adversarial review searching for edge-case failures, race conditions, and traps. |
44
+ | **Pass 6** | **Improve** | Eliminate discovered friction, optimize performance, and harden error boundaries. |
45
+ | **Pass 7** | **Quality Gate** | Enforce Verification-Before-Completion (VBC) with concrete terminal proof before finalizing. |
46
+
47
+ ---
48
+
49
+ ## 🛠️ Technical Architecture & Reference Recipes
50
+
51
+ ---
27
52
 
28
- Diagnose and resolve unnecessary re-renders, state synchronization bugs, memory leaks, and hook dependency issues in React applications.
29
53
 
30
54
  ---
31
55
 
@@ -58,28 +82,45 @@ useEffect(() => {
58
82
 
59
83
  ---
60
84
 
61
- ## 🤖 LLM-Specific Traps
85
+ ## 🚨 Edge-Case & Failure Mode Matrix
86
+
87
+ | Scenario | Risk | Mitigation Strategy |
88
+ |:---|:---|:---|
89
+ | **Empty or Null Inputs** | Unhandled exception or unexpected rendering collapse | Enforce fallback guards, optional chaining, and explicit empty state handlers |
90
+ | **Network Timeout / Latency** | Hanging operations or duplicate side-effects | Implement bounded abort controllers, exponential backoff, and idempotency keys |
91
+ | **Concurrency / Race Conditions** | Stale state overwrite or inconsistent data mutations | Use atomic transactions, mutex locking, or cancel-on-resubmit controls |
92
+ | **Invalid Schema / Malformed Payload** | Downstream runtime errors or security injection | Validate boundary payloads with Zod/Pydantic schemas prior to execution |
93
+ | **Resource / Memory Saturation** | OOM errors, frame drops, or memory leaks | Clean up listeners, cancel active timers, and enforce pagination/virtualization |
94
+
95
+ ---
96
+
97
+ ## 🤖 LLM-Specific Traps Table
62
98
 
63
- 1. **Over-using `useCallback` everywhere**: Wrapping trivial primitives or 1-line functions that aren't passed to memoized children.
64
- 2. **Missing `useEffect` Dependencies**: Omitting referenced variables from effect dependency arrays without proper `useCallback` or ref wrapping.
99
+ | Anti-Pattern | What AI Commonly Does Wrong | What Is Actually Correct |
100
+ |:---|:---|:---|
101
+ | **Uncontrolled Re-render Loop** | Mutating state inside render bodies or omitting hook dependencies | Wrap effects with explicit deps and isolate reactive derivations in useMemo |
102
+ | **Accessibility Neglect** | Interactive <div> without role="button", tabIndex, or onKeyDown | Use semantic <button> or provide ARIA role, keyboard handlers, and focus ring |
103
+ | **Layout Shift Flash** | Images/dynamic content without aspect-ratio or explicit dimensions | Enforce aspect-ratio or skeleton placeholders to guarantee zero CLS |
65
104
 
66
105
  ---
67
106
 
68
- ## 🏛️ Tribunal Integration (Anti-Hallucination)
107
+ ## 🏛️ Tribunal Verification & Guardrails
69
108
 
70
- **Active reviewers: `react-specialist` · `type-safety`**
109
+ **Active Reviewers:** `frontend-reviewer` · `type-safety` · `ui-ux-auditor` · `complexity-reviewer`
110
+ **Slash Command:** `/review` or `/tribunal-full`
71
111
 
72
- ### ✅ Pre-Flight Self-Audit
112
+ ### ✅ Pre-Flight Self-Audit Checklist
73
113
 
74
114
  ```
75
- ✅ Are event listeners and timers properly cleaned up in `useEffect` returns?
76
- ✅ Are expensive calculations wrapped in `useMemo`?
77
- ✅ Is state colocated to minimize re-render scope?
115
+ ✅ Are all component props strictly typed with zero implicit "any"?
116
+ ✅ Are responsive breakpoints, fluid typography, and optical balance verified?
117
+ ✅ Is accessibility (ARIA labels, keyboard focus, contrast) validated?
118
+ ✅ Are re-renders minimized and state lifecycles cleanly separated?
119
+ ✅ Did I verify all imported UI components and icon sets actually exist?
78
120
  ```
79
121
 
80
122
  ### 🛑 Verification-Before-Completion (VBC) Protocol
81
123
 
82
124
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
83
-
84
125
  - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
85
- - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
126
+ - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing test suites, compiler success, or equivalent operational proof) that your output works as intended.
@@ -1,13 +1,13 @@
1
1
  ---
2
2
  name: react-specialist
3
- description: React 19+ specialist. use(), useActionState, useOptimistic, React Compiler, Server/Client Components, Zustand/Jotai, React Query. Use when building components, managing state, optimizing renders.
4
- tools: Read, Grep, Glob, Bash, Edit, Write
5
- version: 3.0.0
6
- last-updated: 2026-07-30
3
+ description: Use when React 19+ specialist. use(), useActionState, useOptimistic, React Compiler, Server/Client Components, Zustand/Jotai, React Query. Use when building components, managing state, optimizing renders.
4
+ version: 5.0.0
5
+ last-updated: 2026-09-13
7
6
  skills:
8
7
  - nextjs-react-expert
9
8
  - react-doctor
10
9
  - baseline-ui
10
+ tools: Read, Grep, Glob, Bash, Edit, Write
11
11
  scripts-binding:
12
12
  - .agent/scripts/lint_runner.js
13
13
  - .agent/scripts/verify_all.js
@@ -15,24 +15,59 @@ scripts-binding:
15
15
 
16
16
  # React 19+ — Dense Reference
17
17
 
18
+ ## Mandatory Pre-Flight Context Inspection
19
+
20
+ Before generating, refactoring, or reviewing code in the `react-specialist` domain, inspect these 5 critical parameters:
21
+
22
+ 1. **System Boundaries & Dependencies**: Verify that all required dependencies exist in target package manifests and environment paths.
23
+ 2. **Runtime Context & Platform Invariants**: Confirm target platform constraints (Node.js, Browser, Mobile OS, Edge runtime) before applying APIs.
24
+ 3. **Execution Guardrails**: Identify potential side-effects, state mutations, and unhandled asynchronous exceptions.
25
+ 4. **Validation & Type Contracts**: Validate input data schemas and strict type constraints across all module interfaces.
26
+ 5. **Observability & Proof of Execution**: Ensure execution produces tangible verification signals (terminal output, tests, metrics).
27
+
28
+ ## Activation Boundaries
29
+
30
+ - **Activate when:** Use when React 19+ specialist. use(), useActionState, useOptimistic, React Compiler, Server/Client Components, Zustand/Jotai, React Query. Use when building components, managing state, optimizing renders.
31
+ - **DO NOT activate when:** The task falls outside the `react-specialist` domain or is managed by a different dedicated specialist.
32
+
33
+ ## 🔁 Multi-Pass Execution Protocol
34
+
35
+ Execute all non-trivial tasks through this 7-pass cognitive loop:
36
+
37
+ | Pass | Phase | Core Action |
38
+ |:---|:---|:---|
39
+ | **Pass 1** | **Understand** | Deconstruct the user's explicit objective, implicit requirements, and platform constraints. |
40
+ | **Pass 2** | **Plan** | Decompose the task into smallest logical steps; map dependencies and required tool calls. |
41
+ | **Pass 3** | **Execute** | Implement the solution with production-grade craft, zero placeholders, and strict typing. |
42
+ | **Pass 4** | **Verify** | Run linters, unit tests, or compiler checks to validate structural correctness. |
43
+ | **Pass 5** | **Attack** | Perform an adversarial review searching for edge-case failures, race conditions, and traps. |
44
+ | **Pass 6** | **Improve** | Eliminate discovered friction, optimize performance, and harden error boundaries. |
45
+ | **Pass 7** | **Quality Gate** | Enforce Verification-Before-Completion (VBC) with concrete terminal proof before finalizing. |
46
+
47
+ ---
48
+
49
+ ## 🛠️ Technical Architecture & Reference Recipes
50
+
18
51
  ---
19
52
 
20
- ## Mandatory Pre-Flight Context Inspection
21
53
 
22
- Before writing React 19+ components or hooks, you MUST inspect:
54
+ ## 2026 React 19 Performance & Architecture Invariants
23
55
 
24
- 1. React 19 APIs (`useActionState` vs deprecated `useFormState`, `use()` vs `useContext`, `ref` as prop vs deprecated `forwardRef`)
25
- 2. React Compiler Memoization (Section 125) Avoid manual `useMemo`/`useCallback` unless React Compiler is explicitly disabled
26
- 3. State Destructuring Traps (Section 189) Never destructure entire Zustand stores; use granular selectors `useStore(s => s.value)`
56
+ 1. **Direct `ref` as a Prop**: Never use `forwardRef`. In React 19, `ref` is passed directly as a standard component prop.
57
+ 2. **Server Actions & `useActionState`**: Prefer native form actions and `useActionState` over manual `onSubmit` event handlers with `preventDefault()`.
58
+ 3. **Optimistic Updates**: Use `useOptimistic` for instant local feedback before network requests settle.
59
+ 4. **Transition-Aware State Updates**: Wrap non-urgent state updates in `startTransition` to keep main thread interactions responsive.
60
+ 5. **No Context Provider Wrapper Boilerplate**: In React 19, `<ThemeContext value={theme}>` replaces `<ThemeContext.Provider value={theme}>`.
27
61
 
28
62
  ## Hallucination Traps (Read First)
29
63
 
30
- - ❌ `useFormState` → ✅ `useActionState` (stable name)
31
- - ❌ `useContext()` in conditionals → ✅ `use(Context)` CAN be conditional
32
- - ❌ `useMemo/useCallback/React.memo` in React 19+ projects → ✅ React Compiler handles this
33
- - ❌ `exitBeforeEnter` (Framer) → ✅ `mode="wait"` on `<AnimatePresence>`
64
+ - ❌ `forwardRef((props, ref) => ...)` → ✅ In React 19, accept `ref` directly as a component prop
65
+ - ❌ `<ThemeContext.Provider value={...}>` → ✅ In React 19, use `<ThemeContext value={...}>`
66
+ - ❌ `useFormState()` → ✅ `useActionState()` (stable API)
67
+ - ❌ `useContext()` inside `if` conditionals → ✅ `use(Context)` CAN be called conditionally
68
+ - ❌ Manual `useMemo`/`useCallback` everywhere → ✅ Let React Compiler handle memoization automatically
69
+ - ❌ Destructuring whole store `const { user } = useStore()` → ✅ Granular selector `useStore(s => s.user)`
34
70
  - ❌ `next/router` → ✅ `next/navigation` in App Router
35
- - ❌ Server Components using `useState/useEffect` → must be `"use client"`
36
71
 
37
72
  ---
38
73
 
@@ -276,89 +311,45 @@ function Input({ ref, ...props }: ComponentProps<'input'> & { ref?: Ref<HTMLInpu
276
311
 
277
312
  ---
278
313
 
279
- AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
314
+ ## 🚨 Edge-Case & Failure Mode Matrix
280
315
 
281
- 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
282
- 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
283
- 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
284
- 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
285
- 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
316
+ | Scenario | Risk | Mitigation Strategy |
317
+ |:---|:---|:---|
318
+ | **Empty or Null Inputs** | Unhandled exception or unexpected rendering collapse | Enforce fallback guards, optional chaining, and explicit empty state handlers |
319
+ | **Network Timeout / Latency** | Hanging operations or duplicate side-effects | Implement bounded abort controllers, exponential backoff, and idempotency keys |
320
+ | **Concurrency / Race Conditions** | Stale state overwrite or inconsistent data mutations | Use atomic transactions, mutex locking, or cancel-on-resubmit controls |
321
+ | **Invalid Schema / Malformed Payload** | Downstream runtime errors or security injection | Validate boundary payloads with Zod/Pydantic schemas prior to execution |
322
+ | **Resource / Memory Saturation** | OOM errors, frame drops, or memory leaks | Clean up listeners, cancel active timers, and enforce pagination/virtualization |
286
323
 
287
324
  ---
288
325
 
289
- **Slash command: `/review` or `/tribunal-full`**
290
- **Active reviewers: `logic-reviewer` · `security-auditor`**
326
+ ## 🤖 LLM-Specific Traps Table
291
327
 
292
- ### Forbidden AI Tropes
293
-
294
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
295
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
296
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
297
-
298
- Review these questions before confirming output:
299
-
300
- ```
301
- ✅ Did I rely ONLY on real, verified tools and methods?
302
- ✅ Is this solution appropriately scoped to the user's constraints?
303
- ✅ Did I handle potential failure modes and edge cases?
304
- ✅ Have I avoided generic boilerplate that doesn't add value?
305
- ```
306
-
307
- ### 🛑 Verification-Before-Completion (VBC) Protocol
308
-
309
- **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
310
-
311
- - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
312
- - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
313
-
314
- ## Pre-Flight Checklist
315
-
316
- - [ ] Have I reviewed the user's specific constraints and requests?
317
- - [ ] Have I checked the environment for relevant existing implementations?
318
-
319
- ## VBC Protocol (Verification-Before-Completion)
320
-
321
- You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
328
+ | Anti-Pattern | What AI Commonly Does Wrong | What Is Actually Correct |
329
+ |:---|:---|:---|
330
+ | **Uncontrolled Re-render Loop** | Mutating state inside render bodies or omitting hook dependencies | Wrap effects with explicit deps and isolate reactive derivations in useMemo |
331
+ | **Accessibility Neglect** | Interactive <div> without role="button", tabIndex, or onKeyDown | Use semantic <button> or provide ARIA role, keyboard handlers, and focus ring |
332
+ | **Layout Shift Flash** | Images/dynamic content without aspect-ratio or explicit dimensions | Enforce aspect-ratio or skeleton placeholders to guarantee zero CLS |
322
333
 
323
334
  ---
324
335
 
325
- ## 🤖 LLM-Specific Traps
336
+ ## 🏛️ Tribunal Verification & Guardrails
326
337
 
327
- AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
338
+ **Active Reviewers:** `frontend-reviewer` · `type-safety` · `ui-ux-auditor` · `complexity-reviewer`
339
+ **Slash Command:** `/review` or `/tribunal-full`
328
340
 
329
- 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
330
- 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
331
- 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
332
- 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
333
- 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
334
-
335
- ---
336
-
337
- ## 🏛️ Tribunal Integration (Anti-Hallucination)
338
-
339
- **Slash command: `/review` or `/tribunal-full`**
340
- **Active reviewers: `logic-reviewer` · `security-auditor`**
341
-
342
- ### ❌ Forbidden AI Tropes
343
-
344
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
345
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
346
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
347
-
348
- ### ✅ Pre-Flight Self-Audit
349
-
350
- Review these questions before confirming output:
341
+ ### ✅ Pre-Flight Self-Audit Checklist
351
342
 
352
343
  ```
353
- Did I rely ONLY on real, verified tools and methods?
354
- Is this solution appropriately scoped to the user's constraints?
355
- Did I handle potential failure modes and edge cases?
356
- Have I avoided generic boilerplate that doesn't add value?
344
+ Are all component props strictly typed with zero implicit "any"?
345
+ Are responsive breakpoints, fluid typography, and optical balance verified?
346
+ Is accessibility (ARIA labels, keyboard focus, contrast) validated?
347
+ Are re-renders minimized and state lifecycles cleanly separated?
348
+ ✅ Did I verify all imported UI components and icon sets actually exist?
357
349
  ```
358
350
 
359
351
  ### 🛑 Verification-Before-Completion (VBC) Protocol
360
352
 
361
353
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
362
-
363
354
  - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
364
- - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
355
+ - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing test suites, compiler success, or equivalent operational proof) that your output works as intended.