Voltar
SitePoint Team

Como revisar mudanças de UI geradas por IA com Storybook e Chromatic

Aprofundamento CEVIU

Aprofundamento

O texto descreve um playbook para revisar mudanças de interface geradas por agentes como Cursor, Copilot Agent, Devin e Claude Code. O ponto de partida é que o diff bruto não serve bem para isso. Em changesets com mais de 50 arquivos, o código pode passar em linting e checagem de tipos e ainda assim jogar um botão de call-to-action para fora da tela em certos breakpoints. Um tipo de erro assim não aparece numa tela de diff. Vale notar que human-authored aparece no texto apenas como contraponto: o diff gerado por IA é comparado ao escrito por humanos, e não é um projeto ou ferramenta com nome próprio, nem há repositório identificado. O que existe é o artigo e a metodologia que ele propõe.

O playbook tem quatro etapas. Primeiro, limitar cada prompt a um único componente (por exemplo, refatorar o PricingCard para usar os novos design tokens), com instruções em .cursorrules ou CLAUDE.md que fixam um limite de arquivos e exigem a story correspondente. Segundo, isolar a mudança no Storybook, com estados como padrão, destacado, desabilitado, responsivo e conteúdo longo. Terceiro, rodar o Chromatic no CI, comparando cada snapshot com a baseline aceita, com fetch-depth: 0 no checkout para achar o commit ancestral. Quarto, um checklist no template de pull request. A stack citada é Storybook 8, 9 ou 10, com React ou Vue 3, e o Percy aparece como alternativa. As limitações vêm do próprio texto: o plano gratuito do Chromatic tem cota de snapshots, e exitZeroOnChanges: true nunca bloqueia um merge sozinho. Sem story, o Chromatic não tem o que fotografar.

O que mudou

A cobertura anterior do CEVIU tratava a revisão de código com IA sobretudo no plano do processo. Em 4 de março de 2026, o CEVIU noticiou "Como Eliminar a Revisão de Código", sobre PRs parados e revisores que olham diffs grandes de forma superficial. Em 13 de outubro de 2026, veio "Revisão de Código com IA: O Futuro da Qualidade e Segurança no Desenvolvimento de Software", e em 14 de outubro de 2026, "A IA e o Futuro da Revisão de Código: Menos Linhas, Mais Estratégia", ambas apontando que a leitura linha a linha perde eficiência. A notícia de agora leva a mesma discussão para a interface: a verificação sai do texto do diff e vai para o resultado renderizado.

Por que isso importa

Para quem trabalha com design e UX/UI, a leitura é que a revisão visual deixa de ser trabalho só de quem programa. Se a story e o snapshot são a superfície de revisão, designers podem comparar baseline e nova versão lado a lado e checar espaçamento, responsividade e atributos de acessibilidade que o código não mostra. Isso também dá um uso concreto aos design tokens e aos sistemas de design: uma mudança de token vira diff visual e pode ser aprovada por quem entende de interface.

Linha do tempo

  1. CEVIU noticia "Como Eliminar a Revisão de Código", sobre gargalos em PRs e diffs grandes.

  2. CEVIU publica "Revisão de Código com IA: O Futuro da Qualidade e Segurança no Desenvolvimento de Software".

  3. CEVIU publica "A IA e o Futuro da Revisão de Código: Menos Linhas, Mais Estratégia".

  4. Playbook de revisão de UI gerada por IA com Storybook e Chromatic em quatro etapas.

Perguntas frequentes

Por que o diff de código não basta para revisar UI gerada por IA?

Porque o código pode ser válido e passar em linting e tipos, mas renderizar errado. Um flex container reestruturado pode empurrar um botão para fora da tela em certos breakpoints. Esse tipo de regressão só aparece comparando o resultado visual com uma baseline.

Qual o papel do Storybook nesse fluxo?

Ele renderiza cada componente isolado, com estados definidos por props e args. Assim o revisor vê os estados que a IA pode ter alterado sem subir a aplicação inteira. Também é a base dos snapshots que o Chromatic compara.

O que o Chromatic faz a cada pull request?

Captura um snapshot de cada story e compara com a baseline aceita, destacando as áreas que mudaram. O revisor aceita ou rejeita cada story. Ao aceitar, o snapshot vira a nova baseline.

Quais cuidados ao adotar o Chromatic?

O plano gratuito limita os snapshots por mês, então vale checar os preços antes de ligar em bibliotecas grandes. Com exitZeroOnChanges: true, regressões não bloqueiam o merge, e o texto recomenda migrar para false depois que o time confiar no processo. Sem fetch-depth: 0 no checkout, todas as stories aparecem como novas e a verificação perde o sentido.

Fontes

Avalie este artigo:
Categoria
CEVIU Design
Publicado
23 de outubro de 2026
Editoria
CEVIU Design

Quer receber mais sobre CEVIU Design?

Conteúdo curado diariamente, direto no seu e-mail.

Conteúdo curado diariamenteDiversas categoriasCancele quando quiser