Esta web, construida con OpenSpec
Esta web se desarrolla con el flujo que enseña: cada cambio pasa por un change de OpenSpec antes de llegar a main. Esta página se genera al compilar el sitio a partir de la carpeta openspec/ del repositorio.
Changes archivados
El autor quiere una infografía-resumen de OpenSpec («mapa visual» del método) visible nada más entrar en la web y en el manual. La referencia visual (`docs/Desarrollo_guiado_por_especificaciones (1).png`, generada con IA) tiene el estilo deseado pero no es publicable: contiene rutas y comandos erróneos (`openspec/apecs/`, `ropax:archive`), una tabla ilegible, texto corrupto y un enfoque «.NET y Angular» ajeno al sitio. En una web que enseña OpenSpec, publicar comandos incorrectos resta credibilidad y contradice la regla de no inventar comandos.
En w13 el `design.md` (D2) fija que las animaciones de la terminal se reproducen una sola vez para no distraer ni gastar CPU, pero el cursor de la terminal parpadea en bucle infinito (`animation: blink 1s steps(1) infinite`). El spec se cumple con movimiento reducido, pero diseño y código se contradicen.
La landing `/` usa el hero y las tarjetas por defecto de Starlight. No transmite que el sitio trata de un flujo de trabajo en terminal con agentes ni da peso al ciclo `/opsx`. Se ha elegido la dirección **1a "Terminal en vivo"** de `docs/Diseño web OpenSpecs innovador/Landing Rediseño.dc.html`: hero a dos columnas con una terminal que "ejecuta" el ciclo, franja de cuatro pasos, frases numeradas y tarjetas de recorrido con uno recomendado.
El sitio enseña OpenSpec en 25 páginas repartidas en siete secciones. Hay lectores que quieren estudiarlo sin conexión, imprimirlo o compartirlo con su equipo como un único documento. Hoy la única forma es imprimir página a página desde el navegador, sin portada, sin índice y con el cromo de Starlight (sidebar, cabecera, buscador) en cada hoja.
La landing actual (`/`) es el placeholder splash de Starlight: un tagline y un único botón "Empieza aquí". No explica qué es OpenSpec, no muestra el ciclo `/opsx` y no orienta a los tres perfiles de lector (quien empieza, quien adopta en equipo, quien consulta). El objetivo de conversión del sitio es "Empieza en 30 minutos" (`/empieza/primer-cambio/`) y la landing no apunta ahí.
The four "Empieza" pages are placeholders ("Página en preparación"). They are the start of the main reading path (Landing → Qué es → Conceptos → Instalación → Primer cambio → Escribir specs) and the landing CTA already points at them, so the site cannot teach OpenSpec until they exist.
Las cinco páginas de Guías son marcadores ("Página en preparación"). `/guias/formato-de-specs/` es el destino del último "Siguiente paso" de Empieza (w05), así que el recorrido Inicio termina hoy en una página vacía. Sin Guías, el lector aprende a instalar OpenSpec pero no a escribir specs ni a usar el flujo `/opsx` con criterio.
Las seis páginas de Con tu agente y En equipo son marcadores ("Página en preparación"). `/agentes/claude-code/` es el destino del último "Siguiente paso" de Guías (w06), así que el recorrido termina hoy en una página vacía. Sin estas secciones, el lector sabe escribir specs pero no cómo configurar su agente ni cómo llevar OpenSpec a un equipo con backlog, CI y un plan de adopción.
Las cinco páginas de Referencia y `/recursos/` son marcadores ("Página en preparación"). Referencia es la entrada del recorrido "Consulta" de la landing y el destino del último "Siguiente paso" de En equipo (w07), así que hoy el lector termina en páginas vacías. Además, la KB se escribió para OpenSpec 1.13 y la CLI fijada es la 1.14.0: una referencia de comandos copiada de la KB enseñaría comandos y flags que ya no coinciden.
The site teaches OpenSpec but does not yet show its own OpenSpec history: `/como-se-hizo/` is a placeholder. Rendering the archived changes and current specs from the repository at build time turns the site itself into a living, always-current example of the workflow.
El sitio ya emite idioma, título, canónica y sitemap (spec `seo`), pero al compartir una URL no hay tarjeta enriquecida (Open Graph/Twitter), los buscadores no reciben datos estructurados (fecha de revisión, migas de pan) y no existe `robots.txt` que anuncie el sitemap. Además `description` no es obligatoria en las guías, así que nada impide publicar una página sin meta description o con una longitud inútil para el snippet.
El sitio aún no tiene un despliegue declarado: faltan cabeceras de seguridad, política de caché y previews por PR revisables. Desplegar pronto (orden recomendado 01 → 02 → 03 → 12) permite revisar cada change en un preview real de Vercel, como exige la Definition of Done.
El sitio sigue siendo la plantilla de Starlight (título "My Docs", sidebar de ejemplo, idioma inglés). Antes de escribir contenido (changes 03–09) hace falta una base estable: idioma, estructura de navegación con slugs definitivos, 404 propia y SEO base, verificada con tests E2E desde el primer día.
Hoy la CI solo valida specs y ejecuta `astro check` + build. No ejecuta ningún test (el script `test:e2e` existe pero no se lanza en el workflow), no comprueba enlaces rotos y no hay tests unitarios ni de accesibilidad. Los siguientes changes (w03–w12) añaden contenido y comportamiento en bloque; sin una puerta de calidad que falle de forma fiable, los errores llegarán a `main`.
Las guías enseñan una herramienta que cambia de versión con frecuencia. Sin metadatos tipados (versión de OpenSpec, fecha de revisión, nivel, duración) el lector no sabe si una página está vigente ni si es para él, y nada impide publicar una guía sin esos datos. Este change es prerrequisito de las secciones de contenido (05–08).