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