bbulman/etiquetado

¿Qué hace etiquetado?

Las etiquetas son las palabras que le dicen a las personas qué hay detrás de una puerta antes de que la abran. Este skill sirve para decidir cómo se llama cada destino, sección o acción, y qué sistema de nombres utiliza cada nivel. La prueba para cada etiqueta: ¿podría un recién llegado predecir qué hay detrás?

Antes de empezar

Necesitas	Si falta
Las etiquetas actuales, cada una con lo que hay detrás y dónde aparece	Lee la navegación o pregúntalo. Si aún no hay nada, entrega el labels.csv vacío y el plan de prueba.
Quién las lee y qué intenta hacer	Pregunta. Si no llega respuesta, indica tu suposición al principio.
Las propias palabras de los usuarios: registros de búsqueda, preguntas de soporte, nombres de grupos de card-sort, entrevistas, reseñas	Redacta a partir del contenido y las convenciones de productos similares, marca cada etiqueta como sin probar y entrega el plan de prueba para que las palabras puedan verificarse. Nunca presentes una suposición como el lenguaje de los usuarios.

Método

1. Enumera las etiquetas en contexto. Registra el grupo de cada una (las etiquetas que se ven juntas), el destino y qué hay realmente detrás. Juzgar una etiqueta sin sus hermanas es cómo se pasan por alto las superposiciones.

2. Recoge las palabras de los usuarios. Sus palabras son los primeros candidatos; tus términos internos no lo son.

   Fuente	Lo que te da	Cuidado con
   Registros de búsqueda	Las palabras exactas escritas, las palabras desencadenantes más fuertes	Ejecuta el informe de registros del skill de encontrabilidad; nunca estimes volúmenes
   Preguntas de soporte	Cómo describen las personas la necesidad	Las personas en problemas expresan las cosas de manera diferente
   Nombres de grupos de card-sort	Cómo llaman las personas a un grupo	Usa sus palabras más comunes
   Entrevistas, de 5 a 10 personas	Vocabulario y qué significan las palabras para ellas	Escucha la palabra que usan sin que se les pida
   Productos similares	Palabras que las personas ya han aprendido	Lo familiar gana a lo ingenioso

3. Elige un sistema de etiquetado por nivel. Mezclarlos en un mismo menú significa que cada elemento responde a una pregunta diferente y las personas no pueden compararlos.

   Sistema	Ejemplo	Funciona cuando	Se rompe cuando
   Tarea	"Rastrear un pedido"	Las personas llegan con un trabajo que hacer	Las tareas se superponen o la lista es larga
   Audiencia	"Para desarrolladores"	Los grupos necesitan contenido diferente y pueden ubicarse	Alguien está en dos grupos, o no sabe cuál
   Tema	"Facturación"	El tema es como las personas piensan en ello	Los temas son de la organización, no de ellos
   Formato	"Videos", "Plantillas"	Las personas eligen por formato	Les importa primero el tema
   A a la Z	Glosarios, directorios	Las personas saben el nombre exacto	Están navegando para descubrir

4. Escribe candidatos siguiendo estas reglas.

   Regla	Débil	Más fuerte
   Específico y familiar, sin misterio	Recursos, Soluciones, Descubrir	Guías y plantillas
   Construcción paralela entre hermanas	Precios, Primeros pasos, Para equipos	Precios, Configuración, Equipos
   Anteponer la palabra que distingue	Configuración de informes, Historial de informes	Informes: Configuración, Informes: Historial
   Una cosa, un nombre en todas partes	"Equipo" en el menú, "Personas" en la página	Elige uno y úsalo en navegación, título y miga de pan
   La puerta coincide con la habitación	"Planes" abre "Elige tu suscripción"	El texto del enlace y el encabezado de la página coinciden
   El texto del enlace dice lo que obtienes	Más información	Descarga la lista de verificación de incorporación

5. Decide qué ocurre con los nombres internos.

   El nombre es	Haz esto
   Un nombre en clave de equipo, departamento o proyecto	Nunca lo muestres. Nombra para lo que la persona vino a hacer
   Un nombre de marca para una funcionalidad que la gente debe aprender	Acompáñalo con un descriptor sencillo dondequiera que se use para navegación
   Un término técnico que la audiencia realmente usa	Consérvalo, incluso si los de fuera no lo conocen, y pruébalo con esa audiencia
   Un término legal o reglamentario	Conserva el término exacto y pon un glosa sencilla a su lado
   Un acrónimo	Escríbelo completo a menos que la audiencia busque más el acrónimo que las palabras

6. Ofrece dos o tres opciones para cada etiqueta en disputa, con lo que cada una gana y pierde, y recomienda una. Una sola respuesta oculta la decisión.

7. Refuerza el rastro de información alrededor de la etiqueta. Las descripciones cortas, los recuentos de elementos, las migas de pan y los estados activos transmiten lo que la palabra sola no puede. Lee references/information-scent.md cuando las etiquetas estén bien de forma aislada pero la gente aún así rebote.

8. Prueba la predictibilidad. En una dirección, muestra solo la etiqueta y pregunta qué espera la gente detrás; en la otra, da un objetivo y pregunta qué etiqueta elegirían. Como primera pasada puedes hacer una lectura en frío: tapa el destino, escribe lo que esperarías, compara. Reporta eso como tu propia lectura, no como investigación. references/predictability-test.md tiene el plan y la puntuación.

9. Revisa otros idiomas. Si las etiquetas se van a traducir, lee references/locales.md antes de definirlas. Traduce por significado, no palabra por palabra, y vuelve a probar con personas de ese mercado.

Entregable

Escribe estos a menos que el usuario nombre otros archivos.

• labels.csv, una fila por etiqueta: group,label,destination,system,was,evidence,status. evidence dice de dónde vino la palabra (registro de búsqueda, soporte, suposición). status es kept, renamed o new, más tested o untested, separados por punto y coma: renamed; untested.
• labels.md, en este orden: Recomendación (dos o tres frases); El sistema elegido para cada nivel; Etiquetas en disputa (opciones, compensaciones, la elección y por qué); Nombres internos y qué ocurre con cada uno; Cómo probarlos; Suposiciones y preguntas abiertas. La lista completa solo vive en labels.csv, por lo que los dos no pueden discrepar.

Trabajo	Entrega
Renombrar una cosa	Tres opciones con compensaciones, una elección y una pregunta de prueba, en la respuesta
Revisar un menú	Las filas de labels.csv y una lista breve de cambios
Un sitio o aplicación completo	Ambos archivos

Un documento más largo no es más exhaustivo.

Verifícalo

Ejecuta la comprobación mecánica y usa sus recuentos:

node "${CLAUDE_SKILL_DIR}/scripts/label-check.mjs" labels.csv

Encuentra palabras vagas, duplicados en un grupo, hermanas que comienzan con la misma palabra, grupos que mezclan formas gramaticales, una etiqueta con varios destinos y un destino con varias etiquetas. La comprobación de forma solo se activa con patrones claros, así que lee cada grupo tú mismo para ver la construcción paralela. Luego verifica:

• Cada grupo usa un sistema de etiquetado, y labels.md dice cuál.
• Cada etiqueta está tested o marcada untested. Una ejecución limpia del script no prueba nada sobre la comprensión.
• La evidence de cada etiqueta es real. Si es una suposición, la fila lo dice.

Lo que Claude no puede hacer aquí

No puedes aprender lo que las personas reales entienden leyendo una etiqueta tú mismo, y no puedes conocer la estrategia de la organización, los compromisos de marca o la política a menos que te lo digan. Nunca inventes números de uso, volúmenes de búsqueda, resultados de pruebas o citas. Propón alternativas con sus compensaciones, recomienda una y di por qué; el humano es dueño de la decisión, especialmente cuando un nombre conlleva peso de marca o legal.

Dónde se entrega esto

Siguiente necesidad	Skill
Los grupos en sí parecen incorrectos	card-sort, sitemaps
Qué etiquetas van en qué menú	navigation
Términos para etiquetado y filtros	taxonomies
Una sección renombrada que cambia su dirección	url-structure, redirect-maps
Probar etiquetas dentro de una jerarquía	tree-tests
Renombrar no solucionó "la gente no lo encuentra"	findability
Una lista de lo que existe primero	content-inventory
Campos detrás de una plantilla	content-models
Una reestructuración de todo el sitio, o no estás seguro por dónde empezar	information-architecture