Bugfixes
¿Qué es un bugfix en RaiSE?¶
Un bugfix es un pipeline estructurado diseñado alrededor de una idea clave: un fix que parte de la causa raíz incorrecta desperdicia todo el esfuerzo. A diferencia de las features (que se pueden construir incrementalmente), los bugs fallan catastróficamente cuando el análisis es incorrecto. El pipeline pone gates en los puntos de decisión críticos — para atrapar errores antes de invertir en el fix equivocado.
¿Por qué un pipeline?¶
La mayoría de los bug fixes fallan así:
- El developer ve un síntoma
- Asume una causa
- Escribe un fix para la causa asumida
- El fix no funciona (causa equivocada) — repetir desde el paso 2
- Eventualmente encuentra la causa real, pero ya hay código residual de intentos fallidos
El pipeline de bugfix de RaiSE invierte esto: probar la causa antes de escribir el fix. Inviertes más tiempo analizando y menos reescribiendo.
El pipeline¶
El pipeline de bugfix tiene 10 fases, organizadas alrededor de 5 gates:
| Fase | Qué pasa | Pregunta del gate |
|---|---|---|
| Scope | Reproducir el bug, definir comportamiento esperado vs actual | ¿Es el problema correcto? |
| Análisis | Encontrar causa raíz, planear la estrategia | ¿Es la causa correcta? |
| Review de arquitectura | Verificar que el cambio planeado es proporcional | ¿Es proporcional el fix? |
| Fix | Escribir test que falle (RED), arreglarlo (GREEN), refactorizar | ¿Funciona el fix? |
| Review de calidad | Verificar regresiones, riesgos semánticos | ¿Está completo el fix? |
| Cierre | Merge, transición Jira, limpieza | Hecho |
Cada gate pausa para tu revisión. Tú decides cuándo proceder — el pipeline nunca avanza automáticamente después de un punto de decisión.
Cómo iniciar¶
En tu asistente de IA (Claude Code), pídele a Rai:
Rai llama al motor de pipelines MCP, detecta en qué fase empezar (o retoma donde lo dejaste), y te guía a través de cada fase.
Principios clave¶
- Reproducir primero — un bug que no puedes reproducir es un bug que no puedes verificar como arreglado
- Test que falle primero — el test prueba que el bug existe Y prueba que el fix funciona (TDD)
- Esfuerzo proporcional — bugs pequeños reciben ceremonia más ligera. El pipeline se adapta al tamaño del fix
- Causa raíz sobre síntomas — arreglar el síntoma deja el bug real vivo para la próxima vez
Siguiente paso¶
- Ciclo de Vida de Bugfix — Guía detallada de las 10 fases
- Stories — Cómo el trabajo de features sigue un ciclo estructurado similar
- Pipeline Quickstart — Cómo funciona el motor de pipelines MCP