Ejemplo: depurar un bug en producción
Los prompts de ejemplo son ilustrativos; los comandos están verificados contra la documentación oficial.
Escenario: el login devuelve un HTTP 500 después del último despliegue. Una investigación razonable guiada por el agente: recoger logs, formular una hipótesis, reproducir en local, arreglar y verificar.
El flujo
- Recoger evidencias (logs, cambios recientes, salida del error).
- Formular hipótesis con el agente.
- Reproducir el fallo.
- Arreglar la causa raíz.
- Verificar con tests y volviendo a ejecutar el camino que fallaba.
Claude Code
Abre una sesión y reúne evidencias — pega los logs directamente, o pásaselos por tubería sin sesión interactiva:
claude
Este es el stack trace de producción: [pegar]. Ejecuta también
`git log --oneline -10` y dime qué cambio reciente podría estar causando un
500 en POST /login.
Variante con tubería:
kubectl logs deploy/api --since=30m | claude -p "Encuentra la causa raíz del 500 de login en estos logs."
Usa la skill de diagnóstico integrada para problemas de ejecución:
/debug El login devuelve 500 después del último despliegue
Formula la hipótesis y reproduce:
Formula una hipótesis y luego reproduce el fallo en local levantando el
servicio de auth y haciendo un POST a /login con un usuario de prueba.
Arregla y verifica:
Arregla la causa raíz, añade un test de regresión que reproduzca el 500 y
ejecuta toda la suite de tests de auth.
Si un intento de arreglo se tuerce, /rewind devuelve el código y la conversación a un checkpoint.
Codex
Investiga de forma interactiva en la TUI, o automatiza el triaje de logs con codex exec (el sandbox por defecto de exec es de solo lectura, perfecto para analizar logs):
kubectl logs deploy/api --since=30m | codex exec "Resume la causa raíz del 500 de login a partir de estos logs."
En la TUI, cruza la información con los cambios recientes:
codex
POST /login devuelve 500 desde el último despliegue. Mira `git log -10` y el
código de auth, e identifica el culpable más probable.
Reproduce bajo el sandbox del workspace:
Levanta el servicio de auth en local, reproduce el 500 con curl y enséñame el
camino de código que falla.
Arregla y verifica:
Arregla la causa raíz y añade un test de regresión. Ejecuta `npm test -- auth`
hasta que esté en verde y luego resume el diff.
Comprueba el resultado con /diff antes de commitear. Los servidores de desarrollo en segundo plano aparecen en /ps; /stop los detiene.
Kimi Code
Abre una sesión y recoge los logs con el modo shell (! en la caja de entrada vacía ejecuta un comando local y su salida entra en la conversación):
kimi
!kubectl logs deploy/api --since=30m | tail -100
El login devuelve 500 después del último despliegue. Con los logs de arriba y
`git log --oneline -10`, ¿cuál es la causa raíz más probable?
Reproduce:
Levanta el servicio de auth en local en segundo plano, reproduce el 500 con un
POST de curl a /login y captura el stack trace.
Arregla y verifica:
Arregla la causa raíz, añade un test de regresión que reproduzca el 500 y
ejecuta la suite de tests de auth para confirmar que está en verde.
Para una investigación larga y desatendida, puedes delegarle un objetivo persistente:
/goal Reproduce el 500 de login en local, arregla la causa raíz y termina sólo
cuando la suite de tests de auth pase.
Relacionado
- Flujos de Claude Code: Claude Code — Flujos de trabajo
- Flujos de Codex: Codex CLI — Flujos de trabajo
- Flujos de Kimi Code: Kimi Code — Flujos de trabajo
- Tablas de referencia rápida: Cheatsheet de las tres herramientas
Última verificación: 2026-09-07
Las herramientas de IA para programar evolucionan rápido. Si encuentras información desactualizada, abre un issue o un pull request.