Creare con l’IA

Gli editor con IA e gli agenti di programmazione spesso tirano a indovinare su sitelo — ricorrono a schemi di React, Next o Astro che qui non valgono. Questa guida mostra come indirizzarli alla documentazione aggiornata di sitelo e mantenere il codice generato in linea con il modello.

Skill per agenti

sitelo include due Agent Skills: istruzioni che un agente di programmazione carica solo quando un compito ne ha bisogno. La CLI skills le installa nel tuo progetto per Claude Code, Cursor, Codex e gli altri agenti che supporta:

npx skills add Paul-Browne/sitelo

Aggiungi --skill sitelo-ui per installarne solo una, oppure -g per installarle in tutti i tuoi progetti. Una skill vive nel progetto, quindi l’agente la trova senza che tu debba indicargli un URL.

llms.txt

sitelo pubblica un riassunto del framework leggibile dalle macchine su sitelo.dev/llms.txt. Molti agenti sanno scaricare un URL; chiedi al tuo di leggere quel file (e la documentazione per umani) prima di scrivere codice sitelo.

A differenza di un server MCP per la documentazione, llms.txt non richiede installazioni — incolla l’URL nella chat, aggiungilo alle regole di progetto, oppure lascia che sia l’agente a scaricarlo.

Regole di progetto

Se il tuo strumento supporta istruzioni persistenti (AGENTS.md, regole di Cursor, istruzioni di Copilot, …), aggiungi una breve regola su sitelo così ogni sessione parte con il modello mentale giusto. L’esempio di base contiene un AGENTS.md che puoi copiare:

# sitelo

This project uses [sitelo](https://sitelo.dev) — a Vite-powered static site generator.

## Rules

- Pages are modules under `src/` with extensions like `.ht.js` / `.ht.ts` / `.ht.jsx` that **export a default function (or string) returning HTML**.
- Do **not** introduce React, Next.js, Astro, or a component/hydration framework unless the user explicitly asks.
- Routing is file-based: `about.ht.js` → `/about`, `[slug].ht.js` → dynamic (use `generateStaticParams` for `sitelo build`).
- Load data with `export async function data(ctx)`. Use `fetchWithCache` from `sitelo` for cached HTTP. Read local JSON with `readJson` / `readJsonCollection` from `sitelo/data`.
- Only JS/CSS referenced from HTML is bundled into `dist/`. Keep server-only code unreferenced so it never ships.
- Config lives in `sitelo.config.js`. Put Vite options under `vite`.
- Commands: `sitelo` (dev), `sitelo build`, `sitelo preview`.
- For current APIs, read https://sitelo.dev/llms.txt and https://sitelo.dev/docs — do not invent APIs from other frameworks.
- Prefer [javascript-to-html](https://ht.js.org) (`ht.js`) for markup: tag functions that return HTML strings. Docs: https://ht.js.org

Cursor

Crea .cursor/rules/sitelo.mdc nel tuo progetto (oppure incolla lo stesso testo nell’interfaccia delle regole di progetto di Cursor):

---
description: sitelo static site conventions
alwaysApply: true
---

# sitelo

Pages are `.ht.js` (etc.) modules that return HTML strings — not React/Next/Astro components.
Prefer javascript-to-html (https://ht.js.org) for markup. Use file-based routing, `data()`, and `sitelo build`.
Prefer https://sitelo.dev/llms.txt for sitelo APIs.

Consigli per lavorare su sitelo con l’IA

Primi passi · Esempio di base · llms.txt