@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,395 @@
1
+ ---
2
+ name: mobile-design
3
+ description: Mobile-first design thinking and decision-making for iOS and Android apps. Touch interaction, performance patterns, platform conventions. Teaches principles, not fixed values. Use when building React Native, Flutter, or native mobile apps.
4
+ when_to_use: "When designing mobile app interfaces for iOS/Android, React Native, or Flutter. Touch interaction and platform conventions. NOT for web apps."
5
+ allowed-tools: Read, Glob, Grep, Bash
6
+ ---
7
+
8
+ # Mobile Design System
9
+
10
+ > **Philosophy:** Touch-first. Battery-conscious. Platform-respectful. Offline-capable.
11
+ > **Core Principle:** Mobile is NOT a small desktop. THINK mobile constraints, ASK platform choice.
12
+
13
+ ---
14
+
15
+ ## 🔧 Runtime Scripts
16
+
17
+ **Execute these for validation (don't read, just run):**
18
+
19
+ | Script | Purpose | Usage |
20
+ |--------|---------|-------|
21
+ | `scripts/mobile_audit.py` | Mobile UX & Touch Audit | `python scripts/mobile_audit.py <project_path>` |
22
+
23
+ ---
24
+
25
+ ## 🔴 MANDATORY: Read Reference Files Before Working!
26
+
27
+ **⛔ DO NOT start development until you read the relevant files:**
28
+
29
+ ### Universal (Always Read)
30
+
31
+ | File | Content | Status |
32
+ |------|---------|--------|
33
+ | **[mobile-design-thinking.md](mobile-design-thinking.md)** | **⚠️ ANTI-MEMORIZATION: Forces thinking, prevents AI defaults** | **⬜ CRITICAL FIRST** |
34
+ | **[touch-psychology.md](touch-psychology.md)** | **Fitts' Law, gestures, haptics, thumb zone** | **⬜ CRITICAL** |
35
+ | **[mobile-performance.md](mobile-performance.md)** | **RN/Flutter performance, 60fps, memory** | **⬜ CRITICAL** |
36
+ | **[mobile-backend.md](mobile-backend.md)** | **Push notifications, offline sync, mobile API** | **⬜ CRITICAL** |
37
+ | **[mobile-testing.md](mobile-testing.md)** | **Testing pyramid, E2E, platform-specific** | **⬜ CRITICAL** |
38
+ | **[mobile-debugging.md](mobile-debugging.md)** | **Native vs JS debugging, Flipper, Logcat** | **⬜ CRITICAL** |
39
+ | [mobile-navigation.md](mobile-navigation.md) | Tab/Stack/Drawer, deep linking | ⬜ Read |
40
+ | [mobile-typography.md](mobile-typography.md) | System fonts, Dynamic Type, a11y | ⬜ Read |
41
+ | [mobile-color-system.md](mobile-color-system.md) | OLED, dark mode, battery-aware | ⬜ Read |
42
+ | [decision-trees.md](decision-trees.md) | Framework/state/storage selection | ⬜ Read |
43
+
44
+ > 🧠 **mobile-design-thinking.md is PRIORITY!** This file ensures AI thinks instead of using memorized patterns.
45
+
46
+ ### Platform-Specific (Read Based on Target)
47
+
48
+ | Platform | File | Content | When to Read |
49
+ |----------|------|---------|--------------|
50
+ | **iOS** | [platform-ios.md](platform-ios.md) | Human Interface Guidelines, SF Pro, SwiftUI patterns | Building for iPhone/iPad |
51
+ | **Android** | [platform-android.md](platform-android.md) | Material Design 3, Roboto, Compose patterns | Building for Android |
52
+ | **Cross-Platform** | Both above | Platform divergence points | React Native / Flutter |
53
+
54
+ > 🔴 **If building for iOS → Read platform-ios.md FIRST!**
55
+ > 🔴 **If building for Android → Read platform-android.md FIRST!**
56
+ > 🔴 **If cross-platform → Read BOTH and apply conditional platform logic!**
57
+
58
+ ---
59
+
60
+ ## ⚠️ CRITICAL: ASK BEFORE ASSUMING (MANDATORY)
61
+
62
+ > **STOP! If the user's request is open-ended, DO NOT default to your favorites.**
63
+
64
+ ### You MUST Ask If Not Specified:
65
+
66
+ | Aspect | Ask | Why |
67
+ |--------|-----|-----|
68
+ | **Platform** | "iOS, Android, or both?" | Affects EVERY design decision |
69
+ | **Framework** | "React Native, Flutter, or native?" | Determines patterns and tools |
70
+ | **Navigation** | "Tab bar, drawer, or stack-based?" | Core UX decision |
71
+ | **State** | "What state management? (Zustand/Redux/Riverpod/BLoC?)" | Architecture foundation |
72
+ | **Offline** | "Does this need to work offline?" | Affects data strategy |
73
+ | **Target devices** | "Phone only, or tablet support?" | Layout complexity |
74
+
75
+ ### ⛔ AI MOBILE ANTI-PATTERNS (YASAK LİSTESİ)
76
+
77
+ > 🚫 **These are AI default tendencies that MUST be avoided!**
78
+
79
+ #### Performance Sins
80
+
81
+ | ❌ NEVER DO | Why It's Wrong | ✅ ALWAYS DO |
82
+ |-------------|----------------|--------------|
83
+ | **ScrollView for long lists** | Renders ALL items, memory explodes | Use `FlatList` / `FlashList` / `ListView.builder` |
84
+ | **Inline renderItem function** | New function every render, all items re-render | `useCallback` + `React.memo` |
85
+ | **Missing keyExtractor** | Index-based keys cause bugs on reorder | Unique, stable ID from data |
86
+ | **Skip getItemLayout** | Async layout = janky scroll | Provide when items have fixed height |
87
+ | **setState() everywhere** | Unnecessary widget rebuilds | Targeted state, `const` constructors |
88
+ | **Native driver: false** | Animations blocked by JS thread | `useNativeDriver: true` always |
89
+ | **console.log in production** | Blocks JS thread severely | Remove before release build |
90
+ | **Skip React.memo/const** | Every item re-renders on any change | Memoize list items ALWAYS |
91
+
92
+ #### Touch/UX Sins
93
+
94
+ | ❌ NEVER DO | Why It's Wrong | ✅ ALWAYS DO |
95
+ |-------------|----------------|--------------|
96
+ | **Touch target < 44px** | Impossible to tap accurately, frustrating | Minimum 44pt (iOS) / 48dp (Android) |
97
+ | **Spacing < 8px between targets** | Accidental taps on neighbors | Minimum 8-12px gap |
98
+ | **Gesture-only interactions** | Motor impaired users excluded | Always provide button alternative |
99
+ | **No loading state** | User thinks app crashed | ALWAYS show loading feedback |
100
+ | **No error state** | User stuck, no recovery path | Show error with retry option |
101
+ | **No offline handling** | Crash/block when network lost | Graceful degradation, cached data |
102
+ | **Ignore platform conventions** | Users confused, muscle memory broken | iOS feels iOS, Android feels Android |
103
+
104
+ #### Security Sins
105
+
106
+ | ❌ NEVER DO | Why It's Wrong | ✅ ALWAYS DO |
107
+ |-------------|----------------|--------------|
108
+ | **Token in AsyncStorage** | Easily accessible, stolen on rooted device | `SecureStore` / `Keychain` / `EncryptedSharedPreferences` |
109
+ | **Hardcode API keys** | Reverse engineered from APK/IPA | Environment variables, secure storage |
110
+ | **Skip SSL pinning** | MITM attacks possible | Pin certificates in production |
111
+ | **Log sensitive data** | Logs can be extracted | Never log tokens, passwords, PII |
112
+
113
+ #### Architecture Sins
114
+
115
+ | ❌ NEVER DO | Why It's Wrong | ✅ ALWAYS DO |
116
+ |-------------|----------------|--------------|
117
+ | **Business logic in UI** | Untestable, unmaintainable | Service layer separation |
118
+ | **Global state for everything** | Unnecessary re-renders, complexity | Local state default, lift when needed |
119
+ | **Deep linking as afterthought** | Notifications, shares broken | Plan deep links from day one |
120
+ | **Skip dispose/cleanup** | Memory leaks, zombie listeners | Clean up subscriptions, timers |
121
+
122
+ ---
123
+
124
+ ## 📱 Platform Decision Matrix
125
+
126
+ ### When to Unify vs Diverge
127
+
128
+ ```
129
+ UNIFY (same on both) DIVERGE (platform-specific)
130
+ ─────────────────── ──────────────────────────
131
+ Business Logic ✅ Always -
132
+ Data Layer ✅ Always -
133
+ Core Features ✅ Always -
134
+
135
+ Navigation - ✅ iOS: edge swipe, Android: back button
136
+ Gestures - ✅ Platform-native feel
137
+ Icons - ✅ SF Symbols vs Material Icons
138
+ Date Pickers - ✅ Native pickers feel right
139
+ Modals/Sheets - ✅ iOS: bottom sheet vs Android: dialog
140
+ Typography - ✅ SF Pro vs Roboto (or custom)
141
+ Error Dialogs - ✅ Platform conventions for alerts
142
+ ```
143
+
144
+ ### Quick Reference: Platform Defaults
145
+
146
+ | Element | iOS | Android |
147
+ |---------|-----|---------|
148
+ | **Primary Font** | SF Pro / SF Compact | Roboto |
149
+ | **Min Touch Target** | 44pt × 44pt | 48dp × 48dp |
150
+ | **Back Navigation** | Edge swipe left | System back button/gesture |
151
+ | **Bottom Tab Icons** | SF Symbols | Material Symbols |
152
+ | **Action Sheet** | UIActionSheet from bottom | Bottom Sheet / Dialog |
153
+ | **Progress** | Spinner | Linear progress (Material) |
154
+ | **Pull to Refresh** | Native UIRefreshControl | SwipeRefreshLayout |
155
+
156
+ ---
157
+
158
+ ## 🧠 Mobile UX Psychology (Quick Reference)
159
+
160
+ ### Fitts' Law for Touch
161
+
162
+ ```
163
+ Desktop: Cursor is precise (1px)
164
+ Mobile: Finger is imprecise (~7mm contact area)
165
+
166
+ → Touch targets MUST be 44-48px minimum
167
+ → Important actions in THUMB ZONE (bottom of screen)
168
+ → Destructive actions AWAY from easy reach
169
+ ```
170
+
171
+ ### Thumb Zone (One-Handed Usage)
172
+
173
+ ```
174
+ ┌─────────────────────────────┐
175
+ │ HARD TO REACH │ ← Navigation, menu, back
176
+ │ (stretch) │
177
+ ├─────────────────────────────┤
178
+ │ OK TO REACH │ ← Secondary actions
179
+ │ (natural) │
180
+ ├─────────────────────────────┤
181
+ │ EASY TO REACH │ ← PRIMARY CTAs, tab bar
182
+ │ (thumb's natural arc) │ ← Main content interaction
183
+ └─────────────────────────────┘
184
+ [ HOME ]
185
+ ```
186
+
187
+ ### Mobile-Specific Cognitive Load
188
+
189
+ | Desktop | Mobile Difference |
190
+ |---------|-------------------|
191
+ | Multiple windows | ONE task at a time |
192
+ | Keyboard shortcuts | Touch gestures |
193
+ | Hover states | NO hover (tap or nothing) |
194
+ | Large viewport | Limited space, scroll vertical |
195
+ | Stable attention | Interrupted constantly |
196
+
197
+ For deep dive: [touch-psychology.md](touch-psychology.md)
198
+
199
+ ---
200
+
201
+ ## ⚡ Performance Principles (Quick Reference)
202
+
203
+ ### React Native Critical Rules
204
+
205
+ ```typescript
206
+ // ✅ CORRECT: Memoized renderItem + React.memo wrapper
207
+ const ListItem = React.memo(({ item }: { item: Item }) => (
208
+ <View style={styles.item}>
209
+ <Text>{item.title}</Text>
210
+ </View>
211
+ ));
212
+
213
+ const renderItem = useCallback(
214
+ ({ item }: { item: Item }) => <ListItem item={item} />,
215
+ []
216
+ );
217
+
218
+ // ✅ CORRECT: FlatList with all optimizations
219
+ <FlatList
220
+ data={items}
221
+ renderItem={renderItem}
222
+ keyExtractor={(item) => item.id} // Stable ID, NOT index
223
+ getItemLayout={(data, index) => ({
224
+ length: ITEM_HEIGHT,
225
+ offset: ITEM_HEIGHT * index,
226
+ index,
227
+ })}
228
+ removeClippedSubviews={true}
229
+ maxToRenderPerBatch={10}
230
+ windowSize={5}
231
+ />
232
+ ```
233
+
234
+ ### Flutter Critical Rules
235
+
236
+ ```dart
237
+ // ✅ CORRECT: const constructors prevent rebuilds
238
+ class MyWidget extends StatelessWidget {
239
+ const MyWidget({super.key}); // CONST!
240
+
241
+ @override
242
+ Widget build(BuildContext context) {
243
+ return const Column( // CONST!
244
+ children: [
245
+ Text('Static content'),
246
+ MyConstantWidget(),
247
+ ],
248
+ );
249
+ }
250
+ }
251
+
252
+ // ✅ CORRECT: Targeted state with ValueListenableBuilder
253
+ ValueListenableBuilder<int>(
254
+ valueListenable: counter,
255
+ builder: (context, value, child) => Text('$value'),
256
+ child: const ExpensiveWidget(), // Won't rebuild!
257
+ )
258
+ ```
259
+
260
+ ### Animation Performance
261
+
262
+ ```
263
+ GPU-accelerated (FAST): CPU-bound (SLOW):
264
+ ├── transform ├── width, height
265
+ ├── opacity ├── top, left, right, bottom
266
+ └── (use these ONLY) ├── margin, padding
267
+ └── (AVOID animating these)
268
+ ```
269
+
270
+ For complete guide: [mobile-performance.md](mobile-performance.md)
271
+
272
+ ---
273
+
274
+ ## 📝 CHECKPOINT (MANDATORY Before Any Mobile Work)
275
+
276
+ > **Before writing ANY mobile code, you MUST complete this checkpoint:**
277
+
278
+ ```
279
+ 🧠 CHECKPOINT:
280
+
281
+ Platform: [ iOS / Android / Both ]
282
+ Framework: [ React Native / Flutter / SwiftUI / Kotlin ]
283
+ Files Read: [ List the skill files you've read ]
284
+
285
+ 3 Principles I Will Apply:
286
+ 1. _______________
287
+ 2. _______________
288
+ 3. _______________
289
+
290
+ Anti-Patterns I Will Avoid:
291
+ 1. _______________
292
+ 2. _______________
293
+ ```
294
+
295
+ **Example:**
296
+ ```
297
+ 🧠 CHECKPOINT:
298
+
299
+ Platform: iOS + Android (Cross-platform)
300
+ Framework: React Native + Expo
301
+ Files Read: touch-psychology.md, mobile-performance.md, platform-ios.md, platform-android.md
302
+
303
+ 3 Principles I Will Apply:
304
+ 1. FlatList with React.memo + useCallback for all lists
305
+ 2. 48px touch targets, thumb zone for primary CTAs
306
+ 3. Platform-specific navigation (edge swipe iOS, back button Android)
307
+
308
+ Anti-Patterns I Will Avoid:
309
+ 1. ScrollView for lists → FlatList
310
+ 2. Inline renderItem → Memoized
311
+ 3. AsyncStorage for tokens → SecureStore
312
+ ```
313
+
314
+ > 🔴 **Can't fill the checkpoint? → GO BACK AND READ THE SKILL FILES.**
315
+
316
+ ---
317
+
318
+ ## 🔧 Framework Decision Tree
319
+
320
+ ```
321
+ WHAT ARE YOU BUILDING?
322
+ │
323
+ ├── Need OTA updates + rapid iteration + web team
324
+ │ └── ✅ React Native + Expo
325
+ │
326
+ ├── Need pixel-perfect custom UI + performance critical
327
+ │ └── ✅ Flutter
328
+ │
329
+ ├── Deep native features + single platform focus
330
+ │ ├── iOS only → SwiftUI
331
+ │ └── Android only → Kotlin + Jetpack Compose
332
+ │
333
+ ├── Existing RN codebase + new features
334
+ │ └── ✅ React Native (bare workflow)
335
+ │
336
+ └── Enterprise + existing Flutter codebase
337
+ └── ✅ Flutter
338
+ ```
339
+
340
+ For complete decision trees: [decision-trees.md](decision-trees.md)
341
+
342
+ ---
343
+
344
+ ## 📋 Pre-Development Checklist
345
+
346
+ ### Before Starting ANY Mobile Project
347
+
348
+ - [ ] **Platform confirmed?** (iOS / Android / Both)
349
+ - [ ] **Framework chosen?** (RN / Flutter / Native)
350
+ - [ ] **Navigation pattern decided?** (Tabs / Stack / Drawer)
351
+ - [ ] **State management selected?** (Zustand / Redux / Riverpod / BLoC)
352
+ - [ ] **Offline requirements known?**
353
+ - [ ] **Deep linking planned from day one?**
354
+ - [ ] **Target devices defined?** (Phone / Tablet / Both)
355
+
356
+ ### Before Every Screen
357
+
358
+ - [ ] **Touch targets ≥ 44-48px?**
359
+ - [ ] **Primary CTA in thumb zone?**
360
+ - [ ] **Loading state exists?**
361
+ - [ ] **Error state with retry exists?**
362
+ - [ ] **Offline handling considered?**
363
+ - [ ] **Platform conventions followed?**
364
+
365
+ ### Before Release
366
+
367
+ - [ ] **console.log removed?**
368
+ - [ ] **SecureStore for sensitive data?**
369
+ - [ ] **SSL pinning enabled?**
370
+ - [ ] **Lists optimized (memo, keyExtractor)?**
371
+ - [ ] **Memory cleanup on unmount?**
372
+ - [ ] **Tested on low-end devices?**
373
+ - [ ] **Accessibility labels on all interactive elements?**
374
+
375
+ ---
376
+
377
+ ## 📚 Reference Files
378
+
379
+ For deeper guidance on specific areas:
380
+
381
+ | File | When to Use |
382
+ |------|-------------|
383
+ | [mobile-design-thinking.md](mobile-design-thinking.md) | **FIRST! Anti-memorization, forces context-based thinking** |
384
+ | [touch-psychology.md](touch-psychology.md) | Understanding touch interaction, Fitts' Law, gesture design |
385
+ | [mobile-performance.md](mobile-performance.md) | Optimizing RN/Flutter, 60fps, memory/battery |
386
+ | [platform-ios.md](platform-ios.md) | iOS-specific design, HIG compliance |
387
+ | [platform-android.md](platform-android.md) | Android-specific design, Material Design 3 |
388
+ | [mobile-navigation.md](mobile-navigation.md) | Navigation patterns, deep linking |
389
+ | [mobile-typography.md](mobile-typography.md) | Type scale, system fonts, accessibility |
390
+ | [mobile-color-system.md](mobile-color-system.md) | OLED optimization, dark mode, battery |
391
+ | [decision-trees.md](decision-trees.md) | Framework, state, storage decisions |
392
+
393
+ ---
394
+
395
+ > **Remember:** Mobile users are impatient, interrupted, and using imprecise fingers on small screens. Design for the WORST conditions: bad network, one hand, bright sun, low battery. If it works there, it works everywhere.