Sviluppo guidato dal dubbio: far attaccare ogni decisione importante da un revisore con contesto nuovo

Un metodo a cinque passi per mettere alla prova le decisioni che contano: dichiarare la tesi, estrarre l'unità minima, chiedere un'analisi avversariale a contesto nuovo, riconciliare, fermarsi.

Metodologiametodologiarevisionequalitàingegneria del software19 novembre 2026 · 3 min di lettura

Chi ha appena preso una decisione è la persona peggiore per metterla in discussione: ha costruito le ragioni per cui è giusta. Quando la correttezza conta più della velocità (produzione, sicurezza, operazioni irreversibili), conviene far esaminare la decisione da qualcuno che non conosce il percorso che ci ha portato lì.

Il ciclo

1. La tesi. Si scrive in due o tre righe ciò che si dà per vero, e perché conta: "il nuovo livello di cache è sicuro sotto carichi concorrenti in lettura; una corsa critica qui corromperebbe i dati e in test non si vede". Se non si riesce a scriverla in poche righe, non è una decisione, è un'impressione.

2. L'estrazione. Si isola l'unità più piccola esaminabile: la modifica o la funzione, non l'intero file; la proposta in tre-cinque frasi con i vincoli che deve rispettare. Si passano il manufatto e il contratto, non il ragionamento. Consegnare le conclusioni significa ottenere in cambio una conferma delle conclusioni. Una richiesta di cinquecento righe va prima scomposta.

3. Il dubbio. Un revisore con contesto nuovo (un'altra persona, un secondo agente avviato da zero) riceve manufatto e contratto, non la tesi, e una consegna esplicitamente avversariale: trova che cosa non va, presumi che l'autore sia troppo sicuro, cerca ipotesi non dichiarate, casi limite non gestiti, accoppiamenti nascosti, modi di violare il contratto, convenzioni esistenti che si rompono, modi di fallire con input inattesi. Non confermare, non riassumere: trova problemi, oppure dichiara di non averne trovati dopo un esame accurato. Una domanda come "va bene?" produce un sì.

4. La riconciliazione. Ogni rilievo si classifica rispetto al testo del manufatto: azionabile (si corregge), già coperto (si indica dove), non pertinente (si spiega). Non si prende l'output del revisore come verità: lo si rilegge contro il manufatto.

5. L'arresto. Il ciclo è limitato, non ricorsivo. Si smette quando i rilievi diventano banali, dopo tre cicli, o quando l'utente decide. Oltre tre cicli senza esito, si porta la questione all'utente.

Quando conviene

Quando la correttezza pesa più della velocità, quando si lavora in codice che non si conosce, quando la posta è alta (produzione, logica di sicurezza, operazioni irreversibili) o quando la decisione è già stata convalidata solo da chi l'ha presa.

Quando non serve

Per rinominare una variabile o riformattare. Il metodo ha un costo, e per una modifica di una riga è sproporzionato.

Segnali d'allarme

  • Avviare un revisore per una modifica banale.
  • Trattare l'output del revisore come autorevole senza rileggere il manufatto.
  • Fare più di tre cicli senza coinvolgere l'utente.
  • Chiedere "va bene?" invece di "trova i problemi".
  • Saltare il dubbio sotto pressione di tempo su una decisione ad alta posta.
  • Rilanciare il revisore su un manufatto invariato: stessi rilievi, si sta solo prendendo tempo.
  • Teatro del dubbio: in due o più cicli con rilievi sostanziali, nessuno è stato classificato come azionabile. Si sta convalidando la tesi invece di metterla alla prova.

Un esempio

Una tesi: "la migrazione si può rieseguire senza effetti collaterali". Si estraggono lo script e la regola di idempotenza. Il revisore, che non conosce la tesi, nota che lo script inserisce una riga di log prima di controllare se la migrazione è già stata applicata: rieseguito, duplica i log e, peggio, azzera un contatore. Il difetto non si vedeva da chi aveva scritto lo script, convinto dell'idempotenza.

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.

doubt-driven-developmentMetodo a cinque passi per sottoporre una decisione importante a un revisore avversariale con contesto nuovo: tesi, estrazione di manufatto e contratto, dubbio, riconciliazione dei rilievi, arresto. Usarla quando la correttezza conta più della velocità o la posta è alta (produzione, sicurezza, operazioni irreversibili).