Revisione del codice su più assi: correttezza, leggibilità, architettura, sicurezza, prestazioni

Come rivedere una modifica prima che entri nel ramo principale: cinque assi di valutazione, dimensione delle modifiche, severità dei rilievi, e come rivedere il lavoro di un agente.

Metodologiametodologiacode reviewqualitàingegneria del software19 novembre 2026 · 3 min di lettura

Una revisione del codice che si limita a controllare se "gira" lascia passare quasi tutto ciò che conta: la funzione corretta ma illeggibile, il modulo che rompe i confini dell'architettura, l'endpoint senza controlli di accesso. Per questo la revisione si fa su più assi, ciascuno con le sue domande.

I cinque assi

1. Correttezza. Fa ciò che dichiara? Gestisce i casi limite (vuoto, nullo, valori estremi, concorrenza)? I test provano il comportamento, o solo che il codice non esploda? Esiste un test che avrebbe fallito prima della modifica?

2. Leggibilità. Si capisce senza chiedere all'autore? Nomi che dicono cosa sono, funzioni con una responsabilità, flussi lineari. Un codice che richiede una spiegazione verbale costa ad ogni lettura futura.

3. Architettura. Rispetta i confini e le convenzioni del progetto? Introduce un nuovo modo di fare cose già risolte altrove? Aggiunge dipendenze? Duplica una utilità esistente?

4. Sicurezza. Valida gli input ai confini? Controlla chi può fare cosa? Espone dati che non dovrebbe? Gestisce i segreti correttamente? Registra informazioni sensibili?

5. Prestazioni. Ci sono cicli che interrogano il database a ogni elemento? Operazioni costose in percorsi frequenti? Elenchi senza limite? Si giudica sulla base di misure o di rischi concreti, non di ottimizzazioni immaginarie.

La dimensione conta

Una modifica troppo grande non si rivede: si approva per stanchezza. Si preferiscono modifiche piccole, con un'unica intenzione, accompagnate da una descrizione che spiega che cosa cambia e perché. Se una modifica supera ciò che si legge con attenzione in una sessione, si chiede di dividerla.

La severità dei rilievi

Ogni rilievo dice quanto pesa, così l'autore sa che cosa deve cambiare e che cosa può discutere:

  • Bloccante: va corretto prima di entrare (difetto, falla di sicurezza, rottura del contratto).
  • Importante: da correggere, a meno di una buona ragione.
  • Suggerimento: miglioramento facoltativo.
  • Nota: osservazione senza azione richiesta.

Rilievi senza etichetta trasformano ogni commento in un ultimatum.

Rivedere il lavoro di un agente

Il codice scritto da un agente si rivede con lo stesso rigore, e con una attenzione in più: tende a essere plausibile, completo in apparenza, con test che riflettono il codice invece del comportamento voluto. Si controlla che cosa è stato eseguito davvero, che le dipendenze esistano e che il perimetro della modifica sia quello richiesto.

Che cosa dire e come

Si commenta il codice, non la persona. Si spiega il perché. Si propone un'alternativa quando si obietta. Si riconosce ciò che è fatto bene: serve a sapere che cosa ripetere.

Segnali d'allarme

  • Approvare perché "i test passano" senza guardare che cosa provano.
  • Una modifica troppo grande per essere letta.
  • Rilievi senza severità.
  • Nessuna attenzione alla sicurezza perché "è interno".
  • Fidarsi del codice dell'agente perché "ha eseguito i test".

Un esempio

Una modifica aggiunge un endpoint per esportare ordini. Sull'asse della correttezza: funziona. Sulla sicurezza: nessun controllo che l'utente possa vedere quegli ordini (bloccante). Sulle prestazioni: un'interrogazione per ogni ordine (importante). Sulla leggibilità: un nome poco chiaro (suggerimento). L'autore sa subito da dove cominciare.

Quando usarla

Prima di unire qualunque modifica al ramo principale, quando si rivede codice proprio, di un'altra persona o di un agente, e quando si valuta la qualità su più dimensioni.

Questo metodo deriva dalla famiglia di skill open source agent-skills di Addy Osmani (licenza MIT), riscritta e adattata.

Questo articolo è una skill di OIAR

Quello che hai letto è il contenuto di una skill del catalogo OIAR, scritto per le persone. Una conoscenza come questa ma più ricca e profonda, scritta per gli agenti, guida le interviste, l'analisi e il report dentro la piattaforma. Le skill si usano in OIAR: per provarla su un tuo progetto serve un account.

code-review-and-qualityMetodo per rivedere una modifica su cinque assi (correttezza, leggibilità, architettura, sicurezza, prestazioni) con rilievi classificati per severità, anche per codice scritto da un agente. Usarla prima di unire una modifica o quando si valuta la qualità di codice proprio o altrui.