Repolode
pbakaus

pbakaus/impeccable

Orientações de design para agentes de programação com IA, com uma skill de design, 24 comandos, iteração ao vivo no navegador e 61 regras determinísticas de detecção para interfaces frontend geradas por IA.

Estrelas
83,060
Forks
5,022
Issues abertas
48
Último commit
há 3 horas

O que é?

Impeccable é uma skill e um toolkit de design para agentes de programação com IA, como Claude Code, Cursor, Codex CLI e Gemini CLI. Ele oferece ao agente um vocabulário de design compartilhado por meio de comandos como polish, audit, critique, distill e animate, além de uma etapa de inicialização que registra o contexto do produto em PRODUCT.md para que os comandos seguintes conheçam o público e as restrições.

Também inclui uma CLI independente e uma extensão de navegador que executam 61 regras determinísticas de detecção em HTML, diretórios de código-fonte ou URLs ativas, sem precisar de LLM ou chave de API. As regras identificam padrões comuns em interfaces frontend geradas por IA, como fontes usadas em excesso, gradientes roxos, cards aninhados e animações com efeito de quique, além de problemas gerais, como alvos de toque pequenos e títulos pulados.

Nos ambientes compatíveis, um hook instalável executa o detector após edições diretas em arquivos de UI e retorna os resultados ao fluxo de trabalho do agente. O modo ao vivo permite iterar sobre elementos da página no navegador, usando um servidor de desenvolvimento local ou HTML estático.

Recursos principais

  • 01Uma etapa de inicialização /impeccable init registra o contexto do produto em PRODUCT.md.
  • 0224 comandos para critique, audit, polish, layout, tipografia, animação e muito mais.
  • 0361 regras determinísticas de detecção, executáveis pela CLI, pela extensão de navegador ou por um hook de agente.
  • 04Modo ao vivo no navegador para iterar sobre elementos usando um servidor de desenvolvimento local ou HTML estático.
  • 05O instalador é compatível com várias ferramentas de programação com IA, incluindo Cursor, Claude Code, Codex CLI e Gemini CLI.

Casos de uso

  • Melhorar a qualidade visual do código frontend gerado por um agente de programação com IA.
  • Auditar uma página da web existente em busca de problemas de acessibilidade, responsividade e layout antes de publicá-la.
  • Executar o detector no CI em HTML ou JSX para sinalizar padrões genéricos de design comuns em conteúdo gerado por IA.
  • Analisar uma URL de produção em busca de anti padrões de design sem tocar no código-fonte.

Início rápido

  1. 1

    Instale a skill no seu projeto a partir da raiz do projeto

    npx impeccable install
  2. 2

    Na sua ferramenta de programação com IA, execute o comando de configuração inicial

    /impeccable init

Antes de usar

  • O instalador npx requer Node.js, mas as opções de instalação manual e via Git funcionam sem ele.
  • Alguns ambientes exigem etapas adicionais, como aprovar hooks ou configurar a confiança, antes que os hooks de design sejam executados.

Tópicos

Perguntas frequentes

O que é impeccable?
Orientações de design para agentes de programação com IA, com uma skill de design, 24 comandos, iteração ao vivo no navegador e 61 regras determinísticas de detecção para interfaces frontend geradas por IA. Impeccable é uma skill e um toolkit de design para agentes de programação com IA, como Claude Code, Cursor, Codex CLI e Gemini CLI. Ele oferece ao agente um vocabulário de design compartilhado por meio de comandos como polish, audit, critique, distill e animate, além de uma etapa de inicialização que registra o contexto do produto em PRODUCT.md para que os comandos seguintes conheçam o público e as restrições.
impeccable é gratuito? Qual é a licença?
impeccable é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
impeccable ainda é mantido?
Manutenção ativa. O último commit de impeccable foi em 19 de out. de 2026.
Para que posso usar impeccable?
Melhorar a qualidade visual do código frontend gerado por um agente de programação com IA. Auditar uma página da web existente em busca de problemas de acessibilidade, responsividade e layout antes de publicá-la. Executar o detector no CI em HTML ou JSX para sinalizar padrões genéricos de design comuns em conteúdo gerado por IA. Analisar uma URL de produção em busca de anti padrões de design sem tocar no código-fonte.
Como instalar impeccable?
Instale a skill no seu projeto a partir da raiz do projeto: npx impeccable install Na sua ferramenta de programação com IA, execute o comando de configuração inicial: /impeccable init
Onde consigo impeccable?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/pbakaus/impeccable

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados