Gerador de Microcopy de UX

Quando Usar

Use esta habilidade quando precisar gerar microcopy de UX (rótulos de botões, mensagens de erro, estados vazios, toasts) seguindo uma voz e tom casuais, mas educados.

Quando NÃO Usar

• Para conteúdo longo (posts de blog, documentos, páginas de marketing) — fora do escopo
• Para design de estado de feedback completo (não apenas texto) → use /ss-feedback
• Para definição de voz/tom da marca em si — esta habilidade consome uma especificação de voz, não a cria
• Para traduções para idiomas que não sejam inglês — apenas um idioma

Contexto: $0 Descrição: $ARGUMENTS

Leia engine/UX-WRITING.md primeiro — é o conjunto de regras que esta habilidade aplica: botões nomeiam a ação (não "Enviar"), erros ajudam em vez de culpar, estados vazios convidam, cópias de dinheiro permanecem calmas, um termo por conceito. Projetos coreanos/CJK: veja §W8 para o "sentimento Toss" claro-calmo-humano (존댓말 일관성, 사용자 관점 "내 계좌", 군더더기 빼기).

Instruções

1. Leia a referência da linguagem de design:

   • Seções DESIGN-LANGUAGE.md sobre Guia de Tom de Microcopy e Escrita de UX

2. Aplique os princípios de voz:

Regras de Tom

• Casual, mas educado: Amigável, não robótico. Como conversar com um amigo prestativo.
• Voz ativa: "Salvamos suas alterações" em vez de "Suas alterações foram salvas"
• Enquadramento positivo: "Frete grátis em pedidos acima de R$ 30" em vez de "Pedidos abaixo de R$ 30 têm taxas de frete"
• Linguagem simples: "Enviar dinheiro" em vez de "Iniciar transferência"
• Conciso: Cada palavra deve justificar seu lugar

Padrões de Cópia por Contexto

Rótulos de Botão (CTA)

Format: [Action verb] + [Object] (optional)
Good: "Place order", "Get started", "Save changes", "Try again"
Bad:  "Submit", "OK", "Click here", "Proceed to next step"

• Um CTA principal por tela
• O rótulo deve descrever claramente o que acontece a seguir
• Máximo de 3 palavras para o CTA principal

Estados Vazios

Format: [Friendly observation] + [Suggested action]
Good: "No activity yet. Create your first project to get started."
Bad:  "No data found."

• Sempre sugira uma próxima ação
• Use um ícone relevante (32px, texto-texto-terciário)
• Tom: encorajador, não culpador

Mensagens de Erro

Format: [What happened] + [What to do]
Good: "Couldn't load the data. Please try again."
Bad:  "Error 500: Internal Server Error"

• Nunca mostre erros técnicos aos usuários
• Culpe o sistema, não o usuário
• Sempre forneça uma ação de recuperação

Notificações Toast

Format: [Confirmation of what happened]
Good: "Saved!", "Changes applied", "Item deleted · Undo"
Bad:  "Operation completed successfully"

• Máximo de 2 linhas
• Inclua o link "Desfazer" para ações destrutivas reversíveis
• Toasts de informação: 3 segundos. Toasts de ação: 5 segundos.

Rótulos e Auxiliares de Formulário

Label: Noun phrase ("Email address", "Password")
Placeholder: Example or hint ("name@example.com")
Helper: Format guidance ("Must be at least 8 characters")
Error: Specific issue ("This email is already registered")

Diálogos de Confirmação

Title: [Question about the action]
Body: [Consequence explanation]
Primary: [Action verb] ("Delete", "Confirm")
Secondary: "Close" (not "Cancel" — avoids confusion)

3. Gere a cópia para o contexto solicitado, fornecendo:
   • Cópia principal (o que exibir)
   • Variantes (se o contexto variar)
   • O que fazer e o que não fazer para o contexto específico

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente à sua fonte original e ao contexto do projeto local.
• Verifique comandos, código gerado, dependências, credenciais e comportamento de serviços externos antes de aplicar alterações.
• Não trate exemplos como substitutos para testes específicos do ambiente, revisão de segurança ou aprovação do usuário para ações destrutivas ou custosas.