Guia de referência lista os edge cases de UI que a IA de código costuma deixar passar
Publicado nesta semana no UX Collective, o documento nasceu de uma pergunta de cliente num workshop sobre fluxos agênticos: por que só revisar o código da IA depois, se dá pra entregar a lista de edge cases antes?

- Leitura
- 5 min
- Tabelas
- 1
- Fontes
- 1
Publicado nesta semana no UX↳UX33 conteúdosUX e IA: Transformando Experiências Digitais com Inteligência ArtificialProduto & UX · jan 2025UX, IA e Front-End: quando experiência, inteligência e código se encontram para criar o futuro digitalProduto & UX · jul 2025Novidades em UX/UI para 2025: O futuro do design de experiências digitaisProduto & UX · abr 2025Ver tudo em Produto & UX → Collective, o documento nasceu de uma pergunta de cliente num workshop sobre fluxos agênticos: por que só revisar o código da IA↳Inteligência artificial440 conteúdosUX e IA: Transformando Experiências Digitais com Inteligência ArtificialProduto & UX · jan 2025MCP: O que é e por que você vai ouvir falar disso em breve?AI · jul 2025IA generativa e a urgência de reconstruir nossa relação com a verdadeAI · jun 2025Ver tudo em AI → depois, se dá pra entregar a lista de edge cases antes?
A pergunta que virou documento
Adir SL estava num workshop sobre fluxos agênticos em design e desenvolvimento de UI quando o cliente fez uma pergunta simples que ninguém no time tinha uma resposta pronta. Em vez de aceitar que revisar o código gerado por IA, item por item, era inevitável, ele perguntou por que não entregar a lista de edge cases para a IA desde o início, como parte do prompt.
Se nós, designers e desenvolvedores, temos que checar o código da IA atrás de todos os pequenos mas importantes edge cases que ela pode deixar passar, por que não damos um documento ou uma lista de edge cases de UI para a IA desde o começo?
Cliente em workshop sobre fluxos agênticos, citado por Adir SL no UX CollectiveIf we, designers and developers, are left to check the AI's code for all the small but important edge cases it might miss, why don't we give a document or a list of UI edge cases to the AI to begin with?
Adir SL e um colega foram atrás de um documento assim pronto e não acharam nada genérico o suficiente para qualquer cliente e específico o suficiente para cobrir os casos do dia a dia. Encontraram material setorial, para militar, governo, área médica e telecom, mas não um guia de referência geral. A solução foi escrever o próprio documento, com mais de 15 anos de bagagem somada em design e desenvolvimento de UI entre os dois, e usá-lo para orientar o fluxo agêntico do cliente. Segundo a autora, o resultado foi um código gerado com menos lacunas.
Por que isso importa quando quem escreve a tela é a IA
O ângulo que interessa a quem desenha produto não é a lista em si, é a decisão por trás dela: transformar revisão reativa em especificação prévia. Hoje boa parte do código de interface sai de um prompt, e um prompt sem critério de borda tende a gerar a versão feliz do fluxo, aquela em que o campo nunca está vazio, o texto nunca é longo demais e a rede nunca cai.
O documento de Adir SL ataca exatamente esse ponto cego: em vez de description funcional ("crie uma lista de projetos"), o prompt ganha restrições de edge case ("trate lista vazia, nomes longos, erro de rede e estado de carregamento acima de 300ms"). Isso desloca o trabalho de design de produto de revisar depois do fato para especificar antes do fato, que é o tipo de decisão que normalmente separa um PM ou designer sênior de quem só aprova telas.
Se nós, designers e desenvolvedores, temos que checar o código da IA atrás de todos os pequenos mas importantes edge cases que ela pode deixar passar, por que não damos uma lista de UI edge cases para a IA desde o começo?
No original: If we, designers and developers, are left to check the AI's code for all the small but important edge cases it might miss, why don't we give a document or a list of UI edge cases to the AI to begin with?
As cinco categorias do guia
O documento organiza os edge cases em cinco grupos, cada um com: o que quebra, como testar e como projetar a correção.
| Categoria | O que costuma quebrar | Como testar |
|---|---|---|
| Guiada por conteúdo | Listas vazias, nomes longos, pluralização, imagem quebrada | Carregar conta nova, forçar contagens 0/1/2/muitos, apontar <img> para URL 404 |
| Guiada por estado | Carregamento, erro, estado otimista, dado desatualizado | Throttle de rede para "Slow 3G", mock de resposta 500/403, abrir o mesmo registro em duas sessões |
| Guiada por entrada | Foco de teclado, disabled vs. readonly, clique repetido, colar texto formatado | Navegar só com Tab/Shift+Tab/Enter/Espaço/Esc, clicar três vezes seguidas em um botão, colar texto rico do Word |
| Layout e responsivo | Viewport extremo, zoom, conteúdo dinâmico, scroll aninhado | Redimensionar para ultrawide e para tela dobrada, dar zoom a 200%, medir Cumulative Layout Shift |
| Sistema e ambiente | Dark mode, modo de alto contraste, movimento reduzido | Alternar prefers-color-scheme: dark, ativar Windows High Contrast, ativar "Reduzir Movimento" no SO |
Alguns exemplos concretos do próprio guia ajudam a calibrar o nível de detalhe esperado. No Hacker News, o contador de pontos e comentários muda de template conforme a quantidade: "discuss" quando não há comentário nenhum, "1 comment" no singular e "15 comments" no plural, em vez de um template único que erra a concordância em um dos dois extremos.
No Loading.io, o botão de ação muda visualmente no instante do clique para um estado de carregamento, o que evita o duplo clique disparando duas requisições. Já no MUI, o exemplo ilustra outro ponto: o intervalo entre a ação do usuário e a confirmação do servidor, com um estado de pendência visível no botão até a resposta chegar. No GOV.UK, o anel de foco de teclado é desenhado como elemento de primeira classe, não herdado do padrão do navegador.
O que fazer com isso no fluxo com IA generativa
O uso mais direto do guia, segundo o relato da própria autora, é como anexo de prompt em fluxos agênticos de geração de UI. Em vez de revisar o output da IA à procura de edge case por edge case, o time entrega a lista como restrição de entrada. Na prática isso significa três movimentos:
- Transformar cada categoria do guia em um item de checklist de aceite do componente, antes de aprovar o PR gerado por IA
- Incluir no prompt restrições explícitas de pluralização, truncamento e estado de erro, em vez de deixar a IA inferir sozinha
- Usar as colunas "como testar" do guia como roteiro de QA manual para qualquer tela nova, gerada por IA ou não
Em resumo: o documento não substitui teste de usuário nem pesquisa de discovery, ele reduz o retrabalho na camada de implementação, que é onde boa parte do tempo de design e desenvolvimento ainda se perde revisando o óbvio.
Os limites do guia
O próprio texto da UX Collective admite o limite: a versão publicada é a paráfrase em linguagem humana de um documento escrito sob encomenda para um cliente específico, com partes técnicas deixadas de fora para ficar genérico. Isso quer dizer que times com stack ou domínio muito particular (saúde, financeiro, governo) ainda vão precisar complementar com os documentos setoriais que a própria autora cita ter encontrado, voltados a áreas como militar, governo, medicina e telecom.
Também vale notar que o guia é uma lista de sintomas e correções, não uma metodologia de priorização: ele não diz qual edge case testar primeiro quando o prazo aperta, decisão que continua sendo de produto, não do documento. A pergunta boa para levar ao próprio backlog é simples: qual dessas cinco categorias o seu time nunca testou de propósito, só descobriu em produção?
Fonte: UX Collective
Highlights
- Documento de Adir SL lista edge cases de UI que IA generativa costuma deixar passar
- Cinco categorias cobrem conteúdo, estado, entrada, layout e ambiente do sistema
- Transformar revisão reativa em especificação prévia reduz retrabalho na implementação
- Guia não substitui testes de usuário, apenas reduz lacunas na geração de código
- Publicado no UX Collective com exemplos do Hacker News, MUI e GOV.UK
Este artigo foi escrito por Marina Pires, colunista de produto digital. Conteúdo produzido por agente de IA da redação iMasters, sob revisão editorial humana. Saiba como produzimos no expediente.
Code Connect do Figma conecta um componente a React, SwiftUI, Compose e Vue
Um mesmo componente de design pode apontar para implementações em React, SwiftUI, Jetpack Compose e Vue ao mesmo tempo, e isso reabre a conversa sobre quem decide nome de variante e estado.













