pbakaus/impeccable

O que é, em uma frase honesta

Impeccable é um conjunto de comandos e regras que ensina o agente de IA (Claude Code, Cursor, Copilot, Gemini) a falar a língua do design. Paul Bakaus, que veio da engenharia de performance do Google, partiu de uma constatação incômoda: todo modelo foi treinado nos mesmos templates de SaaS, então quase toda interface gerada por IA carrega os mesmos vícios, Inter em tudo, gradiente de roxo para azul, card dentro de card. O impeccable dá nome a esses vícios e ensina o caminho contrário, com um vocabulário que o agente e você passam a compartilhar.

Para que serve na prática

São duas frentes. A primeira é um detector determinístico de 44 anti-padrões que roda sem nenhum modelo de IA: você aponta para uma pasta, um arquivo ou uma URL e ele lista o que está genérico (fonte sobreusada, texto cinza sobre fundo colorido, padding apertado, alvo de toque pequeno, hierarquia de título pulada). Como não depende de IA, dá para colocar no CI e barrar regressão de design do mesmo jeito que se barra um teste quebrado.

A segunda frente são 23 comandos compartilhados entre você e o agente (audit, polish, critique, typeset, colorize, animate, distill), que leem o brief e os tokens do seu projeto e escrevem as mudanças direto no código, em variantes que você aprova ou rejeita.

Por que isso importa no AI-First

É a tese da casa de máquinas aplicada ao design. Quando qualquer pessoa gera uma tela pedindo para a IA, a ferramenta deixa de ser o diferencial, e o diferencial passa a ser não parecer com todo mundo e manter a sua marca de pé. Impeccable é engenharia de controle em volta do modelo, só que no eixo estético: ele transforma bom gosto, que costuma viver subjetivo e preso na cabeça de um designer, em vocabulário explícito que o time e a IA usam juntos.

É o tipo de alavanca que separa quem usa IA de quem arquiteta com ela.

A ressalva honesta

Impeccable complementa um sistema de design, não substitui. Ele assume que você tem, ou vai escrever, um brief de marca para ele respeitar, e rende mais quando você já sabe o que quer e precisa de consistência e velocidade. Boa parte dos comandos depende de uma IDE suportada, embora o detector rode sozinho de qualquer lugar.

A licença Apache 2.0 libera uso comercial. Vale instalar e rodar o detector no seu repositório hoje, custa um comando: baseado no projeto de Paul Bakaus em github.com/pbakaus/impeccable.