El Hero: di en una frase qué haces y para quién

Piénsalo como una línea de montaje, no como una lista que atacas al azar. Cada estación le entrega a la siguiente lo que necesita: defines el alcance antes que el contenido, el contenido antes que los metadatos, el diseño antes que las imágenes. Si te saltas un paso, lo pagas al final —contenido sin estructura, diseño sin nada que vestir—.

El orden también cuida tu tiempo, que casi siempre es el recurso corto. Avanzar en secuencia significa tocar cada archivo una vez y seguir, en vez de regresar a arreglar lo que un paso anterior dejó a medias. Para cuando llegas a QA y deploy ya no hay sorpresas: es una revisión, no un rescate.

Cada tarjeta que ves aquí no se escribió a mano en la página: nace de un archivo Markdown en src/content/. Redactas el producto o servicio como una nota simple —título, descripción, imagen, precio si aplica— y el sitio arma la tarjeta por ti. Agregas un archivo y aparece; lo quitas y desaparece, sin tocar la página.

La ventaja es consistencia y tranquilidad: un esquema (Zod) revisa cada archivo antes de publicar, así un campo faltante o una ruta de imagen mal puesta detiene el build y te dice qué corregir —ninguna tarjeta rota llega al sitio—. Tú administras el catálogo como texto y el sistema se encarga del diseño: contenido y diseño separados, cada uno en su lugar.

Los metadatos son lo que tu página dice de sí misma antes de que alguien la abra: el título y la descripción que aparecen en una lista de resultados o cuando compartes el enlace. Aquí eliges tres palabras clave por orden de importancia y construyes ambos sobre ellas —el título arranca con la principal, sin la marca pegada, y la descripción abre con ella y teje las otras dos con naturalidad—.

El oficio está en la mesura: decirlo una vez, claro, para una persona que ojea una lista de opciones —no apilado ni repetido para «verse optimizado»—. La demo lo muestra de las dos formas, bien y mal, y la misma regla (metaAudit) marca sola la versión recargada. Unas buenas metas dan un empujón; el peso de verdad sigue en el contenido de la página.

Un sitio no es una página repetida: son unos pocos tipos de página, cada uno con su trabajo —la home presenta, la categoría lista, la ficha de producto o servicio vende el detalle, el artículo explica—. Nombrarlos desde el principio (home, categoría, ficha, artículo, directorio) te da el mapa de qué construir y en qué orden.

Cada tipo ya tiene su layout esperando en src/layouts/, hecho una vez y reutilizable: tú traes el contenido y el layout trae la estructura —header, espaciados y bloques en su sitio—. Así nunca rehaces el armazón página por página; solo lo llenas. La lista de abajo marca lo que ya está cableado y lo que viene después.