Impeccable

Introdução

Impeccable é uma skill de design open-source, ferramenta de linha de comando, extensão de navegador e site criados para melhorar a qualidade visual das interfaces frontend produzidas por agentes de codificação com IA. Ele resolve uma frustração comum no desenvolvimento assistido por IA: as interfaces geradas costumam apresentar falhas reconhecíveis, como layouts genéricos, títulos vagos, grades de cards uniformes e espaçamento inconsistente — padrões que o próprio projeto cataloga sob o rótulo de "slop". O Impeccable dá ao agente a expertise de design necessária para criar novas páginas, melhorar as existentes e manter a consistência com o design system do projeto.

O toolkit funciona fornecendo orientações de design aos agentes de IA por meio de comandos estruturados e arquivos de contexto do projeto, além de um detector determinístico que sinaliza anti-padrões comuns em UIs geradas. Os usuários executam npx impeccable install na raiz do projeto, registram o contexto do produto em PRODUCT.md e podem habilitar hooks para que o detector rode automaticamente conforme o agente edita os arquivos de UI. Um Live Mode permite iterar sobre páginas renderizadas no navegador, comparar variantes geradas de um elemento nomeado e gravar as alterações aceitas de volta no código-fonte. O Impeccable foi criado por Paul Bakaus e é distribuído como software livre e open-source.

Principais Recursos

• Detecção de anti-padrões: Um detector determinístico identifica falhas reconhecíveis de UI gerada por IA, disponível via CLI (npx impeccable detect) para arquivos, diretórios e URLs renderizadas, além de uma sobreposição no navegador.
• 24 comandos de design: Comandos como shape, critique, audit, polish, harden, optimize, extract e document cobrem o fluxo de trabalho desde o briefing inicial até o refinamento final.
• Live Mode: O usuário seleciona um elemento no navegador ou o nomeia no chat, gera variantes de UI, compara lado a lado e aceita uma delas diretamente no código-fonte, sem cópia manual.
• Suporte a design systems: A ferramenta registra o sistema visual existente em DESIGN.md, reutiliza componentes e tokens e mantém o trabalho futuro do agente consistente com as decisões de design estabelecidas.
• Verificações automáticas via hooks: Hooks nativos do provedor executam o detector conforme o agente edita os arquivos de UI, capturando padrões problemáticos durante o trabalho, e não depois.
• Ampla compatibilidade com agentes: Funciona com Codex CLI, Claude Code, GitHub Copilot, Cursor, Gemini CLI, Grok Build, Antigravity, OpenCode, Pi e Hermes Agent, desde que a ferramenta de codificação suporte hooks.
• Arquivos de contexto do projeto: PRODUCT.md e briefings de design armazenam objetivos do produto e prioridades dos usuários para que as interfaces geradas reflitam o que importa para os usuários do projeto.

Destaques

• Preço: Gratuito e open-source, sem planos pagos indicados nas páginas analisadas; o projeto observa que pode substituir alguns produtos pagos.
• Instalação: A forma mais rápida de instalar é npx impeccable install na raiz do projeto, seguida da inicialização do projeto e da ativação das verificações automáticas.
• Extensão de navegador e overlay: Um overlay de crítica visual combina detecção determinística com revisão no navegador, disponível junto com a CLI e o site.
• Opções de configuração: .impeccable/config.json suporta exceções do detector, comentários de ignore inline e múltiplas raízes de projeto, e um comando doctor repara divergências entre os arquivos do projeto e a versão instalada.

Para Quem É

O Impeccable é voltado para desenvolvedores e equipes pequenas que constroem interfaces frontend com agentes de codificação com IA como Claude Code, Cursor ou GitHub Copilot e estão insatisfeitos com a aparência genérica das UIs geradas por IA. Ele atende engenheiros frontend que mantêm um design system, criadores solo que publicam landing pages rapidamente e designers que trabalham junto com agentes e querem um registro das decisões de design que o agente deve respeitar. Também é útil para equipes que modernizam ferramentas internas, onde branding consistente e redução do ruído visual são importantes.