Saltar a contenido

Arreglar un bug

Usa /n45-fix cuando algo esté roto, con comportamiento incorrecto o lento. N45 investiga, identifica la causa raíz y propone una corrección — aplicada al momento o planificada en detalle.

Como /n45-feat, N45 elige entre hot fix y fix estructurado en base a lo que la investigación encuentra.

Las tres condiciones

Las tres deben ser verdaderas para el camino hot fix. Si alguna falla, N45 escala a un fix estructurado.

Condición Qué significa
Causa raíz clara Diagnóstico confirmado. Sin investigación pendiente.
Sin cambio arquitectural El fix toca solo caminos de código existentes — sin nuevos módulos o cambios de patrón.
Sin schema o migration El fix no requiere cambio de base de datos.

El flujo

flowchart TD
    Start([/n45-fix]) --> Investigate[Investigar]
    Investigate --> Project[Lee patrones del proyecto]
    Project --> Ask[Clarificar síntomas y esperado]
    Ask --> Diagnose[Diagnosticar causa raíz]
    Diagnose --> Decision{Condiciones del
hot fix?}
    Decision -->|las 3 cumplidas| Hot[Hot fix
branch + ejecutor]
    Decision -->|alguna falla| Structured[Fix estructurado
discovery + spec + roadmap]
    Hot --> Validation
    Structured --> Validation
    Validation([Validación])

Hot fix — ejemplo

"El botón de login no hace nada cuando hago clic."

  1. N45 lee PATTERNS y los componentes relevantes
  2. Investiga: encuentra que el handler de submit nunca se enlaza
  3. Diagnostica: causa raíz clara, un único archivo
  4. Confirma que las tres condiciones se cumplen
  5. Decide: hot fix
  6. Crea una rama dedicada (hot-fix/login-button-no-submit)
  7. Lanza el ejecutor con el diagnóstico y el alcance del archivo
  8. Retorna: archivos modificados, resumen, cómo probar
  9. Tú validas → commit → merge

Tiempo total: 1–2 minutos.

Fix estructurado — ejemplo

"Nuestra migration corrompió registros de usuario. Algunas sesiones muestran datos incorrectos."

  1. N45 investiga e identifica un bug de update parcial en una migration
  2. Detecta: requiere script de recovery y verificación de schema — falla la condición 3
  3. Decide: fix estructurado
  4. Ejecuta discovery: mapea registros afectados, causa raíz, estrategia de recuperación
  5. Genera un spec cubriendo el plan de corrección de datos, log de auditoría, rollback
  6. Tú revisas el spec
  7. Genera un roadmap (recuperar → verificar → backfill → tests)
  8. Cada task se ejecuta y revisa antes de avanzar
  9. Validación → aprobación → merge

Cómo difiere de /n45-feat

/n45-feat /n45-fix
Nombre de la ruta rápida Quick Feat Hot Fix
Prefijo de la rama quick-feat/... hot-fix/...
Tag del commit [quick-feat] [hot-fix]
Disparador Nuevo comportamiento deseado Comportamiento existente incorrecto

En el resto: misma clasificación, misma validación, mismo merge.

Mira también