@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,162 @@
1
+ ---
2
+ name: server-management
3
+ description: Server management principles and decision-making. Process management, monitoring strategy, and scaling decisions. Teaches thinking, not commands.
4
+ when_to_use: "When managing servers, configuring process managers (PM2), setting up monitoring, or planning scaling strategies."
5
+ allowed-tools: Read, Write, Edit, Glob, Grep, Bash
6
+ ---
7
+
8
+ # Server Management
9
+
10
+ > Server management principles for production operations.
11
+ > **Learn to THINK, not memorize commands.**
12
+
13
+ ---
14
+
15
+ ## 1. Process Management Principles
16
+
17
+ ### Tool Selection
18
+
19
+ | Scenario | Tool |
20
+ |----------|------|
21
+ | **Node.js app** | PM2 (clustering, reload) |
22
+ | **Any app** | systemd (Linux native) |
23
+ | **Containers** | Docker/Podman |
24
+ | **Orchestration** | Kubernetes, Docker Swarm |
25
+
26
+ ### Process Management Goals
27
+
28
+ | Goal | What It Means |
29
+ |------|---------------|
30
+ | **Restart on crash** | Auto-recovery |
31
+ | **Zero-downtime reload** | No service interruption |
32
+ | **Clustering** | Use all CPU cores |
33
+ | **Persistence** | Survive server reboot |
34
+
35
+ ---
36
+
37
+ ## 2. Monitoring Principles
38
+
39
+ ### What to Monitor
40
+
41
+ | Category | Key Metrics |
42
+ |----------|-------------|
43
+ | **Availability** | Uptime, health checks |
44
+ | **Performance** | Response time, throughput |
45
+ | **Errors** | Error rate, types |
46
+ | **Resources** | CPU, memory, disk |
47
+
48
+ ### Alert Severity Strategy
49
+
50
+ | Level | Response |
51
+ |-------|----------|
52
+ | **Critical** | Immediate action |
53
+ | **Warning** | Investigate soon |
54
+ | **Info** | Review daily |
55
+
56
+ ### Monitoring Tool Selection
57
+
58
+ | Need | Options |
59
+ |------|---------|
60
+ | Simple/Free | PM2 metrics, htop |
61
+ | Full observability | Grafana, Datadog |
62
+ | Error tracking | Sentry |
63
+ | Uptime | UptimeRobot, Pingdom |
64
+
65
+ ---
66
+
67
+ ## 3. Log Management Principles
68
+
69
+ ### Log Strategy
70
+
71
+ | Log Type | Purpose |
72
+ |----------|---------|
73
+ | **Application logs** | Debug, audit |
74
+ | **Access logs** | Traffic analysis |
75
+ | **Error logs** | Issue detection |
76
+
77
+ ### Log Principles
78
+
79
+ 1. **Rotate logs** to prevent disk fill
80
+ 2. **Structured logging** (JSON) for parsing
81
+ 3. **Appropriate levels** (error/warn/info/debug)
82
+ 4. **No sensitive data** in logs
83
+
84
+ ---
85
+
86
+ ## 4. Scaling Decisions
87
+
88
+ ### When to Scale
89
+
90
+ | Symptom | Solution |
91
+ |---------|----------|
92
+ | High CPU | Add instances (horizontal) |
93
+ | High memory | Increase RAM or fix leak |
94
+ | Slow response | Profile first, then scale |
95
+ | Traffic spikes | Auto-scaling |
96
+
97
+ ### Scaling Strategy
98
+
99
+ | Type | When to Use |
100
+ |------|-------------|
101
+ | **Vertical** | Quick fix, single instance |
102
+ | **Horizontal** | Sustainable, distributed |
103
+ | **Auto** | Variable traffic |
104
+
105
+ ---
106
+
107
+ ## 5. Health Check Principles
108
+
109
+ ### What Constitutes Healthy
110
+
111
+ | Check | Meaning |
112
+ |-------|---------|
113
+ | **HTTP 200** | Service responding |
114
+ | **Database connected** | Data accessible |
115
+ | **Dependencies OK** | External services reachable |
116
+ | **Resources OK** | CPU/memory not exhausted |
117
+
118
+ ### Health Check Implementation
119
+
120
+ - Simple: Just return 200
121
+ - Deep: Check all dependencies
122
+ - Choose based on load balancer needs
123
+
124
+ ---
125
+
126
+ ## 6. Security Principles
127
+
128
+ | Area | Principle |
129
+ |------|-----------|
130
+ | **Access** | SSH keys only, no passwords |
131
+ | **Firewall** | Only needed ports open |
132
+ | **Updates** | Regular security patches |
133
+ | **Secrets** | Environment vars, not files |
134
+ | **Audit** | Log access and changes |
135
+
136
+ ---
137
+
138
+ ## 7. Troubleshooting Priority
139
+
140
+ When something's wrong:
141
+
142
+ 1. **Check if running** (process status)
143
+ 2. **Check logs** (error messages)
144
+ 3. **Check resources** (disk, memory, CPU)
145
+ 4. **Check network** (ports, DNS)
146
+ 5. **Check dependencies** (database, APIs)
147
+
148
+ ---
149
+
150
+ ## 8. Anti-Patterns
151
+
152
+ | ❌ Don't | ✅ Do |
153
+ |----------|-------|
154
+ | Run as root | Use non-root user |
155
+ | Ignore logs | Set up log rotation |
156
+ | Skip monitoring | Monitor from day one |
157
+ | Manual restarts | Auto-restart config |
158
+ | No backups | Regular backup schedule |
159
+
160
+ ---
161
+
162
+ > **Remember:** A well-managed server is boring. That's the goal.
@@ -0,0 +1,133 @@
1
+ ---
2
+ name: simplify-code
3
+ description: Reduce complexity of over-engineered code. Identify unnecessary abstractions, remove dead code, flatten deep nesting, and simplify logic while preserving behavior.
4
+ when_to_use: "When code is over-engineered, overly abstract, deeply nested, or more complex than needed. When user asks to 'simplify', 'clean up', 'reduce complexity', or 'make this simpler'. NOT for adding new features."
5
+ allowed-tools: Read, Write, Edit, Grep, Glob
6
+ effort: medium
7
+ ---
8
+
9
+ # Simplify Code — Reduce Unnecessary Complexity
10
+
11
+ > The best code is the code you don't have to write. The second best is the code anyone can read.
12
+
13
+ ## Core Principle
14
+
15
+ ```
16
+ Complexity is a cost. Every abstraction, every indirection, every clever pattern
17
+ adds cognitive load. Simplify ruthlessly unless complexity serves a clear purpose.
18
+ ```
19
+
20
+ > 💡 **Nota:** A prevenção de over-engineering na criação de código novo é coberta por `@[skills/karpathy-guidelines]` (§2 Simplicity First). Esta skill (`simplify-code`) foca especificamente na refatoração pós-fato de código que já se encontra excessivamente complexo.
21
+
22
+ ---
23
+
24
+ ## Simplification Checklist
25
+
26
+ ### 1. Unnecessary Abstractions
27
+ | Smell | Simplification |
28
+ |---|---|
29
+ | Wrapper class that just delegates | Remove wrapper, use the inner class directly |
30
+ | Factory that creates only one type | Replace with direct constructor |
31
+ | Strategy pattern with one strategy | Replace with simple function |
32
+ | Interface with one implementation | Remove interface, use the class |
33
+ | Abstract class with one child | Merge into the child class |
34
+ | Config object for 2 values | Use function parameters |
35
+
36
+ ### 2. Dead Code
37
+ | Smell | Action |
38
+ |---|---|
39
+ | Unused imports | Remove |
40
+ | Unreachable branches | Remove (check tests first) |
41
+ | Commented-out code | Remove (it's in git history) |
42
+ | Unused variables/functions | Remove |
43
+ | TODO comments older than 6 months | Remove or create issue |
44
+ | Feature flags for launched features | Remove flag, keep the code |
45
+
46
+ ### 3. Deep Nesting
47
+ ```javascript
48
+ // ❌ Before: 4 levels deep
49
+ function process(data) {
50
+ if (data) {
51
+ if (data.items) {
52
+ for (const item of data.items) {
53
+ if (item.active) {
54
+ doSomething(item)
55
+ }
56
+ }
57
+ }
58
+ }
59
+ }
60
+
61
+ // ✅ After: Early returns + filter
62
+ function process(data) {
63
+ if (!data?.items) return
64
+
65
+ data.items
66
+ .filter(item => item.active)
67
+ .forEach(doSomething)
68
+ }
69
+ ```
70
+
71
+ ### 4. Over-Parameterized Functions
72
+ ```typescript
73
+ // ❌ Before: 8 parameters
74
+ function createUser(name, email, age, role, dept, active, verified, avatar) { }
75
+
76
+ // ✅ After: Object parameter
77
+ function createUser(opts: CreateUserOpts) { }
78
+ ```
79
+
80
+ ### 5. Premature Optimization
81
+ | Smell | Simplification |
82
+ |---|---|
83
+ | Custom cache for <100 items | Remove cache, measure first |
84
+ | Memoization on cheap functions | Remove memo |
85
+ | Lazy loading for small modules | Use direct import |
86
+ | Complex state machine for 3 states | Use simple if/else or switch |
87
+
88
+ ---
89
+
90
+ ## Simplification Protocol
91
+
92
+ ### Step 1: Identify Complexity
93
+ ```
94
+ - Count nesting levels (target: ≤3)
95
+ - Count function parameters (target: ≤4)
96
+ - Count lines per function (target: ≤30)
97
+ - Count abstractions per feature (target: ≤2)
98
+ - Check for dead code (target: 0)
99
+ ```
100
+
101
+ ### Step 2: Verify Understanding
102
+ Before simplifying, ensure you understand:
103
+ - What the code does (not what it looks like it does)
104
+ - Why it was written this way (maybe there's a reason)
105
+ - What tests cover it (simplification must not break tests)
106
+
107
+ ### Step 3: Simplify Incrementally
108
+ ```
109
+ 1. Remove dead code first (safest)
110
+ 2. Flatten nesting with early returns
111
+ 3. Inline trivial abstractions
112
+ 4. Merge related functions
113
+ 5. Simplify data structures
114
+ ```
115
+
116
+ ### Step 4: Verify Behavior Preserved
117
+ ```bash
118
+ npm run test # All existing tests still pass
119
+ npm run build # Still compiles
120
+ ```
121
+
122
+ ---
123
+
124
+ ## When NOT to Simplify
125
+
126
+ | Situation | Why Keep Complexity |
127
+ |---|---|
128
+ | Performance-critical hot path | Optimization may look complex but is necessary |
129
+ | Required by framework/library | External constraints |
130
+ | Explicitly requested pattern | User chose this architecture |
131
+ | Will need extension soon | Abstraction prepares for known growth |
132
+
133
+ > **Ask first:** "This pattern seems over-engineered. Should I simplify it, or is there a reason for the abstraction?"
@@ -0,0 +1,116 @@
1
+ ---
2
+ name: skillify
3
+ description: Auto-create new skills from repetitive workflows. When you notice yourself doing the same multi-step process repeatedly, extract it into a reusable SKILL.md that any agent can use.
4
+ when_to_use: "When the user says 'make this a skill', 'create a skill for this', 'I keep doing this same thing', or when a repetitive multi-step pattern is observed. NOT for one-off tasks."
5
+ allowed-tools: read, write, glob, grep
6
+ effort: low
7
+ ---
8
+
9
+ # Skillify — Auto-Create Skills from Workflows
10
+
11
+ > Turn repetitive patterns into reusable skills. If you've done it three times, it should be a skill.
12
+
13
+ ## When to Skillify
14
+
15
+ ✅ **Good candidates:**
16
+ - You've seen the user ask for the same type of work 3+ times
17
+ - A workflow involves 5+ consistent steps
18
+ - The pattern works across different projects
19
+ - Other agents could benefit from this knowledge
20
+
21
+ ❌ **Bad candidates:**
22
+ - One-off tasks (just do them)
23
+ - Project-specific hacks (use memory instead)
24
+ - Already covered by existing skills (check first)
25
+
26
+ ---
27
+
28
+ ## Skill Creation Protocol
29
+
30
+ ### Step 1: Identify the Pattern
31
+ ```
32
+ What triggers this workflow? (user says X, file type Y, domain Z)
33
+ What steps are always the same?
34
+ What parts vary between uses?
35
+ What's the expected output?
36
+ ```
37
+
38
+ ### Step 2: Generate SKILL.md
39
+
40
+ Use this template:
41
+
42
+ ```markdown
43
+ ---
44
+ name: [kebab-case-name]
45
+ description: [One sentence describing what this skill does]
46
+ when_to_use: "[When the user asks X, works with Y files, or Z domain. NOT for A.]"
47
+ allowed-tools: read, write, edit, grep, glob, bash
48
+ effort: [low | medium | high]
49
+ ---
50
+
51
+ # [Skill Name] — [Short Subtitle]
52
+
53
+ > [One-line philosophy or principle]
54
+
55
+ ## Overview
56
+ [2-3 sentences explaining what this skill enables]
57
+
58
+ ## When to Use
59
+ ✅ Good for: [list]
60
+ ❌ Not for: [list]
61
+
62
+ ## Protocol
63
+ ### Step 1: [First Action]
64
+ [Instructions]
65
+
66
+ ### Step 2: [Second Action]
67
+ [Instructions]
68
+
69
+ ### Step N: [Verification]
70
+ [How to verify the skill worked correctly]
71
+
72
+ ## Best Practices
73
+ [3-5 key rules]
74
+ ```
75
+
76
+ ### Step 3: Place the Skill in Canonical Source
77
+ ```
78
+ kit/skills/[skill-name]/SKILL.md
79
+ ```
80
+ Then run `npm run generate` or `npm run validate:skills` to compile for all IDE targets (`.cursor/skills/`, `.claude/skills/`, `.agents/skills/`).
81
+
82
+ ### Step 4: Verify
83
+ - [ ] Frontmatter has all required fields (name, description, when_to_use, allowed-tools)
84
+ - [ ] `when_to_use` clearly defines triggers AND exclusions
85
+ - [ ] Steps are actionable, not vague
86
+ - [ ] Skill doesn't duplicate an existing one (check `kit/skills/`)
87
+
88
+ ---
89
+
90
+ ## Naming Conventions
91
+
92
+ | Pattern | Skill Name | Example |
93
+ |---|---|---|
94
+ | Action-based | `[verb]-[noun]` | `verify-changes`, `batch-operations` |
95
+ | Domain-based | `[domain]-[aspect]` | `database-design`, `api-patterns` |
96
+ | Tool-based | `[tool]-patterns` | `tailwind-patterns`, `prisma-expert` |
97
+
98
+ **Rules:**
99
+ - kebab-case only
100
+ - 2-3 words maximum
101
+ - Descriptive, not clever
102
+ - No abbreviations unless universally known
103
+
104
+ ---
105
+
106
+ ## Quality Checklist
107
+
108
+ Before finalizing a new skill:
109
+
110
+ | Check | Criteria |
111
+ |---|---|
112
+ | **Uniqueness** | No existing skill covers this (grep `.cursor/skills/`) |
113
+ | **Reusability** | Useful across multiple projects, not just one |
114
+ | **Completeness** | Has overview, when to use, protocol, verification |
115
+ | **Frontmatter** | All required fields present and accurate |
116
+ | **Clarity** | A new agent could follow these instructions cold |
@@ -0,0 +1,268 @@
1
+ ---
2
+ name: system-design-interview
3
+ description: Roteiro cost-aware para entrevista de system design (45-60 min). Requisitos, estimativa, API, alto nível, escala e mock interview com rubrica. Complementa architecture (ADR em projeto real), não substitui.
4
+ when_to_use: "When practicing or conducting a system design interview, mock interviews, or whiteboard-scale problems with back-of-the-envelope numbers. NOT for documenting production architecture (use architecture + ADR)."
5
+ allowed-tools: Read, Glob, Grep
6
+ ---
7
+
8
+ # System Design Interview (cost-aware)
9
+
10
+ > "Na entrevista você comunica raciocínio sob pressão. No projeto você registra decisão durável."
11
+
12
+ ## Escopo e fronteira
13
+
14
+ Esta skill cobre **entrevista de system design** típica de **45 a 60 minutos**: clarificar requisitos, estimar carga, esboçar dados e API, desenhar alto nível e discutir gargalos com trade-offs.
15
+
16
+ Ela **complementa** `@[skills/architecture]`, que é o framework para **decisão real em projeto** (requisitos, trade-offs, **ADR**). Aqui não há ADR nem escolha de stack para deploy; há narrativa clara para o entrevistador.
17
+
18
+ | Situação | Skill |
19
+ |----------|-------|
20
+ | Simular entrevista, estudar padrões, números na lousa | `system-design-interview` (esta) |
21
+ | Decidir arquitetura do produto, escrever ADR, time em produção | `@[skills/architecture]` |
22
+ | Contratos HTTP, versionamento, erros | `@[skills/api-patterns]` |
23
+ | Schema, índices, particionamento detalhado | `@[skills/database-design]` |
24
+
25
+ ---
26
+
27
+ ## Roteiro em 5 fases (com tempo sugerido)
28
+
29
+ Total alvo: **45 min** (esticar até 60 se o entrevistador pedir aprofundamento).
30
+
31
+ | Fase | Tempo | Entrega |
32
+ |------|-------|---------|
33
+ | **1. Requisitos** | 8-10 min | Funcionais, não funcionais e **números** (DAU, QPS leitura/escrita, tamanho médio de registro, latência p95 alvo, retenção) |
34
+ | **2. Modelo de dados** | 8-10 min | Entidades, cardinalidade, chaves, o que é hot vs cold |
35
+ | **3. API** | 5-8 min | Endpoints, contratos, idempotência onde importa |
36
+ | **4. Alto nível** | 10-12 min | Clientes, serviços, armazenamentos, fluxo feliz |
37
+ | **5. Escala e trade-offs** | 12-15 min | Gargalo, cache, filas, sharding, consistência, falha, **custo** |
38
+
39
+ ### Fase 1: requisitos e back-of-the-envelope
40
+
41
+ Perguntas mínimas antes de desenhar:
42
+
43
+ - Quem usa? DAU, pico vs média, multi-região?
44
+ - Leitura vs escrita (ratio típico 10:1, 100:1)?
45
+ - Tamanho médio do payload (bytes por registro/evento)?
46
+ - Latência alvo (p95) e consistência (forte, eventual, read-your-writes)?
47
+ - Retenção e compliance (PII, TTL)?
48
+
49
+ **Estimativa rápida (sempre com unidade):**
50
+
51
+ ```text
52
+ QPS_write ≈ (DAU × ações_por_dia_por_usuário) / 86_400
53
+ QPS_read ≈ QPS_write × ratio_leitura_escrita
54
+ storage_anual ≈ registros_por_dia × bytes_por_registro × 365
55
+ ```
56
+
57
+ Arredonde para ordem de magnitude; declare premissas em voz alta.
58
+
59
+ ### Fase 2: entidades
60
+
61
+ Nomeie 3-6 entidades, relações 1:N ou N:M, e onde fica a fonte da verdade. Evite normalizar demais na lousa; mostre o que indexa lookup quente.
62
+
63
+ ### Fase 3: API
64
+
65
+ REST ou RPC explícito; métodos, paths, códigos de erro principais. Autenticação só se o enunciado pedir.
66
+
67
+ ### Fase 4: diagrama alto nível
68
+
69
+ Uma caixa por responsabilidade: LB, app stateless, cache, DB primário, fila, workers, blob store. Trace um request read e um write.
70
+
71
+ ### Fase 5: gargalos, escala, trade-offs
72
+
73
+ Ordem usual: DB write path → fan-out de leitura → hot keys → egress. Mencione: cache (TTL, invalidação), fila (async, backpressure), réplicas de leitura, particionamento por `user_id` ou `shard_key`, circuit breaker, degradação graciosa.
74
+
75
+ ---
76
+
77
+ ## Checklist cost-aware
78
+
79
+ Antes de fechar o desenho, passe estes itens (mesmo em entrevista; mostra maturidade):
80
+
81
+ | Item | Pergunta |
82
+ |------|----------|
83
+ | **Custo por requisição** | Quanto CPU/IO por read vs write? Cache elimina quantos % das leituras? |
84
+ | **Custo por usuário/mês** | `(storage + egress + compute + managed APIs) / MAU` em ordem de grandeza |
85
+ | **Egress** | CDN para estáticos; compressão; paginação; evitar chatty API |
86
+ | **Armazenamento quente vs frio** | SSD/DB para 7-30 dias; objeto/arquivo barato para histórico; TTL legal |
87
+ | **Managed vs self-hosted** | Managed acelera time-to-market; self-hosted só com volume ou requisito claro |
88
+ | **Quando NÃO escalar** | KISS: monólito + Postgres + Redis até QPS ou time provar gargalo |
89
+ | **Observabilidade mínima** | métricas (QPS, p95, erro), traces no path crítico, alertas em SLO |
90
+ | **IA / LLM** | tokens por usuário por dia, cache de embedding, batch, modelo menor para draft |
91
+
92
+ ---
93
+
94
+ ## Modo mock interview (conduta do agente)
95
+
96
+ Quando o humano pedir **mock interview**:
97
+
98
+ 1. **Papéis:** agente = entrevistador; humano = candidato.
99
+ 2. **Enunciado:** uma frase (ex.: "Encurtador de URL com analytics básico").
100
+ 3. **Perguntas socráticas** nas fases 1-3; **não** entregue a solução completa durante o exercício.
101
+ 4. **Cronômetro:** anuncie fase e tempo restante a cada transição (ex.: "Fase 1, 7 min restantes").
102
+ 5. **Notas internas:** registre lacunas (só no final).
103
+ 6. **Feedback final** com rubrica (1-5 cada, com evidência):
104
+
105
+ | Critério | O que avaliar |
106
+ |----------|----------------|
107
+ | **Requisitos** | Perguntou escopo, números, edge cases antes de desenhar |
108
+ | **Estimativa** | Contas com unidade, premissas explícitas, ordem de magnitude plausível |
109
+ | **Desenho** | Componentes necessários, fluxo claro, sem over-engineering |
110
+ | **Trade-offs** | Consistência, falha, cache, custo; alternativa mais simples citada |
111
+ | **Comunicação** | Estrutura, checa entendimento, prioriza o crítico |
112
+
113
+ Ofereça **um** ajuste de maior impacto para a próxima tentativa.
114
+
115
+ ---
116
+
117
+ ## Anti-padrões
118
+
119
+ | Anti-padrão | Por que falha |
120
+ |-------------|----------------|
121
+ | Desenhar caixas antes de requisitos | Revela solução memorizada, ignora escopo |
122
+ | Microserviços por padrão | Custo operacional sem gargalo provado |
123
+ | Números sem unidade | "10 milhões" sem saber se é/dia, QPS ou bytes |
124
+ | Um banco para tudo sem motivo | OK no MVP; escalar exige dizer **qual** query doeu |
125
+ | Ignorar custo e egress | Decisão de produção; entrevistador sênior nota |
126
+ | Pular consistência em write path | Duplicata, perda de mensagem, double spend |
127
+
128
+ ---
129
+
130
+ ## Exercício 1 resolvido: encurtador de URL
131
+
132
+ ### Requisitos (resumo)
133
+
134
+ - Criar short link, redirecionar, opcional custom slug (se livre).
135
+ - Analytics: contagem de cliques (não precisa real-time sub-segundo).
136
+ - **NFR:** p95 redirect < 50 ms (cache quente); disponibilidade 99.9%; retenção 5 anos.
137
+ - **Números:** 10M DAU; 1 redirect/usuário/dia; 1 create/100 usuários/dia.
138
+
139
+ ### Estimativa
140
+
141
+ ```text
142
+ QPS_read ≈ 10_000_000 / 86_400 ≈ 116 RPS (pico ×3 → ~350 RPS)
143
+ QPS_write ≈ 100_000 / 86_400 ≈ 1.2 RPS
144
+ Payload: mapping ~100 B; click event ~200 B
145
+ clicks/dia ≈ 10M → ~2 GB/dia de eventos → ~730 GB/ano (ordem 1 TB/ano)
146
+ ```
147
+
148
+ ### Entidades
149
+
150
+ | Entidade | Campos principais |
151
+ |----------|-------------------|
152
+ | `UrlMapping` | `short_code` (PK), `long_url`, `owner_id`, `created_at`, `expires_at` |
153
+ | `ClickEvent` | `id`, `short_code`, `ts`, `referrer` (append-only) |
154
+
155
+ ### API
156
+
157
+ ```http
158
+ POST /v1/links → { long_url, custom_slug? } → 201 { short_url }
159
+ GET /{short_code} → 302 Location (ou 404)
160
+ GET /v1/links/{code}/stats → agregado diário
161
+ ```
162
+
163
+ ### Alto nível
164
+
165
+ ```mermaid
166
+ flowchart LR
167
+ Client --> LB
168
+ LB --> API[API stateless]
169
+ API --> Cache[(Redis: short_code→long_url)]
170
+ API --> PG[(PostgreSQL: mappings)]
171
+ API --> Q[Queue]
172
+ Q --> Worker[Click aggregator]
173
+ Worker --> PG
174
+ Worker --> Cold[(Object storage: raw clicks)]
175
+ ```
176
+
177
+ Redirect: cache hit → sem DB. Miss → DB → populate cache (TTL 24h). Cliques: async na fila (aceita eventual no analytics).
178
+
179
+ ### Gargalos e custo
180
+
181
+ - **Gargalo:** read path; **mitigação:** Redis, CDN só se landing custom.
182
+ - **Hot key:** viral link; shard cache ou redirect 302 para edge rule.
183
+ - **Custo:** 350 RPS é trivial em 1 região; **KISS:** Postgres + Redis managed; cold storage barato para eventos. Egress baixo (redirect 302 pequeno).
184
+
185
+ ---
186
+
187
+ ## Exercício 2 resolvido: feed de notificações / chat simples
188
+
189
+ ### Requisitos (resumo)
190
+
191
+ - Usuário envia mensagem 1:1 ou notificação in-app; destinatário vê feed ordenado por tempo.
192
+ - Entrega: online via long poll ou WebSocket; offline persiste e entrega ao conectar.
193
+ - **NFR:** entrega < 2 s p95 para online; retenção 90 dias; até 50k usuários conectados simultâneos em pico.
194
+ - **Números:** 2M DAU; 20 msgs/usuário/dia; 80% leitura (abrir feed) vs 20% escrita.
195
+
196
+ ### Estimativa
197
+
198
+ ```text
199
+ QPS_write ≈ 2_000_000 × 20 / 86_400 ≈ 463 RPS
200
+ QPS_read ≈ 463 × 4 ≈ 1_850 RPS (ratio 4:1 leitura na abertura do feed)
201
+ Msgs/dia ≈ 2_000_000 × 20 = 40M; msg ~500 B → ~20 GB/dia escritos → ~1.8 TB/90 dias
202
+ Conexões WS: 50k (um shard de conexão por região)
203
+ ```
204
+
205
+ ### Entidades
206
+
207
+ | Entidade | Campos principais |
208
+ |----------|-------------------|
209
+ | `Message` | `message_id`, `thread_id`, `from_user`, `to_user`, `body`, `created_at` |
210
+ | `InboxState` | `user_id`, `last_read_at`, `unread_count` (cacheável) |
211
+ | `DeliveryCursor` | `user_id`, `device_id`, `last_ack_id` |
212
+
213
+ ### API
214
+
215
+ ```http
216
+ POST /v1/threads/{id}/messages → 201 { message_id }
217
+ GET /v1/inbox?cursor=&limit=50 → { items[], next_cursor }
218
+ WS /v1/stream → push { type, payload }
219
+ POST /v1/devices/register → FCM/APNs token
220
+ ```
221
+
222
+ ### Alto nível
223
+
224
+ ```text
225
+ ┌─────────────┐
226
+ Mobile/Web ──────►│ API + WS GW │
227
+ └──────┬──────┘
228
+ ┌───────────────┼───────────────┐
229
+ ▼ ▼ ▼
230
+ [Pub/Sub] [Message DB] [Presence Redis]
231
+ fan-out partition by user online?
232
+ thread_id
233
+ │
234
+ ▼
235
+ [Push worker] ──► FCM/APNs (offline)
236
+ ```
237
+
238
+ Write: persistência em DB (ordem por `thread_id`, `created_at`). Fan-out: para 1:1, um registro + push ao socket do destinatário; sem timeline global.
239
+
240
+ ### Gargalos, consistência e custo
241
+
242
+ - **Gargalo:** conexões WebSocket e fan-out; **mitigação:** GW stateful horizontal com sticky session; Redis pub/sub entre nós.
243
+ - **Consistência:** mensagem "entregue" após ack no cliente; duplicata tratada com `message_id` idempotente.
244
+ - **Custo:** ~2k RPS DB com índice `(to_user, created_at DESC)`; Redis para presença e unread; push provider por MAU. **Não** shard no dia 1; particionar por `user_id` se inbox > 10M rows/user path lento.
245
+ - **LLM:** fora do escopo; se resumo com IA, orçar tokens offline, não no hot path.
246
+
247
+ ---
248
+
249
+ ## Validação antes de encerrar (candidato ou agente)
250
+
251
+ - [ ] Requisitos e números com unidade
252
+ - [ ] Entidades e API alinhadas ao escopo
253
+ - [ ] Diagrama com fluxo read e write
254
+ - [ ] Pelo menos um gargalo com mitigação e alternativa mais simples
255
+ - [ ] Linha de custo (compute, storage, egress, managed)
256
+ - [ ] Se projeto real: handoff para `@[skills/architecture]` e ADR
257
+
258
+ ---
259
+
260
+ ## Skills relacionadas
261
+
262
+ | Skill | Uso |
263
+ |-------|-----|
264
+ | `@[skills/architecture]` | Pós-entrevista / projeto: ADR, trade-offs duráveis |
265
+ | `@[skills/api-patterns]` | Detalhe de contrato e erros |
266
+ | `@[skills/database-design]` | Índices, particionamento, migração |
267
+ | `@[skills/research]` | Comparar managed services antes de decidir |
268
+ | `@[skills/sequential-thinking]` | Decompor problema multi-etapa na lousa |