bbulman/affinity-diagram

Ordena notas de investigación reales en los temas que las personas realmente comparten. Necesita datos para funcionar.

¿Qué es affinity-diagram?

Este skill transforma una pila de observaciones sin procesar en una estructura temática clara y accionable, ideal para investigadores de UX y diseñadores de producto que necesitan extraer patrones significativos de datos cualitativos. Está diseñado originalmente para entornos como Claude Code, Cursor o Codex, y opera siguiendo un contrato de investigación compartida. El proceso comienza leyendo datos de archivos como `primary.md` o `inbox/`, luego divide cada observación en notas individuales, las ordena en pilas temáticas sin etiquetas previas, realiza una segunda ordenación a ciegas para validar la estructura, nombra cada grupo como una frase que refleje el lenguaje de los participantes, cuenta personas en lugar de notas para evitar sesgos, y finalmente agrupa las pilas en 3 a 6 temas. Además, identifica sorpresas y lagunas. El skill no tiene modo prototipo: sin datos suficientes se detiene y solicita más. Es especialmente útil para equipos que buscan tomar decisiones basadas en evidencia real, evitando interpretaciones prematuras o categorías predefinidas.

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

Installed? Explore more Investigación y análisis de datos skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Convierte un montón de observaciones en una estructura sobre la que puedas razonar. No hay modo prototipo: sin datos no hay nada que ordenar.

Lee ~/.claude/skills/research-shared/contract.md y respétalo en todo momento. $SHARED significa esa carpeta. Tu resultado es affinity.md en la carpeta de ideas.

Pasos

  1. Inicio. Antes que nada, busca datos en inbox/, --evidence y primary.md. Si no hay ninguno, di qué necesita este skill y detente, sin crear nada. Luego sigue "Iniciar una ejecución" en el contrato. La ingesta incorpora cualquier material nuevo. Hecho cuando el brief nombra una decisión y la ingesta ha informado.

  2. Distribuye las notas. Usa cada extracto en primary.md, además de cualquier otra cosa a la que la persona te señale: notas adhesivas exportadas, una hoja de cálculo de comentarios, notas de campo. Divide cada uno en notas que contengan una sola observación. Hecho cuando tengas al menos 20 notas de al menos 3 personas. Si son menos, detente, di cuántas más se necesitan y señala /create-interview-script.

  3. Ordena desde abajo hacia arriba. Deja a un lado las preguntas de investigación y cualquier categoría que alguien esperara. Toma una nota, encuentra con qué se relaciona y comienza un nuevo montón si no encaja en ninguno. No nombres nada aún. Cada nota vive en un solo montón. Hecho cuando cada nota está en un montón.

  4. Vuelve a ordenar, a ciegas. Inicia un agente nuevo solo con las notas, y haz que las ordene sin ver tus montones. Compara los dos. Las notas que terminaron en lugares diferentes indican dónde la estructura es débil: relee cada una y decide dónde pertenece. Si no puedes iniciar un agente, indícalo en las notas de la ejecución. Hecho cuando cada desacuerdo está resuelto o listado, y las notas de la ejecución dicen cuántas notas se movieron.

  5. Nombra cada grupo como una oración. Di qué tienen en común estas personas, en su propio lenguaje: "Los propietarios solo se enteran de una ausencia cuando el paciente no se presenta", en lugar de "Ausencias". Hecho cuando ningún nombre de grupo es una etiqueta de tema.

  6. Cuenta personas, no notas. Para cada grupo, cuenta personas y organizaciones distintas. Una persona habladora es una sola voz, por muchas notas que haya dado. Un grupo que se apoya en una sola persona se mueve a Valores atípicos. Divide cualquier montón que supere las 12 notas. Una nota solitaria también va a Valores atípicos, con el motivo por el que se destaca. Hecho cuando cada grupo tiene al menos 2 personas, y Valores atípicos dice por qué está cada uno.

  7. Apila en temas. Agrupa los grupos en 3 a 6 temas. Cada tema dice qué nos cuenta sobre la decisión del brief y cuántas personas lo respaldan. Hecho cuando cada grupo está bajo un tema.

  8. Busca las sorpresas. ¿Qué contradice lo que el equipo esperaba? ¿Qué grupo de personas falta en el panel? Hecho cuando "Lo que nos sorprendió" tiene al menos una línea, o un [vacío].

  9. Escribe. Completa $SHARED/templates/affinity.md. Hecho cuando cada sección tiene sus afirmaciones o un [vacío].

  10. Finaliza. Sigue "Finalizar una ejecución" en el contrato. El siguiente skill es /summarize-research, o /create-persona en modo real.

Individual skills in this repo

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

Skills relacionados