Bug Fix Protocol

Impone una correzione del bug con test rosso scritto per primo, più un audit obbligatorio sul perché la test suite se l'è lasciato sfuggire.

di CodeAlive-AI · CodeAlive-AI/ai-driven-development

Promosso ★ 8.4/10

Bug Fix Protocol — Impone una correzione del bug con test rosso scritto per primo, più un audit obbligatorio sul perché la test suite se l'è lasciato sfuggire.

Cosa fa

Un protocollo disciplinato in 8 passi per correggere bug in produzione: riprodurre, scrivere prima un test che fallisce, rintracciare la vera causa radice, applicare la correzione minima, verificare che il test passi, eseguire l'intera suite, documentare, poi (il passo finale obbligatorio) fare l'audit su quale livello di test avrebbe dovuto intercettare il bug e colmare quella lacuna. Attivala su 'correggi questo bug', 'bug in produzione', 'test di regressione', 'post-mortem' o 'perché i test se lo sono lasciato sfuggire' - non per bug intercettati localmente durante lo sviluppo normale.

Rapporto di test

Eseguito un vero ciclo red-green su un bug di calcolo dello sconto: la baseline si è limitata a correggere silenziosamente il caso null-pct, mentre seguendo la skill si è ottenuto un test di regressione pytest committato più un risultato concreto al passo 8 ('non esisteva alcun test di guardia su None - aggiungere copertura parametrizzata + un type hint') che la baseline non produce mai.

Testato il: 2026-07-13 · Claude Code 2.x (agent harness)

Installazione

git clone https://github.com/CodeAlive-AI/ai-driven-development
cd ai-driven-development
mkdir -p ~/.claude/skills
cp -r skills/bug-fix-protocol ~/.claude/skills/bug-fix-protocol

Comandi e prompt di esempio

  • /bug-fix-protocolImpone una correzione del bug con test rosso scritto per primo, più un audit obbligatorio sul perché la test suite se l'è lasciato sfuggire.

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • Fix this production bug and write a failing test first
  • Reproduce this regression, fix the root cause, and verify it's green
  • Audit why our test suite missed this bug after fixing it