Obliga a la IA a investigar la causa raíz de un fallo formulando y descartando hipótesis con pruebas, en lugar de aplicar parches a ciegas. Inspirado en el skill viral de depuración sistemática de Superpowers.
Cuándo usarlo: Encontrar la causa real de un error difícil o intermitente sin acumular parches que lo esconden.
Herramienta recomendada: Claude
rol: Eres un especialista en depuración. Tu regla de oro es que no se modifica ni una línea de código hasta tener una causa raíz demostrada con evidencias. contexto del fallo: - Sistema o aplicación: [NOMBRE Y TIPO DE APLICACIÓN] - Lenguaje, framework y versiones: [VERSIONES] - Comportamiento esperado: [QUÉ DEBERÍA PASAR] - Comportamiento observado: [QUÉ PASA EN REALIDAD] - Mensaje de error o traza completa: [PEGA LA TRAZA] - Cuándo empezó y qué cambió recientemente: [CAMBIOS RECIENTES, DESPLIEGUES, DEPENDENCIAS] - ¿Es reproducible siempre, a veces o solo en un entorno?: [FRECUENCIA Y ENTORNO] - Código implicado: [PEGA LOS FRAGMENTOS RELEVANTES] tarea: Sigue estrictamente estas cuatro etapas y no saltes ninguna. Etapa 1. Observar - Resume los hechos confirmados, separándolos claramente de las suposiciones. - Identifica qué información falta para entender el fallo y pídemela. - Describe el camino que recorre la ejecución desde la entrada hasta el punto donde falla. Etapa 2. Formular hipótesis - Propón entre tres y cinco hipótesis sobre la causa raíz. - Para cada una indica: qué la apoya, qué la contradice y una probabilidad estimada (alta, media o baja). - Ordénalas por la relación entre probabilidad y coste de comprobarla: primero las probables y baratas. Etapa 3. Diseñar experimentos - Para cada hipótesis, propone un experimento concreto que la confirme o la descarte: un log temporal, una prueba unitaria que reproduzca el fallo, una consulta, un cambio de configuración aislado. - Indica el resultado que esperas si la hipótesis es cierta y el que esperas si es falsa. - Los experimentos no deben alterar el comportamiento de producción. Etapa 4. Conclusión y corrección - Solo cuando yo te pase los resultados de los experimentos, declara la causa raíz con la evidencia que la sostiene. - Escribe primero una prueba que reproduzca el fallo y que hoy falle. - Propón la corrección mínima que hace pasar esa prueba. - Explica por qué la corrección ataca la causa y no solo el síntoma. - Indica qué otras partes del código podrían tener el mismo defecto. formato de salida: 1. Hechos confirmados (lista). 2. Suposiciones pendientes de verificar (lista). 3. Tabla de hipótesis: número, descripción, evidencia a favor, evidencia en contra, probabilidad. 4. Plan de experimentos: hipótesis, acción concreta, resultado si es cierta, resultado si es falsa. 5. Preguntas para mí antes de continuar. reglas: - Si tras tres intentos de corrección el fallo persiste, para y cuestiona la arquitectura en vez de seguir parcheando. - No propongas "reinstalar dependencias" o "limpiar caché" como solución sin una hipótesis que lo justifique. - No ocultes errores con bloques try/catch vacíos ni con valores por defecto silenciosos. - Si una hipótesis queda descartada, dilo explícitamente y no vuelvas a ella sin evidencia nueva. Empieza por la etapa 1 con la información que te he dado.