Reglas de AGENTS.md para un sitio estático de Astro

Coloca esto en la raíz de tu repositorio como AGENTS.md. Los agentes orientados a Astro (Cursor, Claude Code, Codex) lo leen automáticamente al inicio y lo usan para mantenerse dentro de las convenciones en cada sesión de generación de código.

Por qué estas reglas

• “Nunca cambiar la salida a servidor” es la regla de mayor impacto para sitios estáticos de Astro. Los agentes que descubren una función faltante a menudo sugieren agregar un adaptador SSR como solución rápida — esto cambia silenciosamente el destino de implementación, rompe el almacenamiento en caché de CDN y agrega latencia de inicio en frío. La regla obliga a los agentes a resolver problemas dentro del paradigma estático.
• “Las imágenes deben pasar por <Image />” elimina el error de IA más común en sitios de contenido: etiquetas <img> desnudas que perjudican Core Web Vitals. El pipeline de imágenes de Astro maneja la conversión de formato, srcset responsive y carga diferida automáticamente — los agentes lo omiten a menos que se les indique explícitamente lo contrario.
• La validación de frontmatter con Zod detecta discrepancias de esquema en tiempo de verificación de tipos en lugar de en tiempo de compilación o, peor, renderizando datos incorrectos silenciosamente. Los agentes que escriben archivos markdown a menudo alucinan nombres de campos de frontmatter.

Buen ajuste

• Sitios de marketing, blogs, sitios de documentación y sitios de contenido centrados en SEO construidos en Astro con un destino de salida estática fijo.

No es adecuado

• Proyectos de Astro que usan output: "server" o "hybrid" con un adaptador edge/SSR — esos necesitan un conjunto de reglas diferente que permita client:load y patrones de obtención de datos del lado del servidor.