Agenti AI

biagiojs include materiale first-class per LLM e agenti di coding: indice curato, guida operativa completa nel pacchetto npm e documentazione strutturata per il retrieval.

Link rapidi

Risorsa	URL
llms.txt (indice sito)	/llms.txt
AI-GUIDE.md (riferimento completo)	GitHub
Documentazione	/it/docs/
Estensione VS Code	`biagiojs/extensions/vscode-biagio/` nel repo

Punta il tuo agente a https://biagio.danilosprovieri.com/llms.txt.

Modello mentale

biagiojs è SSG-first + islands, business-aware. I componenti dichiarano pesi business (conversion, seo, interaction, 0–1) e costi (cpu, network). La build decide piano idratazione, preload, SEO, consent e i18n.

Regola d'oro: statico è il default. Pagine senza isole → zero JavaScript in produzione.

Workflow agente

npx create-biagiojs mio-sito --template blog
cd mio-sito && npm install

Imposta site.baseUrl con l'URL di produzione reale.
Usa defineConfig da biagiojs/config in biagio.config.js.
Preferisci pages/*.page.biagio o biagio new page ….
Usa le tabelle in Pesi business — non inventare numeri.
Esegui biagio explain pages/index.page.biagio per feedback immediato.
Esegui biagio build . e leggi render order + hydration log.
Esegui biagio doctor . prima del deploy.

Comandi DX per agenti

Comando	Quando usarlo
`biagio new page blog/[slug]`	Nuova route con boilerplate `getStaticPaths`
`biagio new island counter`	Scaffold modulo client
`biagio new collection blog`	Collection Markdown + `content.config.js`
`biagio explain <page>`	Verifica eager/lazy/static senza build completo
`biagio doctor .`	Validazione pre-deploy inclusi link rotti

Riferimento pesi (non indovinare)

Tipo componente	conversion	seo	interaction
Hero / CTA principale	0.8–1.0	0.7–1.0	0.5–0.9
Scheda prodotto	0.6–0.9	0.5–0.8	0.3–0.6
Navigazione	0.1–0.3	0.2–0.5	0.4–0.7
Footer / legal	0.05–0.1	0.3–0.5	0.01–0.05
Widget chat	0.03–0.1	0.1	0.1–0.3

File da leggere per primi

Errori comuni

Idratare tutto — usa i pesi e biagio explain.
Saltare baseUrl — rompe canonical e sitemap.
Tracker senza data-cvw-consent o consent= sull'isola.
Google Fonts in produzione invece di site.fonts self-hosted.
Pubblicare bozze — usa draft: true (escluso in build produzione).