Innesti Digital
Il movimento di un orologio visto da vicino: ingranaggi dโ€™acciaio e, al centro, una pietra verde.

Il metodo

Sette regole per far lavorare agenti AI su codice e processi veri. Non dipendono da un linguaggio o da uno strumento: dicono dove mettere i limiti, e chi decide.

tutti i controlliprincipaleramounionenessuna scorciatoiatutti i controlliprincipaleramo

01

Controlli prima di tutto

Niente arriva al ramo principale senza passare dagli stessi controlli, nello stesso ordine.

Un cambiamento, scritto da una persona o da un agente, arriva al ramo principale solo dopo una serie fissa di controlli: test, tipi, dipendenze, complessitร , build. Lโ€™ordine รจ sempre lo stesso, dal piรน rapido al piรน lento, e il primo che fallisce ferma tutto. I controlli girano sul risultato giร  unito, non sul ramo da solo: cosรฌ si vede che cosa succederebbe davvero.

Nel caso Libretto
In Libretto sono quattordici passi, e il rilascio parte solo se la CI รจ verde. Vedi nel caso: Controlli prima di tutto
difetti: 48335limite 35483 โ†’ 35

02

Numeri che possono solo migliorare

I difetti si contano; il limite scende con loro e non risale.

Quando un progetto si porta dietro dei difetti (errori di tipo, codice inutilizzato, funzioni troppo complesse) non serve pretendere di azzerarli in un giorno. Si contano, e il conteggio diventa un limite: un cambiamento che lo supera si ferma, uno che lo abbassa abbassa anche il limite. Il numero puรฒ solo scendere.

Nel caso Libretto
In Libretto gli errori di tipo sono passati da 1.185 a 234 in due settimane. Vedi nel caso: Numeri che possono solo migliorare
copiadaticontrollocopia + dati

03

Agenti in corsie parallele

Ogni agente lavora nella sua copia, con i suoi dati; il lavoro si incontra solo al controllo.

Piรน agenti possono lavorare insieme se non si intralciano: ognuno ha la sua copia del codice e il suo database, e il lavoro si incontra solo ai controlli, uno alla volta. Se due cambiamenti si scontrano, lo si scopre lรฌ e non in produzione. Quanti lavori far girare insieme รจ una scelta esplicita, non un effetto collaterale.

Nel caso Libretto
In Libretto abbiamo fissato un massimo di tre lavori in parallelo. Vedi nel caso: Agenti in corsie parallele
rifiutatamodificacontrollorifiutatamodifica

04

Un controllo a ogni scrittura

Ogni modifica viene verificata prima di essere salvata; se non regge, non entra.

Ogni modifica a un dato con una struttura (una pagina, una configurazione, un modello) passa da una verifica prima di essere salvata. Se non rispetta le regole viene rifiutata con un motivo preciso, e non resta niente a metร . Vale per le modifiche fatte a mano e per quelle degli agenti, con le stesse regole.

Nel caso Libretto
In Libretto ogni scrittura di una pagina passa da un unico controllo dellโ€™albero. Vedi nel caso: Un controllo a ogni scrittura
modifica 1modifica 2modifica 3provaannullaapplicarevisioneprovaapplicarevisione

05

Prima la prova, poi lโ€™applicazione

Le modifiche si provano senza effetti; si applica solo quello che passa.

Un gruppo di modifiche si puรฒ provare senza effetti: la prova esegue tutti i controlli e poi annulla. Si applica solo quello che รจ passato, in una revisione che si puรฒ annullare. Un agente vede lโ€™esito prima di toccare qualcosa.

Nel caso Libretto
In Libretto un agente prova un lotto di operazioni con dry_run_ops prima di applicarlo con apply_ops. Vedi nel caso: Prima la prova, poi lโ€™applicazione
approvatorna indietropropostedecide una personapubblicaapprovadecideuna personaproposte

06

Una persona decide

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

Gli agenti scrivono, provano e propongono. Pubblicare, cancellare, cambiare una regola: queste decisioni restano a una persona, e gli strumenti lo rendono esplicito invece di lasciarlo alla buona volontร .

Nel caso Libretto
In Libretto un agente pubblica un sito solo dopo il via esplicito di una persona. Vedi nel caso: Una persona decide
agenteticketcorrezioneprodottoagenteticketcorrezioneprodotto

07

I problemi si segnalano

Quando un agente si blocca lo dice; la correzione torna nello strumento.

Quando uno strumento non permette di fare qualcosa, lโ€™agente non cerca una scorciatoia: apre un ticket con quello che manca. La correzione diventa una capacitร  dello strumento, per chiunque lo usi dopo.

Nel caso Libretto
In Libretto i ticket degli agenti arrivano a chi mantiene la piattaforma con report_issue. Vedi nel caso: I problemi si segnalano

Dove lโ€™abbiamo applicato

Il metodo รจ nato costruendo Libretto, un CMS scritto in gran parte da agenti AI. La pagina del caso ha i numeri.

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.