Word GRATIS Intermedio

Analisi della Causa Radice di un Bug

Per sviluppatori che vogliono smettere di tirare a indovinare: trasforma un bug in una procedura ordinata di ipotesi falsificabili, evidenze, isolamento e causa radice, fino al fix e al test di regressione che impedisce il ritorno del problema.

In sintesi

Analisi della Causa Radice di un Bug è un template in formato Word pubblicato da Management Academy. Prompt intermedio che guida il debug con metodo scientifico: ipotesi falsificabili, evidenze, isolamento, causa radice, fix e test di regressione anti-ritorno. Si scarica gratuitamente con un account gratuito.

Aggiornato il 16 agosto 2026 · a cura della faculty di Management Academy

Le versioni di questo template

Analisi della Causa Radice di un Bug · Word
Anteprima del template Analisi della Causa Radice di un Bug in formato Word
ANALISI DELLA CAUSA RADICE

Bug Analysis Report — metodo scientifico di debug

1. Sintomi e dati noti

Registra i fatti concreti: titolo del bug, data della segnalazione, chi l'ha riportato, comportamento atteso vs osservato, ambiente, riproducibilità, passi per riprodurre, messaggio di errore, ultima modifica rilevante.

2. Ipotesi (ordinate per probabilità)

Elenca almeno tre cause possibili del difetto. Per ognuna definisci un esperimento falsificabile.

3. Esperimenti ed evidenze

Conduci ogni test, registra il risultato concreto. Se un'ipotesi è confermata o smentita, annotalo. Continua finché isoli la vera causa.

4. Causa radice

Conclusione: qual è la vera causa, non il sintomo. Meccanismo: come il codice la produce. Ambito: altri punti del sistema potenzialmente affetti.

5. Fix

Descrivi la modifica concreta al codice o alla configurazione che risolve la causa radice. Includi il frammento di codice o la riga esatta.

6. Test di regressione

Scrivi un test automatico che riproduce il bug originale e fallirebbe senza il fix. Questo impedisce che il problema torni in futuro.

Versione standard

È il file pronto da compilare: intestazioni, sezioni obbligatorie e riferimenti metodologici già al loro posto. Usala quando sai cosa scrivere e ti serve solo la struttura corretta.

Scarica per Word

Cos'è e quando si usa

Per sviluppatori che vogliono smettere di tirare a indovinare: trasforma un bug in una procedura ordinata di ipotesi falsificabili, evidenze, isolamento e causa radice, fino al fix e al test di regressione che impedisce il ritorno del problema.

Processo
Execution Templates
Livello
Intermedio

Cosa contiene il file

BUG: il totale carrello mostra 0 quando l'utente applica due coupon.

1. SINTOMI E DATI NOTI
- Atteso: somma sconti applicata una volta. Osservato: totale = 0.
- Riproducibile: sì, sempre, con 2+ coupon. Ambiente: prod e staging.
- Cambiato di recente: refactor del calcolo sconti (commit a3f1).

2. IPOTESI (ordinate per probabilità)
| # | Ipotesi | Probabilità | Come falsificarla |
|---|---------|-------------|-------------------|
| H1 | Sconti sommati come percentuale > 100% | Alta | Logga sconto_totale con 2 coupon |
| H2 | Divisione per zero su quantità | Media | Test con quantità=1 |
| H3 | Bug di arrotondamento | Bassa | Confronta con valori interi |

3. ESPERIMENTI ED EVIDENZE
- H1: log mostra sconto_totale = 1.4 (140%) -> totale clampato a 0. CONFERMA H1.
- H2: riprodotto anche con quantità=1 -> H2 SMENTITA.

4. CAUSA RADICE
Il refactor a3f1 somma gli sconti percentuali invece di applicarli in sequenza; con due coupon supera il 100% e il clamp porta il totale a 0.

5. FIX
Applicare gli sconti in sequenza moltiplicativa, non additiva.
// before: sconto = c1 + c2
// after:  prezzo = prezzo * (1-c1) * (1-c2)

6. TEST DI REGRESSIONE
Test: due coupon 30%+20% su 100 -> atteso 56, non 0. Fallisce senza il fix.

7. ALTRI PUNTI AFFETTI
Verificare la stessa logica additiva in calcoloSpedizione() — stessa causa radice probabile.

Il prompt che lo genera sui tuoi dati

Il file qui sopra è pronto da scaricare. Se ti serve compilato sul tuo progetto, incolla questo prompt in un assistente: costruisce lo stesso documento con i tuoi dati.

Prompt completo riservato agli utenti registrati

Registrati gratis per sbloccare il prompt completo e scaricare il file.

Come si usa, passo per passo

  1. Scarica il file e aprilo. Resta editabile: si apre con Excel, Word e PowerPoint, e anche con Google Workspace o LibreOffice.
  2. Compila prima le sezioni obbligatorie. Sono quelle che un committente o un esaminatore guarda per prime: oggetto, responsabili, criteri di accettazione.
  3. Rigenera con il prompt sui tuoi dati. Copia il prompt di questa pagina, incolla il contesto del progetto e ottieni il documento già compilato.
  4. Fai rivedere il risultato. Un documento corretto nel metodo ma scollegato dal progetto non regge alla prima domanda: rileggilo con chi il progetto lo conosce.

Domande frequenti

Cosa devo fornire perché il debug sia utile?

Più sintomi concreti dai, meglio è: comportamento atteso vs osservato, messaggio o stack trace, passi per riprodurre, ambiente e cosa è cambiato di recente. Il prompt usa solo ciò che fornisci e marca come "Da verificare" qualsiasi passo che richiede dati che non hai ancora dato.

In cosa è diverso dal chiedere semplicemente «perché non funziona»?

Perché impone il metodo scientifico: genera più ipotesi concorrenti, le ordina per probabilità, e per ognuna definisce un esperimento che la conferma o la SMENTISCE. Questo evita il fix a caso che maschera il sintomo senza toccare la causa radice.

Mi aiuta anche a evitare che il bug ritorni?

Sì: la procedura termina sempre con un test di regressione che riproduce il bug e fallirebbe senza il fix, più una nota su altri punti del codice potenzialmente affetti dalla stessa causa radice.