O que Habilidade de Sistema de Design Inteligente faz?
Detecte automaticamente o tipo de projeto, analise a intenção e aplique o sistema de design ideal a partir de mais de 60 padrões de referência.
Gatilhos de Detecção Automática
Esta habilidade é ativada quando:
- O utilizador cria/modifica qualquer ficheiro de projeto web (HTML, CSS, JS, JSX, Vue, Svelte)
- O utilizador diz "projeta isto", "faz ficar bonito", "melhora a UI", "aplica sistema de design"
- O utilizador menciona categorias específicas: "landing page", "dashboard", "portfólio", "e-commerce"
- Nenhum sistema de design explícito é especificado no projeto
Fase 1: Análise do Projeto (Automática)
SEMPRE execute a análise antes de selecionar o sistema de design.
Passo 1: Detetar Categoria do Projeto
Examine os ficheiros do projeto para determinar o tipo:
# Verificar indicadores
deteccoes = {
'saas-landing': ['precos', 'registo', 'funcionalidades', 'hero', 'testemunhos'],
'dashboard-app': ['dashboard', 'grafico', 'tabela', 'sidebar', 'widget'],
'e-commerce': ['produto', 'carrinho', 'checkout', 'loja', 'inventario'],
'portfolio': ['portfolio', 'galeria', 'projeto', 'criativo', 'arte'],
'publicacao-conteudo': ['blog', 'artigo', 'post', 'conteudo', 'newsletter'],
'marca-showcase': ['marca', 'historia', 'sobre', 'missao', 'valores'],
'ferramenta-desenvolvedor': ['api', 'docs', 'codigo', 'terminal', 'github'],
'servico-negocio': ['servico', 'contacto', 'processo', 'equipa', 'consultoria']
}
Passo 2: Analisar Estado Atual
Verificar tokens de design existentes:
- Cores em CSS/SCSS/Tailwind config
- Tipografia (font-family, declarações font-size)
- Espaçamento (padrões margin, padding, gap)
- Componentes (classes de botão, classes de cartão)
Passo 3: Corresponder à Biblioteca de Sistema de Design
Comparar com mais de 60 padrões de referência:
| Tipo de Projeto | Sistemas de Design Recomendados |
|---|---|
| Landing SaaS | linear.app, vercel.com, supabase.com, stripe.com, notion.so |
| Dashboard/Aplicação | linear.app (UI), github.com, vercel.com/dashboard, supabase.com/dashboard |
| E-commerce | apple.com, shopify.com, nike.com |
| Portfólio | framer.com, webflow.com, cargo.site |
| Conteúdo/Blog | medium.com, substack.com, stripe.com/blog |
| Ferramenta de Desenvolvedor | vercel.com, github.com, docs.rs, nextjs.org |
| Negócio de Serviços | cursor.com, intercom.com, webflow.com |
| Marca/Agência | tesla.com, apple.com, nike.com |
Passo 4: Pontuação de Confiança
Calcular confiança da correspondência:
confianca = (
correspondencia_categoria * 0.40 + # O conteúdo corresponde?
semelhanca_tokens * 0.30 + # Sobreposição de cor/tipografia?
padroes_componentes * 0.20 + # Padrões de botão/cartão?
estrutura_layout * 0.10 # Padrões de grelha/flex?
)
Se confianca > 0.75: Sugerir automaticamente a melhor correspondência
Se 0.50-0.75: Oferecer 2-3 alternativas
Se < 0.50: Perguntar ao utilizador pela preferência de categoria
Fase 2: Protocolo Pré-Voo
Lista de Verificação de Inspeção de Ativos
ANTES de aplicar qualquer sistema de design:
-
Verificar project-context.md
- Existe na raiz do projeto?
- Se não: Criar a partir de template com nome do projeto, objetivo, público-alvo
-
Analisar Ativos Atuais
# Executar automaticamente python3 ~/.claude/skills/design-systems/scripts/inspect-project.pyVerifica:
- Logótipo existe? (SVG preferido)
- Imagens do produto? (PNGs transparentes para hero?)
- Esquema de cores já definido?
- Tipografia já definida?
- Biblioteca de componentes existente?
-
Determinar Hierarquia de Composição
- Elemento Hero: Maior elemento visual (imagem do produto, ilustração, título)
- Elementos de suporte: Funcionalidades, benefícios, prova social
- Acentos: Elementos decorativos, padrões
-
Validar Restrições Técnicas
- Framework detetado (React, Vue, vanilla, etc.)
- Abordagem CSS (Tailwind, CSS-in-JS, SCSS, etc.)
- Capacidade de animação (GSAP carregado? Framer Motion?)
- Orçamento de desempenho (mobile-first? desktop?)
Fase 3: Aplicação do Sistema de Design
Passo 1: Selecionar e Carregar
Com base na análise, carregar o DESIGN.md recomendado:
Recomendado: Sistema de Design Linear.app
Confiança: 87%
Razões da correspondência:
- Landing page SaaS detetada (secções de preços, funcionalidades)
- Preferência de modo escuro detetada
- Tipografia limpa (tipo Inter) encontrada
- Padrões de layout baseados em cartões presentes
Passo 2: Adaptar ao Projeto
NÃO copie e cole em bruto. Adapte com base na análise do projeto:
Cores:
- Se o projeto tem cores de marca: Mapear para funções do sistema de design
- Se sem cores: Usar paleta do sistema de design diretamente
- Exemplo: "O teu azul #3B82F6 → Função de Destaque Primário"
Tipografia:
- Se usar Inter/Sistema: Manter escala do sistema de design
- Se usar fonte diferente: Adaptar tamanhos/pesos
- Exemplo: "Roboto em vez de Inter → Ajustar pesos 400→500"
Espaçamento:
- Verificar escala de espaçamento existente
- Mapear para sistema de design ou preservar se consistente
Componentes:
- Mapear classes existentes para padrões do sistema de design
- Exemplo: "O teu .btn-primary → Botão Primário do sistema de design"
Passo 3: Lista de Verificação de Implementação
Aplicar sistema de design por ordem de prioridade:
-
Fundação (Crítico)
- Variáveis CSS de cor mapeadas
- Escala tipográfica definida
- Sistema de espaçamento estabelecido
- Reset/normalize base aplicado
-
Layout (Alto)
- Espaçamento entre secções (hero, conteúdo, rodapé)
- Larguras do contentor (max-width, padding)
- Sistema de grelha (se aplicável)
-
Componentes (Médio)
- Botões (primário, secundário, fantasma)
- Cartões (se usados)
- Formulários/inputs (se usados)
- Navegação (cabeçalho, rodapé)
-
Polimento (Baixo)
- Sombras/elevação
- Consistência do raio de borda
- Estados de foco
- Transições de hover
Fase 4: Validação
Controlos de Qualidade
Executar após aplicação:
Verificação de Consistência Visual:
# Verificar violações
violacoes = []
# 1. Contagem de cores
if cores_unicas > 8:
violacoes.append("Demasiadas cores - simplificar paleta")
# 2. Escala tipográfica
if tamanhos_fonte > 12:
violacoes.append("Tipografia não sistemática - consolidar tamanhos")
# 3. Consistência de espaçamento
if base_espacamento not in [4, 8, 16]:
violacoes.append("Espaçamento não segue grelha de 4/8px")
# 4. Alvos de toque
if alvos_toque < 44:
violacoes.append("Alvos de toque abaixo de 44px")
Verificação de Acessibilidade:
- Contraste de cor >= 4.5:1 para texto
- Indicadores de foco visíveis
- Movimento reduzido respeitado
- Etiquetas ARIA onde necessário
Verificação de Desempenho:
- Sem animações que causem layout-thrashing
- Imagens otimizadas
- Fontes subconjuntadas (se personalizadas)
Referências
Análise de Sistema de Design
- category-detection.md - Como detetar tipos de projeto
- token-extraction.md - Extrair tokens de design existentes
- matching-algorithm.md - Lógica de pontuação de confiança
Guias de Adaptação
- color-adaptation.md - Mapear cores existentes para sistema de design
- typography-adaptation.md - Substituições de famílias de fontes
- spacing-adaptation.md - Mapeamento de sistema de espaçamento
- component-mapping.md - Traduções de nomes de classes
Validação
- quality-gates.md - 11 regras inegociáveis
- accessibility-checks.md - Validação de acessibilidade
- performance-checks.md - Orçamento de desempenho
Padrões Específicos de Categoria
- saas-landing.md - Padrões de landing page SaaS
- dashboard-app.md - Padrões de UI de dashboard
- e-commerce.md - Padrões de produto/e-commerce
- portfolio.md - Padrões de portfólio criativo
- content-site.md - Padrões de blog/conteúdo
Scripts
scripts/analyze-project.py— Detetar categoria, tokens atuaisscripts/match-design-system.py— Comparar com bibliotecascripts/validate-application.py— Controlos de qualidadescripts/generate-adaptation.py— Mapear existente para sistema de designscripts/inspect-assets.py— Verificar imagens, logótipos, ativos de marca
Biblioteca de Sistemas de Design
Mais de 60 sistemas organizados por categoria em ../design-systems/:
SaaS / Ferramentas de Desenvolvedor
- linear.app (escuro, Inter, peso 510)
- vercel.com (Geist, sombra-borda)
- supabase.com (acolhedor, inspirado em postgres)
- stripe.com (rico em conteúdo, gradientes)
- notion.so (amigável, arredondado)
- github.com (funcional, denso)
- cursor.com (focado em editor, cores de sintaxe)
E-commerce / Produto
- apple.com (SF Pro, contraste binário, CTAs em pílula)
- shopify.com (polarizado, tokens Polaris)
- nike.com (negrito, dinâmico, centrado em imagem)
Criativo / Portfólio
- framer.com (brincalhão, gradientes, saltitante)
- webflow.com (profissional, estruturado)
Conteúdo / Publicação
- medium.com (focado em leitura, corpo com serifa)
- substack.com (acolhedor, centrado em newsletter)
Empresarial
- ibm.com (Carbon design, sistemático)
- salesforce.com (funcional, denso)
Automóvel / Luxo
- tesla.com (minimalista, centrado no produto)
- ferrari.com (dramático, destaque vermelho)
- bmw.com (técnico, preciso)
Fluxo de Utilização
Utilizador: "Cria uma landing page para o meu SaaS"
↓
Habilidade: Analisa o projeto...
Deteta: Intenção de landing SaaS
Estado atual: Sem sistema de design
↓
Habilidade: Recomenda linear.app (87% de confiança)
Oferece alternativas: vercel.com, stripe.com
↓
Utilizador: "Usa o estilo Linear"
↓
Habilidade: Executa protocolo pré-voo
- Cria project-context.md
- Analisa ativos
- Verifica stack tecnológico
↓
Habilidade: Aplica sistema de design Linear
- Mapeia tokens de cor
- Define escala tipográfica
- Implementa componentes
↓
Habilidade: Valida saída
- Verificação de contraste de cor
- Consistência de espaçamento
- Revisão de controlo de qualidade
↓
Saída: Projeto com design inspirado em Linear
Configuração
Substituir a deteção automática criando .design-system na raiz do projeto:
{
"system": "linear.app",
"theme": "dark",
"adaptations": {
"primaryColor": "#3B82F6",
"fontFamily": "Inter"
}
}
Esta habilidade combina a tua coleção de mais de 60 sistemas de design com um fluxo de trabalho de nível épico: deteção automática, verificações pré-voo, validação e adaptação inteligente.