@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,134 @@
1
+ ---
2
+ name: negocio-atendimento
3
+ description: Escreve o que a empresa manda para fora — resposta a avaliação, e-mail a cliente ou fornecedor, mensagem de cobrança, resposta a reclamação. Calibra o tom ao destinatário e ao estrago.
4
+ when_to_use: "Quando alguém de negócio pede 'responde essa avaliação', 'escreve um e-mail pro cliente', 'como eu respondo isso', 'me ajuda com essa reclamação', ou cola o texto/print de uma mensagem recebida."
5
+ allowed-tools: Read, Glob, Grep
6
+ ---
7
+
8
+ # Negócio — Atendimento
9
+
10
+ > Carregue **negocio-linguagem** antes. O erro clássico aqui é escrever como
11
+ > empresa grande: educado, correto e sem ninguém dentro.
12
+ >
13
+ > Se a mensagem for de um **cliente em potencial** — e não de um cliente já
14
+ > atendido — carregue **negocio-qualificacao** primeiro: o que responder depende
15
+ > de a pessoa estar só pesquisando ou querendo comprar hoje.
16
+
17
+ ---
18
+
19
+ ## Recusa
20
+
21
+ Não escreva como empresa grande: correto e sem ninguém dentro. Não peça desculpa genérica. Se for lead, não atenda antes de `negocio-qualificacao`.
22
+
23
+ ---
24
+
25
+ ## 1. O teste
26
+
27
+ Antes de entregar, leia em voz alta e pergunte: **um humano escreveria isso?**
28
+
29
+ Se soa como aviso de operadora de telefonia, jogue fora. Marcas de que caiu no
30
+ modo corporativo:
31
+
32
+ - "Prezado cliente," / "Agradecemos o seu contato."
33
+ - "Lamentamos o ocorrido e reforçamos nosso compromisso com a excelência."
34
+ - "Sua opinião é muito importante para nós."
35
+ - "Ficamos à disposição para quaisquer esclarecimentos."
36
+ - Frase passiva quando cabe ativa: *"foi identificado um problema"* → *"eu errei o pedido"*.
37
+
38
+ O padrão de qualidade é: **curto, específico, com o nome da pessoa, e com uma
39
+ frase que só serve para aquele caso.** Genérico é o defeito.
40
+
41
+ ---
42
+
43
+ ## 2. Calibragem
44
+
45
+ | Situação | Tom | Tamanho |
46
+ |----------|-----|---------|
47
+ | Avaliação 5 estrelas | leve, agradecido, sem drama | 1–2 frases |
48
+ | Avaliação 3–4 estrelas | agradece e responde a ressalva | 2–3 frases |
49
+ | Avaliação 1–2 estrelas | direto, assume, tira do público | 2–3 frases |
50
+ | Cliente irritado | reconhece antes de explicar | curto |
51
+ | Cobrança | cordial e inequívoco sobre valor e prazo | curto |
52
+ | Fornecedor / parceiro | igual para igual, sem subserviência | médio |
53
+ | Erro nosso | assume na primeira frase, sem "se" | curto |
54
+
55
+ Em todas: **uma coisa por mensagem.** Duas perguntas numa mensagem viram zero
56
+ resposta.
57
+
58
+ ---
59
+
60
+ ## 3. Avaliação pública
61
+
62
+ Quem lê a resposta **não é quem reclamou** — são os próximos cinquenta clientes
63
+ avaliando se dá para confiar. Escreva para a plateia, falando com a pessoa.
64
+
65
+ - Use o **primeiro nome** de quem avaliou.
66
+ - Varie o agradecimento. Cinco respostas idênticas em sequência denunciam robô e
67
+ fazem mais estrago que não responder.
68
+ - Cite **algo concreto** do que a pessoa falou — o produto, o serviço, a visita.
69
+ - Numa nota baixa: **assuma o que for verdade, não discuta em público, e ofereça o
70
+ canal privado.** Uma frase para cada.
71
+ - Nunca revele dado do cliente na resposta pública — valor pago, endereço,
72
+ telefone, o que ele comprou, histórico.
73
+
74
+ **Não responda no impulso quando a avaliação for injusta.** Escreva, e diga a ele
75
+ para reler daqui a uma hora antes de publicar.
76
+
77
+ **Avaliação falsa, de concorrente ou de bot.** Sinais: perfil sem histórico, texto
78
+ genérico copiado, nota baixa em sequência, elogio exagerado de marca rival, ou
79
+ conteúdo que não bate com nenhum atendimento real. **Não responda** — resposta
80
+ pública dá palco ao que deveria sumir. **Denuncie na plataforma** quando houver
81
+ botão de reportar avaliação suspeita ou violação de política; guarde print e data.
82
+ Se a plataforma não remover e o estrago continuar, encaminhe para advogado — não
83
+ invente acusação nem contra-ataque em público.
84
+
85
+ **Cliente que ameaça processo ou expõe dado sensível na avaliação.** Não discuta
86
+ direito, culpa ou valor na resposta pública — isso é com advogado. Resposta curta:
87
+ reconheça que viu, convide para canal privado (telefone ou e-mail), e **não
88
+ repita** o dado exposto (CPF, endereço, valor de contrato, condição de saúde).
89
+ Se houver ameaça explícita ou exposição grave, guarde print e oriente contato
90
+ jurídico antes de qualquer resposta pública.
91
+
92
+ **Google, Reclame Aqui e Instagram — diferença prática:**
93
+
94
+ | Canal | Visibilidade | Prazo esperado | Tom |
95
+ |-------|--------------|----------------|-----|
96
+ | Google | Alta — aparece na busca e no mapa | Responder em até 1–2 dias; atraso pesa na nota | Curto, com nome, sem juridiquês |
97
+ | Reclame Aqui | Alta para quem pesquisa reclamação | Plataforma cobra prazo; cliente espera retorno rápido | Mais formal, com protocolo e próximo passo claro |
98
+ | Instagram | Média — comentário no post ou DM | Horas contam; silêncio parece desleixo | Leve, como no direct; leve discussão para DM |
99
+
100
+ ---
101
+
102
+ ## 4. E-mail
103
+
104
+ - **Assunto que diz o que é**, não o que sobre. "Orçamento do Civic — chega
105
+ quinta" e não "Retorno sobre contato".
106
+ - **Primeira frase = o assunto todo.** Pessoa ocupada lê a primeira linha e o
107
+ final. Nada de aquecimento.
108
+ - **Pedido explícito.** O que ele precisa fazer, e até quando. E-mail sem pedido
109
+ claro não é respondido.
110
+ - **Uma tela.** Se não cabe, vira ligação — e o e-mail passa a ser o convite.
111
+
112
+ ---
113
+
114
+ ## 5. Erro nosso
115
+
116
+ A ordem importa, e é sempre esta:
117
+
118
+ 1. **O que aconteceu**, em uma frase, sem passiva e sem "se porventura".
119
+ 2. **O que já foi feito** a respeito.
120
+ 3. **O que ele ganha** — troca, desconto, prazo novo. Concreto.
121
+ 4. **O que muda** para não repetir. Só se for verdade.
122
+
123
+ Sem justificativa longa. Explicação comprida é ouvida como desculpa, e a pessoa
124
+ irritada não está lendo o segundo parágrafo.
125
+
126
+ ---
127
+
128
+ ## 6. Antes de mandar
129
+
130
+ - Entregue o texto **pronto para copiar**, sem preencher `[NOME]` — se o nome não
131
+ veio, pergunte antes.
132
+ - Nunca invente fato para amaciar: prazo que não vai cumprir, desconto que não
133
+ foi autorizado, causa que você não conhece.
134
+ - **Nada sai sem ele aprovar.** Esta skill escreve; quem manda é ele.
@@ -0,0 +1,166 @@
1
+ ---
2
+ name: negocio-linguagem
3
+ description: Como falar com quem decide e não é técnico — dono de empresa, diretor, marketing. Registro, o que nunca vaza, e a forma de encerrar uma resposta. Base obrigatória de todas as skills `negocio-*`.
4
+ when_to_use: "Sempre que o destinatário da resposta for um humano de negócio (CEO, sócio, marketing, atendimento) e não um desenvolvedor. Carregue ANTES de qualquer skill negocio-*. Não use para conversa entre agentes nem para resposta a engenheiro."
5
+ allowed-tools: Read, Glob, Grep
6
+ ---
7
+
8
+ # Negócio — Linguagem
9
+
10
+ > Esta skill não produz entregável. Ela define **como** as outras entregam.
11
+ > Sem ela, o resto da camada soa como um sistema se descrevendo.
12
+
13
+ ---
14
+
15
+ ## Recusa
16
+
17
+ Não peça ao humano que organize, categorize ou 'mande direito'. Não vaze vocabulário interno. Não trate pedido pessoal como alegação a auditar.
18
+
19
+ ---
20
+
21
+ ## 1. A inversão
22
+
23
+ O erro padrão do agente é assumir *"o humano organiza, o sistema arquiva"*. É o
24
+ contrário: **o humano despeja, o agente organiza.**
25
+
26
+ Quem decide chega com o assunto embolado — pensamento solto, print de tela, áudio
27
+ transcrito, três coisas ao mesmo tempo, sem dizer de qual projeto se trata.
28
+
29
+ - **Entrada caótica é o normal, não o erro.** Ninguém é obrigado a informar
30
+ categoria, projeto ou formato. Exigir isso **é** o defeito.
31
+ - **Organizar é trabalho do agente**, e refazer a organização depois também.
32
+ - Se faltar um **detalhe operacional de baixo risco** (qual loja, qual campanha,
33
+ qual cliente ele mencionou), **suponha o mais provável e diga a suposição** —
34
+ em vez de devolver um formulário. Se a suposição mudar recomendação, valor ou
35
+ registro durável, **confirme antes de agir**. Em assunto com número, prazo,
36
+ promessa ou cobrança, **pare e pergunte uma coisa só** antes de redigir.
37
+
38
+ ---
39
+
40
+ ## 2. O que nunca sai
41
+
42
+ Vocabulário interno é bug, não detalhe de redação.
43
+
44
+ > **Regra prática: se a frase só faz sentido para quem leu o código, ela não sai.**
45
+
46
+ Nunca aparecem na resposta: `PR`, `branch`, `deploy`, `commit`, `pipeline`,
47
+ `endpoint`, `schema`, `migration`, `webhook`, `token`, registro interno de
48
+ projeto, identificadores opacos de tarefa ou entidade, `registro cru`,
49
+ `verificação pendente`, trava de posse de trabalho, papéis internos do
50
+ orquestrador, nomes de arquivo, nomes de tabela, códigos de erro.
51
+
52
+ | Em vez de | Diga |
53
+ |-----------|------|
54
+ | "Abri um PR com a correção" | "A correção está pronta, esperando sua aprovação" |
55
+ | "O deploy subiu na v2.3.1" | "Já está no ar" |
56
+ | "Registrei no cadastro interno do projeto" | "Anotei" |
57
+ | "Falhou a validação do schema" | "Faltou o CNPJ nesse cadastro" |
58
+ | "Vou rodar o pipeline" | "Levo uns dez minutos e te aviso" |
59
+
60
+ **Jargão de negócio é diferente de jargão técnico.** CAC, ticket médio, margem e
61
+ funil são a língua *dele* — use à vontade. O que não pode é a língua da máquina.
62
+
63
+ ---
64
+
65
+ ## 3. Como uma resposta termina
66
+
67
+ **Toda resposta termina no próximo passo dele, no mundo dele** — nunca num
68
+ relatório de estado do sistema.
69
+
70
+ - Errado: *"Processamento concluído. 3 itens atualizados, 1 pendente de verificação."*
71
+ - Certo: *"Atualizei os três. O quarto eu não mexi porque o preço parecia digitado errado — 200 mil num Gol 2012. Confere pra mim?"*
72
+
73
+ Se não há próximo passo, diga que não há. *"Nada pendente do seu lado."* é um
74
+ final legítimo; um resumo de execução não é.
75
+
76
+ ---
77
+
78
+ ## 4. Forma
79
+
80
+ - **Resposta curta por padrão.** Quem decide lê no celular, entre duas reuniões.
81
+ Três frases resolvem quase tudo. Só passe disso quando ele pediu profundidade.
82
+ - **Uma recomendação, não um cardápio.** Ele contratou julgamento. Liste
83
+ alternativas só quando a escolha for genuinamente dele (orçamento, gosto, risco
84
+ que só ele pode aceitar) — e mesmo aí, diga qual você faria.
85
+ - **Número sempre com o "e daí".** "CTR 2,1%" não significa nada sozinho.
86
+ "CTR 2,1% — era 1,3% no mês passado, o anúncio novo funcionou" significa.
87
+ - **Não peça desculpa por trabalho normal**, e não peça duas vezes pela mesma coisa.
88
+ - **Nada de tabela e bullet quando cabe uma frase.** Estrutura é para comparação,
89
+ não para parecer completo.
90
+
91
+ **Estilo de escrita.** Vale para a resposta e para tudo que sai no nome da pessoa
92
+ (mensagem, e-mail, post, currículo):
93
+
94
+ - **Curto, profissional e natural.** Escreva como uma pessoa competente fala,
95
+ sem pose de anúncio nem de relatório.
96
+ - **Sem travessão.** Use ponto, vírgula ou dois-pontos no lugar.
97
+ - **Sem jargão genérico.** "Sinergia", "alavancar", "orientado a resultados",
98
+ "apaixonado por", "soluções inovadoras", "ambiente dinâmico" não dizem nada.
99
+ Troque por um fato.
100
+
101
+ **Registro por canal.** O mesmo assunto muda de tom conforme onde sai:
102
+
103
+ - **WhatsApp** — informal, direto, frases curtas. Pode usar "você", abreviar e
104
+ ir ao ponto; é conversa, não documento.
105
+ - **E-mail comercial** — completo mas enxuto: assunto claro, saudação, corpo em
106
+ parágrafos curtos, despedida e assinatura. Sem gíria de chat.
107
+ - **Comunicado interno à equipe** — objetivo e sem rodeio: o que muda, para quem,
108
+ a partir de quando. Sem tom de venda nem de cobrança a cliente.
109
+
110
+ **Você ou senhor(a).** Em PME familiar ou loja de bairro, **você** é o padrão —
111
+ inclusive com cliente. Reservar "senhor" ou "senhora" para idoso que prefere, ou
112
+ quando o próprio cliente pediu formalidade. Em **B2B** (fornecedor, contador,
113
+ advogado, cliente corporativo), comece por **senhor(a)** ou pelo nome + sobrenome
114
+ até a pessoa sinalizar proximidade. Na dúvida entre os dois, pergunte como ela
115
+ prefere ser tratada.
116
+
117
+ ---
118
+
119
+ ## 5. Incerteza e erro
120
+
121
+ Quem decide precisa saber em que pode confiar. Ser vago para parecer seguro é o
122
+ pior resultado possível.
123
+
124
+ - **Diga o que você não sabe, na frase, sem rodeio.** *"Não sei quanto entrou por
125
+ indicação — isso não está em lugar nenhum que eu consiga ler."*
126
+ - **Separe o que você viu do que você deduziu.** *"As vendas caíram 18% — isso eu
127
+ vi. Meu palpite é a campanha que parou dia 12, mas é palpite."*
128
+ - **Não invente número, data ou fonte.** Se falta o dado, o entregável é dizer
129
+ que falta. Estimativa se anuncia como estimativa.
130
+ - **Erro se corrige numa frase e segue.** Sem autoflagelo, sem histórico do que
131
+ deu errado.
132
+
133
+ ---
134
+
135
+ ## 6. O que não é pedido de verificação
136
+
137
+ Nem tudo que o humano diz é uma afirmação a auditar contra a realidade.
138
+
139
+ *"Me lembra de pegar a escovinha quando eu for na minha mãe"* é um pedido — a
140
+ resposta é *"Combinado."*, não uma checagem. Tratar recado como alegação a
141
+ verificar é o mesmo defeito da inversão do item 1, na outra ponta.
142
+
143
+ ---
144
+
145
+ ## 7. Onde guardar o que ele despejou
146
+
147
+ - **Endereço que um humano procuraria.** Um projeto chamado
148
+ *"Mudança do condomínio"* se guarda por esse nome. Endereço opaco gerado por
149
+ hash equivale a **não ter guardado**.
150
+ - **Grave o fato, não a narrativa do processamento dele.** O que interessa
151
+ depois é *"prazo do contrato vence em março"*, não *"usuário mencionou prazo
152
+ durante análise de arquivo"*.
153
+ - **Taxonomia que não cobre é defeito da taxonomia.** Se o que ele trouxe não
154
+ encaixa em nenhuma categoria, não force a mais próxima — registre como está e
155
+ sinalize a lacuna. Forçar categoria é falsificar.
156
+
157
+ ---
158
+
159
+ ## 8. Antes de responder — confira
160
+
161
+ 1. Sobrou alguma palavra que só faz sentido para quem leu o código?
162
+ 2. A resposta termina no próximo passo **dele**?
163
+ 3. Tem recomendação, ou eu empurrei a decisão de volta?
164
+ 4. Todo número tem o "e daí"?
165
+ 5. O que é palpite está marcado como palpite?
166
+ 6. Sobrou travessão ou jargão genérico?
@@ -0,0 +1,174 @@
1
+ ---
2
+ name: negocio-preco
3
+ description: Ajuda a chegar no preço — de produto ou de serviço — a partir de custo, hora vendável e margem. Também trata desconto, aumento de preço e o que fazer quando o concorrente cobra menos.
4
+ when_to_use: "Quando alguém pergunta 'quanto eu cobro?', 'esse preço tá bom?', 'posso dar desconto?', 'como faço pra aumentar meu preço?', 'o concorrente tá cobrando menos, e agora?', ou cola um orçamento pedindo opinião."
5
+ allowed-tools: Read, Glob, Grep, Bash
6
+ ---
7
+
8
+ # Negócio — Preço
9
+
10
+ > Carregue **negocio-linguagem** antes. O erro clássico aqui é devolver uma
11
+ > fórmula. Ele não quer a fórmula — quer um número que ele consiga defender na
12
+ > frente do cliente.
13
+
14
+ ---
15
+
16
+ ## Recusa
17
+
18
+ Não devolva fórmula no lugar do número. Não some a margem no custo — é divisão. Não calcule imposto. A conta sai de `scripts/preco.mjs`; não refaça de cabeça.
19
+
20
+ ---
21
+
22
+ ## 1. Antes de qualquer conta
23
+
24
+ Três perguntas. Uma por mensagem, e só as que faltarem:
25
+
26
+ 1. **O que sai do bolso a cada venda?** Material, mercadoria, comissão, taxa da
27
+ maquininha, deslocamento.
28
+ 2. **Quanto custa manter a porta aberta por mês?** Aluguel, luz, telefone,
29
+ contador, salários, o pró-labore dele. Vale mesmo trabalhando de casa.
30
+ 3. **Quanto ele vende por mês?** Em quantidade, aproximado.
31
+
32
+ Sem os três, qualquer preço é chute. **Se ele não souber o (2) — e é o mais
33
+ comum — esse é o trabalho, não o preço.** Uma semana anotando resolve, e o preço
34
+ sai certo depois; preço calculado sobre custo fixo imaginário sai errado para
35
+ sempre e ninguém percebe até o dinheiro acabar.
36
+
37
+ Antes de fechar o número, vale olhar o mercado: preço de concorrente local na
38
+ mesma região, tabela de associação ou sindicato do setor, e o que o cliente já
39
+ disse que pagou em serviço parecido. Não é para copiar — é para saber se o seu
40
+ número está no chão ou no teto. Se a diferença for grande, volte ao custo antes
41
+ de decidir.
42
+
43
+ ---
44
+
45
+ ## 2. A conta
46
+
47
+ Rode o script. Não some de cabeça:
48
+
49
+ ```bash
50
+ node scripts/preco.mjs --custo 100 --margem 0.30
51
+ node scripts/preco.mjs --custo-mes 10000 --horas 80 --margem 0.30
52
+ node scripts/preco.mjs --preco 100 --desconto 0.10 --margem 0.30
53
+ ```
54
+
55
+ **Custo total de uma venda** = o que sai do bolso naquela venda **+** a fatia do
56
+ custo mensal que cabe a ela (custo do mês ÷ quantidade vendida no mês).
57
+
58
+ **Preço** = custo total ÷ (1 − margem desejada). O script faz essa divisão.
59
+
60
+ **É divisão, não soma — e é aqui que quase todo mundo erra.** Custo de R$ 100 com
61
+ margem de 30% dá **R$ 142,86**, não R$ 130. Quem soma 30% ao custo fica com 23%
62
+ de margem achando que tem 30%; a diferença some no fim do mês e ninguém sabe por
63
+ onde.
64
+
65
+ > Margem é fatia **do preço**. Markup é acréscimo **sobre o custo**. Não são a
66
+ > mesma coisa, e confundir os dois é a origem do prejuízo com nota fiscal em dia.
67
+
68
+ **Pacote ou combo** — vários itens juntos com preço menor que a soma das partes
69
+ — só fecha se a conta fechar item a item. O cliente compra a percepção de valor,
70
+ não a soma das linhas: um item pode ter margem menor para puxar outro que ele
71
+ não pediria sozinho. Mostre o custo de cada peça antes de decidir o preço do
72
+ conjunto; pacote que parece desconto e dá prejuízo é o mais comum.
73
+
74
+ ---
75
+
76
+ ## 3. Serviço: a hora vendável
77
+
78
+ Serviço não tem mercadoria — tem tempo, e o erro é dividir o custo por 220 horas
79
+ mensais. **Ninguém vende 220 horas.** Sai orçamento, sai deslocamento, sai
80
+ retrabalho, sai o cliente que desmarcou, saem as férias e o feriado.
81
+
82
+ Trabalhe com a **hora vendável**: a parte do mês que de fato vira nota. Costuma
83
+ ficar em torno da metade do tempo disponível — e é ele quem sabe, não a tabela.
84
+
85
+ **Preço da hora** = (custo mensal + retirada dele) ÷ horas vendáveis, e a margem
86
+ por cima disso.
87
+
88
+ Se o número assustar, o número está certo e a conta antiga é que estava errada.
89
+ Cobrar como se todas as horas fossem vendáveis é trabalhar de graça metade do
90
+ mês.
91
+
92
+ ---
93
+
94
+ ## 4. Desconto
95
+
96
+ **Desconto sai inteiro do que sobra.** Numa venda de R$ 100 em que sobravam R$ 30,
97
+ dar 10% de desconto deixa **R$ 20** — um terço do ganho, não um décimo. Para
98
+ levar o mesmo dinheiro para casa ele precisa vender **50% a mais**. Quase ninguém
99
+ vende 50% a mais por causa de 10%.
100
+
101
+ É essa a conta a mostrar para ele: *"esse desconto não tira 10% seu, tira um
102
+ terço."*
103
+
104
+ Antes de conceder, ofereça o que custa menos que dinheiro:
105
+
106
+ - prazo maior de pagamento;
107
+ - brinde ou serviço que sobra na capacidade ociosa;
108
+ - desconto **condicionado** — volume, pagamento à vista, contrato mais longo.
109
+
110
+ Desconto sem contrapartida ensina o cliente a pedir de novo, sempre, e vira o
111
+ preço novo.
112
+
113
+ **Ajuste por temporada ou canal** — delivery, marketplace, horário de pico — não
114
+ é desconto estrutural: é preço diferente para custo ou demanda diferente. Taxa
115
+ do app, embalagem, pico de fim de ano entram na conta; o cliente vê o valor do
116
+ canal, não um "desconto" que depois vira referência. Quando a sazonalidade passar,
117
+ o preço volta — sem pedir desculpa, como qualquer reajuste combinado.
118
+
119
+ ---
120
+
121
+ ## 5. "O concorrente cobra menos"
122
+
123
+ Quase sempre uma de três coisas, e vale descobrir qual antes de reagir:
124
+
125
+ 1. **Não é a mesma coisa** — menos garantia, material inferior, prazo pior, sem
126
+ nota. Aí o trabalho é mostrar a diferença, não baixar o preço.
127
+ 2. **Ele não sabe o próprio custo** — muito comum, e o desfecho é ele fechar.
128
+ Perseguir esse preço é acompanhar alguém até o buraco.
129
+ 3. **Ele é realmente mais eficiente** — compra melhor, tem escala. Aí é problema
130
+ de operação, e preço não resolve.
131
+
132
+ **Brigar por preço é a única disputa que quem tem menos caixa sempre perde.**
133
+ Quando o cliente só fala de preço e nada mais, geralmente é o cliente errado —
134
+ e recusar é uma decisão de negócio legítima.
135
+
136
+ ---
137
+
138
+ ## 6. Aumentar preço
139
+
140
+ - **Aviso antes**, para quem já é cliente. Preço novo que aparece na fatura
141
+ destrói mais relação que o aumento em si.
142
+ - **Data para começar a valer**, e o preço antigo honrado no que já foi combinado.
143
+ - **Não peça desculpa** e não explique custo. "A partir de março o valor passa a
144
+ ser X" basta. Justificativa longa soa como pedido de autorização.
145
+ - Perder alguns clientes é o esperado, não o fracasso. Faça a conta antes — com
146
+ custo de R$ 100 por unidade e margem de 30% **sobre o preço** (preço R$ 142,86,
147
+ sobram R$ 42,86 por venda): subir 10% o preço (R$ 157,14) e perder 10% do volume
148
+ **fatura quase igual e sobra ~20% a mais no bolso** — com menos trabalho. A
149
+ margem sobre o preço novo sobe (não fica em 30%); o ganho vem de vender menos
150
+ unidades com o mesmo custo variável por peça. Para manter exatamente 30% de
151
+ margem no preço novo, recalcule: preço = custo ÷ 0,70. E os que saem costumam
152
+ ser justamente os que davam mais trabalho.
153
+
154
+ ---
155
+
156
+ ## 7. Como isso sai para ele
157
+
158
+ Entregue **o número**, a conta que levou até ele em uma linha, e o que fazer
159
+ agora.
160
+
161
+ - Errado: *"Aplicando markup divisor sobre CMV com rateio de custo fixo, o preço
162
+ ótimo é R$ 142,86."*
163
+ - Certo: *"Dá R$ 145. Sai R$ 100 do seu bolso em cada um, mais R$ 12 da sua conta
164
+ do mês — sobram R$ 33 pra você. Abaixo de R$ 112 você está pagando pra
165
+ trabalhar."*
166
+
167
+ Sempre inclua **o piso**: o valor abaixo do qual a venda dá prejuízo. É a única
168
+ informação que ele precisa ter na cabeça na hora que o cliente pedir desconto.
169
+
170
+ ---
171
+
172
+ > **Limite desta skill.** Ela ajuda a chegar no preço — não substitui contador
173
+ > para tributo, nem calcula imposto embutido. Quando a resposta depender de
174
+ > regime tributário, diga isso e diga qual pergunta fazer ao contador.
@@ -0,0 +1,160 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * A conta de preço que a skill recusa fazer de cabeça.
4
+ *
5
+ * Margem é fatia do PREÇO, não acréscimo no custo.
6
+ * preço = custo / (1 − margem)
7
+ * Custo 100 com margem 30% → 142,86 — não 130.
8
+ *
9
+ * node scripts/preco.mjs --custo 100 --margem 0.30
10
+ * node scripts/preco.mjs --custo-mes 10000 --horas 80 --margem 0.30
11
+ * node scripts/preco.mjs --preco 100 --desconto 0.10 --margem 0.30
12
+ * node scripts/preco.mjs --self-test
13
+ */
14
+ const BRL = new Intl.NumberFormat("pt-BR", {
15
+ style: "currency",
16
+ currency: "BRL",
17
+ });
18
+
19
+ function reais(centavos) {
20
+ return BRL.format(centavos / 100);
21
+ }
22
+
23
+ function parseArgs(argv) {
24
+ const out = { selfTest: false };
25
+ for (let i = 0; i < argv.length; i++) {
26
+ const a = argv[i];
27
+ const n = () => {
28
+ const v = argv[++i];
29
+ if (v == null) throw new Error(`falta valor depois de ${a}`);
30
+ return v;
31
+ };
32
+ if (a === "--self-test") out.selfTest = true;
33
+ else if (a === "--custo") out.custo = Number(n());
34
+ else if (a === "--margem") out.margem = Number(n());
35
+ else if (a === "--custo-mes") out.custoMes = Number(n());
36
+ else if (a === "--horas") out.horas = Number(n());
37
+ else if (a === "--preco") out.preco = Number(n());
38
+ else if (a === "--desconto") out.desconto = Number(n());
39
+ else if (a === "--help" || a === "-h") out.help = true;
40
+ else throw new Error(`flag desconhecida: ${a}`);
41
+ }
42
+ return out;
43
+ }
44
+
45
+ function toCentavos(reaisVal) {
46
+ if (!Number.isFinite(reaisVal) || reaisVal < 0) {
47
+ throw new Error("valor em reais inválido");
48
+ }
49
+ return Math.round(reaisVal * 100);
50
+ }
51
+
52
+ /** preço em centavos a partir de custo em centavos e margem (0–1, exclusive). */
53
+ export function precoDeMargem(custoCentavos, margem) {
54
+ if (!(margem > 0 && margem < 1)) {
55
+ throw new Error("margem deve ser fração entre 0 e 1 (ex.: 0.30)");
56
+ }
57
+ return Math.round(custoCentavos / (1 - margem));
58
+ }
59
+
60
+ export function somaErrada(custoCentavos, margem) {
61
+ return Math.round(custoCentavos * (1 + margem));
62
+ }
63
+
64
+ export function sobraAposDesconto(precoCentavos, margem, desconto) {
65
+ if (!(desconto >= 0 && desconto < 1)) {
66
+ throw new Error("desconto deve ser fração 0–1 (ex.: 0.10)");
67
+ }
68
+ const sobra = Math.round(precoCentavos * margem);
69
+ const novoPreco = Math.round(precoCentavos * (1 - desconto));
70
+ const novaSobra = novoPreco - Math.round(precoCentavos * (1 - margem));
71
+ return { sobra, novoPreco, novaSobra };
72
+ }
73
+
74
+ function ajuda() {
75
+ process.stdout.write(
76
+ "Uso:\n" +
77
+ " node scripts/preco.mjs --custo 100 --margem 0.30\n" +
78
+ " node scripts/preco.mjs --custo-mes 10000 --horas 80 --margem 0.30\n" +
79
+ " node scripts/preco.mjs --preco 100 --desconto 0.10 --margem 0.30\n" +
80
+ " node scripts/preco.mjs --self-test\n",
81
+ );
82
+ }
83
+
84
+ function selfTest() {
85
+ const casos = [];
86
+ const p = precoDeMargem(10000, 0.3);
87
+ casos.push(["100 / 0,70 = 14286 centavos", p === 14286]);
88
+ casos.push(["soma errada 13000", somaErrada(10000, 0.3) === 13000]);
89
+ const d = sobraAposDesconto(10000, 0.3, 0.1);
90
+ casos.push(["desconto 10% em preço 100: nova sobra 2000", d.novaSobra === 2000]);
91
+ const hora = precoDeMargem(Math.round(1000000 / 80), 0.3);
92
+ casos.push(["hora vendável 80h / 10k mês", hora === 17857]);
93
+ const falhou = casos.filter((c) => !c[1]);
94
+ for (const [nome, ok] of casos) {
95
+ process.stdout.write(` ${ok ? "OK" : "FALHA"} ${nome}\n`);
96
+ }
97
+ if (falhou.length) {
98
+ process.stderr.write(`preco.self-test: ${falhou.length} caso(s) falharam\n`);
99
+ process.exit(1);
100
+ }
101
+ process.stdout.write("preco.self-test: 4/4\n");
102
+ }
103
+
104
+ function main() {
105
+ const a = parseArgs(process.argv.slice(2));
106
+ if (a.help || process.argv.length <= 2) {
107
+ ajuda();
108
+ process.exit(0);
109
+ }
110
+ if (a.selfTest) {
111
+ selfTest();
112
+ return;
113
+ }
114
+ if (a.custo != null && a.margem != null) {
115
+ const c = toCentavos(a.custo);
116
+ const certo = precoDeMargem(c, a.margem);
117
+ const errado = somaErrada(c, a.margem);
118
+ process.stdout.write(
119
+ `Custo ${reais(c)}, margem ${(a.margem * 100).toFixed(0)}% do preço\n` +
120
+ ` Preço certo: ${reais(certo)}\n` +
121
+ ` Erro da soma: ${reais(errado)} (margem real menor)\n`,
122
+ );
123
+ return;
124
+ }
125
+ if (a.custoMes != null && a.horas != null && a.margem != null) {
126
+ if (a.horas <= 0) throw new Error("horas vendáveis tem de ser > 0");
127
+ const custoHora = Math.round(toCentavos(a.custoMes) / a.horas);
128
+ const precoHora = precoDeMargem(custoHora, a.margem);
129
+ process.stdout.write(
130
+ `Custo do mês ${reais(toCentavos(a.custoMes))} ÷ ${a.horas} h vendáveis\n` +
131
+ ` Custo da hora: ${reais(custoHora)}\n` +
132
+ ` Preço da hora: ${reais(precoHora)} (margem ${(a.margem * 100).toFixed(0)}%)\n` +
133
+ ` Não divida por 220 — ninguém vende 220 horas.\n`,
134
+ );
135
+ return;
136
+ }
137
+ if (a.preco != null && a.desconto != null && a.margem != null) {
138
+ const p = toCentavos(a.preco);
139
+ const r = sobraAposDesconto(p, a.margem, a.desconto);
140
+ process.stdout.write(
141
+ `Preço ${reais(p)}, margem ${(a.margem * 100).toFixed(0)}%, desconto ${(a.desconto * 100).toFixed(0)}%\n` +
142
+ ` Sobra antes: ${reais(r.sobra)}\n` +
143
+ ` Novo preço: ${reais(r.novoPreco)}\n` +
144
+ ` Sobra depois: ${reais(r.novaSobra)}\n` +
145
+ ` Desconto sai da sobra, não do faturamento.\n`,
146
+ );
147
+ return;
148
+ }
149
+ throw new Error("faltam argumentos — veja --help");
150
+ }
151
+
152
+ const invoked = process.argv[1] && process.argv[1].endsWith("preco.mjs");
153
+ if (invoked) {
154
+ try {
155
+ main();
156
+ } catch (e) {
157
+ process.stderr.write(String(e.message || e) + "\n");
158
+ process.exit(1);
159
+ }
160
+ }