Impeccable: linguagem de design frontend e regras detectoras para agentes de código

Para quem

Olhe o Impeccable quando precisar dar orientação de design a um agente de código de IA. O resumo oficial: Design guidance for AI coding agents. 1 skill, 23 commands, live browser iteration, and 61 deterministic detector rules for AI-generated frontend design.

Serve para quem já tem um projeto frontend e topa primeiro escrever fatos duráveis do produto, depois deixar os comandos seguintes trabalharem a partir desses fatos. Não é um pacote de tema que só ajusta cores. O corpo lista o uso com Cursor, Claude Code, Gemini CLI, Codex CLI, Grok Build, Hermes Agent, Veto e every other supported tool; não leia essa lista como o único escopo suportado.

Página:

https://github.com/pbakaus/impeccable

Primeira tentativa em 3 minutos

O caminho oficial é só este trecho. Primeiro na raiz do projeto:

npx impeccable install

Depois no seu AI coding tool rode /impeccable init. Pré-requisito: o diretório atual é a raiz do projeto; você aceita que o init grave fatos do produto em PRODUCT.md. Não invente outro instalador nem um diretório de skill que não foi escrito.

Na primeira vez, uma conferência somente leitura; não se apresse a gravar arquivos. Pergunte ao agente: quais fatos o init registra em PRODUCT.md, e em que eles diferem da direção visual. Sucesso: o agente nomeia audience, purpose, operating context, constraints, voice e evidence, e diz que later commands não devem misturar isso com surface-level visual direction.

Depois de confirmar, rode /impeccable init. Sucesso: PRODUCT.md aparece no projeto e cobre esses campos.

Casos de uso

Caso 1: primeiro fixar fatos do produto. /impeccable init records durable product truth in PRODUCT.md. Entregue ao agente «para quem estamos construindo, o que o produto faz, quais restrições duras existem, qual é a voz» e deixe gravar nesse arquivo. Isso altera arquivos. Antes de executar, confirme que você pode criar ou sobrescrever PRODUCT.md. A página não dá o modelo completo do arquivo; não invente estrutura além dos campos nomeados.

Caso 2: conferir o design frontend com regras determinísticas. O corpo escreve 61 deterministic detector rules, mais LLM-only critique checks. The CLI and browser extension run the deterministic rules with no LLM and no API key. Serve depois de mudar uma passagem de interface: primeiro a conferência de regras sem modelo, em vez de pular para crítica generativa. Conferível: esta conferência declara não usar LLM e não pedir API key. Os nomes concretos dos 23 comandos não estão listados; não os invente.

Limites de uso

A instalação deve começar na raiz do projeto, depois /impeccable init. Não separe os dois passos em dois instaladores principais concorrentes.

PRODUCT.md registra fatos duráveis do produto, não uma ficha de estilo visual.

Quando o CLI e a extensão do navegador rodam regras determinísticas, não precisam de LLM nem de API key. LLM-only critique é outro tipo de conferência; não misture num só passo.

Os clientes são listados como na origem, incluindo every other supported tool; não escreva que só um deles é suportado. Não preencha nomes de comando, detalhes de regras nem passos de navegador ao vivo não escritos.