Communitygithub.com

bbulman/arquitectura-de-la-información

Úsalo cuando alguien quiera organizar, reestructurar o revisar cómo se agrupa y se encuentra el contenido de un sitio, aplicación, documentación, base de conocimiento o biblioteca de contenidos, y el trabajo abarque varias piezas o aún no esté claro qué pieza se necesita, incluso si nunca mencionan 'arquitectura de la información' o 'IA'. No es para un trabajo que sea claramente una sola pieza, como solo una prueba de árbol o solo un mapa de redirecciones, y no es para diseño visual.

¿Qué es arquitectura-de-la-información?

Esta habilidad define cómo se estructura, etiqueta y conecta el contenido y las funciones de un sistema para que las personas encuentren lo que necesitan y entiendan lo que pueden hacer. Es útil porque una mala estructura afecta al contenido, el diseño, la búsqueda, las URL y el CMS, generando costos adicionales y trabajo extra. Funciona en cualquier plataforma (código, CMS, bases de datos, archivos) y guía al agente IA para elegir el trabajo correcto (como reorganizar contenido, diseñar navegación o crear taxonomías), aplicar reglas universales (como estructurar por tareas de usuario, no por organigrama) y entregar artefactos prácticos como mapas de sitio, modelos de contenido y especificaciones de URL. También incluye pautas específicas para trabajar como IA en este campo, limitaciones éticas y recomendaciones para productos de IA y contexto de agentes.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bbulman/information-architecture-skill/tree/HEAD/skills/information-architecture

Preguntar en tu IA favorita

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

Documentación

Arquitectura de la información

La arquitectura de la información es cómo se agrupan, etiquetan y conectan el contenido y las funciones de un sistema para que las personas encuentren lo que necesitan y entiendan lo que pueden hacer. Cada decisión sirve a una prueba: ¿esta estructura ayuda a la persona que está frente a ella a tomar una buena decisión, rápidamente, sin que le digan cómo?

Está por encima de todo lo demás. Una estructura incorrecta sobrecarga el contenido, que no tiene hogar; el diseño, que tiene que inventar navegación extra; la búsqueda, donde las URL cambian constantemente; y el CMS, que se convierte en un montón de soluciones provisionales.

Esta habilidad delimita el trabajo y contiene las reglas que se aplican en todo él. El trabajo en sí mismo está en las habilidades siguientes.

1. Elegir el trabajo

La mayoría de las solicitudes necesitan parte del conjunto de herramientas, no todo. Nombra lo que vas a producir, para que la persona sepa qué está recibiendo.

El trabajoEjecutar estos, en orden
Reorganizar contenido existentecontent-inventory, card-sort o taxonomies, sitemaps, url-structure si las direcciones cambian, tree-tests, redirect-maps
Nuevo sitio, área de aplicación o secciónsitemaps, navigation, url-structure, content-models
Repensar un menú, navegación o selector de aplicaciónnavigation, labeling, tree-tests
Etiquetas y categoríastaxonomies
Nombres que no funcionanlabeling
"La gente no encuentra X"findability, luego la habilidad que señale el diagnóstico
Mover o reconstruir un sitiositemaps, navigation, url-structure, content-models, redirect-maps
Verificar una estructura antes de construirlatree-tests
Una función o producto de IASección 5 aquí, luego findability

Un mapa del sitio solo es decoración. Para la construcción de un sitio, el conjunto completo es un mapa del sitio, reglas de URL, una especificación de navegación, un modelo de contenido y, para cualquier reconstrucción, un mapa de redirecciones. Sin los otros cuatro, nadie puede construir a partir de él.

Si una habilidad hermana no está disponible, haz esa parte aquí usando las reglas a continuación y dímelo.

2. Enmarcarlo, luego mapear lo que existe

Antes de cualquier ruta, establece quién usa esto y qué está tratando de hacer, cuánto contenido hay ahora y en dos años, qué quiere la empresa de ello y cómo se medirá el éxito. Registra los números actuales de esas medidas antes de que cualquier cosa cambie, o no habrá nada con qué comparar después.

Luego construye la imagen actual. Nunca rediseñes desde la página de inicio únicamente.

  • En un repositorio de código: lee las rutas, los componentes de navegación, sitemap.xml, el esquema del CMS y cualquier tabla de categorías o etiquetas. Cuenta los elementos por sección. Las secciones vacías y sobrecargadas son hallazgos en sí mismos.
  • En una carpeta de contenido: examina todo el corpus, no un elemento a la vez. Di lo que es y a quién parece servir, y deja que la persona te corrija antes de construir sobre una lectura incorrecta.
  • Contenido en una base de datos o CMS: exporta primero títulos, tipos, etiquetas y fechas.
  • Conjuntos muy grandes: examina por tipo y muestra dentro de cada tipo, y di lo que muestreaste, para que nadie confunda una muestra con un censo.

También pregunta por lo que solo las personas saben: las audiencias y sus tareas principales, hacia dónde se dirige la organización, análisis, registros de búsqueda del sitio y las preguntas que el soporte sigue respondiendo.

3. Las reglas que se aplican en todo el trabajo

  • Estructura por lo que la gente intenta hacer, nunca por el organigrama. "Para desarrolladores, APIs" es mejor que "Sobre nosotros, ingeniería, APIs".
  • Dale a cada elemento un hogar canónico. Se puede enlazar desde otros lugares, pero vive en un solo lugar.
  • Mantén el rastro por encima del conteo de clics. La gente hace clic más lejos cuando cada paso huele claramente a su objetivo. La regla de los tres clics es un mito. Los callejones sin salida y las etiquetas vagas son el costo real.
  • Diseña para diez veces el contenido. Si una categoría va a crecer, diseña para eso ahora.
  • Ofrece varias formas de entrada. Navegación, búsqueda, filtros, enlaces relacionados, migas de pan.
  • Pon las señales donde se toma la decisión. Una buena señal responde una pregunta que la persona ya tiene, en el momento en que elige, en el lugar donde ya está mirando, de manera silenciosa y económica.
  • Diseña para el contexto inmediatamente superior. Una página está en una sección, una sección en un sitio, un sitio en un negocio.

4. Trabajar como IA en arquitectura de la información

Lo que haces bien: leer un corpus completo en minutos, proponer esquemas alternativos, aplicar una taxonomía de manera consistente a miles de elementos, encontrar términos casi duplicados y detectar elementos que no encajan en ningún lado.

Lo que no puedes hacer: ejecutar una clasificación de tarjetas o prueba de árbol con personas reales, o conocer la estrategia y política de la organización a menos que te lo digan. Por lo tanto:

  • Propón, no decidas. Da dos o tres esquemas con sus ventajas y desventajas, recomienda uno y di por qué. Una sola respuesta oculta la decisión.
  • Obtén la audiencia y la dirección primero. Si no te han dicho para quién es y hacia dónde se dirige el producto, pregunta, o declara tu suposición al principio.
  • Coloca todo lo que te pidieron que colocaras. Un elemento que no encaje recibe su hogar menos malo y una bandera, y el caso para moverlo, fusionarlo o retirarlo es una recomendación separada.
  • Entrega cada artefacto solicitado. Si crees que uno no debería existir, entrégalo de todos modos y presenta el caso por separado.
  • Nunca inventes datos de investigación. Sin recuentos de participantes inventados, tasas de éxito, volúmenes de tickets, citas o frecuencias. "Se usa cada hora" declarado como un hecho cuenta. Di "probablemente" y enuméralo como una suposición.
  • No adivines el comportamiento de la plataforma. Lo que un host o CMS puede hacer varía. Di lo que esperarías y dile a la persona que lo confirme.
  • Protege el contenido. Antes de editar contenido, metadatos, rutas o redirecciones en el lugar, asegúrate de que el trabajo esté en control de versiones o respaldado.

5. IA para productos de IA, y para el contexto del agente

Antes de añadir IA a un producto, busca lo que realmente está en el camino. Si la gente no puede entender cómo funciona el sistema, no puede distinguir sus categorías, o sigue teniendo que preguntar lo mismo, una estructura más clara, una etiqueta mejor o una señal bien colocada generalmente solucionarán eso de manera más económica que una caja de chat. Los botones y menús hacen dos trabajos: permiten que la gente actúe y muestran a la gente lo que el sistema puede hacer. Un chat abierto hace el primero lentamente y el segundo en absoluto. Usa el chat donde la tarea realmente sea abierta, y en otros lugares usa IA detrás de una interfaz estructurada.

El contexto para los agentes también es un problema de arquitectura de la información. Dale al modelo la información correcta en el momento adecuado: un archivo de entrada corto que apunte a archivos más profundos, un hogar canónico para cada hecho, nombres consistentes y nada cargado que la tarea no necesite.

6. Cuando el trabajo abarca varias habilidades

A menos que se te pida otra cosa, devuelve un documento con:

  1. Resumen: la recomendación en dos o tres frases, y la razón principal de la misma.
  2. Lo que existe ahora: el árbol actual y los problemas que contiene, con recuentos.
  3. Las opciones: dos o tres esquemas, cada uno con a quién sirve, qué cuesta y dónde se esfuerza.
  4. La propuesta: el árbol recomendado con el tipo de plantilla de cada nodo, luego las etiquetas y la especificación de navegación, y las reglas de URL y el modelo de contenido cuando sea relevante.
  5. Migración: el mapeo de lo antiguo a lo nuevo y notas de reetiquetado, si algo se mueve.
  6. Suposiciones y preguntas abiertas: todo lo que asumiste.
  7. Cómo validarlo: tareas de prueba de árbol con sus respuestas correctas y objetivos, o la clasificación de tarjetas que se debe ejecutar primero.

Escálalo al trabajo. Empieza con la recomendación, mantén cada sección tan corta como pueda ser sin dejar de ser utilizable, y empuja las tablas largas al final. Un documento más largo no es más exhaustivo.

Verifica que sea coherente consigo mismo antes de entregarlo. Vuelve a contar los totales con la tabla de ubicaciones, verifica cada regla que establezcas con las tablas que escribiste, rastrea cualquier afirmación sobre la longitud de la ruta a través del árbol, y asegúrate de que cualquier archivo entregable implemente cada fila del plan del que proviene.

Para revisar una arquitectura de la información, propia o de otra persona, puntúala con references/rubric.md.

7. Patrones para nombrar cuando los veas

  • Navegación por organigrama: secciones nombradas según departamentos.
  • Dos taxonomías en competencia: el carril lateral, las migas de pan y la URL dicen algo diferente cada uno.
  • Todo bajo un solo paraguas: /servicios/<cosa> para cada sección, un cajón de sastre con una URL.
  • Secciones de marcador de posición: páginas "Próximamente" que se envían. Constrúyelo o déjalo fuera.
  • Una caja de chat en lugar de estructura: una interfaz de IA abierta donde opciones claras responderían la pregunta más rápido y enseñarían a la gente cómo funciona el sistema.

Individual skills in this repo

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

bbulman/findability

Use when people can't find something, when site search returns nothing or the wrong thing, when someone wants a search log analysed, best bets or synonyms set up, a no-results page designed or findability measured, or when a chatbot is proposed because "nobody can find anything". Not for redrawing the whole page tree, renaming a menu on its own, or running a tree test.

bbulman/labeling

Use when someone needs to name or rename a section, menu item, tab, category, feature or link, when labels feel vague or read like internal jargon, or when they ask "what should we call this", "is this label clear", "nobody knows what Resources means" or "people don't understand this menu". Not for deciding the structure behind the labels, building a tag vocabulary, or writing body copy and microcopy.

bbulman/navigation

Use when someone wants a navigation or menu designed, audited or cut down, including a main menu, nav bar, sidebar, app switcher, mega-menu, footer, breadcrumbs, tab bar or mobile menu, or says "there are too many items in the menu", "rethink the sidebar", "our nav is a mess" or "where should settings go". Not for deciding which pages exist, for wording a single label, for fixing site search, or for running a tree test.

bbulman/sitemaps

Use when someone needs the structure of a website, app or docs set decided, asking for a sitemap, site tree, page hierarchy or list of sections, or saying "what pages do we need", "how should we organise the site", "where should this page live" or "the site is too deep". This is where the structure gets decided. Not for writing the linked sitemap file that later design stages read once the structure is settled (design-os:create-sitemap), for generating sitemap.xml, or for designing the menus.

Skills relacionados