Freebuff in pratica: leggere il codice scritto da un agente prima del merge

Una suite di test verde non è una revisione

I test verificano i casi a cui qualcuno ha pensato. Un agente che cambia il comportamento può lasciare tutti i test verdi, perché verificavano il vecchio comportamento solo in modo vago o perché nessun test copriva quel percorso. Il verde dimostra che la modifica gira, non che sia corretta.

Lo stesso vale per un riassunto ordinato: la descrizione di ciò che l’agente ha fatto è un’affermazione dello stesso sistema che ha fatto la modifica. Leggi il diff, non la nota di copertura, e tratta i test come un segnale tra gli altri.

Parti da uno stato pulito e reversibile

Prima del primo prompt: committa o metti da parte il lavoro, crea un branch e sappi esattamente come tornare indietro. Un agente con accesso al terminale può eseguire migrazioni, riscrivere configurazioni e cancellare file; un punto di partenza reversibile trasforma un incidente in un fastidio.

Se l’attività tocca qualcosa di regolamentato o riservato, usa una copia usa e getta del progetto e una conversazione senza segreti. I termini e la documentazione sui dati del fornitore decidono cosa lascia la tua macchina: leggili invece di dare per scontato il confine.

Leggi il diff nell’ordine in cui fa male

Una modifica generata e grande si rivede meglio in un ordine scelto che dall’alto in basso.

• Punti di ingresso: rotte, handler, permessi e tutto ciò che cambia chi arriva a cosa.
• Dati: schema, migrazioni, serializzazione e query, soprattutto ciò che cancella o riscrive.
• Configurazione: variabili d’ambiente, passaggi di build, CI e impostazioni di deploy.
• Il resto: nomi, struttura, duplicazione e i ritocchi cosmetici che gonfiano il diff.

Poi leggi i test aggiunti e chiediti cosa non coprono. Un agente che ha scritto sia codice sia test può registrare due volte lo stesso fraintendimento.

Dipendenze, segreti e le righe che nessuno legge

Le nuove dipendenze sono il rischio più silenzioso di una patch generata: un nome di pacchetto familiare, una versione saltata fuori dal nulla, un lockfile riscritto in blocco. Controlla cosa è stato aggiunto, perché e se il progetto aveva già qualcosa che bastava.

Cerca credenziali, token e URL interne che non dovrebbero finire in un commit, e verifica che i log non stampino dati dei clienti. Sono le righe che si scorrono veloci, e proprio quelle per cui un agente non ha motivo di essere prudente: ottimizza per la richiesta, non per il tuo modello di minaccia.

Quando buttare tutto

Se il diff è più grande del compito, se non riesci a spiegare un blocco senza indovinare, o se la modifica cura il sintomo e non la causa, elimina il branch. Ricominciare con una richiesta più stretta costa meno che mantenere codice che nessuno capisce.

La stessa regola vale per il prompt: la lista di revisione nella nostra guida a Manus e i consigli di struttura nella nostra guida a Prompt Cowboy accorciano entrambi il diff. Per il prodotto, parti dalla nostra panoramica su Freebuff, e come trattiamo i link di segnalazione è spiegato nella informativa sull’affiliazione.