{
  "esquema": "design-guia-para-agentes/v1",
  "guia": "design",
  "nome": "Design (entrada da pasta)",
  "titulo": "Execução visual para páginas e campanhas · Leadlovers 2026",
  "descricao": "Escolha a forma visual pela decisão que a peça precisa facilitar: navegação, desenho da informação e interface com critérios de leitura no celular.",
  "url": "https://brasilgeo.ai/leadlovers2026/design/",
  "arquivos": {
    "markdown": "https://brasilgeo.ai/leadlovers2026/design/agentes.md",
    "json": "https://brasilgeo.ai/leadlovers2026/design/agentes.json",
    "indice": "https://brasilgeo.ai/leadlovers2026/design/llms.txt"
  },
  "revisadoEm": "2026-11-16",
  "idioma": "pt-BR",
  "resumo": "A pasta Design reúne dez guias de execução visual e as decisões transversais de identidade: uma família de ícones, licença lida, a escada de movimento, imagem gerada por IA e peso de imagem. Leia as regras DSG primeiro e abra o guia da tarefa. O agente preenche sozinho o que o pedido não diz, então cada decisão vira uma linha escrita, com número e nome de arquivo.",
  "quandoUsar": [
    "Montar página, e-mail ou anúncio com ícones, ilustração, fonte ou foto.",
    "Escolher biblioteca de animação ou decidir se um efeito precisa de uma.",
    "Gerar imagem por IA para campanha ou artigo.",
    "Escrever o arquivo de instruções visuais de um projeto.",
    "Reduzir peso de imagem e acertar Core Web Vitals.",
    "Revisar a saída visual de um agente de código antes de publicar.",
    "Decidir qual dos dez guias abrir para uma tarefa de interface."
  ],
  "regras": [
    {
      "id": "DSG-01",
      "nivel": "obrigatória",
      "regra": "Use uma única família de ícones por projeto, nomeada no arquivo de instruções com a espessura do traço. Peça o conjunto de uma vez.",
      "porque": "Cada pedido separado é nova chance de trocar o padrão. Referência: Lucide (traço único, ISC)."
    },
    {
      "id": "DSG-02",
      "nivel": "obrigatória",
      "regra": "Cor de ícone vem de token (var(--color-icon)) e o desenho usa stroke=\"currentColor\". Nunca cravar hexadecimal.",
      "porque": "#1a1a1a vira preto sobre preto no tema escuro; com currentColor, hover, foco e desabilitado movem rótulo e ícone juntos."
    },
    {
      "id": "DSG-03",
      "nivel": "obrigatória",
      "regra": "Botão de ícone: aria-label com verbo no botão, aria-hidden no SVG, alvo de 44 x 44 px no botão inteiro. Estado nunca só por cor: combine forma, texto e role status ou alert.",
      "porque": "WCAG 2.2 pede 24 px (2.5.8); o guia usa 44 px (AAA, 2.5.5). A WCAG 1.4.1 reprova cor sozinha."
    },
    {
      "id": "DSG-04",
      "nivel": "obrigatória",
      "regra": "Antes de adotar ilustração, fonte ou ícone de fora, abra a licença, procure a palavra comercial e anote a data. Atribuição obrigatória exige crédito visível.",
      "porque": "Sem crédito você descumpre o combinado mesmo com download grátis. A Lucide 1.0 (23/03/2026) removeu os ícones de marca."
    },
    {
      "id": "DSG-05",
      "nivel": "obrigatória",
      "regra": "Hospede a fonte com Fontsource (variável, font-display: swap) e confira na aba Rede que não há chamada a fonts.googleapis.com. Passe todo SVG exportado pelo SVGO.",
      "porque": "Tribunal de Munique condenou um site em 20/01/2022 por enviar o IP ao Google. SVGO 4 mantém viewBox e title; o 3 exige ajuste manual."
    },
    {
      "id": "DSG-06",
      "nivel": "obrigatória",
      "regra": "Suba a escada de movimento um degrau por vez, só quando o de baixo falhar: 1) CSS puro, 2) recurso nativo (dialog, popover, @starting-style), 3) Motion, 4) GSAP.",
      "porque": "Quase toda tela vive nos dois primeiros, que pesam zero."
    },
    {
      "id": "DSG-07",
      "nivel": "obrigatória",
      "regra": "Em toda animação: respeite prefers-reduced-motion, deixe o estado base visível (opacity: 0 só dentro do from do @keyframes) e anime só transform e opacity.",
      "porque": "Na regra base, opacity: 0 apaga o conteúdo de quem não recebe a animação; animar altura refaz o desenho a cada quadro."
    },
    {
      "id": "DSG-08",
      "nivel": "obrigatória",
      "regra": "Duração: 120 a 200 ms em microinteração, 200 a 300 ms em troca de estado, 240 ms de entrada, ease-out. Scrub de 0,5 a 1 s para revelar e 1,5 a 2 s para atmosfera.",
      "porque": "Acima de 400 ms a interface fica preguiçosa."
    },
    {
      "id": "DSG-09",
      "nivel": "obrigatória",
      "regra": "Imagem gerada por IA só para textura e cena de fundo, editada depois. Logotipo, ícone, diagrama, pessoa e produto reais usam vetor sob medida, recurso aberto com licença clara ou foto licenciada.",
      "porque": "Thaler contra Perlmutter (18/03/2025): direito autoral exige obra criada por gente; a contribuição humana registrada é o que protege."
    },
    {
      "id": "DSG-10",
      "nivel": "obrigatória",
      "regra": "Siga a ordem direito, coerência, peso. Registre plataforma, data, instrução e edições em arquivo ao lado da imagem.",
      "porque": "Cada plataforma define quem detém a saída; descobrir com a campanha no ar custa mais que refazer a arte."
    },
    {
      "id": "DSG-11",
      "nivel": "obrigatória",
      "regra": "Texto nunca entra na imagem gerada: sobreponha em HTML. Escreva um pedido base (traço, paleta em tokens, proporção) e varie só o tema.",
      "porque": "O modelo erra palavra e acento, sobretudo em português; sem pedido base, cada seção sai com uma estética."
    },
    {
      "id": "DSG-12",
      "nivel": "obrigatória",
      "regra": "Nunca sirva imagem maior que o espaço onde aparece. Foto e cena abaixo de 150 KB no tamanho exibido, AVIF primeiro e WebP de retaguarda; SVG para ícone e ilustração plana.",
      "porque": "Esteira do guia: 4,2 MB original, 380 KB na largura real, 96 KB em AVIF."
    },
    {
      "id": "DSG-13",
      "nivel": "obrigatória",
      "regra": "No img, declare width e height, alt vazio se decorativa e descrição objetiva se informa. fetchpriority=high só na imagem do topo; loading=lazy no resto. Use picture com srcset e sizes.",
      "porque": "Medidas reservam o espaço e evitam o botão mudar de lugar na hora do toque (CLS)."
    },
    {
      "id": "DSG-14",
      "nivel": "obrigatória",
      "regra": "Meça Core Web Vitals em visitas reais no percentil 75, celular e computador separados: LCP até 2,5 s, INP até 200 ms, CLS até 0,1.",
      "porque": "Teste isolado de laboratório não comprova a experiência do público."
    },
    {
      "id": "DSG-15",
      "nivel": "obrigatória",
      "regra": "Rode npx impeccable detect --json contra a página publicada, em largura de computador e com --viewport 390x844, e classifique os achados: defeito medido, escolha de estilo, leitura errada do programa.",
      "porque": "Parte dos defeitos só aparece no celular. Trecho repetido 20 vezes ou mais costuma vir de um estilo compartilhado: confira no navegador."
    },
    {
      "id": "DSG-16",
      "nivel": "recomendada",
      "regra": "Mantenha um DESIGN.md (tokens em YAML, oito seções) e rode npx @google/design.md lint. Pergunte se cada cor e cada espaço saíram de token declarado.",
      "porque": "Formato em fase alfa no Google Labs; troca gosto pessoal por conferência repetível."
    },
    {
      "id": "DSG-17",
      "nivel": "recomendada",
      "regra": "Importe ícone por nome, nunca a coleção. Em site estático, use sprite SVG só com os ícones usados, nome versionado por hash. Entregue o ícone de aplicativo em cinco arquivos.",
      "porque": "Importação em bloco arrasta a coleção. Cinco arquivos cobrem tudo; a lista de dezenove tamanhos envelheceu."
    },
    {
      "id": "DSG-18",
      "nivel": "recomendada",
      "regra": "Registre o estilo de ilustração (linha ou flat) no pedido base, combinando com a família de ícones. Textura atrás de texto fica em até 8% de opacidade, com contraste de 4,5:1 medido.",
      "porque": "Misturar estilos equivale a misturar famílias de ícone."
    }
  ],
  "decisoes": [
    {
      "situacao": "Botões, CTA, estados, envio, botão de IA",
      "escolha": "Abra o guia Botões: https://brasilgeo.ai/leadlovers2026/design/botoes/agentes.md"
    },
    {
      "situacao": "Painel que o gestor lê em uma tela",
      "escolha": "Abra o guia Dashboards: https://brasilgeo.ai/leadlovers2026/design/dashboards/agentes.md"
    },
    {
      "situacao": "Diagrama de arquitetura ou fluxo como código",
      "escolha": "Abra o guia Diagramas (Mermaid, D2): https://brasilgeo.ai/leadlovers2026/design/diagramas/agentes.md"
    },
    {
      "situacao": "Gráfico ou visualização de dados fora de painel",
      "escolha": "Abra o guia Gráficos: https://brasilgeo.ai/leadlovers2026/design/graficos/agentes.md"
    },
    {
      "situacao": "Menu, abas, paginação, gaveta, catálogo compartilhável por URL",
      "escolha": "Abra o guia Navegação: https://brasilgeo.ai/leadlovers2026/design/navegacao/agentes.md"
    },
    {
      "situacao": "Tokens, @theme, tema claro e escuro, CSS moderno",
      "escolha": "Abra o guia Tailwind e tokens: https://brasilgeo.ai/leadlovers2026/design/tailwind/agentes.md"
    },
    {
      "situacao": "Componente React, estado, operação cancelável, lista animada",
      "escolha": "Abra o guia React: https://brasilgeo.ai/leadlovers2026/design/react/agentes.md"
    },
    {
      "situacao": "tsconfig, esquema de formulário, máquina de estados",
      "escolha": "Abra o guia TypeScript: https://brasilgeo.ai/leadlovers2026/design/typescript/agentes.md"
    },
    {
      "situacao": "Ensinar o agente a desenhar telas com skills e waves",
      "escolha": "Abra o guia frontend-2027: https://brasilgeo.ai/leadlovers2026/design/frontend2027/agentes.md"
    },
    {
      "situacao": "Ícone, ilustração, fonte, animação, imagem de IA ou peso",
      "escolha": "Fique nesta pasta e siga as regras DSG; o catálogo de 36 tipos de peça traz a receita de cada formato.",
      "evitar": "Procurar essas decisões nos outros guias."
    },
    {
      "situacao": "Hover, foco, entrada de bloco, janela sobreposta, menu flutuante",
      "escolha": "CSS puro ou recurso nativo (dialog, popover, ancoragem por CSS).",
      "evitar": "Motion ou GSAP."
    },
    {
      "situacao": "Gesto, mola, arrastar, reordenar em React",
      "escolha": "Motion (13.1.0, MIT).",
      "evitar": "GSAP para revelar bloco."
    },
    {
      "situacao": "Linha do tempo longa na rolagem, cinco peças ou mais em ordem",
      "escolha": "GSAP (gratuito desde 30/04/2025), com useGSAP em React.",
      "evitar": "CSS puro com atrasos manuais."
    },
    {
      "situacao": "Dois tipos de peça resolvem a mesma função",
      "escolha": "Vence o que pesa menos na rede de quem visita."
    }
  ],
  "numeros": [
    {
      "valor": "36 oficinas, 245 critérios, 36 tipos de peça",
      "uso": "Tamanho do material da pasta.",
      "fonte": "Hub Design"
    },
    {
      "valor": "44 px e 24 px",
      "uso": "Alvo de toque do guia e mínimo da WCAG 2.2.",
      "fonte": "Seção Ícones"
    },
    {
      "valor": "120 a 200, 200 a 300 e 240 ms",
      "uso": "Microinteração, troca de estado, entrada.",
      "fonte": "Seção Movimento"
    },
    {
      "valor": "150 KB",
      "uso": "Teto de foto e cena no espaço exibido.",
      "fonte": "Seção Formato e peso"
    },
    {
      "valor": "4,2 MB, 380 KB, 96 KB",
      "uso": "Original, largura real e AVIF.",
      "fonte": "Seção Formato e peso"
    },
    {
      "valor": "LCP 2,5 s, INP 200 ms, CLS 0,1",
      "uso": "Limites no percentil 75.",
      "fonte": "Seção Formato e peso"
    },
    {
      "valor": "8,4% a mais de conversão por 0,1 s",
      "uso": "Ganho de 0,1 s no celular no varejo.",
      "fonte": "Deloitte, 37 marcas"
    },
    {
      "valor": "390 x 844",
      "uso": "Viewport do segundo passe do detector.",
      "fonte": "Revisar a tela"
    }
  ],
  "evitar": [
    {
      "erro": "Misturar ícones de bibliotecas diferentes.",
      "corrija": "Uma família por projeto, nomeada nas instruções."
    },
    {
      "erro": "Hexadecimal cravado em ícone ou gradiente.",
      "corrija": "Token de cor e currentColor; confira os dois temas."
    },
    {
      "erro": "Baixar ilustração ou fonte sem abrir a licença.",
      "corrija": "Procure a palavra comercial, anote a data, dê o crédito exigido."
    },
    {
      "erro": "Instalar Motion ou GSAP para efeito de CSS.",
      "corrija": "Suba a escada um degrau por vez."
    },
    {
      "erro": "Animação em laço sem fim ou transição de altura e largura.",
      "corrija": "Uma execução por evento; só transform e opacity."
    },
    {
      "erro": "Texto, logotipo ou diagrama gerados por IA.",
      "corrija": "Texto em HTML; marca em vetor sob medida."
    },
    {
      "erro": "Servir a foto como saiu da pasta, sem width e height.",
      "corrija": "Esteira de build com larguras, AVIF e WebP, e picture com medidas."
    }
  ],
  "padroes": [
    {
      "nome": "Entrada de bloco com estado base visível",
      "quando": "Revelar cartão ou seção ao entrar na tela.",
      "linguagem": "css",
      "codigo": "@keyframes entrar { from { opacity: 0; transform: translateY(16px); } }\n.cartao { animation: entrar 240ms ease-out; }\n@media (prefers-reduced-motion: reduce) { .cartao { animation: none; } }\n@supports (animation-timeline: view()) {\n  .cartao { animation-timeline: view(); animation-range: entry 0% entry 40%; }\n}"
    },
    {
      "nome": "Pedido base de ilustração",
      "quando": "Gerar conjunto coerente por IA.",
      "linguagem": "text",
      "codigo": "Ilustração plana, traço de 2 px, sem gradiente, sem sombra, sem texto.\nPaleta: tokens da marca (4 cores), fundo claro.\nTema desta peça: [uma frase]. Proporção: [1:1 | 3:1].\nSaída: SVG com viewBox.\nRegistro: plataforma, data, este pedido e edições, em arquivo ao lado."
    }
  ],
  "checklist": [
    "Uma só família de ícones, nomeada nas instruções, com traço declarado.",
    "Cor de ícone e de gradiente por token; tema escuro conferido.",
    "Botões de ícone com aria-label, aria-hidden no SVG e 44 px de alvo.",
    "Licença de cada ilustração, fonte e ícone lida, com data anotada.",
    "Fonte local; nenhuma chamada a fonts.googleapis.com na aba Rede.",
    "Movimento no degrau mais barato, só transform e opacity, com menos movimento atendido e estado base visível.",
    "Imagem de IA só em fundo, sem texto dentro, com registro de plataforma, data, instrução e edições.",
    "Nenhuma imagem maior que o espaço exibido; foto abaixo de 150 KB em AVIF, WebP de retaguarda.",
    "Detector da Impeccable rodado em computador e 390x844, achados classificados.",
    "LCP, INP e CLS lidos em dados reais no percentil 75."
  ],
  "ferramentas": [
    {
      "nome": "Lucide (ISC)",
      "uso": "Família de ícones de traço importada por nome."
    },
    {
      "nome": "Fontsource",
      "uso": "Fonte variável hospedada no projeto."
    },
    {
      "nome": "SVGO 4",
      "uso": "Limpar SVG exportado mantendo viewBox e title."
    },
    {
      "nome": "Impeccable 4.5.0 (detect)",
      "uso": "Detector sem modelo de linguagem contra a página publicada."
    },
    {
      "nome": "DESIGN.md e @google/design.md lint",
      "uso": "Contrato visual com tokens em YAML."
    },
    {
      "nome": "verify.contentauthenticity.org (C2PA)",
      "uso": "Ler o selo Content Credentials de imagem recebida."
    }
  ],
  "ondeAprofundar": [
    {
      "tema": "Ícones, alvo de toque e ícone de aplicativo",
      "ancora": "#icones",
      "url": "https://brasilgeo.ai/leadlovers2026/design/#icones"
    },
    {
      "tema": "Licença de ilustração e fonte, SVGO",
      "ancora": "#ilustracoes",
      "url": "https://brasilgeo.ai/leadlovers2026/design/#ilustracoes"
    },
    {
      "tema": "Escada de movimento e regras fixas",
      "ancora": "#animacao",
      "url": "https://brasilgeo.ai/leadlovers2026/design/#animacao"
    },
    {
      "tema": "Imagem gerada por IA: direito, coerência, peso",
      "ancora": "#geracao-imagens",
      "url": "https://brasilgeo.ai/leadlovers2026/design/#geracao-imagens"
    },
    {
      "tema": "Formato, peso e Core Web Vitals",
      "ancora": "#formato-peso",
      "url": "https://brasilgeo.ai/leadlovers2026/design/#formato-peso"
    },
    {
      "tema": "Catálogo dos 36 tipos de peça com receita",
      "ancora": "#catalogo",
      "url": "https://brasilgeo.ai/leadlovers2026/design/#catalogo"
    },
    {
      "tema": "Prompts prontos",
      "ancora": "#prompts",
      "url": "https://brasilgeo.ai/leadlovers2026/design/#prompts"
    },
    {
      "tema": "Revisão com detector, DESIGN.md e Annnimate",
      "ancora": "#revisar-antes-de-publicar",
      "url": "https://brasilgeo.ai/leadlovers2026/design/#revisar-antes-de-publicar"
    },
    {
      "tema": "As 36 oficinas por guia",
      "ancora": "#oficinas-de-design",
      "url": "https://brasilgeo.ai/leadlovers2026/design/#oficinas-de-design"
    }
  ],
  "relacionados": [
    {
      "guia": "botoes",
      "motivo": "Botão de site, app, e-mail, formulário ou IA, com estados, alvo e envio seguro.",
      "url": "https://brasilgeo.ai/leadlovers2026/design/botoes/",
      "instrucoes": "https://brasilgeo.ai/leadlovers2026/design/botoes/agentes.md"
    },
    {
      "guia": "dashboards",
      "motivo": "Painel denso lido em uma tela: indicadores, escalas, múltiplos pequenos.",
      "url": "https://brasilgeo.ai/leadlovers2026/design/dashboards/",
      "instrucoes": "https://brasilgeo.ai/leadlovers2026/design/dashboards/agentes.md"
    },
    {
      "guia": "diagramas",
      "motivo": "Arquitetura e fluxo como código e SVG legível na exportação.",
      "url": "https://brasilgeo.ai/leadlovers2026/design/diagramas/",
      "instrucoes": "https://brasilgeo.ai/leadlovers2026/design/diagramas/agentes.md"
    },
    {
      "guia": "frontend2027",
      "motivo": "Ensinar agentes a desenhar telas com skills e waves.",
      "url": "https://brasilgeo.ai/leadlovers2026/design/frontend2027/",
      "instrucoes": "https://brasilgeo.ai/leadlovers2026/design/frontend2027/agentes.md"
    },
    {
      "guia": "graficos",
      "motivo": "Gráfico, paleta de séries e tabela equivalente.",
      "url": "https://brasilgeo.ai/leadlovers2026/design/graficos/",
      "instrucoes": "https://brasilgeo.ai/leadlovers2026/design/graficos/agentes.md"
    },
    {
      "guia": "icones",
      "motivo": "Família, sprite, e-mail sem imagem e teste de compreensão dos ícones.",
      "url": "https://brasilgeo.ai/leadlovers2026/design/icones/",
      "instrucoes": "https://brasilgeo.ai/leadlovers2026/design/icones/agentes.md"
    },
    {
      "guia": "navegacao",
      "motivo": "Menus, abas, paginação, gaveta e estado na URL.",
      "url": "https://brasilgeo.ai/leadlovers2026/design/navegacao/",
      "instrucoes": "https://brasilgeo.ai/leadlovers2026/design/navegacao/agentes.md"
    },
    {
      "guia": "react",
      "motivo": "Componentes, estado, operação cancelável, scrub com limpeza ao desmontar.",
      "url": "https://brasilgeo.ai/leadlovers2026/design/react/",
      "instrucoes": "https://brasilgeo.ai/leadlovers2026/design/react/agentes.md"
    },
    {
      "guia": "tailwind",
      "motivo": "Tokens, @theme, temas e DESIGN.md que a tela respeita.",
      "url": "https://brasilgeo.ai/leadlovers2026/design/tailwind/",
      "instrucoes": "https://brasilgeo.ai/leadlovers2026/design/tailwind/agentes.md"
    },
    {
      "guia": "typescript",
      "motivo": "Tipos, tsconfig, esquema de formulário e máquina de estados.",
      "url": "https://brasilgeo.ai/leadlovers2026/design/typescript/",
      "instrucoes": "https://brasilgeo.ai/leadlovers2026/design/typescript/agentes.md"
    }
  ],
  "fontes": [
    {
      "titulo": "Impeccable, de Paul Bakaus",
      "url": "https://github.com/pbakaus/impeccable"
    }
  ]
}
