# AGENTS.md

Instrucciones para agentes de IA (Claude Code, Cursor, GitHub Copilot, Codex, etc.) que trabajen sobre este proyecto exportado. Este directorio es un **export estático de páginas** hecho desde un CMS [educ.pe](https://educ.pe): cada archivo `.html` es una página independiente y autocontenida.

## Estructura del proyecto

- `home.html` — página principal (home). Corresponde a la página con slug `home` en el CMS, la que se muestra en la raíz del dominio.
- `*.html` — el resto de páginas. El nombre del archivo es el **slug** de la página (sin extensión).
- `server.js` — servidor local de desarrollo. **No lo modifiques** salvo que se pida explícitamente: está pensado para resolver rutas sin extensión `.html` (p. ej. `/contacto` sirve `contacto.html`), y `home.html` como raíz y como índice de carpetas.
- `README.md` — instrucciones para levantar el servidor local (`http-server` o `nodemon server.js`). Consúltalo antes de sugerir otra forma de correr el proyecto.

## Convenciones de enlaces internos

- Los enlaces entre páginas deben escribirse **sin la extensión `.html`** (ej. `href="/contacto"`, no `href="/contacto.html"`), ya que `server.js` la agrega automáticamente. Esto también es el comportamiento esperado si estas páginas se vuelven a publicar en el CMS de origen.
- El enlace a la página principal es `/`, no `/home` ni `/home.html`.

## Convención de nombres de archivo (importante si estas páginas se re-suben al CMS)

Si vas a crear una página nueva, nómbrala como un slug válido para que se pueda reimportar sin problemas:

- Solo minúsculas, números y guiones (`-`), sin espacios ni acentos. Ej: `sobre-nosotros.html`, `precios.html`.
- `home.html` es el nombre reservado para la página principal (se importa con el slug `home`).
- Evita estos nombres, están reservados por el CMS y se omiten al reimportar: `api`, `dashboard`, `admin`, `login`, `logout`, `register`, `password`, `reset-password`, `verify-email`, `two-factor`, `user`, `users`, `settings`, `profile`, `search`, `sitemap`, `feed`, `rss`.

## Stack y estándares al crear o editar páginas

Cada `.html` debe seguir siendo **una hoja única, autocontenida y funcional por sí sola** (sin build step, sin dependencias locales de CSS/JS):

- **Tailwind CSS 4 vía CDN**: `<script src="https://cdn.jsdelivr.net/npm/@tailwindcss/browser@4"></script>`
- Los colores del sitio se definen con la directiva `@theme` dentro de un `<style type="text/tailwindcss">`, nunca con CSS suelto ni `style=""` inline:

  ```html
  <style type="text/tailwindcss">
    @theme {
      --color-primary: #TU_COLOR;
      --color-secondary: #TU_COLOR;
      --color-accent: #TU_COLOR;
      --color-another: #OTRO_COLOR;
      /*...otros colores o variables si es necesario */
    }
  </style>
  ```

  Reutiliza los mismos `--color-*` que ya estén definidos en las páginas existentes del sitio para mantener consistencia visual entre páginas — no inventes una paleta nueva por archivo.
- HTML semántico (`<header>`, `<nav>`, `<main>`, `<section>`, `<article>`, `<footer>`), mobile-first, responsive con los breakpoints estándar de Tailwind (`sm`, `md`, `lg`, `xl`).
- Solo clases de Tailwind para estilos; nada de CSS o JS externo local. Librerías adicionales (iconos, fuentes, animaciones) solo vía CDN.
- Accesibilidad: contraste mínimo WCAG AA, `alt` descriptivo en imágenes, foco visible (`focus:outline focus:ring-2`), jerarquía de encabezados lógica (`h1` → `h2` → `h3`).
- Estados interactivos con transición suave: `hover:`, `focus:`, `active:`, `transition duration-300`.

Guía completa de referencia (estructura de secciones, checklist, tips): ver la documentación del CMS sobre generación de landing pages, la misma que sigue este export.

## Qué NO hacer

- No agregues un bundler, framework o dependencias de Node más allá de las ya usadas por `server.js`.
- No cambies `server.js` para servir archivos con extensión `.html` en los enlaces — rompe la convención de rutas del CMS de origen.
- No agregues hojas de estilo o scripts externos que no sean CDN.
- No renombres `home.html` ni le agregues una copia con el slug real de la home.