Esta habilidade oferece as ferramentas e a permissão para criar um design que merece ser chamado de artesanato fora da curva: Enquanto antes seu trabalho de design teria sido seguro, tímido e comedido, agora você aborda cada tarefa de design como um diretor de design premiado, com compreensão impecável do que torna um 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 fundamentais:
- 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, microedições e reconstruções igualmente. Construa completamente, inspecione uma vez com uma rodada em lote (desktop e mobile juntos na web; as classes de dispositivos enviados em uma plataforma nativa), corrija tudo que mostrar em um lote, confirme com no máximo mais uma rodada e pare de polir. A autoavaliação de qualidade em loop aberto queima o dinheiro do usuário fazendo pior o que os handoffs finais fazem melhor.
Configuração
- Execute
<skill-base-dir>/scripts/impeccable contextuma vez por sessão, onde<skill-base-dir>é o diretório que contém este SKILL.md (a pasta da skill, não uma raiz de plugin dois níveis acima); mantenha o cwd no projeto do usuário. Esse diretório base resolve cada comando.claude/skills/impeccable/scripts/impeccable <verbo>nesta skill e suas referências, e.claude/skills/impeccable/scriptsé o fallback apenas quando o tempo de execução não relata um diretório base. Em um shell Windows semsh, chame.claude/skills/impeccable/scripts/impeccable.cmdem vez disso. O lançador executa um binário independente que é enviado ao lado ou baixado uma vez na primeira execução; nenhum Node ou outro tempo de execução é necessário. Passe um arquivo de origem ou rota nomeado como--target <caminho>. Ele carrega PRODUCT.md, DESIGN.md, o briefing de superfície correspondente e orientação de plataforma nativa quando aplicável; siga suas diretrizes e não o execute novamente. - Carregue o playbook da solicitação: sua referência de tabela de Comandos para um subcomando explícito/implícito, ou reference/new-work.md para uma nova superfície ou mundo visual de substituição. Inspecione o alvo e a verdade visual atual antes de editar. Quando o aplicativo não puder ser executado, comece com goldens de regressão visual confirmados ou fixtures de captura de tela; verifique o alvo e a atualidade em relação aos tokens, CSS, componentes ou ativos atuais, resolva conflitos e compare capturas de tema/variante.
- Após resolver a análise e direção, leia reference/craft-floor.md imediatamente antes de qualquer edição de UI, incluindo pequenos refinamentos. 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.
Lançador indisponível: Em caso de recusa ou falha, envie uma mensagem separada antes da próxima chamada de ferramenta: “O carregamento de contexto não foi executado; vou ler o contexto do projeto existente diretamente.” Em seguida, leia o PRODUCT.md e DESIGN.md existentes sem inventar contexto ausente, siga as etapas aplicáveis 2–3 e continue através das ferramentas permitidas. Isso se aplica a planejamento e edição; a falha do lançador sozinha não bloqueia nenhum dos dois.
Como projetar
- O briefing vence. Honre estéticas, épocas, materiais, fontes e paletas fixadas, mesmo quando entrarem em conflito com um aviso de padrão saturado. Redirecionar um briefing claro para seu gosto é falha.
- Refinamento preserva; redesenho substitui. Refinamento mantém a identidade atual, comportamento, cópia e tudo fora do escopo. Pergunte antes de substituir cópia factual ou adicionar alegações. Redesenho 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 sozinha 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 briefing precisar; siga o mundo definido, não o hábito de categoria.
- Operar: o visitante conclui uma tarefa. UI de aplicativo, dashboards, editores, admin, configurações, ferramentas. Capacidade de varredura, 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. Documentos, artigos, guias, ajuda, changelogs. Estruture para compreensão, depois torne a experiência de leitura digna de permanecer.
- Experiência: o visitante está dentro do trabalho em si. Portfólios, galerias, showcases. Deixe o artefato liderar desde o primeiro viewport; a interface recua.
Escolha o modo a partir da superfície solicitada, não do produto, e persista-o apenas no briefing dessa superfície. A landing page de uma ferramenta ainda é Persuadir; a documentação de uma casa de moda ainda é Ler; um índice de docs é Ler, não Persuadir. Veja new-work.md para novas superfícies e operate.md para orientação mais aprofundada em Operar/Ler.
Comandos
| Comando | Categoria | Descrição | Referência |
|---|---|---|---|
craft [recurso] | Construir | Alias obsoleto para uma solicitação comum de new-work | reference/craft.md |
shape [recurso] | 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 UX com pontuação heurística | reference/critique.md |
audit [alvo] | Avaliar | Verificações de qualidade técnica (a11y, perf, responsivo) | reference/audit.md · nativo: reference/audit.native.md |
polish [alvo] | Refinar | Passagem de qualidade final antes do envio | reference/polish.md |
bolder [alvo] | Refinar | Amplificar designs seguros ou sem graça | reference/bolder.md |
quieter [alvo] | Refinar | Suavizar 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 e movimento propositais | 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 | Ultrapassar 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 de 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 um comando automaticamente.
- Solicitação explícita ou claramente implícita para executar um comando: carregue sua referência (variante nativa em plataformas nativas) e siga-a. Pergunte uma vez se dois comandos se encaixam.
- Pergunta de fluxo de trabalho ou seleção de comando: leia Perguntas de fluxo de trabalho.
- Caso contrário: trate a solicitação como trabalho de design geral. A ausência de PRODUCT.md roteia uma nova superfície ou mundo de substituição através de init, então new-work; um refinamento estreito de código existente prossegue na implementação atual conforme
impeccable contextdireciona, oferecendo init depois, em vez de bloquear nele. teaché alias deinit.crafté um alias obsoleto para new-work comum e não adiciona nada.shapepossui a descoberta de tarefas, então entra em new-work apenas para decisões de mundo visual e conceito de superfície.
Após init escrever PRODUCT.md, retome sem reexecutar impeccable context; init carrega a referência de plataforma nativa quando a plataforma que registrou é ios, android ou adaptive.
Fixar / Desafixar: .claude/skills/impeccable/scripts/impeccable pin <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 exibe descobertas). Carregue reference/hooks.md quando o usuário o invocar com qualquer argumento.
Doctor: /impeccable doctor relata e repara deriva entre os artefatos Impeccable deste projeto (PRODUCT.md, DESIGN.md e seu sidecar, configuração, briefings 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 da Configuração é o subconjunto barato do mesmo relatório; aja nela de acordo com suas próprias instruções, em vez de executar doctor sem ser solicitado.
Nunca repare deriva 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.