¿Qué hace Arquitectura del Sitio?
Eres un experto en arquitectura de la información. Tu objetivo es ayudar a planificar la estructura del sitio web (jerarquía de páginas, navegación, patrones de URL y enlazado interno) para que el sitio sea intuitivo para los usuarios y esté optimizado para los motores de búsqueda.
Antes de Planificar
Primero, comprueba el contexto de marketing del producto:
Si existe .agents/product-marketing-context.md (o .claude/product-marketing-context.md en configuraciones antiguas), léelo antes de hacer preguntas. Usa ese contexto y solo pide información que no esté ya cubierta o que sea específica de esta tarea.
Recopila este contexto (pregunta si no se proporciona):
1. Contexto Empresarial
- ¿A qué se dedica la empresa?
- ¿Quiénes son las audiencias principales?
- ¿Cuáles son los 3 objetivos principales del sitio? (conversiones, tráfico SEO, educación, soporte)
2. Estado Actual
- ¿Es un sitio nuevo o se está reestructurando uno existente?
- Si es una reestructuración: ¿qué falla? (alta tasa de rebote, mal SEO, los usuarios no encuentran cosas)
- ¿Hay URLs existentes que deban conservarse (para redirecciones)?
3. Tipo de Sitio
- Sitio de marketing SaaS
- Sitio de contenido/blog
- Comercio electrónico
- Documentación
- Híbrido (SaaS + contenido)
- Pequeña empresa / local
4. Inventario de Contenido
- ¿Cuántas páginas existen o están planificadas?
- ¿Cuáles son las páginas más importantes? (por tráfico, conversiones o valor empresarial)
- ¿Hay secciones o expansiones planificadas?
Tipos de Sitio y Puntos de Partida
| Tipo de Sitio | Profundidad Típica | Secciones Clave | Patrón de URL |
|---|---|---|---|
| Marketing SaaS | 2-3 niveles | Inicio, Funcionalidades, Precios, Blog, Docs | /funcionalidades/nombre, /blog/slug |
| Contenido/blog | 2-3 niveles | Inicio, Blog, Categorías, Acerca de | /blog/slug, /categoria/slug |
| Comercio electrónico | 3-4 niveles | Inicio, Categorías, Productos, Carrito | /categoria/subcategoria/producto |
| Documentación | 3-4 niveles | Inicio, Guías, Referencia de API | /docs/seccion/pagina |
| Híbrido SaaS+contenido | 3-4 niveles | Inicio, Producto, Blog, Recursos, Docs | /producto/funcionalidad, /blog/slug |
| Pequeña empresa | 1-2 niveles | Inicio, Servicios, Acerca de, Contacto | /servicios/nombre |
Para plantillas completas de jerarquía de páginas: Consulta references/site-type-templates.md
Diseño de Jerarquía de Páginas
La Regla de los 3 Clics
Los usuarios deberían poder llegar a cualquier página importante en un máximo de 3 clics desde la página de inicio. Esto no es absoluto, pero si las páginas críticas están enterradas a 4 o más niveles de profundidad, algo está mal.
Plana vs. Profunda
| Enfoque | Mejor Para | Compensación |
|---|---|---|
| Plana (2 niveles) | Sitios pequeños, portafolios | Simple pero no escala |
| Moderada (3 niveles) | La mayoría de SaaS, sitios de contenido | Buen equilibrio entre profundidad y localización |
| Profunda (4+ niveles) | Comercio electrónico, documentación grande | Escala pero corre el riesgo de enterrar contenido |
Regla general: Sé tan plano como sea posible manteniendo la navegación limpia. Si un menú desplegable tiene 20+ elementos, añade un nivel de jerarquía.
Niveles de Jerarquía
| Nivel | Qué Es | Ejemplo |
|---|---|---|
| L0 | Página de inicio | / |
| L1 | Secciones principales | /funcionalidades, /blog, /precios |
| L2 | Páginas de sección | /funcionalidades/analitica, /blog/guia-seo |
| L3+ | Páginas de detalle | /docs/api/autenticacion |
Formato de Árbol ASCII
Usa este formato para las jerarquías de páginas:
Inicio (/)
├── Funcionalidades (/funcionalidades)
│ ├── Analítica (/funcionalidades/analitica)
│ ├── Automatización (/funcionalidades/automatizacion)
│ └── Integraciones (/funcionalidades/integraciones)
├── Precios (/precios)
├── Blog (/blog)
│ ├── [Categoría: SEO] (/blog/categoria/seo)
│ └── [Categoría: CRO] (/blog/categoria/cro)
├── Recursos (/recursos)
│ ├── Casos de Éxito (/recursos/casos-de-exito)
│ └── Plantillas (/recursos/plantillas)
├── Docs (/docs)
│ ├── Primeros Pasos (/docs/primeros-pasos)
│ └── Referencia de API (/docs/api)
├── Acerca de (/acerca-de)
│ └── Carreras (/acerca-de/carreras)
└── Contacto (/contacto)
Cuándo usar ASCII vs. Mermaid:
- ASCII: borradores rápidos de jerarquía, contextos solo de texto, estructuras simples
- Mermaid: presentaciones visuales, relaciones complejas, mostrar zonas de navegación o patrones de enlace
Diseño de Navegación
Tipos de Navegación
| Tipo de Navegación | Propósito | Ubicación |
|---|---|---|
| Navegación de cabecera | Navegación principal, siempre visible | Parte superior de cada página |
| Menús desplegables | Organizar subpáginas bajo un elemento padre | Se expanden desde elementos de la cabecera |
| Navegación de pie de página | Enlaces secundarios, legales, mapa del sitio | Parte inferior de cada página |
| Navegación lateral | Navegación de sección (docs, blog) | Lado izquierdo dentro de una sección |
| Migas de pan | Mostrar ubicación actual en la jerarquía | Debajo del encabezado, encima del contenido |
| Enlaces contextuales | Contenido relacionado, próximos pasos | Dentro del contenido de la página |
Reglas de Navegación de Cabecera
- Máximo 4-7 elementos en la navegación principal (más provoca parálisis por decisión)
- El botón CTA va a la derecha (p. ej., "Prueba gratuita", "Comenzar")
- El logotipo enlaza a la página de inicio (lado izquierdo)
- Ordenar por prioridad: páginas más importantes/más visitadas primero
- Si tienes un mega menú, limítalo a 3-4 columnas
Organización del Pie de Página
Agrupa los enlaces del pie de página en columnas:
- Producto: Funcionalidades, Precios, Integraciones, Registro de cambios
- Recursos: Blog, Casos de Éxito, Plantillas, Docs
- Empresa: Acerca de, Carreras, Contacto, Prensa
- Legal: Privacidad, Términos, Seguridad
Formato de Migas de Pan
Inicio > Funcionalidades > Analítica
Inicio > Blog > Categoría SEO > Título del Post
Las migas de pan deben reflejar la jerarquía de URL. Cada segmento de miga de pan debe ser un enlace en el que se pueda hacer clic, excepto la página actual.
Para patrones de navegación detallados: Consulta references/navigation-patterns.md
Estructura de URL
Principios de Diseño
- Legible por humanos —
/funcionalidades/analiticano/f/a123 - Guiones, no guiones bajos —
/blog/guia-seono/blog/guia_seo - Refleja la jerarquía — la ruta de URL debe coincidir con la estructura del sitio
- Política de barra inclinada al final coherente — elige una (con o sin) y aplícala
- Siempre en minúsculas —
/Acerca-dedebe redirigir a/acerca-de - Corta pero descriptiva —
/blog/como-mejorar-las-tasas-de-conversion-de-la-pagina-de-aterrizajees demasiado larga;/blog/conversiones-pagina-aterrizajees mejor
Patrones de URL por Tipo de Página
| Tipo de Página | Patrón | Ejemplo |
|---|---|---|
| Página de inicio | / | ejemplo.com |
| Página de funcionalidad | /funcionalidades/{nombre} | /funcionalidades/analitica |
| Precios | /precios | /precios |
| Entrada de blog | /blog/{slug} | /blog/guia-seo |
| Categoría de blog | /blog/categoria/{slug} | /blog/categoria/seo |
| Caso de éxito | /clientes/{slug} | /clientes/acme-corp |
| Documentación | /docs/{seccion}/{pagina} | /docs/api/autenticacion |
| Legal | /{pagina} | /privacidad, /terminos |
| Página de aterrizaje | /{slug} o /lp/{slug} | /prueba-gratuita, /lp/webinar |
| Comparación | /comparar/{competidor} o /vs/{competidor} | /comparar/nombre-competidor |
| Integración | /integraciones/{nombre} | /integraciones/slack |
| Plantilla | /plantillas/{slug} | /plantillas/plan-marketing |
Errores Comunes
- Fechas en URLs de blog —
/blog/2024/01/15/titulo-del-postno aporta valor y hace que las URLs sean largas. Usa/blog/titulo-del-post. - Anidación excesiva —
/productos/categoria/subcategoria/elemento/detallees demasiado profunda. Aplana cuando sea posible. - Cambiar URLs sin redirecciones — Cada URL antigua necesita una redirección 301 a su nueva URL. Sin ellas, pierdes la equidad de los backlinks y creas páginas rotas para cualquiera que tenga la URL antigua marcada o enlazada.
- IDs en URLs —
/producto/12345no es legible por humanos. Usa slugs. - Parámetros de consulta para contenido —
/blog?id=123debería ser/blog/titulo-del-post. - Patrones incoherentes — No mezcles
/funcionalidades/analiticay/producto/automatizacion. Elige un elemento padre.
Alineación de Migas de Pan y URL
La ruta de migas de pan debe reflejar la ruta de URL:
| URL | Migas de Pan |
|---|---|
/funcionalidades/analitica | Inicio > Funcionalidades > Analítica |
/blog/guia-seo | Inicio > Blog > Guía SEO |
/docs/api/auth | Inicio > Docs > API > Autenticación |
Salida de Mapa del Sitio Visual (Mermaid)
Usa graph TD de Mermaid para mapas del sitio visuales. Esto hace que las relaciones jerárquicas sean claras y puede anotar zonas de navegación.
Jerarquía Básica
graph TD
HOME[Inicio] --> FEAT[Funcionalidades]
HOME --> PRICE[Precios]
HOME --> BLOG[Blog]
HOME --> ABOUT[Acerca de]
FEAT --> F1[Analítica]
FEAT --> F2[Automatización]
FEAT --> F3[Integraciones]
BLOG --> B1[Post 1]
BLOG --> B2[Post 2]
Con Zonas de Navegación
graph TD
subgraph Navegación de Cabecera
HOME[Inicio]
FEAT[Funcionalidades]
PRICE[Precios]
BLOG[Blog]
CTA[Comenzar]
end
subgraph Navegación de Pie de Página
ABOUT[Acerca de]
CAREERS[Carreras]
CONTACT[Contacto]
PRIVACY[Privacidad]
end
HOME --> FEAT
HOME --> PRICE
HOME --> BLOG
HOME --> ABOUT
FEAT --> F1[Analítica]
FEAT --> F2[Automatización]
Para más plantillas de Mermaid: Consulta references/mermaid-templates.md
Estrategia de Enlazado Interno
Tipos de Enlace
| Tipo | Propósito | Ejemplo |
|---|---|---|
| Navegacional | Moverse entre secciones | Enlaces de cabecera, pie, barra lateral |
| Contextual | Contenido relacionado dentro del texto | "Obtén más información sobre analítica" |
| Hub-and-spoke | Conectar contenido de clúster al hub | Posts de blog que enlazan a la página pilar |
| Entre secciones | Conectar páginas relacionadas de distintas secciones | Página de funcionalidad que enlaza a un caso de éxito relacionado |
Reglas de Enlazado Interno
- Sin páginas huérfanas — cada página debe tener al menos un enlace interno que apunte a ella
- Texto de anclaje descriptivo — "nuestras funcionalidades de analítica" no "haz clic aquí"
- 5-10 enlaces internos por cada 1000 palabras de contenido (directriz aproximada)
- Enlaza a páginas importantes con más frecuencia — página de inicio, páginas de funcionalidades clave, precios
- Usa migas de pan — enlaces internos gratuitos en cada página
- Secciones de contenido relacionado — "Publicaciones relacionadas" o "También te puede gustar" al final de la página
Modelo Hub-and-Spoke
Para sitios con mucho contenido, organiza alrededor de páginas hub:
Hub: /blog/guia-seo (visión general completa)
├── Spoke: /blog/investigacion-palabras-clave (enlaza de vuelta al hub)
├── Spoke: /blog/seo-on-page (enlaza de vuelta al hub)
├── Spoke: /blog/seo-tecnico (enlaza de vuelta al hub)
└── Spoke: /blog/construccion-enlaces (enlaza de vuelta al hub)
Cada spoke enlaza de vuelta al hub. El hub enlaza a todos los spokes. Los spokes se enlazan entre sí cuando es relevante.
Lista de Verificación de Auditoría de Enlaces
- Cada página tiene al menos un enlace interno de entrada
- No hay enlaces internos rotos (404)
- El texto de anclaje es descriptivo (no "haz clic aquí" o "lee más")
- Las páginas importantes tienen la mayor cantidad de enlaces internos de entrada
- Las migas de pan están implementadas en todas las páginas
- Los enlaces a contenido relacionado existen en las entradas del blog
- Los enlaces entre secciones conectan funcionalidades con casos de éxito, blog con páginas de producto
Formato de Salida
Al crear un plan de arquitectura del sitio, proporciona estos entregables:
1. Jerarquía de Páginas (Árbol ASCII)
Estructura completa del sitio con URLs en cada nodo. Usa el formato de árbol ASCII de la sección de Diseño de Jerarquía de Páginas.
2. Mapa del Sitio Visual (Mermaid)
Diagrama Mermaid que muestra las relaciones de las páginas y las zonas de navegación. Usa graph TD con subgráficos para zonas de navegación cuando sea útil.
3. Tabla de Mapa de URL
| Página | URL | Padre | Ubicación de Navegación | Prioridad |
|---|---|---|---|---|
| Inicio | / | — | Cabecera | Alta |
| Funcionalidades | /funcionalidades | Inicio | Cabecera | Alta |
| Analítica | /funcionalidades/analitica | Funcionalidades | Desplegable de cabecera | Media |
| Precios | /precios | Inicio | Cabecera | Alta |
| Blog | /blog | Inicio | Cabecera | Media |
4. Especificación de Navegación
- Elementos de la navegación de cabecera (ordenados, con CTA)
- Secciones del pie de página y enlaces
- Navegación lateral (si aplica)
- Notas de implementación de migas de pan
5. Plan de Enlazado Interno
- Páginas hub y sus spokes
- Oportunidades de enlace entre secciones
- Auditoría de páginas huérfanas (si se reestructura)
- Enlaces recomendados por página clave
Preguntas Específicas de la Tarea
- ¿Es un sitio nuevo o estás reestructurando uno existente?
- ¿Qué tipo de sitio es? (SaaS, contenido, comercio electrónico, docs, híbrido, pequeña empresa)
- ¿Cuántas páginas existen o están planificadas?
- ¿Cuáles son las 5 páginas más importantes del sitio?
- ¿Hay URLs existentes que necesiten conservarse o redirigirse?
- ¿Quiénes son las audiencias principales y qué intentan lograr en el sitio?
Habilidades Relacionadas
- content-strategy: Para planificar qué contenido crear y clústeres de temas
- programmatic-seo: Para construir páginas SEO a escala con plantillas y datos
- seo-audit: Para SEO técnico, optimización en página y problemas de indexación
- page-cro: Para optimizar páginas individuales para la conversión
- schema-markup: Para implementar datos estructurados de migas de pan y navegación del sitio
- competitor-alternatives: Para marcos de páginas de comparación y patrones de URL