@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,145 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: i18n-localization
|
|
3
|
+
description: Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.
|
|
4
|
+
when_to_use: "When internationalizing an app, managing translations, detecting hardcoded strings, or adding RTL support."
|
|
5
|
+
allowed-tools: Read, Glob, Grep
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# i18n & Localization
|
|
9
|
+
|
|
10
|
+
> Internationalization (i18n) and Localization (L10n) best practices.
|
|
11
|
+
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
## 1. Core Concepts
|
|
15
|
+
|
|
16
|
+
| Term | Meaning |
|
|
17
|
+
|------|---------|
|
|
18
|
+
| **i18n** | Internationalization - making app translatable |
|
|
19
|
+
| **L10n** | Localization - actual translations |
|
|
20
|
+
| **Locale** | Language + Region (en-US, tr-TR) |
|
|
21
|
+
| **RTL** | Right-to-left languages (Arabic, Hebrew) |
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
## 2. When to Use i18n
|
|
26
|
+
|
|
27
|
+
| Project Type | i18n Needed? |
|
|
28
|
+
|--------------|--------------|
|
|
29
|
+
| Public web app | ✅ Yes |
|
|
30
|
+
| SaaS product | ✅ Yes |
|
|
31
|
+
| Internal tool | ⚠️ Maybe |
|
|
32
|
+
| Single-region app | ⚠️ Consider future |
|
|
33
|
+
| Personal project | ❌ Optional |
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
## 3. Implementation Patterns
|
|
38
|
+
|
|
39
|
+
### React (react-i18next)
|
|
40
|
+
|
|
41
|
+
```tsx
|
|
42
|
+
import { useTranslations } from 'next-intl';
|
|
43
|
+
|
|
44
|
+
// In Next.js App Router, ensure messages are preloaded on the server to prevent SSR hydration mismatch:
|
|
45
|
+
export default function Page() {
|
|
46
|
+
const t = useTranslations('Home');
|
|
47
|
+
return <h1>{t('title')}</h1>;
|
|
48
|
+
}
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
### Python (gettext)
|
|
52
|
+
|
|
53
|
+
```python
|
|
54
|
+
from gettext import gettext as _
|
|
55
|
+
|
|
56
|
+
print(_("Welcome to our app"))
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
---
|
|
60
|
+
|
|
61
|
+
## 4. File Structure
|
|
62
|
+
|
|
63
|
+
```
|
|
64
|
+
locales/
|
|
65
|
+
├── en/
|
|
66
|
+
│ ├── common.json
|
|
67
|
+
│ ├── auth.json
|
|
68
|
+
│ └── errors.json
|
|
69
|
+
├── tr/
|
|
70
|
+
│ ├── common.json
|
|
71
|
+
│ ├── auth.json
|
|
72
|
+
│ └── errors.json
|
|
73
|
+
└── ar/ # RTL
|
|
74
|
+
└── ...
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
---
|
|
78
|
+
|
|
79
|
+
## 5. Best Practices
|
|
80
|
+
|
|
81
|
+
### DO ✅
|
|
82
|
+
|
|
83
|
+
- Use translation keys, not raw text
|
|
84
|
+
- Namespace translations by feature and split dynamically (avoid monolingual dictionary bundles)
|
|
85
|
+
- Support pluralization via ICU message format (CLDR plural rules: zero, one, few, many, other)
|
|
86
|
+
- Cache / memoize `Intl.DateTimeFormat` and `Intl.NumberFormat` instances to prevent render loop jank
|
|
87
|
+
- Plan for RTL from the start (mirror layout, but preserve direction on media controls/numbers)
|
|
88
|
+
- Configure hreflang and localized routing (`/en`, `/pt-BR`) for public multilingual SEO
|
|
89
|
+
|
|
90
|
+
### DON'T ❌
|
|
91
|
+
|
|
92
|
+
- Hardcode strings in components
|
|
93
|
+
- Concatenate translated strings
|
|
94
|
+
- Assume text length (German is 30% longer)
|
|
95
|
+
- Forget about RTL layout
|
|
96
|
+
- Mix languages in same file
|
|
97
|
+
|
|
98
|
+
---
|
|
99
|
+
|
|
100
|
+
## 6. Common Issues
|
|
101
|
+
|
|
102
|
+
| Issue | Solution |
|
|
103
|
+
|-------|----------|
|
|
104
|
+
| Missing translation | Fallback to default language |
|
|
105
|
+
| Hardcoded strings | Use linter/checker script |
|
|
106
|
+
| Date format | Use Intl.DateTimeFormat |
|
|
107
|
+
| Number format | Use Intl.NumberFormat |
|
|
108
|
+
| Pluralization | Use ICU message format |
|
|
109
|
+
|
|
110
|
+
---
|
|
111
|
+
|
|
112
|
+
## 7. RTL Support
|
|
113
|
+
|
|
114
|
+
```css
|
|
115
|
+
/* CSS Logical Properties */
|
|
116
|
+
.container {
|
|
117
|
+
margin-inline-start: 1rem; /* Not margin-left */
|
|
118
|
+
padding-inline-end: 1rem; /* Not padding-right */
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
[dir="rtl"] .icon {
|
|
122
|
+
transform: scaleX(-1);
|
|
123
|
+
}
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
---
|
|
127
|
+
|
|
128
|
+
## 8. Checklist
|
|
129
|
+
|
|
130
|
+
Before shipping:
|
|
131
|
+
|
|
132
|
+
- [ ] All user-facing strings use translation keys
|
|
133
|
+
- [ ] Locale files exist for all supported languages
|
|
134
|
+
- [ ] Date/number formatting uses Intl API
|
|
135
|
+
- [ ] RTL layout tested (if applicable)
|
|
136
|
+
- [ ] Fallback language configured
|
|
137
|
+
- [ ] No hardcoded strings in components
|
|
138
|
+
|
|
139
|
+
---
|
|
140
|
+
|
|
141
|
+
## Script
|
|
142
|
+
|
|
143
|
+
| Script | Purpose | Command |
|
|
144
|
+
|--------|---------|---------|
|
|
145
|
+
| `scripts/i18n_checker.py` | Detect hardcoded strings & missing translations | `python scripts/i18n_checker.py <project_path>` |
|
|
@@ -0,0 +1,241 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""
|
|
3
|
+
i18n Checker - Detects hardcoded strings and missing translations.
|
|
4
|
+
Scans for untranslated text in React, Vue, and Python files.
|
|
5
|
+
"""
|
|
6
|
+
import sys
|
|
7
|
+
import re
|
|
8
|
+
import json
|
|
9
|
+
from pathlib import Path
|
|
10
|
+
|
|
11
|
+
# Fix Windows console encoding for Unicode output
|
|
12
|
+
try:
|
|
13
|
+
sys.stdout.reconfigure(encoding='utf-8', errors='replace')
|
|
14
|
+
sys.stderr.reconfigure(encoding='utf-8', errors='replace')
|
|
15
|
+
except AttributeError:
|
|
16
|
+
pass # Python < 3.7
|
|
17
|
+
|
|
18
|
+
# Patterns that indicate hardcoded strings (should be translated)
|
|
19
|
+
HARDCODED_PATTERNS = {
|
|
20
|
+
'jsx': [
|
|
21
|
+
# Text directly in JSX: <div>Hello World</div>
|
|
22
|
+
r'>\s*[A-Z][a-zA-Z\s]{3,30}\s*</',
|
|
23
|
+
# JSX attribute strings: title="Welcome"
|
|
24
|
+
r'(title|placeholder|label|alt|aria-label)="[A-Z][a-zA-Z\s]{2,}"',
|
|
25
|
+
# Button/heading text
|
|
26
|
+
r'<(button|h[1-6]|p|span|label)[^>]*>\s*[A-Z][a-zA-Z\s!?.,]{3,}\s*</',
|
|
27
|
+
],
|
|
28
|
+
'vue': [
|
|
29
|
+
# Vue template text
|
|
30
|
+
r'>\s*[A-Z][a-zA-Z\s]{3,30}\s*</',
|
|
31
|
+
r'(placeholder|label|title)="[A-Z][a-zA-Z\s]{2,}"',
|
|
32
|
+
],
|
|
33
|
+
'python': [
|
|
34
|
+
# print/raise with string literals
|
|
35
|
+
r'(print|raise\s+\w+)\s*\(\s*["\'][A-Z][^"\']{5,}["\']',
|
|
36
|
+
# Flask flash messages
|
|
37
|
+
r'flash\s*\(\s*["\'][A-Z][^"\']{5,}["\']',
|
|
38
|
+
]
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
# Patterns that indicate proper i18n usage
|
|
42
|
+
I18N_PATTERNS = [
|
|
43
|
+
r't\(["\']', # t('key') - react-i18next
|
|
44
|
+
r'useTranslation', # React hook
|
|
45
|
+
r'\$t\(', # Vue i18n
|
|
46
|
+
r'_\(["\']', # Python gettext
|
|
47
|
+
r'gettext\(', # Python gettext
|
|
48
|
+
r'useTranslations', # next-intl
|
|
49
|
+
r'FormattedMessage', # react-intl
|
|
50
|
+
r'i18n\.', # Generic i18n
|
|
51
|
+
]
|
|
52
|
+
|
|
53
|
+
def find_locale_files(project_path: Path) -> list:
|
|
54
|
+
"""Find translation/locale files."""
|
|
55
|
+
patterns = [
|
|
56
|
+
"**/locales/**/*.json",
|
|
57
|
+
"**/translations/**/*.json",
|
|
58
|
+
"**/lang/**/*.json",
|
|
59
|
+
"**/i18n/**/*.json",
|
|
60
|
+
"**/messages/*.json",
|
|
61
|
+
"**/*.po", # gettext
|
|
62
|
+
]
|
|
63
|
+
|
|
64
|
+
files = []
|
|
65
|
+
for pattern in patterns:
|
|
66
|
+
files.extend(project_path.glob(pattern))
|
|
67
|
+
|
|
68
|
+
return [f for f in files if 'node_modules' not in str(f)]
|
|
69
|
+
|
|
70
|
+
def check_locale_completeness(locale_files: list) -> dict:
|
|
71
|
+
"""Check if all locales have the same keys."""
|
|
72
|
+
issues = []
|
|
73
|
+
passed = []
|
|
74
|
+
|
|
75
|
+
if not locale_files:
|
|
76
|
+
return {'passed': [], 'issues': ["[!] No locale files found"]}
|
|
77
|
+
|
|
78
|
+
# Group by parent folder (language)
|
|
79
|
+
locales = {}
|
|
80
|
+
for f in locale_files:
|
|
81
|
+
if f.suffix == '.json':
|
|
82
|
+
try:
|
|
83
|
+
lang = f.parent.name
|
|
84
|
+
content = json.loads(f.read_text(encoding='utf-8'))
|
|
85
|
+
if lang not in locales:
|
|
86
|
+
locales[lang] = {}
|
|
87
|
+
locales[lang][f.stem] = set(flatten_keys(content))
|
|
88
|
+
except:
|
|
89
|
+
continue
|
|
90
|
+
|
|
91
|
+
if len(locales) < 2:
|
|
92
|
+
passed.append(f"[OK] Found {len(locale_files)} locale file(s)")
|
|
93
|
+
return {'passed': passed, 'issues': issues}
|
|
94
|
+
|
|
95
|
+
passed.append(f"[OK] Found {len(locales)} language(s): {', '.join(locales.keys())}")
|
|
96
|
+
|
|
97
|
+
# Compare keys across locales
|
|
98
|
+
all_langs = list(locales.keys())
|
|
99
|
+
base_lang = all_langs[0]
|
|
100
|
+
|
|
101
|
+
for namespace in locales.get(base_lang, {}):
|
|
102
|
+
base_keys = locales[base_lang].get(namespace, set())
|
|
103
|
+
|
|
104
|
+
for lang in all_langs[1:]:
|
|
105
|
+
other_keys = locales.get(lang, {}).get(namespace, set())
|
|
106
|
+
|
|
107
|
+
missing = base_keys - other_keys
|
|
108
|
+
if missing:
|
|
109
|
+
issues.append(f"[X] {lang}/{namespace}: Missing {len(missing)} keys")
|
|
110
|
+
|
|
111
|
+
extra = other_keys - base_keys
|
|
112
|
+
if extra:
|
|
113
|
+
issues.append(f"[!] {lang}/{namespace}: {len(extra)} extra keys")
|
|
114
|
+
|
|
115
|
+
if not issues:
|
|
116
|
+
passed.append("[OK] All locales have matching keys")
|
|
117
|
+
|
|
118
|
+
return {'passed': passed, 'issues': issues}
|
|
119
|
+
|
|
120
|
+
def flatten_keys(d, prefix=''):
|
|
121
|
+
"""Flatten nested dict keys."""
|
|
122
|
+
keys = set()
|
|
123
|
+
for k, v in d.items():
|
|
124
|
+
new_key = f"{prefix}.{k}" if prefix else k
|
|
125
|
+
if isinstance(v, dict):
|
|
126
|
+
keys.update(flatten_keys(v, new_key))
|
|
127
|
+
else:
|
|
128
|
+
keys.add(new_key)
|
|
129
|
+
return keys
|
|
130
|
+
|
|
131
|
+
def check_hardcoded_strings(project_path: Path) -> dict:
|
|
132
|
+
"""Check for hardcoded strings in code files."""
|
|
133
|
+
issues = []
|
|
134
|
+
passed = []
|
|
135
|
+
|
|
136
|
+
# Find code files
|
|
137
|
+
extensions = {
|
|
138
|
+
'.tsx': 'jsx', '.jsx': 'jsx', '.ts': 'jsx', '.js': 'jsx',
|
|
139
|
+
'.vue': 'vue',
|
|
140
|
+
'.py': 'python'
|
|
141
|
+
}
|
|
142
|
+
|
|
143
|
+
code_files = []
|
|
144
|
+
for ext in extensions:
|
|
145
|
+
code_files.extend(project_path.rglob(f"*{ext}"))
|
|
146
|
+
|
|
147
|
+
code_files = [f for f in code_files if not any(x in str(f) for x in
|
|
148
|
+
['node_modules', '.git', 'dist', 'build', '__pycache__', 'venv', 'test', 'spec'])]
|
|
149
|
+
|
|
150
|
+
if not code_files:
|
|
151
|
+
return {'passed': ["[!] No code files found"], 'issues': []}
|
|
152
|
+
|
|
153
|
+
files_with_i18n = 0
|
|
154
|
+
files_with_hardcoded = 0
|
|
155
|
+
hardcoded_examples = []
|
|
156
|
+
|
|
157
|
+
for file_path in code_files[:50]: # Limit
|
|
158
|
+
try:
|
|
159
|
+
content = file_path.read_text(encoding='utf-8', errors='ignore')
|
|
160
|
+
ext = file_path.suffix
|
|
161
|
+
file_type = extensions.get(ext, 'jsx')
|
|
162
|
+
|
|
163
|
+
# Check for i18n usage
|
|
164
|
+
has_i18n = any(re.search(p, content) for p in I18N_PATTERNS)
|
|
165
|
+
if has_i18n:
|
|
166
|
+
files_with_i18n += 1
|
|
167
|
+
|
|
168
|
+
# Check for hardcoded strings
|
|
169
|
+
patterns = HARDCODED_PATTERNS.get(file_type, [])
|
|
170
|
+
hardcoded_found = False
|
|
171
|
+
|
|
172
|
+
for pattern in patterns:
|
|
173
|
+
matches = re.findall(pattern, content)
|
|
174
|
+
if matches and not has_i18n:
|
|
175
|
+
hardcoded_found = True
|
|
176
|
+
if len(hardcoded_examples) < 5:
|
|
177
|
+
hardcoded_examples.append(f"{file_path.name}: {str(matches[0])[:40]}...")
|
|
178
|
+
|
|
179
|
+
if hardcoded_found:
|
|
180
|
+
files_with_hardcoded += 1
|
|
181
|
+
|
|
182
|
+
except:
|
|
183
|
+
continue
|
|
184
|
+
|
|
185
|
+
passed.append(f"[OK] Analyzed {len(code_files)} code files")
|
|
186
|
+
|
|
187
|
+
if files_with_i18n > 0:
|
|
188
|
+
passed.append(f"[OK] {files_with_i18n} files use i18n")
|
|
189
|
+
|
|
190
|
+
if files_with_hardcoded > 0:
|
|
191
|
+
issues.append(f"[X] {files_with_hardcoded} files may have hardcoded strings")
|
|
192
|
+
for ex in hardcoded_examples:
|
|
193
|
+
issues.append(f" → {ex}")
|
|
194
|
+
else:
|
|
195
|
+
passed.append("[OK] No obvious hardcoded strings detected")
|
|
196
|
+
|
|
197
|
+
return {'passed': passed, 'issues': issues}
|
|
198
|
+
|
|
199
|
+
def main():
|
|
200
|
+
target = sys.argv[1] if len(sys.argv) > 1 else "."
|
|
201
|
+
project_path = Path(target)
|
|
202
|
+
|
|
203
|
+
print("\n" + "=" * 60)
|
|
204
|
+
print(" i18n CHECKER - Internationalization Audit")
|
|
205
|
+
print("=" * 60 + "\n")
|
|
206
|
+
|
|
207
|
+
# Check locale files
|
|
208
|
+
locale_files = find_locale_files(project_path)
|
|
209
|
+
locale_result = check_locale_completeness(locale_files)
|
|
210
|
+
|
|
211
|
+
# Check hardcoded strings
|
|
212
|
+
code_result = check_hardcoded_strings(project_path)
|
|
213
|
+
|
|
214
|
+
# Print results
|
|
215
|
+
print("[LOCALE FILES]")
|
|
216
|
+
print("-" * 40)
|
|
217
|
+
for item in locale_result['passed']:
|
|
218
|
+
print(f" {item}")
|
|
219
|
+
for item in locale_result['issues']:
|
|
220
|
+
print(f" {item}")
|
|
221
|
+
|
|
222
|
+
print("\n[CODE ANALYSIS]")
|
|
223
|
+
print("-" * 40)
|
|
224
|
+
for item in code_result['passed']:
|
|
225
|
+
print(f" {item}")
|
|
226
|
+
for item in code_result['issues']:
|
|
227
|
+
print(f" {item}")
|
|
228
|
+
|
|
229
|
+
# Summary
|
|
230
|
+
critical_issues = sum(1 for i in locale_result['issues'] + code_result['issues'] if i.startswith("[X]"))
|
|
231
|
+
|
|
232
|
+
print("\n" + "=" * 60)
|
|
233
|
+
if critical_issues == 0:
|
|
234
|
+
print("[OK] i18n CHECK: PASSED")
|
|
235
|
+
sys.exit(0)
|
|
236
|
+
else:
|
|
237
|
+
print(f"[X] i18n CHECK: {critical_issues} issues found")
|
|
238
|
+
sys.exit(1)
|
|
239
|
+
|
|
240
|
+
if __name__ == "__main__":
|
|
241
|
+
main()
|
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: intelligent-routing
|
|
3
|
+
description: Automatic agent selection and intelligent task routing. Analyzes user requests and automatically selects the best specialist agent(s) without requiring explicit user mentions.
|
|
4
|
+
when_to_use: "Always active. Automatically selects the best specialist agent for each user request without explicit user mentions."
|
|
5
|
+
version: 1.0.0
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Intelligent Agent Routing
|
|
9
|
+
|
|
10
|
+
**Purpose**: Automatically analyze user requests and route them to the most appropriate specialist agent(s) without requiring explicit user mentions.
|
|
11
|
+
|
|
12
|
+
## Core Principle
|
|
13
|
+
|
|
14
|
+
> **The AI should act as an intelligent Project Manager**, analyzing each request and automatically selecting the best specialist(s) for the job.
|
|
15
|
+
|
|
16
|
+
## How It Works
|
|
17
|
+
|
|
18
|
+
### 1. Request Analysis
|
|
19
|
+
|
|
20
|
+
Before responding to non-trivial user requests, evaluate intent and token cost:
|
|
21
|
+
|
|
22
|
+
```mermaid
|
|
23
|
+
graph TD
|
|
24
|
+
A[User Request: Add login] --> B[Fast Local Match]
|
|
25
|
+
B -->|Trivial/Factual| C[Direct Answer / Low Tier]
|
|
26
|
+
B -->|Non-Trivial| D[SELECT SPECIALIST & MODEL TIER]
|
|
27
|
+
D --> E[Single Specialist]
|
|
28
|
+
D -->|Explicit Complex/Multi-domain| F[Orchestrator - Plan First]
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
### 2. Agent Selection Matrix
|
|
32
|
+
|
|
33
|
+
#### Fork 0 — who is going to READ the answer?
|
|
34
|
+
|
|
35
|
+
**Decide this before anything else.** It is not a technical-domain question, and
|
|
36
|
+
getting it wrong is not a small miss: it produces "I opened a PR with the fix"
|
|
37
|
+
delivered to a shop owner.
|
|
38
|
+
|
|
39
|
+
| Reader | Signal | Route |
|
|
40
|
+
|--------|--------|-------|
|
|
41
|
+
| **Someone who decides** — owner, CEO, marketing, front desk, **or a person deciding about their own life** | Asks about something they must choose or act on: money, customer, campaign, **a course of study, a career move, a business they want to start**. Uses no technical vocabulary, and is not asking for a change to a codebase. | **`negocio-*` skills.** Load `negocio-linguagem` FIRST — it is the base and the others assume it — then the specific one below. Do **not** route to an engineering agent. |
|
|
42
|
+
| **Someone who builds** | Asks for a change to code, infra, schema, tests, deploy | The matrix below |
|
|
43
|
+
|
|
44
|
+
Judge by **who reads the answer and what they will do with it** — not by matching
|
|
45
|
+
words. "Esse erro" from a shop owner is a mistake they made with a customer;
|
|
46
|
+
"esse erro" from a developer is a stack trace. Same word, opposite routes.
|
|
47
|
+
|
|
48
|
+
When the reader is someone who decides:
|
|
49
|
+
|
|
50
|
+
| What they want | Skill |
|
|
51
|
+
|----------------|-------|
|
|
52
|
+
| Answer this review, customer, complaint, e-mail | `negocio-atendimento` |
|
|
53
|
+
| How much to charge / discount / price increase | `negocio-preco` |
|
|
54
|
+
| Where this customer is in the decision | `negocio-qualificacao` |
|
|
55
|
+
| Instructions for an agent that talks to customers | `negocio-agente-conversa` |
|
|
56
|
+
| Anything else about the business or their own life | the matching skill from the installed business pack, if any |
|
|
57
|
+
| *(any of the above)* | **always** `negocio-linguagem` alongside it |
|
|
58
|
+
|
|
59
|
+
When a request spans two skills, load both and answer once. Do not produce two answers.
|
|
60
|
+
|
|
61
|
+
If it is genuinely unclear who is reading, **ask one short question** — do not
|
|
62
|
+
guess and do not answer in both registers.
|
|
63
|
+
|
|
64
|
+
**Never announce the routing to a business reader.** The "🤖 Applying `@agent`…"
|
|
65
|
+
convention in §4 below is for someone who builds. To someone who decides,
|
|
66
|
+
*"I'll consult the language and decision skills"* is internal vocabulary leaking
|
|
67
|
+
— the exact defect `negocio-linguagem` forbids. Open with the answer itself.
|
|
68
|
+
|
|
69
|
+
---
|
|
70
|
+
|
|
71
|
+
**Use this matrix to automatically select agents:**
|
|
72
|
+
|
|
73
|
+
| User Intent | Keywords | Selected Agent(s) | Min Model Tier | Auto-invoke? |
|
|
74
|
+
| ------------------- | ------------------------------------------ | ------------------------------------------- | -------------- | ------------ |
|
|
75
|
+
| **Authentication** | "login", "auth", "signup", "password" | `backend-specialist` (consult auditor on PR)| Fast/Sonnet | ✅ YES |
|
|
76
|
+
| **UI Component** | "button", "card", "layout", "style" | `frontend-specialist` | Fast/Flash | ✅ YES |
|
|
77
|
+
| **Mobile UI** | "screen", "navigation", "touch", "gesture" | `mobile-developer` | Fast/Flash | ✅ YES |
|
|
78
|
+
| **API Endpoint** | "endpoint", "route", "API", "POST", "GET" | `backend-specialist` | Fast/Sonnet | ✅ YES |
|
|
79
|
+
| **Database** | "schema", "migration", "query", "table" | `database-architect` | Fast/Sonnet | ✅ YES |
|
|
80
|
+
| **Bug Fix** | "error", "bug", "not working", "broken" | `debugger` | Sonnet | ✅ YES |
|
|
81
|
+
| **Test** | "test", "coverage", "unit", "e2e" | `test-engineer` | Fast/Flash | ✅ YES |
|
|
82
|
+
| **Deployment** | "deploy", "production", "CI/CD", "docker" | `devops-engineer` | Fast/Sonnet | ✅ YES |
|
|
83
|
+
| **Security Review** | "security", "vulnerability", "exploit" | `security-auditor` | Sonnet | ✅ YES |
|
|
84
|
+
| **Performance** | "slow", "optimize", "performance", "speed" | `performance-optimizer` | Sonnet | ✅ YES |
|
|
85
|
+
| **Product Def** | "requirements", "user story", "backlog" | `product-owner` | Fast/Haiku | ✅ YES |
|
|
86
|
+
| **New Feature** | "build", "create", "implement", "new app" | `orchestrator` → multi-agent | Plan Tier | ⚠️ ASK FIRST |
|
|
87
|
+
| **Feature delivery (phased)** | "entregar feature", "fluxo completo", demanda com fases, DEM-* engenharia | Load `entrega-com-agentes` → `orchestrator` ou flagship plan + `dispatch_handoff` | Plan Tier | ✅ YES when process documented |
|
|
88
|
+
| **Complex Task** | Multiple domains detected | `orchestrator` → multi-agent | Plan Tier | ⚠️ ASK FIRST |
|
|
89
|
+
| **Complex + Bridge** | Complex task + `zenkit-bridge` MCP | MCP `plan (Claude)` then `execute (Cursor)` | Plan Tier | ✅ YES when bridge on |
|
|
90
|
+
| **Delegate to another CLI** | "pass to composer/cursor", "claude -p", "codex exec" | `provider-orchestration` + matching `*-exec` | CLI Default | ✅ YES |
|
|
91
|
+
| **Project architecture** | "ADR", "trade-off", "arquitetura do produto", "decisão arquitetural" | Load `architecture`; `orchestrator` or `backend-specialist` | Plan Tier | ✅ YES |
|
|
92
|
+
| **System design interview** | "system design", "entrevista de system design", "mock interview", "design a URL shortener" | Load `system-design-interview` (+ `architecture` só se virar projeto real) | Sonnet | ✅ YES |
|
|
93
|
+
| **Physical actuation** | "light", "switch", "lock", "gate", "HVAC", "smart home", "set_power", "Tuya", real device | `backend-specialist` + `mcp-atuacao`, `mcp-builder` | Sonnet | ⚠️ HUMAN IN LOOP |
|
|
94
|
+
|
|
95
|
+
Same-runtime subagents (`Task`, native Agent tool) are **not** another provider — that is `coordinator-mode`. Another provider is another **binary** on the machine, with the buyer's own key.
|
|
96
|
+
|
|
97
|
+
### Cross-IDE bridge (Claude Code ↔ Cursor)
|
|
98
|
+
|
|
99
|
+
When `ZENKIT_BRIDGE_ENABLED` is not `false` and MCP `zenkit-bridge` is connected:
|
|
100
|
+
|
|
101
|
+
1. Call tool `classify_and_route` with the user message.
|
|
102
|
+
2. If `action === "plan"` → `plan (Claude)` (use `modelHint`: opus / sonnet / haiku from result).
|
|
103
|
+
3. If `action === "execute"` → `execute (Cursor SDK)` (requires `CURSOR_API_KEY`).
|
|
104
|
+
4. If `action === "local_only"` or `"question"` → route to specialist agents as usual.
|
|
105
|
+
|
|
106
|
+
> The bridge's cheap tier obeys the house cost cap: ≤ $2 per 1M tokens (in+out,
|
|
107
|
+
> models.dev). Haiku (~$6) is not cheap — the cheap executor default is
|
|
108
|
+
> `opencode-go-exec` (`opencode-go/deepseek-v4-flash`). See `model-routing.mdc`.
|
|
109
|
+
|
|
110
|
+
See rule [cross-ide-bridge.mdc](../../rules/cross-ide-bridge.mdc) and [packages/zenkit-bridge/README.md](../../../packages/zenkit-bridge/README.md) (from repo root).
|
|
111
|
+
|
|
112
|
+
## Load on demand
|
|
113
|
+
|
|
114
|
+
Read only the file that matches the task:
|
|
115
|
+
|
|
116
|
+
- [TIER 0 - Automatic Analysis (ALWAYS ACTIVE)](references/tier-0-automatic-analysis-always-active.md)
|
|
117
|
+
- [4. Response Format](references/4-response-format.md)
|
|
118
|
+
- [Domain Detection Rules](references/domain-detection-rules.md)
|
|
119
|
+
- [Complexity Assessment](references/complexity-assessment.md)
|
|
120
|
+
- [Implementation Rules](references/implementation-rules.md)
|
|
121
|
+
- [Edge Cases](references/edge-cases.md)
|
|
122
|
+
- [Integration with Existing Workflows](references/integration-with-existing-workflows.md)
|
|
123
|
+
- [Testing the System](references/testing-the-system.md)
|
|
124
|
+
- [Performance Considerations](references/performance-considerations.md)
|
|
125
|
+
- [User Education](references/user-education.md)
|
|
126
|
+
- [Debugging Agent Selection](references/debugging-agent-selection.md)
|
|
127
|
+
- [DEBUG: Intelligent Routing](references/debug-intelligent-routing.md)
|
|
128
|
+
- [Summary](references/summary.md)
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
## 4. Response Format
|
|
2
|
+
|
|
3
|
+
**When auto-selecting an agent, inform the user concisely:**
|
|
4
|
+
|
|
5
|
+
```markdown
|
|
6
|
+
🤖 **Applying knowledge of `@security-auditor` + `@backend-specialist`...**
|
|
7
|
+
|
|
8
|
+
[Proceed with specialized response]
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
**Benefits:**
|
|
12
|
+
|
|
13
|
+
- ✅ User sees which expertise is being applied
|
|
14
|
+
- ✅ Transparent decision-making
|
|
15
|
+
- ✅ Still automatic (no /commands needed)
|
|
16
|
+
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
## Complexity Assessment
|
|
2
|
+
|
|
3
|
+
### SIMPLE (Direct agent invocation)
|
|
4
|
+
|
|
5
|
+
- Single file edit
|
|
6
|
+
- Clear, specific task
|
|
7
|
+
- One domain only
|
|
8
|
+
- Example: "Fix the login button style"
|
|
9
|
+
|
|
10
|
+
**Action**: Auto-invoke respective agent
|
|
11
|
+
|
|
12
|
+
### MODERATE (2-3 agents)
|
|
13
|
+
|
|
14
|
+
- 2-3 files affected
|
|
15
|
+
- Clear requirements
|
|
16
|
+
- 2 domains max
|
|
17
|
+
- Example: "Add API endpoint for user profile"
|
|
18
|
+
|
|
19
|
+
**Action**: Auto-invoke relevant agents sequentially
|
|
20
|
+
|
|
21
|
+
### COMPLEX (Orchestrator required)
|
|
22
|
+
|
|
23
|
+
- Multiple files/domains
|
|
24
|
+
- Architectural decisions needed
|
|
25
|
+
- Unclear requirements
|
|
26
|
+
- Example: "Build a social media app"
|
|
27
|
+
|
|
28
|
+
**Action**: Auto-invoke `orchestrator` → will ask Socratic questions
|
|
29
|
+
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
## Domain Detection Rules
|
|
2
|
+
|
|
3
|
+
### Single-Domain Tasks (Auto-invoke Single Agent)
|
|
4
|
+
|
|
5
|
+
| Domain | Patterns | Agent |
|
|
6
|
+
| --------------- | ------------------------------------------ | ----------------------- |
|
|
7
|
+
| **Security** | auth, login, jwt, password, hash, token | `security-auditor` |
|
|
8
|
+
| **Frontend** | component, react, vue, css, html, tailwind | `frontend-specialist` |
|
|
9
|
+
| **Backend** | api, server, express, fastapi, node | `backend-specialist` |
|
|
10
|
+
| **Mobile** | react native, flutter, ios, android, expo | `mobile-developer` |
|
|
11
|
+
| **Database** | prisma, sql, mongodb, schema, migration | `database-architect` |
|
|
12
|
+
| **Testing** | test, jest, vitest, playwright, cypress | `test-engineer` |
|
|
13
|
+
| **DevOps** | docker, kubernetes, ci/cd, pm2, nginx | `devops-engineer` |
|
|
14
|
+
| **Debug** | error, bug, crash, not working, issue | `debugger` |
|
|
15
|
+
| **Performance** | slow, lag, optimize, cache, performance | `performance-optimizer` |
|
|
16
|
+
| **SEO** | seo, meta, analytics, sitemap, robots | `seo-specialist` |
|
|
17
|
+
| **Game** | unity, godot, phaser, game, multiplayer | `game-developer` |
|
|
18
|
+
|
|
19
|
+
### Multi-Domain Tasks (Auto-invoke Orchestrator)
|
|
20
|
+
|
|
21
|
+
If request matches **2+ domains from different categories**, automatically use `orchestrator`:
|
|
22
|
+
|
|
23
|
+
```text
|
|
24
|
+
Example: "Create a secure login system with dark mode UI"
|
|
25
|
+
→ Detected: Security + Frontend
|
|
26
|
+
→ Auto-invoke: orchestrator
|
|
27
|
+
→ Orchestrator will handle: security-auditor, frontend-specialist, test-engineer
|
|
28
|
+
```
|
|
29
|
+
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
## Edge Cases
|
|
2
|
+
|
|
3
|
+
### Case 1: Generic Question
|
|
4
|
+
|
|
5
|
+
```text
|
|
6
|
+
User: "How does React work?"
|
|
7
|
+
→ Type: QUESTION
|
|
8
|
+
→ No agent needed
|
|
9
|
+
→ Respond directly with explanation
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
### Case 2: Extremely Vague Request
|
|
13
|
+
|
|
14
|
+
```text
|
|
15
|
+
User: "Make it better"
|
|
16
|
+
→ Complexity: UNCLEAR
|
|
17
|
+
→ Action: Ask clarifying questions first
|
|
18
|
+
→ Then route to appropriate agent
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
### Case 3: Contradictory Patterns
|
|
22
|
+
|
|
23
|
+
```text
|
|
24
|
+
User: "Add mobile support to the web app"
|
|
25
|
+
→ Conflict: mobile vs web
|
|
26
|
+
→ Action: Ask: "Do you want responsive web or native mobile app?"
|
|
27
|
+
→ Then route accordingly
|
|
28
|
+
```
|
|
29
|
+
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
## Implementation Rules
|
|
2
|
+
|
|
3
|
+
### Rule 1: Silent Analysis
|
|
4
|
+
|
|
5
|
+
#### DO NOT announce "I'm analyzing your request..."
|
|
6
|
+
|
|
7
|
+
- ✅ Analyze silently
|
|
8
|
+
- ✅ Inform which agent is being applied
|
|
9
|
+
- ❌ Avoid verbose meta-commentary
|
|
10
|
+
|
|
11
|
+
### Rule 2: Inform Agent Selection
|
|
12
|
+
|
|
13
|
+
**DO inform which expertise is being applied:**
|
|
14
|
+
|
|
15
|
+
```markdown
|
|
16
|
+
🤖 **Applying knowledge of `@frontend-specialist`...**
|
|
17
|
+
|
|
18
|
+
I will create the component with the following characteristics:
|
|
19
|
+
[Continue with specialized response]
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
### Rule 3: Seamless Experience
|
|
23
|
+
|
|
24
|
+
**The user should not notice a difference from talking to the right specialist directly.**
|
|
25
|
+
|
|
26
|
+
### Rule 4: Override Capability
|
|
27
|
+
|
|
28
|
+
**User can still explicitly mention agents:**
|
|
29
|
+
|
|
30
|
+
```text
|
|
31
|
+
User: "Use @backend-specialist to review this"
|
|
32
|
+
→ Override auto-selection
|
|
33
|
+
→ Use explicitly mentioned agent
|
|
34
|
+
```
|
|
35
|
+
|