# Depurar con tu agente: reproducir, encontrar, arreglar, comprobar

> La depuración es el método paso a paso que usa tu agente cuando algo se rompe: primero reproducir el fallo de forma fiable, después localizar la causa de fondo en los logs y el código, arreglarla con un solo cambio cada vez y añadir un test para que no vuelva.

## Analogía

Cuando una lámpara deja de encender, no cambias los cables de toda la casa al azar. Pulsas el interruptor para ver el fallo, compruebas la bombilla y el enchufe uno por uno, cambias la bombilla fundida y vuelves a pulsar para comprobar que da luz.

## Cómo funciona

Un bug es simplemente un fallo en el código que hace que tu app no se comporte como esperabas. La debugging es la forma de resolverlo con tu coding-agent: no adivinando ni cambiando cinco archivos a la vez, sino siguiendo cuatro pasos ordenados: **reproducir, encontrar, arreglar y comprobar**.

Primero, **reproducir** y **encontrar**: le dices a tu agente los pasos exactos que provocan el fallo, y el agente lee el error-message y las líneas de log para localizar el archivo y la línea donde empieza el problema. Aísla la causa de fondo antes de tocar nada.

Después, **arreglar** y **comprobar**: el agente hace **un solo cambio cada vez** para corregir la causa de fondo (sin probar a ciegas), añade un test automático que habría detectado ese fallo y verifica el flujo de principio a fin para que el error no pueda volver en el futuro.

¿Y si el primer intento no funciona? La guía de Agentic Makers marca una regla estricta: **tras dos intentos fallidos**, el agente debe detenerse, devolver tu proyecto al último commit que funcionaba (`git revert` o una rama limpia, sin borrar nunca el historial) y explicarte las opciones con claridad para no acumular parches.

## En tu proyecto

Cuando algo se rompe, tu agente activa su skill `debugging-and-error-recovery`. Te explica en dos frases sencillas qué causó el fallo y cómo lo resuelve el arreglo, añade un test y te pide que compruebes que el problema ha desaparecido.

## Copia para tu agente

```text
Algo se ha roto: cuando [pasos que diste], esperaba [resultado esperado] pero ocurrió [resultado real]. Sigue el ciclo de depuración: reprodúcelo, busca la causa de fondo en los logs, explícamela en dos frases sencillas, haz un cambio cada vez y añade un test.
```

---
Fuente: [Agentic Makers](https://agenticmakers.app/es/aprende/depurar-con-tu-agente) · Licencia: CC BY 4.0