@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,306 @@
|
|
|
1
|
+
# Motion Graphics Reference
|
|
2
|
+
|
|
3
|
+
> Advanced animation techniques for premium web experiences - Lottie, GSAP, SVG, 3D, Particles.
|
|
4
|
+
> **Learn the principles, create WOW effects.**
|
|
5
|
+
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## 1. Lottie Animations
|
|
9
|
+
|
|
10
|
+
### What is Lottie?
|
|
11
|
+
|
|
12
|
+
```
|
|
13
|
+
JSON-based vector animations:
|
|
14
|
+
├── Exported from After Effects via Bodymovin
|
|
15
|
+
├── Lightweight (smaller than GIF/video)
|
|
16
|
+
├── Scalable (vector-based, no pixelation)
|
|
17
|
+
├── Interactive (control playback, segments)
|
|
18
|
+
└── Cross-platform (web, iOS, Android, React Native)
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
### When to Use Lottie
|
|
22
|
+
|
|
23
|
+
| Use Case | Why Lottie? |
|
|
24
|
+
|----------|-------------|
|
|
25
|
+
| **Loading animations** | Branded, smooth, lightweight |
|
|
26
|
+
| **Empty states** | Engaging illustrations |
|
|
27
|
+
| **Onboarding flows** | Complex multi-step animations |
|
|
28
|
+
| **Success/Error feedback** | Delightful micro-interactions |
|
|
29
|
+
| **Animated icons** | Consistent cross-platform |
|
|
30
|
+
|
|
31
|
+
### Principles
|
|
32
|
+
|
|
33
|
+
- Keep file size under 100KB for performance
|
|
34
|
+
- Use loop sparingly (avoid distraction)
|
|
35
|
+
- Provide static fallback for reduced-motion
|
|
36
|
+
- Lazy load animation files when possible
|
|
37
|
+
|
|
38
|
+
### Sources
|
|
39
|
+
|
|
40
|
+
- LottieFiles.com (free library)
|
|
41
|
+
- After Effects + Bodymovin (custom)
|
|
42
|
+
- Figma plugins (export from design)
|
|
43
|
+
|
|
44
|
+
---
|
|
45
|
+
|
|
46
|
+
## 2. GSAP (GreenSock)
|
|
47
|
+
|
|
48
|
+
### What Makes GSAP Different
|
|
49
|
+
|
|
50
|
+
```
|
|
51
|
+
Professional timeline-based animation:
|
|
52
|
+
├── Precise control over sequences
|
|
53
|
+
├── ScrollTrigger for scroll-driven animations
|
|
54
|
+
├── MorphSVG for shape transitions
|
|
55
|
+
├── Physics-based easing
|
|
56
|
+
└── Works with any DOM element
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
### Core Concepts
|
|
60
|
+
|
|
61
|
+
| Concept | Purpose |
|
|
62
|
+
|---------|---------|
|
|
63
|
+
| **Tween** | Single A→B animation |
|
|
64
|
+
| **Timeline** | Sequenced/overlapping animations |
|
|
65
|
+
| **ScrollTrigger** | Scroll position controls playback |
|
|
66
|
+
| **Stagger** | Cascade effect across elements |
|
|
67
|
+
|
|
68
|
+
### When to Use GSAP
|
|
69
|
+
|
|
70
|
+
- ✅ Complex sequenced animations
|
|
71
|
+
- ✅ Scroll-triggered reveals
|
|
72
|
+
- ✅ Precise timing control needed
|
|
73
|
+
- ✅ SVG morphing effects
|
|
74
|
+
- ❌ Simple hover/focus effects (use CSS)
|
|
75
|
+
- ❌ Performance-critical mobile (heavier)
|
|
76
|
+
|
|
77
|
+
### Principles
|
|
78
|
+
|
|
79
|
+
- Use timeline for orchestration (not individual tweens)
|
|
80
|
+
- Stagger delay: 0.05-0.15s between items
|
|
81
|
+
- ScrollTrigger: start at 70-80% viewport entry
|
|
82
|
+
- Kill animations on unmount (prevent memory leaks)
|
|
83
|
+
|
|
84
|
+
---
|
|
85
|
+
|
|
86
|
+
## 3. SVG Animations
|
|
87
|
+
|
|
88
|
+
### Types of SVG Animation
|
|
89
|
+
|
|
90
|
+
| Type | Technique | Use Case |
|
|
91
|
+
|------|-----------|----------|
|
|
92
|
+
| **Line Drawing** | stroke-dashoffset | Logo reveals, signatures |
|
|
93
|
+
| **Morph** | Path interpolation | Icon transitions |
|
|
94
|
+
| **Transform** | rotate, scale, translate | Interactive icons |
|
|
95
|
+
| **Color** | fill/stroke transition | State changes |
|
|
96
|
+
|
|
97
|
+
### Line Drawing Principles
|
|
98
|
+
|
|
99
|
+
```
|
|
100
|
+
How stroke-dashoffset drawing works:
|
|
101
|
+
├── Set dasharray to path length
|
|
102
|
+
├── Set dashoffset equal to dasharray (hidden)
|
|
103
|
+
├── Animate dashoffset to 0 (revealed)
|
|
104
|
+
└── Create "drawing" effect
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
### When to Use SVG Animations
|
|
108
|
+
|
|
109
|
+
- ✅ Logo reveals, brand moments
|
|
110
|
+
- ✅ Icon state transitions (hamburger ↔ X)
|
|
111
|
+
- ✅ Infographics, data visualization
|
|
112
|
+
- ✅ Interactive illustrations
|
|
113
|
+
- ❌ Photo-realistic content (use video)
|
|
114
|
+
- ❌ Very complex scenes (performance)
|
|
115
|
+
|
|
116
|
+
### Principles
|
|
117
|
+
|
|
118
|
+
- Get path length dynamically for accuracy
|
|
119
|
+
- Duration: 1-3s for full drawings
|
|
120
|
+
- Easing: ease-out for natural feel
|
|
121
|
+
- Simple fills complement, don't compete
|
|
122
|
+
|
|
123
|
+
---
|
|
124
|
+
|
|
125
|
+
## 4. 3D CSS Transforms
|
|
126
|
+
|
|
127
|
+
### Core Properties
|
|
128
|
+
|
|
129
|
+
```
|
|
130
|
+
CSS 3D Space:
|
|
131
|
+
├── perspective: depth of 3D field (500-1500px typical)
|
|
132
|
+
├── transform-style: preserve-3d (enable children 3D)
|
|
133
|
+
├── rotateX/Y/Z: rotation per axis
|
|
134
|
+
├── translateZ: move toward/away from viewer
|
|
135
|
+
└── backface-visibility: show/hide back side
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
### Common 3D Patterns
|
|
139
|
+
|
|
140
|
+
| Pattern | Use Case |
|
|
141
|
+
|---------|----------|
|
|
142
|
+
| **Card flip** | Reveals, flashcards, product views |
|
|
143
|
+
| **Tilt on hover** | Interactive cards, 3D depth |
|
|
144
|
+
| **Parallax layers** | Hero sections, immersive scrolling |
|
|
145
|
+
| **3D carousel** | Image galleries, sliders |
|
|
146
|
+
|
|
147
|
+
### Principles
|
|
148
|
+
|
|
149
|
+
- Perspective: 800-1200px for subtle, 400-600px for dramatic
|
|
150
|
+
- Keep transforms simple (rotate + translate)
|
|
151
|
+
- Ensure backface-visibility: hidden for flips
|
|
152
|
+
- Test on Safari (different rendering)
|
|
153
|
+
|
|
154
|
+
---
|
|
155
|
+
|
|
156
|
+
## 5. Particle Effects
|
|
157
|
+
|
|
158
|
+
### Types of Particle Systems
|
|
159
|
+
|
|
160
|
+
| Type | Feel | Use Case |
|
|
161
|
+
|------|------|----------|
|
|
162
|
+
| **Geometric** | Tech, network | SaaS, tech sites |
|
|
163
|
+
| **Confetti** | Celebration | Success moments |
|
|
164
|
+
| **Snow/Rain** | Atmospheric | Seasonal, mood |
|
|
165
|
+
| **Dust/Bokeh** | Dreamy | Photography, luxury |
|
|
166
|
+
| **Fireflies** | Magical | Games, fantasy |
|
|
167
|
+
|
|
168
|
+
### Libraries
|
|
169
|
+
|
|
170
|
+
| Library | Best For |
|
|
171
|
+
|---------|----------|
|
|
172
|
+
| **tsParticles** | Configurable, lightweight |
|
|
173
|
+
| **particles.js** | Simple backgrounds |
|
|
174
|
+
| **Canvas API** | Custom, maximum control |
|
|
175
|
+
| **Three.js** | Complex 3D particles |
|
|
176
|
+
|
|
177
|
+
### Principles
|
|
178
|
+
|
|
179
|
+
- Default: 30-50 particles (not overwhelming)
|
|
180
|
+
- Movement: slow, organic (speed 0.5-2)
|
|
181
|
+
- Opacity: 0.3-0.6 (don't compete with content)
|
|
182
|
+
- Connections: subtle lines for "network" feel
|
|
183
|
+
- ⚠️ Disable or reduce on mobile
|
|
184
|
+
|
|
185
|
+
### When to Use
|
|
186
|
+
|
|
187
|
+
- ✅ Hero backgrounds (atmospheric)
|
|
188
|
+
- ✅ Success celebrations (confetti burst)
|
|
189
|
+
- ✅ Tech visualization (connected nodes)
|
|
190
|
+
- ❌ Content-heavy pages (distraction)
|
|
191
|
+
- ❌ Low-powered devices (battery drain)
|
|
192
|
+
|
|
193
|
+
---
|
|
194
|
+
|
|
195
|
+
## 6. Scroll-Driven Animations
|
|
196
|
+
|
|
197
|
+
### Native CSS (Modern)
|
|
198
|
+
|
|
199
|
+
```
|
|
200
|
+
CSS Scroll Timelines:
|
|
201
|
+
├── animation-timeline: scroll() - document scroll
|
|
202
|
+
├── animation-timeline: view() - element in viewport
|
|
203
|
+
├── animation-range: entry/exit thresholds
|
|
204
|
+
└── No JavaScript required
|
|
205
|
+
```
|
|
206
|
+
|
|
207
|
+
### Principles
|
|
208
|
+
|
|
209
|
+
| Trigger Point | Use Case |
|
|
210
|
+
|---------------|----------|
|
|
211
|
+
| **Entry 0%** | When element starts entering |
|
|
212
|
+
| **Entry 50%** | When half visible |
|
|
213
|
+
| **Cover 50%** | When centered in viewport |
|
|
214
|
+
| **Exit 100%** | When fully exited |
|
|
215
|
+
|
|
216
|
+
### Best Practices
|
|
217
|
+
|
|
218
|
+
- Reveal animations: start at ~25% entry
|
|
219
|
+
- Parallax: continuous scroll progress
|
|
220
|
+
- Sticky elements: use cover range
|
|
221
|
+
- Always test scroll performance
|
|
222
|
+
|
|
223
|
+
---
|
|
224
|
+
|
|
225
|
+
## 7. Performance Principles
|
|
226
|
+
|
|
227
|
+
### GPU vs CPU Animation
|
|
228
|
+
|
|
229
|
+
```
|
|
230
|
+
CHEAP (GPU-accelerated):
|
|
231
|
+
├── transform (translate, scale, rotate)
|
|
232
|
+
├── opacity
|
|
233
|
+
└── filter (use sparingly)
|
|
234
|
+
|
|
235
|
+
EXPENSIVE (triggers reflow):
|
|
236
|
+
├── width, height
|
|
237
|
+
├── top, left, right, bottom
|
|
238
|
+
├── padding, margin
|
|
239
|
+
└── complex box-shadow
|
|
240
|
+
```
|
|
241
|
+
|
|
242
|
+
### Optimization Checklist
|
|
243
|
+
|
|
244
|
+
- [ ] Animate only transform/opacity
|
|
245
|
+
- [ ] Use `will-change` before heavy animations (remove after)
|
|
246
|
+
- [ ] Test on low-end devices
|
|
247
|
+
- [ ] Implement `prefers-reduced-motion`
|
|
248
|
+
- [ ] Lazy load animation libraries
|
|
249
|
+
- [ ] Throttle scroll-based calculations
|
|
250
|
+
|
|
251
|
+
---
|
|
252
|
+
|
|
253
|
+
## 8. Motion Graphics Decision Tree
|
|
254
|
+
|
|
255
|
+
```
|
|
256
|
+
What animation do you need?
|
|
257
|
+
│
|
|
258
|
+
├── Complex branded animation?
|
|
259
|
+
│ └── Lottie (After Effects export)
|
|
260
|
+
│
|
|
261
|
+
├── Sequenced scroll-triggered?
|
|
262
|
+
│ └── GSAP + ScrollTrigger
|
|
263
|
+
│
|
|
264
|
+
├── Logo/icon animation?
|
|
265
|
+
│ └── SVG animation (stroke or morph)
|
|
266
|
+
│
|
|
267
|
+
├── Interactive 3D effect?
|
|
268
|
+
│ └── CSS 3D Transforms (simple) or Three.js (complex)
|
|
269
|
+
│
|
|
270
|
+
├── Atmospheric background?
|
|
271
|
+
│ └── tsParticles or Canvas
|
|
272
|
+
│
|
|
273
|
+
└── Simple entrance/hover?
|
|
274
|
+
└── CSS @keyframes or Framer Motion
|
|
275
|
+
```
|
|
276
|
+
|
|
277
|
+
---
|
|
278
|
+
|
|
279
|
+
## 9. Anti-Patterns
|
|
280
|
+
|
|
281
|
+
| ❌ Don't | ✅ Do |
|
|
282
|
+
|----------|-------|
|
|
283
|
+
| Animate everything at once | Stagger and sequence |
|
|
284
|
+
| Use heavy libraries for simple effects | Start with CSS |
|
|
285
|
+
| Ignore reduced-motion | Always provide fallback |
|
|
286
|
+
| Block main thread | Optimize for 60fps |
|
|
287
|
+
| Same particles every project | Match brand/context |
|
|
288
|
+
| Complex effects on mobile | Feature detection |
|
|
289
|
+
|
|
290
|
+
---
|
|
291
|
+
|
|
292
|
+
## 10. Quick Reference
|
|
293
|
+
|
|
294
|
+
| Effect | Tool | Performance |
|
|
295
|
+
|--------|------|-------------|
|
|
296
|
+
| Loading spinner | CSS/Lottie | Light |
|
|
297
|
+
| Staggered reveal | GSAP/Framer | Medium |
|
|
298
|
+
| SVG path draw | CSS stroke | Light |
|
|
299
|
+
| 3D card flip | CSS transforms | Light |
|
|
300
|
+
| Particle background | tsParticles | Heavy |
|
|
301
|
+
| Scroll parallax | GSAP ScrollTrigger | Medium |
|
|
302
|
+
| Shape morphing | GSAP MorphSVG | Medium |
|
|
303
|
+
|
|
304
|
+
---
|
|
305
|
+
|
|
306
|
+
> **Remember**: Motion graphics should enhance, not distract. Every animation must serve a PURPOSE—feedback, guidance, delight, or storytelling.
|
|
@@ -0,0 +1,163 @@
|
|
|
1
|
+
# Design Guidelines: [Project Name]
|
|
2
|
+
|
|
3
|
+
_Generated: [Date]_
|
|
4
|
+
|
|
5
|
+
## Design Style
|
|
6
|
+
|
|
7
|
+
[Specify: Minimalism, Glassmorphism, Neo-brutalism, Modern, Memphis, Flat Design, etc.]
|
|
8
|
+
|
|
9
|
+
## Color Palette
|
|
10
|
+
|
|
11
|
+
### Primary Colors
|
|
12
|
+
- **Primary**: `#000000` - [Description/Usage]
|
|
13
|
+
- **Secondary**: `#000000` - [Description/Usage]
|
|
14
|
+
|
|
15
|
+
### Accent Colors
|
|
16
|
+
- **Accent**: `#000000` - [Description/Usage]
|
|
17
|
+
- **Success**: `#000000` - [Description/Usage]
|
|
18
|
+
- **Warning**: `#000000` - [Description/Usage]
|
|
19
|
+
- **Error**: `#000000` - [Description/Usage]
|
|
20
|
+
|
|
21
|
+
### Neutral Colors
|
|
22
|
+
- **Background**: `#000000` - [Description/Usage]
|
|
23
|
+
- **Surface**: `#000000` - [Description/Usage]
|
|
24
|
+
- **Border**: `#000000` - [Description/Usage]
|
|
25
|
+
|
|
26
|
+
### Color Psychology
|
|
27
|
+
[Explain mood and emotions evoked by color choices]
|
|
28
|
+
|
|
29
|
+
## Typography System
|
|
30
|
+
|
|
31
|
+
### Font Families
|
|
32
|
+
- **Primary Font**: [Font Name] - Body text, paragraphs
|
|
33
|
+
- **Secondary Font**: [Font Name] - Headings, emphasis
|
|
34
|
+
- **Monospace Font**: [Font Name] - Code, technical content
|
|
35
|
+
|
|
36
|
+
### Font Hierarchy
|
|
37
|
+
- **H1**: [Size]px / [Weight] / [Line Height] - [Usage]
|
|
38
|
+
- **H2**: [Size]px / [Weight] / [Line Height] - [Usage]
|
|
39
|
+
- **H3**: [Size]px / [Weight] / [Line Height] - [Usage]
|
|
40
|
+
- **Body**: [Size]px / [Weight] / [Line Height] - [Usage]
|
|
41
|
+
- **Small**: [Size]px / [Weight] / [Line Height] - [Usage]
|
|
42
|
+
|
|
43
|
+
### Typography Guidelines
|
|
44
|
+
- Line length: [Character count] characters max
|
|
45
|
+
- Paragraph spacing: [Value]
|
|
46
|
+
- Letter spacing: [Value]
|
|
47
|
+
|
|
48
|
+
## Layout Principles
|
|
49
|
+
|
|
50
|
+
### Grid System
|
|
51
|
+
- Columns: [Number]
|
|
52
|
+
- Gutter: [Size]px
|
|
53
|
+
- Margin: [Size]px
|
|
54
|
+
- Max width: [Size]px
|
|
55
|
+
|
|
56
|
+
### Spacing Scale
|
|
57
|
+
- xs: [Size]px
|
|
58
|
+
- sm: [Size]px
|
|
59
|
+
- md: [Size]px
|
|
60
|
+
- lg: [Size]px
|
|
61
|
+
- xl: [Size]px
|
|
62
|
+
- 2xl: [Size]px
|
|
63
|
+
|
|
64
|
+
### Responsive Breakpoints
|
|
65
|
+
- Mobile: [Width]px
|
|
66
|
+
- Tablet: [Width]px
|
|
67
|
+
- Desktop: [Width]px
|
|
68
|
+
- Wide: [Width]px
|
|
69
|
+
|
|
70
|
+
## Component Styling
|
|
71
|
+
|
|
72
|
+
### Buttons
|
|
73
|
+
- **Primary**: [Description of style]
|
|
74
|
+
- **Secondary**: [Description of style]
|
|
75
|
+
- **Ghost**: [Description of style]
|
|
76
|
+
- **Sizes**: [List sizes]
|
|
77
|
+
- **States**: Default, Hover, Active, Disabled
|
|
78
|
+
|
|
79
|
+
### Cards
|
|
80
|
+
- Border radius: [Value]
|
|
81
|
+
- Shadow: [Value]
|
|
82
|
+
- Padding: [Value]
|
|
83
|
+
- Background: [Color]
|
|
84
|
+
|
|
85
|
+
### Forms
|
|
86
|
+
- Input height: [Value]
|
|
87
|
+
- Border radius: [Value]
|
|
88
|
+
- Focus state: [Description]
|
|
89
|
+
- Error state: [Description]
|
|
90
|
+
|
|
91
|
+
### Navigation
|
|
92
|
+
- [Description of nav patterns]
|
|
93
|
+
|
|
94
|
+
## Visual Hierarchy
|
|
95
|
+
|
|
96
|
+
### Emphasis Techniques
|
|
97
|
+
- [List how to draw attention: size, color, placement, etc.]
|
|
98
|
+
|
|
99
|
+
### Content Flow
|
|
100
|
+
- [Describe reading patterns: F-pattern, Z-pattern, etc.]
|
|
101
|
+
|
|
102
|
+
## Micro-Interactions
|
|
103
|
+
|
|
104
|
+
### Animation Timing
|
|
105
|
+
- Fast: 150ms - [Usage]
|
|
106
|
+
- Normal: 250ms - [Usage]
|
|
107
|
+
- Slow: 350ms - [Usage]
|
|
108
|
+
|
|
109
|
+
### Easing Curves
|
|
110
|
+
- Ease-out: [Usage]
|
|
111
|
+
- Ease-in: [Usage]
|
|
112
|
+
- Spring: [Usage]
|
|
113
|
+
|
|
114
|
+
### Interactive States
|
|
115
|
+
- Hover: [Description]
|
|
116
|
+
- Active: [Description]
|
|
117
|
+
- Focus: [Description]
|
|
118
|
+
- Loading: [Description]
|
|
119
|
+
|
|
120
|
+
## Accessibility
|
|
121
|
+
|
|
122
|
+
### Contrast Ratios
|
|
123
|
+
- Text: [Ratio] (WCAG AA: 4.5:1 minimum)
|
|
124
|
+
- Large text: [Ratio] (WCAG AA: 3:1 minimum)
|
|
125
|
+
- UI elements: [Ratio]
|
|
126
|
+
|
|
127
|
+
### Focus Indicators
|
|
128
|
+
- [Description of focus styles]
|
|
129
|
+
|
|
130
|
+
### Touch Targets
|
|
131
|
+
- Minimum size: 44x44px
|
|
132
|
+
|
|
133
|
+
## Design Highlights
|
|
134
|
+
|
|
135
|
+
### What Works Well
|
|
136
|
+
- [List successful design decisions]
|
|
137
|
+
|
|
138
|
+
### Unique Elements
|
|
139
|
+
- [List distinctive design features]
|
|
140
|
+
|
|
141
|
+
### Brand Alignment
|
|
142
|
+
- [Explain how design supports brand identity]
|
|
143
|
+
|
|
144
|
+
## Implementation Notes
|
|
145
|
+
|
|
146
|
+
### Technologies
|
|
147
|
+
- [List frameworks, libraries, tools used]
|
|
148
|
+
|
|
149
|
+
### Performance Considerations
|
|
150
|
+
- [List optimization strategies]
|
|
151
|
+
|
|
152
|
+
### Browser Support
|
|
153
|
+
- [List supported browsers/versions]
|
|
154
|
+
|
|
155
|
+
## Resources
|
|
156
|
+
|
|
157
|
+
### Design Files
|
|
158
|
+
- Figma: [Link]
|
|
159
|
+
- Assets: [Link]
|
|
160
|
+
|
|
161
|
+
### Related Documentation
|
|
162
|
+
- [Link to design-story.md]
|
|
163
|
+
- [Link to component library]
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
# Design Principles: Beautiful & Right
|
|
2
|
+
|
|
3
|
+
## BEAUTIFUL: Understanding Aesthetic Principles
|
|
4
|
+
|
|
5
|
+
### Study Process
|
|
6
|
+
Analyze high-quality designs on Dribbble, Mobbin, Behance. Ask AI to identify:
|
|
7
|
+
- Design styles (Memphis, Flat Design, Glassmorphism, Neo-brutalism, Minimalism)
|
|
8
|
+
- Layout structures & applications
|
|
9
|
+
- Typography systems (font pairing, hierarchy, scaling)
|
|
10
|
+
- Color systems (palettes, contrasts, psychology)
|
|
11
|
+
|
|
12
|
+
### Visual Hierarchy
|
|
13
|
+
Guide users through interfaces effectively:
|
|
14
|
+
- **Size**: Larger elements draw attention first
|
|
15
|
+
- **Contrast**: High contrast (text/background) boosts readability
|
|
16
|
+
- **Typography**: Use weight, size, style for hierarchy
|
|
17
|
+
- **Placement**: F-pattern (web), Z-pattern (landing pages)
|
|
18
|
+
- **Spacing**: White space improves clarity, reduces cognitive load
|
|
19
|
+
|
|
20
|
+
### Typography Best Practices
|
|
21
|
+
- Stick to 2-3 typefaces max
|
|
22
|
+
- Clear font hierarchy with proper spacing, sizes, alignment
|
|
23
|
+
- Appropriate font sizes for readability across devices
|
|
24
|
+
- Short, scannable paragraphs
|
|
25
|
+
|
|
26
|
+
### Color Theory Applications
|
|
27
|
+
- **Blue**: Trust, security, calmness
|
|
28
|
+
- **Red**: Urgency, passion, excitement
|
|
29
|
+
- **Warm colors**: Drive urgency
|
|
30
|
+
- **Cool colors**: Create trust
|
|
31
|
+
- Use color intentionally to direct attention & evoke emotion
|
|
32
|
+
- Ensure WCAG AA contrast ratios (4.5:1 text, 3:1 large text)
|
|
33
|
+
|
|
34
|
+
### White Space
|
|
35
|
+
Not empty—essential for clarity. Proper spacing between sections, buttons, text improves readability & gives visual breathing room.
|
|
36
|
+
|
|
37
|
+
## RIGHT: Ensuring Functionality
|
|
38
|
+
|
|
39
|
+
### Design Systems Research
|
|
40
|
+
Search "Figma Design System + [style]" to understand:
|
|
41
|
+
- Component architecture (atomic design: atoms → molecules → organisms)
|
|
42
|
+
- Layout principles (grid systems, responsive breakpoints)
|
|
43
|
+
- UX patterns & interactions
|
|
44
|
+
|
|
45
|
+
### Component Library Standards
|
|
46
|
+
- Semantic HTML first (button > div with ARIA roles)
|
|
47
|
+
- Built-in accessibility, focus handling, keyboard interaction
|
|
48
|
+
- Each component tested for accessibility before adding
|
|
49
|
+
- Documentation includes structure, focus order, keyboard expectations, screen reader announcements
|
|
50
|
+
|
|
51
|
+
### Accessibility Requirements
|
|
52
|
+
- WCAG 2.1 AA minimum (work toward 2.2)
|
|
53
|
+
- Color contrast ratios meet/exceed minimums
|
|
54
|
+
- Alt text for images
|
|
55
|
+
- Color-blind-friendly palettes
|
|
56
|
+
- Keyboard navigation support
|
|
57
|
+
- Screen reader compatibility
|
|
58
|
+
|
|
59
|
+
### Testing Protocol
|
|
60
|
+
- Automated tools catch 30-50% of issues
|
|
61
|
+
- Manual testing crucial for comprehensive coverage
|
|
62
|
+
- Test with real users when possible
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
# Design Resources & Tools
|
|
2
|
+
|
|
3
|
+
## Inspiration Platforms
|
|
4
|
+
|
|
5
|
+
### Design Galleries
|
|
6
|
+
- **Dribbble**: High-quality UI/UX designs, trending styles
|
|
7
|
+
- **Mobbin**: Mobile app design patterns, real-world examples
|
|
8
|
+
- **Behance**: Creative portfolios, comprehensive projects
|
|
9
|
+
- **Awwwards**: Award-winning web experiences
|
|
10
|
+
- **21st.dev**: Component animations, micro-interactions
|
|
11
|
+
- **CSS Design Awards**: Cutting-edge web designs
|
|
12
|
+
|
|
13
|
+
### Design Systems
|
|
14
|
+
Search pattern: "Figma Design System + [style name]"
|
|
15
|
+
- Material Design (Google)
|
|
16
|
+
- Human Interface Guidelines (Apple)
|
|
17
|
+
- Carbon Design System (IBM)
|
|
18
|
+
- Ant Design
|
|
19
|
+
- Shadcn UI
|
|
20
|
+
- Atlassian Design System
|
|
21
|
+
|
|
22
|
+
## AI Tools for Design
|
|
23
|
+
|
|
24
|
+
### Generation
|
|
25
|
+
- **Gemini**: Image generation via ai-multimodal skill
|
|
26
|
+
- **Claude**: Design variations, component code
|
|
27
|
+
|
|
28
|
+
### Prompt Structure
|
|
29
|
+
Include in prompts:
|
|
30
|
+
- Task description
|
|
31
|
+
- Preferred design style
|
|
32
|
+
- Color palette
|
|
33
|
+
- Typography preferences
|
|
34
|
+
- Target audience/user story
|
|
35
|
+
- Animation specifications
|
|
36
|
+
|
|
37
|
+
## MCP Integrations
|
|
38
|
+
|
|
39
|
+
### Available MCPs
|
|
40
|
+
- **Chrome MCP**: Research designs, analyze trends from Dribbble/Mobbin
|
|
41
|
+
- **Figma MCP**: Code based on community designs
|
|
42
|
+
- **Freepik MCP**: Access stock imagery
|
|
43
|
+
- **ChatGPT-Image MCP**: Image resources
|
|
44
|
+
- **gallery-dl**: Download reference images via bash
|
|
45
|
+
|
|
46
|
+
### Usage
|
|
47
|
+
Connect MCPs for enhanced capabilities when researching, analyzing, or implementing designs.
|
|
48
|
+
|
|
49
|
+
## Development Approach
|
|
50
|
+
|
|
51
|
+
### Git Worktrees Strategy
|
|
52
|
+
Maintain separate branches for different design style variations during development.
|
|
53
|
+
Allows parallel exploration of Minimalist, Modern, Glassmorphism interpretations.
|
|
54
|
+
|
|
55
|
+
### Parallel Agents
|
|
56
|
+
Use multiple agents to generate design style variations simultaneously, compare approaches.
|
|
57
|
+
|
|
58
|
+
## Documentation Standards
|
|
59
|
+
|
|
60
|
+
### Required Files
|
|
61
|
+
Create in `./docs/` directory:
|
|
62
|
+
- **design-guideline.md**: Color patterns, typography, layout principles, component styling, design highlights
|
|
63
|
+
- **design-story.md**: Narrative elements, thematic decisions, user journey considerations
|
|
64
|
+
|
|
65
|
+
### Content
|
|
66
|
+
Document:
|
|
67
|
+
- Rationale for design decisions
|
|
68
|
+
- Style guide (colors, fonts, spacing)
|
|
69
|
+
- Component patterns & usage
|
|
70
|
+
- Responsive breakpoints
|
|
71
|
+
- Accessibility considerations
|
|
72
|
+
- Brand alignment
|
|
73
|
+
|
|
74
|
+
### Maintenance
|
|
75
|
+
Update during development. Use development rules to remind Claude Code to follow guidelines consistently.
|