@zenrick/zenkit 0.0.0-stage → 0.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +19 -0
- package/.cursor-plugin/marketplace.json +22 -0
- package/INSTALL.md +73 -0
- package/LICENSE +202 -0
- package/NOTICE +5 -0
- package/README.md +69 -3
- package/TERMS.md +48 -0
- package/THIRD-PARTY-NOTICES.md +109 -0
- package/kit/agents/backend-specialist.md +263 -0
- package/kit/agents/code-archaeologist.md +106 -0
- package/kit/agents/database-architect.md +226 -0
- package/kit/agents/debugger.md +226 -0
- package/kit/agents/devops-engineer.md +242 -0
- package/kit/agents/documentation-writer.md +104 -0
- package/kit/agents/explorer-agent.md +73 -0
- package/kit/agents/frontend-specialist.md +593 -0
- package/kit/agents/game-developer.md +162 -0
- package/kit/agents/mobile-developer.md +377 -0
- package/kit/agents/orchestrator.md +489 -0
- package/kit/agents/penetration-tester.md +188 -0
- package/kit/agents/performance-optimizer.md +187 -0
- package/kit/agents/product-manager.md +112 -0
- package/kit/agents/product-owner.md +95 -0
- package/kit/agents/project-planner.md +409 -0
- package/kit/agents/qa-automation-engineer.md +103 -0
- package/kit/agents/security-auditor.md +170 -0
- package/kit/agents/seo-specialist.md +111 -0
- package/kit/agents/test-engineer.md +158 -0
- package/kit/bundles/agent-building.yaml +26 -0
- package/kit/bundles/backend-data.yaml +14 -0
- package/kit/bundles/base.yaml +10 -0
- package/kit/bundles/core.yaml +21 -0
- package/kit/bundles/kit-engenharia.yaml +8 -0
- package/kit/bundles/kit-lite.yaml +9 -0
- package/kit/bundles/security.yaml +11 -0
- package/kit/bundles/ship-run.yaml +16 -0
- package/kit/bundles/web-ui.yaml +18 -0
- package/kit/commands/docs.md +33 -0
- package/kit/commands/explain.md +41 -0
- package/kit/commands/fix.md +65 -0
- package/kit/commands/implement.md +35 -0
- package/kit/commands/refactor.md +59 -0
- package/kit/commands/review.md +55 -0
- package/kit/commands/test.md +63 -0
- package/kit/modules/bridge/rules/cross-ide-bridge.mdc +73 -0
- package/kit/modules/bridge/zenkit-layer.yaml +1 -0
- package/kit/modules/nexuscore/sections/convivencia.md +12 -0
- package/kit/modules/nexuscore/sections/memoria.md +9 -0
- package/kit/modules/nexuscore/skills/quadro-agentes/SKILL.md +186 -0
- package/kit/modules/nexuscore/zenkit-layer.yaml +1 -0
- package/kit/rules/ZENKIT.mdc +294 -0
- package/kit/rules/git.mdc +51 -0
- package/kit/rules/karpathy-guidelines.mdc +70 -0
- package/kit/rules/model-routing.mdc +89 -0
- package/kit/rules/security-headers.mdc +41 -0
- package/kit/rules/social-automation.mdc +69 -0
- package/kit/rules/toc.mdc +40 -0
- package/kit/skills/api-patterns/SKILL.md +95 -0
- package/kit/skills/api-patterns/api-style.md +42 -0
- package/kit/skills/api-patterns/auth.md +24 -0
- package/kit/skills/api-patterns/documentation.md +26 -0
- package/kit/skills/api-patterns/graphql.md +41 -0
- package/kit/skills/api-patterns/rate-limiting.md +31 -0
- package/kit/skills/api-patterns/references/backend/backend-api-design.md +495 -0
- package/kit/skills/api-patterns/references/backend/backend-architecture.md +454 -0
- package/kit/skills/api-patterns/references/backend/backend-authentication.md +338 -0
- package/kit/skills/api-patterns/references/backend/backend-code-quality.md +659 -0
- package/kit/skills/api-patterns/references/backend/backend-debugging.md +904 -0
- package/kit/skills/api-patterns/references/backend/backend-devops.md +494 -0
- package/kit/skills/api-patterns/references/backend/backend-mindset.md +387 -0
- package/kit/skills/api-patterns/references/backend/backend-performance.md +397 -0
- package/kit/skills/api-patterns/references/backend/backend-security.md +290 -0
- package/kit/skills/api-patterns/references/backend/backend-technologies.md +256 -0
- package/kit/skills/api-patterns/references/backend/backend-testing.md +429 -0
- package/kit/skills/api-patterns/response.md +37 -0
- package/kit/skills/api-patterns/rest.md +40 -0
- package/kit/skills/api-patterns/scripts/api_validator.py +211 -0
- package/kit/skills/api-patterns/security-testing.md +122 -0
- package/kit/skills/api-patterns/trpc.md +41 -0
- package/kit/skills/api-patterns/versioning.md +22 -0
- package/kit/skills/app-builder/SKILL.md +76 -0
- package/kit/skills/app-builder/agent-coordination.md +71 -0
- package/kit/skills/app-builder/feature-building.md +53 -0
- package/kit/skills/app-builder/project-detection.md +34 -0
- package/kit/skills/app-builder/scaffolding.md +118 -0
- package/kit/skills/app-builder/tech-stack.md +41 -0
- package/kit/skills/app-builder/templates/SKILL.md +39 -0
- package/kit/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -0
- package/kit/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -0
- package/kit/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -0
- package/kit/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -0
- package/kit/skills/app-builder/templates/express-api/TEMPLATE.md +83 -0
- package/kit/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -0
- package/kit/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -0
- package/kit/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +122 -0
- package/kit/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +122 -0
- package/kit/skills/app-builder/templates/nextjs-static/TEMPLATE.md +169 -0
- package/kit/skills/app-builder/templates/nuxt-app/TEMPLATE.md +134 -0
- package/kit/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -0
- package/kit/skills/app-builder/templates/react-native-app/TEMPLATE.md +119 -0
- package/kit/skills/architecture/SKILL.md +56 -0
- package/kit/skills/architecture/context-discovery.md +43 -0
- package/kit/skills/architecture/examples.md +94 -0
- package/kit/skills/architecture/pattern-selection.md +68 -0
- package/kit/skills/architecture/patterns-reference.md +50 -0
- package/kit/skills/architecture/trade-off-analysis.md +77 -0
- package/kit/skills/bash-linux/SKILL.md +203 -0
- package/kit/skills/batch-operations/SKILL.md +112 -0
- package/kit/skills/behavioral-modes/SKILL.md +255 -0
- package/kit/skills/brainstorming/SKILL.md +189 -0
- package/kit/skills/brainstorming/dynamic-questioning.md +350 -0
- package/kit/skills/brainstorming/references/problem-solving/attribution.md +69 -0
- package/kit/skills/brainstorming/references/problem-solving/collision-zone-thinking.md +79 -0
- package/kit/skills/brainstorming/references/problem-solving/inversion-exercise.md +91 -0
- package/kit/skills/brainstorming/references/problem-solving/meta-pattern-recognition.md +87 -0
- package/kit/skills/brainstorming/references/problem-solving/scale-game.md +95 -0
- package/kit/skills/brainstorming/references/problem-solving/simplification-cascades.md +80 -0
- package/kit/skills/brainstorming/references/problem-solving/when-stuck.md +72 -0
- package/kit/skills/claude-exec/SKILL.md +185 -0
- package/kit/skills/clean-code/SKILL.md +210 -0
- package/kit/skills/code-review-checklist/SKILL.md +115 -0
- package/kit/skills/code-review-graph/SKILL.md +50 -0
- package/kit/skills/code-review-graph/references/alternatives-comparison.md +12 -0
- package/kit/skills/code-review-graph/references/best-practices.md +9 -0
- package/kit/skills/code-review-graph/references/configuration.md +43 -0
- package/kit/skills/code-review-graph/references/core-workflows.md +61 -0
- package/kit/skills/code-review-graph/references/how-it-works-4-layers.md +20 -0
- package/kit/skills/code-review-graph/references/installation.md +67 -0
- package/kit/skills/code-review-graph/references/integration-with-zenkit.md +23 -0
- package/kit/skills/code-review-graph/references/known-limitations.md +13 -0
- package/kit/skills/code-review-graph/references/when-to-use-vs-when-to-skip.md +21 -0
- package/kit/skills/codex-exec/SKILL.md +161 -0
- package/kit/skills/context-compression/SKILL.md +145 -0
- package/kit/skills/coordinator-mode/SKILL.md +215 -0
- package/kit/skills/cursor-exec/SKILL.md +152 -0
- package/kit/skills/database-design/SKILL.md +53 -0
- package/kit/skills/database-design/database-selection.md +43 -0
- package/kit/skills/database-design/indexing.md +39 -0
- package/kit/skills/database-design/migrations.md +48 -0
- package/kit/skills/database-design/optimization.md +36 -0
- package/kit/skills/database-design/orm-selection.md +30 -0
- package/kit/skills/database-design/schema-design.md +56 -0
- package/kit/skills/database-design/scripts/schema_validator.py +172 -0
- package/kit/skills/deployment-procedures/SKILL.md +242 -0
- package/kit/skills/deprecation-and-migration/SKILL.md +149 -0
- package/kit/skills/documentation-templates/SKILL.md +195 -0
- package/kit/skills/entrega-com-agentes/SKILL.md +177 -0
- package/kit/skills/frontend-design/NOTICE.md +6 -0
- package/kit/skills/frontend-design/SKILL.md +456 -0
- package/kit/skills/frontend-design/animation-guide.md +331 -0
- package/kit/skills/frontend-design/color-system.md +311 -0
- package/kit/skills/frontend-design/decision-trees.md +418 -0
- package/kit/skills/frontend-design/motion-graphics.md +306 -0
- package/kit/skills/frontend-design/references/aesthetic/design-guideline-template.md +163 -0
- package/kit/skills/frontend-design/references/aesthetic/design-principles.md +62 -0
- package/kit/skills/frontend-design/references/aesthetic/design-resources.md +75 -0
- package/kit/skills/frontend-design/references/aesthetic/design-story-template.md +135 -0
- package/kit/skills/frontend-design/references/aesthetic/micro-interactions.md +53 -0
- package/kit/skills/frontend-design/references/aesthetic/storytelling-design.md +50 -0
- package/kit/skills/frontend-design/scripts/accessibility_checker.py +183 -0
- package/kit/skills/frontend-design/scripts/ux_audit.py +722 -0
- package/kit/skills/frontend-design/typography-system.md +345 -0
- package/kit/skills/frontend-design/ux-psychology.md +1116 -0
- package/kit/skills/frontend-design/visual-effects.md +383 -0
- package/kit/skills/game-development/2d-games/SKILL.md +119 -0
- package/kit/skills/game-development/3d-games/SKILL.md +135 -0
- package/kit/skills/game-development/SKILL.md +168 -0
- package/kit/skills/game-development/game-art/SKILL.md +185 -0
- package/kit/skills/game-development/game-audio/SKILL.md +190 -0
- package/kit/skills/game-development/game-design/SKILL.md +129 -0
- package/kit/skills/game-development/mobile-games/SKILL.md +108 -0
- package/kit/skills/game-development/multiplayer/SKILL.md +132 -0
- package/kit/skills/game-development/pc-games/SKILL.md +144 -0
- package/kit/skills/game-development/vr-ar/SKILL.md +123 -0
- package/kit/skills/game-development/web-games/SKILL.md +150 -0
- package/kit/skills/gemini-exec/SKILL.md +80 -0
- package/kit/skills/geo-fundamentals/SKILL.md +157 -0
- package/kit/skills/geo-fundamentals/scripts/geo_checker.py +289 -0
- package/kit/skills/git-worktrees/SKILL.md +107 -0
- package/kit/skills/i18n-localization/SKILL.md +145 -0
- package/kit/skills/i18n-localization/scripts/i18n_checker.py +241 -0
- package/kit/skills/intelligent-routing/SKILL.md +128 -0
- package/kit/skills/intelligent-routing/references/4-response-format.md +16 -0
- package/kit/skills/intelligent-routing/references/complexity-assessment.md +29 -0
- package/kit/skills/intelligent-routing/references/debug-intelligent-routing.md +9 -0
- package/kit/skills/intelligent-routing/references/debugging-agent-selection.md +7 -0
- package/kit/skills/intelligent-routing/references/domain-detection-rules.md +29 -0
- package/kit/skills/intelligent-routing/references/edge-cases.md +29 -0
- package/kit/skills/intelligent-routing/references/implementation-rules.md +35 -0
- package/kit/skills/intelligent-routing/references/integration-with-existing-workflows.md +21 -0
- package/kit/skills/intelligent-routing/references/performance-considerations.md +14 -0
- package/kit/skills/intelligent-routing/references/summary.md +16 -0
- package/kit/skills/intelligent-routing/references/testing-the-system.md +36 -0
- package/kit/skills/intelligent-routing/references/tier-0-automatic-analysis-always-active.md +27 -0
- package/kit/skills/intelligent-routing/references/user-education.md +12 -0
- package/kit/skills/karpathy-guidelines/SKILL.md +67 -0
- package/kit/skills/karpathy-guidelines/references/EXAMPLES.md +522 -0
- package/kit/skills/lint-and-validate/SKILL.md +46 -0
- package/kit/skills/lint-and-validate/scripts/lint_runner.py +184 -0
- package/kit/skills/lint-and-validate/scripts/type_coverage.py +173 -0
- package/kit/skills/mcp-atuacao/SKILL.md +238 -0
- package/kit/skills/mcp-builder/NOTICE.md +6 -0
- package/kit/skills/mcp-builder/SKILL.md +259 -0
- package/kit/skills/memory-system/SKILL.md +181 -0
- package/kit/skills/mobile-design/SKILL.md +395 -0
- package/kit/skills/mobile-design/decision-trees.md +516 -0
- package/kit/skills/mobile-design/mobile-backend.md +491 -0
- package/kit/skills/mobile-design/mobile-color-system.md +420 -0
- package/kit/skills/mobile-design/mobile-debugging.md +122 -0
- package/kit/skills/mobile-design/mobile-design-thinking.md +357 -0
- package/kit/skills/mobile-design/mobile-navigation.md +458 -0
- package/kit/skills/mobile-design/mobile-performance.md +767 -0
- package/kit/skills/mobile-design/mobile-testing.md +356 -0
- package/kit/skills/mobile-design/mobile-typography.md +433 -0
- package/kit/skills/mobile-design/platform-android.md +666 -0
- package/kit/skills/mobile-design/platform-ios.md +561 -0
- package/kit/skills/mobile-design/scripts/mobile_audit.py +670 -0
- package/kit/skills/mobile-design/touch-psychology.md +537 -0
- package/kit/skills/negocio-agente-conversa/SKILL.md +168 -0
- package/kit/skills/negocio-atendimento/SKILL.md +134 -0
- package/kit/skills/negocio-linguagem/SKILL.md +166 -0
- package/kit/skills/negocio-preco/SKILL.md +174 -0
- package/kit/skills/negocio-preco/scripts/preco.mjs +160 -0
- package/kit/skills/negocio-qualificacao/SKILL.md +140 -0
- package/kit/skills/nextjs-react-expert/1-async-eliminating-waterfalls.md +351 -0
- package/kit/skills/nextjs-react-expert/2-bundle-bundle-size-optimization.md +240 -0
- package/kit/skills/nextjs-react-expert/3-server-server-side-performance.md +490 -0
- package/kit/skills/nextjs-react-expert/4-client-client-side-data-fetching.md +264 -0
- package/kit/skills/nextjs-react-expert/5-rerender-re-render-optimization.md +581 -0
- package/kit/skills/nextjs-react-expert/6-rendering-rendering-performance.md +432 -0
- package/kit/skills/nextjs-react-expert/7-js-javascript-performance.md +684 -0
- package/kit/skills/nextjs-react-expert/8-advanced-advanced-patterns.md +150 -0
- package/kit/skills/nextjs-react-expert/9-cache-components.md +103 -0
- package/kit/skills/nextjs-react-expert/SKILL.md +308 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/common-patterns.md +331 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/complete-examples.md +872 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/component-patterns.md +502 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/data-fetching.md +767 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/file-organization.md +502 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/loading-and-error-states.md +501 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/performance.md +406 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/routing-guide.md +364 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/styling-guide.md +428 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/typescript-standards.md +418 -0
- package/kit/skills/nextjs-react-expert/scripts/convert_rules.py +222 -0
- package/kit/skills/nextjs-react-expert/scripts/react_performance_checker.py +252 -0
- package/kit/skills/nodejs-best-practices/SKILL.md +78 -0
- package/kit/skills/nodejs-best-practices/references/10-anti-patterns-to-avoid.md +21 -0
- package/kit/skills/nodejs-best-practices/references/11-decision-checklist.md +14 -0
- package/kit/skills/nodejs-best-practices/references/2-runtime-considerations-2025.md +36 -0
- package/kit/skills/nodejs-best-practices/references/3-architecture-principles.md +35 -0
- package/kit/skills/nodejs-best-practices/references/4-error-handling-principles.md +42 -0
- package/kit/skills/nodejs-best-practices/references/5-async-patterns-principles.md +35 -0
- package/kit/skills/nodejs-best-practices/references/6-validation-principles.md +29 -0
- package/kit/skills/nodejs-best-practices/references/7-security-principles.md +29 -0
- package/kit/skills/nodejs-best-practices/references/8-testing-principles.md +28 -0
- package/kit/skills/observability-and-instrumentation/SKILL.md +150 -0
- package/kit/skills/opencode-go-exec/SKILL.md +101 -0
- package/kit/skills/parallel-agents/SKILL.md +184 -0
- package/kit/skills/performance-profiling/SKILL.md +145 -0
- package/kit/skills/performance-profiling/scripts/lighthouse_audit.py +76 -0
- package/kit/skills/plan-writing/SKILL.md +213 -0
- package/kit/skills/powershell-windows/SKILL.md +196 -0
- package/kit/skills/provider-orchestration/SKILL.md +269 -0
- package/kit/skills/python-patterns/SKILL.md +80 -0
- package/kit/skills/python-patterns/references/10-decision-checklist.md +14 -0
- package/kit/skills/python-patterns/references/11-anti-patterns-to-avoid.md +20 -0
- package/kit/skills/python-patterns/references/2-async-vs-sync-decision.md +44 -0
- package/kit/skills/python-patterns/references/3-type-hints-strategy.md +56 -0
- package/kit/skills/python-patterns/references/4-project-structure-principles.md +56 -0
- package/kit/skills/python-patterns/references/5-django-principles-2025.md +40 -0
- package/kit/skills/python-patterns/references/6-fastapi-principles.md +50 -0
- package/kit/skills/python-patterns/references/7-background-tasks.md +31 -0
- package/kit/skills/python-patterns/references/8-error-handling-principles.md +29 -0
- package/kit/skills/python-patterns/references/9-testing-principles.md +37 -0
- package/kit/skills/red-team-tactics/SKILL.md +201 -0
- package/kit/skills/research/SKILL.md +166 -0
- package/kit/skills/rust-pro/SKILL.md +177 -0
- package/kit/skills/seo-fundamentals/SKILL.md +130 -0
- package/kit/skills/seo-fundamentals/scripts/seo_checker.py +219 -0
- package/kit/skills/sequential-thinking/.env.example +8 -0
- package/kit/skills/sequential-thinking/README.md +183 -0
- package/kit/skills/sequential-thinking/SKILL.md +95 -0
- package/kit/skills/sequential-thinking/package.json +31 -0
- package/kit/skills/sequential-thinking/references/advanced-strategies.md +79 -0
- package/kit/skills/sequential-thinking/references/advanced-techniques.md +76 -0
- package/kit/skills/sequential-thinking/references/core-patterns.md +95 -0
- package/kit/skills/sequential-thinking/references/examples-api.md +88 -0
- package/kit/skills/sequential-thinking/references/examples-architecture.md +94 -0
- package/kit/skills/sequential-thinking/references/examples-debug.md +90 -0
- package/kit/skills/sequential-thinking/scripts/format-thought.js +159 -0
- package/kit/skills/sequential-thinking/scripts/process-thought.js +236 -0
- package/kit/skills/server-management/SKILL.md +162 -0
- package/kit/skills/simplify-code/SKILL.md +133 -0
- package/kit/skills/skillify/SKILL.md +116 -0
- package/kit/skills/system-design-interview/SKILL.md +268 -0
- package/kit/skills/systematic-debugging/SKILL.md +110 -0
- package/kit/skills/tailwind-patterns/SKILL.md +283 -0
- package/kit/skills/tailwind-patterns/references/shadcn-ui/canvas-design-system.md +320 -0
- package/kit/skills/tailwind-patterns/references/shadcn-ui/shadcn-accessibility.md +471 -0
- package/kit/skills/tailwind-patterns/references/shadcn-ui/shadcn-components.md +424 -0
- package/kit/skills/tailwind-patterns/references/shadcn-ui/shadcn-theming.md +373 -0
- package/kit/skills/tailwind-patterns/references/shadcn-ui/tailwind-customization.md +483 -0
- package/kit/skills/tailwind-patterns/references/shadcn-ui/tailwind-responsive.md +382 -0
- package/kit/skills/tailwind-patterns/references/shadcn-ui/tailwind-utilities.md +455 -0
- package/kit/skills/tdd-workflow/SKILL.md +150 -0
- package/kit/skills/testing-patterns/SKILL.md +196 -0
- package/kit/skills/testing-patterns/scripts/test_runner.py +219 -0
- package/kit/skills/ui-ux-pro-max/SKILL.md +135 -0
- package/kit/skills/verify-changes/SKILL.md +125 -0
- package/kit/skills/vulnerability-scanner/SKILL.md +278 -0
- package/kit/skills/vulnerability-scanner/checklists.md +121 -0
- package/kit/skills/vulnerability-scanner/scripts/security_scan.py +458 -0
- package/kit/skills/web-design-guidelines/SKILL.md +58 -0
- package/kit/skills/webapp-testing/NOTICE.md +6 -0
- package/kit/skills/webapp-testing/SKILL.md +188 -0
- package/kit/skills/webapp-testing/scripts/playwright_runner.py +173 -0
- package/kit/workflows/brainstorm.md +113 -0
- package/kit/workflows/coordinate.md +72 -0
- package/kit/workflows/create.md +59 -0
- package/kit/workflows/debug.md +103 -0
- package/kit/workflows/deploy.md +176 -0
- package/kit/workflows/enhance.md +63 -0
- package/kit/workflows/orchestrate.md +237 -0
- package/kit/workflows/plan.md +89 -0
- package/kit/workflows/preview.md +81 -0
- package/kit/workflows/remember.md +67 -0
- package/kit/workflows/status.md +86 -0
- package/kit/workflows/test.md +144 -0
- package/kit/workflows/ui-ux-pro-max.md +296 -0
- package/kit/workflows/verify.md +72 -0
- package/licenses/Apache-2.0.txt +202 -0
- package/package.json +60 -6
- package/scripts/avaliar-vigilancia-mandato.mjs +38 -0
- package/scripts/bundle.mjs +158 -0
- package/scripts/check-deps.mjs +178 -0
- package/scripts/check-models.mjs +150 -0
- package/scripts/cli.mjs +295 -0
- package/scripts/continuidade-mandato.mjs +47 -0
- package/scripts/discriminar-turno.mjs +191 -0
- package/scripts/doctor.mjs +615 -0
- package/scripts/generate.mjs +676 -0
- package/scripts/install.mjs +11 -0
- package/scripts/layer-remote.mjs +344 -0
- package/scripts/layers.mjs +208 -0
- package/scripts/marketplace.mjs +77 -0
- package/scripts/product.mjs +32 -0
- package/scripts/ruleset-core.mjs +68 -0
- package/scripts/social-hooks.mjs +293 -0
- package/scripts/social-pacer.mjs +219 -0
- package/scripts/validate-bundles.mjs +14 -0
- package/scripts/validate-skills.mjs +174 -0
- package/scripts/zenkit-daemon-task.cmd +3 -0
|
@@ -0,0 +1,111 @@
|
|
|
1
|
+
---
|
|
2
|
+
tools: Read, Grep, Glob, Bash, Write
|
|
3
|
+
skills: clean-code, seo-fundamentals, geo-fundamentals
|
|
4
|
+
name: seo-specialist
|
|
5
|
+
model: inherit
|
|
6
|
+
description: SEO and GEO (Generative Engine Optimization) expert. Handles SEO audits, Core Web Vitals, E-E-A-T optimization, AI search visibility. Use for SEO improvements, content optimization, or AI citation strategies.
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# SEO Specialist
|
|
10
|
+
|
|
11
|
+
Expert in SEO and GEO (Generative Engine Optimization) for traditional and AI-powered search engines.
|
|
12
|
+
|
|
13
|
+
## Core Philosophy
|
|
14
|
+
|
|
15
|
+
> "Content for humans, structured for machines. Win both Google and ChatGPT."
|
|
16
|
+
|
|
17
|
+
## Your Mindset
|
|
18
|
+
|
|
19
|
+
- **User-first**: Content quality over tricks
|
|
20
|
+
- **Dual-target**: SEO + GEO simultaneously
|
|
21
|
+
- **Data-driven**: Measure, test, iterate
|
|
22
|
+
- **Future-proof**: AI search is growing
|
|
23
|
+
|
|
24
|
+
---
|
|
25
|
+
|
|
26
|
+
## SEO vs GEO
|
|
27
|
+
|
|
28
|
+
| Aspect | SEO | GEO |
|
|
29
|
+
|--------|-----|-----|
|
|
30
|
+
| Goal | Rank #1 in Google | Be cited in AI responses |
|
|
31
|
+
| Platform | Google, Bing | ChatGPT, Claude, Perplexity |
|
|
32
|
+
| Metrics | Rankings, CTR | Citation rate, appearances |
|
|
33
|
+
| Focus | Keywords, backlinks | Entities, data, credentials |
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
## Core Web Vitals Targets
|
|
38
|
+
|
|
39
|
+
| Metric | Good | Poor |
|
|
40
|
+
|--------|------|------|
|
|
41
|
+
| **LCP** | < 2.5s | > 4.0s |
|
|
42
|
+
| **INP** | < 200ms | > 500ms |
|
|
43
|
+
| **CLS** | < 0.1 | > 0.25 |
|
|
44
|
+
|
|
45
|
+
---
|
|
46
|
+
|
|
47
|
+
## E-E-A-T Framework
|
|
48
|
+
|
|
49
|
+
| Principle | How to Demonstrate |
|
|
50
|
+
|-----------|-------------------|
|
|
51
|
+
| **Experience** | First-hand knowledge, real stories |
|
|
52
|
+
| **Expertise** | Credentials, certifications |
|
|
53
|
+
| **Authoritativeness** | Backlinks, mentions, recognition |
|
|
54
|
+
| **Trustworthiness** | HTTPS, transparency, reviews |
|
|
55
|
+
|
|
56
|
+
---
|
|
57
|
+
|
|
58
|
+
## Technical SEO Checklist
|
|
59
|
+
|
|
60
|
+
- [ ] XML sitemap submitted
|
|
61
|
+
- [ ] robots.txt configured
|
|
62
|
+
- [ ] Canonical tags correct
|
|
63
|
+
- [ ] HTTPS enabled
|
|
64
|
+
- [ ] Mobile-friendly
|
|
65
|
+
- [ ] Core Web Vitals passing
|
|
66
|
+
- [ ] Schema markup valid
|
|
67
|
+
|
|
68
|
+
## Content SEO Checklist
|
|
69
|
+
|
|
70
|
+
- [ ] Title tags optimized (50-60 chars)
|
|
71
|
+
- [ ] Meta descriptions (150-160 chars)
|
|
72
|
+
- [ ] H1-H6 hierarchy correct
|
|
73
|
+
- [ ] Internal linking structure
|
|
74
|
+
- [ ] Image alt texts
|
|
75
|
+
|
|
76
|
+
## GEO Checklist
|
|
77
|
+
|
|
78
|
+
- [ ] FAQ sections present
|
|
79
|
+
- [ ] Author credentials visible
|
|
80
|
+
- [ ] Statistics with sources
|
|
81
|
+
- [ ] Clear definitions
|
|
82
|
+
- [ ] Expert quotes attributed
|
|
83
|
+
- [ ] "Last updated" timestamps
|
|
84
|
+
|
|
85
|
+
---
|
|
86
|
+
|
|
87
|
+
## Content That Gets Cited
|
|
88
|
+
|
|
89
|
+
| Element | Why AI Cites It |
|
|
90
|
+
|---------|-----------------|
|
|
91
|
+
| Original statistics | Unique data |
|
|
92
|
+
| Expert quotes | Authority |
|
|
93
|
+
| Clear definitions | Extractable |
|
|
94
|
+
| Step-by-step guides | Useful |
|
|
95
|
+
| Comparison tables | Structured |
|
|
96
|
+
|
|
97
|
+
---
|
|
98
|
+
|
|
99
|
+
## When You Should Be Used
|
|
100
|
+
|
|
101
|
+
- SEO audits
|
|
102
|
+
- Core Web Vitals optimization
|
|
103
|
+
- E-E-A-T improvement
|
|
104
|
+
- AI search visibility
|
|
105
|
+
- Schema markup implementation
|
|
106
|
+
- Content optimization
|
|
107
|
+
- GEO strategy
|
|
108
|
+
|
|
109
|
+
---
|
|
110
|
+
|
|
111
|
+
> **Remember:** The best SEO is great content that answers questions clearly and authoritatively.
|
|
@@ -0,0 +1,158 @@
|
|
|
1
|
+
---
|
|
2
|
+
tools: Read, Grep, Glob, Bash, Edit, Write
|
|
3
|
+
skills: clean-code, testing-patterns, tdd-workflow, webapp-testing, code-review-checklist, lint-and-validate
|
|
4
|
+
name: test-engineer
|
|
5
|
+
model: inherit
|
|
6
|
+
description: Expert in testing, TDD, and test automation. Use for writing tests, improving coverage, debugging test failures. Triggers on test, spec, coverage, jest, pytest, playwright, e2e, unit test.
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Test Engineer
|
|
10
|
+
|
|
11
|
+
Expert in test automation, TDD, and comprehensive testing strategies.
|
|
12
|
+
|
|
13
|
+
## Core Philosophy
|
|
14
|
+
|
|
15
|
+
> "Find what the developer forgot. Test behavior, not implementation."
|
|
16
|
+
|
|
17
|
+
## Your Mindset
|
|
18
|
+
|
|
19
|
+
- **Proactive**: Discover untested paths
|
|
20
|
+
- **Systematic**: Follow testing pyramid
|
|
21
|
+
- **Behavior-focused**: Test what matters to users
|
|
22
|
+
- **Quality-driven**: Coverage is a guide, not a goal
|
|
23
|
+
|
|
24
|
+
---
|
|
25
|
+
|
|
26
|
+
## Testing Pyramid
|
|
27
|
+
|
|
28
|
+
```
|
|
29
|
+
/\ E2E (Few)
|
|
30
|
+
/ \ Critical user flows
|
|
31
|
+
/----\
|
|
32
|
+
/ \ Integration (Some)
|
|
33
|
+
/--------\ API, DB, services
|
|
34
|
+
/ \
|
|
35
|
+
/------------\ Unit (Many)
|
|
36
|
+
Functions, logic
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
---
|
|
40
|
+
|
|
41
|
+
## Framework Selection
|
|
42
|
+
|
|
43
|
+
| Language | Unit | Integration | E2E |
|
|
44
|
+
|----------|------|-------------|-----|
|
|
45
|
+
| TypeScript | Vitest, Jest | Supertest | Playwright |
|
|
46
|
+
| Python | Pytest | Pytest | Playwright |
|
|
47
|
+
| React | Testing Library | MSW | Playwright |
|
|
48
|
+
|
|
49
|
+
---
|
|
50
|
+
|
|
51
|
+
## TDD Workflow
|
|
52
|
+
|
|
53
|
+
```
|
|
54
|
+
🔴 RED → Write failing test
|
|
55
|
+
🟢 GREEN → Minimal code to pass
|
|
56
|
+
🔵 REFACTOR → Improve code quality
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
---
|
|
60
|
+
|
|
61
|
+
## Test Type Selection
|
|
62
|
+
|
|
63
|
+
| Scenario | Test Type |
|
|
64
|
+
|----------|-----------|
|
|
65
|
+
| Business logic | Unit |
|
|
66
|
+
| API endpoints | Integration |
|
|
67
|
+
| User flows | E2E |
|
|
68
|
+
| Components | Component/Unit |
|
|
69
|
+
|
|
70
|
+
---
|
|
71
|
+
|
|
72
|
+
## AAA Pattern
|
|
73
|
+
|
|
74
|
+
| Step | Purpose |
|
|
75
|
+
|------|---------|
|
|
76
|
+
| **Arrange** | Set up test data |
|
|
77
|
+
| **Act** | Execute code |
|
|
78
|
+
| **Assert** | Verify outcome |
|
|
79
|
+
|
|
80
|
+
---
|
|
81
|
+
|
|
82
|
+
## Coverage Strategy
|
|
83
|
+
|
|
84
|
+
| Area | Target |
|
|
85
|
+
|------|--------|
|
|
86
|
+
| Critical paths | 100% |
|
|
87
|
+
| Business logic | 80%+ |
|
|
88
|
+
| Utilities | 70%+ |
|
|
89
|
+
| UI layout | As needed |
|
|
90
|
+
|
|
91
|
+
---
|
|
92
|
+
|
|
93
|
+
## Deep Audit Approach
|
|
94
|
+
|
|
95
|
+
### Discovery
|
|
96
|
+
|
|
97
|
+
| Target | Find |
|
|
98
|
+
|--------|------|
|
|
99
|
+
| Routes | Scan app directories |
|
|
100
|
+
| APIs | Grep HTTP methods |
|
|
101
|
+
| Components | Find UI files |
|
|
102
|
+
|
|
103
|
+
### Systematic Testing
|
|
104
|
+
|
|
105
|
+
1. Map all endpoints
|
|
106
|
+
2. Verify responses
|
|
107
|
+
3. Cover critical paths
|
|
108
|
+
|
|
109
|
+
---
|
|
110
|
+
|
|
111
|
+
## Mocking Principles
|
|
112
|
+
|
|
113
|
+
| Mock | Don't Mock |
|
|
114
|
+
|------|------------|
|
|
115
|
+
| External APIs | Code under test |
|
|
116
|
+
| Database (unit) | Simple deps |
|
|
117
|
+
| Network | Pure functions |
|
|
118
|
+
|
|
119
|
+
---
|
|
120
|
+
|
|
121
|
+
## Review Checklist
|
|
122
|
+
|
|
123
|
+
- [ ] Coverage 80%+ on critical paths
|
|
124
|
+
- [ ] AAA pattern followed
|
|
125
|
+
- [ ] Tests are isolated
|
|
126
|
+
- [ ] Descriptive naming
|
|
127
|
+
- [ ] Edge cases covered
|
|
128
|
+
- [ ] External deps mocked
|
|
129
|
+
- [ ] Cleanup after tests
|
|
130
|
+
- [ ] Fast unit tests (<100ms)
|
|
131
|
+
|
|
132
|
+
---
|
|
133
|
+
|
|
134
|
+
## Anti-Patterns
|
|
135
|
+
|
|
136
|
+
| ❌ Don't | ✅ Do |
|
|
137
|
+
|----------|-------|
|
|
138
|
+
| Test implementation | Test behavior |
|
|
139
|
+
| Multiple asserts | One per test |
|
|
140
|
+
| Dependent tests | Independent |
|
|
141
|
+
| Ignore flaky | Fix root cause |
|
|
142
|
+
| Skip cleanup | Always reset |
|
|
143
|
+
|
|
144
|
+
---
|
|
145
|
+
|
|
146
|
+
## When You Should Be Used
|
|
147
|
+
|
|
148
|
+
- Writing unit tests
|
|
149
|
+
- TDD implementation
|
|
150
|
+
- E2E test creation
|
|
151
|
+
- Improving coverage
|
|
152
|
+
- Debugging test failures
|
|
153
|
+
- Test infrastructure setup
|
|
154
|
+
- API integration tests
|
|
155
|
+
|
|
156
|
+
---
|
|
157
|
+
|
|
158
|
+
> **Remember:** Good tests are documentation. They explain what the code should do.
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
name: agent-building
|
|
2
|
+
title: Agent Building
|
|
3
|
+
description: Orquestrar CLIs do comprador. Exec é escritor/investigador; flagship só se o humano pedir.
|
|
4
|
+
audience: quem vende ou opera agentes
|
|
5
|
+
kind: building-block
|
|
6
|
+
skills:
|
|
7
|
+
- mcp-builder
|
|
8
|
+
- mcp-atuacao
|
|
9
|
+
- skillify
|
|
10
|
+
- intelligent-routing
|
|
11
|
+
- memory-system
|
|
12
|
+
- parallel-agents
|
|
13
|
+
- entrega-com-agentes
|
|
14
|
+
- coordinator-mode
|
|
15
|
+
- provider-orchestration
|
|
16
|
+
- cursor-exec
|
|
17
|
+
- claude-exec
|
|
18
|
+
- codex-exec
|
|
19
|
+
- gemini-exec
|
|
20
|
+
- behavioral-modes
|
|
21
|
+
- context-compression
|
|
22
|
+
- sequential-thinking
|
|
23
|
+
- research
|
|
24
|
+
- brainstorming
|
|
25
|
+
agents:
|
|
26
|
+
- orchestrator
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
name: backend-data
|
|
2
|
+
title: Backend & Data
|
|
3
|
+
description: API, banco, Node, Python, Rust.
|
|
4
|
+
audience: quem constrói o servidor
|
|
5
|
+
kind: building-block
|
|
6
|
+
skills:
|
|
7
|
+
- api-patterns
|
|
8
|
+
- database-design
|
|
9
|
+
- nodejs-best-practices
|
|
10
|
+
- python-patterns
|
|
11
|
+
- rust-pro
|
|
12
|
+
agents:
|
|
13
|
+
- backend-specialist
|
|
14
|
+
- database-architect
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
name: base
|
|
2
|
+
title: Base
|
|
3
|
+
description: Registro e conversa — entra em todo kit de negócio. Sem ela o resto soa como um sistema se descrevendo.
|
|
4
|
+
audience: todos os kits de negócio
|
|
5
|
+
kind: building-block
|
|
6
|
+
skills:
|
|
7
|
+
- negocio-linguagem
|
|
8
|
+
- negocio-qualificacao
|
|
9
|
+
- negocio-atendimento
|
|
10
|
+
- negocio-agente-conversa
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
name: core
|
|
2
|
+
title: Core
|
|
3
|
+
description: Planejar, verificar, isolar, revisar. Entra em todo kit de engenharia.
|
|
4
|
+
audience: quem constrói software
|
|
5
|
+
kind: building-block
|
|
6
|
+
skills:
|
|
7
|
+
- plan-writing
|
|
8
|
+
- entrega-com-agentes
|
|
9
|
+
- verify-changes
|
|
10
|
+
- systematic-debugging
|
|
11
|
+
- simplify-code
|
|
12
|
+
- clean-code
|
|
13
|
+
- tdd-workflow
|
|
14
|
+
- testing-patterns
|
|
15
|
+
- code-review-checklist
|
|
16
|
+
- code-review-graph
|
|
17
|
+
- git-worktrees
|
|
18
|
+
- lint-and-validate
|
|
19
|
+
agents:
|
|
20
|
+
- debugger
|
|
21
|
+
- explorer-agent
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
name: security
|
|
2
|
+
title: Security
|
|
3
|
+
description: Varredura e tática ofensiva de revisão — não é kit de ataque.
|
|
4
|
+
audience: quem revisa segurança de código próprio
|
|
5
|
+
kind: building-block
|
|
6
|
+
skills:
|
|
7
|
+
- vulnerability-scanner
|
|
8
|
+
- red-team-tactics
|
|
9
|
+
agents:
|
|
10
|
+
- security-auditor
|
|
11
|
+
- penetration-tester
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
name: ship-run
|
|
2
|
+
title: Ship & Run
|
|
3
|
+
description: Deploy, servidor, observabilidade, aposentar.
|
|
4
|
+
audience: quem coloca no ar e tira do ar
|
|
5
|
+
kind: building-block
|
|
6
|
+
skills:
|
|
7
|
+
- deployment-procedures
|
|
8
|
+
- server-management
|
|
9
|
+
- bash-linux
|
|
10
|
+
- powershell-windows
|
|
11
|
+
- performance-profiling
|
|
12
|
+
- observability-and-instrumentation
|
|
13
|
+
- deprecation-and-migration
|
|
14
|
+
agents:
|
|
15
|
+
- devops-engineer
|
|
16
|
+
- performance-optimizer
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
name: web-ui
|
|
2
|
+
title: Web & UI
|
|
3
|
+
description: Front, design, mobile, i18n, SEO.
|
|
4
|
+
audience: quem constrói interface
|
|
5
|
+
kind: building-block
|
|
6
|
+
skills:
|
|
7
|
+
- nextjs-react-expert
|
|
8
|
+
- tailwind-patterns
|
|
9
|
+
- frontend-design
|
|
10
|
+
- web-design-guidelines
|
|
11
|
+
- ui-ux-pro-max
|
|
12
|
+
- mobile-design
|
|
13
|
+
- i18n-localization
|
|
14
|
+
- seo-fundamentals
|
|
15
|
+
agents:
|
|
16
|
+
- frontend-specialist
|
|
17
|
+
- mobile-developer
|
|
18
|
+
- seo-specialist
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
Before answering:
|
|
2
|
+
- Follow `ZENKIT.mdc` (P0) and use `toc.mdc` to pick Skills/Rules.
|
|
3
|
+
- Read `SKILL.md` first; load only relevant sections.
|
|
4
|
+
- If nothing matches, answer normally.
|
|
5
|
+
|
|
6
|
+
## Purpose
|
|
7
|
+
You are a technical writer. Your mission is to create or update documentation that is clear, accurate, and synced with the codebase.
|
|
8
|
+
|
|
9
|
+
## Analyze
|
|
10
|
+
|
|
11
|
+
- What is the code/feature to document?
|
|
12
|
+
- What is the appropriate doc type?
|
|
13
|
+
- What is the existing documentation?
|
|
14
|
+
- What is the current codebase state?
|
|
15
|
+
- What is the outdated info?
|
|
16
|
+
|
|
17
|
+
## Principles
|
|
18
|
+
|
|
19
|
+
- Clarity: Simple language, avoid jargon
|
|
20
|
+
- Accuracy: Must match actual code behavior
|
|
21
|
+
- Examples: Real, runnable code from the codebase
|
|
22
|
+
- Structure: Headings, lists, tables for scannability
|
|
23
|
+
|
|
24
|
+
## Rules
|
|
25
|
+
|
|
26
|
+
- Always verify against current code before writing
|
|
27
|
+
- Keep concise - no fluff
|
|
28
|
+
- Update in place, don't duplicate
|
|
29
|
+
- Match existing documentation style
|
|
30
|
+
- Include type information for APIs
|
|
31
|
+
|
|
32
|
+
START: What would you like me to document?
|
|
33
|
+
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
Before answering:
|
|
2
|
+
- Follow `ZENKIT.mdc` (P0) and use `toc.mdc` to pick Skills/Rules.
|
|
3
|
+
- Read `SKILL.md` first; load only relevant sections.
|
|
4
|
+
- If nothing matches, answer normally.
|
|
5
|
+
|
|
6
|
+
You are a patient technical educator. Your job is to explain code or concepts clearly.
|
|
7
|
+
|
|
8
|
+
## EXPLANATION APPROACH
|
|
9
|
+
|
|
10
|
+
### For Code Explanations
|
|
11
|
+
|
|
12
|
+
1. Overview: What does this code do at a high level?
|
|
13
|
+
2. Breakdown: Walk through section by section
|
|
14
|
+
3. Key Concepts: Explain any patterns, techniques, or language features used
|
|
15
|
+
4. Flow: Describe the execution flow
|
|
16
|
+
5. Why: Explain design decisions if apparent
|
|
17
|
+
|
|
18
|
+
### For Concept Explanations
|
|
19
|
+
|
|
20
|
+
1. Simple Definition: One sentence explanation
|
|
21
|
+
2. Analogy: Real-world comparison
|
|
22
|
+
3. How It Works: Technical details
|
|
23
|
+
4. When To Use: Practical applications
|
|
24
|
+
5. Example: Concrete code example
|
|
25
|
+
|
|
26
|
+
## Teaching principles
|
|
27
|
+
|
|
28
|
+
- Start simple, add complexity gradually
|
|
29
|
+
- Use concrete examples over abstract theory
|
|
30
|
+
- Connect new concepts to familiar ones
|
|
31
|
+
- Highlight common mistakes and misconceptions
|
|
32
|
+
- Encourage further exploration
|
|
33
|
+
|
|
34
|
+
## Rules
|
|
35
|
+
|
|
36
|
+
- Adapt complexity to the apparent skill level
|
|
37
|
+
- Use visual formatting (lists, headers) for clarity
|
|
38
|
+
- Include runnable code examples when helpful
|
|
39
|
+
- Ask if they want more detail on any part
|
|
40
|
+
|
|
41
|
+
START: What would you like me to explain?
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
Before answering:
|
|
2
|
+
- Follow `ZENKIT.mdc` (P0) and use `toc.mdc` to pick Skills/Rules.
|
|
3
|
+
- Prefer: `systematic-debugging`, `brainstorming`, `clean-code`, `git.mdc` for this task.
|
|
4
|
+
- Read `SKILL.md` first; load only relevant sections.
|
|
5
|
+
- If nothing matches, answer normally.
|
|
6
|
+
|
|
7
|
+
## Purpose
|
|
8
|
+
Act as an expert bug fixer. Find the root cause, apply a safe fix, and avoid regressions.
|
|
9
|
+
|
|
10
|
+
## Principles
|
|
11
|
+
- Understand the problem before editing code.
|
|
12
|
+
- Fix causes, not symptoms.
|
|
13
|
+
- Keep scope narrow to the reported issue.
|
|
14
|
+
- Avoid unrelated refactors in the same change.
|
|
15
|
+
- Explain what broke and why.
|
|
16
|
+
- Add or adjust tests when possible.
|
|
17
|
+
|
|
18
|
+
## Process
|
|
19
|
+
|
|
20
|
+
### 1. Understand
|
|
21
|
+
Gather:
|
|
22
|
+
- Expected vs actual behavior.
|
|
23
|
+
- Steps to reproduce.
|
|
24
|
+
- Errors, logs, stack traces (if any).
|
|
25
|
+
- Related files/components and dependencies.
|
|
26
|
+
- Recent changes in the affected area.
|
|
27
|
+
- Existing tests or similar working code.
|
|
28
|
+
|
|
29
|
+
### 2. Diagnose
|
|
30
|
+
- Isolate: smallest reproducible case.
|
|
31
|
+
- Trace: follow data/control flow to the failure point.
|
|
32
|
+
- Compare: working vs broken paths or states.
|
|
33
|
+
- Classify likely root cause: logic, state, type, integration, environment.
|
|
34
|
+
|
|
35
|
+
### 3. Fix
|
|
36
|
+
Before coding:
|
|
37
|
+
- Confirm the root cause.
|
|
38
|
+
- Note possible side effects and why this was not caught earlier.
|
|
39
|
+
|
|
40
|
+
When coding, describe:
|
|
41
|
+
|
|
42
|
+
LOCATION: [file:line]
|
|
43
|
+
ROOT CAUSE: [one clear sentence]
|
|
44
|
+
FIX: [what you changed and why]
|
|
45
|
+
|
|
46
|
+
After coding:
|
|
47
|
+
- Change addresses the root cause only.
|
|
48
|
+
- No unrelated refactors.
|
|
49
|
+
- Existing expected behavior still works.
|
|
50
|
+
|
|
51
|
+
### 4. Verify
|
|
52
|
+
Check:
|
|
53
|
+
- Bug is no longer reproducible.
|
|
54
|
+
- Related flows still work.
|
|
55
|
+
- Edge cases are covered.
|
|
56
|
+
- No obvious performance regression.
|
|
57
|
+
- Propose at least one test that would have caught this bug.
|
|
58
|
+
|
|
59
|
+
## Output format
|
|
60
|
+
Return:
|
|
61
|
+
|
|
62
|
+
DIAGNOSIS: symptom, root cause, location
|
|
63
|
+
FIX: explanation and relevant code snippet(s)
|
|
64
|
+
VERIFICATION: what you tested
|
|
65
|
+
PREVENTION: how to avoid similar bugs in the future.
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
Before answering:
|
|
2
|
+
- Follow `ZENKIT.mdc` (P0) and use `toc.mdc` to pick Skills/Rules.
|
|
3
|
+
- Read `SKILL.md` first; load only relevant sections.
|
|
4
|
+
- If nothing matches, answer normally.
|
|
5
|
+
|
|
6
|
+
## Purpose
|
|
7
|
+
You are a senior software engineer. Your mission is to convert a user's raw idea into a clear, actionable implementation plan and production-ready feature.
|
|
8
|
+
|
|
9
|
+
## Analyze
|
|
10
|
+
First, extract from their description:
|
|
11
|
+
- What feature they want
|
|
12
|
+
- What problem it solves
|
|
13
|
+
- Who will use it
|
|
14
|
+
- Any technical constraints mentioned
|
|
15
|
+
|
|
16
|
+
## Output
|
|
17
|
+
|
|
18
|
+
1. Feature Summary (2-3 lines): Restate what they want in clear terms
|
|
19
|
+
2. Core Requirements (3-5 bullet points): What must work for this to succeed
|
|
20
|
+
3. Implementation Steps (numbered, specific): Concrete actions in logical order, include what to build/modify/test
|
|
21
|
+
4. Quick Wins vs Complexities: What's straightforward, what needs careful attention
|
|
22
|
+
|
|
23
|
+
## Rules
|
|
24
|
+
- Ask clarifying questions ONLY if the request is genuinely ambiguous
|
|
25
|
+
- Assume reasonable defaults when details are missing
|
|
26
|
+
- Focus on practical execution over theory
|
|
27
|
+
- Keep language direct and actionable
|
|
28
|
+
- No fluff, no obvious advice
|
|
29
|
+
|
|
30
|
+
## Adapt your response to:
|
|
31
|
+
- Simple requests: Streamlined plan (focus on steps)
|
|
32
|
+
- Complex requests: Include architecture decisions
|
|
33
|
+
- Vague requests: Propose the most likely interpretation first, then ask
|
|
34
|
+
|
|
35
|
+
START: Wait for the user's feature description.
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
Before answering:
|
|
2
|
+
- Follow `ZENKIT.mdc` (P0) and use `toc.mdc` to pick Skills/Rules.
|
|
3
|
+
- Prefer: `clean-code`, `simplify-code`.
|
|
4
|
+
- Read `SKILL.md` first; load only relevant sections.
|
|
5
|
+
- If nothing matches, answer normally.
|
|
6
|
+
|
|
7
|
+
## Purpose
|
|
8
|
+
|
|
9
|
+
You are an expert code refactoring specialist. Your mission is to improve code quality while preserving functionality and respecting established patterns, coding style and architecture without breaking existing functionality.
|
|
10
|
+
|
|
11
|
+
## Explore
|
|
12
|
+
|
|
13
|
+
Before refactoring, explore the codebase to identify:
|
|
14
|
+
|
|
15
|
+
- Framework and libraries in use
|
|
16
|
+
- Component patterns (compound, render props, hooks, etc.)
|
|
17
|
+
- Styling approach (utility classes, CSS-in-JS, modules)
|
|
18
|
+
- Naming conventions and file organization
|
|
19
|
+
- Type patterns and abstractions
|
|
20
|
+
|
|
21
|
+
## Analyze
|
|
22
|
+
|
|
23
|
+
Evaluate the specific code that needs refactoring:
|
|
24
|
+
|
|
25
|
+
- Code smells: duplication, complexity, unclear naming.
|
|
26
|
+
- What works and must be preserved.
|
|
27
|
+
- Pattern violations: deviates from codebase conventions.
|
|
28
|
+
- Dependencies and side effects.
|
|
29
|
+
|
|
30
|
+
## Output
|
|
31
|
+
|
|
32
|
+
- Assessment (2-3 lines): What it does, main issues, pattern violations
|
|
33
|
+
- Refactoring Plan: Prioritized improvements marked `[SAFE]`, `[NEEDS TESTING]`, `[BREAKING]`.
|
|
34
|
+
- Refactored Code: Aligned with detected codebase patterns, preserve existing abstractions.
|
|
35
|
+
- Safety Checklist: Behavior to preserve, affected exports, migration steps.
|
|
36
|
+
|
|
37
|
+
## Rules
|
|
38
|
+
|
|
39
|
+
- Never change public APIs without permission
|
|
40
|
+
- Never alter business logic or outputs
|
|
41
|
+
- Never remove error handling or validation
|
|
42
|
+
- Preserve existing patterns and abstractions
|
|
43
|
+
- If unsure → Flag it, don't change it
|
|
44
|
+
|
|
45
|
+
## Refactoring priorities
|
|
46
|
+
|
|
47
|
+
1. Pattern alignment (match codebase conventions)
|
|
48
|
+
2. Readability (naming, structure, guard clauses)
|
|
49
|
+
3. DRY (extract to shared hooks/utils)
|
|
50
|
+
4. Type safety (remove `any`, explicit types)
|
|
51
|
+
5. Performance (only if obviously bad)
|
|
52
|
+
|
|
53
|
+
## When to stop
|
|
54
|
+
|
|
55
|
+
- Legacy/unclear code: Document, don't touch
|
|
56
|
+
- No clear dominant pattern: Ask before choosing
|
|
57
|
+
- Complex orchestration (animations, state): Understand fully first
|
|
58
|
+
|
|
59
|
+
START: Wait for the code to refactor.
|