@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,140 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: negocio-qualificacao
|
|
3
|
+
description: Lê em que ponto da decisão o cliente está pelos sinais que ele dá na conversa — curioso, avaliando ou comprando hoje — e diz o que fazer com cada um. Também mapeia onde o negócio perde cliente entre uma etapa e outra.
|
|
4
|
+
when_to_use: "Quando alguém cola uma conversa de cliente e pergunta 'o que respondo?', 'esse aqui vale a pena?', 'por que ninguém fecha?', 'estou perdendo cliente e não sei onde'. Carregue ANTES de negocio-atendimento quando a mensagem for de um cliente em potencial, e ao desenhar o roteiro de um agente de atendimento."
|
|
5
|
+
allowed-tools: Read, Glob, Grep
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Negócio — Qualificação
|
|
9
|
+
|
|
10
|
+
> Carregue **negocio-linguagem** antes. O erro clássico aqui é tratar todo mundo
|
|
11
|
+
> que chega igual — e gastar a mesma energia com quem compra hoje e com quem
|
|
12
|
+
> nunca vai comprar.
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
## Recusa
|
|
17
|
+
|
|
18
|
+
Não trate todo mundo que chega como comprador de hoje. Não gaste a mesma energia com curioso e com quem fecha. Se não souber o estágio, pergunte uma vez.
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
## 1. A pergunta que vem antes da resposta
|
|
23
|
+
|
|
24
|
+
`negocio-atendimento` ensina a **escrever** a mensagem. Esta ensina a **ler quem
|
|
25
|
+
está do outro lado** antes de escrever. Na ordem inversa, sai uma mensagem boa
|
|
26
|
+
para a pessoa errada.
|
|
27
|
+
|
|
28
|
+
Quem manda mensagem para uma empresa está num de três pontos da própria decisão.
|
|
29
|
+
O ponto muda tudo: o que perguntar, quanto insistir, e se vale seguir.
|
|
30
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
## 2. Os três pontos
|
|
34
|
+
|
|
35
|
+
| Ponto | O que ele quer | Quanto costuma fechar |
|
|
36
|
+
|-------|----------------|------------------------|
|
|
37
|
+
| **Curioso** | matar a dúvida, comparar preço, olhar para daqui a meses | pouquíssimo |
|
|
38
|
+
| **Avaliando** | decidir se vale e de quem comprar | uma parte |
|
|
39
|
+
| **Comprando hoje** | resolver essa semana, só escolhendo o fornecedor | a maioria |
|
|
40
|
+
|
|
41
|
+
> **Sobre os números.** A referência de mercado que circula é ~3% / ~20% / ~60%,
|
|
42
|
+
> e serve para ordenar prioridade — não é medição do negócio dele. Nunca
|
|
43
|
+
> apresente como se fosse o número dele. Se ele quiser o número real, é contar
|
|
44
|
+
> quantos entraram e quantos fecharam em um mês; sem isso, é chute com casa
|
|
45
|
+
> decimal.
|
|
46
|
+
|
|
47
|
+
---
|
|
48
|
+
|
|
49
|
+
## 3. Como reconhecer, pelos sinais da conversa
|
|
50
|
+
|
|
51
|
+
**Curioso**
|
|
52
|
+
- Pergunta genérica e solta: *"quanto custa?"*, *"vocês fazem?"*
|
|
53
|
+
- Nenhum prazo. Nenhum contexto: não diz onde, quando, para quê.
|
|
54
|
+
- Diz explicitamente que está *"só pesquisando"*, *"dando uma olhada"*.
|
|
55
|
+
- Some entre uma resposta e outra; volta dias depois do zero.
|
|
56
|
+
- Desvia das perguntas de qualificação em vez de respondê-las.
|
|
57
|
+
|
|
58
|
+
**Avaliando**
|
|
59
|
+
- Pergunta específica, com o caso dele dentro: *"quanto custa para X até dia Y?"*
|
|
60
|
+
- Compara em voz alta: *"vi outro lugar por Z"*.
|
|
61
|
+
- Prazo aproximado: *"nos próximos meses"*, *"depois das férias"*.
|
|
62
|
+
- Pede detalhe técnico, garantia, condição, quem executa.
|
|
63
|
+
|
|
64
|
+
**Comprando hoje**
|
|
65
|
+
- Pergunta disponibilidade imediata: *"tem horário hoje?"*, *"tem em estoque?"*
|
|
66
|
+
- Urgência explícita: *"preciso resolver essa semana"*.
|
|
67
|
+
- Pergunta pagamento: *"aceita PIX?"*, *"parcela?"*
|
|
68
|
+
- Pergunta de fechamento: endereço, horário de funcionamento, se pode ir amanhã.
|
|
69
|
+
|
|
70
|
+
**A regra prática:** *contexto + prazo + pergunta de fechamento* é o trio. Quem
|
|
71
|
+
dá os três está comprando. Quem não dá nenhum está passeando.
|
|
72
|
+
|
|
73
|
+
---
|
|
74
|
+
|
|
75
|
+
## 4. O que fazer com cada um
|
|
76
|
+
|
|
77
|
+
| Ponto | Conduta | O erro típico |
|
|
78
|
+
|-------|---------|---------------|
|
|
79
|
+
| **Curioso** | responde a dúvida, seja gentil, **não persiga**. Deixa a porta aberta e o nome guardado. | montar proposta e ficar cobrando resposta de quem nunca disse que queria |
|
|
80
|
+
| **Avaliando** | trazer o que decide: o que está incluso, prazo, quem faz, prova de que já deu certo. **Uma pergunta por mensagem.** | despejar tabela de preço antes de saber o caso dele |
|
|
81
|
+
|
|
82
|
+
**Pergunta de preço solta** — *"quanto custa?"* sem prazo nem contexto — **mantém o lead em
|
|
83
|
+
curioso**. Responda com gentileza e faça uma pergunta de qualificação antes de mandar tabela
|
|
84
|
+
ou proposta. Quem só queria o número não vai responder; quem tem caso real, responde.
|
|
85
|
+
| **Comprando hoje** | **velocidade acima de tudo.** Confirmar disponibilidade e marcar. Não qualificar mais. | fazer o formulário de qualificação inteiro em quem já decidiu — e perder para quem respondeu primeiro |
|
|
86
|
+
|
|
87
|
+
O maior desperdício de um atendimento é o inverso das duas pontas: energia demais
|
|
88
|
+
no curioso, formulário demais em quem já ia comprar.
|
|
89
|
+
|
|
90
|
+
**Sinal muda.** Curioso de terça vira urgente na quinta quando o problema aperta.
|
|
91
|
+
Requalifique a cada conversa nova, não uma vez na vida.
|
|
92
|
+
|
|
93
|
+
**Cliente que já comprou** e volta com nova dúvida não é lead novo: já tem confiança e
|
|
94
|
+
histórico. Pergunte o que mudou desde a última vez e requalifique — pode estar comprando
|
|
95
|
+
hoje sem precisar do mesmo caminho do curioso.
|
|
96
|
+
|
|
97
|
+
**Lead por indicação** chega com confiança parcial — não trate como curioso frio. Confirme
|
|
98
|
+
o que a pessoa indicadora disse, pergunte o caso dele e siga a partir daí.
|
|
99
|
+
|
|
100
|
+
**Desqualificação explícita** — fora da área atendida, fora do perfil que o negócio atende,
|
|
101
|
+
ou orçamento irreal para o serviço — não vale insistir. Responda com gentileza, diga que
|
|
102
|
+
não atende aquele caso, e encerre sem perseguir.
|
|
103
|
+
|
|
104
|
+
---
|
|
105
|
+
|
|
106
|
+
## 5. Onde o cliente escapa
|
|
107
|
+
|
|
108
|
+
Quando alguém diz *"estou perdendo cliente e não sei onde"*, o caminho é sempre
|
|
109
|
+
o mesmo: da primeira vez que ele ouve falar do negócio até o dinheiro entrar,
|
|
110
|
+
há degraus, e em cada degrau cai gente. Localize o degrau antes de propor
|
|
111
|
+
qualquer coisa.
|
|
112
|
+
|
|
113
|
+
1. **Viu o anúncio → chamou no WhatsApp** — link quebrado, página confusa,
|
|
114
|
+
fricção antes da primeira mensagem.
|
|
115
|
+
2. **Chamou → marcou alguma coisa** — ninguém responde rápido, ou responde e não
|
|
116
|
+
conduz. **Costuma ser o maior buraco dos quatro.**
|
|
117
|
+
3. **Marcou → apareceu** — esquecimento, sem confirmação, sem lembrete.
|
|
118
|
+
4. **Apareceu → pagou** — a conversa final.
|
|
119
|
+
|
|
120
|
+
Diagnóstico honesto exige contar, não achar: quantos chegaram, quantos marcaram,
|
|
121
|
+
quantos vieram, quantos pagaram — num mês. Se ele não tem esses quatro números,
|
|
122
|
+
**o primeiro trabalho é passar a contar**, não mexer no atendimento no escuro.
|
|
123
|
+
|
|
124
|
+
O ganho grande quase nunca está em trazer mais gente. Está em parar de perder a
|
|
125
|
+
que já chegou: reduzir a queda do degrau 2 vale mais que dobrar o anúncio, e
|
|
126
|
+
custa menos.
|
|
127
|
+
|
|
128
|
+
---
|
|
129
|
+
|
|
130
|
+
## 6. Como isso sai para ele
|
|
131
|
+
|
|
132
|
+
Nunca entregue a classificação crua — *"lead frio, estágio 1"* é vocabulário
|
|
133
|
+
interno e não é problema dele.
|
|
134
|
+
|
|
135
|
+
- Errado: *"Lead em estágio de avaliação, conversão esperada 20%. Recomendo
|
|
136
|
+
nutrição."*
|
|
137
|
+
- Certo: *"Esse aí tá comparando preço, ainda não decidiu. Vale mandar o que tá
|
|
138
|
+
incluso e quanto tempo leva — e não ficar cobrando resposta."*
|
|
139
|
+
- Certo: *"Esse quer resolver essa semana. Responde agora com o horário; quem
|
|
140
|
+
responder primeiro leva."*
|
|
@@ -0,0 +1,351 @@
|
|
|
1
|
+
# 1. Eliminating Waterfalls
|
|
2
|
+
|
|
3
|
+
> **Impact:** CRITICAL
|
|
4
|
+
> **Focus:** Waterfalls are the #1 performance killer. Each sequential await adds full network latency. Eliminating them yields the largest gains.
|
|
5
|
+
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## Overview
|
|
9
|
+
|
|
10
|
+
This section contains **6 rules** focused on eliminating waterfalls, now including Next.js 16 `after()` and `connection()` patterns.
|
|
11
|
+
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
## Rule 1.1: Defer Await Until Needed
|
|
15
|
+
|
|
16
|
+
**Impact:** HIGH
|
|
17
|
+
**Tags:** async, await, conditional, optimization
|
|
18
|
+
|
|
19
|
+
## Defer Await Until Needed
|
|
20
|
+
|
|
21
|
+
Move `await` operations into the branches where they're actually used to avoid blocking code paths that don't need them.
|
|
22
|
+
|
|
23
|
+
**Incorrect (blocks both branches):**
|
|
24
|
+
|
|
25
|
+
```typescript
|
|
26
|
+
async function handleRequest(userId: string, skipProcessing: boolean) {
|
|
27
|
+
const userData = await fetchUserData(userId)
|
|
28
|
+
|
|
29
|
+
if (skipProcessing) {
|
|
30
|
+
// Returns immediately but still waited for userData
|
|
31
|
+
return { skipped: true }
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
// Only this branch uses userData
|
|
35
|
+
return processUserData(userData)
|
|
36
|
+
}
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
**Correct (only blocks when needed):**
|
|
40
|
+
|
|
41
|
+
```typescript
|
|
42
|
+
async function handleRequest(userId: string, skipProcessing: boolean) {
|
|
43
|
+
if (skipProcessing) {
|
|
44
|
+
// Returns immediately without waiting
|
|
45
|
+
return { skipped: true }
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
// Fetch only when needed
|
|
49
|
+
const userData = await fetchUserData(userId)
|
|
50
|
+
return processUserData(userData)
|
|
51
|
+
}
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
**Another example (early return optimization):**
|
|
55
|
+
|
|
56
|
+
```typescript
|
|
57
|
+
// Incorrect: always fetches permissions
|
|
58
|
+
async function updateResource(resourceId: string, userId: string) {
|
|
59
|
+
const permissions = await fetchPermissions(userId)
|
|
60
|
+
const resource = await getResource(resourceId)
|
|
61
|
+
|
|
62
|
+
if (!resource) {
|
|
63
|
+
return { error: 'Not found' }
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
if (!permissions.canEdit) {
|
|
67
|
+
return { error: 'Forbidden' }
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
return await updateResourceData(resource, permissions)
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
// Correct: fetches only when needed
|
|
74
|
+
async function updateResource(resourceId: string, userId: string) {
|
|
75
|
+
const resource = await getResource(resourceId)
|
|
76
|
+
|
|
77
|
+
if (!resource) {
|
|
78
|
+
return { error: 'Not found' }
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
const permissions = await fetchPermissions(userId)
|
|
82
|
+
|
|
83
|
+
if (!permissions.canEdit) {
|
|
84
|
+
return { error: 'Forbidden' }
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
return await updateResourceData(resource, permissions)
|
|
88
|
+
}
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
This optimization is especially valuable when the skipped branch is frequently taken, or when the deferred operation is expensive.
|
|
92
|
+
|
|
93
|
+
---
|
|
94
|
+
|
|
95
|
+
## Rule 1.2: Dependency-Based Parallelization
|
|
96
|
+
|
|
97
|
+
**Impact:** CRITICAL
|
|
98
|
+
**Tags:** async, parallelization, dependencies, better-all
|
|
99
|
+
|
|
100
|
+
## Dependency-Based Parallelization
|
|
101
|
+
|
|
102
|
+
For operations with partial dependencies, use `better-all` to maximize parallelism. It automatically starts each task at the earliest possible moment.
|
|
103
|
+
|
|
104
|
+
**Incorrect (profile waits for config unnecessarily):**
|
|
105
|
+
|
|
106
|
+
```typescript
|
|
107
|
+
const [user, config] = await Promise.all([
|
|
108
|
+
fetchUser(),
|
|
109
|
+
fetchConfig()
|
|
110
|
+
])
|
|
111
|
+
const profile = await fetchProfile(user.id)
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
**Correct (config and profile run in parallel):**
|
|
115
|
+
|
|
116
|
+
```typescript
|
|
117
|
+
import { all } from 'better-all'
|
|
118
|
+
|
|
119
|
+
const { user, config, profile } = await all({
|
|
120
|
+
async user() { return fetchUser() },
|
|
121
|
+
async config() { return fetchConfig() },
|
|
122
|
+
async profile() {
|
|
123
|
+
return fetchProfile((await this.$.user).id)
|
|
124
|
+
}
|
|
125
|
+
})
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
**Alternative without extra dependencies:**
|
|
129
|
+
|
|
130
|
+
We can also create all the promises first, and do `Promise.all()` at the end.
|
|
131
|
+
|
|
132
|
+
```typescript
|
|
133
|
+
const userPromise = fetchUser()
|
|
134
|
+
const profilePromise = userPromise.then(user => fetchProfile(user.id))
|
|
135
|
+
|
|
136
|
+
const [user, config, profile] = await Promise.all([
|
|
137
|
+
userPromise,
|
|
138
|
+
fetchConfig(),
|
|
139
|
+
profilePromise
|
|
140
|
+
])
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
Reference: [https://github.com/shuding/better-all](https://github.com/shuding/better-all)
|
|
144
|
+
|
|
145
|
+
---
|
|
146
|
+
|
|
147
|
+
## Rule 1.3: Prevent Waterfall Chains in API Routes
|
|
148
|
+
|
|
149
|
+
**Impact:** CRITICAL
|
|
150
|
+
**Tags:** api-routes, server-actions, waterfalls, parallelization
|
|
151
|
+
|
|
152
|
+
## Prevent Waterfall Chains in API Routes
|
|
153
|
+
|
|
154
|
+
In API routes and Server Actions, start independent operations immediately, even if you don't await them yet.
|
|
155
|
+
|
|
156
|
+
**Incorrect (config waits for auth, data waits for both):**
|
|
157
|
+
|
|
158
|
+
```typescript
|
|
159
|
+
export async function GET(request: Request) {
|
|
160
|
+
const session = await auth()
|
|
161
|
+
const config = await fetchConfig()
|
|
162
|
+
const data = await fetchData(session.user.id)
|
|
163
|
+
return Response.json({ data, config })
|
|
164
|
+
}
|
|
165
|
+
```
|
|
166
|
+
|
|
167
|
+
**Correct (auth and config start immediately):**
|
|
168
|
+
|
|
169
|
+
```typescript
|
|
170
|
+
export async function GET(request: Request) {
|
|
171
|
+
const sessionPromise = auth()
|
|
172
|
+
const configPromise = fetchConfig()
|
|
173
|
+
const session = await sessionPromise
|
|
174
|
+
const [config, data] = await Promise.all([
|
|
175
|
+
configPromise,
|
|
176
|
+
fetchData(session.user.id)
|
|
177
|
+
])
|
|
178
|
+
return Response.json({ data, config })
|
|
179
|
+
}
|
|
180
|
+
```
|
|
181
|
+
|
|
182
|
+
For operations with more complex dependency chains, use `better-all` to automatically maximize parallelism (see Dependency-Based Parallelization).
|
|
183
|
+
|
|
184
|
+
---
|
|
185
|
+
|
|
186
|
+
## Rule 1.4: Promise.all() for Independent Operations
|
|
187
|
+
|
|
188
|
+
**Impact:** CRITICAL
|
|
189
|
+
**Tags:** async, parallelization, promises, waterfalls
|
|
190
|
+
|
|
191
|
+
## Promise.all() for Independent Operations
|
|
192
|
+
|
|
193
|
+
When async operations have no interdependencies, execute them concurrently using `Promise.all()`.
|
|
194
|
+
|
|
195
|
+
**Incorrect (sequential execution, 3 round trips):**
|
|
196
|
+
|
|
197
|
+
```typescript
|
|
198
|
+
const user = await fetchUser()
|
|
199
|
+
const posts = await fetchPosts()
|
|
200
|
+
const comments = await fetchComments()
|
|
201
|
+
```
|
|
202
|
+
|
|
203
|
+
**Correct (parallel execution, 1 round trip):**
|
|
204
|
+
|
|
205
|
+
```typescript
|
|
206
|
+
const [user, posts, comments] = await Promise.all([
|
|
207
|
+
fetchUser(),
|
|
208
|
+
fetchPosts(),
|
|
209
|
+
fetchComments()
|
|
210
|
+
])
|
|
211
|
+
```
|
|
212
|
+
|
|
213
|
+
---
|
|
214
|
+
|
|
215
|
+
## Rule 1.5: Strategic Suspense Boundaries
|
|
216
|
+
|
|
217
|
+
**Impact:** HIGH
|
|
218
|
+
**Tags:** async, suspense, streaming, layout-shift
|
|
219
|
+
|
|
220
|
+
## Strategic Suspense Boundaries
|
|
221
|
+
|
|
222
|
+
Instead of awaiting data in async components before returning JSX, use Suspense boundaries to show the wrapper UI faster while data loads.
|
|
223
|
+
|
|
224
|
+
**Incorrect (wrapper blocked by data fetching):**
|
|
225
|
+
|
|
226
|
+
```tsx
|
|
227
|
+
async function Page() {
|
|
228
|
+
const data = await fetchData() // Blocks entire page
|
|
229
|
+
|
|
230
|
+
return (
|
|
231
|
+
<div>
|
|
232
|
+
<div>Sidebar</div>
|
|
233
|
+
<div>Header</div>
|
|
234
|
+
<div>
|
|
235
|
+
<DataDisplay data={data} />
|
|
236
|
+
</div>
|
|
237
|
+
<div>Footer</div>
|
|
238
|
+
</div>
|
|
239
|
+
)
|
|
240
|
+
}
|
|
241
|
+
```
|
|
242
|
+
|
|
243
|
+
The entire layout waits for data even though only the middle section needs it.
|
|
244
|
+
|
|
245
|
+
**Correct (wrapper shows immediately, data streams in):**
|
|
246
|
+
|
|
247
|
+
```tsx
|
|
248
|
+
function Page() {
|
|
249
|
+
return (
|
|
250
|
+
<div>
|
|
251
|
+
<div>Sidebar</div>
|
|
252
|
+
<div>Header</div>
|
|
253
|
+
<div>
|
|
254
|
+
<Suspense fallback={<Skeleton />}>
|
|
255
|
+
<DataDisplay />
|
|
256
|
+
</Suspense>
|
|
257
|
+
</div>
|
|
258
|
+
<div>Footer</div>
|
|
259
|
+
</div>
|
|
260
|
+
)
|
|
261
|
+
}
|
|
262
|
+
|
|
263
|
+
async function DataDisplay() {
|
|
264
|
+
const data = await fetchData() // Only blocks this component
|
|
265
|
+
return <div>{data.content}</div>
|
|
266
|
+
}
|
|
267
|
+
```
|
|
268
|
+
|
|
269
|
+
Sidebar, Header, and Footer render immediately. Only DataDisplay waits for data.
|
|
270
|
+
|
|
271
|
+
**Alternative (share promise across components):**
|
|
272
|
+
|
|
273
|
+
```tsx
|
|
274
|
+
function Page() {
|
|
275
|
+
// Start fetch immediately, but don't await
|
|
276
|
+
const dataPromise = fetchData()
|
|
277
|
+
|
|
278
|
+
return (
|
|
279
|
+
<div>
|
|
280
|
+
<div>Sidebar</div>
|
|
281
|
+
<div>Header</div>
|
|
282
|
+
<Suspense fallback={<Skeleton />}>
|
|
283
|
+
<DataDisplay dataPromise={dataPromise} />
|
|
284
|
+
<DataSummary dataPromise={dataPromise} />
|
|
285
|
+
</Suspense>
|
|
286
|
+
<div>Footer</div>
|
|
287
|
+
</div>
|
|
288
|
+
)
|
|
289
|
+
}
|
|
290
|
+
|
|
291
|
+
function DataDisplay({ dataPromise }: { dataPromise: Promise<Data> }) {
|
|
292
|
+
const data = use(dataPromise) // Unwraps the promise
|
|
293
|
+
return <div>{data.content}</div>
|
|
294
|
+
}
|
|
295
|
+
|
|
296
|
+
function DataSummary({ dataPromise }: { dataPromise: Promise<Data> }) {
|
|
297
|
+
const data = use(dataPromise) // Reuses the same promise
|
|
298
|
+
return <div>{data.summary}</div>
|
|
299
|
+
}
|
|
300
|
+
```
|
|
301
|
+
|
|
302
|
+
Both components share the same promise, so only one fetch occurs. Layout renders immediately while both components wait together.
|
|
303
|
+
|
|
304
|
+
**When NOT to use this pattern:**
|
|
305
|
+
|
|
306
|
+
- Critical data needed for layout decisions (affects positioning)
|
|
307
|
+
- SEO-critical content above the fold
|
|
308
|
+
- Small, fast queries where suspense overhead isn't worth it
|
|
309
|
+
- When you want to avoid layout shift (loading → content jump)
|
|
310
|
+
|
|
311
|
+
**Trade-off:** Faster initial paint vs potential layout shift. Choose based on your UX priorities.
|
|
312
|
+
|
|
313
|
+
|
|
314
|
+
---
|
|
315
|
+
|
|
316
|
+
## Rule 1.6: Use `after()` and `connection()` (Next.js 16+)
|
|
317
|
+
|
|
318
|
+
**Impact:** HIGH
|
|
319
|
+
**Tags:** nextjs16, async, runtime, performance
|
|
320
|
+
|
|
321
|
+
Next.js 16 introduced APIs to prevent "Blocking the Main Thread" and ensure "Dynamic Runtime" awareness.
|
|
322
|
+
|
|
323
|
+
### 1. `after()` for Non-Blocking Logic
|
|
324
|
+
Avoid `await` on logic that doesn't affect the initial UI (logging, analytics, emails).
|
|
325
|
+
|
|
326
|
+
```tsx
|
|
327
|
+
import { after } from 'next/server'
|
|
328
|
+
|
|
329
|
+
export default async function Page() {
|
|
330
|
+
const data = await fetchData() // CRITICAL
|
|
331
|
+
|
|
332
|
+
after(() => {
|
|
333
|
+
// RUNS AFTER THE RESPONSE IS SENT
|
|
334
|
+
logTrack(data)
|
|
335
|
+
})
|
|
336
|
+
|
|
337
|
+
return <View data={data} />
|
|
338
|
+
}
|
|
339
|
+
```
|
|
340
|
+
|
|
341
|
+
### 2. `connection()` for Dynamic Intent
|
|
342
|
+
Use `connection()` to signal that a component is dynamic and should not be pre-rendered as static, allowing other parts of the page to stream independently.
|
|
343
|
+
|
|
344
|
+
```tsx
|
|
345
|
+
import { connection } from 'next/server'
|
|
346
|
+
|
|
347
|
+
async function DynamicData() {
|
|
348
|
+
await connection() // Signals dynamic intent
|
|
349
|
+
return await fetchFreshData()
|
|
350
|
+
}
|
|
351
|
+
```
|