Innesti Digital

Caso

Libretto

Un CMS per studi di design e i loro clienti, che abbiamo costruito con agenti AI. È la prova del metodo: qui ci sono i numeri.

La pagina iniziale di librettocms.com

La pagina iniziale di librettocms.com, il 27 ottobre 2026. librettocms.com

Che cos’è

Libretto è un sistema per costruire siti in un editor visuale, sopra il sistema di design di ciascun sito: colori, caratteri, spazi e componenti sono parametri del sito. Il movimento si mette in scena con GSAP, i testi si pubblicano in ogni lingua del sito, e il cliente modifica parole e immagini senza toccare il design. Gli agenti lo usano in due modi: ne scrivono il codice e, attraverso un’interfaccia MCP, costruiscono e modificano siti.

Come è cresciuto

Il primo commit è del 21 aprile 2026. Il lavoro non è andato a velocità costante: 662 commit ad aprile, 90 a giugno, 2.197 a ottobre, più di tutti i mesi precedenti messi insieme. Su 3.665 commit, 2.642 portano la firma di un agente AI come coautore.

Gli errori di tipo, a ogni gradino del cricchetto

1.185errori di tipo il 6 ottobre 2026
234il 20 ottobre
Errori di tipo in Libretto, applicazione più test, dal 6 al 20 ottobre 2026: da 1.185 a 234, meno 80 per cento. Limite in CI 220.

Errori di tipo in Libretto, applicazione più test, a ogni gradino del cricchetto. La linea tratteggiata è il limite in CI oggi: 220 (100 applicazione e 120 test). Può solo scendere.

Fonte commento del cricchetto in .github/workflows/ci.yml

Il cricchetto

35

25 ott · catalogue trim

Problemi knip a ogni gradino del cricchetto, dal 6 al 25 ottobre 2026: da 483 a 35.

Problemi segnalati da knip: file, export e dipendenze che nessuno usa. Il limite in CI scende insieme al numero; un push che lo supera si ferma.

Fonte commento del cricchetto in .github/workflows/ci.yml

tutti i controlliprincipaleramounionenessuna scorciatoiatutti i controlliprincipaleramo

Il cancello davanti a main

Sul piano gratuito di GitHub il repository privato di Libretto non può proteggere il ramo principale. Il cancello è uno script: unisce il ramo a main in una copia dedicata, con il suo database, ed esegue gli stessi quattordici passi della CI, dal più rapido al più lento. Solo se passano tutti, main si muove.

  1. install
  2. generate
  3. contratti delle operazioni
  4. documenti di riferimento
  5. confini tra livelli
  6. knip
  7. complessità
  8. typecheck app
  9. typecheck test
  10. seed del database
  11. unit
  12. integration
  13. build
  14. budget del bundle pubblico
changesunitunit-reportintegrationqualitypublic-bundlemutationci gatedeployneeds: 7 jobci gate7 jobdeploy

I sette job della CI

Ogni push esegue questi sette job; un ultimo controllo fallisce se uno solo è rosso, e il rilascio aspetta quel controllo.

  • changes
  • unit
  • unit-report
  • integration
  • quality
  • public-bundle
  • mutation

Altri limiti

copiadaticontrollocopia + dati

Corsie parallele

Più agenti al lavoro, ognuno con la sua copia e il suo database.

git worktree; scripts/merge-gate.mjs (una copia per il cancello, con il suo database)

rifiutatamodificacontrollorifiutatamodifica

Albero controllato

Ogni scrittura passa da validateTree, o viene rifiutata.

validateTree, su ogni scrittura dell’albero (I1-I14)

modifica 1modifica 2modifica 3provaannullaapplicarevisioneprovaapplicarevisione

Prova, poi applica

Un lotto di operazioni si prova senza scrivere, poi si applica.

docs/architecture/mcp.md: dry_run_ops, apply_ops

adminthemessharedserver17 regole · 0 eccezioniadminthemessharedserver17 regole · 0 eccezioni

Confini tra livelli

Certe dipendenze non si possono scrivere.

.dependency-cruiser.cjs (17 regole), .dependency-cruiser-known-violations.json (0)

Aa12721AA 4,5:12,43:1 rifiutatoAa121AA 4,5:12,43:1 rifiutato

Contrasto AA

Un colore che non regge 4,5:1 non si salva.

docs/design/design-system-section.md, Contrast

approvatorna indietropropostedecide una personapubblicaapprovadecideuna personaproposte

Una persona decide

Gli agenti propongono; le scelte che contano restano a una persona.

plugin di Libretto: publication.publish solo con il via esplicito di una persona

agenteticketcorrezioneprodottoagenteticketcorrezioneprodotto

Ciclo dei ticket

Quando un agente si blocca, apre un ticket; la correzione torna nel prodotto.

MCP di Libretto: report_issue

I numeri

Commit al giorno, dal 6 al 27 ottobre 2026

Commit al giorno in Libretto dal 6 al 27 ottobre 2026; picco di 274 il 25 ottobre. Il 27 è parziale.
6 ott27 ott

Picco: 274 commit il 25 ottobre. Il 27 è parziale.

Fonte git log

  • commit dal 21 aprile 2026, in 75 giorni di lavoro
    3.665
  • commit con un agente AI come coautore
    2.642
  • passi prima che il ramo principale si muova
    14
  • job nel controllo della CI
    7
  • regole sui confini tra livelli, 0 eccezioni
    17
  • accessibilità Lighthouse richiesta al sito e alla documentazione di Libretto
    100

Le funzioni sopra complessità 15 sono contate dal 25 ottobre: erano 149, sono 143.

Se qualcosa qui vi è utile e vi serve una mano per farlo vostro, ci trovate a info@innestidigital.it. Se no, va bene lo stesso.