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

> Un AGENTS.md listo para usar para sitios estáticos de Astro que mantiene a los agentes de IA en la pila, evita la deriva SSR y hace cumplir las convenciones de colección de contenido.

**Type:** Rule  
**Tools:** Cursor, Claude Code, Codex, Windsurf  
**Stack:** Astro, TypeScript, Tailwind  
**Updated:** 2026-06-08

---

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.