Agentes entregam UI que funciona e ainda falha no acabamento

Uma interface sai do pipeline de um agente, carrega no navegador e parece pronta. No detalhe, estados ausentes, formulários incompletos, acessibilidade fraca, metadata ruim, mobile quebrado e inconsistências de acabamento ainda passam sem alarme. Parte dessa revisão, até agora manual e subjetiva, começa a ser tratada como gate determinístico e repetível.

O que o shadscan faz — e o que devolve ao time

O shadscan é um auditor determinístico e read-only para interfaces React/shadcn. Na prática, ele inspeciona o código sem reescrevê-lo e sem depender de julgamento humano a cada execução. O pacote cobre 60 checks e devolve um score de 0 a 100 acompanhado de evidência — não um número solto, mas material que permite rastrear por que a nota subiu ou caiu.

O resultado não chega em bloco único. A ferramenta separa fixes, decisions e advisories, o que importa quando o time precisa distinguir correção obrigatória, decisão de produto e alerta de baixa confiança. Além do relatório, gera handoff para agentes, integra com CI e GitHub Actions e expõe MCP em modo read-only: o mesmo gate pode alimentar o pipeline de integração contínua e o próximo passo de um agente, sem abrir superfície de escrita no repositório.

O desenho de quality gate que a Saraiva.AI enxerga

A análise da Saraiva.AI identificou uma aplicação possível: usar o shadscan como quality gate visual na Fábrica/OpenWork Teams para projetos React/shadcn. O fluxo proposto é encadeado e explícito — o agente implementa a interface; o shadscan audita; um plano determinístico é entregue ao Codex ou ao Claude; o agente corrige; o CI exige score mínimo; a revisão humana valida o comportamento renderizado. O auditor não substitui o humano no final: tenta reduzir o volume de falhas de acabamento que chegam à revisão visual.

O que a análise estática ainda não comprova

Análise estática não comprova UX renderizada, conversão, identidade visual ou ausência de bugs. Essa fronteira é central: o score pode subir e a experiência no navegador ainda falhar. O próprio projeto mantém checks de baixa confiança como advisories, o que reforça que nem todo achado tem o mesmo peso operacional. O escopo é principalmente React/shadcn e frameworks suportados — fora desse perímetro, a promessa não se estende automaticamente.

Há também limites de operação e de privacidade. A Hosted API implica envio opt-in de repositório público ou de snapshot sanitizado. Para código privado, a orientação é preferir o CLI local. O fix automático, por fim, não é nativo do auditor: depende de um agente externo e do modelo de aprovação desse agente. Quem espera um botão de “corrigir tudo” dentro do shadscan está lendo além do que a ferramenta entrega.

O que isso significa para o seu negócio

Para um negócio brasileiro que já acelera entrega de interface com agentes em cima de React e shadcn, o ponto não é adotar mais um scanner por moda. É transformar falhas recorrentes de acabamento — estados, acessibilidade, formulários, metadata, mobile e consistência de implementação — em critério de passagem no CI, com evidência e handoff legível para o próximo agente. Em times que operam Fábrica ou OpenWork Teams, esse desenho pode encurtar o ciclo entre “implementou” e “revisão humana só do que realmente precisa de olho”.

A ressalva importa tanto quanto a promessa. O score não substitui validação humana do que o usuário vê, não prova conversão e não garante identidade visual. Em código privado, o caminho mais seguro permanece o CLI local; a API hospedada só entra com opt-in e repositório público ou snapshot sanitizado. Fix automático continua dependente de agente externo e de política de aprovação — o gate reduz ruído, mas não fecha sozinho o ciclo de qualidade.

A decisão de testar agora, com 46 em 50 no Radar, faz sentido quando o time já sofre com revisão manual inconsistente e quer um gate repetível antes da validação humana. Não faz sentido quando se espera que análise estática comprove UX, conversão ou ausência de bugs. O valor está em tornar determinística a parte da revisão que hoje depende de checklist solto e de memória de quem revisa.

Para sair da notícia e colocar a ferramenta para funcionar com critério, o caminho natural é o Playbook Saraiva.AI — com o guia em português previsto na Biblioteca após a validação técnica.

Curadoria Saraiva.AI

shadscan

Testar agoraFato verificadoEm desenvolvimento ativoMIT

46/50 no Radar

Ver fonte oficial