Ir al contenido
Mastering Claude

Inicio / Cuando algo falla

Cuando algo falla9 minApplication

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.

Figure 1

De la solicitud a la corrección de la causa real

01
Solicitud recibida
Un síntoma observado y una causa supuesta llegan mezclados en la misma frase, sin distinción entre ambos.
02
Estado medido
Un diff, una lectura de registro o la apertura directa del archivo en cuestión aporta una observación independiente de la solicitud.
03
Discrepancia comparada
La causa supuesta y el estado medido se confrontan, pueden coincidir o divergir.
04
Discrepancia enunciada
Si ambos divergen, la discrepancia se dice al principio de la respuesta, antes de cualquier corrección, para que la premisa falsa no quede en silencio.
05
Causa real corregida
La corrección recae sobre lo que mostró la medición, no sobre lo que suponía la solicitud de origen.
La secuencia separa la solicitud recibida, que mezcla síntoma y causa supuesta, de la medición independiente que viene a confirmar o contradecir esa causa antes de cualquier corrección.
Calíbralo tú mismo

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 hay que recordar
  • 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.
Hazlo ahora

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.