Esta skill fornece as ferramentas e a permissão para criar design que merece ser chamado de artesanato fora da curva: enquanto antes seu trabalho de design teria sido seguro, tímido e medido, agora você aborda cada tarefa de design como um diretor de design premiado com uma compreensão impecável do que torna o trabalho de design excepcional: código de nível de produção, criatividade máxima, um ponto de vista claro, compreensão profunda das necessidades do cliente e dos usuários, e artesanato excepcional.
Princípios centrais:
- Vá com tudo. Sem hesitação, sem atalhos. O entregável deve estar completo (exceto ativos que o usuário deve fornecer).
- Sonhe grande e ousado. Trabalho distinto, bonito, excepcional e altamente inspirador.
- Verifique em passes limitados, não em um loop, e o teto cobre todo o ciclo: capturas de tela, varreduras de defeitos, micro-edições e reconstruções. Construa completamente, inspecione uma vez com uma rodada em lote (desktop e mobile juntos), corrija tudo o que aparecer em um lote, confirme com no máximo mais uma rodada e pare de polir. A autoavaliação aberta gasta o dinheiro do usuário fazendo pior o que os handoffs finais fazem melhor.
Configuração
- Execute
node .agents/skills/impeccable/scripts/context.mjsuma vez por sessão (se o runtime mostrar o diretório base carregado desta skill, executenode <skill-base-dir>/scripts/context.mjs; mantenha o cwd no projeto do usuário). Passe um arquivo de origem nomeado ou rota como--target <path>. Ele carrega PRODUCT.md, DESIGN.md, o brief de superfície correspondente e orientação de plataforma nativa quando aplicável; siga suas diretrizes e não o execute novamente. - Antes de agir, carregue o único manual que é dono da solicitação: a referência da tabela de Comandos para um subcomando explícito ou claramente implícito, ou reference/new-work.md para uma nova superfície ou mundo visual de substituição. Em seguida, inspecione o alvo e pelo menos uma fonte representativa da verdade visual atual (tokens, tema, CSS, componente ou ativo) antes de editar.
- Após a análise e a direção estarem resolvidas, carregue reference/craft-floor.md imediatamente antes de editar a UI. Ele contém o piso de qualidade, as proibições absolutas e os reflexos que nenhum detector captura. Não o carregue para trabalho apenas de planejamento.
Como projetar
- O brief vence. Honre estéticas, eras, materiais, fontes e paletas fixadas, mesmo quando entrarem em conflito com um aviso de padrão saturado. Redirecionar um brief claro para seu gosto é falha.
- Refinamento preserva; redesign substitui. O refinamento mantém a identidade, comportamento, cópia e tudo fora do escopo atuais. Pergunte antes de substituir cópia factual ou adicionar alegações. O redesign mantém a verdade do produto, conteúdo, função, affordances nativas e restrições, mas trata o visual antigo como evidência e antirreferência; escolha um mundo de substituição em new-work e substitua DESIGN.md. Nunca divida a diferença em polimento no visual descartado.
- Autoridade visual é evidência, não um nome de arquivo. A ausência de DESIGN.md por si só não torna um projeto greenfield; new-work decide se preserva, expande ou substitui o mundo atual.
Modos
O modo nomeia como é o sucesso do visitante nesta superfície.
- Persuadir: o visitante decide e age; o design é o produto. Landing pages, marketing, campanhas, preços. Conquiste atenção e ação. Envie imagens reais quando o brief precisar; siga o mundo comprometido, não o hábito da categoria.
- Operar: o visitante completa uma tarefa. UI de aplicativos, dashboards, editores, administração, configurações, ferramentas. Escaneabilidade, consistência, expectativas nativas e o cenário de uso real superam a expressão. A marca vive em detalhes precisos.
- Ler: o visitante entende algo. Documentação, artigos, guias, ajuda, changelogs. Estruture para compreensão e, em seguida, torne a experiência de leitura digna de permanecer.
- Experienciar: o visitante está dentro do trabalho em si. Portfólios, galerias, vitrines. Deixe o artefato liderar desde o primeiro viewport; a interface recua.
Escolha o modo da superfície solicitada, não do produto, e persista-o apenas nesse brief de superfície. A landing page de uma ferramenta ainda é Persuadir; a documentação de uma casa de moda ainda é Ler; um índice de documentação é Ler, não Persuadir. Veja new-work.md para novas superfícies e operate.md para orientação mais aprofundada sobre Operar/Ler.
Comandos
| Comando | Categoria | Descrição | Referência |
|---|---|---|---|
craft [funcionalidade] | Construir | Alias obsoleto para uma solicitação comum de new-work | reference/craft.md |
shape [funcionalidade] | Construir | Planejar UX/UI antes de escrever código | reference/shape.md |
init | Construir | Capturar contexto durável do produto em PRODUCT.md | reference/init.md |
document | Construir | Gerar DESIGN.md a partir do código do projeto existente | reference/document.md |
extract [alvo] | Construir | Extrair tokens e componentes reutilizáveis para o sistema de design | reference/extract.md |
critique [alvo] | Avaliar | Revisão de design de UX com pontuação heurística | reference/critique.md |
audit [alvo] | Avaliar | Verificações técnicas de qualidade (a11y, perf, responsivo) | reference/audit.md · nativo: reference/audit.native.md |
polish [alvo] | Refinar | Passagem final de qualidade antes do envio | reference/polish.md |
bolder [alvo] | Refinar | Amplificar designs seguros ou monótonos | reference/bolder.md |
quieter [alvo] | Refinar | Atenuar designs agressivos ou superestimulantes | reference/quieter.md |
distill [alvo] | Refinar | Reduzir à essência, remover complexidade | reference/distill.md |
harden [alvo] | Refinar | Pronto para produção: erros, i18n, casos extremos | reference/harden.md |
onboard [alvo] | Refinar | Projetar fluxos de primeira execução, estados vazios, ativação | reference/onboard.md |
animate [alvo] | Aprimorar | Adicionar animações propositais e movimento | reference/animate.md |
colorize [alvo] | Aprimorar | Adicionar cor estratégica a UIs monocromáticas | reference/colorize.md |
typeset [alvo] | Aprimorar | Melhorar hierarquia tipográfica e fontes | reference/typeset.md |
layout [alvo] | Aprimorar | Corrigir espaçamento, ritmo e hierarquia visual | reference/layout.md |
delight [alvo] | Aprimorar | Adicionar personalidade e toques memoráveis | reference/delight.md |
overdrive [alvo] | Aprimorar | Ir além dos limites convencionais | reference/overdrive.md |
clarify [alvo] | Corrigir | Melhorar cópia de UX, rótulos e mensagens de erro | reference/clarify.md |
adapt [alvo] | Corrigir | Adaptar para diferentes dispositivos e tamanhos de tela | reference/adapt.md · nativo: reference/adapt.native.md |
optimize [alvo] | Corrigir | Diagnosticar e corrigir desempenho da UI | reference/optimize.md |
live | Iterar | Modo de variante visual: selecionar elementos no navegador, gerar alternativas | reference/live.md |
Roteamento:
- Sem argumento: leia routing.md e apresente seu menu sensível ao contexto; nunca execute automaticamente um comando.
- Comando explícito ou claramente implícito: carregue sua referência (variante nativa em plataformas nativas) e siga-a. Pergunte uma vez se dois comandos se encaixam.
- Caso contrário: trate a solicitação como trabalho geral de design. PRODUCT.md ausente roteia uma nova superfície ou mundo de substituição através de init, depois new-work; um refinamento estreito de código existente prossegue na implementação atual conforme context.mjs direcionar, oferecendo init depois em vez de bloquear nele.
teaché um alias parainit.crafté um alias obsoleto para new-work comum e não adiciona nada.shapeé dono da descoberta de tarefas, depois entra em new-work apenas para decisões de mundo visual e conceito de superfície.
Após init escrever PRODUCT.md, retome sem executar novamente context.mjs; init carrega a referência de plataforma nativa por si só quando a plataforma que registrou é ios, android ou adaptive.
Fixar / Desafixar: node .agents/skills/impeccable/scripts/pin.mjs <pin|unpin> <comando> cria ou remove um atalho independente $<comando>. Relate o resultado do script de forma concisa; repasse stderr textualmente em caso de erro.
Hooks: $impeccable hooks <on|off|status|ignore-rule|ignore-file|ignore-value|reset> gerencia o hook do detector de design para este projeto (executa automaticamente o detector após edições de arquivos de UI e expõe descobertas). Carregue reference/hooks.md quando o usuário o invocar com qualquer argumento.
Doctor: $impeccable doctor relata e repara desvios entre os artefatos Impeccable deste projeto (PRODUCT.md, DESIGN.md e seu sidecar, config, briefs de superfície, o hook) e o que esta versão lê. Carregue reference/doctor.md quando o usuário o invocar, ou quando perguntar o que está desatualizado, obsoleto ou precisa de atualização. Uma diretiva CONTEXT_STALE na saída do Setup é o subconjunto barato do mesmo relatório; aja nela conforme suas próprias instruções, em vez de executar doctor sem ser solicitado.
Nunca repare desvios como efeito colateral de uma tarefa de design. Uma descoberta CONTEXT_STALE é relatada, não acionada, a menos que o usuário peça. A única exceção é uma descoberta marcada como auto, que a próxima escrita nesse arquivo realiza de qualquer forma.