La solicitud puede partir de una premisa falsa
Una solicitud puede describir el síntoma con exactitud a la vez que se equivoca sobre la causa, y ejecutar esa solicitud al pie de la letra entonces no corrige nada o agrava la situación.
Una solicitud de corrección contiene casi siempre dos cosas mezcladas: un síntoma observado y una causa supuesta. El síntoma puede ser perfectamente exacto, el servidor efectivamente responde en el puerto equivocado, el informe efectivamente contiene una cifra falsa, mientras que la causa aducida para explicarlo es falsa. Obedecer al pie de la letra una solicitud construida sobre una causa falsa no repara nada, e incluso puede enmascarar el verdadero problema al dar la impresión de que alguien se ha ocupado de él.
El síntoma es verdadero, la causa supuesta no necesariamente
La formulación de una solicitud siempre viene de alguien que ya tiene un diagnóstico en mente en el momento de escribirla. Ese diagnóstico no tiene nada de arbitrario, a menudo viene de un recuerdo o de una hipótesis razonable, pero nada garantiza que se haya verificado sobre el estado real del sistema en el momento en que se formula la solicitud. Una premisa falsa deslizada en una solicitud tiene una propiedad incómoda: se lee como un hecho establecido, no como una hipótesis, y nada en su formulación señala que merezca ser comprobada antes de actuar.
# La solicitud afirma: "el puerto se ha quedado en 3000 en config.json, vuelve a ponerlo en 8080"
printf '{"port": 8080}\n' > config-ejemplo.json
cat config-ejemplo.json
# {"port": 8080}
La lectura directa del archivo fabricado arriba ya contradice la solicitud: el valor guardado es 8080, no 3000. Corregir un valor que ya es correcto no repara nada y deja intacta la verdadera causa del síntoma observado, ya se trate de una caché, de un proceso que no se ha reiniciado, o de un segundo archivo de configuración leído con prioridad.
Medir antes de ejecutar al pie de la letra
El reflejo que evita esta trampa se resume en tres gestos, en este orden. Medir el estado real por un medio independiente de la solicitud misma, un diff, una lectura de registro, una apertura directa del archivo de configuración en cuestión. Enunciar la discrepancia desde el inicio de la respuesta, antes de cualquier corrección, para que la persona que formuló la solicitud vea de inmediato que su premisa no se sostenía. Corregir después la causa real tal como acaba de medirse, no la causa tal como se había supuesto en la solicitud de origen.
Este orden importa más que cada gesto tomado por separado. Medir sin decirlo nunca deja a la persona con la misma falsa creencia para la próxima vez. Corregir sin haber medido equivale a apostar a que la premisa era correcta, una apuesta perdida en cuanto el síntoma y la causa supuesta se han separado el uno del otro. Esta misma disciplina, verificar antes de culpar, estructura también el diagnóstico de una sesión que muere sin razón aparente, ver varias sesiones mueren juntas, sospecha de la máquina.
De la solicitud a la corrección de la causa real
Un usuario le pide a Claude Code que vuelva a poner el valor del puerto en 8080 en el archivo config.json, indicando que el servidor sigue respondiendo en el puerto 3000. Claude Code abre el archivo antes de modificarlo y lee ahí el valor 8080.
Escribe en una frase lo que esta situación establece, y en una frase lo que no establece.
Lo que esto establece: La lectura del archivo muestra que el valor guardado en config.json ya es 8080, un hecho distinto de lo que suponía la solicitud.
Lo que esto no establece: No establece por qué el servidor sigue respondiendo en el puerto 3000, ni qué elemento del sistema explica realmente ese comportamiento.
Los tres calibrados falsos más frecuentes
- Demasiado amplio Esta lectura prueba que el problema viene forzosamente de un proceso en caché que nunca se ha reiniciado desde el último cambio.
- Demasiado estrecho Esta lectura no sirve de nada, ya que config.json es solo uno de los muchos lugares donde puede definirse un valor de puerto.
- Fuera de lugar Esta lectura muestra que config.json es el único lugar del proyecto donde está definido el valor del puerto.
- Una solicitud mezcla casi siempre un síntoma observado y una causa supuesta, y solo la primera de las dos está garantizada como exacta.
- Ejecutar una corrección construida sobre una premisa falsa no repara el síntoma y puede dar la ilusión engañosa de que el problema ha sido tratado.
- Medir el estado real por un medio independiente de la solicitud, diff, registro o lectura directa de la configuración, precede a toda corrección.
- La discrepancia entre la premisa anunciada y el estado medido se enuncia desde el inicio de la respuesta, antes de la corrección misma.
- La corrección recae sobre la causa tal como acaba de medirse, nunca sobre la causa tal como estaba formulada en la solicitud de origen.
Ante tu próxima solicitud de corrección dirigida a Claude Code, haz que verifique el estado real del archivo o del registro implicado antes de aceptar la premisa enunciada, y lee su constatación antes de dejarle corregir nada.