@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,259 @@
1
+ ---
2
+ name: mcp-builder
3
+ description: MCP (Model Context Protocol) server building principles. Tool design, resource patterns, best practices.
4
+ when_to_use: "When building MCP (Model Context Protocol) servers, designing MCP tools, or implementing MCP resource patterns."
5
+ allowed-tools: Read, Write, Edit, Glob, Grep
6
+ ---
7
+
8
+ # MCP Builder
9
+
10
+ > Principles for building MCP servers.
11
+
12
+ ---
13
+
14
+ ## 1. MCP Overview
15
+
16
+ ### What is MCP?
17
+
18
+ Model Context Protocol - standard for connecting AI systems with external tools and data sources.
19
+
20
+ ### Core Concepts
21
+
22
+ | Concept | Purpose |
23
+ |---------|---------|
24
+ | **Tools** | Functions AI can call |
25
+ | **Resources** | Data AI can read |
26
+ | **Prompts** | Pre-defined prompt templates |
27
+
28
+ ---
29
+
30
+ ## 2. Server Architecture
31
+
32
+ ### Project Structure
33
+
34
+ ```
35
+ my-mcp-server/
36
+ ├── src/
37
+ │ └── index.ts # Main entry
38
+ ├── package.json
39
+ └── tsconfig.json
40
+ ```
41
+
42
+ ### Transport Types (MCP Spec)
43
+
44
+ | Type | Use | Specification |
45
+ |------|-----|---------------|
46
+ | **Stdio** | Local, CLI/Desktop process | Standard in/out (logs MUST go to `stderr`) |
47
+ | **SSE / Streamable HTTP** | Remote, web-based | Server-Sent Events with HTTP POST endpoint |
48
+
49
+ ---
50
+
51
+ ## 3. Tool Design Principles
52
+
53
+ ### Good Tool Design
54
+
55
+ | Principle | Description |
56
+ |-----------|-------------|
57
+ | Clear name | Action-oriented (get_weather, create_user) |
58
+ | Single purpose | One thing well |
59
+ | Validated input | Schema with types and descriptions |
60
+ | Structured output | Predictable response format |
61
+
62
+ ### Input Schema Design
63
+
64
+ | Field | Required? |
65
+ |-------|-----------|
66
+ | Type | Yes - object |
67
+ | Properties | Define each param |
68
+ | Required | List mandatory params |
69
+ | Description | Human-readable |
70
+
71
+ ---
72
+
73
+ ## 4. Resource Patterns
74
+
75
+ ### Resource Types
76
+
77
+ | Type | Use |
78
+ |------|-----|
79
+ | Static | Fixed data (config, docs) |
80
+ | Dynamic | Generated on request |
81
+ | Template | URI with parameters |
82
+
83
+ ### URI Patterns
84
+
85
+ | Pattern | Example |
86
+ |---------|---------|
87
+ | Fixed | `docs://readme` |
88
+ | Parameterized | `users://{userId}` |
89
+ | Collection | `files://project/*` |
90
+
91
+ ---
92
+
93
+ ## 5. Error Handling
94
+
95
+ ### Error Types
96
+
97
+ | Situation | Response |
98
+ |-----------|----------|
99
+ | Invalid params | Validation error message |
100
+ | Not found | Clear "not found" |
101
+ | Server error | Generic error, log details |
102
+
103
+ ### Best Practices
104
+
105
+ - Return operational tool errors as `{ isError: true, content: [...] }` so the LLM can self-correct
106
+ - In stdio transport, NEVER use `console.log` (corrupts JSON-RPC); route all diagnostics to `console.error` (stderr)
107
+ - Don't expose internal stack traces or database connection strings
108
+ - Provide actionable, domain-specific error messages
109
+
110
+ ---
111
+
112
+ ## 6. Multimodal Handling
113
+
114
+ ### Supported Types
115
+
116
+ | Type | Encoding |
117
+ |------|----------|
118
+ | Text | Plain text |
119
+ | Images | Base64 + MIME type |
120
+ | Files | Base64 + MIME type |
121
+
122
+ ---
123
+
124
+ ## 7. Security Principles
125
+
126
+ ### Input Validation
127
+
128
+ - Validate all tool inputs
129
+ - Sanitize user-provided data
130
+ - Limit resource access
131
+
132
+ ### API Keys
133
+
134
+ - Use environment variables
135
+ - Don't log secrets
136
+ - Validate permissions
137
+
138
+ ---
139
+
140
+ ## 8. Configuration
141
+
142
+ ### Claude Desktop Config
143
+
144
+ | Field | Purpose |
145
+ |-------|---------|
146
+ | command | Executable to run |
147
+ | args | Command arguments |
148
+ | env | Environment variables |
149
+
150
+ ---
151
+
152
+ ## 9. Testing
153
+
154
+ ### Test Categories
155
+
156
+ | Type | Focus |
157
+ |------|-------|
158
+ | Unit | Tool logic |
159
+ | Integration | Full server |
160
+ | Contract | Schema validation |
161
+
162
+ ---
163
+
164
+ ## 10. Best Practices Checklist
165
+
166
+ - [ ] Clear, action-oriented tool names
167
+ - [ ] Complete input schemas with descriptions
168
+ - [ ] Structured JSON output
169
+ - [ ] Error handling for all cases
170
+ - [ ] Input validation
171
+ - [ ] Environment-based configuration
172
+ - [ ] Logging for debugging
173
+
174
+ ---
175
+
176
+ ## 11. WebMCP do navegador x MCP de servidor
177
+
178
+ O **WebMCP** é uma proposta do lado do navegador em que a página web declara ferramentas para um agente que roda na aba via `navigator.modelContext`. Esse agente executa no contexto da sessão do usuário (cookies, login, DOM da página) e **complementa**, não substitui, um **MCP de servidor**: processo ou serviço HTTP com autenticação própria, persistência, auditoria e acesso para vários clientes (IDE, CLI, cron).
179
+
180
+ ### Exemplo A: WebMCP no navegador
181
+
182
+ ```javascript
183
+ if ("modelContext" in navigator) {
184
+ await navigator.modelContext.provideContext({
185
+ tools: [
186
+ {
187
+ name: "add_to_cart",
188
+ description: "Add a product SKU to the shopping cart",
189
+ inputSchema: {
190
+ type: "object",
191
+ properties: {
192
+ sku: { type: "string", description: "Product SKU" },
193
+ qty: { type: "integer", minimum: 1, description: "Quantity" },
194
+ },
195
+ required: ["sku", "qty"],
196
+ },
197
+ async execute({ sku, qty }) {
198
+ const res = await fetch("/api/cart", {
199
+ method: "POST",
200
+ headers: { "Content-Type": "application/json" },
201
+ body: JSON.stringify({ sku, qty }),
202
+ });
203
+ if (!res.ok) throw new Error(`cart error: ${res.status}`);
204
+ return { content: [{ type: "text", text: `Added ${qty}x ${sku}` }] };
205
+ },
206
+ },
207
+ ],
208
+ });
209
+ }
210
+ ```
211
+
212
+ > **Nota:** API em evolução (W3C Web Machine Learning Community Group / documento explainer). Nomes e formas podem mudar; use feature detect com `if ("modelContext" in navigator)`.
213
+
214
+ ### Exemplo B: MCP de servidor (stdio ou HTTP)
215
+
216
+ ```typescript
217
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
218
+ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
219
+ import { z } from "zod";
220
+
221
+ const server = new McpServer({ name: "nexus-tools", version: "1.0.0" });
222
+
223
+ server.tool(
224
+ "demand_assume",
225
+ "Assume a tracked task in the project tracker",
226
+ { demand_id: z.string().describe("Demand identifier") },
227
+ async ({ demand_id }) => {
228
+ const row = await assumeDemand(demand_id);
229
+ return {
230
+ content: [{ type: "text", text: JSON.stringify(row) }],
231
+ };
232
+ }
233
+ );
234
+
235
+ const transport = new StdioServerTransport();
236
+ await server.connect(transport);
237
+ ```
238
+
239
+ ### Quando usar cada um
240
+
241
+ | Critério | WebMCP | MCP de servidor |
242
+ |----------|--------|-----------------|
243
+ | Onde roda | Aba do navegador, mesmo origin da página | Processo local (stdio) ou serviço remoto (HTTP/SSE) |
244
+ | Quem autentica | Sessão do site (cookies, OAuth do front) | Token/API key do servidor, RBAC próprio |
245
+ | Estado / persistência | Efêmero na página; persiste só via APIs do site | Banco, filas, memória compartilhada |
246
+ | Multiusuário / multiagente | Um usuário por aba; difícil coordenar vários agentes | Vários clientes no mesmo backend auditável |
247
+ | Acesso fora do navegador (CLI, IDE, cron) | Não: exige página aberta | Sim: qualquer cliente MCP |
248
+ | Superfície de risco | Prompt injection via conteúdo da página; tratar HTML/headers como dado, não instrução | Expor só contratos validados; segredos nunca no cliente |
249
+ | Exemplo no ecossistema | Loja expõe `add_to_cart`, busca no catálogo | Servidor de memória: fatos, tarefas, quadro de agentes |
250
+
251
+ ### Regra prática
252
+
253
+ - Dado ou ação que **pertence à sessão do usuário numa página** (carrinho, formulário, wizard UI): **WebMCP**.
254
+ - Estado **compartilhado, auditável, multi-cliente** (demandas, memória, integrações de backoffice): **MCP de servidor**.
255
+ - Os dois **podem coexistir**: a página expõe ações de UI; o servidor guarda o estado e o histórico.
256
+
257
+ ---
258
+
259
+ > **Remember:** MCP tools should be simple, focused, and well-documented. The AI relies on descriptions to use them correctly.
@@ -0,0 +1,181 @@
1
+ ---
2
+ name: memory-system
3
+ description: Persistent cross-session memory management. Enables agents to remember user preferences, project conventions, and past decisions across different sessions using a structured MEMORY.md index and topic files.
4
+ when_to_use: "When the user says 'remember this', 'save this for later', 'don't forget', or when starting a new session and needing to recall past context. Also when /remember workflow is invoked."
5
+ allowed-tools: Read, Write, Grep, Glob
6
+ effort: low
7
+ ---
8
+
9
+ # Memory System — Persistent Cross-Session Memory
10
+
11
+ > Enables agents to remember across sessions. Never re-discover what was already learned.
12
+
13
+ ## Overview
14
+
15
+ The Memory System provides **persistent, searchable memory** that survives across sessions. Instead of re-explaining preferences, conventions, and past decisions every time, agents read a structured MEMORY.md index and topic files.
16
+
17
+ **Token Impact:** +1,000 tokens to load index, but saves 3,000-10,000 tokens by eliminating re-discovery.
18
+
19
+ ---
20
+
21
+ ## Architecture
22
+
23
+ ```
24
+ .cursor/memory/
25
+ ├── MEMORY.md ← Lightweight index (max 200 lines)
26
+ ├── user-preferences.md ← Topic file: user role, style, tools
27
+ ├── project-conventions.md ← Topic file: coding standards, patterns
28
+ ├── tech-decisions.md ← Topic file: past architectural decisions
29
+ ├── feedback-history.md ← Topic file: what user liked/disliked
30
+ └── [topic-name].md ← Additional topic files as needed
31
+ ```
32
+
33
+ ---
34
+
35
+ ## MEMORY.md Index Format
36
+
37
+ The index is a **lightweight pointer file** — short entries that reference topic files for details.
38
+
39
+ **Rules:**
40
+ - Maximum **200 lines** total
41
+ - Each entry: **~150 characters max**
42
+ - Format: `- [type] summary → topic-file.md`
43
+ - Types: `[user]` `[feedback]` `[project]` `[reference]`
44
+
45
+ **Example:**
46
+ ```markdown
47
+ # Memory Index
48
+
49
+ ## User
50
+ - [user] Prefers dark mode, uses Windows 11, PowerShell → user-preferences.md
51
+ - [user] Senior DevOps engineer, 8 years experience → user-preferences.md
52
+ - [user] Primary language: English, sometimes Turkish → user-preferences.md
53
+
54
+ ## Project
55
+ - [project] Always use bun instead of npm → project-conventions.md
56
+ - [project] Tailwind v4 preferred, no v3 → tech-decisions.md
57
+ - [project] No purple/violet colors in UI → project-conventions.md
58
+
59
+ ## Feedback
60
+ - [feedback] User likes concise responses, no filler → feedback-history.md
61
+ - [feedback] User dislikes verbose explanations → feedback-history.md
62
+ - [feedback] User prefers tables over bullet lists → feedback-history.md
63
+
64
+ ## Reference
65
+ - [reference] Squid proxy runs on port 3128 → infrastructure-notes.md
66
+ - [reference] Git workflow: feature branches → main → project-conventions.md
67
+ ```
68
+
69
+ ---
70
+
71
+ ## Topic File Format
72
+
73
+ Each topic file has **frontmatter** and **structured content**:
74
+
75
+ ```markdown
76
+ ---
77
+ type: user | feedback | project | reference
78
+ created: 2026-04-01
79
+ updated: 2026-04-01
80
+ ---
81
+
82
+ # User Preferences
83
+
84
+ ## Development Environment
85
+ - OS: Windows 11
86
+ - Shell: PowerShell
87
+ - Editor: Cursor / Windsurf
88
+ - Package Manager: bun (NOT npm)
89
+
90
+ ## Communication Style
91
+ - Prefers concise responses
92
+ - Likes tables for comparisons
93
+ - Dislikes verbose explanations
94
+ ```
95
+
96
+ ---
97
+
98
+ ## Memory Taxonomy
99
+
100
+ | Type | What to Store | Example |
101
+ |------|--------------|---------|
102
+ | **user** | Role, preferences, tools, communication style | "Senior DevOps, prefers dark mode" |
103
+ | **feedback** | What user liked/disliked about agent output | "User said 'too verbose', prefers tables" |
104
+ | **project** | Coding standards, tech choices, conventions | "Use bun not npm, Tailwind v4" |
105
+ | **reference** | Non-sensitive infrastructure notes, public URLs, configs | "Prod API hostname and port" |
106
+
107
+ ---
108
+
109
+ ## What NOT to Save
110
+
111
+ | Don't Save | Why |
112
+ |---|---|
113
+ | Secrets, credentials, tokens, passwords, private keys, or API keys | Memory is persistent and may be shared across sessions |
114
+ | Information derivable from code | Read `package.json` instead of memorizing deps |
115
+ | Temporary debug context | Clutters memory, not useful later |
116
+ | Exact code snippets | Code changes — memory becomes stale |
117
+ | File paths that may move | Use glob patterns or descriptions instead |
118
+ | Entire conversation transcripts | Memory is for distilled insights only |
119
+
120
+ ---
121
+
122
+ ## Operations
123
+
124
+ ### Save (Trigger: user says "remember", "save", "don't forget")
125
+
126
+ 1. Identify the information type (user/feedback/project/reference)
127
+ 2. Check if relevant topic file exists
128
+ 3. If yes → append to existing topic file
129
+ 4. If no → create new topic file with frontmatter
130
+ 5. Update MEMORY.md index with one-line pointer
131
+ 6. Confirm to user: "Saved to memory: [summary]"
132
+
133
+ ### Recall (Trigger: session start, or "what do you remember about X")
134
+
135
+ 1. Read `.cursor/memory/MEMORY.md` index
136
+ 2. Scan for relevant entries matching the current task
137
+ 3. If match found → read the referenced topic file
138
+ 4. Apply recalled context silently (don't recite memories unless asked)
139
+
140
+ ### Search (Trigger: "do I have any notes about X")
141
+
142
+ 1. Grep across `.cursor/memory/*.md` for the search term
143
+ 2. Return matching entries with file references
144
+ 3. Offer to read full topic file if user wants details
145
+
146
+ ### Prune (Trigger: index exceeds 200 lines)
147
+
148
+ 1. Warn: "Memory index is getting large (X lines). Review recommended."
149
+ 2. Suggest merging related entries
150
+ 3. Suggest archiving old entries to `memory/archive/`
151
+ 4. Never auto-delete — always ask user first
152
+
153
+ ---
154
+
155
+ ## Session Start Protocol
156
+
157
+ At the start of every session:
158
+
159
+ ```
160
+ 1. Check: Does `.cursor/memory/MEMORY.md` exist?
161
+ → YES: Read index. Apply relevant context silently.
162
+ → NO: Continue without memory. Create on first "remember" trigger.
163
+
164
+ 2. Apply memory WITHOUT reciting it.
165
+ ❌ WRONG: "I remember you prefer dark mode and use bun..."
166
+ ✅ RIGHT: (silently apply preferences, use bun in commands)
167
+
168
+ 3. Exception: If user asks "what do you remember?" → recite relevant memories.
169
+ ```
170
+
171
+ ---
172
+
173
+ ## Memory vs. Plan vs. Task
174
+
175
+ | Artifact | Purpose | Lifespan | Location |
176
+ |----------|---------|----------|----------|
177
+ | **Memory** | Cross-session knowledge | Permanent until pruned | `.cursor/memory/` |
178
+ | **Plan** | Task breakdown for current project | Until project complete | Project root |
179
+ | **Task** | Progress tracker for current session | Until session ends | Artifact directory |
180
+
181
+ > Memory = what you KNOW. Plan = what you'll DO. Task = what you're DOING NOW.