@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,177 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: entrega-com-agentes
|
|
3
|
+
description: Orquestra o fluxo de entrega de feature em fases com portões (brainstorm, plano, implementação, teste, revisão, entrega), no estilo Superpowers. Não substitui as skills de fase; delega para elas.
|
|
4
|
+
when_to_use: "Quando uma demanda de engenharia pede feature nova, entrega ponta a ponta, ou processo explícito brainstorm→plano→código→teste→revisão. Use com demandas registradas, worktree isolada e zenkit-bridge quando disponível. NOT para typo ou one-liner sem plano."
|
|
5
|
+
allowed-tools: Read, Glob, Grep, Bash
|
|
6
|
+
effort: high
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Entrega com agentes
|
|
10
|
+
|
|
11
|
+
> Fonte de método: obra/superpowers. Esta skill é o **maestro**: define fases, portões e handoffs. O conteúdo de cada fase vive nas skills referenciadas; não copie daqui para lá.
|
|
12
|
+
|
|
13
|
+
## Propósito
|
|
14
|
+
|
|
15
|
+
Entregar uma feature como **pipeline com portões**, não como um turno solto:
|
|
16
|
+
|
|
17
|
+
```
|
|
18
|
+
brainstorm → plano → implementação → teste/verificação → revisão → entrega
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
Cada fase produz um artefato verificável. Só avança quando o portão de saída é verdadeiro. O flagship (sessão atual cara) **planeja e revisa**; a escrita em massa vai para `dispatch_handoff` → executor padrão **Cursor `composer-2.5`** (ZENKIT §2), salvo pedido explícito do humano por outro provider (`provider-orchestration`).
|
|
22
|
+
|
|
23
|
+
## Antes de começar (estado do projeto + escopo)
|
|
24
|
+
|
|
25
|
+
1. Ler o estado do projeto e conferir quem mais trabalha no repositório (ZENKIT §0, §8).
|
|
26
|
+
2. Registrar a tarefa onde o time acompanha (issue ou demanda) quando houver id.
|
|
27
|
+
3. Avisar o escopo: arquivos previstos e branch.
|
|
28
|
+
4. Carregar só o índice desta skill; em cada fase, abrir **uma** skill filha.
|
|
29
|
+
|
|
30
|
+
**Unidade de trabalho:** a demanda inteira (ZENKIT §10). Não pergunte entre fases já escritas neste fluxo. Pare só em fork legítimo (§10.2).
|
|
31
|
+
|
|
32
|
+
---
|
|
33
|
+
|
|
34
|
+
## Visão das fases
|
|
35
|
+
|
|
36
|
+
| Fase | Skill que executa |
|
|
37
|
+
| --- | --- |
|
|
38
|
+
| Brainstorm | `@[skills/brainstorming]` |
|
|
39
|
+
| Plano | `@[skills/plan-writing]` |
|
|
40
|
+
| Implementação | `@[skills/git-worktrees]` + bridge `dispatch_handoff` + `@[skills/parallel-agents]` quando couber |
|
|
41
|
+
| Teste | `@[skills/tdd-workflow]` + `@[skills/verify-changes]` |
|
|
42
|
+
| Revisão | MCP `gate_diff` + `@[skills/code-review-checklist]` |
|
|
43
|
+
| Entrega | estado do projeto atualizado + passos humanos de PR/deploy (fork) |
|
|
44
|
+
|
|
45
|
+
---
|
|
46
|
+
|
|
47
|
+
## Fase 1: Brainstorm
|
|
48
|
+
|
|
49
|
+
| | |
|
|
50
|
+
| --- | --- |
|
|
51
|
+
| **Entrada** | Pedido bruto de feature, contexto do produto, restrições conhecidas. |
|
|
52
|
+
| **Saída (artefato)** | **Spec curta** (máx. ~1 página): problema, usuários, must-have vs nice-to-have, decisões tomadas, perguntas ainda abertas (se houver fork). |
|
|
53
|
+
| **Skill** | `@[skills/brainstorming]` (Portão Socrático quando requisito vago; exceções triviais em ZENKIT §5). |
|
|
54
|
+
| **Portão de saída** | Spec sem ambiguidade bloqueante; decisões P0 registradas (`/remember` ou `store_knowledge` se durável); escopo fechado para planejar. |
|
|
55
|
+
|
|
56
|
+
---
|
|
57
|
+
|
|
58
|
+
## Fase 2: Plano
|
|
59
|
+
|
|
60
|
+
| | |
|
|
61
|
+
| --- | --- |
|
|
62
|
+
| **Entrada** | Spec curta aprovada (implicitamente, se o processo já a descreveu). |
|
|
63
|
+
| **Saída (artefato)** | Arquivo `{task-slug}.md` na **raiz do projeto** com 5 a 10 tarefas de 2 a 5 min cada: caminhos de arquivo exatos, dependências, e **comando de verificação por tarefa** (ex.: `npx tsc --noEmit`, `npm test -- path/to.test.ts`). Fase final do plano = verificação global. |
|
|
64
|
+
| **Skill** | `@[skills/plan-writing]`. Se bridge ativo: `gate_dispatch` com o texto do plano antes de executar. |
|
|
65
|
+
| **Portão de saída** | Plano cabe em uma página; toda tarefa tem verificação; última fase é verificação; `gate_dispatch` retorna `dispatch` (não `needs_plan` / `stop` / `human` sem resolução). |
|
|
66
|
+
|
|
67
|
+
---
|
|
68
|
+
|
|
69
|
+
## Fase 3: Implementação
|
|
70
|
+
|
|
71
|
+
| | |
|
|
72
|
+
| --- | --- |
|
|
73
|
+
| **Entrada** | Plano aprovado pelo gate (ou equivalente nativo se o bridge falhou). |
|
|
74
|
+
| **Saída (artefato)** | **Diff** no worktree (branch dedicada), commits atômicos alinhados ao plano, notas curtas do que cada tarefa tocou. |
|
|
75
|
+
| **Skills** | `@[skills/git-worktrees]` para isolar; `dispatch_handoff` (`plan`, `repo`, modo write) via zenkit-bridge; `@[skills/cursor-exec]` / `@[skills/provider-orchestration]` se executar fora do MCP. Tarefas **independentes** no plano: um subagente novo por tarefa (`@[skills/parallel-agents]`). |
|
|
76
|
+
| **Portão de saída** | `dispatch_status` com estado terminal `ran` (ou implementação nativa equivalente); diff capturado; nenhuma tarefa do plano de implementação pendente; branch correta (`git branch --show-current`). |
|
|
77
|
+
|
|
78
|
+
Exemplo de handoff (bridge disponível):
|
|
79
|
+
|
|
80
|
+
```json
|
|
81
|
+
{
|
|
82
|
+
"tool": "dispatch_handoff",
|
|
83
|
+
"arguments": {
|
|
84
|
+
"plan": "<conteúdo do {task-slug}.md>",
|
|
85
|
+
"repo": "<caminho absoluto do repo ou worktree>",
|
|
86
|
+
"mode": "write",
|
|
87
|
+
"executor": "cursor"
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
Flagship **não** digita o diff quando o plano existe: revisa depois (ZENKIT §2).
|
|
93
|
+
|
|
94
|
+
---
|
|
95
|
+
|
|
96
|
+
## Fase 4: Teste e verificação
|
|
97
|
+
|
|
98
|
+
| | |
|
|
99
|
+
| --- | --- |
|
|
100
|
+
| **Entrada** | Diff da implementação no worktree correto. |
|
|
101
|
+
| **Saída (artefato)** | Saída literal dos verificadores: exit code + trecho relevante do log; ciclo TDD documentado (RED/GREEN/REFACTOR) quando aplicável. |
|
|
102
|
+
| **Skills** | `@[skills/tdd-workflow]` para comportamento novo; `@[skills/verify-changes]` para provar por execução, não por inspeção. |
|
|
103
|
+
| **Portão de saída** | **Definição de Pronto** ZENKIT §9: para código, `tsc --noEmit` **e** suíte de testes verdes **depois da última edição**. Verificador que não rodou **não é evidência** (§9.1). Lacunas declaradas como `não verificado: <motivo>`. |
|
|
104
|
+
|
|
105
|
+
Ordem típica no worktree:
|
|
106
|
+
|
|
107
|
+
```bash
|
|
108
|
+
npx tsc --noEmit
|
|
109
|
+
npm test
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
Ajuste aos comandos do plano quando o projeto usar outro harness.
|
|
113
|
+
|
|
114
|
+
---
|
|
115
|
+
|
|
116
|
+
## Fase 5: Revisão
|
|
117
|
+
|
|
118
|
+
| | |
|
|
119
|
+
| --- | --- |
|
|
120
|
+
| **Entrada** | Plano + diff + evidências de teste. |
|
|
121
|
+
| **Saída (artefato)** | Resultado de `gate_diff` + checklist preenchido; lista de achados (crítico / menor / nit). |
|
|
122
|
+
| **Skills** | MCP `gate_diff` (`plan`, `diff`, `slug`); `@[skills/code-review-checklist]` para passada humana ou do flagship. |
|
|
123
|
+
| **Portão de saída** | Decisão `light_review` aceitável sem achados críticos; `deep_review` ou `human` exige resolução antes de entregar. Achado **crítico** (correção, segurança, fora do plano) → volta para **Fase 3** no mesmo worktree, depois repete teste e revisão. |
|
|
124
|
+
|
|
125
|
+
---
|
|
126
|
+
|
|
127
|
+
## Fase 6: Entrega
|
|
128
|
+
|
|
129
|
+
| | |
|
|
130
|
+
| --- | --- |
|
|
131
|
+
| **Entrada** | Revisão aprovada, evidência de teste, estado da demanda. |
|
|
132
|
+
| **Saída (artefato)** | Demanda atualizada no registro do projeto; worktree higienizado quando mergeado; estado do projeto atualizado; handoff ao humano para PR/merge/deploy (fork §10.2). |
|
|
133
|
+
| **Skills** | `@[skills/quadro-agentes]` para quadro; ZENKIT §7 para ciclo `code-complete` → `in-review` → … quando o processo de demanda exigir. |
|
|
134
|
+
| **Portão de saída** | Estado da demanda reflete o estágio real; `release_work`; `git worktree remove` + `prune` após merge; sem WIP órfão. |
|
|
135
|
+
|
|
136
|
+
---
|
|
137
|
+
|
|
138
|
+
## Regras de fluxo (ZENKIT §10)
|
|
139
|
+
|
|
140
|
+
1. **Demanda, não passo:** execute todas as fases até bloqueio real; não use `question` para "posso ir para o plano?".
|
|
141
|
+
2. **Forks legítimos only:** credencial, irreversível externo (PR, prod), dinheiro, spec ambígua, dado só do humano.
|
|
142
|
+
3. **Bridge falhou:** reporte o erro; continue com ferramentas nativas (edit, bash, worktree) sem alegar que estão desabilitadas (§2).
|
|
143
|
+
4. **Escopo congelado na implementação:** mudança de escopo volta ao brainstorm ou exige adendo explícito ao plano (novo `gate_dispatch`).
|
|
144
|
+
|
|
145
|
+
---
|
|
146
|
+
|
|
147
|
+
## Anti-padrões
|
|
148
|
+
|
|
149
|
+
| Anti-padrão | Por que falha |
|
|
150
|
+
| --- | --- |
|
|
151
|
+
| Pular brainstorm/plano e codar | Sem spec e sem verificação por tarefa; drift garantido. |
|
|
152
|
+
| Plano sem comando de verificação em cada tarefa | §9 bloqueia "concluído"; executor inventa sucesso. |
|
|
153
|
+
| "Testei" sem colar saída do comando | §9.1 fail-closed; falso positivo. |
|
|
154
|
+
| Mudar escopo no meio da implementação | Diff não casa com plano; `gate_diff` → `deep_review` ou retrabalho. |
|
|
155
|
+
| Flagship digitando em massa com plano pronto | Queima cota; viola §2; use `dispatch_handoff`. |
|
|
156
|
+
| Perguntar entre fases deste fluxo | Viola §10; só fork legítimo. |
|
|
157
|
+
|
|
158
|
+
---
|
|
159
|
+
|
|
160
|
+
## Checklist final (antes de declarar entrega)
|
|
161
|
+
|
|
162
|
+
- [ ] Spec curta arquivada ou referenciada na demanda
|
|
163
|
+
- [ ] Plano `{task-slug}.md` na raiz com verificações por tarefa
|
|
164
|
+
- [ ] Worktree/branch corretos; diff revisável
|
|
165
|
+
- [ ] `tsc --noEmit` e suíte verdes após última edição (ou `não verificado` declarado)
|
|
166
|
+
- [ ] `gate_diff` + checklist sem críticos abertos
|
|
167
|
+
- [ ] Registro do projeto: tarefa atualizada, escopo liberado
|
|
168
|
+
- [ ] Worktree removido após merge (quando aplicável)
|
|
169
|
+
|
|
170
|
+
---
|
|
171
|
+
|
|
172
|
+
## Referências rápidas
|
|
173
|
+
|
|
174
|
+
- Router e executor: `kit/rules/ZENKIT.mdc` §2
|
|
175
|
+
- Pronto e evidência: §9
|
|
176
|
+
- Unidade de trabalho: §10
|
|
177
|
+
- Gates: `packages/zenkit-bridge/README.md` (`gate_dispatch`, `dispatch_handoff`, `gate_diff`)
|
|
@@ -0,0 +1,456 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: frontend-design
|
|
3
|
+
description: Design thinking and decision-making for web UI. Use when designing components, layouts, color schemes, typography, or creating aesthetic interfaces. Teaches principles, not fixed values.
|
|
4
|
+
when_to_use: "When designing web UI components, choosing color schemes, typography, layouts, or creating aesthetic interfaces. NOT for mobile apps."
|
|
5
|
+
allowed-tools: Read, Write, Edit, Glob, Grep, Bash
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Frontend Design System
|
|
9
|
+
|
|
10
|
+
> **Philosophy:** Every pixel has purpose. Restraint is luxury. User psychology drives decisions.
|
|
11
|
+
> **Core Principle:** THINK, don't memorize. ASK, don't assume.
|
|
12
|
+
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
## 🎯 Selective Reading Rule (MANDATORY)
|
|
16
|
+
|
|
17
|
+
**Read REQUIRED files always, OPTIONAL only when needed:**
|
|
18
|
+
|
|
19
|
+
| File | Status | When to Read |
|
|
20
|
+
|------|--------|--------------|
|
|
21
|
+
| [ux-psychology.md](ux-psychology.md) | 🔴 **REQUIRED** | Always read first! |
|
|
22
|
+
| [color-system.md](color-system.md) | ⚪ Optional | Color/palette decisions |
|
|
23
|
+
| [typography-system.md](typography-system.md) | ⚪ Optional | Font selection/pairing |
|
|
24
|
+
| [visual-effects.md](visual-effects.md) | ⚪ Optional | Glassmorphism, shadows, gradients |
|
|
25
|
+
| [animation-guide.md](animation-guide.md) | ⚪ Optional | Animation needed |
|
|
26
|
+
| [motion-graphics.md](motion-graphics.md) | ⚪ Optional | Lottie, GSAP, 3D |
|
|
27
|
+
| [decision-trees.md](decision-trees.md) | ⚪ Optional | Context templates |
|
|
28
|
+
| [references/aesthetic/design-principles.md](references/aesthetic/design-principles.md) | ⚪ Optional | Storytelling, distinctive UI |
|
|
29
|
+
| [references/aesthetic/micro-interactions.md](references/aesthetic/micro-interactions.md) | ⚪ Optional | Motion and feedback |
|
|
30
|
+
| [references/aesthetic/storytelling-design.md](references/aesthetic/storytelling-design.md) | ⚪ Optional | Narrative-driven layouts |
|
|
31
|
+
|
|
32
|
+
> 🔴 **ux-psychology.md = ALWAYS READ. Others = only if relevant.**
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
## 🔧 Runtime Scripts
|
|
37
|
+
|
|
38
|
+
**Execute these for audits (don't read, just run):**
|
|
39
|
+
|
|
40
|
+
| Script | Purpose | Usage |
|
|
41
|
+
|--------|---------|-------|
|
|
42
|
+
| `scripts/ux_audit.py` | UX Psychology & Accessibility Audit | `python scripts/ux_audit.py <project_path>` |
|
|
43
|
+
|
|
44
|
+
---
|
|
45
|
+
|
|
46
|
+
## ⚠️ CRITICAL: ASK BEFORE ASSUMING (MANDATORY)
|
|
47
|
+
|
|
48
|
+
> **STOP! If the user's request is open-ended, DO NOT default to your favorites.**
|
|
49
|
+
|
|
50
|
+
### When User Prompt is Vague, ASK:
|
|
51
|
+
|
|
52
|
+
**Color not specified?** Ask:
|
|
53
|
+
> "What color palette do you prefer? (blue/green/orange/neutral/other?)"
|
|
54
|
+
|
|
55
|
+
**Style not specified?** Ask:
|
|
56
|
+
> "What style are you going for? (minimal/bold/retro/futuristic/organic?)"
|
|
57
|
+
|
|
58
|
+
**Layout not specified?** Ask:
|
|
59
|
+
> "Do you have a layout preference? (single column/grid/asymmetric/full-width?)"
|
|
60
|
+
|
|
61
|
+
### ⛔ DEFAULT TENDENCIES TO AVOID (ANTI-SAFE HARBOR):
|
|
62
|
+
|
|
63
|
+
| AI Default Tendency | Why It's Bad | Think Instead |
|
|
64
|
+
|---------------------|--------------|---------------|
|
|
65
|
+
| **Bento Grids (Modern Cliché)** | Used in every AI design | Why does this content NEED a grid? |
|
|
66
|
+
| **Hero Split (Left/Right)** | Predictable & Boring | How about Massive Typography or Vertical Narrative? |
|
|
67
|
+
| **Mesh/Aurora Gradients** | The "new" lazy background | What's a radical color pairing? |
|
|
68
|
+
| **Glassmorphism** | AI's idea of "premium" | How about solid, high-contrast flat? |
|
|
69
|
+
| **Deep Cyan / Fintech Blue** | Safe harbor from purple ban | Why not Red, Black, or Neon Green? |
|
|
70
|
+
| **"Orchestrate / Empower"** | AI-generated copywriting | How would a human say this? |
|
|
71
|
+
| Dark background + neon glow | Overused, "AI look" | What does the BRAND actually need? |
|
|
72
|
+
| **Rounded everything** | Generic/Safe | Where can I use sharp, brutalist edges? |
|
|
73
|
+
|
|
74
|
+
> 🔴 **"Every 'safe' structure you choose brings you one step closer to a generic template. TAKE RISKS."**
|
|
75
|
+
|
|
76
|
+
---
|
|
77
|
+
|
|
78
|
+
## 1. Constraint Analysis (ALWAYS FIRST)
|
|
79
|
+
|
|
80
|
+
Before any design work, ANSWER THESE or ASK USER:
|
|
81
|
+
|
|
82
|
+
| Constraint | Question | Why It Matters |
|
|
83
|
+
|------------|----------|----------------|
|
|
84
|
+
| **Timeline** | How much time? | Determines complexity |
|
|
85
|
+
| **Content** | Ready or placeholder? | Affects layout flexibility |
|
|
86
|
+
| **Brand** | Existing guidelines? | May dictate colors/fonts |
|
|
87
|
+
| **Tech** | What stack? | Affects capabilities |
|
|
88
|
+
| **Audience** | Who exactly? | Drives all visual decisions |
|
|
89
|
+
|
|
90
|
+
### Audience → Design Approach
|
|
91
|
+
|
|
92
|
+
| Audience | Think About |
|
|
93
|
+
|----------|-------------|
|
|
94
|
+
| **Gen Z** | Bold, fast, mobile-first, authentic |
|
|
95
|
+
| **Millennials** | Clean, minimal, value-driven |
|
|
96
|
+
| **Gen X** | Familiar, trustworthy, clear |
|
|
97
|
+
| **Boomers** | Readable, high contrast, simple |
|
|
98
|
+
| **B2B** | Professional, data-focused, trust |
|
|
99
|
+
| **Luxury** | Restrained elegance, whitespace |
|
|
100
|
+
|
|
101
|
+
---
|
|
102
|
+
|
|
103
|
+
## 2. UX Psychology Principles
|
|
104
|
+
|
|
105
|
+
### Core Laws (Internalize These)
|
|
106
|
+
|
|
107
|
+
| Law | Principle | Application |
|
|
108
|
+
|-----|-----------|-------------|
|
|
109
|
+
| **Hick's Law** | More choices = slower decisions | Limit options, use progressive disclosure |
|
|
110
|
+
| **Fitts' Law** | Bigger + closer = easier to click | Size CTAs appropriately |
|
|
111
|
+
| **Miller's Law** | ~7 items in working memory | Chunk content into groups |
|
|
112
|
+
| **Von Restorff** | Different = memorable | Make CTAs visually distinct |
|
|
113
|
+
| **Serial Position** | First/last remembered most | Key info at start/end |
|
|
114
|
+
|
|
115
|
+
### Emotional Design Levels
|
|
116
|
+
|
|
117
|
+
```
|
|
118
|
+
VISCERAL (instant) → First impression: colors, imagery, overall feel
|
|
119
|
+
BEHAVIORAL (use) → Using it: speed, feedback, efficiency
|
|
120
|
+
REFLECTIVE (memory) → After: "I like what this says about me"
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
### Trust Building
|
|
124
|
+
|
|
125
|
+
- Security indicators on sensitive actions
|
|
126
|
+
- Social proof where relevant
|
|
127
|
+
- Clear contact/support access
|
|
128
|
+
- Consistent, professional design
|
|
129
|
+
- Transparent policies
|
|
130
|
+
|
|
131
|
+
---
|
|
132
|
+
|
|
133
|
+
## 3. Layout Principles
|
|
134
|
+
|
|
135
|
+
### Golden Ratio (φ = 1.618)
|
|
136
|
+
|
|
137
|
+
```
|
|
138
|
+
Use for proportional harmony:
|
|
139
|
+
├── Content : Sidebar = roughly 62% : 38%
|
|
140
|
+
├── Each heading size = previous × 1.618 (for dramatic scale)
|
|
141
|
+
├── Spacing can follow: sm → md → lg (each × 1.618)
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
### 8-Point Grid Concept
|
|
145
|
+
|
|
146
|
+
```
|
|
147
|
+
All spacing and sizing in multiples of 8:
|
|
148
|
+
├── Tight: 4px (half-step for micro)
|
|
149
|
+
├── Small: 8px
|
|
150
|
+
├── Medium: 16px
|
|
151
|
+
├── Large: 24px, 32px
|
|
152
|
+
├── XL: 48px, 64px, 80px
|
|
153
|
+
└── Adjust based on content density
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
### Key Sizing Principles
|
|
157
|
+
|
|
158
|
+
| Element | Consideration |
|
|
159
|
+
|---------|---------------|
|
|
160
|
+
| **Touch targets** | Minimum comfortable tap size |
|
|
161
|
+
| **Buttons** | Height based on importance hierarchy |
|
|
162
|
+
| **Inputs** | Match button height for alignment |
|
|
163
|
+
| **Cards** | Consistent padding, breathable |
|
|
164
|
+
| **Reading width** | 45-75 characters optimal |
|
|
165
|
+
|
|
166
|
+
---
|
|
167
|
+
|
|
168
|
+
## 4. Color Principles
|
|
169
|
+
|
|
170
|
+
### 60-30-10 Rule
|
|
171
|
+
|
|
172
|
+
```
|
|
173
|
+
60% → Primary/Background (calm, neutral base)
|
|
174
|
+
30% → Secondary (supporting areas)
|
|
175
|
+
10% → Accent (CTAs, highlights, attention)
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
### Color Psychology (For Decision Making)
|
|
179
|
+
|
|
180
|
+
| If You Need... | Consider Hues | Avoid |
|
|
181
|
+
|----------------|---------------|-------|
|
|
182
|
+
| Trust, calm | Blue family | Aggressive reds |
|
|
183
|
+
| Growth, nature | Green family | Industrial grays |
|
|
184
|
+
| Energy, urgency | Orange, red | Passive blues |
|
|
185
|
+
| Luxury, creativity | Deep Teal, Gold, Emerald | Cheap-feeling brights |
|
|
186
|
+
| Clean, minimal | Neutrals | Overwhelming color |
|
|
187
|
+
|
|
188
|
+
### Selection Process
|
|
189
|
+
|
|
190
|
+
1. **What's the industry?** (narrows options)
|
|
191
|
+
2. **What's the emotion?** (picks primary)
|
|
192
|
+
3. **Light or dark mode?** (sets foundation)
|
|
193
|
+
4. **ASK USER** if not specified
|
|
194
|
+
|
|
195
|
+
For detailed color theory: [color-system.md](color-system.md)
|
|
196
|
+
|
|
197
|
+
---
|
|
198
|
+
|
|
199
|
+
## 5. Typography Principles
|
|
200
|
+
|
|
201
|
+
### Scale Selection
|
|
202
|
+
|
|
203
|
+
| Content Type | Scale Ratio | Feel |
|
|
204
|
+
|--------------|-------------|------|
|
|
205
|
+
| Dense UI | 1.125-1.2 | Compact, efficient |
|
|
206
|
+
| General web | 1.25 | Balanced (most common) |
|
|
207
|
+
| Editorial | 1.333 | Readable, spacious |
|
|
208
|
+
| Hero/display | 1.5-1.618 | Dramatic impact |
|
|
209
|
+
|
|
210
|
+
### Pairing Concept
|
|
211
|
+
|
|
212
|
+
```
|
|
213
|
+
Contrast + Harmony:
|
|
214
|
+
├── DIFFERENT enough for hierarchy
|
|
215
|
+
├── SIMILAR enough for cohesion
|
|
216
|
+
└── Usually: display + neutral, or serif + sans
|
|
217
|
+
```
|
|
218
|
+
|
|
219
|
+
### Readability Rules
|
|
220
|
+
|
|
221
|
+
- **Line length**: 45-75 characters optimal
|
|
222
|
+
- **Line height**: 1.4-1.6 for body text
|
|
223
|
+
- **Contrast**: Check WCAG requirements
|
|
224
|
+
- **Size**: 16px+ for body on web
|
|
225
|
+
|
|
226
|
+
For detailed typography: [typography-system.md](typography-system.md)
|
|
227
|
+
|
|
228
|
+
---
|
|
229
|
+
|
|
230
|
+
## 6. Visual Effects Principles
|
|
231
|
+
|
|
232
|
+
### Glassmorphism (When Appropriate)
|
|
233
|
+
|
|
234
|
+
```
|
|
235
|
+
Key properties:
|
|
236
|
+
├── Semi-transparent background
|
|
237
|
+
├── Backdrop blur
|
|
238
|
+
├── Subtle border for definition
|
|
239
|
+
└── ⚠️ **WARNING:** Standard blue/white glassmorphism is a modern cliché. Use it radically or not at all.
|
|
240
|
+
```
|
|
241
|
+
|
|
242
|
+
### Shadow Hierarchy
|
|
243
|
+
|
|
244
|
+
```
|
|
245
|
+
Elevation concept:
|
|
246
|
+
├── Higher elements = larger shadows
|
|
247
|
+
├── Y-offset > X-offset (light from above)
|
|
248
|
+
├── Multiple layers = more realistic
|
|
249
|
+
└── Dark mode: may need glow instead
|
|
250
|
+
```
|
|
251
|
+
|
|
252
|
+
### Gradient Usage
|
|
253
|
+
|
|
254
|
+
```
|
|
255
|
+
Harmonious gradients:
|
|
256
|
+
├── Adjacent colors on wheel (analogous)
|
|
257
|
+
├── OR same hue, different lightness
|
|
258
|
+
├── Avoid harsh complementary pairs
|
|
259
|
+
├── 🚫 **NO Mesh/Aurora Gradients** (floating blobs)
|
|
260
|
+
└── VARY from project to project radically
|
|
261
|
+
```
|
|
262
|
+
|
|
263
|
+
For complete effects guide: [visual-effects.md](visual-effects.md)
|
|
264
|
+
|
|
265
|
+
---
|
|
266
|
+
|
|
267
|
+
## 7. Animation Principles
|
|
268
|
+
|
|
269
|
+
### Timing Concept
|
|
270
|
+
|
|
271
|
+
```
|
|
272
|
+
Duration based on:
|
|
273
|
+
├── Distance (further = longer)
|
|
274
|
+
├── Size (larger = slower)
|
|
275
|
+
├── Importance (critical = clear)
|
|
276
|
+
└── Context (urgent = fast, luxury = slow)
|
|
277
|
+
```
|
|
278
|
+
|
|
279
|
+
### Easing Selection
|
|
280
|
+
|
|
281
|
+
| Action | Easing | Why |
|
|
282
|
+
|--------|--------|-----|
|
|
283
|
+
| Entering | Ease-out | Decelerate, settle in |
|
|
284
|
+
| Leaving | Ease-in | Accelerate, exit |
|
|
285
|
+
| Emphasis | Ease-in-out | Smooth, deliberate |
|
|
286
|
+
| Playful | Bounce | Fun, energetic |
|
|
287
|
+
|
|
288
|
+
### Performance
|
|
289
|
+
|
|
290
|
+
- Animate only transform and opacity
|
|
291
|
+
- Respect reduced-motion preference
|
|
292
|
+
- Test on low-end devices
|
|
293
|
+
|
|
294
|
+
For animation patterns: [animation-guide.md](animation-guide.md), for advanced: [motion-graphics.md](motion-graphics.md)
|
|
295
|
+
|
|
296
|
+
---
|
|
297
|
+
|
|
298
|
+
## 8. "Wow Factor" Checklist
|
|
299
|
+
|
|
300
|
+
### Premium Indicators
|
|
301
|
+
|
|
302
|
+
- [ ] Generous whitespace (luxury = breathing room)
|
|
303
|
+
- [ ] Subtle depth and dimension
|
|
304
|
+
- [ ] Smooth, purposeful animations
|
|
305
|
+
- [ ] Attention to detail (alignment, consistency)
|
|
306
|
+
- [ ] Cohesive visual rhythm
|
|
307
|
+
- [ ] Custom elements (not all defaults)
|
|
308
|
+
|
|
309
|
+
### Trust Builders
|
|
310
|
+
|
|
311
|
+
- [ ] Security cues where appropriate
|
|
312
|
+
- [ ] Social proof / testimonials
|
|
313
|
+
- [ ] Clear value proposition
|
|
314
|
+
- [ ] Professional imagery
|
|
315
|
+
- [ ] Consistent design language
|
|
316
|
+
|
|
317
|
+
### Emotional Triggers
|
|
318
|
+
|
|
319
|
+
- [ ] Hero that evokes intended emotion
|
|
320
|
+
- [ ] Human elements (faces, stories)
|
|
321
|
+
- [ ] Progress/achievement indicators
|
|
322
|
+
- [ ] Moments of delight
|
|
323
|
+
|
|
324
|
+
---
|
|
325
|
+
|
|
326
|
+
## 9. Anti-Patterns (What NOT to Do)
|
|
327
|
+
|
|
328
|
+
### ❌ Lazy Design Indicators
|
|
329
|
+
|
|
330
|
+
- Default system fonts without consideration
|
|
331
|
+
- Stock imagery that doesn't match
|
|
332
|
+
- Inconsistent spacing
|
|
333
|
+
- Too many competing colors
|
|
334
|
+
- Walls of text without hierarchy
|
|
335
|
+
- Inaccessible contrast
|
|
336
|
+
|
|
337
|
+
### ❌ AI Tendency Patterns (AVOID!)
|
|
338
|
+
|
|
339
|
+
- **Same colors every project**
|
|
340
|
+
- **Dark + neon as default**
|
|
341
|
+
- **Purple/violet everything (PURPLE BAN ✅)**
|
|
342
|
+
- **Bento grids for simple landing pages**
|
|
343
|
+
- **Mesh Gradients & Glow Effects**
|
|
344
|
+
- **Same layout structure / Vercel clone**
|
|
345
|
+
- **Not asking user preferences**
|
|
346
|
+
|
|
347
|
+
### ❌ Dark Patterns (Unethical)
|
|
348
|
+
|
|
349
|
+
- Hidden costs
|
|
350
|
+
- Fake urgency
|
|
351
|
+
- Forced actions
|
|
352
|
+
- Deceptive UI
|
|
353
|
+
- Confirmshaming
|
|
354
|
+
|
|
355
|
+
---
|
|
356
|
+
|
|
357
|
+
## 10. Decision Process Summary
|
|
358
|
+
|
|
359
|
+
```
|
|
360
|
+
For EVERY design task:
|
|
361
|
+
|
|
362
|
+
1. CONSTRAINTS
|
|
363
|
+
└── What's the timeline, brand, tech, audience?
|
|
364
|
+
└── If unclear → ASK
|
|
365
|
+
|
|
366
|
+
2. CONTENT
|
|
367
|
+
└── What content exists?
|
|
368
|
+
└── What's the hierarchy?
|
|
369
|
+
|
|
370
|
+
3. STYLE DIRECTION
|
|
371
|
+
└── What's appropriate for context?
|
|
372
|
+
└── If unclear → ASK (don't default!)
|
|
373
|
+
|
|
374
|
+
4. EXECUTION
|
|
375
|
+
└── Apply principles above
|
|
376
|
+
└── Check against anti-patterns
|
|
377
|
+
|
|
378
|
+
5. REVIEW
|
|
379
|
+
└── "Does this serve the user?"
|
|
380
|
+
└── "Is this different from my defaults?"
|
|
381
|
+
└── "Would I be proud of this?"
|
|
382
|
+
```
|
|
383
|
+
|
|
384
|
+
---
|
|
385
|
+
|
|
386
|
+
## Reference Files
|
|
387
|
+
|
|
388
|
+
For deeper guidance on specific areas:
|
|
389
|
+
|
|
390
|
+
- [color-system.md](color-system.md) - Color theory and selection process
|
|
391
|
+
- [typography-system.md](typography-system.md) - Font pairing and scale decisions
|
|
392
|
+
- [visual-effects.md](visual-effects.md) - Effects principles and techniques
|
|
393
|
+
- [animation-guide.md](animation-guide.md) - Motion design principles
|
|
394
|
+
- [motion-graphics.md](motion-graphics.md) - Advanced: Lottie, GSAP, SVG, 3D, Particles
|
|
395
|
+
- [decision-trees.md](decision-trees.md) - Context-specific templates
|
|
396
|
+
- [ux-psychology.md](ux-psychology.md) - User psychology deep dive
|
|
397
|
+
|
|
398
|
+
---
|
|
399
|
+
|
|
400
|
+
## Related Skills
|
|
401
|
+
|
|
402
|
+
| Skill | When to Use |
|
|
403
|
+
|-------|-------------|
|
|
404
|
+
| **frontend-design** (this) | Before coding - Learn design principles (color, typography, UX psychology) |
|
|
405
|
+
| **[web-design-guidelines](../web-design-guidelines/SKILL.md)** | After coding - Audit for accessibility, performance, and best practices |
|
|
406
|
+
|
|
407
|
+
## Post-Design Workflow
|
|
408
|
+
|
|
409
|
+
After implementing your design, run the audit:
|
|
410
|
+
|
|
411
|
+
```
|
|
412
|
+
1. DESIGN → Read frontend-design principles ← YOU ARE HERE
|
|
413
|
+
2. CODE → Implement the design
|
|
414
|
+
3. AUDIT → Run web-design-guidelines review
|
|
415
|
+
4. FIX → Address findings from audit
|
|
416
|
+
```
|
|
417
|
+
|
|
418
|
+
> **Next Step:** After coding, use `web-design-guidelines` skill to audit your implementation for accessibility, focus states, animations, and performance issues.
|
|
419
|
+
|
|
420
|
+
---
|
|
421
|
+
|
|
422
|
+
> **Remember:** Design is THINKING, not copying. Every project deserves fresh consideration based on its unique context and users. **Avoid the Modern SaaS Safe Harbor!**
|
|
423
|
+
|
|
424
|
+
---
|
|
425
|
+
|
|
426
|
+
## 5. Next.js 16+ Modern Form Patterns
|
|
427
|
+
|
|
428
|
+
> [!IMPORTANT]
|
|
429
|
+
> For Next.js 16+ projects, use the native `next/form` component instead of standard HTML `<form>` for all GET-based search/filter operations.
|
|
430
|
+
|
|
431
|
+
### The `<Form>` Component Advantage
|
|
432
|
+
- **Automatic Client Navigation:** Performs client-side transitions on submit.
|
|
433
|
+
- **Progressive Enhancement:** Works even without JavaScript.
|
|
434
|
+
- **URL Sync:** Automatically encodes input values into search params.
|
|
435
|
+
|
|
436
|
+
### Implementation Example (Search Bar)
|
|
437
|
+
```tsx
|
|
438
|
+
import Form from 'next/form'
|
|
439
|
+
|
|
440
|
+
export default function SearchBar() {
|
|
441
|
+
return (
|
|
442
|
+
<Form action="/search" className="flex gap-2">
|
|
443
|
+
<input
|
|
444
|
+
name="q"
|
|
445
|
+
placeholder="Search products..."
|
|
446
|
+
className="border p-2"
|
|
447
|
+
/>
|
|
448
|
+
<button type="submit">Search</button>
|
|
449
|
+
</Form>
|
|
450
|
+
)
|
|
451
|
+
}
|
|
452
|
+
```
|
|
453
|
+
|
|
454
|
+
### When to use `<Form>` vs. standard `<form>`:
|
|
455
|
+
- **Use `next/form`** for: Search, Filtering, Sorting, Pagination (GET requests).
|
|
456
|
+
- **Use standard `<form>`** for: Mutations, Login, Data Entry (POST requests via Server Actions).
|