Crear con IA

Los editores con IA y los agentes de programación suelen equivocarse con sitelo: recurren a patrones de React, Next o Astro que aquí no aplican. Esta guía explica cómo apuntarlos a la documentación actual de sitelo y mantener el código generado dentro del modelo correcto.

llms.txt

sitelo publica un resumen del framework legible por máquinas en sitelo.dev/llms.txt. Muchos agentes pueden descargar una URL; pídele al tuyo que lea ese archivo (y la documentación para humanos) antes de escribir código de sitelo.

https://sitelo.dev/llms.txt — API y convenciones en formato compacto
https://sitelo.dev/es/docs — guías completas
README en GitHub — modelo mental y resumen de funcionalidades
https://ht.js.org — documentación de javascript-to-html (recomendado para escribir HTML en JS)

A diferencia de un servidor MCP de documentación, llms.txt no necesita instalación: pega la URL en el chat, añádela a las reglas del proyecto, o deja que el agente la descargue.

Reglas de proyecto

Si tu herramienta admite instrucciones persistentes (AGENTS.md, reglas de Cursor, instrucciones de Copilot, …), añade una regla breve sobre sitelo para que cada sesión arranque con el modelo mental correcto. El ejemplo básico incluye un AGENTS.md que puedes copiar:

# sitelo

Este proyecto usa [sitelo](https://sitelo.dev) — un generador de sitios estáticos basado en Vite.

## Reglas

- Las páginas son módulos dentro de `src/` con extensiones como `.ht.js` / `.ht.ts` / `.ht.jsx` que **exportan por defecto una función (o cadena) que devuelve HTML**.
- **No** introduzcas React, Next.js, Astro ni ningún framework de componentes o hidratación salvo que el usuario lo pida explícitamente.
- El enrutado se basa en archivos: `about.ht.js` → `/about`, `[slug].ht.js` → dinámica (usa `generateStaticParams` para `sitelo build`).
- Carga datos con `export async function data(ctx)`. Usa `fetchWithCache` de `sitelo` para HTTP cacheado. Lee JSON local con `readJson` / `readJsonCollection` de `sitelo/data`.
- Solo el JS/CSS referenciado desde el HTML se empaqueta en `dist/`. Deja el código de servidor sin referenciar para que nunca se publique.
- La configuración vive en `sitelo.config.js`. Pon las opciones de Vite bajo `vite`.
- Comandos: `sitelo` (dev), `sitelo build`, `sitelo preview`.
- Para las APIs actuales, lee https://sitelo.dev/llms.txt y https://sitelo.dev/docs — no inventes APIs de otros frameworks.
- Prefiere [javascript-to-html](https://ht.js.org) (`ht.js`) para el marcado: funciones de etiqueta que devuelven cadenas HTML. Docs: https://ht.js.org

Cursor

Crea .cursor/rules/sitelo.mdc en tu proyecto (o pega el mismo texto en la interfaz de reglas de proyecto de Cursor):

---
description: convenciones de sitios estáticos con sitelo
alwaysApply: true
---

# sitelo

Las páginas son módulos `.ht.js` (etc.) que devuelven cadenas HTML — no componentes de React/Next/Astro.
Prefiere javascript-to-html (https://ht.js.org) para el marcado. Usa enrutado por archivos, `data()` y `sitelo build`.
Consulta https://sitelo.dev/llms.txt para las APIs de sitelo.

Consejos para trabajar en sitelo con IA

Parte de una plantilla — pídele al agente que genere el andamiaje a partir de examples/basic o examples/wordpress en lugar de inventarse un framework.
Prefiere javascript-to-html (ht.js) para el marcado: funciones de etiqueta que devuelven cadenas HTML, sin motor de plantillas ni React. Apunta a los agentes a ht.js.org para que no se inventen árboles de componentes JSX.
Las páginas son funciones que devuelven HTML — export default () => `<html>…</html>` o compuestas con javascript-to-html. JSX está bien mientras compile a cadenas; no hace falta un runtime de React.
Usa la CLI de sitelo — sitelo / sitelo build — y no vite directamente, salvo que sepas que necesitas una configuración de Vite propia.
Verifica las APIs contra llms.txt — sobre todo generateStaticParams, fetchWithCache y las islas de servidor.
Cero JS por defecto: enlaza un <script> solo cuando la página necesite código de cliente; los módulos sin referenciar se quedan en el servidor.
Revisa y ejecuta — siempre sitelo build (o el servidor de desarrollo) después de que el agente edite páginas; trata el marcado generado como un borrador.

Primeros pasos · Ejemplo básico · llms.txt