Communitygithub.com

pesquisa-ux

Use ao planejar ou sintetizar pesquisas com usuários (entrevistas, testes de usabilidade, pesquisas), mapear uma jornada ou tarefa a ser realizada, especificar os estados de uma interação ou realizar uma revisão heurística de um fluxo. Não usar para menus, rótulos, taxonomia ou estrutura do site; use `arquitetura-da-informacao`. Não usar para polimento visual; use `designer`.

O que é pesquisa-ux?

Esta skill capacita agentes de IA a realizar e sintetizar pesquisas de experiência do usuário (UX) de forma rigorosa e orientada a evidências. Ela abrange a definição de perguntas de pesquisa, escolha de métodos (como entrevistas e testes de usabilidade), mapeamento de jornadas e jobs to be done, e especificação completa de interações. A skill enfatiza a separação entre observação, interpretação e recomendação, além de regras claras como 'comportamento vence opinião' e a contagem precisa de participantes por descoberta. É ideal para agentes que auxiliam em processos de design thinking e desenvolvimento de produtos, garantindo que decisões de design sejam baseadas em dados qualitativos sólidos e não em suposições.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/heliacon/claude-skills/tree/HEAD/skills/ux-research

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Pesquisa de UX

Como as pessoas tentam realizar uma tarefa com o produto, onde falham e o que a interface deve fazer em cada etapa. A evidência vem em primeiro lugar. Um fluxo projetado com base em opinião é um palpite com um diagrama anexado.

Limite: esta skill é responsável por pessoas, tarefas, fluxos e estados de interação. A skill arquitetura-da-informacao é responsável por como o conteúdo é organizado, rotulado e encontrado. A skill designer é responsável por como uma tela se parece e é lida.

As regras mais importantes

  1. Escreva a pergunta de pesquisa antes de escolher um método. "Por que usuários em teste não convidam um colega?" define o método. "Vamos fazer algumas entrevistas" não define nada.
  2. Comportamento vence opinião. O que as pessoas fizeram da última vez é evidência. O que dizem que fariam é uma previsão, e uma previsão ruim. Pergunte sobre eventos passados, observe tarefas reais.
  3. Cada descoberta carrega sua contagem e sua fonte. "4 de 6 participantes não encontraram o botão salvar (sessões 2, 3, 5, 6)" é uma descoberta. "Os usuários acharam salvar confuso" não é.
  4. Separe observação, interpretação e recomendação. Escreva-as em três colunas. Misturá-las esconde qual parte é evidência e qual parte é você.
  5. Cinco participantes por grupo de usuário distinto encontra a maioria dos problemas de usabilidade em um teste qualitativo. Isso não mede nada. Nunca cite uma porcentagem de n=5.
  6. Toda especificação de interação cobre todos os estados, não apenas o caminho feliz (veja abaixo).
  7. Diga o que a pesquisa não pode lhe dizer. Toda síntese termina com seus limites e as perguntas em aberto para a próxima rodada.

Quando não usar

  • A pergunta é "onde este conteúdo deve ficar" ou "o que este menu deve dizer": use arquitetura-da-informacao.
  • A pergunta é "isto parece cuidado?": use designer ou design-visual.
  • Você precisa de uma métrica com intervalo de confiança: isso é análise quantitativa, use analise-de-dados. A pesquisa qualitativa encontra os problemas; ela não os dimensiona.
  • Aceitação pelo dono do negócio: use teste-de-aceite-do-usuario.

Escolha do método (um padrão por pergunta)

PerguntaMétodo padrãoNotas
Qual problema eles têm e como o resolvem hoje?Entrevistas sobre a última ocorrência real5 a 8 por segmento; pare quando novas sessões pararem de adicionar temas
Eles conseguem concluir esta tarefa com este design?Teste de usabilidade moderado, think-aloud5 por grupo de usuário; tarefas reais, sem dicas
Onde no fluxo as pessoas desistem?Análise de funil, depois teste de usabilidade na pior etapaOs dados dizem onde; apenas observar diz por que
Quais destes recursos importam?Questionário Kano ou pesquisa de top-tasksPrecisa de uma amostra grande o suficiente para contar, não 5
Como eles chamam as coisas / como as agrupam?Card sortPasse para arquitetura-da-informacao
A nova versão é melhor que a antiga?Mesmas tarefas, mesmas métricas, ambas as versõesDecida a métrica antes do teste

Combine uma fonte qualitativa e uma quantitativa quando a decisão for cara. Quando elas discordarem, a discordância é a descoberta: investigue-a, não a calcule como média.

Entrevistas

  • Recrute pessoas que tiveram o problema recentemente. Uma pergunta de triagem sobre a última vez que isso aconteceu filtra pessoas que apenas acham que têm o problema.
  • Pergunte sobre um evento passado específico: "Conte-me sobre a última vez que..." e então siga a história. Perguntas sobre o futuro ("Você usaria...?") obtêm ficção educada.
  • Sem perguntas tendenciosas. "Como você decidiu?" não "O preço foi o principal fator?"
  • Não apresente, demonstre ou defenda o produto durante uma entrevista. No momento em que você vende, o participante começa a querer agradá-lo.
  • O silêncio é uma ferramenta. Espere três segundos após uma resposta antes da próxima pergunta.
  • Faça anotações literais ou grave com consentimento. Citações são evidência; paráfrase não é.

Testes de usabilidade

Escreva o plano antes de recrutar:

Objetivo:         a decisão que este teste informa
Participantes:    quem, quantos, critérios de triagem
Tarefas:          3 a 6, cada uma um objetivo realista nas palavras do usuário, nunca no rótulo da UI
                  ("Você quer enviar a fatura do mês passado para seu contador",
                   não "Use o botão Exportar")
Sucesso:          o que conta como concluído para cada tarefa, decidido agora
Medidas:          conclusão, erros, tempo, assistências, avaliação de facilidade pós-tarefa
Script:           introdução, consentimento, aquecimento, tarefas, perguntas de debriefing
  • Uma tarefa que nomeia o botão testa leitura, não usabilidade.
  • Anote onde o participante hesita, volta atrás ou diz "Esperava que...". Esses são os problemas, mesmo quando a tarefa é concluída.
  • Avalie cada problema por gravidade: bloqueia a tarefa, causa um grande atraso ou erro, incômodo menor, cosmético. Corrija nessa ordem.

Síntese

  1. Coloque cada observação em sua própria linha com o ID do participante e sessão.
  2. Agrupe por padrão, não por tela. Nomeie cada grupo como uma frase de descoberta.
  3. Conte os participantes por trás de cada descoberta. Uma citação vívida não é um padrão.
  4. Transforme cada descoberta em um insight (por que acontece) e depois em uma oportunidade ("Como poderíamos..."). Mantenha a cadeia visível: oportunidade, insight, descoberta, notas brutas.
  5. Identifique segmentos a partir dos dados. Se dois grupos se comportarem de forma diferente, relate-os separadamente, não os misture em um único usuário médio.
  6. Termine com notas metodológicas (quem, quantos, como recrutados, o que não foi coberto) e perguntas para pesquisas futuras.

Jobs to be done

Para cada grupo de usuário, nomeie três partes da tarefa:

  • Funcional: a tarefa ("enviar minha declaração de imposto trimestral").
  • Emocional: como eles querem se sentir ("com certeza não cometi nenhum erro").
  • Social: como eles querem ser vistos ("organizado na frente do meu contador").

Projete o fluxo para a tarefa, não para a lista de recursos. Uma declaração de job escrita a partir das suposições da equipe, sem nenhuma entrevista por trás, é uma hipótese. Rotule-a como tal.

Mapas de jornada

  1. Defina o objetivo no nível da jornada.
  2. Divida em fases (por exemplo: descobrir, decidir, começar, usar, obter ajuda).
  3. Para cada fase: ações, pensamentos, sentimentos, pontos de contato. Marque quais vêm de pesquisa e quais são presumidos.
  4. Marque momentos da verdade (onde o relacionamento é ganho ou perdido), pontos de dor e lacunas de oportunidade.

Um mapa de jornada sem pesquisa por trás é uma crença compartilhada da equipe. Isso tem valor, mas não é evidência. Diga qual é no mapa.

Especificação de interação

Toda especificação de interação cobre:

  • Caminho feliz: o fluxo esperado.
  • Caminho de erro: entrada inválida, solicitação falha, tempo limite, permissão negada.
  • Estado vazio: nenhum dado ainda. O primeiro estado vazio é um convite para a primeira ação.
  • Estado de carregamento: o que o usuário vê enquanto espera, e depois de quanto tempo muda.
  • Estado parcial: alguns dados carregados, alguns falharam.
  • Casos de borda: nomes muito longos, zero, um e muitos itens, rede lenta, botão voltar, envio duplicado, expiração de sessão no meio do fluxo.

Toque e entrada:

  • Alvos de toque de pelo menos 44 por 44 pt (iOS) ou 48 por 48 dp (Android). Sem sobreposição.
  • Nunca coloque informações ou ações essenciais atrás de hover em um dispositivo touch.
  • Todo fluxo é concluído apenas pelo teclado. O foco move-se para um diálogo quando ele abre e volta para o gatilho quando ele fecha.

Erros:

  • Previna primeiro: restrinja a entrada (seletores, listas), valide ao sair do campo, nomeie o objeto em uma confirmação destrutiva ("Excluir 'Fatura de março'", não "Excluir item").
  • Prefira desfazer a um diálogo de confirmação para ações reversíveis.
  • Uma mensagem de erro diz o que deu errado, como corrigir e com quem entrar em contato se o usuário não conseguir. "A senha deve ter pelo menos 8 caracteres" é melhor que "Entrada inválida".
  • Um formulário nunca limpa a entrada do usuário em um erro de validação.

Leia references/checklists-de-revisao.md ao realizar uma revisão heurística, verificar carga cognitiva, projetar onboarding ou classificar recursos com o modelo Kano.

Armadilhas

  • Perguntar aos usuários o que eles querem. Eles respondem com recursos que viram em outros lugares. Pergunte o que eles fizeram e o que atrapalhou; derive o recurso você mesmo.
  • Testar com colegas. Eles conhecem as palavras e o modelo do produto. O sucesso deles não prova nada sobre um estranho.
  • Recrutar apenas clientes satisfeitos. Pessoas que desistiram ou nunca ativaram têm as respostas mais úteis. Recrute-as de propósito.
  • Contar uma descoberta de n=5 como uma taxa. "60% falharam" de 3 de 5 implica uma precisão que você não tem. Diga "3 de 5".
  • Uma revisão heurística apresentada como pesquisa de usuário. Uma revisão de especialista encontra prováveis problemas rapidamente. É uma previsão sobre usuários, não uma observação deles. Rotule-a.
  • Uma citação forte guiando o roadmap. Verifique quantas sessões a suportam antes de incluí-la em uma apresentação.
  • Projetar apenas o caminho feliz. Os estados vazio, carregamento e erro são onde novos usuários passam seus primeiros minutos. Especifique-os primeiro, se possível.
  • Um fluxo que funciona na especificação, mas não na build. Percorra a build real com as mesmas tarefas antes de considerar a pesquisa concluída.

Verificação

O trabalho de pesquisa está concluído quando:

  • A pergunta de pesquisa e a decisão que ela informa estão documentadas.
  • Cada descoberta nomeia sua contagem de participantes e sessões de origem.
  • Observação, interpretação e recomendação são mantidas separadas.
  • Conteúdo presumido (em mapas de jornada, declarações de job) é rotulado como presumido.
  • Limites e perguntas em aberto estão listados.
  • Cada especificação de interação cobre os estados feliz, erro, vazio, carregamento, parcial e de borda.
  • As recomendações são classificadas por gravidade e por quantos usuários afetam.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Habilidades Relacionadas