# Design (entrada da pasta): instruções para agentes de IA

- Página: Execução visual para páginas e campanhas · Leadlovers 2026 (https://brasilgeo.ai/leadlovers2026/design/)
- Revisado em: 2026-11-16
- JSON com o mesmo conteúdo: https://brasilgeo.ai/leadlovers2026/design/agentes.json
- Índice dos guias de Design para agentes: https://brasilgeo.ai/leadlovers2026/design/llms.txt
- Esquema: design-guia-para-agentes/v1

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.

## Quando consultar

- 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

- **DSG-01** (obrigatória). 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. Por quê: Cada pedido separado é nova chance de trocar o padrão. Referência: Lucide (traço único, ISC).
- **DSG-02** (obrigatória). Cor de ícone vem de token (var(--color-icon)) e o desenho usa stroke="currentColor". Nunca cravar hexadecimal. Por quê: #1a1a1a vira preto sobre preto no tema escuro; com currentColor, hover, foco e desabilitado movem rótulo e ícone juntos.
- **DSG-03** (obrigatória). 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. Por quê: 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.
- **DSG-04** (obrigatória). 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. Por quê: Sem crédito você descumpre o combinado mesmo com download grátis. A Lucide 1.0 (23/03/2026) removeu os ícones de marca.
- **DSG-05** (obrigatória). 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. Por quê: 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.
- **DSG-06** (obrigatória). 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. Por quê: Quase toda tela vive nos dois primeiros, que pesam zero.
- **DSG-07** (obrigatória). 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. Por quê: 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.
- **DSG-08** (obrigatória). 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. Por quê: Acima de 400 ms a interface fica preguiçosa.
- **DSG-09** (obrigatória). 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. Por quê: Thaler contra Perlmutter (18/03/2025): direito autoral exige obra criada por gente; a contribuição humana registrada é o que protege.
- **DSG-10** (obrigatória). Siga a ordem direito, coerência, peso. Registre plataforma, data, instrução e edições em arquivo ao lado da imagem. Por quê: Cada plataforma define quem detém a saída; descobrir com a campanha no ar custa mais que refazer a arte.
- **DSG-11** (obrigatória). 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. Por quê: O modelo erra palavra e acento, sobretudo em português; sem pedido base, cada seção sai com uma estética.
- **DSG-12** (obrigatória). 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. Por quê: Esteira do guia: 4,2 MB original, 380 KB na largura real, 96 KB em AVIF.
- **DSG-13** (obrigatória). 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. Por quê: Medidas reservam o espaço e evitam o botão mudar de lugar na hora do toque (CLS).
- **DSG-14** (obrigatória). 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. Por quê: Teste isolado de laboratório não comprova a experiência do público.
- **DSG-15** (obrigatória). 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. Por quê: Parte dos defeitos só aparece no celular. Trecho repetido 20 vezes ou mais costuma vir de um estilo compartilhado: confira no navegador.
- **DSG-16** (recomendada). 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. Por quê: Formato em fase alfa no Google Labs; troca gosto pessoal por conferência repetível.
- **DSG-17** (recomendada). 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. Por quê: Importação em bloco arrasta a coleção. Cinco arquivos cobrem tudo; a lista de dezenove tamanhos envelheceu.
- **DSG-18** (recomendada). 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. Por quê: Misturar estilos equivale a misturar famílias de ícone.

## Decisões rápidas

| Situação | Escolha | Evite |
| --- | --- | --- |
| Botões, CTA, estados, envio, botão de IA | Abra o guia Botões: https://brasilgeo.ai/leadlovers2026/design/botoes/agentes.md |  |
| Painel que o gestor lê em uma tela | Abra o guia Dashboards: https://brasilgeo.ai/leadlovers2026/design/dashboards/agentes.md |  |
| Diagrama de arquitetura ou fluxo como código | Abra o guia Diagramas (Mermaid, D2): https://brasilgeo.ai/leadlovers2026/design/diagramas/agentes.md |  |
| Gráfico ou visualização de dados fora de painel | Abra o guia Gráficos: https://brasilgeo.ai/leadlovers2026/design/graficos/agentes.md |  |
| Menu, abas, paginação, gaveta, catálogo compartilhável por URL | Abra o guia Navegação: https://brasilgeo.ai/leadlovers2026/design/navegacao/agentes.md |  |
| Tokens, @theme, tema claro e escuro, CSS moderno | Abra o guia Tailwind e tokens: https://brasilgeo.ai/leadlovers2026/design/tailwind/agentes.md |  |
| Componente React, estado, operação cancelável, lista animada | Abra o guia React: https://brasilgeo.ai/leadlovers2026/design/react/agentes.md |  |
| tsconfig, esquema de formulário, máquina de estados | Abra o guia TypeScript: https://brasilgeo.ai/leadlovers2026/design/typescript/agentes.md |  |
| Ensinar o agente a desenhar telas com skills e waves | Abra o guia frontend-2027: https://brasilgeo.ai/leadlovers2026/design/frontend2027/agentes.md |  |
| Ícone, ilustração, fonte, animação, imagem de IA ou peso | Fique nesta pasta e siga as regras DSG; o catálogo de 36 tipos de peça traz a receita de cada formato. | Procurar essas decisões nos outros guias. |
| Hover, foco, entrada de bloco, janela sobreposta, menu flutuante | CSS puro ou recurso nativo (dialog, popover, ancoragem por CSS). | Motion ou GSAP. |
| Gesto, mola, arrastar, reordenar em React | Motion (13.1.0, MIT). | GSAP para revelar bloco. |
| Linha do tempo longa na rolagem, cinco peças ou mais em ordem | GSAP (gratuito desde 30/04/2025), com useGSAP em React. | CSS puro com atrasos manuais. |
| Dois tipos de peça resolvem a mesma função | Vence o que pesa menos na rede de quem visita. |  |

## Números de referência

| Valor | Para quê | Fonte |
| --- | --- | --- |
| 36 oficinas, 245 critérios, 36 tipos de peça | Tamanho do material da pasta. | Hub Design |
| 44 px e 24 px | Alvo de toque do guia e mínimo da WCAG 2.2. | Seção Ícones |
| 120 a 200, 200 a 300 e 240 ms | Microinteração, troca de estado, entrada. | Seção Movimento |
| 150 KB | Teto de foto e cena no espaço exibido. | Seção Formato e peso |
| 4,2 MB, 380 KB, 96 KB | Original, largura real e AVIF. | Seção Formato e peso |
| LCP 2,5 s, INP 200 ms, CLS 0,1 | Limites no percentil 75. | Seção Formato e peso |
| 8,4% a mais de conversão por 0,1 s | Ganho de 0,1 s no celular no varejo. | Deloitte, 37 marcas |
| 390 x 844 | Viewport do segundo passe do detector. | Revisar a tela |

## Erros comuns e a correção

- 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.

## Padrões de código

### Entrada de bloco com estado base visível

Revelar cartão ou seção ao entrar na tela.

```css
@keyframes entrar { from { opacity: 0; transform: translateY(16px); } }
.cartao { animation: entrar 240ms ease-out; }
@media (prefers-reduced-motion: reduce) { .cartao { animation: none; } }
@supports (animation-timeline: view()) {
  .cartao { animation-timeline: view(); animation-range: entry 0% entry 40%; }
}
```

### Pedido base de ilustração

Gerar conjunto coerente por IA.

```text
Ilustração plana, traço de 2 px, sem gradiente, sem sombra, sem texto.
Paleta: tokens da marca (4 cores), fundo claro.
Tema desta peça: [uma frase]. Proporção: [1:1 | 3:1].
Saída: SVG com viewBox.
Registro: plataforma, data, este pedido e edições, em arquivo ao lado.
```

## Checklist antes de entregar

- [ ] 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 citadas

- **Lucide (ISC)**: Família de ícones de traço importada por nome.
- **Fontsource**: Fonte variável hospedada no projeto.
- **SVGO 4**: Limpar SVG exportado mantendo viewBox e title.
- **Impeccable 4.5.0 (detect)**: Detector sem modelo de linguagem contra a página publicada.
- **DESIGN.md e @google/design.md lint**: Contrato visual com tokens em YAML.
- **verify.contentauthenticity.org (C2PA)**: Ler o selo Content Credentials de imagem recebida.

## Onde aprofundar na página

- [Ícones, alvo de toque e ícone de aplicativo](https://brasilgeo.ai/leadlovers2026/design/#icones)
- [Licença de ilustração e fonte, SVGO](https://brasilgeo.ai/leadlovers2026/design/#ilustracoes)
- [Escada de movimento e regras fixas](https://brasilgeo.ai/leadlovers2026/design/#animacao)
- [Imagem gerada por IA: direito, coerência, peso](https://brasilgeo.ai/leadlovers2026/design/#geracao-imagens)
- [Formato, peso e Core Web Vitals](https://brasilgeo.ai/leadlovers2026/design/#formato-peso)
- [Catálogo dos 36 tipos de peça com receita](https://brasilgeo.ai/leadlovers2026/design/#catalogo)
- [Prompts prontos](https://brasilgeo.ai/leadlovers2026/design/#prompts)
- [Revisão com detector, DESIGN.md e Annnimate](https://brasilgeo.ai/leadlovers2026/design/#revisar-antes-de-publicar)
- [As 36 oficinas por guia](https://brasilgeo.ai/leadlovers2026/design/#oficinas-de-design)

## Guias relacionados

- [Botões](https://brasilgeo.ai/leadlovers2026/design/botoes/): Botão de site, app, e-mail, formulário ou IA, com estados, alvo e envio seguro. Instruções: https://brasilgeo.ai/leadlovers2026/design/botoes/agentes.md
- [Dashboards](https://brasilgeo.ai/leadlovers2026/design/dashboards/): Painel denso lido em uma tela: indicadores, escalas, múltiplos pequenos. Instruções: https://brasilgeo.ai/leadlovers2026/design/dashboards/agentes.md
- [Diagramas](https://brasilgeo.ai/leadlovers2026/design/diagramas/): Arquitetura e fluxo como código e SVG legível na exportação. Instruções: https://brasilgeo.ai/leadlovers2026/design/diagramas/agentes.md
- [frontend-2027](https://brasilgeo.ai/leadlovers2026/design/frontend2027/): Ensinar agentes a desenhar telas com skills e waves. Instruções: https://brasilgeo.ai/leadlovers2026/design/frontend2027/agentes.md
- [Gráficos](https://brasilgeo.ai/leadlovers2026/design/graficos/): Gráfico, paleta de séries e tabela equivalente. Instruções: https://brasilgeo.ai/leadlovers2026/design/graficos/agentes.md
- [Ícones](https://brasilgeo.ai/leadlovers2026/design/icones/): Família, sprite, e-mail sem imagem e teste de compreensão dos ícones. Instruções: https://brasilgeo.ai/leadlovers2026/design/icones/agentes.md
- [Navegação](https://brasilgeo.ai/leadlovers2026/design/navegacao/): Menus, abas, paginação, gaveta e estado na URL. Instruções: https://brasilgeo.ai/leadlovers2026/design/navegacao/agentes.md
- [React](https://brasilgeo.ai/leadlovers2026/design/react/): Componentes, estado, operação cancelável, scrub com limpeza ao desmontar. Instruções: https://brasilgeo.ai/leadlovers2026/design/react/agentes.md
- [Tailwind e tokens](https://brasilgeo.ai/leadlovers2026/design/tailwind/): Tokens, @theme, temas e DESIGN.md que a tela respeita. Instruções: https://brasilgeo.ai/leadlovers2026/design/tailwind/agentes.md
- [TypeScript](https://brasilgeo.ai/leadlovers2026/design/typescript/): Tipos, tsconfig, esquema de formulário e máquina de estados. Instruções: https://brasilgeo.ai/leadlovers2026/design/typescript/agentes.md

## Fontes primárias

- [Impeccable, de Paul Bakaus](https://github.com/pbakaus/impeccable)
