5 dicas para revisar interfaces com Impeccable

O repositório oficial descreve 24 comandos e um detector com 62 regras determinísticas para apontar padrões visuais problemáticos.

A versão consultada teve atividade no GitHub em 5 de novembro de 2026. Este guia organiza o que a documentação recomenda, sem instalar nem executar o projeto, e destaca um cuidado importante no modo live.

Como o Impeccable orienta agentes na revisão de interfaces

O Impeccable oferece uma linguagem de comandos para pedir mudanças específicas.

Em vez de escrever apenas “deixe a página mais bonita”, a pessoa pode pedir uma crítica da área de preços, ajustar o ritmo da página ou revisar o formulário de cadastro.

O README oficial do Impeccable organiza os comandos em orientação visual, revisão, acabamento e planejamento.

O repositório também descreve um detector que aplica regras determinísticas, sem depender de outra chamada de modelo.

Os mantenedores mostram no README dois resultados para a mesma descrição de uma pousada. A imagem de exemplo ilustra uma direção visual, mas não é um teste independente nem prova que toda interface ficará melhor com a ferramenta.

5 dicas para revisar interfaces com Impeccable

Dica 1: registre o objetivo do produto antes da revisão

O comando init pergunta o que falta para entender o projeto e escreve o arquivo PRODUCT.md, de acordo com a documentação.

Use esse momento para explicar o público, a tarefa principal, as restrições e o resultado que a interface precisa permitir.

Não comece com uma lista de cores. Se o agente não souber se a página deve gerar um contato, explicar uma função ou concluir uma compra, ele pode polir uma tela que não resolve o problema certo.

Dica 2: documente o sistema visual existente

O comando document registra em DESIGN.md os padrões visuais que já aparecem no projeto.

Isso ajuda o agente a preservar tipografia, espaçamento, cores e componentes que fazem parte da identidade, em vez de substituir tudo por uma aparência genérica.

Revise o arquivo produzido antes de tratá-lo como regra. Corrija decisões que não representam a marca e retire exceções antigas.

O agente passa a usar esse contexto nas próximas alterações, então um erro salvo pode se repetir em outras páginas.

Para planejar o que será feito antes do visual, veja as dicas de planejamento de tarefas com o BMAD Method.

Elas ajudam a separar objetivo, passos e critérios de aceite.

Dica 3: peça uma revisão de uma área por vez

O README recomenda apontar o comando para um alvo estreito. Por exemplo, peça uma critique da página de preços ou use polish em uma seção específica, em vez de pedir para revisar todo o produto numa única passada.

Uma área delimitada facilita comparar antes e depois e decidir se a mudança resolve um problema. Se a resposta trouxer várias recomendações, escolha uma prioridade, aplique e confira o resultado antes de avançar para a próxima.

Dica 4: diferencie critique, audit e detector

critique é descrito como uma avaliação de UX. audit gera um relatório técnico sobre temas como acessibilidade, desempenho, responsividade e tema visual.

Eles respondem a perguntas diferentes, então não use uma saída como substituta da outra.

O detector lista 62 regras determinísticas, segundo o README. Algumas verificações funcionam em arquivos de interface.

Checagens como contraste e tamanho de texto dependem de uma página renderizada. A documentação recomenda apontar o detector para um servidor local quando a regra exige renderização.

O resultado é uma lista de sinais para investigar, não um certificado de acessibilidade ou qualidade. Confirme os achados no navegador, com teclado e em tamanhos de tela que representem o uso real.

Dica 5: use hooks para detectar regressões, mas revise permissões

O Impeccable descreve um hook de design que devolve achados ao agente depois que ele edita arquivos de interface.

Se a ferramenta que você usa oferece esse hook, ele pode lembrar a equipe de conferir padrões visuais durante o trabalho, em vez de depender de uma checagem final esquecida.

O projeto também descreve um modo live para selecionar elementos em um servidor local e testar variantes.

O guia de criação de sites com IA em sete passos mostra outras formas de validar layout, formulários e conteúdo antes de publicar.

O que verificar antes de usar o modo live

O README alerta que Apply pode iniciar o CLI Codex ou Claude com aprovações, verificações de permissão e sandbox desativados se não houver uma sessão de chat consultando o modo live.

Isso não deve ser tratado como uma configuração segura por padrão.

A documentação informa que IMPECCABLE_LIVE_COPY_AGENT=chat mantém Apply na sessão de chat.

IMPECCABLE_LIVE_COPY_AGENT=off desativa essa ação. Mantenha o modo live apenas em servidor local e revise o comportamento antes de aceitar alterações.

Não enfraqueça a política de segurança de um site publicado.

O repositório principal declara licença Apache 2.0. Na consulta de 5 de novembro, não encontrei um arquivo SECURITY.md nem avisos publicados na página de advisories do GitHub.

Isso não prova ausência de vulnerabilidades. Revise permissões e código antes de adotar o projeto em um ambiente sensível.