Bug Fix Protocol

Obliga a corregir bugs siguiendo primero un test en rojo, más una auditoría obligatoria de por qué la suite de tests no lo detectó.

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

Probado · Funciona ★ 8.4/10

Bug Fix Protocol — Obliga a corregir bugs siguiendo primero un test en rojo, más una auditoría obligatoria de por qué la suite de tests no lo detectó.

Qué hace

Un protocolo disciplinado de 8 pasos para corregir bugs de producción: reproducir, escribir primero un test que falle, rastrear la causa raíz real, aplicar la corrección mínima, verificar que pasa en verde, ejecutar la suite completa, documentar, y luego (el paso final obligatorio) auditar qué capa de tests debería haber detectado el bug y cerrar esa brecha. Actívalo con 'corrige este bug', 'bug de producción', 'test de regresión', 'post-mortem' o 'por qué los tests no detectaron esto'; no para bugs detectados localmente durante el desarrollo normal.

Informe de la prueba

Se ejecutó un ciclo real rojo-verde sobre un bug de cálculo de descuentos: el baseline simplemente parcheó en silencio el caso de porcentaje null, mientras que seguir el skill produjo un test de regresión pytest incorporado al repositorio más un hallazgo concreto del paso 8 ('no existía ningún test de protección contra None; añadir cobertura parametrizada + una anotación de tipo') que el baseline nunca produce.

Probado el: 2026-07-13 · Claude Code 2.x (agent harness)

Instalación

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

Comandos y prompts de ejemplo

  • /bug-fix-protocolObliga a corregir bugs siguiendo primero un test en rojo, más una auditoría obligatoria de por qué la suite de tests no lo detectó.

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

  • 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