UI sem ruído
Construa uma interface que as pessoas possam usar, não uma narração da interface. Padrão para o controle, seu nome, o objeto relevante e o estado necessário. Adicione cópia de suporte apenas quando ela mudar a compreensão, a decisão, a próxima ação ou a avaliação de risco do usuário.
Ao gerar
- Comece sem mobília explicativa. Não adicione automaticamente um subtítulo, parágrafo introdutório, cartão de ajuda, banner, sobrancelha, badge ou ícone a cada seção. Adicione um apenas por uma necessidade concreta do usuário, não para preencher espaço ou fazer a página parecer finalizada.
- Deixe a interface fazer a explicação. Prefira rótulos específicos, verbos de ação familiares, agrupamento e posicionamento. "Criar workspace" não precisa de "Clique abaixo para criar um workspace." Se um rótulo não for claro, corrija o rótulo antes de adicionar um parágrafo.
- Não narre a implementação. Arquitetura, escolhas de componentes, avisos genéricos de confiança e relatórios de progresso do desenvolvedor não são cópia padrão do produto. Preserve fatos técnicos quando eles afetarem privacidade, escopo, recuperação ou a próxima decisão do usuário.
- Diga cada fato onde ele é útil. Um título, badge, frase e banner não devem repetir o mesmo fato no mesmo escopo. Preserve a repetição proposital, como um resumo de erro vinculado a um campo, ou um aviso ao lado de uma ação distinta e consequente. Não mescle estados entre objetos, solicitações ou workspaces.
- Remova também o invólucro vazio. Quando a cópia redundante for removida, remova seu cartão, alerta, ícone, divisor ou espaço reservado agora inúteis. Não substitua um parágrafo por um badge decorativo ou uma linha de ícones. Não esconda cópia desnecessária em um tooltip, divulgação, tipo minúsculo ou baixo contraste.
- Mantenha a informação necessária para agir com segurança. Mantenha rótulos de campo associados e normalmente visíveis; restrições reais de formato/comprimento/obrigatoriedade; erros acionáveis; estados de carregamento, não salvo, indisponível, permissão e desconhecido significativos; e o escopo e consequências de ações perigosas. Desconhecido não é vazio, sucesso ou falha. Nunca implique que uma capacidade indisponível funciona.
- Torne a informação necessária legível. Estado importante e razões de ação desabilitada devem ser visíveis perto de seu escopo, não apenas para leitores de tela ou apenas ao passar o mouse. Mantenha nomes acessíveis, descrições, urgência de região ativa, acesso por teclado e legibilidade em tela estreita. Concisão nunca substitui acessibilidade.
- Não crie um produto menor por acidente. Preserve recursos, dados, ações, confirmações, autorização e comportamento de solicitação/repetição. Não exclua um requisito de segurança ou negócio pouco claro: sinalize a ambiguidade específica para o proprietário.
Antes de entregar uma tela alterada
Revise a tela renderizada quando disponível, não apenas strings isoladas. Para cada string de suporte e seu contêiner, escolha um resultado:
- Manter: adiciona um fato, distinção, restrição, consequência ou próximo passo necessário.
- Reescrever: o fato é necessário, mas sua redação é vaga, repetida ou mais longa que o necessário.
- Mesclar: repete o mesmo fato no mesmo escopo; mantenha o posicionamento e as associações úteis.
- Excluir: a interface já comunica isso e nenhum significado necessário é perdido; remova o invólucro vazio.
- Mover: apenas ajuda genuinamente de baixa frequência pertence atrás de uma entrada de ajuda explícita e acessível. Não enterre ações comuns ou estado importante.
Verifique o escopo alterado nos estados normal, vazio, erro, indisponível e desconhecido, quando aplicável. Inclua confirmação destrutiva se afetada, navegação por teclado e uma viewport estreita. Não afirme verificação de navegador ou acessibilidade que não foi executada.
Relate mudanças significativas brevemente como antes → depois — motivo; inclua um fato necessário deliberadamente mantido. Não escreva um novo ensaio explicativo no produto ou invente um sistema de pontuação para provar que é conciso.
Exemplos
| Antes | Depois / decisão |
|---|---|
| workspace · aqui você gerencia e organiza seu workspace | workspace — exclua a descrição repetida. |
| Clique no botão abaixo para criar um novo projeto / Criar projeto | Criar projeto — mantenha a ação real. |
| Nome do projeto / Insira o nome do seu projeto aqui | Nome do projeto — mantenha o rótulo; remova a instrução óbvia. |
| Arquivo / Apenas CSV, máximo 20 MB | Mantenha ambos — a segunda linha é uma restrição real. |
| Salvo + Salvamento bem-sucedido + Suas alterações foram salvas | Um reconhecimento adequadamente escopo se necessário; sem empilhamento de sinônimos. |
| Resultado do salvamento desconhecido. Consulte primeiro este resultado, não salve novamente. | Mantenha — a incerteza e o próximo passo seguro importam. |
| Excluirá permanentemente "Plano de viagem" e suas 12 notas, irrecuperável. | Mantenha o objeto, escopo, contagem e consequência. |
Limites
Esta skill é uma orientação de modelo, não um linter, hook automático ou prova de conformidade. Siga a terminologia existente do projeto, contratos de produto e segurança. Não introduza uma especificação concorrente ou instale dependências, entre em contato com serviços externos ou altere a configuração global para usar esta skill. Os exemplos são sensíveis ao idioma: preserve terminologia consistente; não force contagens de palavras em inglês, variação de sinônimos literários, contagens universais de fontes ou um ícone em cada linha.