CommunityPesquisa e Análise de Dadosgithub.com

bbulman/affinity-diagram

Organize notas de pesquisa reais nos temas que as pessoas realmente compartilham. Precisa de dados para funcionar.

O que é affinity-diagram?

Esta skill transforma um monte de observações brutas em uma estrutura organizada que você pode usar para tomar decisões informadas. Ela é essencial para analistas de pesquisa de usuários e desenvolvedores de produto que precisam extrair padrões significativos de dados qualitativos, como entrevistas, anotações de campo ou feedback de planilhas. A skill suporta plataformas como Claude Code, Cursor e Codex, onde segue um contrato de pesquisa armazenado em `~/.claude/skills/research-shared/contract.md`. O processo começa pela coleta de dados de entrada, depois divide cada observação em notas individuais, realiza múltiplas rodadas de ordenação cega para garantir robustez, nomeia clusters como frases (não como rótulos), conta pessoas em vez de notas para evitar viés, e empilha os clusters em 3 a 6 temas que respondem diretamente à decisão do resumo da pesquisa. O resultado final é salvo em `affinity.md` na pasta de ideias, pronto para as próximas etapas como sumarização ou criação de persona.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bbulman/research-skills/tree/HEAD/skills/affinity-diagram

Installed? Explore more Pesquisa e Análise de Dados skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Transforma uma pilha de observações numa estrutura que você pode raciocinar. Não há modo protótipo: sem dados não há nada para ordenar.

Leia ~/.claude/skills/research-shared/contract.md e mantenha-se fiel a ele durante todo o processo. $SHARED significa essa pasta. Sua saída é affinity.md na pasta de ideias.

Passos

  1. Início. Antes de qualquer outra coisa, procure dados em inbox/, --evidence e primary.md. Se não houver nenhum, diga o que esta skill precisa e pare, sem criar nada. Depois siga "Iniciar uma execução" no contrato. A captação inclui qualquer material novo. Concluído quando o resumo nomeia uma decisão e a captação relatou.

  2. Dispor as notas. Use cada excerto em primary.md, além de qualquer outra coisa que a pessoa indicar: post-its exportados, uma planilha de feedback, anotações de campo. Divida cada um em notas que contenham uma observação cada. Concluído quando você tiver pelo menos 20 notas de pelo menos 3 pessoas. Com menos, pare, diga quantas mais são necessárias e aponte para /create-interview-script.

  3. Ordenar de baixo para cima. Deixe de lado as perguntas de pesquisa e quaisquer categorias que alguém esperava. Pegue uma nota, encontre com o que ela se relaciona e inicie uma nova pilha se nada couber. Não nomeie nada ainda. Cada nota vive em uma pilha. Concluído quando cada nota está em uma pilha.

  4. Ordenar novamente, às cegas. Inicie um novo agente apenas com as notas e peça para ordená-las sem ver suas pilhas. Compare as duas. As notas que caíram em lugares diferentes são onde a estrutura está fraca: releia cada uma e decida onde ela pertence. Se não puder iniciar um agente, diga isso nas notas da execução. Concluído quando cada discordância é resolvida ou listada, e as notas da execução dizem quantas notas mudaram.

  5. Nomear cada cluster como uma frase. Diga o que essas pessoas têm em comum, na linguagem delas: "Os proprietários só sabem de um não comparecimento quando o paciente não aparece", em vez de "Não comparecimentos". Concluído quando nenhum nome de cluster é um rótulo de tópico.

  6. Contar pessoas, não notas. Para cada cluster, conte pessoas e organizações distintas. Uma pessoa falante é uma voz, por mais notas que tenha dado. Um cluster que se apoia em uma única pessoa vai para a seção Outliers. Divida qualquer pilha acima de 12 notas. Uma única nota perdida também vai para Outliers, com o motivo pelo qual se destaca. Concluído quando cada cluster tem pelo menos 2 pessoas, e Outliers diz por que cada uma está lá.

  7. Empilhar em temas. Agrupe os clusters em 3 a 6 temas. Cada tema diz o que nos conta sobre a decisão no resumo e quantas pessoas estão por trás dele. Concluído quando cada cluster está sob um tema.

  8. Procurar as surpresas. O que contradiz o que a equipe esperava? Qual grupo de pessoas está faltando no quadro? Concluído quando "O que nos surpreendeu" tem pelo menos uma linha, ou um [gap].

  9. Escrever. Preencha $SHARED/templates/affinity.md. Concluído quando cada seção tem suas afirmações ou um [gap].

  10. Finalizar. Siga "Finalizar uma execução" no contrato. A próxima skill é /summarize-research, ou /create-persona no modo real.

Individual skills in this repo

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

Habilidades Relacionadas