@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,80 @@
1
+ ---
2
+ name: python-patterns
3
+ description: Python development principles and decision-making. Framework selection, async patterns, type hints, project structure. Teaches thinking, not copying.
4
+ when_to_use: "When writing Python code, selecting Python frameworks, implementing type hints, or structuring Python projects."
5
+ allowed-tools: Read, Write, Edit, Glob, Grep
6
+ ---
7
+
8
+ # Python Patterns
9
+
10
+ > Python development principles and decision-making for 2025.
11
+ > **Learn to THINK, not memorize patterns.**
12
+
13
+ ---
14
+
15
+ ## ⚠️ How to Use This Skill
16
+
17
+ This skill teaches **decision-making principles**, not fixed code to copy.
18
+
19
+ - ASK user for framework preference when unclear
20
+ - Choose async vs sync based on CONTEXT
21
+ - Don't default to same framework every time
22
+
23
+ ---
24
+
25
+ ## 1. Framework Selection (2025)
26
+
27
+ ### Decision Tree
28
+
29
+ ```
30
+ What are you building?
31
+ │
32
+ ├── API-first / Microservices
33
+ │ └── FastAPI (async, modern, fast)
34
+ │
35
+ ├── Full-stack web / CMS / Admin
36
+ │ └── Django (batteries-included)
37
+ │
38
+ ├── Simple / Script / Learning
39
+ │ └── Flask (minimal, flexible)
40
+ │
41
+ ├── AI/ML API serving
42
+ │ └── FastAPI (Pydantic, async, uvicorn)
43
+ │
44
+ └── Background workers
45
+ ├── Light / Async-native: ARQ / SAQ / Taskiq
46
+ └── Heavy / Multi-broker: Celery / Dramatiq
47
+ ```
48
+
49
+ ### Comparison Principles
50
+
51
+ | Factor | FastAPI | Django | Flask |
52
+ |--------|---------|--------|-------|
53
+ | **Best for** | APIs, microservices | Full-stack, CMS | Simple, learning |
54
+ | **Async** | Native | Django 5.0+ | Via extensions |
55
+ | **Admin** | Manual | Built-in | Via extensions |
56
+ | **ORM** | Choose your own | Django ORM | Choose your own |
57
+ | **Learning curve** | Low | Medium | Low |
58
+
59
+ ### Selection Questions to Ask:
60
+ 1. Is this API-only or full-stack?
61
+ 2. Need admin interface?
62
+ 3. Team familiar with async?
63
+ 4. Existing infrastructure?
64
+
65
+ **Recusa:** não copie um stack porque é o de sempre. Se o pedido for vago, pergunte. Anti-padrões em [11. Anti-Patterns](references/11-anti-patterns-to-avoid.md).
66
+
67
+ ## Load on demand
68
+
69
+ Read only the file that matches the task:
70
+
71
+ - [2. Async vs Sync Decision](references/2-async-vs-sync-decision.md)
72
+ - [3. Type Hints Strategy](references/3-type-hints-strategy.md)
73
+ - [4. Project Structure Principles](references/4-project-structure-principles.md)
74
+ - [5. Django Principles (2025)](references/5-django-principles-2025.md)
75
+ - [6. FastAPI Principles](references/6-fastapi-principles.md)
76
+ - [7. Background Tasks](references/7-background-tasks.md)
77
+ - [8. Error Handling Principles](references/8-error-handling-principles.md)
78
+ - [9. Testing Principles](references/9-testing-principles.md)
79
+ - [10. Decision Checklist](references/10-decision-checklist.md)
80
+ - [11. Anti-Patterns to Avoid](references/11-anti-patterns-to-avoid.md)
@@ -0,0 +1,14 @@
1
+ ## 10. Decision Checklist
2
+
3
+ Before implementing:
4
+
5
+ - [ ] **Asked user about framework preference?**
6
+ - [ ] **Chosen framework for THIS context?** (not just default)
7
+ - [ ] **Decided async vs sync?**
8
+ - [ ] **Planned type hint strategy?**
9
+ - [ ] **Defined project structure?**
10
+ - [ ] **Planned error handling?**
11
+ - [ ] **Considered background tasks?**
12
+
13
+ ---
14
+
@@ -0,0 +1,20 @@
1
+ ## 11. Anti-Patterns to Avoid
2
+
3
+ ### ❌ DON'T:
4
+ - Default to Django for simple APIs (FastAPI may be better)
5
+ - Use sync libraries in async code
6
+ - Skip type hints for public APIs
7
+ - Put business logic in routes/views
8
+ - Ignore N+1 queries
9
+ - Mix async and sync carelessly
10
+
11
+ ### ✅ DO:
12
+ - Choose framework based on context
13
+ - Ask about async requirements
14
+ - Use Pydantic for validation
15
+ - Separate concerns (routes → services → repos)
16
+ - Test critical paths
17
+
18
+ ---
19
+
20
+ > **Remember**: Python patterns are about decision-making for YOUR specific context. Don't copy code—think about what serves your application best.
@@ -0,0 +1,44 @@
1
+ ## 2. Async vs Sync Decision
2
+
3
+ ### When to Use Async
4
+
5
+ ```
6
+ async def is better when:
7
+ ├── I/O-bound operations (database, HTTP, file)
8
+ ├── Many concurrent connections
9
+ ├── Real-time features
10
+ ├── Microservices communication
11
+ └── FastAPI/Starlette/Django ASGI
12
+
13
+ def (sync) is better when:
14
+ ├── CPU-bound operations
15
+ ├── Simple scripts
16
+ ├── Legacy codebase
17
+ ├── Team unfamiliar with async
18
+ └── Blocking libraries (no async version)
19
+ ```
20
+
21
+ ### The Golden Rule
22
+
23
+ ```
24
+ I/O-bound → async (waiting for external)
25
+ CPU-bound → sync + multiprocessing (computing)
26
+
27
+ Don't:
28
+ ├── Mix sync and async carelessly
29
+ ├── Use sync libraries in async code
30
+ └── Force async for CPU work
31
+ ```
32
+
33
+ ### Async Library Selection
34
+
35
+ | Need | Async Library |
36
+ |------|---------------|
37
+ | HTTP client | httpx |
38
+ | PostgreSQL | asyncpg |
39
+ | Redis | aioredis / redis-py async |
40
+ | File I/O | aiofiles |
41
+ | Database ORM | SQLAlchemy 2.0 async, Tortoise |
42
+
43
+ ---
44
+
@@ -0,0 +1,56 @@
1
+ ## 3. Type Hints Strategy
2
+
3
+ ### When to Type
4
+
5
+ ```
6
+ Always type:
7
+ ├── Function parameters
8
+ ├── Return types
9
+ ├── Class attributes
10
+ ├── Public APIs
11
+
12
+ Can skip:
13
+ ├── Local variables (let inference work)
14
+ ├── One-off scripts
15
+ ├── Tests (usually)
16
+ ```
17
+
18
+ ### Common Type Patterns
19
+
20
+ ```python
21
+ # These are patterns, understand them:
22
+
23
+ # Optional → might be None
24
+ from typing import Optional
25
+ def find_user(id: int) -> Optional[User]: ...
26
+
27
+ # Union → one of multiple types
28
+ def process(data: str | dict) -> None: ...
29
+
30
+ # Generic collections
31
+ def get_items() -> list[Item]: ...
32
+ def get_mapping() -> dict[str, int]: ...
33
+
34
+ # Callable
35
+ from typing import Callable
36
+ def apply(fn: Callable[[int], str]) -> str: ...
37
+ ```
38
+
39
+ ### Pydantic for Validation
40
+
41
+ ```
42
+ When to use Pydantic:
43
+ ├── API request/response models
44
+ ├── Configuration/settings
45
+ ├── Data validation
46
+ ├── Serialization
47
+
48
+ Benefits:
49
+ ├── Runtime validation
50
+ ├── Auto-generated JSON schema
51
+ ├── Works with FastAPI natively
52
+ └── Clear error messages
53
+ ```
54
+
55
+ ---
56
+
@@ -0,0 +1,56 @@
1
+ ## 4. Project Structure Principles
2
+
3
+ ### Structure Selection
4
+
5
+ ```
6
+ Small project / Script:
7
+ ├── main.py
8
+ ├── utils.py
9
+ └── requirements.txt
10
+
11
+ Medium API:
12
+ ├── app/
13
+ │ ├── __init__.py
14
+ │ ├── main.py
15
+ │ ├── models/
16
+ │ ├── routes/
17
+ │ ├── services/
18
+ │ └── schemas/
19
+ ├── tests/
20
+ └── pyproject.toml
21
+
22
+ Large application:
23
+ ├── src/
24
+ │ └── myapp/
25
+ │ ├── core/
26
+ │ ├── api/
27
+ │ ├── services/
28
+ │ ├── models/
29
+ │ └── ...
30
+ ├── tests/
31
+ └── pyproject.toml
32
+ ```
33
+
34
+ ### FastAPI Structure Principles
35
+
36
+ ```
37
+ Organize by feature or layer:
38
+
39
+ By layer:
40
+ ├── routes/ (API endpoints)
41
+ ├── services/ (business logic)
42
+ ├── models/ (database models)
43
+ ├── schemas/ (Pydantic models)
44
+ └── dependencies/ (shared deps)
45
+
46
+ By feature:
47
+ ├── users/
48
+ │ ├── routes.py
49
+ │ ├── service.py
50
+ │ └── schemas.py
51
+ └── products/
52
+ └── ...
53
+ ```
54
+
55
+ ---
56
+
@@ -0,0 +1,40 @@
1
+ ## 5. Django Principles (2025)
2
+
3
+ ### Django Async (Django 5.0+)
4
+
5
+ ```
6
+ Django supports async:
7
+ ├── Async views
8
+ ├── Async middleware
9
+ ├── Async ORM (limited)
10
+ └── ASGI deployment
11
+
12
+ When to use async in Django:
13
+ ├── External API calls
14
+ ├── WebSocket (Channels)
15
+ ├── High-concurrency views
16
+ └── Background task triggering
17
+ ```
18
+
19
+ ### Django Best Practices
20
+
21
+ ```
22
+ Model design:
23
+ ├── Fat models, thin views
24
+ ├── Use managers for common queries
25
+ ├── Abstract base classes for shared fields
26
+
27
+ Views:
28
+ ├── Class-based for complex CRUD
29
+ ├── Function-based for simple endpoints
30
+ ├── Use viewsets with DRF
31
+
32
+ Queries:
33
+ ├── select_related() for FKs
34
+ ├── prefetch_related() for M2M
35
+ ├── Avoid N+1 queries
36
+ └── Use .only() for specific fields
37
+ ```
38
+
39
+ ---
40
+
@@ -0,0 +1,50 @@
1
+ ## 6. FastAPI Principles
2
+
3
+ ### async def vs def in FastAPI
4
+
5
+ ```
6
+ Use async def when:
7
+ ├── Using async database drivers
8
+ ├── Making async HTTP calls
9
+ ├── I/O-bound operations
10
+ └── Want to handle concurrency
11
+
12
+ Use def when:
13
+ ├── Blocking operations
14
+ ├── Sync database drivers
15
+ ├── CPU-bound work
16
+ └── FastAPI runs in threadpool automatically
17
+ ```
18
+
19
+ ### Dependency Injection
20
+
21
+ ```
22
+ Use dependencies for:
23
+ ├── Database sessions
24
+ ├── Current user / Auth
25
+ ├── Configuration
26
+ ├── Shared resources
27
+
28
+ Benefits:
29
+ ├── Testability (mock dependencies)
30
+ ├── Clean separation
31
+ ├── Automatic cleanup (yield)
32
+ ```
33
+
34
+ ### Pydantic v2 Integration
35
+
36
+ ```python
37
+ # FastAPI + Pydantic are tightly integrated:
38
+
39
+ # Request validation
40
+ @app.post("/users")
41
+ async def create(user: UserCreate) -> UserResponse:
42
+ # user is already validated
43
+ ...
44
+
45
+ # Response serialization
46
+ # Return type becomes response schema
47
+ ```
48
+
49
+ ---
50
+
@@ -0,0 +1,31 @@
1
+ ## 7. Background Tasks
2
+
3
+ ### Selection Guide
4
+
5
+ | Solution | Best For |
6
+ |----------|----------|
7
+ | **BackgroundTasks** | Simple, in-process tasks |
8
+ | **Celery** | Distributed, complex workflows |
9
+ | **ARQ** | Async, Redis-based |
10
+ | **RQ** | Simple Redis queue |
11
+ | **Dramatiq** | Actor-based, simpler than Celery |
12
+
13
+ ### When to Use Each
14
+
15
+ ```
16
+ FastAPI BackgroundTasks:
17
+ ├── Quick operations
18
+ ├── No persistence needed
19
+ ├── Fire-and-forget
20
+ └── Same process
21
+
22
+ Celery/ARQ:
23
+ ├── Long-running tasks
24
+ ├── Need retry logic
25
+ ├── Distributed workers
26
+ ├── Persistent queue
27
+ └── Complex workflows
28
+ ```
29
+
30
+ ---
31
+
@@ -0,0 +1,29 @@
1
+ ## 8. Error Handling Principles
2
+
3
+ ### Exception Strategy
4
+
5
+ ```
6
+ In FastAPI:
7
+ ├── Create custom exception classes
8
+ ├── Register exception handlers
9
+ ├── Return consistent error format
10
+ └── Log without exposing internals
11
+
12
+ Pattern:
13
+ ├── Raise domain exceptions in services
14
+ ├── Catch and transform in handlers
15
+ └── Client gets clean error response
16
+ ```
17
+
18
+ ### Error Response Philosophy
19
+
20
+ ```
21
+ Include:
22
+ ├── Error code (programmatic)
23
+ ├── Message (human readable)
24
+ ├── Details (field-level when applicable)
25
+ └── NOT stack traces (security)
26
+ ```
27
+
28
+ ---
29
+
@@ -0,0 +1,37 @@
1
+ ## 9. Testing Principles
2
+
3
+ ### Testing Strategy
4
+
5
+ | Type | Purpose | Tools |
6
+ |------|---------|-------|
7
+ | **Unit** | Business logic | pytest |
8
+ | **Integration** | API endpoints | pytest + httpx/TestClient |
9
+ | **E2E** | Full workflows | pytest + DB |
10
+
11
+ ### Async Testing
12
+
13
+ ```python
14
+ # Use pytest-asyncio for async tests
15
+
16
+ import pytest
17
+ from httpx import AsyncClient
18
+
19
+ @pytest.mark.asyncio
20
+ async def test_endpoint():
21
+ async with AsyncClient(app=app, base_url="http://test") as client:
22
+ response = await client.get("/users")
23
+ assert response.status_code == 200
24
+ ```
25
+
26
+ ### Fixtures Strategy
27
+
28
+ ```
29
+ Common fixtures:
30
+ ├── db_session → Database connection
31
+ ├── client → Test client
32
+ ├── authenticated_user → User with token
33
+ └── sample_data → Test data setup
34
+ ```
35
+
36
+ ---
37
+
@@ -0,0 +1,201 @@
1
+ ---
2
+ name: red-team-tactics
3
+ description: Red team tactics principles based on MITRE ATT&CK. Attack phases, detection evasion, reporting.
4
+ when_to_use: "When conducting authorized security assessments, threat modeling, or red team exercises. Use to understand attacker perspectives and improve defenses. NEVER use for unauthorized access."
5
+ allowed-tools: Read, Write, Edit, Glob, Grep, Bash
6
+ ---
7
+
8
+ # Red Team Tactics
9
+
10
+ > Adversary simulation principles based on MITRE ATT&CK framework.
11
+
12
+ ---
13
+
14
+ ## 1. MITRE ATT&CK Phases
15
+
16
+ ### Attack Lifecycle
17
+
18
+ ```
19
+ RECONNAISSANCE → INITIAL ACCESS → EXECUTION → PERSISTENCE
20
+ ↓ ↓ ↓ ↓
21
+ PRIVILEGE ESC → DEFENSE EVASION → CRED ACCESS → DISCOVERY
22
+ ↓ ↓ ↓ ↓
23
+ LATERAL MOVEMENT → COLLECTION → C2 → EXFILTRATION → IMPACT
24
+ ```
25
+
26
+ ### Phase Objectives
27
+
28
+ | Phase | Objective |
29
+ |-------|-----------|
30
+ | **Recon** | Map attack surface |
31
+ | **Initial Access** | Get first foothold |
32
+ | **Execution** | Run code on target |
33
+ | **Persistence** | Survive reboots |
34
+ | **Privilege Escalation** | Get admin/root |
35
+ | **Defense Evasion** | Avoid detection |
36
+ | **Credential Access** | Harvest credentials |
37
+ | **Discovery** | Map internal network |
38
+ | **Lateral Movement** | Spread to other systems |
39
+ | **Collection** | Gather target data |
40
+ | **C2** | Maintain command channel |
41
+ | **Exfiltration** | Extract data |
42
+
43
+ ---
44
+
45
+ ## 2. Reconnaissance Principles
46
+
47
+ ### Passive vs Active
48
+
49
+ | Type | Trade-off |
50
+ |------|-----------|
51
+ | **Passive** | No target contact, limited info |
52
+ | **Active** | Direct contact, more detection risk |
53
+
54
+ ### Information Targets
55
+
56
+ | Category | Value |
57
+ |----------|-------|
58
+ | Technology stack | Attack vector selection |
59
+ | Employee info | Social engineering |
60
+ | Network ranges | Scanning scope |
61
+ | Third parties | Supply chain attack |
62
+
63
+ ---
64
+
65
+ ## 3. Initial Access Vectors
66
+
67
+ ### Selection Criteria
68
+
69
+ | Vector | When to Use |
70
+ |--------|-------------|
71
+ | **Phishing** | Human target, email access |
72
+ | **Public exploits** | Vulnerable services exposed |
73
+ | **Valid credentials** | Leaked or cracked |
74
+ | **Supply chain** | Third-party access |
75
+
76
+ ---
77
+
78
+ ## 4. Privilege Escalation Principles
79
+
80
+ ### Windows Targets
81
+
82
+ | Check | Opportunity |
83
+ |-------|-------------|
84
+ | Unquoted service paths | Write to path |
85
+ | Weak service permissions | Modify service |
86
+ | Token privileges | Abuse SeDebug, etc. |
87
+ | Stored credentials | Harvest |
88
+
89
+ ### Linux Targets
90
+
91
+ | Check | Opportunity |
92
+ |-------|-------------|
93
+ | SUID binaries | Execute as owner |
94
+ | Sudo misconfiguration | Command execution |
95
+ | Kernel vulnerabilities | Kernel exploits |
96
+ | Cron jobs | Writable scripts |
97
+
98
+ ---
99
+
100
+ ## 5. Defense Evasion Principles
101
+
102
+ ### Defense Evasion & Detection Testing
103
+
104
+ > **Safety Rule:** In authorized assessments, NEVER delete logs or destroy forensic evidence in production. Focus on testing whether Blue Team detection rules trigger.
105
+
106
+ | Technique | Assessment Focus | Blue Team Verification |
107
+ |-----------|-----------------|------------------------|
108
+ | LOLBins | Living off the land binaries | Verify if process creation monitoring detects anomalous parent-child relationships |
109
+ | Obfuscation | Payload variation | Verify if static analysis and runtime EDR detect encoded strings |
110
+ | Forensic Resilience | Test log pipeline durability | Verify that central SIEM immutably preserves events even if local agents degrade |
111
+
112
+ ### Operational Security
113
+
114
+ - Work during business hours
115
+ - Mimic legitimate traffic patterns
116
+ - Use encrypted channels
117
+ - Blend with normal behavior
118
+
119
+ ---
120
+
121
+ ## 6. Lateral Movement Principles
122
+
123
+ ### Credential Types
124
+
125
+ | Type | Use |
126
+ |------|-----|
127
+ | Password | Standard auth |
128
+ | Hash | Pass-the-hash |
129
+ | Ticket | Pass-the-ticket |
130
+ | Certificate | Certificate auth |
131
+
132
+ ### Movement Paths
133
+
134
+ - Admin shares
135
+ - Remote services (RDP, SSH, WinRM)
136
+ - Exploitation of internal services
137
+
138
+ ---
139
+
140
+ ## 7. Active Directory Attacks
141
+
142
+ ### Attack Categories
143
+
144
+ | Attack | Target |
145
+ |--------|--------|
146
+ | Kerberoasting | Service account passwords |
147
+ | AS-REP Roasting | Accounts without pre-auth |
148
+ | DCSync | Domain credentials |
149
+ | Golden Ticket | Persistent domain access |
150
+
151
+ ---
152
+
153
+ ## 8. Reporting Principles
154
+
155
+ ### Attack Narrative
156
+
157
+ Document the full attack chain:
158
+ 1. How initial access was gained
159
+ 2. What techniques were used
160
+ 3. What objectives were achieved
161
+ 4. Where detection failed
162
+
163
+ ### Detection Gaps
164
+
165
+ For each successful technique:
166
+ - What should have detected it?
167
+ - Why didn't detection work?
168
+ - How to improve detection
169
+
170
+ ---
171
+
172
+ ## 9. Ethical Boundaries
173
+
174
+ ### Always
175
+
176
+ - Stay within scope
177
+ - Minimize impact
178
+ - Report immediately if real threat found
179
+ - Document all actions
180
+
181
+ ### Never
182
+
183
+ - Destroy production data
184
+ - Cause denial of service (unless scoped)
185
+ - Access beyond proof of concept
186
+ - Retain sensitive data
187
+
188
+ ---
189
+
190
+ ## 10. Anti-Patterns
191
+
192
+ | ❌ Don't | ✅ Do |
193
+ |----------|-------|
194
+ | Rush to exploitation | Follow methodology |
195
+ | Cause damage | Minimize impact |
196
+ | Skip reporting | Document everything |
197
+ | Ignore scope | Stay within boundaries |
198
+
199
+ ---
200
+
201
+ > **Remember:** Red team simulates attackers to improve defenses, not to cause harm.