Communitygithub.com

Habilidade de Sistema de Design Inteligente

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.

O que é Habilidade de Sistema de Design Inteligente?

Esta habilidade permite que agentes de IA, como Claude Code ou Cursor, analisem automaticamente um projeto web, identifiquem sua categoria (por exemplo, landing page SaaS, dashboard, e-commerce) e apliquem o sistema de design mais adequado a partir de uma biblioteca de mais de 60 padrões de referência (como Linear, Vercel, Apple, etc.). Ela realiza uma análise em fases: primeiro, detecta o tipo de projeto e tokens de design existentes; depois, calcula uma pontuação de confiança para recomendar o melhor sistema; em seguida, executa um protocolo de inspeção de ativos e validação técnica antes de aplicar o sistema adaptado; por fim, valida a saída com verificações de consistência visual, acessibilidade e desempenho. A habilidade é compatível com projetos HTML, CSS, JS, React, Vue, Svelte e suporta Tailwind, SCSS e outras abordagens CSS. Ela pode ser configurada manualmente com um arquivo `.design-system` ou operar de forma totalmente automática com base na análise do projeto. O resultado é uma interface profissional e consistente, adaptada às necessidades específicas do projeto, sem copiar e colar cegamente padrões.

Funciona com✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Cozythecoder/frontend-design-md/tree/HEAD/skills/design-systems

Perguntar na sua IA favorita

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

Documentação

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 ProjetoSistemas de Design Recomendados
Landing SaaSlinear.app, vercel.com, supabase.com, stripe.com, notion.so
Dashboard/Aplicaçãolinear.app (UI), github.com, vercel.com/dashboard, supabase.com/dashboard
E-commerceapple.com, shopify.com, nike.com
Portfólioframer.com, webflow.com, cargo.site
Conteúdo/Blogmedium.com, substack.com, stripe.com/blog
Ferramenta de Desenvolvedorvercel.com, github.com, docs.rs, nextjs.org
Negócio de Serviçoscursor.com, intercom.com, webflow.com
Marca/Agênciatesla.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:

  1. 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
  2. Analisar Ativos Atuais

    # Executar automaticamente
    python3 ~/.claude/skills/design-systems/scripts/inspect-project.py
    

    Verifica:

    • Logótipo existe? (SVG preferido)
    • Imagens do produto? (PNGs transparentes para hero?)
    • Esquema de cores já definido?
    • Tipografia já definida?
    • Biblioteca de componentes existente?
  3. 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
  4. 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:

  1. Fundação (Crítico)

    • Variáveis CSS de cor mapeadas
    • Escala tipográfica definida
    • Sistema de espaçamento estabelecido
    • Reset/normalize base aplicado
  2. Layout (Alto)

    • Espaçamento entre secções (hero, conteúdo, rodapé)
    • Larguras do contentor (max-width, padding)
    • Sistema de grelha (se aplicável)
  3. Componentes (Médio)

    • Botões (primário, secundário, fantasma)
    • Cartões (se usados)
    • Formulários/inputs (se usados)
    • Navegação (cabeçalho, rodapé)
  4. 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

Guias de Adaptação

Validação

Padrões Específicos de Categoria

Scripts

  • scripts/analyze-project.py — Detetar categoria, tokens atuais
  • scripts/match-design-system.py — Comparar com biblioteca
  • scripts/validate-application.py — Controlos de qualidade
  • scripts/generate-adaptation.py — Mapear existente para sistema de design
  • scripts/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.

Habilidades Relacionadas