bbulman/sitemaps

Mapas del sitio (Sitemaps)

Un mapa del sitio decide qué existe, dónde vive cada cosa y cuántas decisiones separan a una persona de ello. Los menús, las URLs, las plantillas y las redirecciones se derivan de esta decisión, por lo que un árbol incorrecto afecta a todo lo que viene después.

Lo que necesitas primero

Entrada	De dónde viene	Si falta
La estructura actual	En un repositorio, lee primero las rutas, los componentes de navegación, el sitemap.xml, el esquema del CMS y las tablas de categorías. Nunca rediseñes solo desde la página de inicio.	Solicita una lista de URLs o una exportación. Si no hay nada que leer, etiqueta el árbol como un borrador en blanco.
Tamaño del contenido, ahora y en dos años	Cuenta los elementos por sección. Las secciones vacías y las sobrecargadas son hallazgos.	Solicita una cifra aproximada. Si no es posible, muestra qué forma requeriría cada tamaño probable.
Audiencias y tareas principales	El usuario, las analíticas, los registros de búsqueda, las preguntas que el soporte sigue respondiendo	Pregunta, o escribe tu suposición al principio del entregable.
Hacia dónde se dirige la organización	El usuario	Pregunta. Un briefing genérico produce un árbol genérico.

Carpeta de contenido: examina todo el conjunto antes de agrupar, luego describe qué es y a quién parece servir para que el usuario pueda corregirte. Base de datos o CMS dinámico: exporta primero títulos, tipos, etiquetas y fechas. PDF y otros binarios: conviértelos a texto e indica qué tal fue la conversión. Conjunto muy grande: examina por tipo, toma muestras dentro de cada tipo y di qué muestreaste.

Si no puedes obtener nada de esto, explica qué necesitarías y entrega el formato del árbol en references/tree-format.md con los tipos de nodo sugeridos para este tipo de sitio.

Método

1. Dibuja lo que existe. El árbol actual, un recuento de cada sección y sus problemas: superposiciones, vacíos, huérfanos, cualquier cosa archivada por departamento.

2. Dimensiónalo. Usa el total a dos años vista, no el de hoy.

   Elementos	Estructura
   Menos de 50	Plana, de 1 a 2 niveles
   50 a 500	De 2 a 3 niveles
   500 a 5,000	De 3 a 4 niveles más facetas
   Más de 5,000	Navegación, búsqueda y facetas juntos

3. Elige la forma a partir del contenido, nunca del organigrama.

   El contenido	Forma	Qué cuesta
   Unas pocas ofertas distintas, menos de unas 50 páginas	Hub and spoke (centro y radios): unas pocas secciones amplias y poco profundas, cada una a un clic de inicio. El valor por defecto para sitios de marketing.	El inicio hace todo el enrutamiento. Poco margen para crecer antes de una reestructuración.
   Verdaderamente categórico, como un catálogo grande o industria por industria	Jerarquía profunda	Cada nivel cuesta un clic y un poco de "olor" (pista visual). Una mala decisión temprana deja a la gente perdida.
   Mayormente plano, con una o dos áreas densas como documentación o una biblioteca	Híbrido: hub and spoke en la parte superior, una jerarquía estrecha dentro de esas secciones. La respuesta habitual para sitios más grandes.	Dos modelos de navegación que construir y explicar.
   Elementos que la gente clasifica de varias maneras, o una categoría que superará una sola lista	Facetado: dimensiones independientes que se combinan como filtros	Metadatos limpios en cada elemento y alguien que los mantenga.

4. Redacta dos o tres alternativas, cortadas en diferentes ejes (por tarea, por audiencia, por tipo de contenido) en lugar de tres versiones de una misma idea. Para cada una, indica a quién sirve, qué cuesta y dónde se tensa. Recomienda una y explica por qué. Una sola respuesta oculta la decisión.

5. Asigna a cada elemento un único hogar canónico. Puede estar enlazado desde otros lugares, pero vive en un solo sitio, donde la gente lo espera. Dos hogares dividen los resultados de búsqueda, los enlaces y el mantenimiento.

   Un elemento parece pertenecer a dos lugares	Decisión
   Un puñado de auténticos transversales	Un hogar, enlaces cruzados desde los demás
   Muchos elementos pertenecen a varios lugares	El árbol está cortado en el eje equivocado. Usa facetas.
   No sabes dónde buscaría la gente	Elige el hogar más probable y márcalo para la prueba del árbol

6. Anota cada nodo. Cada uno recibe un tipo de plantilla; un nodo sin plantilla suele significar que la idea no está terminada. Marca los nodos nuevos, movidos y retirados. Usa un nodo patrón como /guides/<slug> para páginas repetitivas, y pon facets: e items: en los nodos que los tengan.

7. Ponlo a prueba. Con diez veces el contenido, ¿una sección se convertiría en una lista que nadie puede escanear? Diseña subsecciones o facetas ahora, no después. ¿Sirve el árbol al siguiente contexto más amplio, el producto o negocio que lo rodea? ¿Alguna sección se corresponde con un departamento en lugar de con una tarea? Más de 9 elementos por nivel o 4 de profundidad necesitan una razón, y "la regla de los tres clics lo dice" no lo es, ya que esa regla es un mito: la gente hace más clics si cada paso huele claramente a su objetivo. Lee references/depth-and-shape.md cuando se discutan la profundidad y la anchura, o al revisar el árbol de otra persona.

Entregable

Escribe sitemap-tree.txt, el árbol propuesto y nada más, porque la comprobación lo lee:

/                          home
├── /guides                section-hub   items: 40
│   └── /guides/<slug>     guide
├── /products              listing       items: 120  facets: use, price
│   └── /products/<slug>   product
├── /pricing               marketing     (new)
└── /about                 marketing     (moved from /company)

Luego escribe sitemap.md, en este orden:

1. Recomendación: dos o tres frases y la razón principal.
2. Lo que existe ahora: el árbol actual y sus problemas, con recuentos.
3. Opciones: una fila por estructura, con columnas organizado por, sirve a, cuesta, se tensa cuando.
4. Árbol propuesto: el texto exacto de sitemap-tree.txt en un bloque de código.
5. Ubicaciones: elemento, hogar, nota. Solo cuando se pregunte dónde van las cosas.
6. Suposiciones y preguntas abiertas: todo lo que hayas supuesto, sobre todo audiencia y dirección.
7. Cómo validar: las ubicaciones más riesgosas, sometidas a pruebas de árbol.

Redúcelo. Un sitio de 12 páginas necesita la recomendación, el árbol y una tabla de opciones de tres líneas. Un documento más largo no es más exhaustivo. Una solicitud de ubicar cada elemento significa que cada elemento recibe un hogar: asigna a un elemento no encajado su hogar menos malo, márcalo y argumenta por separado para moverlo, fusionarlo o retirarlo.

Compruébalo

node "${CLAUDE_SKILL_DIR}/scripts/tree-check.mjs" sitemap-tree.txt

Informa sobre profundidad y anchura por rama, etiquetas que aparecen dos veces, nodos sin plantilla, nodos "Otros" o "Varios", y elementos por sección. Usa su resultado, no tu lectura del árbol. El código de salida 1 significa advertencias: corrige cada una, o escribe una línea en sitemap.md explicando por qué la excepción se mantiene. Pasa --items N cuando el árbol no tenga recuentos.

Luego manualmente: vuelve a contar las ubicaciones con los totales, verifica cualquier afirmación sobre la longitud de la ruta a través del árbol, y confirma que el bloque de código en sitemap.md coincide con el archivo.

Lo que Claude no puede hacer aquí

• Conocer la estrategia o política de la organización a menos que se le indique. El árbol es un borrador para reaccionar, y el humano es dueño de la decisión.
• Inventar tráfico, uso o investigación. Esto incluye palabras de frecuencia expresadas como hechos, como "usado todos los días". Di "probablemente" y enuméralo como una suposición.
• Realizar una prueba de árbol o un card sort con personas reales. Diséñalos, y analiza los resultados que el usuario traiga.
• Prometer lo que un CMS puede hacer. Di lo que esperarías, como rutas anidadas o filtrado por facetas, y dile al usuario que lo confirme, porque lo que admite una plataforma varía.

Dónde se entrega esto

Un mapa del sitio solo es decoración: nadie puede construir a partir de él sin reglas de URL, una especificación de navegación, un modelo de contenido y, para una reconstrucción, un plan de redirecciones.

• information-architecture: la puerta de entrada, cuando el trabajo abarca varios de estos.
• content-inventory: cuando nadie sabe qué existe todavía. card-sort: cuando las agrupaciones deberían venir de los usuarios.
• taxonomies: cuando el árbol necesita facetas o etiquetas diseñadas. labeling: para redactar los nombres de los nodos.
• navigation, url-structure y content-models: para convertir nodos en menús, direcciones y plantillas.
• redirect-maps: cuando algo se mueve.
• tree-tests: para validar el árbol antes de construirlo. findability: para medirlo después.
• design-os:create-sitemap: para escribir el árbol acordado como el archivo enlazado que las etapas de diseño posteriores leerán.