O Impeccable não é a ArtCraft nem faz parte dos produtos ou da suíte da ArtCraft; esta página é um guia independente, e as informações oficiais estão em impeccable.style e github.com/pbakaus/impeccable.
Impeccable: o vocabulário de design do seu agente de código
Impeccable é um skill de design e uma ferramenta de linha de comando de código aberto que dá ao seu agente de programação um vocabulário comum para revisar, ajustar e polir interfaces. Foi criado por Paul Bakaus a partir do skill frontend-design da Anthropic e é distribuído sob a licença Apache-2.0. Esta página é um guia independente, não a documentação oficial.
- 24 comandos: critique, polish, audit, typeset, distill e outros
- Detector com 62 regras determinísticas, sem LLM e sem chave de API
- Funciona com Claude Code, Cursor, Codex CLI, Copilot e 19 agentes no total
Site oficialRepositório no GitHubDocumentação
Última atualização: · English
O que é o Impeccable
O Impeccable é um skill que se instala no agente de código e lhe entrega um vocabulário de design, além de uma CLI independente. Ele não abre uma tela de desenho: transforma design em ações que o agente consegue executar, da crítica à tipografia, passando por limpeza e robustez. O projeto nasceu do skill frontend-design da Anthropic e é publicado sob Apache-2.0.
O alvo é o gosto padrão dos agentes: Inter em tudo, gradientes de roxo para azul, cartões dentro de cartões, texto cinza sobre fundo colorido e um quadradinho de ícone arredondado acima de cada título. Sessenta e duas regras determinísticas sinalizam esses vícios durante a edição, sem LLM e sem chave de API.
Ele rende mais em interfaces que já existem: você aponta para uma página ou um componente e itera. Também cria páginas novas, mas o próprio projeto admite que esse modo é mais difícil. Vale deixar claro: o Impeccable é um projeto aberto e independente, não é produto da ArtCraft nem integra a suíte dela.
Instalação e primeiros passos
Rode o comando na raiz do projeto. O npx exige Node 18.19 ou superior. O instalador detecta suas ferramentas, pergunta se a instalação é do projeto ou global e oferece o hook de design quando a ferramenta permite. Aceite o hook.
Depois, recarregue a ferramenta e execute /impeccable init ($impeccable init no Codex). Para automação, use --providers=claude,codex,cursor e --scope=project|global. Uma instalação existente é atualizada com npx impeccable update.
npx impeccable install- Confirme o Node 18.19+ e abra a raiz do projeto.
- Execute npx impeccable install, escolha o escopo do projeto ou global e ative o hook de design se houver suporte.
- Recarregue a ferramenta de código e rode /impeccable init ($impeccable init no Codex) para gerar o PRODUCT.md.
- Se quiser fixar o sistema visual, rode /impeccable document e crie o DESIGN.md; depois mantenha tudo em dia com npx impeccable update.
Comandos principais
São 24 comandos. O uso é “comando + alvo”, como em /impeccable critique the pricing cards; no Codex, troque a barra por $. Digitar só /impeccable mostra a lista. Estes são os sete mais úteis.
| Comando | O que faz | Quando usar |
|---|---|---|
/impeccable init | Lê o código, pergunta apenas o que não consegue inferir e grava o PRODUCT.md. | Uma vez no começo do projeto, para dar contexto aos demais comandos. |
/impeccable critique | Faz uma revisão de UX pontuada por heurísticas de usabilidade e ordena o que corrigir primeiro. | Antes de redesenhar ou para descobrir onde um fluxo trava. |
/impeccable polish | Dá a última passada antes de publicar. | Quando as funcionalidades estão fechadas e o lançamento se aproxima. |
/impeccable audit | Gera um relatório técnico de acessibilidade, desempenho, temas, responsividade e integridade da implementação, com achados de P0 a P3. | Antes de uma release ou para atacar dívida de implementação. |
/impeccable typeset | Corrige fontes, hierarquia, tamanhos e espaçamento. | Quando a tipografia parece frouxa ou a hierarquia não se sustenta. |
/impeccable distill | Remove o que a página não precisa. | Quando há conteúdo demais e o foco se perde. |
/impeccable hooks status|on|off | Consulta, liga ou desliga o hook de design, que analisa os arquivos de UI editados pelo agente. | Para confirmar que a checagem automática está ativa ou pausá-la. |
Fluxo de trabalho recomendado
Primeiro o contexto, depois a tela. O init pergunta só o que não dá para deduzir: para quem é o produto, o que ele precisa entregar e quais restrições existem. As respostas vão para o PRODUCT.md e são lidas por todos os comandos seguintes. Se já houver um sistema visual, rode document para registrar as regras de marca no DESIGN.md e evitar que o agente mude de estilo no meio do caminho.
Quanto mais estreito o alvo, melhor o resultado. Em vez de “refaça a página inteira”, peça “critique os cartões de preço”. Comandos frequentes podem ser fixados com /impeccable pin audit, que cria o atalho /audit; antes de publicar, feche com audit e depois polish.
- Rode /impeccable init uma vez por projeto e revise o PRODUCT.md gerado.
- Se existir um design system, rode /impeccable document e resuma fontes, cores e componentes no DESIGN.md.
- Itere por seção: /impeccable critique the pricing cards e depois bolder, quieter, distill ou typeset para ajustar a direção.
- Antes de publicar, rode /impeccable audit e /impeccable polish em sequência e fixe seus comandos favoritos com pin.
Agentes compatíveis
A lista oficial é ampla: Claude Code, Cursor, Codex CLI, GitHub Copilot, Devin, Replit Agent, Gemini CLI, Grok Build, OpenCode, Google Antigravity, Kiro, Trae, Rovo Dev, Qoder, Mistral Vibe, Pi, Hermes Agent, DeepSeek Harness e Veto. A instalação muda conforme a ferramenta; a lista completa está na documentação oficial.
Claude Code, Copilot e Grok têm plugins; o hook de design existe no Claude Code, Cursor, Codex, GitHub Copilot, Grok Build e Hermes Agent. No Codex é preciso aprovar o hook do projeto em /hooks; no Grok Build, rodar /hooks-trust; no Hermes, habilitar o plugin.
Sem Node, dá para copiar a pasta do skill na mão. Para usar só o detector, npx impeccable detect dispensa agente. O modo live funciona com Vite, Next, SvelteKit, Astro, Nuxt e HTML puro, mas altera apenas uma cópia local do projeto.
Impeccable x ArtCraft MCP
Os nomes se parecem porque ambos colocam agentes para trabalhar, mas atuam em camadas diferentes. O Impeccable mexe no código-fonte da interface; o ArtCraft MCP é o MCP/CLI oficial por aplicativo da storytold, que controla Crafting Apps locais como o PhotoCraft. Também não é a API por assinatura da comunidade que usa o nome artcraft-mcp.
| Dimensão | Impeccable | ArtCraft MCP |
|---|---|---|
| Sobre o que atua | Código front-end no repositório: componentes, JSX/TSX, CSS e estrutura de página. | Crafting Apps locais (como o PhotoCraft) e seus fluxos de imagem e vídeo. |
| O que entrega | Recomendações de design, mudanças de código, relatórios critique/audit e os arquivos PRODUCT.md e DESIGN.md. | Imagens ou vídeos e operações automatizadas dentro desses aplicativos. |
| Quando escolher | Para construir, avaliar ou polir uma interface front-end. | Para gerar ou processar imagens e vídeos em escala e automatizar o trabalho nesses apps. |
| Dá para combinar? | Sim: a interface fica com o Impeccable e a produção de mídia com o ArtCraft MCP. | Sim, mas só para ativos de mídia: ele não faz revisão de design de interface nem substitui o Impeccable. |
Guia do ArtCraft MCPCrafting Apps
Limites e segurança
O Impeccable é um skill de design front-end e uma CLI, não um aplicativo de design nem um gerador de imagens. O modo live edita apenas uma cópia local; não o injete em um site publicado nem afrouxe a CSP de produção para fazê-lo funcionar.
Os hooks rodam fora da aprovação do modelo. No Claude Code, um hook de comando instalado pode executar mesmo que você recuse os comandos do modelo, e a primeira edição pode baixar o motor. Revise os hooks antes de execuções sem supervisão ou desligue-os com --settings '{"disableAllHooks": true}'.
A telemetria registra de forma anônima quais direções visuais foram mostradas e qual foi escolhida; ela não envia nome do projeto, arquivos, código nem PRODUCT.md. Para desligar: npx impeccable telemetry off, DO_NOT_TRACK=1 ou "telemetry": false em .impeccable/config.json. No detector, o código de saída 2 indica achados e o 1, que o alvo não pôde ser escaneado.
Guias relacionados
Perguntas frequentes
O que é o Impeccable e ele é um produto da ArtCraft?
O Impeccable é um skill de design e uma CLI para agentes de código criado por Paul Bakaus, com 24 comandos e um detector de 62 regras sob a licença Apache-2.0. Ele não é um produto da ArtCraft nem pertence à suíte dela. Esta página é um guia independente; as fontes oficiais são impeccable.style e github.com/pbakaus/impeccable.
Como instalar?
Na raiz do projeto, execute npx impeccable install e recarregue sua ferramenta. Depois rode /impeccable init, ou $impeccable init no Codex, para criar o PRODUCT.md. O npx pede Node 18.19 ou superior, e npx impeccable update atualiza uma instalação existente; o passo a passo completo está em impeccable.style/docs.
Qual a diferença entre critique e audit?
critique é uma revisão de UX pontuada, baseada em heurísticas de usabilidade, que indica o que corrigir primeiro. audit é um relatório técnico de acessibilidade, desempenho, temas, responsividade e integridade da implementação, com achados classificados de P0 a P3. Um julga a experiência, o outro inspeciona a engenharia, e costumam ser usados em sequência.
Precisa de chave de API?
O detector não: suas 62 regras são determinísticas e não chamam LLM nem leem chave alguma. O skill em si roda dentro do seu agente, então também não exige uma chave de modelo extra. A telemetria pode ser desativada com npx impeccable telemetry off ou DO_NOT_TRACK=1.
Com quais agentes funciona?
Claude Code, Cursor, Codex CLI, GitHub Copilot, Devin, Replit Agent, Gemini CLI, Grok Build, OpenCode, Google Antigravity, Kiro, Trae, Rovo Dev, Qoder, Mistral Vibe, Pi, Hermes Agent, DeepSeek Harness e Veto. A instalação e o suporte a hooks variam por ferramenta; a lista atualizada está em impeccable.style/docs.
Impeccable ou ArtCraft MCP?
Depende do que você quer alterar. O Impeccable trabalha no código da interface e devolve recomendações, mudanças e revisões. O ArtCraft MCP controla aplicativos locais como o PhotoCraft para gerar imagens e vídeos e automatizar seus fluxos. Os dois podem conviver, mas o ArtCraft MCP não é ferramenta de revisão de design e não substitui o Impeccable.
Aviso de independência
O Impeccable é um projeto de código aberto independente criado por Paul Bakaus. Não tem vínculo com a ArtCraft, não é um produto da ArtCraft e não faz parte da suíte nem dos componentes oficiais dela. Esta página é escrita por terceiros para leitores de língua portuguesa; para comandos, requisitos e novidades, a referência é o site oficial impeccable.style e o repositório github.com/pbakaus/impeccable. O ArtCraft MCP é outra integração oficial, voltada às Crafting Apps, e resolve um problema diferente.
Sources
Every fact on this page comes from the pages below, checked on 3 November 2026.