Coerenza del codice AI:un pattern, 633 servizi

La coerenza del codice AI nasce dal costruire un unico pattern master e far sì che l'AI lo copi, senza mai lasciarle inventare due volte un approccio nuovo. Una piattaforma reale l'ha dimostrato su larga scala: 633 servizi, ognuno copia identica di un'unica fondazione di 305 righe, ognuno costruito dall'AI. La ripetizione, non la novità, è il superpotere.

Se non sei tecnico, questa potrebbe essere la lezione più controintuitiva del costruire con l'aiuto dell'AI. Siamo abituati a pensare che la creatività sia la parte di valore. Nel software è vero il contrario: i codebase più preziosi sono i più noiosi. Ecco la storia, con i concetti sollevati sopra il codice.

L'errore che stava per accadere

Gennaio 2025. Il database di FIKR Space è progettato: 964 tabelle, multi-tenant fin dal primo giorno. Ora servono i servizi. Tanti servizi.

L'AI costruisce il primo. Funziona. Ottimo. L'AI costruisce il secondo, e usa un pattern diverso. Gestione degli errori diversa, modo diverso di interrogare il database. Il terzo servizio? Ancora un altro pattern.

Stop. Perché la matematica di quella traiettoria è brutale: se continui così, al centesimo servizio hai 100 pattern diversi. Ogni bug viene corretto in 100 modi diversi. Il refactoring diventa impossibile. La coerenza diventa un sogno.

Non è l'AI che si comporta male. Se chiedi all'AI di costruire qualcosa da zero, genererà una soluzione perfettamente ragionevole, nella media di internet, e una soluzione diversa, altrettanto ragionevole, ogni volta. L'AI è un'improvvisatrice brillante, e l'improvvisazione è esattamente ciò che un codebase non può sopportare. Se non la gestisci, è così che scivoli nella trappola del vibe coding.

Cos'è davvero un servizio (senza bisogno di codice)

Una rapida traduzione per i lettori non tecnici. Un servizio è il livello tra il tuo database e le tue schermate. Quando un utente clicca “salva”, un servizio verifica che ne abbia il permesso, scrive i dati nel posto giusto, registra chi l'ha fatto e risponde: successo o un errore utile.

Se il database è le fondamenta del tuo prodotto e le schermate sono la sua faccia, i servizi sono il sistema nervoso: ogni segnale passa da loro. Ogni funzionalità del tuo prodotto ne ha bisogno di uno, ed è così che una piattaforma seria finisce per averne centinaia. E ogni servizio deve rispondere alle stesse cinque domande: questo utente può farlo? Di quale cliente sono questi dati? Cosa succede se qualcosa fallisce? Questa azione va registrata nel log? L'input è sicuro?

Cinque domande, centinaia di servizi. Quella ripetizione è il tuo rischio più grande o il tuo patrimonio più grande, a seconda di una decisione.

Coerenza del codice AI: la mossa del pattern master

La decisione: smettere di costruire servizi e costruire prima il pattern. Un'unica fondazione, 305 righe di codice, che risponde una volta sola a tutte e cinque le domande. Gestione degli errori. Filtro multi-tenancy, così ogni cliente vede solo i propri dati. Controllo dei permessi. Audit logging. Sanificazione dell'input. Ogni risposta conquistata a fatica, codificata una sola volta.

Poi, una regola scritta in ogni blueprint di funzionalità consegnato all'AI: ogni servizio estende la fondazione. Nessuna eccezione. (Quei blueprint sono PRP; la meccanica è in il metodo PRP.)

Da quel momento l'AI ha smesso di improvvisare e ha iniziato a replicare. Chiedi un nuovo servizio e copia lo scheletro collaudato, riempie i dettagli specifici ed eredita gratis tutte le proprietà di sicurezza. Il primo servizio ha richiesto circa 2 ore, il tempo per costruire bene la fondazione. Ciascuno dei 632 successivi ne ha richiesti 15–30 minuti. Sull'intera piattaforma, sono circa 800 ore risparmiate rispetto al costruire ognuno da zero.

Il libroThe Solopreneur RevolutionLuis Gonçalves su come costruire un'attività da solopreneur con l'IA mentre sei ancora dipendente.Scopri il libro →

Una modifica, 633 aggiornamenti

Il vantaggio composto arriva dopo. Quando l'audit logging è stato aggiunto alla fondazione, tutti i 633 servizi l'hanno ottenuto, all'istante. Quando i messaggi di errore sono stati sanificati per motivi di sicurezza, tutti i 633 servizi l'hanno ottenuto. Quando la gestione delle query è migliorata, tutti i 633 servizi l'hanno ottenuta. Una modifica, 633 aggiornamenti, zero modifiche manuali.

Questo suggerisce un test semplice per capire se la tua architettura funziona. Chiamalo il test di scala: se puoi aggiungere una capacità alla tua fondazione e ogni servizio la eredita subito, hai avuto successo. Se dovessi aggiornare 633 file a mano, hai fallito. Il test funziona altrettanto bene con 6 servizi come con 633; l'unica differenza è quanto fa male scoprire la risposta in ritardo.

Perché la ripetizione è il superpotere

I numeri dietro l'argomento "noioso è bello":

Guarda quella riga del più piccolo/più grande. Il servizio più semplice ha 87 righe; il più complesso gestisce l'intero flusso di un'operazione di investimento in 2.214 righe. Compiti enormemente diversi, scheletro identico. La complessità varia; il pattern mai.

Ecco il concetto da portarti a casa: l'AI è una replicatrice perfetta. Qualunque cosa le dai come riferimento, la riprodurrà fedelmente e instancabilmente, il che significa che la leva sta tutta in ciò che rendi degno di essere replicato. Fai bene un solo pattern, una volta, e l'AI lo stamperà centinaia di volte senza stanchezza, ego o scorciatoie. Se prima non fai bene nulla, l'AI replicherà volentieri il caos. La stessa logica guida l'anatomia del prompt di produzione: punta l'AI sul tuo miglior lavoro esistente e lascia che copi.

La creatività appartiene al tuo prodotto, al tuo posizionamento, alla tua offerta. Il tuo codebase dovrebbe essere la cosa meno creativa che possiedi.

12 settimaneLa carriera aziendale non è mai stata il pianoCandidati al Solopreneur Accelerator.Candidati ora →

Domande frequenti

Cos'è un livello di servizi, in parole semplici?

È il livello intermedio del tuo prodotto: il codice che sta tra il database (dove vivono i dati) e l'interfaccia (ciò che vedono gli utenti). Ogni azione significativa (salvare, recuperare, eliminare, controllare i permessi) passa da un servizio. Ecco perché lì la coerenza conta più che altrove.

Mi servono 633 servizi?

No: quel numero riflette una grande piattaforma multi-prodotto. Ma il principio vale già dal tuo quinto servizio. La trappola del pattern-diverso-ogni-volta comincia dal secondo servizio, e il costo di correggere l'incoerenza cresce a ogni servizio che aggiungi. Costruisci la fondazione prima di costruire la folla.

Come faccio seguire all'AI il mio pattern ogni volta?

Due mosse. Primo, crea la fondazione come file reale nel tuo prodotto, non come idea nella tua testa. Secondo, richiamala esplicitamente in ogni blueprint di funzionalità con una regola senza eccezioni. L'AI segue gli esempi molto meglio delle descrizioni: la meccanica per puntare l'AI su file di riferimento è trattata in anatomia del prompt di produzione.

Cosa succede se salto il pattern master?

Dieci servizi dopo, avrai dieci pattern diversi: dieci stili di gestione degli errori, dieci approcci alla sicurezza, dieci modi di parlare con il database. Ogni correzione va riscoperta per servizio, e una pulizia seria significa alla fine riscrivere gran parte del tuo prodotto. È la versione strutturale della trappola del vibe coding: progressi rapidi adesso, pagati con gli interessi dopo.