Skip to content
NeuralSkills
Depuracion

Detective de Regresiones

Rastrea cuando y por que un feature se rompio usando git bisect combinado con analisis de IA para encontrar el commit culpable.

Intermedio Gratis Publicado: 15 de abril de 2026
Herramientas Compatibles claude-codechatgptgeminicopilotcursorwindsurfuniversal

El Problema

Algo que funcionaba ahora esta roto, y nadie sabe cuando paso. El equipo ha mergeado 200 commits desde el ultimo estado bueno conocido. Revisar cada commit manualmente es locura. Git bisect automatiza la busqueda binaria sobre commits, y combinarlo con analisis de IA convierte un proceso mecanico en una investigacion inteligente que tambien explica POR QUE ocurrio la regresion.

El Prompt

Eres un experto en analisis de regresiones. Ayudame a encontrar y entender el commit que rompio este feature:

QUE SE ROMPIO: [describe el feature que ya no funciona]
ULTIMO ESTADO BUENO: [commit hash, fecha o version donde funcionaba]
PRIMER ESTADO MALO: [commit actual o cuando se descubrio el bug]
COMANDO DE TEST: [comando que retorna exit 0 para bueno, exit 1 para malo]

Guiame a traves de un git bisect potenciado por IA:
1. **Setup de Bisect**: Genera los comandos exactos de git bisect para comenzar.
2. **Estrategia de Skip Inteligente**: Que commits podemos saltar automaticamente? (merge commits, solo docs, CI config)
3. **En Cada Paso**: Cuando comparta el diff del commit actual, analiza si este commit PODRIA logicamente causar la regresion — no solo probar, RAZONAR.
4. **Una Vez Encontrado**: Analiza el commit culpable en profundidad — explica que cambio de linea causo la regresion y POR QUE el autor no lo detecto.
5. **Radio de Explosion**: Que otros features podria haber afectado este commit?

Ejemplo de Salida

Setup: git bisect start HEAD abc1234 && git bisect run npm test
Smart skip: Marcando cambios en docs/ y .github/ como buenos automaticamente
Commit culpable: f7e2a91 "Refactor: extract UserService from controller"
Cambio que rompio: Linea 47 cambio `this.db.query()` a `db.query()` — perdio el contexto del pool de conexiones
Por que no se detecto: Unit tests mockeaban la base de datos, el contexto roto nunca se probo contra un pool real
Fix: Patch forward — inyectar el pool de conexiones explicitamente en vez de depender del contexto `this`

Cuando Usar

Usa este skill cuando un feature que previamente funcionaba esta roto y no puedes identificar la causa solo con code review. Ideal cuando la regresion abarca muchos commits o cuando el breaking change es sutil.

Tips Pro

  • Automatiza bisect con un script de testgit bisect run ./test.sh automatiza completamente el proceso.
  • Usa git bisect skip para commits que no compilan — saltalos en vez de marcarlos como buenos o malos.
  • Revisa cambios en dependencias — las regresiones frecuentemente vienen de actualizaciones en package-lock.json, no de cambios en codigo fuente.