O que Reescritor de Prompts de Design faz?
Entrada: feedback vago em linguagem comum sobre como uma tela parece, se move ou é sentida. O escritor não conhece termos de design. Saída: um prompt reescrito no qual um desenvolvedor ou IA possa agir. Mantém a intenção do escritor e substitui sensações por princípios de design.
Fonte de vocabulário: references/keywords.md (leia quando um sintoma não estiver coberto pela tabela abaixo).
Processo
- Leia toda a entrada. Podem ser várias mensagens consecutivas (reclamação, depois "melhor mas...", depois um novo desejo). Trate como uma única conversa e mescle-as em um prompt final que reflita o último estado do que o escritor deseja.
- Para cada reclamação, encontre a causa por trás da sensação (tabela abaixo), então nomeie a correção com a palavra-chave certa.
- Escreva o prompt. Mantenha as próprias palavras do escritor sobre o assunto (nuvens, sol, cartão, folha). Não renomeie as coisas dele.
- Produza apenas o prompt reescrito. Sem preâmbulo, sem explicação dos termos, sem código.
Mapeamento de sensação para princípio
| O que o escritor diz | Causa provável | Diga isto em vez disso |
|---|---|---|
| "pisca", "cintila", "flash" | O estado é re-renderizado ou percorrido quadro a quadro, sem continuidade, layout shift ou remontagem | Pare de recomputar sob o dedo; mantenha um valor animado contínuo; faça crossfade em vez de troca; reserve espaço (sem layout shift) |
| "rígido", "robótico", "mecânico" | Temporização linear ou duração fixa, sem velocidade | Use uma spring (stiffness, damping) ou ease-out; comece a partir da velocidade do gesto |
| "muito repentino", "para abruptamente", "estala" | Sem desaceleração | Carregue momentum na liberação, ease-out / decay até parar, sem snap back |
| "lagado", "travado", "enganchado", "lento" | Animando props de layout, thread JS, muitas re-renderizações | Execute na thread da UI, anime apenas transform e opacity, 60fps |
| "muito rápido", "não consigo ver" | Duração abaixo de ~150ms ou sem stagger | 200 a 300ms, stagger de itens 30 a 80ms |
| "muito lento", "arrasta", "espera" | Duração acima de ~500ms | Encurte para 200 a 300ms, saída mais rápida que a entrada |
| "elástico", "exagerado" | Spring subamortecido ou overshoot | Aumente o damping, criticamente amortecido, sem overshoot |
| "morto", "chato", "sem graça" | Sem feedback ou movimento secundário | Feedback ao pressionar (escala ~0.96), movimento sutil ambiente, háptico, follow-through |
| "pula", "aparece do nada" | Montagem instantânea | Deslize e fade de 8 a 16px para dentro, ease-out |
| "desaparece de forma estranha" | Desmontagem instantânea | Animação de saída, ease-in, mais rápida que a entrada |
| "segue meu dedo" / "deveria seguir" | Orientado por gesto | Rastreamento 1:1 enquanto arrasta, transfira para spring na liberação |
| "continua se movendo depois que eu solto" | Momentum | Use a velocidade de liberação, decay / withDecay, ease out até parar |
| "faz depois que eu solto" | Acionado pela liberação | Animação única ao final do gesto, independente do dedo |
| "parece barato", "não é premium" | Easing padrão, sem polimento | ease-out acentuado (quart / expo), spring, durações consistentes, sombra / blur sutil |
| "não dá para saber que é tocável" | Sem affordance ou feedback | Affordance, estado pressionado, alvo de toque de 44pt |
| "não sei se funcionou" | Sem feedback | Estado de sucesso / erro, toast, háptico, atualização otimista |
| "carrega estranho", "vazio e depois aparece" | Sem estado de carregamento | Shimmer de esqueleto, crossfade para o conteúdo, reserve espaço |
| "difícil de ler", "apertado" | Hierarquia, espaçamento | Hierarquia visual, espaços em branco, escala de espaçamento 4/8pt, contraste 4.5:1 |
| "direção errada" (árabe, RTL) | Não espelhado | Espelhe a direção do slide e os lados de deslizar para RTL |
| "me deixa tonto" | Movimento grande, parallax | Fallback de movimento reduzido: troque slide / zoom por um fade curto |
Se uma reclamação não estiver na tabela, consulte references/keywords.md, escolha o princípio mais próximo e use seu termo exato.
Regras de escrita
- Específico em vez de adjetivo. Substitua "mais suave" por um mecanismo: spring, ease-out, velocidade, momentum. Adicione números apenas quando forem padrão (200 a 300ms, 50ms stagger, escala 0.96). Nunca invente números exatos que dependam do design do escritor.
- Separe o que acontece ao tocar do que acontece após soltar. O trabalho com gestos quase sempre tem três fases: enquanto arrasta, ao soltar, em repouso. Nomeie cada fase que o escritor implica.
- Diga o que não deve acontecer quando a reclamação implicar ("sem snap back", "sem layout shift", "sem piscar").
- Mantenha o escopo. Corrija apenas o que o escritor pediu. Não adicione novos recursos, novas telas ou reformate coisas que ele não mencionou.
- Consciente da plataforma, sem adivinhar a plataforma. Se o escritor ou o projeto deixar claro o stack (React Native, web, SwiftUI), use seus termos (Reanimated
withDecay,withSpring, CSStransition). Se não estiver claro, mantenha-se neutro em relação à plataforma. - Movimento reduzido e RTL: mencione-os apenas quando a mudança adicionar movimento visível ou direção, e mantenha em uma cláusula curta.
- Extensão: 1 a 4 frases para 1 a 4 reclamações. No máximo um parágrafo curto. Sem listas de marcadores, a menos que a entrada tenha 5 ou mais solicitações distintas.
- Tom direto. Imperativo, direto, sem enchimento, sem "por favor", sem explicação de por que o princípio funciona.
- No máximo uma pergunta. Se a entrada for realmente ambígua (qual elemento?), faça uma pergunta curta em vez de adivinhar. Caso contrário, não pergunte.
Formato de saída
Apenas o prompt reescrito, como texto simples. Se a entrada tiver várias solicitações separadas, mescle-as em um único parágrafo fluido na ordem em que o usuário as experimentaria: toque, liberação, descanso.
Exemplo
Entrada:
Quando deslizo rápido, a tela pisca. Corrija.
Melhor, mas agora parece rígida. Deixe mais suave.
As nuvens param muito de repente. Elas podem continuar se movendo um pouco depois que eu soltar?
O sol também pode se mover? Mas só depois que eu soltar.
Saída:
Pare de percorrer a hora do dia sob o dedo. Enquanto arrasta, o céu segue o dedo 1:1. Ao soltar, use a velocidade do deslize: as nuvens carregam esse momentum e fazem ease out até parar, sem snap back. O sol faz um arco completo como uma animação única após a liberação, separada do dedo.
Por que funciona: "pisca" tornou-se "pare de percorrer sob o dedo" (continuidade), "rígida" tornou-se movimento orientado por velocidade, "para de repente" tornou-se momentum mais ease-out, "só depois que eu soltar" tornou-se uma animação única acionada pela liberação. As três fases (arrastar, soltar, descanso) estão explícitas.
Mais exemplos:
Entrada: o popup simplesmente aparece, parece barato
Saída: Anime o popup ao entrar: fade e escala de 0.95 para 1 com um leve deslize para cima de 8px, 200ms, ease-out. Saída com um fade ease-in mais rápido. Escureça o fundo com um scrim que aparece ao mesmo tempo.
Entrada: a lista carrega e então tudo pula de lugar
Saída: Mostre linhas de esqueleto com um shimmer enquanto carrega, dimensionadas para corresponder às linhas finais para que nada se desloque. Quando os dados chegarem, faça crossfade de cada esqueleto para sua linha com um stagger curto (cerca de 50ms entre linhas). Reserve espaço para imagens para evitar layout shift.
Entrada: o botão parece morto quando toco
Saída: Adicione feedback ao pressionar: escala para cerca de 0.96 ao pressionar com um ease-out rápido (100ms), spring de volta ao soltar, e um toque háptico leve. Mostre um estado pressionado claro e desative o botão enquanto a requisição é executada.