Iterare progressivamente
In questa pagina
Sviluppo iterativo con l’IA
È tentante chiedere tutto in un unico prompt. Tuttavia, con grok-build-0.1, come con qualsiasi modello di codice, un approccio iterativo produce risultati migliori. Costruisci progressivamente, validando ogni passaggio prima di procedere al successivo.
Perché iterare?
I limiti di un singolo prompt
Un prompt che richiede la creazione di un sistema di autenticazione completo con JWT, token di aggiornamento, middleware, route, test e documentazione genererà un output voluminoso, difficile da verificare e probabilmente incompleto in alcune aree.
Il vantaggio dell’iterazione
Suddividere la stessa richiesta in passaggi modifica tre aspetti che si rafforzano a vicenda. Verifichi ogni step prima di continuare: un errore nelle fondamenta (una scelta sbagliata della struttura dati, una firma di funzione incerta) viene corretto quando costa solo cinque minuti, invece di propagarsi in tutto il codice generato successivamente. Aggiusti la rotta lungo il percorso: se la prima iterazione rivela un problema architetturale, lo affronti prima di andare oltre, esattamente come in una revisione del design. E mantieni il modello focalizzato: un prompt breve e mirato produce sistematicamente risposte migliori rispetto a una specifica dispersiva dove il modello deve arbitrare autonomamente tra dieci requisiti; ogni turno pone una sola domanda e il modello la risponde bene.
Strategia di iterazione
Passaggio 1: Le fondamenta
Inizia con la struttura di base, senza i dettagli:
“Crea lo schema della tabella users con Drizzle ORM: id, email, passwordHash, createdAt. Aggiungi i tipi TypeScript corrispondenti.”
Valida, testa e poi procedi.
Passaggio 2: Logica di business
Aggiungi la logica sulla base validata:
“Ora, crea il servizio di registrazione in @src/services/auth.ts. Deve hashare la password con bcrypt, verificare che l’email non esista già e inserire l’utente. Usa lo schema @src/db/schema.ts che abbiamo appena creato.”
Passaggio 3: Affinamento
Una volta implementata la logica, affinala:
“Aggiungi la validazione dell’input con Zod nel servizio di registrazione. L’email deve essere valida, la password deve avere almeno 8 caratteri con una lettera maiuscola e una cifra.”
Passaggio 4: Casi limite
Infine, gestisci i casi limite:
“Cosa succede se la connessione al database fallisce durante la registrazione? Aggiungi una gestione degli errori appropriata con messaggi chiari per l’utente.”
Riferimento agli errori precedenti
L’iterazione include anche l’apprendimento dagli errori. Se un suggerimento del modello non funziona, dillo esplicitamente:
“La soluzione precedente non funziona perché TypeORM non supporta questa sintassi nella versione 0.3. L’errore è: [incolla errore]. Proponi un’alternativa compatibile.”
Il modello usa queste informazioni per evitare di riprodurre lo stesso errore e per comprendere meglio il tuo ambiente.
Adeguamento del contesto lungo il percorso
L’iterazione ha un beneficio meno visibile ma altrettanto prezioso: il contesto si affina turno dopo turno. Scopri durante lo sviluppo che un file di configurazione guida il comportamento che stai modificando: aggiungilo nel turno successivo. Emerge un vincolo che non avevi identificato: il middleware deve gestire anche le chiavi API, non solo i JWT: specificalo quando diventa rilevante. Un’ipotesi iniziale si rivela falsa: correggila esplicitamente invece di lasciare che il modello continui a costruirci sopra. In un unico prompt monolitico, tutte queste scoperte arriverebbero troppo tardi.
“In realtà, il middleware di autenticazione deve gestire anche le chiavi API oltre ai JWT. Ecco il formato attuale della chiave in @src/config/api-keys.ts.”
Quando chiedere tutto in una volta
L’iterazione non è sempre necessaria. Per compiti semplici e ben definiti, un singolo prompt è sufficiente:
- Rinominare una variabile in tutto un file
- Convertire un callback in async/await
- Aggiungere tipi TypeScript a una funzione JavaScript esistente
- Generare un test unitario per una funzione pura
Punti chiave
- Suddividi le richieste complesse in passaggi validati progressivamente
- Ogni iterazione si basa sulla precedente dopo la verifica
- Fai riferimento agli errori precedenti per evitare ripetizioni
- Adegua il contesto man mano che fai nuove scoperte
- I compiti semplici non richiedono iterazione