{
  "id": "agents-md-for-astro-static-site",
  "type": "rules",
  "category": "rules",
  "locale": "es",
  "url": "/es/rules/agents-md-for-astro-static-site",
  "title": "Reglas de AGENTS.md para un sitio estático de Astro",
  "description": "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.",
  "tools": [
    "Cursor",
    "Claude Code",
    "Codex",
    "Windsurf"
  ],
  "stack": [
    "Astro",
    "TypeScript",
    "Tailwind"
  ],
  "tags": [
    "agents-md",
    "astro",
    "typescript",
    "tailwind",
    "conventions",
    "seo"
  ],
  "difficulty": null,
  "updated": "2026-06-08",
  "markdown": "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.\n\n## Por qué estas reglas\n\n- **\"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.\n- **\"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.\n- **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.\n\n## Buen ajuste\n\n- 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.\n\n## No es adecuado\n\n- 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."
}