@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.
- package/.claude-plugin/marketplace.json +19 -0
- package/.cursor-plugin/marketplace.json +22 -0
- package/INSTALL.md +73 -0
- package/LICENSE +202 -0
- package/NOTICE +5 -0
- package/README.md +69 -3
- package/TERMS.md +48 -0
- package/THIRD-PARTY-NOTICES.md +109 -0
- package/kit/agents/backend-specialist.md +263 -0
- package/kit/agents/code-archaeologist.md +106 -0
- package/kit/agents/database-architect.md +226 -0
- package/kit/agents/debugger.md +226 -0
- package/kit/agents/devops-engineer.md +242 -0
- package/kit/agents/documentation-writer.md +104 -0
- package/kit/agents/explorer-agent.md +73 -0
- package/kit/agents/frontend-specialist.md +593 -0
- package/kit/agents/game-developer.md +162 -0
- package/kit/agents/mobile-developer.md +377 -0
- package/kit/agents/orchestrator.md +489 -0
- package/kit/agents/penetration-tester.md +188 -0
- package/kit/agents/performance-optimizer.md +187 -0
- package/kit/agents/product-manager.md +112 -0
- package/kit/agents/product-owner.md +95 -0
- package/kit/agents/project-planner.md +409 -0
- package/kit/agents/qa-automation-engineer.md +103 -0
- package/kit/agents/security-auditor.md +170 -0
- package/kit/agents/seo-specialist.md +111 -0
- package/kit/agents/test-engineer.md +158 -0
- package/kit/bundles/agent-building.yaml +26 -0
- package/kit/bundles/backend-data.yaml +14 -0
- package/kit/bundles/base.yaml +10 -0
- package/kit/bundles/core.yaml +21 -0
- package/kit/bundles/kit-engenharia.yaml +8 -0
- package/kit/bundles/kit-lite.yaml +9 -0
- package/kit/bundles/security.yaml +11 -0
- package/kit/bundles/ship-run.yaml +16 -0
- package/kit/bundles/web-ui.yaml +18 -0
- package/kit/commands/docs.md +33 -0
- package/kit/commands/explain.md +41 -0
- package/kit/commands/fix.md +65 -0
- package/kit/commands/implement.md +35 -0
- package/kit/commands/refactor.md +59 -0
- package/kit/commands/review.md +55 -0
- package/kit/commands/test.md +63 -0
- package/kit/modules/bridge/rules/cross-ide-bridge.mdc +73 -0
- package/kit/modules/bridge/zenkit-layer.yaml +1 -0
- package/kit/modules/nexuscore/sections/convivencia.md +12 -0
- package/kit/modules/nexuscore/sections/memoria.md +9 -0
- package/kit/modules/nexuscore/skills/quadro-agentes/SKILL.md +186 -0
- package/kit/modules/nexuscore/zenkit-layer.yaml +1 -0
- package/kit/rules/ZENKIT.mdc +294 -0
- package/kit/rules/git.mdc +51 -0
- package/kit/rules/karpathy-guidelines.mdc +70 -0
- package/kit/rules/model-routing.mdc +89 -0
- package/kit/rules/security-headers.mdc +41 -0
- package/kit/rules/social-automation.mdc +69 -0
- package/kit/rules/toc.mdc +40 -0
- package/kit/skills/api-patterns/SKILL.md +95 -0
- package/kit/skills/api-patterns/api-style.md +42 -0
- package/kit/skills/api-patterns/auth.md +24 -0
- package/kit/skills/api-patterns/documentation.md +26 -0
- package/kit/skills/api-patterns/graphql.md +41 -0
- package/kit/skills/api-patterns/rate-limiting.md +31 -0
- package/kit/skills/api-patterns/references/backend/backend-api-design.md +495 -0
- package/kit/skills/api-patterns/references/backend/backend-architecture.md +454 -0
- package/kit/skills/api-patterns/references/backend/backend-authentication.md +338 -0
- package/kit/skills/api-patterns/references/backend/backend-code-quality.md +659 -0
- package/kit/skills/api-patterns/references/backend/backend-debugging.md +904 -0
- package/kit/skills/api-patterns/references/backend/backend-devops.md +494 -0
- package/kit/skills/api-patterns/references/backend/backend-mindset.md +387 -0
- package/kit/skills/api-patterns/references/backend/backend-performance.md +397 -0
- package/kit/skills/api-patterns/references/backend/backend-security.md +290 -0
- package/kit/skills/api-patterns/references/backend/backend-technologies.md +256 -0
- package/kit/skills/api-patterns/references/backend/backend-testing.md +429 -0
- package/kit/skills/api-patterns/response.md +37 -0
- package/kit/skills/api-patterns/rest.md +40 -0
- package/kit/skills/api-patterns/scripts/api_validator.py +211 -0
- package/kit/skills/api-patterns/security-testing.md +122 -0
- package/kit/skills/api-patterns/trpc.md +41 -0
- package/kit/skills/api-patterns/versioning.md +22 -0
- package/kit/skills/app-builder/SKILL.md +76 -0
- package/kit/skills/app-builder/agent-coordination.md +71 -0
- package/kit/skills/app-builder/feature-building.md +53 -0
- package/kit/skills/app-builder/project-detection.md +34 -0
- package/kit/skills/app-builder/scaffolding.md +118 -0
- package/kit/skills/app-builder/tech-stack.md +41 -0
- package/kit/skills/app-builder/templates/SKILL.md +39 -0
- package/kit/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -0
- package/kit/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -0
- package/kit/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -0
- package/kit/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -0
- package/kit/skills/app-builder/templates/express-api/TEMPLATE.md +83 -0
- package/kit/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -0
- package/kit/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -0
- package/kit/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +122 -0
- package/kit/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +122 -0
- package/kit/skills/app-builder/templates/nextjs-static/TEMPLATE.md +169 -0
- package/kit/skills/app-builder/templates/nuxt-app/TEMPLATE.md +134 -0
- package/kit/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -0
- package/kit/skills/app-builder/templates/react-native-app/TEMPLATE.md +119 -0
- package/kit/skills/architecture/SKILL.md +56 -0
- package/kit/skills/architecture/context-discovery.md +43 -0
- package/kit/skills/architecture/examples.md +94 -0
- package/kit/skills/architecture/pattern-selection.md +68 -0
- package/kit/skills/architecture/patterns-reference.md +50 -0
- package/kit/skills/architecture/trade-off-analysis.md +77 -0
- package/kit/skills/bash-linux/SKILL.md +203 -0
- package/kit/skills/batch-operations/SKILL.md +112 -0
- package/kit/skills/behavioral-modes/SKILL.md +255 -0
- package/kit/skills/brainstorming/SKILL.md +189 -0
- package/kit/skills/brainstorming/dynamic-questioning.md +350 -0
- package/kit/skills/brainstorming/references/problem-solving/attribution.md +69 -0
- package/kit/skills/brainstorming/references/problem-solving/collision-zone-thinking.md +79 -0
- package/kit/skills/brainstorming/references/problem-solving/inversion-exercise.md +91 -0
- package/kit/skills/brainstorming/references/problem-solving/meta-pattern-recognition.md +87 -0
- package/kit/skills/brainstorming/references/problem-solving/scale-game.md +95 -0
- package/kit/skills/brainstorming/references/problem-solving/simplification-cascades.md +80 -0
- package/kit/skills/brainstorming/references/problem-solving/when-stuck.md +72 -0
- package/kit/skills/claude-exec/SKILL.md +185 -0
- package/kit/skills/clean-code/SKILL.md +210 -0
- package/kit/skills/code-review-checklist/SKILL.md +115 -0
- package/kit/skills/code-review-graph/SKILL.md +50 -0
- package/kit/skills/code-review-graph/references/alternatives-comparison.md +12 -0
- package/kit/skills/code-review-graph/references/best-practices.md +9 -0
- package/kit/skills/code-review-graph/references/configuration.md +43 -0
- package/kit/skills/code-review-graph/references/core-workflows.md +61 -0
- package/kit/skills/code-review-graph/references/how-it-works-4-layers.md +20 -0
- package/kit/skills/code-review-graph/references/installation.md +67 -0
- package/kit/skills/code-review-graph/references/integration-with-zenkit.md +23 -0
- package/kit/skills/code-review-graph/references/known-limitations.md +13 -0
- package/kit/skills/code-review-graph/references/when-to-use-vs-when-to-skip.md +21 -0
- package/kit/skills/codex-exec/SKILL.md +161 -0
- package/kit/skills/context-compression/SKILL.md +145 -0
- package/kit/skills/coordinator-mode/SKILL.md +215 -0
- package/kit/skills/cursor-exec/SKILL.md +152 -0
- package/kit/skills/database-design/SKILL.md +53 -0
- package/kit/skills/database-design/database-selection.md +43 -0
- package/kit/skills/database-design/indexing.md +39 -0
- package/kit/skills/database-design/migrations.md +48 -0
- package/kit/skills/database-design/optimization.md +36 -0
- package/kit/skills/database-design/orm-selection.md +30 -0
- package/kit/skills/database-design/schema-design.md +56 -0
- package/kit/skills/database-design/scripts/schema_validator.py +172 -0
- package/kit/skills/deployment-procedures/SKILL.md +242 -0
- package/kit/skills/deprecation-and-migration/SKILL.md +149 -0
- package/kit/skills/documentation-templates/SKILL.md +195 -0
- package/kit/skills/entrega-com-agentes/SKILL.md +177 -0
- package/kit/skills/frontend-design/NOTICE.md +6 -0
- package/kit/skills/frontend-design/SKILL.md +456 -0
- package/kit/skills/frontend-design/animation-guide.md +331 -0
- package/kit/skills/frontend-design/color-system.md +311 -0
- package/kit/skills/frontend-design/decision-trees.md +418 -0
- package/kit/skills/frontend-design/motion-graphics.md +306 -0
- package/kit/skills/frontend-design/references/aesthetic/design-guideline-template.md +163 -0
- package/kit/skills/frontend-design/references/aesthetic/design-principles.md +62 -0
- package/kit/skills/frontend-design/references/aesthetic/design-resources.md +75 -0
- package/kit/skills/frontend-design/references/aesthetic/design-story-template.md +135 -0
- package/kit/skills/frontend-design/references/aesthetic/micro-interactions.md +53 -0
- package/kit/skills/frontend-design/references/aesthetic/storytelling-design.md +50 -0
- package/kit/skills/frontend-design/scripts/accessibility_checker.py +183 -0
- package/kit/skills/frontend-design/scripts/ux_audit.py +722 -0
- package/kit/skills/frontend-design/typography-system.md +345 -0
- package/kit/skills/frontend-design/ux-psychology.md +1116 -0
- package/kit/skills/frontend-design/visual-effects.md +383 -0
- package/kit/skills/game-development/2d-games/SKILL.md +119 -0
- package/kit/skills/game-development/3d-games/SKILL.md +135 -0
- package/kit/skills/game-development/SKILL.md +168 -0
- package/kit/skills/game-development/game-art/SKILL.md +185 -0
- package/kit/skills/game-development/game-audio/SKILL.md +190 -0
- package/kit/skills/game-development/game-design/SKILL.md +129 -0
- package/kit/skills/game-development/mobile-games/SKILL.md +108 -0
- package/kit/skills/game-development/multiplayer/SKILL.md +132 -0
- package/kit/skills/game-development/pc-games/SKILL.md +144 -0
- package/kit/skills/game-development/vr-ar/SKILL.md +123 -0
- package/kit/skills/game-development/web-games/SKILL.md +150 -0
- package/kit/skills/gemini-exec/SKILL.md +80 -0
- package/kit/skills/geo-fundamentals/SKILL.md +157 -0
- package/kit/skills/geo-fundamentals/scripts/geo_checker.py +289 -0
- package/kit/skills/git-worktrees/SKILL.md +107 -0
- package/kit/skills/i18n-localization/SKILL.md +145 -0
- package/kit/skills/i18n-localization/scripts/i18n_checker.py +241 -0
- package/kit/skills/intelligent-routing/SKILL.md +128 -0
- package/kit/skills/intelligent-routing/references/4-response-format.md +16 -0
- package/kit/skills/intelligent-routing/references/complexity-assessment.md +29 -0
- package/kit/skills/intelligent-routing/references/debug-intelligent-routing.md +9 -0
- package/kit/skills/intelligent-routing/references/debugging-agent-selection.md +7 -0
- package/kit/skills/intelligent-routing/references/domain-detection-rules.md +29 -0
- package/kit/skills/intelligent-routing/references/edge-cases.md +29 -0
- package/kit/skills/intelligent-routing/references/implementation-rules.md +35 -0
- package/kit/skills/intelligent-routing/references/integration-with-existing-workflows.md +21 -0
- package/kit/skills/intelligent-routing/references/performance-considerations.md +14 -0
- package/kit/skills/intelligent-routing/references/summary.md +16 -0
- package/kit/skills/intelligent-routing/references/testing-the-system.md +36 -0
- package/kit/skills/intelligent-routing/references/tier-0-automatic-analysis-always-active.md +27 -0
- package/kit/skills/intelligent-routing/references/user-education.md +12 -0
- package/kit/skills/karpathy-guidelines/SKILL.md +67 -0
- package/kit/skills/karpathy-guidelines/references/EXAMPLES.md +522 -0
- package/kit/skills/lint-and-validate/SKILL.md +46 -0
- package/kit/skills/lint-and-validate/scripts/lint_runner.py +184 -0
- package/kit/skills/lint-and-validate/scripts/type_coverage.py +173 -0
- package/kit/skills/mcp-atuacao/SKILL.md +238 -0
- package/kit/skills/mcp-builder/NOTICE.md +6 -0
- package/kit/skills/mcp-builder/SKILL.md +259 -0
- package/kit/skills/memory-system/SKILL.md +181 -0
- package/kit/skills/mobile-design/SKILL.md +395 -0
- package/kit/skills/mobile-design/decision-trees.md +516 -0
- package/kit/skills/mobile-design/mobile-backend.md +491 -0
- package/kit/skills/mobile-design/mobile-color-system.md +420 -0
- package/kit/skills/mobile-design/mobile-debugging.md +122 -0
- package/kit/skills/mobile-design/mobile-design-thinking.md +357 -0
- package/kit/skills/mobile-design/mobile-navigation.md +458 -0
- package/kit/skills/mobile-design/mobile-performance.md +767 -0
- package/kit/skills/mobile-design/mobile-testing.md +356 -0
- package/kit/skills/mobile-design/mobile-typography.md +433 -0
- package/kit/skills/mobile-design/platform-android.md +666 -0
- package/kit/skills/mobile-design/platform-ios.md +561 -0
- package/kit/skills/mobile-design/scripts/mobile_audit.py +670 -0
- package/kit/skills/mobile-design/touch-psychology.md +537 -0
- package/kit/skills/negocio-agente-conversa/SKILL.md +168 -0
- package/kit/skills/negocio-atendimento/SKILL.md +134 -0
- package/kit/skills/negocio-linguagem/SKILL.md +166 -0
- package/kit/skills/negocio-preco/SKILL.md +174 -0
- package/kit/skills/negocio-preco/scripts/preco.mjs +160 -0
- package/kit/skills/negocio-qualificacao/SKILL.md +140 -0
- package/kit/skills/nextjs-react-expert/1-async-eliminating-waterfalls.md +351 -0
- package/kit/skills/nextjs-react-expert/2-bundle-bundle-size-optimization.md +240 -0
- package/kit/skills/nextjs-react-expert/3-server-server-side-performance.md +490 -0
- package/kit/skills/nextjs-react-expert/4-client-client-side-data-fetching.md +264 -0
- package/kit/skills/nextjs-react-expert/5-rerender-re-render-optimization.md +581 -0
- package/kit/skills/nextjs-react-expert/6-rendering-rendering-performance.md +432 -0
- package/kit/skills/nextjs-react-expert/7-js-javascript-performance.md +684 -0
- package/kit/skills/nextjs-react-expert/8-advanced-advanced-patterns.md +150 -0
- package/kit/skills/nextjs-react-expert/9-cache-components.md +103 -0
- package/kit/skills/nextjs-react-expert/SKILL.md +308 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/common-patterns.md +331 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/complete-examples.md +872 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/component-patterns.md +502 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/data-fetching.md +767 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/file-organization.md +502 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/loading-and-error-states.md +501 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/performance.md +406 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/routing-guide.md +364 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/styling-guide.md +428 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/typescript-standards.md +418 -0
- package/kit/skills/nextjs-react-expert/scripts/convert_rules.py +222 -0
- package/kit/skills/nextjs-react-expert/scripts/react_performance_checker.py +252 -0
- package/kit/skills/nodejs-best-practices/SKILL.md +78 -0
- package/kit/skills/nodejs-best-practices/references/10-anti-patterns-to-avoid.md +21 -0
- package/kit/skills/nodejs-best-practices/references/11-decision-checklist.md +14 -0
- package/kit/skills/nodejs-best-practices/references/2-runtime-considerations-2025.md +36 -0
- package/kit/skills/nodejs-best-practices/references/3-architecture-principles.md +35 -0
- package/kit/skills/nodejs-best-practices/references/4-error-handling-principles.md +42 -0
- package/kit/skills/nodejs-best-practices/references/5-async-patterns-principles.md +35 -0
- package/kit/skills/nodejs-best-practices/references/6-validation-principles.md +29 -0
- package/kit/skills/nodejs-best-practices/references/7-security-principles.md +29 -0
- package/kit/skills/nodejs-best-practices/references/8-testing-principles.md +28 -0
- package/kit/skills/observability-and-instrumentation/SKILL.md +150 -0
- package/kit/skills/opencode-go-exec/SKILL.md +101 -0
- package/kit/skills/parallel-agents/SKILL.md +184 -0
- package/kit/skills/performance-profiling/SKILL.md +145 -0
- package/kit/skills/performance-profiling/scripts/lighthouse_audit.py +76 -0
- package/kit/skills/plan-writing/SKILL.md +213 -0
- package/kit/skills/powershell-windows/SKILL.md +196 -0
- package/kit/skills/provider-orchestration/SKILL.md +269 -0
- package/kit/skills/python-patterns/SKILL.md +80 -0
- package/kit/skills/python-patterns/references/10-decision-checklist.md +14 -0
- package/kit/skills/python-patterns/references/11-anti-patterns-to-avoid.md +20 -0
- package/kit/skills/python-patterns/references/2-async-vs-sync-decision.md +44 -0
- package/kit/skills/python-patterns/references/3-type-hints-strategy.md +56 -0
- package/kit/skills/python-patterns/references/4-project-structure-principles.md +56 -0
- package/kit/skills/python-patterns/references/5-django-principles-2025.md +40 -0
- package/kit/skills/python-patterns/references/6-fastapi-principles.md +50 -0
- package/kit/skills/python-patterns/references/7-background-tasks.md +31 -0
- package/kit/skills/python-patterns/references/8-error-handling-principles.md +29 -0
- package/kit/skills/python-patterns/references/9-testing-principles.md +37 -0
- package/kit/skills/red-team-tactics/SKILL.md +201 -0
- package/kit/skills/research/SKILL.md +166 -0
- package/kit/skills/rust-pro/SKILL.md +177 -0
- package/kit/skills/seo-fundamentals/SKILL.md +130 -0
- package/kit/skills/seo-fundamentals/scripts/seo_checker.py +219 -0
- package/kit/skills/sequential-thinking/.env.example +8 -0
- package/kit/skills/sequential-thinking/README.md +183 -0
- package/kit/skills/sequential-thinking/SKILL.md +95 -0
- package/kit/skills/sequential-thinking/package.json +31 -0
- package/kit/skills/sequential-thinking/references/advanced-strategies.md +79 -0
- package/kit/skills/sequential-thinking/references/advanced-techniques.md +76 -0
- package/kit/skills/sequential-thinking/references/core-patterns.md +95 -0
- package/kit/skills/sequential-thinking/references/examples-api.md +88 -0
- package/kit/skills/sequential-thinking/references/examples-architecture.md +94 -0
- package/kit/skills/sequential-thinking/references/examples-debug.md +90 -0
- package/kit/skills/sequential-thinking/scripts/format-thought.js +159 -0
- package/kit/skills/sequential-thinking/scripts/process-thought.js +236 -0
- package/kit/skills/server-management/SKILL.md +162 -0
- package/kit/skills/simplify-code/SKILL.md +133 -0
- package/kit/skills/skillify/SKILL.md +116 -0
- package/kit/skills/system-design-interview/SKILL.md +268 -0
- package/kit/skills/systematic-debugging/SKILL.md +110 -0
- package/kit/skills/tailwind-patterns/SKILL.md +283 -0
- package/kit/skills/tailwind-patterns/references/shadcn-ui/canvas-design-system.md +320 -0
- package/kit/skills/tailwind-patterns/references/shadcn-ui/shadcn-accessibility.md +471 -0
- package/kit/skills/tailwind-patterns/references/shadcn-ui/shadcn-components.md +424 -0
- package/kit/skills/tailwind-patterns/references/shadcn-ui/shadcn-theming.md +373 -0
- package/kit/skills/tailwind-patterns/references/shadcn-ui/tailwind-customization.md +483 -0
- package/kit/skills/tailwind-patterns/references/shadcn-ui/tailwind-responsive.md +382 -0
- package/kit/skills/tailwind-patterns/references/shadcn-ui/tailwind-utilities.md +455 -0
- package/kit/skills/tdd-workflow/SKILL.md +150 -0
- package/kit/skills/testing-patterns/SKILL.md +196 -0
- package/kit/skills/testing-patterns/scripts/test_runner.py +219 -0
- package/kit/skills/ui-ux-pro-max/SKILL.md +135 -0
- package/kit/skills/verify-changes/SKILL.md +125 -0
- package/kit/skills/vulnerability-scanner/SKILL.md +278 -0
- package/kit/skills/vulnerability-scanner/checklists.md +121 -0
- package/kit/skills/vulnerability-scanner/scripts/security_scan.py +458 -0
- package/kit/skills/web-design-guidelines/SKILL.md +58 -0
- package/kit/skills/webapp-testing/NOTICE.md +6 -0
- package/kit/skills/webapp-testing/SKILL.md +188 -0
- package/kit/skills/webapp-testing/scripts/playwright_runner.py +173 -0
- package/kit/workflows/brainstorm.md +113 -0
- package/kit/workflows/coordinate.md +72 -0
- package/kit/workflows/create.md +59 -0
- package/kit/workflows/debug.md +103 -0
- package/kit/workflows/deploy.md +176 -0
- package/kit/workflows/enhance.md +63 -0
- package/kit/workflows/orchestrate.md +237 -0
- package/kit/workflows/plan.md +89 -0
- package/kit/workflows/preview.md +81 -0
- package/kit/workflows/remember.md +67 -0
- package/kit/workflows/status.md +86 -0
- package/kit/workflows/test.md +144 -0
- package/kit/workflows/ui-ux-pro-max.md +296 -0
- package/kit/workflows/verify.md +72 -0
- package/licenses/Apache-2.0.txt +202 -0
- package/package.json +60 -6
- package/scripts/avaliar-vigilancia-mandato.mjs +38 -0
- package/scripts/bundle.mjs +158 -0
- package/scripts/check-deps.mjs +178 -0
- package/scripts/check-models.mjs +150 -0
- package/scripts/cli.mjs +295 -0
- package/scripts/continuidade-mandato.mjs +47 -0
- package/scripts/discriminar-turno.mjs +191 -0
- package/scripts/doctor.mjs +615 -0
- package/scripts/generate.mjs +676 -0
- package/scripts/install.mjs +11 -0
- package/scripts/layer-remote.mjs +344 -0
- package/scripts/layers.mjs +208 -0
- package/scripts/marketplace.mjs +77 -0
- package/scripts/product.mjs +32 -0
- package/scripts/ruleset-core.mjs +68 -0
- package/scripts/social-hooks.mjs +293 -0
- package/scripts/social-pacer.mjs +219 -0
- package/scripts/validate-bundles.mjs +14 -0
- package/scripts/validate-skills.mjs +174 -0
- 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
|
+
}
|