@zenrick/zenkit 0.0.0-stage → 0.5.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 (355) 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/archive-codex-rollouts.ps1 +35 -0
  335. package/scripts/avaliar-vigilancia-mandato.mjs +38 -0
  336. package/scripts/bundle.mjs +170 -0
  337. package/scripts/check-deps.mjs +178 -0
  338. package/scripts/check-models.mjs +150 -0
  339. package/scripts/cli.mjs +313 -0
  340. package/scripts/content-checks.mjs +18 -0
  341. package/scripts/continuidade-mandato.mjs +47 -0
  342. package/scripts/discriminar-turno.mjs +191 -0
  343. package/scripts/doctor.mjs +611 -0
  344. package/scripts/generate.mjs +688 -0
  345. package/scripts/install.mjs +11 -0
  346. package/scripts/layer-remote.mjs +407 -0
  347. package/scripts/layers.mjs +208 -0
  348. package/scripts/marketplace.mjs +77 -0
  349. package/scripts/product.mjs +32 -0
  350. package/scripts/ruleset-core.mjs +68 -0
  351. package/scripts/social-hooks.mjs +293 -0
  352. package/scripts/social-pacer.mjs +219 -0
  353. package/scripts/validate-bundles.mjs +14 -0
  354. package/scripts/validate-skills.mjs +174 -0
  355. package/scripts/zenkit-daemon-task.cmd +3 -0
@@ -0,0 +1,177 @@
1
+ ---
2
+ name: entrega-com-agentes
3
+ description: Orquestra o fluxo de entrega de feature em fases com portões (brainstorm, plano, implementação, teste, revisão, entrega), no estilo Superpowers. Não substitui as skills de fase; delega para elas.
4
+ when_to_use: "Quando uma demanda de engenharia pede feature nova, entrega ponta a ponta, ou processo explícito brainstorm→plano→código→teste→revisão. Use com demandas registradas, worktree isolada e zenkit-bridge quando disponível. NOT para typo ou one-liner sem plano."
5
+ allowed-tools: Read, Glob, Grep, Bash
6
+ effort: high
7
+ ---
8
+
9
+ # Entrega com agentes
10
+
11
+ > Fonte de método: obra/superpowers. Esta skill é o **maestro**: define fases, portões e handoffs. O conteúdo de cada fase vive nas skills referenciadas; não copie daqui para lá.
12
+
13
+ ## Propósito
14
+
15
+ Entregar uma feature como **pipeline com portões**, não como um turno solto:
16
+
17
+ ```
18
+ brainstorm → plano → implementação → teste/verificação → revisão → entrega
19
+ ```
20
+
21
+ Cada fase produz um artefato verificável. Só avança quando o portão de saída é verdadeiro. O flagship (sessão atual cara) **planeja e revisa**; a escrita em massa vai para `dispatch_handoff` → executor padrão **Cursor `composer-2.5`** (ZENKIT §2), salvo pedido explícito do humano por outro provider (`provider-orchestration`).
22
+
23
+ ## Antes de começar (estado do projeto + escopo)
24
+
25
+ 1. Ler o estado do projeto e conferir quem mais trabalha no repositório (ZENKIT §0, §8).
26
+ 2. Registrar a tarefa onde o time acompanha (issue ou demanda) quando houver id.
27
+ 3. Avisar o escopo: arquivos previstos e branch.
28
+ 4. Carregar só o índice desta skill; em cada fase, abrir **uma** skill filha.
29
+
30
+ **Unidade de trabalho:** a demanda inteira (ZENKIT §10). Não pergunte entre fases já escritas neste fluxo. Pare só em fork legítimo (§10.2).
31
+
32
+ ---
33
+
34
+ ## Visão das fases
35
+
36
+ | Fase | Skill que executa |
37
+ | --- | --- |
38
+ | Brainstorm | `@[skills/brainstorming]` |
39
+ | Plano | `@[skills/plan-writing]` |
40
+ | Implementação | `@[skills/git-worktrees]` + bridge `dispatch_handoff` + `@[skills/parallel-agents]` quando couber |
41
+ | Teste | `@[skills/tdd-workflow]` + `@[skills/verify-changes]` |
42
+ | Revisão | MCP `gate_diff` + `@[skills/code-review-checklist]` |
43
+ | Entrega | estado do projeto atualizado + passos humanos de PR/deploy (fork) |
44
+
45
+ ---
46
+
47
+ ## Fase 1: Brainstorm
48
+
49
+ | | |
50
+ | --- | --- |
51
+ | **Entrada** | Pedido bruto de feature, contexto do produto, restrições conhecidas. |
52
+ | **Saída (artefato)** | **Spec curta** (máx. ~1 página): problema, usuários, must-have vs nice-to-have, decisões tomadas, perguntas ainda abertas (se houver fork). |
53
+ | **Skill** | `@[skills/brainstorming]` (Portão Socrático quando requisito vago; exceções triviais em ZENKIT §5). |
54
+ | **Portão de saída** | Spec sem ambiguidade bloqueante; decisões P0 registradas (`/remember` ou `store_knowledge` se durável); escopo fechado para planejar. |
55
+
56
+ ---
57
+
58
+ ## Fase 2: Plano
59
+
60
+ | | |
61
+ | --- | --- |
62
+ | **Entrada** | Spec curta aprovada (implicitamente, se o processo já a descreveu). |
63
+ | **Saída (artefato)** | Arquivo `{task-slug}.md` na **raiz do projeto** com 5 a 10 tarefas de 2 a 5 min cada: caminhos de arquivo exatos, dependências, e **comando de verificação por tarefa** (ex.: `npx tsc --noEmit`, `npm test -- path/to.test.ts`). Fase final do plano = verificação global. |
64
+ | **Skill** | `@[skills/plan-writing]`. Se bridge ativo: `gate_dispatch` com o texto do plano antes de executar. |
65
+ | **Portão de saída** | Plano cabe em uma página; toda tarefa tem verificação; última fase é verificação; `gate_dispatch` retorna `dispatch` (não `needs_plan` / `stop` / `human` sem resolução). |
66
+
67
+ ---
68
+
69
+ ## Fase 3: Implementação
70
+
71
+ | | |
72
+ | --- | --- |
73
+ | **Entrada** | Plano aprovado pelo gate (ou equivalente nativo se o bridge falhou). |
74
+ | **Saída (artefato)** | **Diff** no worktree (branch dedicada), commits atômicos alinhados ao plano, notas curtas do que cada tarefa tocou. |
75
+ | **Skills** | `@[skills/git-worktrees]` para isolar; `dispatch_handoff` (`plan`, `repo`, modo write) via zenkit-bridge; `@[skills/cursor-exec]` / `@[skills/provider-orchestration]` se executar fora do MCP. Tarefas **independentes** no plano: um subagente novo por tarefa (`@[skills/parallel-agents]`). |
76
+ | **Portão de saída** | `dispatch_status` com estado terminal `ran` (ou implementação nativa equivalente); diff capturado; nenhuma tarefa do plano de implementação pendente; branch correta (`git branch --show-current`). |
77
+
78
+ Exemplo de handoff (bridge disponível):
79
+
80
+ ```json
81
+ {
82
+ "tool": "dispatch_handoff",
83
+ "arguments": {
84
+ "plan": "<conteúdo do {task-slug}.md>",
85
+ "repo": "<caminho absoluto do repo ou worktree>",
86
+ "mode": "write",
87
+ "executor": "cursor"
88
+ }
89
+ }
90
+ ```
91
+
92
+ Flagship **não** digita o diff quando o plano existe: revisa depois (ZENKIT §2).
93
+
94
+ ---
95
+
96
+ ## Fase 4: Teste e verificação
97
+
98
+ | | |
99
+ | --- | --- |
100
+ | **Entrada** | Diff da implementação no worktree correto. |
101
+ | **Saída (artefato)** | Saída literal dos verificadores: exit code + trecho relevante do log; ciclo TDD documentado (RED/GREEN/REFACTOR) quando aplicável. |
102
+ | **Skills** | `@[skills/tdd-workflow]` para comportamento novo; `@[skills/verify-changes]` para provar por execução, não por inspeção. |
103
+ | **Portão de saída** | **Definição de Pronto** ZENKIT §9: para código, `tsc --noEmit` **e** suíte de testes verdes **depois da última edição**. Verificador que não rodou **não é evidência** (§9.1). Lacunas declaradas como `não verificado: <motivo>`. |
104
+
105
+ Ordem típica no worktree:
106
+
107
+ ```bash
108
+ npx tsc --noEmit
109
+ npm test
110
+ ```
111
+
112
+ Ajuste aos comandos do plano quando o projeto usar outro harness.
113
+
114
+ ---
115
+
116
+ ## Fase 5: Revisão
117
+
118
+ | | |
119
+ | --- | --- |
120
+ | **Entrada** | Plano + diff + evidências de teste. |
121
+ | **Saída (artefato)** | Resultado de `gate_diff` + checklist preenchido; lista de achados (crítico / menor / nit). |
122
+ | **Skills** | MCP `gate_diff` (`plan`, `diff`, `slug`); `@[skills/code-review-checklist]` para passada humana ou do flagship. |
123
+ | **Portão de saída** | Decisão `light_review` aceitável sem achados críticos; `deep_review` ou `human` exige resolução antes de entregar. Achado **crítico** (correção, segurança, fora do plano) → volta para **Fase 3** no mesmo worktree, depois repete teste e revisão. |
124
+
125
+ ---
126
+
127
+ ## Fase 6: Entrega
128
+
129
+ | | |
130
+ | --- | --- |
131
+ | **Entrada** | Revisão aprovada, evidência de teste, estado da demanda. |
132
+ | **Saída (artefato)** | Demanda atualizada no registro do projeto; worktree higienizado quando mergeado; estado do projeto atualizado; handoff ao humano para PR/merge/deploy (fork §10.2). |
133
+ | **Skills** | `@[skills/quadro-agentes]` para quadro; ZENKIT §7 para ciclo `code-complete` → `in-review` → … quando o processo de demanda exigir. |
134
+ | **Portão de saída** | Estado da demanda reflete o estágio real; `release_work`; `git worktree remove` + `prune` após merge; sem WIP órfão. |
135
+
136
+ ---
137
+
138
+ ## Regras de fluxo (ZENKIT §10)
139
+
140
+ 1. **Demanda, não passo:** execute todas as fases até bloqueio real; não use `question` para "posso ir para o plano?".
141
+ 2. **Forks legítimos only:** credencial, irreversível externo (PR, prod), dinheiro, spec ambígua, dado só do humano.
142
+ 3. **Bridge falhou:** reporte o erro; continue com ferramentas nativas (edit, bash, worktree) sem alegar que estão desabilitadas (§2).
143
+ 4. **Escopo congelado na implementação:** mudança de escopo volta ao brainstorm ou exige adendo explícito ao plano (novo `gate_dispatch`).
144
+
145
+ ---
146
+
147
+ ## Anti-padrões
148
+
149
+ | Anti-padrão | Por que falha |
150
+ | --- | --- |
151
+ | Pular brainstorm/plano e codar | Sem spec e sem verificação por tarefa; drift garantido. |
152
+ | Plano sem comando de verificação em cada tarefa | §9 bloqueia "concluído"; executor inventa sucesso. |
153
+ | "Testei" sem colar saída do comando | §9.1 fail-closed; falso positivo. |
154
+ | Mudar escopo no meio da implementação | Diff não casa com plano; `gate_diff` → `deep_review` ou retrabalho. |
155
+ | Flagship digitando em massa com plano pronto | Queima cota; viola §2; use `dispatch_handoff`. |
156
+ | Perguntar entre fases deste fluxo | Viola §10; só fork legítimo. |
157
+
158
+ ---
159
+
160
+ ## Checklist final (antes de declarar entrega)
161
+
162
+ - [ ] Spec curta arquivada ou referenciada na demanda
163
+ - [ ] Plano `{task-slug}.md` na raiz com verificações por tarefa
164
+ - [ ] Worktree/branch corretos; diff revisável
165
+ - [ ] `tsc --noEmit` e suíte verdes após última edição (ou `não verificado` declarado)
166
+ - [ ] `gate_diff` + checklist sem críticos abertos
167
+ - [ ] Registro do projeto: tarefa atualizada, escopo liberado
168
+ - [ ] Worktree removido após merge (quando aplicável)
169
+
170
+ ---
171
+
172
+ ## Referências rápidas
173
+
174
+ - Router e executor: `kit/rules/ZENKIT.mdc` §2
175
+ - Pronto e evidência: §9
176
+ - Unidade de trabalho: §10
177
+ - Gates: `packages/zenkit-bridge/README.md` (`gate_dispatch`, `dispatch_handoff`, `gate_diff`)
@@ -0,0 +1,6 @@
1
+ # Aviso
2
+
3
+ Esta skill deriva de `skills/frontend-design` em https://github.com/anthropics/skills,
4
+ licenciada sob a Apache License 2.0 (texto em `licenses/Apache-2.0.txt` no pacote do ZenKit).
5
+
6
+ Os arquivos foram modificados e ampliados pela Zenrick em 2026.
@@ -0,0 +1,456 @@
1
+ ---
2
+ name: frontend-design
3
+ description: Design thinking and decision-making for web UI. Use when designing components, layouts, color schemes, typography, or creating aesthetic interfaces. Teaches principles, not fixed values.
4
+ when_to_use: "When designing web UI components, choosing color schemes, typography, layouts, or creating aesthetic interfaces. NOT for mobile apps."
5
+ allowed-tools: Read, Write, Edit, Glob, Grep, Bash
6
+ ---
7
+
8
+ # Frontend Design System
9
+
10
+ > **Philosophy:** Every pixel has purpose. Restraint is luxury. User psychology drives decisions.
11
+ > **Core Principle:** THINK, don't memorize. ASK, don't assume.
12
+
13
+ ---
14
+
15
+ ## 🎯 Selective Reading Rule (MANDATORY)
16
+
17
+ **Read REQUIRED files always, OPTIONAL only when needed:**
18
+
19
+ | File | Status | When to Read |
20
+ |------|--------|--------------|
21
+ | [ux-psychology.md](ux-psychology.md) | 🔴 **REQUIRED** | Always read first! |
22
+ | [color-system.md](color-system.md) | ⚪ Optional | Color/palette decisions |
23
+ | [typography-system.md](typography-system.md) | ⚪ Optional | Font selection/pairing |
24
+ | [visual-effects.md](visual-effects.md) | ⚪ Optional | Glassmorphism, shadows, gradients |
25
+ | [animation-guide.md](animation-guide.md) | ⚪ Optional | Animation needed |
26
+ | [motion-graphics.md](motion-graphics.md) | ⚪ Optional | Lottie, GSAP, 3D |
27
+ | [decision-trees.md](decision-trees.md) | ⚪ Optional | Context templates |
28
+ | [references/aesthetic/design-principles.md](references/aesthetic/design-principles.md) | ⚪ Optional | Storytelling, distinctive UI |
29
+ | [references/aesthetic/micro-interactions.md](references/aesthetic/micro-interactions.md) | ⚪ Optional | Motion and feedback |
30
+ | [references/aesthetic/storytelling-design.md](references/aesthetic/storytelling-design.md) | ⚪ Optional | Narrative-driven layouts |
31
+
32
+ > 🔴 **ux-psychology.md = ALWAYS READ. Others = only if relevant.**
33
+
34
+ ---
35
+
36
+ ## 🔧 Runtime Scripts
37
+
38
+ **Execute these for audits (don't read, just run):**
39
+
40
+ | Script | Purpose | Usage |
41
+ |--------|---------|-------|
42
+ | `scripts/ux_audit.py` | UX Psychology & Accessibility Audit | `python scripts/ux_audit.py <project_path>` |
43
+
44
+ ---
45
+
46
+ ## ⚠️ CRITICAL: ASK BEFORE ASSUMING (MANDATORY)
47
+
48
+ > **STOP! If the user's request is open-ended, DO NOT default to your favorites.**
49
+
50
+ ### When User Prompt is Vague, ASK:
51
+
52
+ **Color not specified?** Ask:
53
+ > "What color palette do you prefer? (blue/green/orange/neutral/other?)"
54
+
55
+ **Style not specified?** Ask:
56
+ > "What style are you going for? (minimal/bold/retro/futuristic/organic?)"
57
+
58
+ **Layout not specified?** Ask:
59
+ > "Do you have a layout preference? (single column/grid/asymmetric/full-width?)"
60
+
61
+ ### ⛔ DEFAULT TENDENCIES TO AVOID (ANTI-SAFE HARBOR):
62
+
63
+ | AI Default Tendency | Why It's Bad | Think Instead |
64
+ |---------------------|--------------|---------------|
65
+ | **Bento Grids (Modern Cliché)** | Used in every AI design | Why does this content NEED a grid? |
66
+ | **Hero Split (Left/Right)** | Predictable & Boring | How about Massive Typography or Vertical Narrative? |
67
+ | **Mesh/Aurora Gradients** | The "new" lazy background | What's a radical color pairing? |
68
+ | **Glassmorphism** | AI's idea of "premium" | How about solid, high-contrast flat? |
69
+ | **Deep Cyan / Fintech Blue** | Safe harbor from purple ban | Why not Red, Black, or Neon Green? |
70
+ | **"Orchestrate / Empower"** | AI-generated copywriting | How would a human say this? |
71
+ | Dark background + neon glow | Overused, "AI look" | What does the BRAND actually need? |
72
+ | **Rounded everything** | Generic/Safe | Where can I use sharp, brutalist edges? |
73
+
74
+ > 🔴 **"Every 'safe' structure you choose brings you one step closer to a generic template. TAKE RISKS."**
75
+
76
+ ---
77
+
78
+ ## 1. Constraint Analysis (ALWAYS FIRST)
79
+
80
+ Before any design work, ANSWER THESE or ASK USER:
81
+
82
+ | Constraint | Question | Why It Matters |
83
+ |------------|----------|----------------|
84
+ | **Timeline** | How much time? | Determines complexity |
85
+ | **Content** | Ready or placeholder? | Affects layout flexibility |
86
+ | **Brand** | Existing guidelines? | May dictate colors/fonts |
87
+ | **Tech** | What stack? | Affects capabilities |
88
+ | **Audience** | Who exactly? | Drives all visual decisions |
89
+
90
+ ### Audience → Design Approach
91
+
92
+ | Audience | Think About |
93
+ |----------|-------------|
94
+ | **Gen Z** | Bold, fast, mobile-first, authentic |
95
+ | **Millennials** | Clean, minimal, value-driven |
96
+ | **Gen X** | Familiar, trustworthy, clear |
97
+ | **Boomers** | Readable, high contrast, simple |
98
+ | **B2B** | Professional, data-focused, trust |
99
+ | **Luxury** | Restrained elegance, whitespace |
100
+
101
+ ---
102
+
103
+ ## 2. UX Psychology Principles
104
+
105
+ ### Core Laws (Internalize These)
106
+
107
+ | Law | Principle | Application |
108
+ |-----|-----------|-------------|
109
+ | **Hick's Law** | More choices = slower decisions | Limit options, use progressive disclosure |
110
+ | **Fitts' Law** | Bigger + closer = easier to click | Size CTAs appropriately |
111
+ | **Miller's Law** | ~7 items in working memory | Chunk content into groups |
112
+ | **Von Restorff** | Different = memorable | Make CTAs visually distinct |
113
+ | **Serial Position** | First/last remembered most | Key info at start/end |
114
+
115
+ ### Emotional Design Levels
116
+
117
+ ```
118
+ VISCERAL (instant) → First impression: colors, imagery, overall feel
119
+ BEHAVIORAL (use) → Using it: speed, feedback, efficiency
120
+ REFLECTIVE (memory) → After: "I like what this says about me"
121
+ ```
122
+
123
+ ### Trust Building
124
+
125
+ - Security indicators on sensitive actions
126
+ - Social proof where relevant
127
+ - Clear contact/support access
128
+ - Consistent, professional design
129
+ - Transparent policies
130
+
131
+ ---
132
+
133
+ ## 3. Layout Principles
134
+
135
+ ### Golden Ratio (φ = 1.618)
136
+
137
+ ```
138
+ Use for proportional harmony:
139
+ ├── Content : Sidebar = roughly 62% : 38%
140
+ ├── Each heading size = previous × 1.618 (for dramatic scale)
141
+ ├── Spacing can follow: sm → md → lg (each × 1.618)
142
+ ```
143
+
144
+ ### 8-Point Grid Concept
145
+
146
+ ```
147
+ All spacing and sizing in multiples of 8:
148
+ ├── Tight: 4px (half-step for micro)
149
+ ├── Small: 8px
150
+ ├── Medium: 16px
151
+ ├── Large: 24px, 32px
152
+ ├── XL: 48px, 64px, 80px
153
+ └── Adjust based on content density
154
+ ```
155
+
156
+ ### Key Sizing Principles
157
+
158
+ | Element | Consideration |
159
+ |---------|---------------|
160
+ | **Touch targets** | Minimum comfortable tap size |
161
+ | **Buttons** | Height based on importance hierarchy |
162
+ | **Inputs** | Match button height for alignment |
163
+ | **Cards** | Consistent padding, breathable |
164
+ | **Reading width** | 45-75 characters optimal |
165
+
166
+ ---
167
+
168
+ ## 4. Color Principles
169
+
170
+ ### 60-30-10 Rule
171
+
172
+ ```
173
+ 60% → Primary/Background (calm, neutral base)
174
+ 30% → Secondary (supporting areas)
175
+ 10% → Accent (CTAs, highlights, attention)
176
+ ```
177
+
178
+ ### Color Psychology (For Decision Making)
179
+
180
+ | If You Need... | Consider Hues | Avoid |
181
+ |----------------|---------------|-------|
182
+ | Trust, calm | Blue family | Aggressive reds |
183
+ | Growth, nature | Green family | Industrial grays |
184
+ | Energy, urgency | Orange, red | Passive blues |
185
+ | Luxury, creativity | Deep Teal, Gold, Emerald | Cheap-feeling brights |
186
+ | Clean, minimal | Neutrals | Overwhelming color |
187
+
188
+ ### Selection Process
189
+
190
+ 1. **What's the industry?** (narrows options)
191
+ 2. **What's the emotion?** (picks primary)
192
+ 3. **Light or dark mode?** (sets foundation)
193
+ 4. **ASK USER** if not specified
194
+
195
+ For detailed color theory: [color-system.md](color-system.md)
196
+
197
+ ---
198
+
199
+ ## 5. Typography Principles
200
+
201
+ ### Scale Selection
202
+
203
+ | Content Type | Scale Ratio | Feel |
204
+ |--------------|-------------|------|
205
+ | Dense UI | 1.125-1.2 | Compact, efficient |
206
+ | General web | 1.25 | Balanced (most common) |
207
+ | Editorial | 1.333 | Readable, spacious |
208
+ | Hero/display | 1.5-1.618 | Dramatic impact |
209
+
210
+ ### Pairing Concept
211
+
212
+ ```
213
+ Contrast + Harmony:
214
+ ├── DIFFERENT enough for hierarchy
215
+ ├── SIMILAR enough for cohesion
216
+ └── Usually: display + neutral, or serif + sans
217
+ ```
218
+
219
+ ### Readability Rules
220
+
221
+ - **Line length**: 45-75 characters optimal
222
+ - **Line height**: 1.4-1.6 for body text
223
+ - **Contrast**: Check WCAG requirements
224
+ - **Size**: 16px+ for body on web
225
+
226
+ For detailed typography: [typography-system.md](typography-system.md)
227
+
228
+ ---
229
+
230
+ ## 6. Visual Effects Principles
231
+
232
+ ### Glassmorphism (When Appropriate)
233
+
234
+ ```
235
+ Key properties:
236
+ ├── Semi-transparent background
237
+ ├── Backdrop blur
238
+ ├── Subtle border for definition
239
+ └── ⚠️ **WARNING:** Standard blue/white glassmorphism is a modern cliché. Use it radically or not at all.
240
+ ```
241
+
242
+ ### Shadow Hierarchy
243
+
244
+ ```
245
+ Elevation concept:
246
+ ├── Higher elements = larger shadows
247
+ ├── Y-offset > X-offset (light from above)
248
+ ├── Multiple layers = more realistic
249
+ └── Dark mode: may need glow instead
250
+ ```
251
+
252
+ ### Gradient Usage
253
+
254
+ ```
255
+ Harmonious gradients:
256
+ ├── Adjacent colors on wheel (analogous)
257
+ ├── OR same hue, different lightness
258
+ ├── Avoid harsh complementary pairs
259
+ ├── 🚫 **NO Mesh/Aurora Gradients** (floating blobs)
260
+ └── VARY from project to project radically
261
+ ```
262
+
263
+ For complete effects guide: [visual-effects.md](visual-effects.md)
264
+
265
+ ---
266
+
267
+ ## 7. Animation Principles
268
+
269
+ ### Timing Concept
270
+
271
+ ```
272
+ Duration based on:
273
+ ├── Distance (further = longer)
274
+ ├── Size (larger = slower)
275
+ ├── Importance (critical = clear)
276
+ └── Context (urgent = fast, luxury = slow)
277
+ ```
278
+
279
+ ### Easing Selection
280
+
281
+ | Action | Easing | Why |
282
+ |--------|--------|-----|
283
+ | Entering | Ease-out | Decelerate, settle in |
284
+ | Leaving | Ease-in | Accelerate, exit |
285
+ | Emphasis | Ease-in-out | Smooth, deliberate |
286
+ | Playful | Bounce | Fun, energetic |
287
+
288
+ ### Performance
289
+
290
+ - Animate only transform and opacity
291
+ - Respect reduced-motion preference
292
+ - Test on low-end devices
293
+
294
+ For animation patterns: [animation-guide.md](animation-guide.md), for advanced: [motion-graphics.md](motion-graphics.md)
295
+
296
+ ---
297
+
298
+ ## 8. "Wow Factor" Checklist
299
+
300
+ ### Premium Indicators
301
+
302
+ - [ ] Generous whitespace (luxury = breathing room)
303
+ - [ ] Subtle depth and dimension
304
+ - [ ] Smooth, purposeful animations
305
+ - [ ] Attention to detail (alignment, consistency)
306
+ - [ ] Cohesive visual rhythm
307
+ - [ ] Custom elements (not all defaults)
308
+
309
+ ### Trust Builders
310
+
311
+ - [ ] Security cues where appropriate
312
+ - [ ] Social proof / testimonials
313
+ - [ ] Clear value proposition
314
+ - [ ] Professional imagery
315
+ - [ ] Consistent design language
316
+
317
+ ### Emotional Triggers
318
+
319
+ - [ ] Hero that evokes intended emotion
320
+ - [ ] Human elements (faces, stories)
321
+ - [ ] Progress/achievement indicators
322
+ - [ ] Moments of delight
323
+
324
+ ---
325
+
326
+ ## 9. Anti-Patterns (What NOT to Do)
327
+
328
+ ### ❌ Lazy Design Indicators
329
+
330
+ - Default system fonts without consideration
331
+ - Stock imagery that doesn't match
332
+ - Inconsistent spacing
333
+ - Too many competing colors
334
+ - Walls of text without hierarchy
335
+ - Inaccessible contrast
336
+
337
+ ### ❌ AI Tendency Patterns (AVOID!)
338
+
339
+ - **Same colors every project**
340
+ - **Dark + neon as default**
341
+ - **Purple/violet everything (PURPLE BAN ✅)**
342
+ - **Bento grids for simple landing pages**
343
+ - **Mesh Gradients & Glow Effects**
344
+ - **Same layout structure / Vercel clone**
345
+ - **Not asking user preferences**
346
+
347
+ ### ❌ Dark Patterns (Unethical)
348
+
349
+ - Hidden costs
350
+ - Fake urgency
351
+ - Forced actions
352
+ - Deceptive UI
353
+ - Confirmshaming
354
+
355
+ ---
356
+
357
+ ## 10. Decision Process Summary
358
+
359
+ ```
360
+ For EVERY design task:
361
+
362
+ 1. CONSTRAINTS
363
+ └── What's the timeline, brand, tech, audience?
364
+ └── If unclear → ASK
365
+
366
+ 2. CONTENT
367
+ └── What content exists?
368
+ └── What's the hierarchy?
369
+
370
+ 3. STYLE DIRECTION
371
+ └── What's appropriate for context?
372
+ └── If unclear → ASK (don't default!)
373
+
374
+ 4. EXECUTION
375
+ └── Apply principles above
376
+ └── Check against anti-patterns
377
+
378
+ 5. REVIEW
379
+ └── "Does this serve the user?"
380
+ └── "Is this different from my defaults?"
381
+ └── "Would I be proud of this?"
382
+ ```
383
+
384
+ ---
385
+
386
+ ## Reference Files
387
+
388
+ For deeper guidance on specific areas:
389
+
390
+ - [color-system.md](color-system.md) - Color theory and selection process
391
+ - [typography-system.md](typography-system.md) - Font pairing and scale decisions
392
+ - [visual-effects.md](visual-effects.md) - Effects principles and techniques
393
+ - [animation-guide.md](animation-guide.md) - Motion design principles
394
+ - [motion-graphics.md](motion-graphics.md) - Advanced: Lottie, GSAP, SVG, 3D, Particles
395
+ - [decision-trees.md](decision-trees.md) - Context-specific templates
396
+ - [ux-psychology.md](ux-psychology.md) - User psychology deep dive
397
+
398
+ ---
399
+
400
+ ## Related Skills
401
+
402
+ | Skill | When to Use |
403
+ |-------|-------------|
404
+ | **frontend-design** (this) | Before coding - Learn design principles (color, typography, UX psychology) |
405
+ | **[web-design-guidelines](../web-design-guidelines/SKILL.md)** | After coding - Audit for accessibility, performance, and best practices |
406
+
407
+ ## Post-Design Workflow
408
+
409
+ After implementing your design, run the audit:
410
+
411
+ ```
412
+ 1. DESIGN → Read frontend-design principles ← YOU ARE HERE
413
+ 2. CODE → Implement the design
414
+ 3. AUDIT → Run web-design-guidelines review
415
+ 4. FIX → Address findings from audit
416
+ ```
417
+
418
+ > **Next Step:** After coding, use `web-design-guidelines` skill to audit your implementation for accessibility, focus states, animations, and performance issues.
419
+
420
+ ---
421
+
422
+ > **Remember:** Design is THINKING, not copying. Every project deserves fresh consideration based on its unique context and users. **Avoid the Modern SaaS Safe Harbor!**
423
+
424
+ ---
425
+
426
+ ## 5. Next.js 16+ Modern Form Patterns
427
+
428
+ > [!IMPORTANT]
429
+ > For Next.js 16+ projects, use the native `next/form` component instead of standard HTML `<form>` for all GET-based search/filter operations.
430
+
431
+ ### The `<Form>` Component Advantage
432
+ - **Automatic Client Navigation:** Performs client-side transitions on submit.
433
+ - **Progressive Enhancement:** Works even without JavaScript.
434
+ - **URL Sync:** Automatically encodes input values into search params.
435
+
436
+ ### Implementation Example (Search Bar)
437
+ ```tsx
438
+ import Form from 'next/form'
439
+
440
+ export default function SearchBar() {
441
+ return (
442
+ <Form action="/search" className="flex gap-2">
443
+ <input
444
+ name="q"
445
+ placeholder="Search products..."
446
+ className="border p-2"
447
+ />
448
+ <button type="submit">Search</button>
449
+ </Form>
450
+ )
451
+ }
452
+ ```
453
+
454
+ ### When to use `<Form>` vs. standard `<form>`:
455
+ - **Use `next/form`** for: Search, Filtering, Sorting, Pagination (GET requests).
456
+ - **Use standard `<form>`** for: Mutations, Login, Data Entry (POST requests via Server Actions).