Skill de Laboratório de Design
Esta skill implementa um fluxo de trabalho completo de exploração de design: entrevista, gerar variações, coletar feedback, refinar, pré-visualizar e finalizar.
CRÍTICO: Comportamento de Limpeza
Todos os arquivos temporários DEVEM ser deletados quando o processo terminar, seja por:
- Usuário confirmar o design final → limpeza, depois gerar plano
- Usuário abortar/cancelar → limpeza imediata, nenhum plano gerado
Nunca deixe .claude-design/ ou rotas __design_lab para trás. Se o usuário disser "cancelar", "abortar", "parar" ou "deixa pra lá" em qualquer ponto, confirme e então delete todos os artefatos temporários.
Fase 0: Detecção de Pré-voo
Antes de iniciar a entrevista, detecte automaticamente:
Gerenciador de Pacotes
Verifique arquivos de lock na raiz do projeto:
pnpm-lock.yaml→ usepnpmyarn.lock→ useyarnpackage-lock.json→ usenpmbun.lockb→ usebun
Detecção de Framework
Verifique arquivos de configuração:
next.config.jsounext.config.mjsounext.config.ts→ Next.js- Verifique diretório
app/→ App Router - Verifique diretório
pages/→ Pages Router
- Verifique diretório
vite.config.jsouvite.config.ts→ Viteremix.config.js→ Remixnuxt.config.jsounuxt.config.ts→ Nuxtastro.config.mjs→ Astro
Detecção de Sistema de Estilização
Verifique dependências do package.json e arquivos de configuração:
tailwind.config.jsoutailwind.config.ts→ Tailwind CSS@mui/materialem dependências → Material UI@chakra-ui/reactem dependências → Chakra UIantdem dependências → Ant Designstyled-componentsem dependências → styled-components@emotion/reactem dependências → Emotion- Arquivos
.cssou.module.css→ CSS Modules
Verificação de Memória de Design
Procure por arquivo de Memória de Design existente:
docs/design-memory.mdDESIGN_MEMORY.md.claude-design/design-memory.md
Se encontrado, leia e use para preencher valores padrão e pular perguntas redundantes.
Inferência de Estilo Visual (CRÍTICO)
NÃO use estilos predefinidos/genéricos. Extraia a linguagem visual do projeto:
Se Tailwind detectado, leia tailwind.config.js ou tailwind.config.ts:
// Extraia e use:
theme.colors // Paleta de cores
theme.spacing // Escala de espaçamento
theme.borderRadius // Valores de borda
theme.fontFamily // Tipografia
theme.boxShadow // Sistema de elevação
Se Variáveis CSS existirem, leia globals.css, variables.css ou definições :root:
:root {
--color-* /* Tokens de cor */
--spacing-* /* Tokens de espaçamento */
--font-* /* Tokens de tipografia */
--radius-* /* Tokens de raio de borda */
}
Se biblioteca de UI detectada (MUI, Chakra, Ant), leia a configuração do tema:
- MUI:
theme.tsou chamadacreateTheme() - Chakra:
theme/index.tsou chamadaextendTheme() - Ant: prop de tema do
ConfigProvider
Sempre escaneie componentes existentes para entender padrões:
- Encontre 2-3 botões existentes → anote seus padrões de estilo
- Encontre 2-3 cards existentes → anote padding, bordas, sombras
- Encontre formulários existentes → anote estilos de input, posição de labels
- Encontre tipografia existente → anote tamanhos de heading, texto corporal
Armazene estilos inferidos no Brief de Design para uso consistente em todas as variantes.
Fase 1: Entrevista
Use a ferramenta AskUserQuestion para todas as etapas da entrevista. Adapte perguntas com base na Memória de Design, se existir.
Passo 1.1: Escopo & Alvo
Faça estas perguntas (pode combinar em um único AskUserQuestion com múltiplas perguntas):
Pergunta 1: Escopo
- Cabeçalho: "Escopo"
- Pergunta: "Estamos projetando um único componente ou uma página completa?"
- Opções:
- "Componente" - Um elemento de UI reutilizável (botão, card, formulário, modal, etc.)
- "Página" - Um layout de página ou tela completo
Pergunta 2: Novo ou Redesign
- Cabeçalho: "Tipo"
- Pergunta: "Isso é um novo design ou um redesign de algo existente?"
- Opções:
- "Novo" - Criando algo do zero
- "Redesign" - Melhorando um componente/página existente
Se "Redesign" selecionado, pergunte: Pergunta 3: Caminho Existente
- Cabeçalho: "Localização"
- Pergunta: "Qual é o caminho do arquivo ou rota da UI existente?"
- Opções: (deixe o usuário fornecer via "Outro")
Se o alvo não estiver claro, proponha um nome baseado nos padrões do repositório e confirme.
Passo 1.2: Pontos Problemáticos & Inspiração
Pergunta 1: Pontos Problemáticos
- Cabeçalho: "Problemas"
- Pergunta: "Quais são os principais pontos problemáticos com o design atual (ou o que este novo design deve evitar)?"
- Opções:
- "Muito poluído/denso" - Sobrecarga de informação, difícil de escanear
- "Hierarquia pouco clara" - Ações primárias não são óbvias
- "Experiência mobile ruim" - Não funciona bem em telas pequenas
- "Aparência desatualizada" - Parece antigo ou inconsistente com a marca
- multiSelect: true
Pergunta 2: Inspiração Visual
- Cabeçalho: "Estilo visual"
- Pergunta: "Quais produtos ou marcas devo referenciar para inspiração visual?"
- Opções:
- "Stripe" - Limpo, minimalista, confiável
- "Linear" - Denso, focado em teclado, voltado para desenvolvedores
- "Notion" - Flexível, focado em conteúdo, divertido
- "Apple" - Premium, espaçoso, refinado
- multiSelect: true
Pergunta 3: Inspiração Funcional
- Cabeçalho: "Interações"
- Pergunta: "Quais padrões de interação devo emular?"
- Opções:
- "Edição inline" - Editar no local sem modais
- "Divulgação progressiva" - Mostrar mais conforme necessário
- "Atualizações otimistas" - Feedback instantâneo, sincronizar em segundo plano
- "Atalhos de teclado" - Eficiência para usuários avançados
Passo 1.3: Direção de Marca & Estilo
Pergunta 1: Adjetivos da Marca
- Cabeçalho: "Tom da marca"
- Pergunta: "Quais 3-5 adjetivos descrevem a sensação desejada da marca?"
- Opções:
- "Minimalista" - Limpo, simples, sem poluição
- "Premium" - Alto padrão, polido, refinado
- "Divertido" - Alegre, amigável, acessível
- "Utilitário" - Funcional, eficiente, direto ao ponto
- multiSelect: true
Pergunta 2: Densidade
- Cabeçalho: "Densidade"
- Pergunta: "Qual densidade de informação você prefere?"
- Opções:
- "Compacto" - Mais informação visível, espaçamento mais apertado
- "Confortável" - Espaçamento equilibrado, fácil escaneamento
- "Espaçoso" - Espaço em branco generoso, atenção focada
Pergunta 3: Modo Escuro
- Cabeçalho: "Modo escuro"
- Pergunta: "O modo escuro é necessário?"
- Opções:
- "Sim" - Deve suportar modo escuro
- "Não" - Apenas modo claro
- "Bom ter" - Suporte se for fácil, não obrigatório
Passo 1.4: Persona & Jobs-to-be-Done
Pergunta 1: Usuário Principal
- Cabeçalho: "Usuário"
- Pergunta: "Quem é o usuário final principal?"
- Opções:
- "Desenvolvedor" - Técnico, orientado a teclado
- "Designer" - Visual, orientado a detalhes
- "Usuário de negócios" - Focado em eficiência, menos técnico
- "Consumidor final" - Público geral, habilidade técnica variada
Pergunta 2: Contexto
- Cabeçalho: "Contexto"
- Pergunta: "Qual é o contexto de uso principal?"
- Opções:
- "Desktop primeiro" - Usado principalmente em telas grandes
- "Mobile primeiro" - Usado principalmente em celulares
- "Ambos igualmente" - Deve funcionar bem em todos os dispositivos
Pergunta 3: Tarefas Principais
- Cabeçalho: "Tarefas principais"
- Pergunta: "Quais são as 3 principais tarefas que os usuários devem concluir?"
- (Deixe o usuário fornecer via "Outro" - isso é aberto)
Passo 1.5: Restrições
Pergunta 1: Elementos a Manter
- Cabeçalho: "Manter"
- Pergunta: "Existem elementos que devem ser preservados?"
- Opções:
- "Cópias/rótulos existentes" - Manter texto atual
- "Campos/inputs atuais" - Manter estrutura do formulário
- "Estrutura de navegação" - Manter navegação atual
- "Nenhum" - Livre para mudar tudo
Pergunta 2: Restrições Técnicas
- Cabeçalho: "Restrições"
- Pergunta: "Alguma restrição técnica?"
- Opções:
- "Sem novas dependências" - Usar apenas bibliotecas existentes
- "Usar componentes existentes" - Construir sobre o sistema de design atual
- "Deve ser acessível (WCAG)" - Requisitos estritos de acessibilidade
- "Nenhuma" - Sem restrições especiais
- multiSelect: true
Fase 2: Gerar Brief de Design
Após a entrevista, crie um Brief de Design estruturado como JSON e salve em .claude-design/design-brief.json:
{
"scope": "componente|pagina",
"isRedesign": true|false,
"targetPath": "src/components/Exemplo.tsx",
"targetName": "Exemplo",
"painPoints": ["Muito denso", "Ação primária pouco clara"],
"inspiration": {
"visual": ["Stripe", "Linear"],
"functional": ["Validação inline"]
},
"brand": {
"adjectives": ["minimalista", "confiável"],
"density": "confortável",
"darkMode": true
},
"persona": {
"primary": "Desenvolvedor",
"context": "desktop-first",
"keyTasks": ["Finalizar checkout", "Revisar pedido", "Aplicar desconto"]
},
"constraints": {
"mustKeep": ["campos existentes"],
"technical": ["sem novas dependências", "acessível WCAG"]
},
"framework": "nextjs-app",
"packageManager": "pnpm",
"stylingSystem": "tailwind"
}
Exiba um resumo ao usuário antes de prosseguir.
Fase 3: Gerar Laboratório de Design
Estrutura de Diretórios
Crie todos os arquivos dentro de .claude-design/:
.claude-design/
├── lab/
│ ├── page.tsx # Página principal do laboratório (específica do framework)
│ ├── variants/
│ │ ├── VariantA.tsx
│ │ ├── VariantB.tsx
│ │ ├── VariantC.tsx
│ │ ├── VariantD.tsx
│ │ └── VariantE.tsx
│ ├── components/
│ │ └── LabShell.tsx # Wrapper de layout do laboratório
│ ├── feedback/ # Sistema de feedback interativo
│ │ ├── types.ts # Interfaces TypeScript
│ │ ├── selector-utils.ts # Identificação de elementos
│ │ ├── format-utils.ts # Formatação de feedback
│ │ ├── FeedbackOverlay.tsx # Componente principal de overlay
│ │ └── index.ts # Exportações do módulo
│ └── data/
│ └── fixtures.ts # Dados mock compartilhados
├── design-brief.json
└── run-log.md
Configuração do Sistema de Feedback (CRÍTICO - NUNCA PULAR)
O FeedbackOverlay é a característica PRINCIPAL do Laboratório de Design. Sem ele, os usuários não podem fornecer feedback interativo. NUNCA gere um Laboratório de Design sem o FeedbackOverlay.
Estratégia de Confiabilidade: Para evitar problemas de caminho de importação em diferentes configurações de projeto, crie o FeedbackOverlay diretamente no diretório da rota (por exemplo, app/design-lab/FeedbackOverlay.tsx), NÃO em .claude-design/. Isso garante que uma importação relativa simples (./FeedbackOverlay) sempre funcione.
Arquivos Necessários no Diretório da Rota:
app/design-lab/ # ou app/__design_lab/ se underscores funcionarem
├── page.tsx # Página principal do laboratório com variantes
└── FeedbackOverlay.tsx # Componente de overlay autocontido (copie dos templates)
Fonte do Template: design-and-refine/templates/feedback/FeedbackOverlay.tsx
Por que esta abordagem:
- Caminhos de
.claude-design/podem falhar devido a configurações do bundler - Importações relativas do mesmo diretório sempre funcionam
- O diretório da rota é deletado durante a limpeza de qualquer maneira
Integração de Rota
Next.js App Router:
Crie app/__design_lab/page.tsx que importa de .claude-design/lab/
Next.js Pages Router:
Crie pages/__design_lab.tsx que importa de .claude-design/lab/
Vite React:
- Se React Router existir: adicione rota para
/__design_lab - Se não houver roteador: crie uma renderização condicional em
App.tsxbaseada no parâmetro de consulta?design_lab=true
Outros frameworks: Crie a rota temporária mais apropriada para o framework detectado.
Diretrizes de Geração de Variantes
IMPORTANTE: Leia DESIGN_PRINCIPLES.md para melhores práticas de UX, interação e movimento. Mas NÃO use estilos visuais predefinidos—inferi-los do projeto.
Aplique princípios universais (de DESIGN_PRINCIPLES.md):
- UX: Heurísticas de Nielsen, redução de carga cognitiva, divulgação progressiva
- Comportamento do componente: Estados de botão, anatomia de formulário, estrutura de card
- Interação: Padrões de feedback, tratamento de estado, atualizações otimistas
- Movimento: Timing (150-300ms), easing (entradas ease-out, saídas ease-in)
- Acessibilidade: Estados de foco, padrões ARIA, alvos de toque (mín. 44px)
Inferir estilos visuais do projeto:
- Cores → do config do Tailwind, variáveis CSS ou componentes existentes
- Tipografia → de headings existentes, texto corporal no código-fonte
- Espaçamento → da escala de espaçamento do projeto ou padrões existentes
- Raio de borda → de cards, botões, inputs existentes
- Sombras → de componentes elevados existentes
Cada variante DEVE explorar um eixo de design diferente. Não crie variações menores—faça-as significativamente distintas. Use a linguagem visual existente do projeto para todas as variantes.
Variante A: Foco na Hierarquia da Informação
- Reestruturar hierarquia de conteúdo (o que é mais importante?)
- Aplicar proximidade Gestalt—agrupar itens relacionados mais próximos
- Uma ação primária por visualização
- Usar a escala de tipografia existente para criar níveis claros
Variante B: Exploração de Modelo de Layout
- Tentar uma abordagem de layout diferente (card vs lista vs tabela vs painel dividido)
- Aplicar anatomia de card ou padrões de comportamento de tabela do DESIGN_PRINCIPLES
- Considerar comportamento responsivo em cada ponto de quebra
- Usar o sistema de grid/layout existente do projeto
Variante C: Variação de Densidade
- Se o brief disser "confortável", tente uma versão mais compacta
- Se o brief disser "compacto", tente uma versão mais espaçosa
- Usar os tokens de espaçamento existentes do projeto—apenas aplicá-los de forma diferente
- Mostrar os trade-offs: mais dados visíveis vs escaneamento mais fácil
Variante D: Modelo de Interação
- Padrão de interação diferente (modal vs inline vs painel vs gaveta)
- Aplicar padrões de feedback: imediato → progresso → conclusão
- Implementar todos os estados necessários (carregamento, erro, vazio, desabilitado)
- Considerar atualizações otimistas para ações não destrutivas
Variante E: Direção Expressiva
- Avançar na direção da marca que o usuário descreveu na entrevista
- Explorar diferentes usos dos tokens de design existentes do projeto
- Mais ou menos uso de sombras, bordas, cores de fundo
- Aplicar movimento onde adiciona significado (hover, foco, transições)
Requisitos da Página do Laboratório
A página do Laboratório de Design deve incluir:
-
Cabeçalho com:
- Resumo do Brief de Design (alvo, escopo, requisitos principais)
- Instruções para revisão
-
Grade de Variantes com:
- Rótulos claros (A, B, C, D, E)
- Breve justificativa para cada variante ("Por que isso existe")
- A variante realmente renderizada