@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,196 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: testing-patterns
|
|
3
|
+
description: Testing patterns and principles. Unit, integration, mocking strategies.
|
|
4
|
+
when_to_use: "When writing unit tests, integration tests, choosing testing frameworks, or implementing mocking strategies."
|
|
5
|
+
allowed-tools: Read, Write, Edit, Glob, Grep, Bash
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Testing Patterns
|
|
9
|
+
|
|
10
|
+
> Principles for reliable test suites.
|
|
11
|
+
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
## 1. Testing Pyramid
|
|
15
|
+
|
|
16
|
+
```
|
|
17
|
+
/\ E2E (Few)
|
|
18
|
+
/ \ Critical flows
|
|
19
|
+
/----\
|
|
20
|
+
/ \ Integration (Some)
|
|
21
|
+
/--------\ API, DB queries
|
|
22
|
+
/ \
|
|
23
|
+
/------------\ Unit (Many)
|
|
24
|
+
Functions, classes
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
---
|
|
28
|
+
|
|
29
|
+
## 2. AAA Pattern
|
|
30
|
+
|
|
31
|
+
| Step | Purpose |
|
|
32
|
+
|------|---------|
|
|
33
|
+
| **Arrange** | Set up test data |
|
|
34
|
+
| **Act** | Execute code under test |
|
|
35
|
+
| **Assert** | Verify outcome |
|
|
36
|
+
|
|
37
|
+
---
|
|
38
|
+
|
|
39
|
+
## 3. Test Type Selection
|
|
40
|
+
|
|
41
|
+
### When to Use Each
|
|
42
|
+
|
|
43
|
+
| Type | Best For | Speed |
|
|
44
|
+
|------|----------|-------|
|
|
45
|
+
| **Unit** | Pure functions, logic | Fast (<50ms) |
|
|
46
|
+
| **Integration** | API, DB, services | Medium |
|
|
47
|
+
| **E2E** | Critical user flows | Slow |
|
|
48
|
+
|
|
49
|
+
---
|
|
50
|
+
|
|
51
|
+
## 4. Unit Test Principles
|
|
52
|
+
|
|
53
|
+
### Good Unit Tests
|
|
54
|
+
|
|
55
|
+
| Principle | Meaning |
|
|
56
|
+
|-----------|---------|
|
|
57
|
+
| Fast | < 100ms each |
|
|
58
|
+
| Isolated | No external deps |
|
|
59
|
+
| Repeatable | Same result always |
|
|
60
|
+
| Self-checking | No manual verification |
|
|
61
|
+
| Timely | Written with code |
|
|
62
|
+
|
|
63
|
+
### What to Unit Test
|
|
64
|
+
|
|
65
|
+
| Test | Don't Test |
|
|
66
|
+
|------|------------|
|
|
67
|
+
| Business logic | Framework code |
|
|
68
|
+
| Edge cases | Third-party libs |
|
|
69
|
+
| Error handling | Simple getters |
|
|
70
|
+
|
|
71
|
+
---
|
|
72
|
+
|
|
73
|
+
## 5. Integration Test Principles
|
|
74
|
+
|
|
75
|
+
### What to Test
|
|
76
|
+
|
|
77
|
+
| Area | Focus |
|
|
78
|
+
|------|-------|
|
|
79
|
+
| API endpoints | Request/response |
|
|
80
|
+
| Database | Queries, transactions |
|
|
81
|
+
| External services | Contracts |
|
|
82
|
+
|
|
83
|
+
### Setup/Teardown
|
|
84
|
+
|
|
85
|
+
| Phase | Action |
|
|
86
|
+
|-------|--------|
|
|
87
|
+
| Before All | Connect resources |
|
|
88
|
+
| Before Each | Reset state |
|
|
89
|
+
| After Each | Clean up |
|
|
90
|
+
| After All | Disconnect |
|
|
91
|
+
|
|
92
|
+
---
|
|
93
|
+
|
|
94
|
+
## 6. Mocking Principles
|
|
95
|
+
|
|
96
|
+
### When to Mock
|
|
97
|
+
|
|
98
|
+
| Mock | Don't Mock |
|
|
99
|
+
|------|------------|
|
|
100
|
+
| External third-party APIs | The code under test |
|
|
101
|
+
| Slow I/O (in unit tests) | In-memory fakes / domain logic |
|
|
102
|
+
| Time/clock | Pure functions |
|
|
103
|
+
| Unreliable network | Deterministic adapters |
|
|
104
|
+
|
|
105
|
+
### Mock Types
|
|
106
|
+
|
|
107
|
+
| Type | Use |
|
|
108
|
+
|------|-----|
|
|
109
|
+
| Stub | Return fixed values |
|
|
110
|
+
| Spy | Track calls |
|
|
111
|
+
| Mock | Set expectations |
|
|
112
|
+
| Fake | Simplified implementation |
|
|
113
|
+
|
|
114
|
+
---
|
|
115
|
+
|
|
116
|
+
## 7. Test Organization
|
|
117
|
+
|
|
118
|
+
### Naming
|
|
119
|
+
|
|
120
|
+
| Pattern | Example |
|
|
121
|
+
|---------|---------|
|
|
122
|
+
| Should behavior | "should return error when..." |
|
|
123
|
+
| When condition | "when user not found..." |
|
|
124
|
+
| Given-when-then | "given X, when Y, then Z" |
|
|
125
|
+
|
|
126
|
+
### Grouping
|
|
127
|
+
|
|
128
|
+
| Level | Use |
|
|
129
|
+
|-------|-----|
|
|
130
|
+
| describe | Group related tests |
|
|
131
|
+
| it/test | Individual case |
|
|
132
|
+
| beforeEach | Common setup |
|
|
133
|
+
|
|
134
|
+
---
|
|
135
|
+
|
|
136
|
+
## 8. Test Data
|
|
137
|
+
|
|
138
|
+
### Strategies
|
|
139
|
+
|
|
140
|
+
| Approach | Use |
|
|
141
|
+
|----------|-----|
|
|
142
|
+
| Factories | Generate test data |
|
|
143
|
+
| Fixtures | Predefined datasets |
|
|
144
|
+
| Builders | Fluent object creation |
|
|
145
|
+
|
|
146
|
+
### Principles
|
|
147
|
+
|
|
148
|
+
- Use realistic, deterministic data
|
|
149
|
+
- Use fixed seeds if using generators (fuzzing/property tests only)
|
|
150
|
+
- Avoid unseeded random values (causes flaky CI runs)
|
|
151
|
+
- Share common fixtures
|
|
152
|
+
- Keep data minimal
|
|
153
|
+
|
|
154
|
+
---
|
|
155
|
+
|
|
156
|
+
## 9. Best Practices
|
|
157
|
+
|
|
158
|
+
| Practice | Why |
|
|
159
|
+
|----------|-----|
|
|
160
|
+
| One logical concept per test | Clear failure reason without artificial assert line limits |
|
|
161
|
+
| Independent tests | No order dependency |
|
|
162
|
+
| Fast tests | Run frequently |
|
|
163
|
+
| Descriptive names | Self-documenting |
|
|
164
|
+
| Clean up | Avoid side effects |
|
|
165
|
+
|
|
166
|
+
---
|
|
167
|
+
|
|
168
|
+
## 10. Anti-Patterns
|
|
169
|
+
|
|
170
|
+
| ❌ Don't | ✅ Do |
|
|
171
|
+
|----------|-------|
|
|
172
|
+
| Test implementation | Test behavior |
|
|
173
|
+
| Duplicate test code | Use factories |
|
|
174
|
+
| Complex test setup | Simplify or split |
|
|
175
|
+
| Ignore flaky tests | Fix root cause |
|
|
176
|
+
| Skip cleanup | Reset state |
|
|
177
|
+
|
|
178
|
+
---
|
|
179
|
+
|
|
180
|
+
> **Remember:** Tests are documentation. If someone can't understand what the code does from the tests, rewrite them.
|
|
181
|
+
|
|
182
|
+
---
|
|
183
|
+
|
|
184
|
+
## Receita Node: três níveis
|
|
185
|
+
|
|
186
|
+
Exemplo executável em [`examples/node-testing-recipe`](../../../examples/node-testing-recipe/README.md) (fora dos workspaces `packages/*`).
|
|
187
|
+
|
|
188
|
+
| Nível | Pasta / artefato | Runner / ferramenta | O que valida |
|
|
189
|
+
|-------|------------------|---------------------|--------------|
|
|
190
|
+
| Unitário | `test/unit/*.test.js` | `node --test` + `node:assert/strict` | Validação e domínio sem I/O externo |
|
|
191
|
+
| Integração | `test/integration/*.test.js` | `node --test` + supertest + Postgres (`DATABASE_URL`) | HTTP + SQL real; skip explícito sem banco |
|
|
192
|
+
| Carga | `load/payments.k6.js` | k6 (20 VUs, 30s) | Latência e taxa de erro sob carga |
|
|
193
|
+
|
|
194
|
+
Pirâmide do exemplo: **muitos** testes unitários rápidos, **alguns** de integração com infraestrutura real, **poucos** scripts de carga para SLO.
|
|
195
|
+
|
|
196
|
+
O exemplo usa o runner nativo **`node --test`**. No vídeo de referência a transcrição automática registrou o nome **"Poco"**; **Poku** é citado como alternativa de runner Node, mas o **nome não foi confirmado no vídeo** (não afirmar confirmação).
|
|
@@ -0,0 +1,219 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""
|
|
3
|
+
Test Runner - Unified test execution and coverage reporting
|
|
4
|
+
Runs tests and generates coverage report based on project type.
|
|
5
|
+
|
|
6
|
+
Usage:
|
|
7
|
+
python test_runner.py <project_path> [--coverage]
|
|
8
|
+
|
|
9
|
+
Supports:
|
|
10
|
+
- Node.js: npm test, jest, vitest
|
|
11
|
+
- Python: pytest, unittest
|
|
12
|
+
"""
|
|
13
|
+
|
|
14
|
+
import subprocess
|
|
15
|
+
import sys
|
|
16
|
+
import json
|
|
17
|
+
from pathlib import Path
|
|
18
|
+
from datetime import datetime
|
|
19
|
+
|
|
20
|
+
# Fix Windows console encoding
|
|
21
|
+
try:
|
|
22
|
+
sys.stdout.reconfigure(encoding='utf-8', errors='replace')
|
|
23
|
+
except:
|
|
24
|
+
pass
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
def detect_test_framework(project_path: Path) -> dict:
|
|
28
|
+
"""Detect test framework and commands."""
|
|
29
|
+
result = {
|
|
30
|
+
"type": "unknown",
|
|
31
|
+
"framework": None,
|
|
32
|
+
"cmd": None,
|
|
33
|
+
"coverage_cmd": None
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
# Node.js project
|
|
37
|
+
package_json = project_path / "package.json"
|
|
38
|
+
if package_json.exists():
|
|
39
|
+
result["type"] = "node"
|
|
40
|
+
try:
|
|
41
|
+
pkg = json.loads(package_json.read_text(encoding='utf-8'))
|
|
42
|
+
scripts = pkg.get("scripts", {})
|
|
43
|
+
deps = {**pkg.get("dependencies", {}), **pkg.get("devDependencies", {})}
|
|
44
|
+
|
|
45
|
+
# Check for test script
|
|
46
|
+
if "test" in scripts:
|
|
47
|
+
result["framework"] = "npm test"
|
|
48
|
+
result["cmd"] = ["npm", "test"]
|
|
49
|
+
|
|
50
|
+
# Try to detect specific framework for coverage
|
|
51
|
+
if "vitest" in deps:
|
|
52
|
+
result["framework"] = "vitest"
|
|
53
|
+
result["coverage_cmd"] = ["npx", "vitest", "run", "--coverage"]
|
|
54
|
+
elif "jest" in deps:
|
|
55
|
+
result["framework"] = "jest"
|
|
56
|
+
result["coverage_cmd"] = ["npx", "jest", "--coverage"]
|
|
57
|
+
elif "vitest" in deps:
|
|
58
|
+
result["framework"] = "vitest"
|
|
59
|
+
result["cmd"] = ["npx", "vitest", "run"]
|
|
60
|
+
result["coverage_cmd"] = ["npx", "vitest", "run", "--coverage"]
|
|
61
|
+
elif "jest" in deps:
|
|
62
|
+
result["framework"] = "jest"
|
|
63
|
+
result["cmd"] = ["npx", "jest"]
|
|
64
|
+
result["coverage_cmd"] = ["npx", "jest", "--coverage"]
|
|
65
|
+
|
|
66
|
+
except:
|
|
67
|
+
pass
|
|
68
|
+
|
|
69
|
+
# Python project
|
|
70
|
+
if (project_path / "pyproject.toml").exists() or (project_path / "requirements.txt").exists():
|
|
71
|
+
result["type"] = "python"
|
|
72
|
+
result["framework"] = "pytest"
|
|
73
|
+
result["cmd"] = ["python", "-m", "pytest", "-v"]
|
|
74
|
+
result["coverage_cmd"] = ["python", "-m", "pytest", "--cov", "--cov-report=term-missing"]
|
|
75
|
+
|
|
76
|
+
return result
|
|
77
|
+
|
|
78
|
+
|
|
79
|
+
def run_tests(cmd: list, cwd: Path) -> dict:
|
|
80
|
+
"""Run tests and return results."""
|
|
81
|
+
result = {
|
|
82
|
+
"passed": False,
|
|
83
|
+
"output": "",
|
|
84
|
+
"error": "",
|
|
85
|
+
"tests_run": 0,
|
|
86
|
+
"tests_passed": 0,
|
|
87
|
+
"tests_failed": 0
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
try:
|
|
91
|
+
proc = subprocess.run(
|
|
92
|
+
cmd,
|
|
93
|
+
cwd=str(cwd),
|
|
94
|
+
capture_output=True,
|
|
95
|
+
text=True,
|
|
96
|
+
encoding='utf-8',
|
|
97
|
+
errors='replace',
|
|
98
|
+
timeout=300 # 5 min timeout for tests
|
|
99
|
+
)
|
|
100
|
+
|
|
101
|
+
result["output"] = proc.stdout[:3000] if proc.stdout else ""
|
|
102
|
+
result["error"] = proc.stderr[:500] if proc.stderr else ""
|
|
103
|
+
result["passed"] = proc.returncode == 0
|
|
104
|
+
|
|
105
|
+
# Try to parse test counts from output
|
|
106
|
+
output = proc.stdout or ""
|
|
107
|
+
|
|
108
|
+
# Jest/Vitest pattern: "Tests: X passed, Y failed, Z total"
|
|
109
|
+
if "passed" in output.lower() and "failed" in output.lower():
|
|
110
|
+
import re
|
|
111
|
+
match = re.search(r'(\d+)\s+passed', output, re.IGNORECASE)
|
|
112
|
+
if match:
|
|
113
|
+
result["tests_passed"] = int(match.group(1))
|
|
114
|
+
match = re.search(r'(\d+)\s+failed', output, re.IGNORECASE)
|
|
115
|
+
if match:
|
|
116
|
+
result["tests_failed"] = int(match.group(1))
|
|
117
|
+
result["tests_run"] = result["tests_passed"] + result["tests_failed"]
|
|
118
|
+
|
|
119
|
+
# Pytest pattern: "X passed, Y failed"
|
|
120
|
+
if "pytest" in str(cmd):
|
|
121
|
+
import re
|
|
122
|
+
match = re.search(r'(\d+)\s+passed', output)
|
|
123
|
+
if match:
|
|
124
|
+
result["tests_passed"] = int(match.group(1))
|
|
125
|
+
match = re.search(r'(\d+)\s+failed', output)
|
|
126
|
+
if match:
|
|
127
|
+
result["tests_failed"] = int(match.group(1))
|
|
128
|
+
result["tests_run"] = result["tests_passed"] + result["tests_failed"]
|
|
129
|
+
|
|
130
|
+
except FileNotFoundError:
|
|
131
|
+
result["error"] = f"Command not found: {cmd[0]}"
|
|
132
|
+
except subprocess.TimeoutExpired:
|
|
133
|
+
result["error"] = "Timeout after 300s"
|
|
134
|
+
except Exception as e:
|
|
135
|
+
result["error"] = str(e)
|
|
136
|
+
|
|
137
|
+
return result
|
|
138
|
+
|
|
139
|
+
|
|
140
|
+
def main():
|
|
141
|
+
project_path = Path(sys.argv[1] if len(sys.argv) > 1 else ".").resolve()
|
|
142
|
+
with_coverage = "--coverage" in sys.argv
|
|
143
|
+
|
|
144
|
+
print(f"\n{'='*60}")
|
|
145
|
+
print(f"[TEST RUNNER] Unified Test Execution")
|
|
146
|
+
print(f"{'='*60}")
|
|
147
|
+
print(f"Project: {project_path}")
|
|
148
|
+
print(f"Coverage: {'enabled' if with_coverage else 'disabled'}")
|
|
149
|
+
print(f"Time: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}")
|
|
150
|
+
|
|
151
|
+
# Detect test framework
|
|
152
|
+
test_info = detect_test_framework(project_path)
|
|
153
|
+
print(f"Type: {test_info['type']}")
|
|
154
|
+
print(f"Framework: {test_info['framework']}")
|
|
155
|
+
print("-"*60)
|
|
156
|
+
|
|
157
|
+
if not test_info["cmd"]:
|
|
158
|
+
print("No test framework found for this project.")
|
|
159
|
+
output = {
|
|
160
|
+
"script": "test_runner",
|
|
161
|
+
"project": str(project_path),
|
|
162
|
+
"type": test_info["type"],
|
|
163
|
+
"framework": None,
|
|
164
|
+
"passed": True,
|
|
165
|
+
"message": "No tests configured"
|
|
166
|
+
}
|
|
167
|
+
print(json.dumps(output, indent=2))
|
|
168
|
+
sys.exit(0)
|
|
169
|
+
|
|
170
|
+
# Choose command
|
|
171
|
+
cmd = test_info["coverage_cmd"] if with_coverage and test_info["coverage_cmd"] else test_info["cmd"]
|
|
172
|
+
|
|
173
|
+
print(f"Running: {' '.join(cmd)}")
|
|
174
|
+
print("-"*60)
|
|
175
|
+
|
|
176
|
+
# Run tests
|
|
177
|
+
result = run_tests(cmd, project_path)
|
|
178
|
+
|
|
179
|
+
# Print output (truncated)
|
|
180
|
+
if result["output"]:
|
|
181
|
+
lines = result["output"].split("\n")
|
|
182
|
+
for line in lines[:30]:
|
|
183
|
+
print(line)
|
|
184
|
+
if len(lines) > 30:
|
|
185
|
+
print(f"... ({len(lines) - 30} more lines)")
|
|
186
|
+
|
|
187
|
+
# Summary
|
|
188
|
+
print("\n" + "="*60)
|
|
189
|
+
print("SUMMARY")
|
|
190
|
+
print("="*60)
|
|
191
|
+
|
|
192
|
+
if result["passed"]:
|
|
193
|
+
print("[PASS] All tests passed")
|
|
194
|
+
else:
|
|
195
|
+
print("[FAIL] Some tests failed")
|
|
196
|
+
if result["error"]:
|
|
197
|
+
print(f"Error: {result['error'][:200]}")
|
|
198
|
+
|
|
199
|
+
if result["tests_run"] > 0:
|
|
200
|
+
print(f"Tests: {result['tests_run']} total, {result['tests_passed']} passed, {result['tests_failed']} failed")
|
|
201
|
+
|
|
202
|
+
output = {
|
|
203
|
+
"script": "test_runner",
|
|
204
|
+
"project": str(project_path),
|
|
205
|
+
"type": test_info["type"],
|
|
206
|
+
"framework": test_info["framework"],
|
|
207
|
+
"tests_run": result["tests_run"],
|
|
208
|
+
"tests_passed": result["tests_passed"],
|
|
209
|
+
"tests_failed": result["tests_failed"],
|
|
210
|
+
"passed": result["passed"]
|
|
211
|
+
}
|
|
212
|
+
|
|
213
|
+
print("\n" + json.dumps(output, indent=2))
|
|
214
|
+
|
|
215
|
+
sys.exit(0 if result["passed"] else 1)
|
|
216
|
+
|
|
217
|
+
|
|
218
|
+
if __name__ == "__main__":
|
|
219
|
+
main()
|
|
@@ -0,0 +1,135 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: ui-ux-pro-max
|
|
3
|
+
description: Native UI/UX design intelligence skill with design-system generation, style/palette/typography search, and stack-specific implementation guidance.
|
|
4
|
+
when_to_use: "When the user asks to design, improve, review, modernize, or implement UI/UX for web/mobile screens and components. Use for layout, visual hierarchy, colors, typography, interaction polish, and responsive refinements."
|
|
5
|
+
allowed-tools: Read, Write, Edit, Glob, Grep, Bash
|
|
6
|
+
version: 1.0.0
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# UI/UX Pro Max (Native Skill)
|
|
10
|
+
|
|
11
|
+
Use this skill to apply the `ui-ux-pro-max` workflow as a first-class native skill in Cursor.
|
|
12
|
+
|
|
13
|
+
## Source of truth
|
|
14
|
+
|
|
15
|
+
- Workflow reference: `.cursor/workflows/ui-ux-pro-max.md`
|
|
16
|
+
- Runtime engine: `.cursor/.shared/ui-ux-pro-max/scripts/search.py`
|
|
17
|
+
|
|
18
|
+
If this skill and workflow diverge, prioritize the workflow file and keep this skill updated.
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
## Prerequisites
|
|
23
|
+
|
|
24
|
+
Verify Python availability before running searches:
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
python3 --version || python --version
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
If Python is unavailable on Windows:
|
|
31
|
+
|
|
32
|
+
```powershell
|
|
33
|
+
winget install Python.Python.3.12
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
---
|
|
37
|
+
|
|
38
|
+
## Mandatory execution flow
|
|
39
|
+
|
|
40
|
+
For any UI/UX request, follow this sequence:
|
|
41
|
+
|
|
42
|
+
1. **Classify request**
|
|
43
|
+
- Product type (SaaS, dashboard, CRM, landing, e-commerce, etc.)
|
|
44
|
+
- Industry/context
|
|
45
|
+
- Desired style keywords (minimal, premium, playful, dark, etc.)
|
|
46
|
+
- Target stack (if not provided, default to `html-tailwind`)
|
|
47
|
+
|
|
48
|
+
2. **Generate design system first (required)**
|
|
49
|
+
|
|
50
|
+
```bash
|
|
51
|
+
python3 .cursor/.shared/ui-ux-pro-max/scripts/search.py "<product_type> <industry> <keywords>" --design-system -p "<Project Name>"
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
3. **Optional persistence for cross-session consistency**
|
|
55
|
+
|
|
56
|
+
```bash
|
|
57
|
+
python3 .cursor/.shared/ui-ux-pro-max/scripts/search.py "<query>" --design-system --persist -p "<Project Name>"
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
With page overrides:
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
python3 .cursor/.shared/ui-ux-pro-max/scripts/search.py "<query>" --design-system --persist -p "<Project Name>" --page "<page-name>"
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
4. **Supplementary domain searches (as needed)**
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
python3 .cursor/.shared/ui-ux-pro-max/scripts/search.py "<keyword>" --domain <domain> [-n <max_results>]
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
Domains:
|
|
73
|
+
- `product`, `style`, `typography`, `color`, `landing`, `chart`, `ux`, `react`, `web`, `prompt`
|
|
74
|
+
|
|
75
|
+
5. **Stack-specific guidance**
|
|
76
|
+
|
|
77
|
+
```bash
|
|
78
|
+
python3 .cursor/.shared/ui-ux-pro-max/scripts/search.py "<keyword>" --stack <stack>
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
Stacks:
|
|
82
|
+
- `html-tailwind` (default), `react`, `nextjs`, `vue`, `svelte`, `swiftui`, `react-native`, `flutter`, `shadcn`, `jetpack-compose`
|
|
83
|
+
|
|
84
|
+
6. **Implement and validate**
|
|
85
|
+
- Apply design tokens, spacing system, hierarchy, and interaction feedback.
|
|
86
|
+
- Ensure responsive behavior and accessibility states.
|
|
87
|
+
- Run project lint/type/build checks after changes.
|
|
88
|
+
|
|
89
|
+
---
|
|
90
|
+
|
|
91
|
+
## Core quality guardrails
|
|
92
|
+
|
|
93
|
+
- No emoji as UI icon; use SVG icon sets consistently.
|
|
94
|
+
- Clear hover/focus states without layout shift.
|
|
95
|
+
- High contrast in light mode text and borders.
|
|
96
|
+
- Respect `prefers-reduced-motion`.
|
|
97
|
+
- Keep component spacing and container widths consistent.
|
|
98
|
+
|
|
99
|
+
---
|
|
100
|
+
|
|
101
|
+
## Recommended command templates
|
|
102
|
+
|
|
103
|
+
### Full design-system (default terminal format)
|
|
104
|
+
|
|
105
|
+
```bash
|
|
106
|
+
python3 .cursor/.shared/ui-ux-pro-max/scripts/search.py "crm dashboard support operations modern professional" --design-system -p "SaaS Dashboard"
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
### Markdown output
|
|
110
|
+
|
|
111
|
+
```bash
|
|
112
|
+
python3 .cursor/.shared/ui-ux-pro-max/scripts/search.py "crm dashboard support operations modern professional" --design-system -f markdown -p "SaaS Dashboard"
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
### UX deep dive
|
|
116
|
+
|
|
117
|
+
```bash
|
|
118
|
+
python3 .cursor/.shared/ui-ux-pro-max/scripts/search.py "animation accessibility focus states loading feedback" --domain ux
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
### React stack recommendations
|
|
122
|
+
|
|
123
|
+
```bash
|
|
124
|
+
python3 .cursor/.shared/ui-ux-pro-max/scripts/search.py "layout responsive forms stateful lists" --stack react
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
---
|
|
128
|
+
|
|
129
|
+
## Integration note
|
|
130
|
+
|
|
131
|
+
This skill is intentionally thin and operational. It delegates detailed design intelligence to:
|
|
132
|
+
- `.cursor/workflows/ui-ux-pro-max.md`
|
|
133
|
+
- `.cursor/.shared/ui-ux-pro-max/*`
|
|
134
|
+
|
|
135
|
+
Keep these paths stable so Cursor can use `ui-ux-pro-max` natively through this skill.
|
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: verify-changes
|
|
3
|
+
description: Prove code works by running it, not just checking it exists. Verification through execution rather than inspection. Use after writing or modifying code to ensure it actually functions correctly.
|
|
4
|
+
when_to_use: "After writing code, completing a feature, or fixing a bug. When the user says 'does this work?', 'test this', 'verify', or when /verify workflow is invoked. NOT for writing new code — for proving existing code works."
|
|
5
|
+
allowed-tools: Read, Bash, Grep, Glob
|
|
6
|
+
effort: medium
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Verify Changes — Prove Code Works
|
|
10
|
+
|
|
11
|
+
> "Code that exists" ≠ "Code that works." This skill ensures changes are verified through execution.
|
|
12
|
+
|
|
13
|
+
## Core Principle
|
|
14
|
+
|
|
15
|
+
```
|
|
16
|
+
❌ Verification by inspection: "I can see the function exists, it should work"
|
|
17
|
+
❌ Verification by assumption: "The types check out, so it's correct"
|
|
18
|
+
✅ Verification by execution: "I ran it, here's the output, it works because [evidence]"
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## Verification Protocol
|
|
24
|
+
|
|
25
|
+
### Step 1: Identify What Changed
|
|
26
|
+
```
|
|
27
|
+
- Which files were modified?
|
|
28
|
+
- What behavior should be different now?
|
|
29
|
+
- What was the original bug/requirement?
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
### Step 2: Determine Verification Method
|
|
33
|
+
|
|
34
|
+
| Change Type | Verification Method |
|
|
35
|
+
|---|---|
|
|
36
|
+
| **Bug fix** | Reproduce the original bug scenario → confirm it no longer occurs |
|
|
37
|
+
| **New feature** | Run the feature → confirm expected output |
|
|
38
|
+
| **Refactor** | Run existing tests → confirm nothing broke |
|
|
39
|
+
| **API change** | Call the endpoint → confirm response shape |
|
|
40
|
+
| **UI change** | Render the component → confirm visual output |
|
|
41
|
+
| **Config change** | Load the config → confirm values applied |
|
|
42
|
+
| **Build/infra** | Run build command → confirm success |
|
|
43
|
+
|
|
44
|
+
### Step 3: Execute Verification
|
|
45
|
+
|
|
46
|
+
Execute automated commands and capture actual exit codes and output:
|
|
47
|
+
```bash
|
|
48
|
+
# Compile and typecheck
|
|
49
|
+
npm run build # Must exit 0
|
|
50
|
+
|
|
51
|
+
# Test suites
|
|
52
|
+
npm run test # All tests must pass (exit 0)
|
|
53
|
+
|
|
54
|
+
# Targeted component/unit validation
|
|
55
|
+
npx vitest run path/to/changed.test.ts
|
|
56
|
+
|
|
57
|
+
# API contract check (assert status and body)
|
|
58
|
+
curl -sS -f http://localhost:3000/api/endpoint
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
### Step 4: Report Evidence
|
|
62
|
+
|
|
63
|
+
Tie every verification claim to an immutable Git SHA and raw command evidence:
|
|
64
|
+
|
|
65
|
+
```markdown
|
|
66
|
+
## Verification Report
|
|
67
|
+
|
|
68
|
+
### Target Context
|
|
69
|
+
- Repository / Worktree: [Path or isolated worktree]
|
|
70
|
+
- Commit / Head SHA: `[git rev-parse --short HEAD]`
|
|
71
|
+
|
|
72
|
+
### Executed Commands & Exit Codes
|
|
73
|
+
- Build: `npm run build` → exit code 0
|
|
74
|
+
- Unit/E2E: `npm run test` → exit code 0 (42/42 passed)
|
|
75
|
+
- API/Runtime: `curl -f ...` → HTTP 200 OK with expected JSON payload
|
|
76
|
+
|
|
77
|
+
### Non-Verifiable Items & Escalation
|
|
78
|
+
- [List any gaps requiring manual user testing or external credentials]
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
---
|
|
82
|
+
|
|
83
|
+
## Verification Checklist by Project Type
|
|
84
|
+
|
|
85
|
+
### Web Application
|
|
86
|
+
- [ ] `npm run build` — compiles without errors
|
|
87
|
+
- [ ] `npm run lint` — no linting errors
|
|
88
|
+
- [ ] `npm run test` — all tests pass
|
|
89
|
+
- [ ] Dev server starts successfully
|
|
90
|
+
- [ ] Changed pages render correctly
|
|
91
|
+
- [ ] No console errors in browser
|
|
92
|
+
|
|
93
|
+
### API / Backend
|
|
94
|
+
- [ ] Server starts without errors
|
|
95
|
+
- [ ] Changed endpoints respond correctly
|
|
96
|
+
- [ ] Error cases return appropriate status codes
|
|
97
|
+
- [ ] Database queries execute successfully
|
|
98
|
+
|
|
99
|
+
### CLI / Script
|
|
100
|
+
- [ ] Script runs without errors
|
|
101
|
+
- [ ] Expected output matches actual output
|
|
102
|
+
- [ ] Error handling works (bad input test)
|
|
103
|
+
- [ ] Help/usage text is correct
|
|
104
|
+
|
|
105
|
+
---
|
|
106
|
+
|
|
107
|
+
## Anti-Patterns
|
|
108
|
+
|
|
109
|
+
| Anti-Pattern | Why It's Bad | Fix |
|
|
110
|
+
|---|---|---|
|
|
111
|
+
| "It should work" | No evidence | Run it and show output |
|
|
112
|
+
| Only checking happy path | Bugs hide in edge cases | Test error paths too |
|
|
113
|
+
| Verifying only compilation | Compiles ≠ correct | Test runtime behavior |
|
|
114
|
+
| Skipping verification for "trivial" changes | Trivial changes cause real bugs | Verify everything |
|
|
115
|
+
|
|
116
|
+
---
|
|
117
|
+
|
|
118
|
+
## Integration with Other Skills
|
|
119
|
+
|
|
120
|
+
| After Using | Verify With |
|
|
121
|
+
|---|---|
|
|
122
|
+
| `frontend-design` → UI changes | Render in browser, check console |
|
|
123
|
+
| `backend-specialist` → API changes | curl endpoints, check responses |
|
|
124
|
+
| `database-design` → Schema changes | Run migrations, query data |
|
|
125
|
+
| `testing-patterns` → New tests | Run test suite, check coverage |
|