@zenrick/zenkit 0.0.0-stage → 0.5.0

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 (353) hide show
  1. package/.claude-plugin/marketplace.json +19 -0
  2. package/.cursor-plugin/marketplace.json +22 -0
  3. package/INSTALL.md +73 -0
  4. package/LICENSE +202 -0
  5. package/NOTICE +5 -0
  6. package/README.md +69 -3
  7. package/TERMS.md +48 -0
  8. package/THIRD-PARTY-NOTICES.md +109 -0
  9. package/kit/agents/backend-specialist.md +263 -0
  10. package/kit/agents/code-archaeologist.md +106 -0
  11. package/kit/agents/database-architect.md +226 -0
  12. package/kit/agents/debugger.md +226 -0
  13. package/kit/agents/devops-engineer.md +242 -0
  14. package/kit/agents/documentation-writer.md +104 -0
  15. package/kit/agents/explorer-agent.md +73 -0
  16. package/kit/agents/frontend-specialist.md +593 -0
  17. package/kit/agents/game-developer.md +162 -0
  18. package/kit/agents/mobile-developer.md +377 -0
  19. package/kit/agents/orchestrator.md +489 -0
  20. package/kit/agents/penetration-tester.md +188 -0
  21. package/kit/agents/performance-optimizer.md +187 -0
  22. package/kit/agents/product-manager.md +112 -0
  23. package/kit/agents/product-owner.md +95 -0
  24. package/kit/agents/project-planner.md +409 -0
  25. package/kit/agents/qa-automation-engineer.md +103 -0
  26. package/kit/agents/security-auditor.md +170 -0
  27. package/kit/agents/seo-specialist.md +111 -0
  28. package/kit/agents/test-engineer.md +158 -0
  29. package/kit/bundles/agent-building.yaml +26 -0
  30. package/kit/bundles/backend-data.yaml +14 -0
  31. package/kit/bundles/base.yaml +10 -0
  32. package/kit/bundles/core.yaml +21 -0
  33. package/kit/bundles/kit-engenharia.yaml +8 -0
  34. package/kit/bundles/kit-lite.yaml +9 -0
  35. package/kit/bundles/security.yaml +11 -0
  36. package/kit/bundles/ship-run.yaml +16 -0
  37. package/kit/bundles/web-ui.yaml +18 -0
  38. package/kit/commands/docs.md +33 -0
  39. package/kit/commands/explain.md +41 -0
  40. package/kit/commands/fix.md +65 -0
  41. package/kit/commands/implement.md +35 -0
  42. package/kit/commands/refactor.md +59 -0
  43. package/kit/commands/review.md +55 -0
  44. package/kit/commands/test.md +63 -0
  45. package/kit/modules/bridge/rules/cross-ide-bridge.mdc +73 -0
  46. package/kit/modules/bridge/zenkit-layer.yaml +1 -0
  47. package/kit/modules/nexuscore/sections/convivencia.md +12 -0
  48. package/kit/modules/nexuscore/sections/memoria.md +9 -0
  49. package/kit/modules/nexuscore/skills/quadro-agentes/SKILL.md +186 -0
  50. package/kit/modules/nexuscore/zenkit-layer.yaml +1 -0
  51. package/kit/rules/ZENKIT.mdc +294 -0
  52. package/kit/rules/git.mdc +51 -0
  53. package/kit/rules/karpathy-guidelines.mdc +70 -0
  54. package/kit/rules/model-routing.mdc +89 -0
  55. package/kit/rules/security-headers.mdc +41 -0
  56. package/kit/rules/social-automation.mdc +69 -0
  57. package/kit/rules/toc.mdc +40 -0
  58. package/kit/skills/api-patterns/SKILL.md +95 -0
  59. package/kit/skills/api-patterns/api-style.md +42 -0
  60. package/kit/skills/api-patterns/auth.md +24 -0
  61. package/kit/skills/api-patterns/documentation.md +26 -0
  62. package/kit/skills/api-patterns/graphql.md +41 -0
  63. package/kit/skills/api-patterns/rate-limiting.md +31 -0
  64. package/kit/skills/api-patterns/references/backend/backend-api-design.md +495 -0
  65. package/kit/skills/api-patterns/references/backend/backend-architecture.md +454 -0
  66. package/kit/skills/api-patterns/references/backend/backend-authentication.md +338 -0
  67. package/kit/skills/api-patterns/references/backend/backend-code-quality.md +659 -0
  68. package/kit/skills/api-patterns/references/backend/backend-debugging.md +904 -0
  69. package/kit/skills/api-patterns/references/backend/backend-devops.md +494 -0
  70. package/kit/skills/api-patterns/references/backend/backend-mindset.md +387 -0
  71. package/kit/skills/api-patterns/references/backend/backend-performance.md +397 -0
  72. package/kit/skills/api-patterns/references/backend/backend-security.md +290 -0
  73. package/kit/skills/api-patterns/references/backend/backend-technologies.md +256 -0
  74. package/kit/skills/api-patterns/references/backend/backend-testing.md +429 -0
  75. package/kit/skills/api-patterns/response.md +37 -0
  76. package/kit/skills/api-patterns/rest.md +40 -0
  77. package/kit/skills/api-patterns/scripts/api_validator.py +211 -0
  78. package/kit/skills/api-patterns/security-testing.md +122 -0
  79. package/kit/skills/api-patterns/trpc.md +41 -0
  80. package/kit/skills/api-patterns/versioning.md +22 -0
  81. package/kit/skills/app-builder/SKILL.md +76 -0
  82. package/kit/skills/app-builder/agent-coordination.md +71 -0
  83. package/kit/skills/app-builder/feature-building.md +53 -0
  84. package/kit/skills/app-builder/project-detection.md +34 -0
  85. package/kit/skills/app-builder/scaffolding.md +118 -0
  86. package/kit/skills/app-builder/tech-stack.md +41 -0
  87. package/kit/skills/app-builder/templates/SKILL.md +39 -0
  88. package/kit/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -0
  89. package/kit/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -0
  90. package/kit/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -0
  91. package/kit/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -0
  92. package/kit/skills/app-builder/templates/express-api/TEMPLATE.md +83 -0
  93. package/kit/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -0
  94. package/kit/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -0
  95. package/kit/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +122 -0
  96. package/kit/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +122 -0
  97. package/kit/skills/app-builder/templates/nextjs-static/TEMPLATE.md +169 -0
  98. package/kit/skills/app-builder/templates/nuxt-app/TEMPLATE.md +134 -0
  99. package/kit/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -0
  100. package/kit/skills/app-builder/templates/react-native-app/TEMPLATE.md +119 -0
  101. package/kit/skills/architecture/SKILL.md +56 -0
  102. package/kit/skills/architecture/context-discovery.md +43 -0
  103. package/kit/skills/architecture/examples.md +94 -0
  104. package/kit/skills/architecture/pattern-selection.md +68 -0
  105. package/kit/skills/architecture/patterns-reference.md +50 -0
  106. package/kit/skills/architecture/trade-off-analysis.md +77 -0
  107. package/kit/skills/bash-linux/SKILL.md +203 -0
  108. package/kit/skills/batch-operations/SKILL.md +112 -0
  109. package/kit/skills/behavioral-modes/SKILL.md +255 -0
  110. package/kit/skills/brainstorming/SKILL.md +189 -0
  111. package/kit/skills/brainstorming/dynamic-questioning.md +350 -0
  112. package/kit/skills/brainstorming/references/problem-solving/attribution.md +69 -0
  113. package/kit/skills/brainstorming/references/problem-solving/collision-zone-thinking.md +79 -0
  114. package/kit/skills/brainstorming/references/problem-solving/inversion-exercise.md +91 -0
  115. package/kit/skills/brainstorming/references/problem-solving/meta-pattern-recognition.md +87 -0
  116. package/kit/skills/brainstorming/references/problem-solving/scale-game.md +95 -0
  117. package/kit/skills/brainstorming/references/problem-solving/simplification-cascades.md +80 -0
  118. package/kit/skills/brainstorming/references/problem-solving/when-stuck.md +72 -0
  119. package/kit/skills/claude-exec/SKILL.md +185 -0
  120. package/kit/skills/clean-code/SKILL.md +210 -0
  121. package/kit/skills/code-review-checklist/SKILL.md +115 -0
  122. package/kit/skills/code-review-graph/SKILL.md +50 -0
  123. package/kit/skills/code-review-graph/references/alternatives-comparison.md +12 -0
  124. package/kit/skills/code-review-graph/references/best-practices.md +9 -0
  125. package/kit/skills/code-review-graph/references/configuration.md +43 -0
  126. package/kit/skills/code-review-graph/references/core-workflows.md +61 -0
  127. package/kit/skills/code-review-graph/references/how-it-works-4-layers.md +20 -0
  128. package/kit/skills/code-review-graph/references/installation.md +67 -0
  129. package/kit/skills/code-review-graph/references/integration-with-zenkit.md +23 -0
  130. package/kit/skills/code-review-graph/references/known-limitations.md +13 -0
  131. package/kit/skills/code-review-graph/references/when-to-use-vs-when-to-skip.md +21 -0
  132. package/kit/skills/codex-exec/SKILL.md +161 -0
  133. package/kit/skills/context-compression/SKILL.md +145 -0
  134. package/kit/skills/coordinator-mode/SKILL.md +215 -0
  135. package/kit/skills/cursor-exec/SKILL.md +152 -0
  136. package/kit/skills/database-design/SKILL.md +53 -0
  137. package/kit/skills/database-design/database-selection.md +43 -0
  138. package/kit/skills/database-design/indexing.md +39 -0
  139. package/kit/skills/database-design/migrations.md +48 -0
  140. package/kit/skills/database-design/optimization.md +36 -0
  141. package/kit/skills/database-design/orm-selection.md +30 -0
  142. package/kit/skills/database-design/schema-design.md +56 -0
  143. package/kit/skills/database-design/scripts/schema_validator.py +172 -0
  144. package/kit/skills/deployment-procedures/SKILL.md +242 -0
  145. package/kit/skills/deprecation-and-migration/SKILL.md +149 -0
  146. package/kit/skills/documentation-templates/SKILL.md +195 -0
  147. package/kit/skills/entrega-com-agentes/SKILL.md +177 -0
  148. package/kit/skills/frontend-design/NOTICE.md +6 -0
  149. package/kit/skills/frontend-design/SKILL.md +456 -0
  150. package/kit/skills/frontend-design/animation-guide.md +331 -0
  151. package/kit/skills/frontend-design/color-system.md +311 -0
  152. package/kit/skills/frontend-design/decision-trees.md +418 -0
  153. package/kit/skills/frontend-design/motion-graphics.md +306 -0
  154. package/kit/skills/frontend-design/references/aesthetic/design-guideline-template.md +163 -0
  155. package/kit/skills/frontend-design/references/aesthetic/design-principles.md +62 -0
  156. package/kit/skills/frontend-design/references/aesthetic/design-resources.md +75 -0
  157. package/kit/skills/frontend-design/references/aesthetic/design-story-template.md +135 -0
  158. package/kit/skills/frontend-design/references/aesthetic/micro-interactions.md +53 -0
  159. package/kit/skills/frontend-design/references/aesthetic/storytelling-design.md +50 -0
  160. package/kit/skills/frontend-design/scripts/accessibility_checker.py +183 -0
  161. package/kit/skills/frontend-design/scripts/ux_audit.py +722 -0
  162. package/kit/skills/frontend-design/typography-system.md +345 -0
  163. package/kit/skills/frontend-design/ux-psychology.md +1116 -0
  164. package/kit/skills/frontend-design/visual-effects.md +383 -0
  165. package/kit/skills/game-development/2d-games/SKILL.md +119 -0
  166. package/kit/skills/game-development/3d-games/SKILL.md +135 -0
  167. package/kit/skills/game-development/SKILL.md +168 -0
  168. package/kit/skills/game-development/game-art/SKILL.md +185 -0
  169. package/kit/skills/game-development/game-audio/SKILL.md +190 -0
  170. package/kit/skills/game-development/game-design/SKILL.md +129 -0
  171. package/kit/skills/game-development/mobile-games/SKILL.md +108 -0
  172. package/kit/skills/game-development/multiplayer/SKILL.md +132 -0
  173. package/kit/skills/game-development/pc-games/SKILL.md +144 -0
  174. package/kit/skills/game-development/vr-ar/SKILL.md +123 -0
  175. package/kit/skills/game-development/web-games/SKILL.md +150 -0
  176. package/kit/skills/gemini-exec/SKILL.md +80 -0
  177. package/kit/skills/geo-fundamentals/SKILL.md +157 -0
  178. package/kit/skills/geo-fundamentals/scripts/geo_checker.py +289 -0
  179. package/kit/skills/git-worktrees/SKILL.md +107 -0
  180. package/kit/skills/i18n-localization/SKILL.md +145 -0
  181. package/kit/skills/i18n-localization/scripts/i18n_checker.py +241 -0
  182. package/kit/skills/intelligent-routing/SKILL.md +128 -0
  183. package/kit/skills/intelligent-routing/references/4-response-format.md +16 -0
  184. package/kit/skills/intelligent-routing/references/complexity-assessment.md +29 -0
  185. package/kit/skills/intelligent-routing/references/debug-intelligent-routing.md +9 -0
  186. package/kit/skills/intelligent-routing/references/debugging-agent-selection.md +7 -0
  187. package/kit/skills/intelligent-routing/references/domain-detection-rules.md +29 -0
  188. package/kit/skills/intelligent-routing/references/edge-cases.md +29 -0
  189. package/kit/skills/intelligent-routing/references/implementation-rules.md +35 -0
  190. package/kit/skills/intelligent-routing/references/integration-with-existing-workflows.md +21 -0
  191. package/kit/skills/intelligent-routing/references/performance-considerations.md +14 -0
  192. package/kit/skills/intelligent-routing/references/summary.md +16 -0
  193. package/kit/skills/intelligent-routing/references/testing-the-system.md +36 -0
  194. package/kit/skills/intelligent-routing/references/tier-0-automatic-analysis-always-active.md +27 -0
  195. package/kit/skills/intelligent-routing/references/user-education.md +12 -0
  196. package/kit/skills/karpathy-guidelines/SKILL.md +67 -0
  197. package/kit/skills/karpathy-guidelines/references/EXAMPLES.md +522 -0
  198. package/kit/skills/lint-and-validate/SKILL.md +46 -0
  199. package/kit/skills/lint-and-validate/scripts/lint_runner.py +184 -0
  200. package/kit/skills/lint-and-validate/scripts/type_coverage.py +173 -0
  201. package/kit/skills/mcp-atuacao/SKILL.md +238 -0
  202. package/kit/skills/mcp-builder/NOTICE.md +6 -0
  203. package/kit/skills/mcp-builder/SKILL.md +259 -0
  204. package/kit/skills/memory-system/SKILL.md +181 -0
  205. package/kit/skills/mobile-design/SKILL.md +395 -0
  206. package/kit/skills/mobile-design/decision-trees.md +516 -0
  207. package/kit/skills/mobile-design/mobile-backend.md +491 -0
  208. package/kit/skills/mobile-design/mobile-color-system.md +420 -0
  209. package/kit/skills/mobile-design/mobile-debugging.md +122 -0
  210. package/kit/skills/mobile-design/mobile-design-thinking.md +357 -0
  211. package/kit/skills/mobile-design/mobile-navigation.md +458 -0
  212. package/kit/skills/mobile-design/mobile-performance.md +767 -0
  213. package/kit/skills/mobile-design/mobile-testing.md +356 -0
  214. package/kit/skills/mobile-design/mobile-typography.md +433 -0
  215. package/kit/skills/mobile-design/platform-android.md +666 -0
  216. package/kit/skills/mobile-design/platform-ios.md +561 -0
  217. package/kit/skills/mobile-design/scripts/mobile_audit.py +670 -0
  218. package/kit/skills/mobile-design/touch-psychology.md +537 -0
  219. package/kit/skills/negocio-agente-conversa/SKILL.md +168 -0
  220. package/kit/skills/negocio-atendimento/SKILL.md +134 -0
  221. package/kit/skills/negocio-linguagem/SKILL.md +166 -0
  222. package/kit/skills/negocio-preco/SKILL.md +174 -0
  223. package/kit/skills/negocio-preco/scripts/preco.mjs +160 -0
  224. package/kit/skills/negocio-qualificacao/SKILL.md +140 -0
  225. package/kit/skills/nextjs-react-expert/1-async-eliminating-waterfalls.md +351 -0
  226. package/kit/skills/nextjs-react-expert/2-bundle-bundle-size-optimization.md +240 -0
  227. package/kit/skills/nextjs-react-expert/3-server-server-side-performance.md +490 -0
  228. package/kit/skills/nextjs-react-expert/4-client-client-side-data-fetching.md +264 -0
  229. package/kit/skills/nextjs-react-expert/5-rerender-re-render-optimization.md +581 -0
  230. package/kit/skills/nextjs-react-expert/6-rendering-rendering-performance.md +432 -0
  231. package/kit/skills/nextjs-react-expert/7-js-javascript-performance.md +684 -0
  232. package/kit/skills/nextjs-react-expert/8-advanced-advanced-patterns.md +150 -0
  233. package/kit/skills/nextjs-react-expert/9-cache-components.md +103 -0
  234. package/kit/skills/nextjs-react-expert/SKILL.md +308 -0
  235. package/kit/skills/nextjs-react-expert/resources/app-patterns/common-patterns.md +331 -0
  236. package/kit/skills/nextjs-react-expert/resources/app-patterns/complete-examples.md +872 -0
  237. package/kit/skills/nextjs-react-expert/resources/app-patterns/component-patterns.md +502 -0
  238. package/kit/skills/nextjs-react-expert/resources/app-patterns/data-fetching.md +767 -0
  239. package/kit/skills/nextjs-react-expert/resources/app-patterns/file-organization.md +502 -0
  240. package/kit/skills/nextjs-react-expert/resources/app-patterns/loading-and-error-states.md +501 -0
  241. package/kit/skills/nextjs-react-expert/resources/app-patterns/performance.md +406 -0
  242. package/kit/skills/nextjs-react-expert/resources/app-patterns/routing-guide.md +364 -0
  243. package/kit/skills/nextjs-react-expert/resources/app-patterns/styling-guide.md +428 -0
  244. package/kit/skills/nextjs-react-expert/resources/app-patterns/typescript-standards.md +418 -0
  245. package/kit/skills/nextjs-react-expert/scripts/convert_rules.py +222 -0
  246. package/kit/skills/nextjs-react-expert/scripts/react_performance_checker.py +252 -0
  247. package/kit/skills/nodejs-best-practices/SKILL.md +78 -0
  248. package/kit/skills/nodejs-best-practices/references/10-anti-patterns-to-avoid.md +21 -0
  249. package/kit/skills/nodejs-best-practices/references/11-decision-checklist.md +14 -0
  250. package/kit/skills/nodejs-best-practices/references/2-runtime-considerations-2025.md +36 -0
  251. package/kit/skills/nodejs-best-practices/references/3-architecture-principles.md +35 -0
  252. package/kit/skills/nodejs-best-practices/references/4-error-handling-principles.md +42 -0
  253. package/kit/skills/nodejs-best-practices/references/5-async-patterns-principles.md +35 -0
  254. package/kit/skills/nodejs-best-practices/references/6-validation-principles.md +29 -0
  255. package/kit/skills/nodejs-best-practices/references/7-security-principles.md +29 -0
  256. package/kit/skills/nodejs-best-practices/references/8-testing-principles.md +28 -0
  257. package/kit/skills/observability-and-instrumentation/SKILL.md +150 -0
  258. package/kit/skills/opencode-go-exec/SKILL.md +101 -0
  259. package/kit/skills/parallel-agents/SKILL.md +184 -0
  260. package/kit/skills/performance-profiling/SKILL.md +145 -0
  261. package/kit/skills/performance-profiling/scripts/lighthouse_audit.py +76 -0
  262. package/kit/skills/plan-writing/SKILL.md +213 -0
  263. package/kit/skills/powershell-windows/SKILL.md +196 -0
  264. package/kit/skills/provider-orchestration/SKILL.md +269 -0
  265. package/kit/skills/python-patterns/SKILL.md +80 -0
  266. package/kit/skills/python-patterns/references/10-decision-checklist.md +14 -0
  267. package/kit/skills/python-patterns/references/11-anti-patterns-to-avoid.md +20 -0
  268. package/kit/skills/python-patterns/references/2-async-vs-sync-decision.md +44 -0
  269. package/kit/skills/python-patterns/references/3-type-hints-strategy.md +56 -0
  270. package/kit/skills/python-patterns/references/4-project-structure-principles.md +56 -0
  271. package/kit/skills/python-patterns/references/5-django-principles-2025.md +40 -0
  272. package/kit/skills/python-patterns/references/6-fastapi-principles.md +50 -0
  273. package/kit/skills/python-patterns/references/7-background-tasks.md +31 -0
  274. package/kit/skills/python-patterns/references/8-error-handling-principles.md +29 -0
  275. package/kit/skills/python-patterns/references/9-testing-principles.md +37 -0
  276. package/kit/skills/red-team-tactics/SKILL.md +201 -0
  277. package/kit/skills/research/SKILL.md +166 -0
  278. package/kit/skills/rust-pro/SKILL.md +177 -0
  279. package/kit/skills/seo-fundamentals/SKILL.md +130 -0
  280. package/kit/skills/seo-fundamentals/scripts/seo_checker.py +219 -0
  281. package/kit/skills/sequential-thinking/.env.example +8 -0
  282. package/kit/skills/sequential-thinking/README.md +183 -0
  283. package/kit/skills/sequential-thinking/SKILL.md +95 -0
  284. package/kit/skills/sequential-thinking/package.json +31 -0
  285. package/kit/skills/sequential-thinking/references/advanced-strategies.md +79 -0
  286. package/kit/skills/sequential-thinking/references/advanced-techniques.md +76 -0
  287. package/kit/skills/sequential-thinking/references/core-patterns.md +95 -0
  288. package/kit/skills/sequential-thinking/references/examples-api.md +88 -0
  289. package/kit/skills/sequential-thinking/references/examples-architecture.md +94 -0
  290. package/kit/skills/sequential-thinking/references/examples-debug.md +90 -0
  291. package/kit/skills/sequential-thinking/scripts/format-thought.js +159 -0
  292. package/kit/skills/sequential-thinking/scripts/process-thought.js +236 -0
  293. package/kit/skills/server-management/SKILL.md +162 -0
  294. package/kit/skills/simplify-code/SKILL.md +133 -0
  295. package/kit/skills/skillify/SKILL.md +116 -0
  296. package/kit/skills/system-design-interview/SKILL.md +268 -0
  297. package/kit/skills/systematic-debugging/SKILL.md +110 -0
  298. package/kit/skills/tailwind-patterns/SKILL.md +283 -0
  299. package/kit/skills/tailwind-patterns/references/shadcn-ui/canvas-design-system.md +320 -0
  300. package/kit/skills/tailwind-patterns/references/shadcn-ui/shadcn-accessibility.md +471 -0
  301. package/kit/skills/tailwind-patterns/references/shadcn-ui/shadcn-components.md +424 -0
  302. package/kit/skills/tailwind-patterns/references/shadcn-ui/shadcn-theming.md +373 -0
  303. package/kit/skills/tailwind-patterns/references/shadcn-ui/tailwind-customization.md +483 -0
  304. package/kit/skills/tailwind-patterns/references/shadcn-ui/tailwind-responsive.md +382 -0
  305. package/kit/skills/tailwind-patterns/references/shadcn-ui/tailwind-utilities.md +455 -0
  306. package/kit/skills/tdd-workflow/SKILL.md +150 -0
  307. package/kit/skills/testing-patterns/SKILL.md +196 -0
  308. package/kit/skills/testing-patterns/scripts/test_runner.py +219 -0
  309. package/kit/skills/ui-ux-pro-max/SKILL.md +135 -0
  310. package/kit/skills/verify-changes/SKILL.md +125 -0
  311. package/kit/skills/vulnerability-scanner/SKILL.md +278 -0
  312. package/kit/skills/vulnerability-scanner/checklists.md +121 -0
  313. package/kit/skills/vulnerability-scanner/scripts/security_scan.py +458 -0
  314. package/kit/skills/web-design-guidelines/SKILL.md +58 -0
  315. package/kit/skills/webapp-testing/NOTICE.md +6 -0
  316. package/kit/skills/webapp-testing/SKILL.md +188 -0
  317. package/kit/skills/webapp-testing/scripts/playwright_runner.py +173 -0
  318. package/kit/workflows/brainstorm.md +113 -0
  319. package/kit/workflows/coordinate.md +72 -0
  320. package/kit/workflows/create.md +59 -0
  321. package/kit/workflows/debug.md +103 -0
  322. package/kit/workflows/deploy.md +176 -0
  323. package/kit/workflows/enhance.md +63 -0
  324. package/kit/workflows/orchestrate.md +237 -0
  325. package/kit/workflows/plan.md +89 -0
  326. package/kit/workflows/preview.md +81 -0
  327. package/kit/workflows/remember.md +67 -0
  328. package/kit/workflows/status.md +86 -0
  329. package/kit/workflows/test.md +144 -0
  330. package/kit/workflows/ui-ux-pro-max.md +296 -0
  331. package/kit/workflows/verify.md +72 -0
  332. package/licenses/Apache-2.0.txt +202 -0
  333. package/package.json +60 -6
  334. package/scripts/avaliar-vigilancia-mandato.mjs +38 -0
  335. package/scripts/bundle.mjs +158 -0
  336. package/scripts/check-deps.mjs +178 -0
  337. package/scripts/check-models.mjs +150 -0
  338. package/scripts/cli.mjs +295 -0
  339. package/scripts/continuidade-mandato.mjs +47 -0
  340. package/scripts/discriminar-turno.mjs +191 -0
  341. package/scripts/doctor.mjs +615 -0
  342. package/scripts/generate.mjs +676 -0
  343. package/scripts/install.mjs +11 -0
  344. package/scripts/layer-remote.mjs +344 -0
  345. package/scripts/layers.mjs +208 -0
  346. package/scripts/marketplace.mjs +77 -0
  347. package/scripts/product.mjs +32 -0
  348. package/scripts/ruleset-core.mjs +68 -0
  349. package/scripts/social-hooks.mjs +293 -0
  350. package/scripts/social-pacer.mjs +219 -0
  351. package/scripts/validate-bundles.mjs +14 -0
  352. package/scripts/validate-skills.mjs +174 -0
  353. package/scripts/zenkit-daemon-task.cmd +3 -0
@@ -0,0 +1,150 @@
1
+ # 8. Advanced Patterns
2
+
3
+ > **Impact:** VARIABLE
4
+ > **Focus:** Advanced patterns for specific cases that require careful implementation.
5
+
6
+ ---
7
+
8
+ ## Overview
9
+
10
+ This section contains **3 rules** focused on advanced patterns.
11
+
12
+ ---
13
+
14
+ ## Rule 8.1: Initialize App Once, Not Per Mount
15
+
16
+ **Impact:** LOW-MEDIUM
17
+ **Tags:** initialization, useEffect, app-startup, side-effects
18
+
19
+ ## Initialize App Once, Not Per Mount
20
+
21
+ Do not put app-wide initialization that must run once per app load inside `useEffect([])` of a component. Components can remount and effects will re-run. Use a module-level guard or top-level init in the entry module instead.
22
+
23
+ **Incorrect (runs twice in dev, re-runs on remount):**
24
+
25
+ ```tsx
26
+ function Comp() {
27
+ useEffect(() => {
28
+ loadFromStorage()
29
+ checkAuthToken()
30
+ }, [])
31
+
32
+ // ...
33
+ }
34
+ ```
35
+
36
+ **Correct (once per app load):**
37
+
38
+ ```tsx
39
+ let didInit = false
40
+
41
+ function Comp() {
42
+ useEffect(() => {
43
+ if (didInit) return
44
+ didInit = true
45
+ loadFromStorage()
46
+ checkAuthToken()
47
+ }, [])
48
+
49
+ // ...
50
+ }
51
+ ```
52
+
53
+ Reference: [Initializing the application](https://react.dev/learn/you-might-not-need-an-effect#initializing-the-application)
54
+
55
+ ---
56
+
57
+ ## Rule 8.2: Store Event Handlers in Refs
58
+
59
+ **Impact:** LOW
60
+ **Tags:** advanced, hooks, refs, event-handlers, optimization
61
+
62
+ ## Store Event Handlers in Refs
63
+
64
+ Store callbacks in refs when used in effects that shouldn't re-subscribe on callback changes.
65
+
66
+ **Incorrect (re-subscribes on every render):**
67
+
68
+ ```tsx
69
+ function useWindowEvent(event: string, handler: (e) => void) {
70
+ useEffect(() => {
71
+ window.addEventListener(event, handler)
72
+ return () => window.removeEventListener(event, handler)
73
+ }, [event, handler])
74
+ }
75
+ ```
76
+
77
+ **Correct (stable subscription):**
78
+
79
+ ```tsx
80
+ function useWindowEvent(event: string, handler: (e) => void) {
81
+ const handlerRef = useRef(handler)
82
+ useEffect(() => {
83
+ handlerRef.current = handler
84
+ }, [handler])
85
+
86
+ useEffect(() => {
87
+ const listener = (e) => handlerRef.current(e)
88
+ window.addEventListener(event, listener)
89
+ return () => window.removeEventListener(event, listener)
90
+ }, [event])
91
+ }
92
+ ```
93
+
94
+ **Alternative: use `useEffectEvent` if you're on latest React:**
95
+
96
+ ```tsx
97
+ import { useEffectEvent } from 'react'
98
+
99
+ function useWindowEvent(event: string, handler: (e) => void) {
100
+ const onEvent = useEffectEvent(handler)
101
+
102
+ useEffect(() => {
103
+ window.addEventListener(event, onEvent)
104
+ return () => window.removeEventListener(event, onEvent)
105
+ }, [event])
106
+ }
107
+ ```
108
+
109
+ `useEffectEvent` provides a cleaner API for the same pattern: it creates a stable function reference that always calls the latest version of the handler.
110
+
111
+ ---
112
+
113
+ ## Rule 8.3: useEffectEvent for Stable Callback Refs
114
+
115
+ **Impact:** LOW
116
+ **Tags:** advanced, hooks, useEffectEvent, refs, optimization
117
+
118
+ ## useEffectEvent for Stable Callback Refs
119
+
120
+ Access latest values in callbacks without adding them to dependency arrays. Prevents effect re-runs while avoiding stale closures.
121
+
122
+ **Incorrect (effect re-runs on every callback change):**
123
+
124
+ ```tsx
125
+ function SearchInput({ onSearch }: { onSearch: (q: string) => void }) {
126
+ const [query, setQuery] = useState('')
127
+
128
+ useEffect(() => {
129
+ const timeout = setTimeout(() => onSearch(query), 300)
130
+ return () => clearTimeout(timeout)
131
+ }, [query, onSearch])
132
+ }
133
+ ```
134
+
135
+ **Correct (using React's useEffectEvent):**
136
+
137
+ ```tsx
138
+ import { useEffectEvent } from 'react';
139
+
140
+ function SearchInput({ onSearch }: { onSearch: (q: string) => void }) {
141
+ const [query, setQuery] = useState('')
142
+ const onSearchEvent = useEffectEvent(onSearch)
143
+
144
+ useEffect(() => {
145
+ const timeout = setTimeout(() => onSearchEvent(query), 300)
146
+ return () => clearTimeout(timeout)
147
+ }, [query])
148
+ }
149
+ ```
150
+
@@ -0,0 +1,103 @@
1
+ # Cache Components: `use cache` & `cacheLife`
2
+
3
+ > [!IMPORTANT]
4
+ > This is a Next.js 16+ specific skill. Do NOT apply these patterns to Next.js 15 or earlier without explicitly checking compatibility.
5
+
6
+ ## Core Philosophy
7
+ Next.js 16 marks the transition from "Segment-level caching" to "Component-level caching". We no longer rely on `export const revalidate = 3600`. Instead, we use granular directives and profiles.
8
+
9
+ ## 1. The `use cache` Directive
10
+ The `use cache` directive can be applied to **Server Components** or **Functions**.
11
+
12
+ ### Rule: Granular Application
13
+ Wrap only the data-fetching logic or the specific component that needs caching.
14
+
15
+ ```tsx
16
+ // Good: Granular function caching
17
+ async function getProduct(id: string) {
18
+ 'use cache'
19
+ return await db.product.findUnique({ where: { id } })
20
+ }
21
+
22
+ // Good: Component-level caching
23
+ export default async function ProductCard({ id }: { id: string }) {
24
+ 'use cache'
25
+ const product = await getProduct(id)
26
+ return <div>{product.name}</div>
27
+ }
28
+ ```
29
+
30
+ ## 2. Using `cacheLife`
31
+ `cacheLife` defines the "Freshness" and "Staleness" of a cached item using pre-defined or custom profiles.
32
+
33
+ ### Usage Pattern
34
+ ```tsx
35
+ import { cacheLife } from 'next/cache'
36
+
37
+ async function getStockInfo() {
38
+ 'use cache'
39
+ cacheLife('minutes') // Using a pre-defined profile
40
+ return await fetchStocks()
41
+ }
42
+ ```
43
+
44
+ ### Profile Reference
45
+ - `default`: Base profile (1 year stale time).
46
+ - `seconds`: High-frequency updates.
47
+ - `minutes`: Standard dynamic content.
48
+ - `hours`: Stable content (e.g., blog posts).
49
+ - `days`: Semi-static content.
50
+ - `weeks`: Static-like content.
51
+ - `max`: Permanent cache until invalidated.
52
+
53
+ ## 3. On-Demand Invalidation with `cacheTag`
54
+ `cacheTag` allows you to label cached data for selective purging.
55
+
56
+ ### Implementation
57
+ ```tsx
58
+ import { cacheTag } from 'next/cache'
59
+
60
+ async function getProfile(user: string) {
61
+ 'use cache'
62
+ cacheTag(`profile-${user}`)
63
+ return await db.user.findUnique(...)
64
+ }
65
+ ```
66
+
67
+ ### Revalidation
68
+ In a Server Action:
69
+ ```tsx
70
+ import { revalidateTag, updateTag } from 'next/cache'
71
+
72
+ export async function updateProfile(user: string, data: any) {
73
+ await db.user.update(...)
74
+
75
+ // Choice A: Background revalidation (Stale-While-Revalidate)
76
+ revalidateTag(`profile-${user}`)
77
+
78
+ // Choice B: Immediate "Read-Your-Writes" update
79
+ updateTag(`profile-${user}`)
80
+ }
81
+ ```
82
+
83
+ ## 4. Partial Pre-Rendering (PPR)
84
+ Next.js 16 stabilizes PPR via the `cacheComponents` flag in `next.config.ts`.
85
+
86
+ ### Pattern: Suspense Boundaries
87
+ Always wrap dynamic "Cache Components" in `<Suspense>` to enable PPR.
88
+
89
+ ```tsx
90
+ import { Suspense } from 'react'
91
+ import { Skeleton } from '@/components/ui/skeleton'
92
+
93
+ export default function Page() {
94
+ return (
95
+ <main>
96
+ <h1>Static Header</h1>
97
+ <Suspense fallback={<Skeleton />}>
98
+ <DynamicCacheComponent />
99
+ </Suspense>
100
+ </main>
101
+ )
102
+ }
103
+ ```
@@ -0,0 +1,308 @@
1
+ ---
2
+ name: nextjs-react-expert
3
+ description: React and Next.js performance optimization from Vercel Engineering. Use when building React components, optimizing performance, eliminating waterfalls, reducing bundle size, reviewing code for performance issues, or implementing server/client-side optimizations.
4
+ when_to_use: "When building React components, optimizing Next.js performance, eliminating waterfalls, or reducing bundle size. For React/Next.js web projects."
5
+ allowed-tools: Read, Write, Edit, Glob, Grep, Bash
6
+ ---
7
+
8
+ # Next.js & React Performance Expert
9
+
10
+ > **From Vercel Engineering** - 57 optimization rules prioritized by impact
11
+ > **Philosophy:** Eliminate waterfalls first, optimize bundles second, then micro-optimize.
12
+
13
+ ---
14
+
15
+ ## 🎯 Selective Reading Rule (MANDATORY)
16
+
17
+ **Read ONLY sections relevant to your task!** Check the content map below and load what you need.
18
+
19
+ > 🔴 **For performance reviews: Start with CRITICAL sections (1-2), then move to HIGH/MEDIUM.**
20
+
21
+ ---
22
+
23
+ ## 📑 Content Map
24
+
25
+ | File | Impact | Rules | When to Read |
26
+ | --------------------------------------- | ------------------ | -------- | --------------------------------------------------------------- |
27
+ | `1-async-eliminating-waterfalls.md` | 🔴 **CRITICAL** | 5 rules | Slow page loads, sequential API calls, data fetching waterfalls |
28
+ | `2-bundle-bundle-size-optimization.md` | 🔴 **CRITICAL** | 5 rules | Large bundle size, slow Time to Interactive, First Load issues |
29
+ | `3-server-server-side-performance.md` | 🟠 **HIGH** | 7 rules | Slow SSR, API route optimization, server-side waterfalls |
30
+ | `4-client-client-side-data-fetching.md` | 🟡 **MEDIUM-HIGH** | 4 rules | Client data management, SWR patterns, deduplication |
31
+ | `5-rerender-re-render-optimization.md` | 🟡 **MEDIUM** | 12 rules | Excessive re-renders, React performance, memoization |
32
+ | `6-rendering-rendering-performance.md` | 🟡 **MEDIUM** | 9 rules | Rendering bottlenecks, virtualization, image optimization |
33
+ | `7-js-javascript-performance.md` | ⚪ **LOW-MEDIUM** | 12 rules | Micro-optimizations, caching, loop performance |
34
+ | `8-advanced-advanced-patterns.md` | 🔵 **VARIABLE** | 3 rules | Advanced React patterns, useLatest, init-once |
35
+ | `9-cache-components.md` | 🔴 **CRITICAL** | 4 sections | **Next.js 16+ Only**: `use cache`, `cacheLife`, PPR, `cacheTag` |
36
+
37
+ **Total: 57 rules across 8 categories**
38
+
39
+ ### App patterns (cursor-kit merged)
40
+
41
+ | File | When to Read |
42
+ |------|--------------|
43
+ | `resources/app-patterns/component-patterns.md` | New React components |
44
+ | `resources/app-patterns/data-fetching.md` | TanStack Query / Suspense |
45
+ | `resources/app-patterns/routing-guide.md` | TanStack Router setup |
46
+ | `resources/app-patterns/file-organization.md` | Feature folder structure |
47
+ | `resources/app-patterns/loading-and-error-states.md` | Suspense boundaries |
48
+ | `resources/app-patterns/styling-guide.md` | MUI v7 styling |
49
+ | `resources/app-patterns/typescript-standards.md` | TS conventions |
50
+ | `resources/app-patterns/common-patterns.md` | Reusable UI patterns |
51
+ | `resources/app-patterns/complete-examples.md` | Full feature examples |
52
+
53
+ ---
54
+
55
+ ## 🚀 Quick Decision Tree
56
+
57
+ **What's your performance issue?**
58
+
59
+ ```
60
+ 🐌 Slow page loads / Long Time to Interactive
61
+ → Read Section 1: Eliminating Waterfalls
62
+ → Read Section 2: Bundle Size Optimization
63
+
64
+ 📦 Large bundle size (> 200KB)
65
+ → Read Section 2: Bundle Size Optimization
66
+ → Check: Dynamic imports, barrel imports, tree-shaking
67
+
68
+ 🖥️ Slow Server-Side Rendering
69
+ → Read Section 3: Server-Side Performance
70
+ → Check: Parallel data fetching, streaming
71
+
72
+ 🔄 Too many re-renders / UI lag
73
+ → Read Section 5: Re-render Optimization
74
+ → Check: React.memo, useMemo, useCallback
75
+
76
+ 🎨 Rendering performance issues
77
+ → Read Section 6: Rendering Performance
78
+ → Check: Virtualization, layout thrashing
79
+
80
+ 🌐 Client-side data fetching problems
81
+ → Read Section 4: Client-Side Data Fetching
82
+ → Check: SWR deduplication, localStorage
83
+
84
+ ✨ Need advanced patterns
85
+ → Read Section 8: Advanced Patterns
86
+
87
+ 🚀 **Next.js 16+ Performance (Caching & PPR)**
88
+ → Read Section 9: Cache Components
89
+ ```
90
+
91
+ ---
92
+
93
+ ## 📊 Impact Priority Guide
94
+
95
+ **Use this order when doing comprehensive optimization:**
96
+
97
+ ```
98
+ 1️⃣ CRITICAL (Biggest Gains - Do First):
99
+ ├─ Section 1: Eliminating Waterfalls
100
+ │ └─ Each waterfall adds full network latency (100-500ms+)
101
+ └─ Section 2: Bundle Size Optimization
102
+ └─ Affects Time to Interactive and Largest Contentful Paint
103
+
104
+ 2️⃣ HIGH (Significant Impact - Do Second):
105
+ └─ Section 3: Server-Side Performance
106
+ └─ Eliminates server-side waterfalls, faster response times
107
+
108
+ 3️⃣ MEDIUM (Moderate Gains - Do Third):
109
+ ├─ Section 4: Client-Side Data Fetching
110
+ ├─ Section 5: Re-render Optimization
111
+ └─ Section 6: Rendering Performance
112
+
113
+ 4️⃣ LOW (Polish - Do Last):
114
+ ├─ Section 7: JavaScript Performance
115
+ └─ Section 8: Advanced Patterns
116
+
117
+ 🔥 **MODERN (Next.js 16+):**
118
+ └─ Section 9: Cache Components (Replaces most traditional revalidation)
119
+ ```
120
+
121
+ ---
122
+
123
+ ## 🔗 Related Skills
124
+
125
+ | Need | Skill |
126
+ | ----------------------- | --------------------------------- |
127
+ | API design patterns | `@[skills/api-patterns]` |
128
+ | Database optimization | `@[skills/database-design]` |
129
+ | Testing strategies | `@[skills/testing-patterns]` |
130
+ | UI/UX design principles | `@[skills/frontend-design]` |
131
+ | TypeScript patterns | `@[skills/typescript-expert]` |
132
+ | Deployment & DevOps | `@[skills/deployment-procedures]` |
133
+
134
+ ---
135
+
136
+ ## ✅ Performance Review Checklist
137
+
138
+ Before shipping to production:
139
+
140
+ **Critical (Must Fix):**
141
+
142
+ - [ ] No sequential data fetching (waterfalls eliminated)
143
+ - [ ] Bundle size < 200KB for main bundle
144
+ - [ ] No barrel imports in app code
145
+ - [ ] Dynamic imports used for large components
146
+ - [ ] Parallel data fetching where possible
147
+
148
+ **High Priority:**
149
+
150
+ - [ ] Server components used where appropriate
151
+ - [ ] API routes optimized (no N+1 queries)
152
+ - [ ] Suspense boundaries for data fetching
153
+ - [ ] Static generation used where possible
154
+
155
+ **Medium Priority:**
156
+
157
+ - [ ] Expensive computations memoized
158
+ - [ ] List rendering virtualized (if > 100 items)
159
+ - [ ] Images optimized with next/image
160
+ - [ ] No unnecessary re-renders
161
+
162
+ **Low Priority (Polish):**
163
+
164
+ - [ ] Hot path loops optimized
165
+ - [ ] RegExp patterns hoisted
166
+ - [ ] Property access cached in loops
167
+
168
+ ---
169
+
170
+ ## ❌ Anti-Patterns (Common Mistakes)
171
+
172
+ **DON'T:**
173
+
174
+ - ❌ Use sequential `await` for independent operations
175
+ - ❌ Import entire libraries when you need one function
176
+ - ❌ Use barrel exports (`index.ts` re-exports) in app code
177
+ - ❌ Skip dynamic imports for large components/libraries
178
+ - ❌ Fetch data in useEffect without deduplication
179
+ - ❌ Forget to memoize expensive computations
180
+ - ❌ Use client components when server components work
181
+
182
+ **DO:**
183
+
184
+ - ✅ Fetch data in parallel with `Promise.all()`
185
+ - ✅ Use dynamic imports: `const Comp = dynamic(() => import('./Heavy'))`
186
+ - ✅ Import directly: `import { specific } from 'library/specific'`
187
+ - ✅ Use Suspense boundaries for better UX
188
+ - ✅ Leverage React Server Components
189
+ - ✅ Measure performance before optimizing
190
+ - ✅ Use Next.js built-in optimizations (next/image, next/font)
191
+
192
+ ---
193
+
194
+ ## 🎯 How to Use This Skill
195
+
196
+ ### For New Features:
197
+
198
+ 1. Check **Section 1 & 2** while building (prevent waterfalls, keep bundle small)
199
+ 2. Use server components by default (Section 3)
200
+ 3. Apply memoization for expensive operations (Section 5)
201
+
202
+ ### For Performance Reviews:
203
+
204
+ 1. Start with **Section 1** (waterfalls = biggest impact)
205
+ 2. Then **Section 2** (bundle size)
206
+ 3. Then **Section 3** (server-side)
207
+ 4. Finally other sections as needed
208
+
209
+ ### For Debugging Slow Performance:
210
+
211
+ 1. Identify the symptom (slow load, lag, etc.)
212
+ 2. Use Quick Decision Tree above
213
+ 3. Read relevant section
214
+ 4. Apply fixes in priority order
215
+
216
+ ---
217
+
218
+ ## 📚 Learning Path
219
+
220
+ **Beginner (Focus on Critical):**
221
+ → Section 1: Eliminating Waterfalls
222
+ → Section 2: Bundle Size Optimization
223
+
224
+ **Intermediate (Add High Priority):**
225
+ → Section 3: Server-Side Performance
226
+ → Section 5: Re-render Optimization
227
+
228
+ **Advanced (Full Optimization):**
229
+ → All sections + Section 8: Advanced Patterns
230
+
231
+ ---
232
+
233
+ ## 🔍 Validation Script
234
+
235
+ | Script | Purpose | Command |
236
+ | -------------------------------------- | --------------------------- | ------------------------------------------------------------ |
237
+ | `scripts/react_performance_checker.py` | Automated performance audit | `python scripts/react_performance_checker.py <project_path>` |
238
+
239
+ ---
240
+
241
+ ## 📖 Section Details
242
+
243
+ ### Section 1: Eliminating Waterfalls (CRITICAL)
244
+
245
+ **Impact:** Each waterfall adds 100-500ms+ latency
246
+ **Key Concepts:** Parallel fetching, Promise.all(), Suspense boundaries, preloading
247
+
248
+ ### Section 2: Bundle Size Optimization (CRITICAL)
249
+
250
+ **Impact:** Directly affects Time to Interactive, Largest Contentful Paint
251
+ **Key Concepts:** Dynamic imports, tree-shaking, barrel import avoidance
252
+
253
+ ### Section 3: Server-Side Performance (HIGH)
254
+
255
+ **Impact:** Faster server responses, better SEO
256
+ **Key Concepts:** Parallel server fetching, streaming, API route optimization
257
+
258
+ ### Section 4: Client-Side Data Fetching (MEDIUM-HIGH)
259
+
260
+ **Impact:** Reduces redundant requests, better UX
261
+ **Key Concepts:** SWR deduplication, localStorage caching, event listeners
262
+
263
+ ### Section 5: Re-render Optimization (MEDIUM)
264
+
265
+ **Impact:** Smoother UI, less wasted computation
266
+ **Key Concepts:** React.memo, useMemo, useCallback, component structure
267
+
268
+ ### Section 6: Rendering Performance (MEDIUM)
269
+
270
+ **Impact:** Better rendering efficiency
271
+ **Key Concepts:** Virtualization, image optimization, layout thrashing
272
+
273
+ ### Section 7: JavaScript Performance (LOW-MEDIUM)
274
+
275
+ **Impact:** Incremental improvements in hot paths
276
+ **Key Concepts:** Loop optimization, caching, RegExp hoisting
277
+
278
+ ### Section 8: Advanced Patterns (VARIABLE)
279
+
280
+ **Impact:** Specific use cases
281
+ **Key Concepts:** useLatest hook, init-once patterns, event handler refs
282
+
283
+ ---
284
+
285
+ ## 🎓 Best Practices Summary
286
+
287
+ **Golden Rules:**
288
+
289
+ 1. **Measure first** - Use React DevTools Profiler, Chrome DevTools
290
+ 2. **Biggest impact first** - Waterfalls → Bundle → Server → Micro
291
+ 3. **Don't over-optimize** - Focus on real bottlenecks
292
+ 4. **Use platform features** - Next.js has optimizations built-in
293
+ 5. **Think about users** - Real-world conditions matter
294
+
295
+ **Performance Mindset:**
296
+
297
+ - Every `await` in sequence = potential waterfall
298
+ - Every `import` = potential bundle bloat
299
+ - Every re-render = wasted computation (if unnecessary)
300
+ - Server components = less JavaScript to ship
301
+ - Measure, don't guess
302
+
303
+ ---
304
+
305
+ **Source:** Vercel Engineering
306
+ **Date:** January 2026
307
+ **Version:** 1.0.0
308
+ **Total Rules:** 57 across 8 categories