Communitygithub.com

edneymatias/antigravity-laravel-kit

Design thinking e tomada de decisão para UI web. Use ao projetar componentes, layouts, esquemas de cores, tipografia ou criar interfaces estéticas. Ensina princípios, não valores fixos.

O que é antigravity-laravel-kit?

Este skill fornece um sistema de design frontend focado em princípios de pensamento de design, psicologia do usuário e tomada de decisão estética, em vez de valores fixos. Ele é projetado para ajudar desenvolvedores e designers a criar interfaces web que são esteticamente agradáveis, centradas no usuário e que evitam padrões genéricos de IA. O conteúdo é organizado em seções que cobrem psicologia UX, princípios de cores, tipografia, layout, efeitos visuais e animação, com ênfase em fazer perguntas e evitar suposições. Suporta fluxos de trabalho de design para várias plataformas (web, mobile) e é especialmente útil ao projetar componentes, layouts, esquemas de cores, tipografia ou criar interfaces estéticas. O skill inclui regras rigorosas para evitar padrões de IA excessivamente usados (como Bento grids, Glassmorphism e gradientes Aurora) e incentiva a tomada de riscos com base no contexto do projeto.

Funciona com✓Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/edneymatias/antigravity-laravel-kit/tree/HEAD/.agent/skills/frontend-design

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Sistema de Design Frontend

Filosofia: Cada pixel tem um propósito. Moderação é luxo. A psicologia do usuário impulsiona as decisões. Princípio Central: PENSE, não decore. PERGUNTE, não suponha.


🎯 Regra de Leitura Seletiva (OBRIGATÓRIA)

Leia os arquivos REQUERIDOS sempre, os OPCIONAIS apenas quando necessário:

ArquivoStatusQuando Ler
ux-psychology.md🔴 REQUERIDOSempre leia primeiro!
color-system.md⚪ OpcionalDecisões de cor/paleta
typography-system.md⚪ OpcionalSeleção/combinação de fontes
visual-effects.md⚪ OpcionalGlassmorphism, sombras, gradientes
animation-guide.md⚪ OpcionalAnimação necessária
motion-graphics.md⚪ OpcionalLottie, GSAP, 3D
decision-trees.md⚪ OpcionalModelos de contexto

🔴 ux-psychology.md = LEIA SEMPRE. Os outros = apenas se relevante.


🔧 Scripts de Execução

Execute estes para auditorias (não leia, apenas execute):

ScriptPropósitoUso
Auditoria ManualAuditoria de Psicologia UX e AcessibilidadeUse ferramentas de desenvolvedor do navegador e Lighthouse

⚠️ CRÍTICO: PERGUNTE ANTES DE SUPOR (OBRIGATÓRIO)

PARE! Se a solicitação do usuário for aberta, NÃO use seus padrões favoritos.

Quando o Prompt do Usuário for Vago, PERGUNTE:

Cor não especificada? Pergunte:

"Qual paleta de cores você prefere? (azul/verde/laranja/neutro/outro?)"

Estilo não especificado? Pergunte:

"Qual estilo você está buscando? (minimalista/ousado/retrô/futurista/orgânico?)"

Layout não especificado? Pergunte:

"Você tem uma preferência de layout? (coluna única/grid/assimétrico/largura total?)"

⛔ TENDÊNCIAS PADRÃO A EVITAR (PORTO SEGURO ANTIPADRÃO):

Tendência Padrão de IAPor Que é RuimPense em Vez Disso
Bento Grids (Clichê Moderno)Usado em todo design de IAPor que este conteúdo PRECISA de um grid?
Hero Split (Esquerda/Direita)Previsível e EntedianteQue tal Tipografia Massiva ou Narrativa Vertical?
Gradientes Mesh/AuroraO fundo preguiçoso "novo"Qual é uma combinação radical de cores?
GlassmorphismA ideia de IA de "premium"Que tal um plano sólido e de alto contraste?
Ciano Escuro / Azul FintechPorto seguro da proibição roxaPor que não Vermelho, Preto ou Verde Neon?
"Orquestrar / Capacitar"Copywriting gerado por IAComo um humano diria isso?
Fundo escuro + brilho neonExagerado, "aparência de IA"O que a MARCA realmente precisa?
Tudo arredondadoGenérico/SeguroOnde posso usar arestas afiadas e brutalistas?

🔴 "Cada estrutura 'segura' que você escolher te aproxima um passo de um modelo genérico. ASSUMA RISCOS."


1. Análise de Restrições (SEMPRE PRIMEIRO)

Antes de qualquer trabalho de design, RESPONDA ISTO ou PERGUNTE AO USUÁRIO:

RestriçãoPerguntaPor Que Importa
CronogramaQuanto tempo?Determina a complexidade
ConteúdoPronto ou placeholder?Afeta a flexibilidade do layout
MarcaDiretrizes existentes?Pode ditar cores/fontes
TecnologiaQual stack?Afeta as capacidades
PúblicoQuem exatamente?Orienta todas as decisões visuais

Público → Abordagem de Design

PúblicoPense Sobre
Geração ZOusado, rápido, mobile-first, autêntico
MillennialsLimpo, minimalista, orientado a valor
Geração XFamiliar, confiável, claro
BoomersLegível, alto contraste, simples
B2BProfissional, focado em dados, confiança
LuxoElegância comedida, espaços em branco

2. Princípios de Psicologia UX

Leis Fundamentais (Internalize Estas)

LeiPrincípioAplicação
Lei de HickMais escolhas = decisões mais lentasLimite opções, use divulgação progressiva
Lei de FittsMaior + mais perto = mais fácil de clicarTamanho adequado de CTAs
Lei de Miller~7 itens na memória de trabalhoAgrupe conteúdo em blocos
Von RestorffDiferente = memorávelTorne CTAs visualmente distintos
Posição SerialPrimeiro/último lembrado maisInformações-chave no início/fim

Níveis de Design Emocional

VISCERAL (instantâneo) → Primeira impressão: cores, imagens, sensação geral
COMPORTAMENTAL (uso)   → Usando: velocidade, feedback, eficiência
REFLEXIVO (memória)   → Depois: "Gosto do que isso diz sobre mim"

Construção de Confiança

  • Indicadores de segurança em ações sensíveis
  • Prova social quando relevante
  • Acesso claro a contato/suporte
  • Design consistente e profissional
  • Políticas transparentes

3. Princípios de Layout

Proporção Áurea (φ = 1,618)

Use para harmonia proporcional:
├── Conteúdo : Sidebar = aproximadamente 62% : 38%
├── Cada tamanho de título = anterior × 1,618 (para escala dramática)
├── Espaçamento pode seguir: sm → md → lg (cada × 1,618)

Conceito de Grid de 8 Pontos

Todo espaçamento e dimensionamento em múltiplos de 8:
├── Apertado: 4px (meio-passo para micro)
├── Pequeno: 8px
├── Médio: 16px
├── Grande: 24px, 32px
├── Extra Grande: 48px, 64px, 80px
└── Ajuste com base na densidade do conteúdo

Princípios Chave de Dimensionamento

ElementoConsideração
Alvos de toqueTamanho mínimo confortável para toque
BotõesAltura baseada na hierarquia de importância
InputsCombine altura do botão para alinhamento
CartõesPadding consistente, respirável
Largura de leitura45-75 caracteres ideal

4. Princípios de Cor

Regra 60-30-10

60% → Primário/Fundo (base neutra e calma)
30% → Secundário (áreas de suporte)
10% → Destaque (CTAs, realces, atenção)

Psicologia das Cores (Para Tomada de Decisão)

Se Você Precisa...Considere MatizesEvite
Confiança, calmaFamília azulVermelhos agressivos
Crescimento, naturezaFamília verdeCinzas industriais
Energia, urgênciaLaranja, vermelhoAzuis passivos
Luxo, criatividadeVerde Musgo Escuro, Dourado, EsmeraldaCores brilhantes que parecem baratas
Limpo, minimalistaNeutrosCor esmagadora

Processo de Seleção

  1. Qual é o setor? (restringe opções)
  2. Qual é a emoção? (escolhe a primária)
  3. Modo claro ou escuro? (estabelece a base)
  4. PERGUNTE AO USUÁRIO se não especificado

Para teoria de cores detalhada: color-system.md


5. Princípios de Tipografia

Seleção de Escala

Tipo de ConteúdoProporção de EscalaSensação
UI densa1,125-1,2Compacto, eficiente
Web geral1,25Equilibrado (mais comum)
Editorial1,333Legível, espaçoso
Hero/display1,5-1,618Impacto dramático

Conceito de Combinação

Contraste + Harmonia:
├── DIFERENTE o suficiente para hierarquia
├── SEMELHANTE o suficiente para coesão
└── Geralmente: display + neutro, ou serifa + sans serifa

Regras de Legibilidade

  • Comprimento da linha: 45-75 caracteres ideal
  • Altura da linha: 1,4-1,6 para texto do corpo
  • Contraste: Verifique os requisitos WCAG
  • Tamanho: 16px+ para corpo na web

Para tipografia detalhada: typography-system.md


6. Princípios de Efeitos Visuais

Glassmorphism (Quando Apropriado)

Propriedades principais:
├── Fundo semitransparente
├── Desfoque de fundo
├── Borda sutil para definição
└── ⚠️ **AVISO:** Glassmorphism azul/branco padrão é um clichê moderno. Use-o radicalmente ou não use.

Hierarquia de Sombras

Conceito de elevação:
├── Elementos mais altos = sombras maiores
├── Deslocamento Y > Deslocamento X (luz de cima)
├── Múltiplas camadas = mais realista
└── Modo escuro: pode precisar de brilho

Uso de Gradientes

Gradientes harmoniosos:
├── Cores adjacentes na roda (análogas)
├── OU mesma matiz, diferentes luminosidades
├── Evite pares complementares agressivos
├── 🚫 **SEM Gradientes Mesh/Aurora** (bolhas flutuantes)
└── VARIE radicalmente de projeto para projeto

Para guia completo de efeitos: visual-effects.md


7. Princípios de Animação

Conceito de Tempo

Duração baseada em:
├── Distância (mais longe = mais longo)
├── Tamanho (maior = mais lento)
├── Importância (crítico = claro)
└── Contexto (urgente = rápido, luxo = lento)

Seleção de Easing

AçãoEasingPor Quê
EntrarEase-outDesacelerar, estabelecer
SairEase-inAcelerar, sair
ÊnfaseEase-in-outSuave, deliberado
BrincalhãoBounceDivertido, energético

Performance

  • Anime apenas transform e opacidade
  • Respeite a preferência de movimento reduzido
  • Teste em dispositivos de baixo custo

Para padrões de animação: animation-guide.md, para avançado: motion-graphics.md


8. Checklist de "Fator Uau"

Indicadores Premium

  • Espaços em branco generosos (luxo = espaço para respirar)
  • Profundidade e dimensão sutis
  • Animações suaves e propositais
  • Atenção aos detalhes (alinhamento, consistência)
  • Ritmo visual coeso
  • Elementos personalizados (nem todos padrões)

Construtores de Confiança

  • Sinais de segurança quando apropriado
  • Prova social / depoimentos
  • Proposta de valor clara
  • Imagens profissionais
  • Linguagem de design consistente

Gatilhos Emocionais

  • Hero que evoca a emoção pretendida
  • Elementos humanos (rostos, histórias)
  • Indicadores de progresso/realização
  • Momentos de deleite

9. Antipadrões (O que NÃO Fazer)

❌ Indicadores de Design Preguiçoso

  • Fontes padrão do sistema sem consideração
  • Imagens de banco de imagens que não combinam
  • Espaçamento inconsistente
  • Muitas cores concorrentes
  • Paredes de texto sem hierarquia
  • Contraste inacessível

❌ Padrões de Tendência de IA (EVITE!)

  • Mesmas cores em todo projeto
  • Escuro + neon como padrão
  • Roxo/violeta em tudo (PROIBIÇÃO DE ROXO ✅)
  • Bento grids para landing pages simples
  • Gradientes Mesh e Efeitos de Brilho
  • Mesma estrutura de layout / clone do Vercel
  • Não perguntar as preferências do usuário

❌ Padrões Escuros (Antiéticos)

  • Custos ocultos
  • Urgência falsa
  • Ações forçadas
  • UI enganosa
  • Confirmshaming (envergonhar o usuário para confirmar)

10. Resumo do Processo de Decisão

Para CADA tarefa de design:

1. RESTRIÇÕES
   └── Qual é o cronograma, marca, tecnologia, público?
   └── Se não estiver claro → PERGUNTE

2. CONTEÚDO
   └── Que conteúdo existe?
   └── Qual é a hierarquia?

3. DIREÇÃO DE ESTILO
   └── O que é apropriado para o contexto?
   └── Se não estiver claro → PERGUNTE (não use padrões!)

4. EXECUÇÃO
   └── Aplique os princípios acima
   └── Verifique contra antipadrões

5. REVISÃO
   └── "Isso serve ao usuário?"
   └── "Isso é diferente dos meus padrões?"
   └── "Eu me orgulharia disso?"

Arquivos de Referência

Para orientação mais aprofundada em áreas específicas:


Skills Relacionados

SkillQuando Usar
frontend-design (este)Antes de codificar - Aprenda princípios de design (cor, tipografia, psicologia UX)
web-design-guidelinesDepois de codificar - Audite acessibilidade, performance e melhores práticas

Fluxo de Trabalho Pós-Design

Após implementar seu design, execute a auditoria:

1. DESIGN   → Leia princípios de frontend-design ← VOCÊ ESTÁ AQUI
2. CÓDIGO   → Implemente o design
3. AUDITORIA → Execute a revisão de web-design-guidelines
4. CORRIJA  → Trate os achados da auditoria

Próximo Passo: Depois de codificar, use o skill web-design-guidelines para auditar sua implementação quanto a acessibilidade, estados de foco, animações e problemas de performance.


Lembre-se: Design é PENSAR, não copiar. Cada projeto merece consideração fresca com base em seu contexto e usuários únicos. Evite o Porto Seguro Moderno de SaaS!

Habilidades Relacionadas