bbulman/findability

Findability (Encontrabilidade)

"As pessoas não conseguem encontrar" é um sintoma com quatro causas comuns, e cada uma exige uma correção diferente. Esta skill serve para decidir o que mudar primeiro: ela separa a causa da reclamação, escolhe a correção mais barata que a aborda e define uma medida que mostra se funcionou.

Antes de começar

Você precisa	Se estiver faltando
O que as pessoas não conseguem encontrar, quem elas são e onde procuraram	Pergunte. Se continuar vago, liste os candidatos e trate-os como hipóteses.
O site, o app ou pelo menos sua navegação	Pergunte. Sem isso, você só pode escrever o plano de diagnóstico.
Um log de busca como CSV: consulta,contagem,resultados e cliques se disponível	Diga o que exportar e por qual período. Entregue o plano de diagnóstico, as medidas e as tabelas vazias. Nunca estime o que o log diria.
Analytics, perguntas do suporte, um inventário	Diga quais conclusões eles alterariam e marque-as como não confirmadas.

Método

1. Escreva a falha como uma tarefa. "Um(a) [quem] tentando [objetivo] olha em [onde] por [coisa], e [o que acontece]." Uma linha por reclamação, nas palavras deles.

2. Leia o log e use seus números.

   node "${CLAUDE_SKILL_DIR}/scripts/search-log.mjs" searches.csv
   

   Se o script disser que o log é muito pequeno para classificar, use-o como uma lista das palavras que as pessoas digitaram e indique que não há taxas. Diga qual período a exportação cobre; o script não tem como saber.

3. Diagnostique antes de prescrever. Trabalhe as causas nesta ordem, porque cada uma se baseia na anterior. Várias podem se aplicar ao mesmo tempo. Marque cada conclusão como confirmada ou inferida.

   Causa	Como confirmar	Correção usual	Skill
   Ausente: não existe	Procure por todos os nomes que as pessoas usam. Consultas com zero resultados e nenhum conteúdo correspondente em qualquer lugar	Crie o conteúdo, ou diga claramente que ele não é oferecido	content-inventory
   Mal rotulado: existe com outro nome	A palavra deles dá zero resultados ou nenhum clique enquanto o conteúdo está sob o seu nome; pogo-sticking	Renomeie, adicione sinônimos	labeling
   Enterrado: bem nomeado, sem rota até ele	Conte os passos desde a home e os hubs; procure por órfãos, becos sem saída, paginação profunda como único caminho, buscas iniciadas na página da seção que deveria oferecê-lo	Link onde as pessoas já procuram, ou mova-o	navigation, sitemaps
   A busca está falhando: existe, a consulta corresponde, os resultados estão errados	Execute você mesmo as principais consultas e leia os resultados; resultados sem cliques, reformulações, saídas da página de resultados	Best bets, sinônimos, escopo do índice, ranqueamento	Passo 5

   Muitos problemas de encontrabilidade são mais baratos de resolver em rótulos e agrupamentos do que no mecanismo de busca, portanto não comece pelo mecanismo. Profundidade sozinha não é um defeito: a regra dos três cliques é um mito, e as pessoas clicam mais quando cada passo cheira claramente ao seu objetivo.

4. Decida qual rota deve funcionar. Apoie a navegação e a busca, porque as pessoas alternam entre elas. As principais consultas devem ser alcançáveis em um ou dois passos a partir da home.

   A pessoa	Rota a fortalecer
   Sabe o nome exato	Busca, ou uma lista A a Z
   Sabe a necessidade mas não o nome	Navegar com rótulos claros, depois facetas
   Está explorando ou comparando	Navegar, filtros, links relacionados
   Está voltando a algo	Itens recentes, visualizações salvas, atalhos
   Está no meio de uma tarefa	Um link contextual ou dica no local onde está trabalhando

5. Corrija a busca onde a busca é a causa. Coloque 'best bets' curados no topo dos resultados para as principais consultas. Construa conjuntos de sinônimos a partir dos grupos de variantes do script, começando pelos marcados como SINÔNIMO RESPONDERIA, depois adicione o que só uma pessoa percebe, como acrônimos e jargões. Nunca deixe uma página de 'sem resultados' ser um beco sem saída. references/search-tuning.md cobre todos os três itens e o que exportar.

6. Coloque dicas onde a decisão acontece. Uma boa dica responde a uma pergunta que a pessoa já tem, no momento em que ela faz a escolha, no local onde ela já está olhando, de forma silenciosa e barata. A seta ao lado do medidor de combustível de um carro mostrando de que lado está a tampa é o modelo. Leia references/routes-and-cues.md antes de adicionar uma dica ou um ponto de entrada personalizado.

7. Se alguém propõe um chat de IA como solução, teste primeiro. Botões e menus permitem que as pessoas ajam e mostram o que o sistema pode fazer. Uma caixa de chat aberta faz o primeiro lentamente e o segundo não faz.

   Situação	Melhor resposta
   Um conjunto limitado e conhecível de opções	Botões, menus ou filtros
   As pessoas não sabem o que o sistema pode fazer	Estrutura visível; uma caixa vazia não ensina nada
   Uma tarefa repetida com passos conhecidos	Um caminho direto
   O conteúdo está ausente ou mal rotulado	Corrija isso primeiro; o chat não pode recuperar o que não está lá
   Verdadeiramente aberto, expresso de forma diferente a cada vez	O chat pode merecer seu lugar, com estrutura ao redor

8. Defina medidas que você pode realmente coletar. Tire uma linha de base antes de mudar qualquer coisa, uma medida por problema. Se não houver linha de base, diga isso.

   Medida	Vem de	Alvo
   Tempo para encontrar um item simples	Um teste de tarefa cronometrado com pessoas	Abaixo de 30 segundos
   Sucesso na tarefa	Um teste de tarefa ou teste de árvore	Pelo menos 70%, e 80% para as principais tarefas
   Participação de consultas com zero resultados nas buscas	Log de busca	Abaixo de sua própria linha de base
   Saídas da busca, reformulações	Analytics, se a página de resultados for rastreada	Abaixo de sua própria linha de base
   Volume de suporte sobre este tópico	Help desk, se etiquetado	Abaixo de sua própria linha de base

   references/measures.md diz o que cada uma pode e não pode mostrar.

Entregável

Escreva findability-diagnosis.md a menos que o usuário nomeie outro arquivo, nesta ordem: Recomendação (duas ou três frases); As falhas, como tarefas; Evidência (fonte, período, números do script); Diagnóstico (coisa, causa, evidência, confirmado ou inferido); Opções (duas ou três, com o que cada uma custa e o que deixa sem corrigir); Lista de correções em ordem, com a skill que cuida de cada uma; Best bets e sinônimos (consulta, ação, alvo); Página de 'sem resultados', se relevante; Medidas (nome, linha de base, alvo, fonte, data de reavaliação); Suposições e o que não estava disponível.

Trabalho	Devolva
Uma coisa que ninguém consegue encontrar	Falha, causa, evidência, correção e uma medida, na resposta
Um log de busca para ler	Evidência, best bets e sinônimos, e as lacunas de zero resultados
"A encontrabilidade está ruim em todo o site"	O documento completo

Coloque tabelas longas por último. Um documento mais longo não é um documento mais completo.

Verifique

• Cada número remete a uma execução do script ou a uma fonte que o usuário lhe deu. Execute o script novamente se o log mudou.
• Cada correção nomeia a causa que aborda, e cada causa tem evidência ou está marcada como inferida.
• Você executou as principais consultas manualmente se teve acesso, porque o log não pode dizer se os resultados foram bons.
• Você verificou se cada sinônimo proposto significa a mesma coisa. O script agrupa por ortografia, então pode parear palavras que diferem em significado.
• Logs de busca podem conter nomes e e-mails digitados na caixa. O script oculta endereços de e-mail; não copie outros detalhes pessoais no relatório.

O que o Claude não pode fazer aqui

Você não pode observar pessoas reais buscando, cronometrá-las ou saber a estratégia da organização a menos que lhe seja dito. Nunca invente números de uso, volumes de busca, taxas de sucesso ou citações; uma medida sem dados é mostrada como ainda não coletada. Proponha alternativas com suas compensações, recomende uma e diga por quê; o humano é dono da decisão. O que um produto de busca pode fazer (sinônimos, resultados fixados, registro de consultas) varia, então diga o que você esperaria e peça ao usuário para confirmar.

Onde isso passa a mão

Próxima necessidade	Skill
Descobrir o que existe	content-inventory
O nome está errado	labeling
Termos e filtros precisam de trabalho	taxonomies
Os grupos não correspondem a como as pessoas pensam	card-sort
A rota até ele está faltando	navigation, sitemaps
Testar uma hierarquia alterada	tree-tests
Campos necessários para facetas ou pré-visualizações	content-models
Uma página se move	url-structure, redirect-maps
Uma reestruturação de todo o site, ou sem certeza de por onde começar	information-architecture