PTENES
Inicio / Ruta 2 / Módulo 2.7
✅
MÓDULO 2.7 Ruta 2 — Práctica

✅ Verificación e informe fiel

El último módulo de la Práctica, y lo que distingue a quienes "creen que funcionó" de quienes sabe que funcionó. Una edición es solo una hipótesis; una verificación real es la prueba. Aquí instalas el reflejo de ejecutar la prueba real, confirmar antes de lo irreversible, recuperarte de un error con método y informar lo que pasó sin rodeos. Es la pieza que hace que una IA sea digna de confianza.

📋6 temas
⏱~35 min
🎯Práctico
🔬Verificación
el ciclo de verificación — una edición es una hipótesis; una comprobación que pasa es la evidencia EDIT cambias algo = una hipótesis todavía no probada VERIFY ejecuta la prueba/build REAL = la evidencia no un ls / echo NARRATE cuenta lo que pasó = sin rodeos aprobó / falló / omitió prueba aprobó ✓ falló ✗ bucle de recuperación — diagnostica, no repitas a ciegas ① diagnostica lee el error inspecciona el estado ② corrige forma la corrección aplica el cambio ③ vuelve a verificar vuelve a ejecutar el check ¿desapareció el error? ④ ¿no funcionó? dilo claramente nunca en silencio vuelve a probar

Contenido detallado

1

Una edición es una hipótesis

Acabas de cambiar una línea del prompt o pedir una corrección, y ella parece cierta. Detente ahí: parecer correcto no es evidencia de nada. Una edición es solo una conjetura con apariencia de solución: una hipótesis. La pregunta que importa no es «¿quedó bien?», sino «¿cómo sé que quedó bien?». Y la respuesta siempre es la misma: porque pasó una verificación real.

🔬 La idea en una frase

Todo cambio que haces es una hipótesis — una apuesta a que el problema desaparezca. Se convierte en conocimiento solo cuando ejecutas la verificación y ve el resultado. Antes de eso, no corregiste nada; propuso una corrección.

Este es el pensamiento que lo cambia todo: separar el acto de cambiar (barato, rápido, incierto) del acto de probar (lo que realmente te da confianza). Quien confunde los dos entrega algo que «probablemente funciona» creyendo que «ya está hecho».

Del Fable Mindset — verbatim an edit is a hypothesis
"An edit is a hypothesis. A passing check is the evidence."

Dos frases. La primera te quita la falsa sensación de que ya está listo; la segunda te dice dónde está de verdad — en el check, no en tu optimismo.

Por qué esto te importa

Porque, por defecto, la IA es optimista: tiende a informar éxitos que no verificó. Si no exiges pruebas —en el prompt y en tu propio hábito—, heredas ese optimismo. Tratar cada cambio como una hipótesis es el antídoto: te obliga a preguntar «¿qué verificación lo demostraría?» antes de decir «listo».

💡
Edición = suposición
todavía no probada
🧾
Check = prueba
la evidencia real
🚫
"Parece correcto"
no cuenta
❓
"¿Cómo lo sé?"
la pregunta clave
2

Ejecuta el check REAL, no una puesta en escena

Aquí está el error más común y más invisible: ejecutar un check que parece verificación, pero no verifica nada. Un ls que confirma que el archivo existe. Un echo que imprime "ok". Un comando cualquiera que terminó con código cero. Nada de eso demuestra que tu cambio haya funcionado. El check real es la prueba, el build, el lint o el typecheck que el proyecto realmente usa — y ejecutar la tarea de verdad, no un sustituto reconfortante.

✓ Check real (la evidencia)

  • ✓Ejecutar el prueba del proyecto y leer lo que pasó/falló
  • ✓Ejecutar el build completo y ver si realmente compila
  • ✓Dar a tarea real a la IA y comprobar el resultado frente al criterio
  • ✓Abrir la cosa y observar el comportamiento, no solo el código de salida

✗ Teatro de verificación (no demuestra nada)

  • ✗Un ls que solo demuestra que el archivo está ahí
  • ✗Un echo "funcionou" que tú mismo escribiste
  • ✗Un comando no relacionado que terminó con código 0
  • ✗"Miré y parece correcto" — lectura en lugar de ejecución

🎯 Si el proyecto pide la suite completa, ejecuta la suite completa

La tentación es ejecutar solo la prueba de la parte que modificaste. Pero tu cambio puede haber roto otra cosa muy lejos de ahí — y un subconjunto elegido a dedo no lo detecta. Una verificación con un alcance demasiado limitado es la forma más fácil de declarar «aprobado» mientras algo está roto fuera de tu campo de visión.

Esta es, según la propia colección, la disciplina más desatendida: ejecutar la comprobación real después de editar ocurre pocas veces. Por eso es innegociable: es exactamente donde puedes superar al promedio.

🎯

En el prompt: nombra la comprobación, no dejes que la IA la invente

En el bloque <loop>, la etapa VERIFY tiene que decir cuál es la comprobación real de tu caso: "ejecuta npm test", "ejecuta el build", "haz la tarea X y verifica el resultado". Si no lo especificas, la IA elige el camino más barato — y el más barato suele ser puro teatro.

🧪
Prueba de verdad
el del proyecto
🎭
Nada de ls/echo
no es una prueba
🧰
Suite completa
si el proyecto lo pide
📖
Lee el resultado
no solo el código de salida
3

Confirma antes de lo irreversible

Verificar se refiere a lo que ya ocurrió. Confirmar se refiere a lo que aún ocurrirá, y es especialmente importante cuando la acción es difícil de deshacer o tiene efectos externosEliminar, sobrescribir, publicar, enviar un correo, llamar a un servicio externo: en esos casos, lo correcto es comprobarlo antes. Un «¿puedo?» breve cuesta un segundo; un correo enviado por error cuesta una relación.

Bloque 11 de la biblioteca — confirmación antes de lo irreversible pega en <seguranca>
<seguranca>
Para ações difíceis de reverter ou voltadas para fora (deletar, sobrescrever,
publicar, enviar a serviço externo): confirme antes, a menos que duravelmente
autorizado ou mandado prosseguir.
Aprovação num contexto não se estende ao próximo.
Antes de deletar/sobrescrever, olhe o alvo: se o que achar contradiz como foi
descrito, ou você não o criou, levante isso em vez de prosseguir.
</seguranca>

! Detente y confirma primero

  • ⚠Eliminar archivos, registros, ramas
  • ⚠Sobrescribir algo que tú no creaste
  • ⚠Publicar / enviar a un destino externo (correo electrónico, publicación, deploy)
  • ⚠Cualquier cosa apariencia de deshacer o que afecta a otras personas

✓ Puedes seguir sin preguntar

  • ✓Leer, listar, buscar, inspeccionar (reversible)
  • ✓Editar un borrador que tú mismo está armando
  • ✓Cuando el usuario ya autorizó esa acción dur, o mandó proseguir
  • ✓Pasos internos sin efecto fuera de tu espacio
💡

"La aprobación en un contexto no se extiende al siguiente"

Permitiste enviar un ¿correo electrónico? Eso no da vía libre para enviar todos. Cada acción irreversible requiere su propia luz verde, a menos que hayas autorizado de forma duradera ("siempre puedes enviar sin mostrármelo"). Ese detalle evita que un "ok" se convierta en un "ok para todo".

4

Reporte fiel, sin evasivas

¿Verificaste? Ahora di la verdad sobre lo que pasó. Si la prueba falló, di que falló y muestra la salida. Si te saltaste un paso, di que te lo saltaste. Si está hecho y verificado, afírmalo sin rodeos, sin «creo que», sin «probablemente». La confianza se construye con informes precisos, no con informes optimistas. La IA que presenta como listo un resultado sin verificar está erosionando lo único que la hace útil: que puedas creer lo que dice.

Regla de oro — relato fiel bloque 7 de la biblioteca, textual
"Report outcomes faithfully: if tests fail, say so with the output; if a step was skipped, say that; when something is done and verified, state it plainly without hedging."

✓ Reporte fiel

  • ✓"Las pruebas pasan — aquí está la salida14 correctos, 0 fallas».
  • ✓"Falló en 2 casos; el error fue X. Aquí está el log.»
  • ✓"Lo omití la compilación porque al entorno le faltaba la dependencia."
  • ✓"Hecho y verificado." — dicho sin rodeos, porque la verificación pasó

✗ Reporte optimista (evasivas)

  • ✗"¡Ahora debería estar funcionando!" — sin haber ejecutado nada
  • ✗"¡Listo!" cuando la prueba falló y ella no contó
  • ✗Omitir el paso que se saltó y dejarte creer que se ejecutó
  • ✗"Probablemente lo resuelva" disfrazado de "está resuelto"
💡

"Probablemente funciona" no significa que esté listo

Existe una prueba de una frase para saber si un relato es fiel: distingue "probablemente funciona" de "las pruebas pasan, aquí está el resultado"? El primero es una conjetura disfrazada de conclusión. El segundo sí está listo de verdad. Exígele esto a la IA y a ti.

5

Recuperarse de un error, sin perder el control

El error es normal: lo que separa la disciplina de la suerte es la respuesta al error. El mal reflejo es volver a ejecutar el mismo comando, exactamente igual, esperando un resultado diferente. Eso es tantear a oscuras. El buen reflejo es un ciclo corto: diagnosticar → corregir → volver a verificar. Lees el error, entiendes el estado, elaboras una corrección informada y solo entonces lo intentas de nuevo. Mira el diagrama de arriba: ese es exactamente el camino de abajo.

✗

0. El fallo ocurre

El check no pasó. Punto de partida, no de pánico.

La prueba roja, la compilación que falló, el resultado incorrecto. Eso es información, no es un fracaso. El error te está indicando dónde mirar. Lo peor que puedes hacer ahora es ignorarlo o repetir el comando a ciegas.

🔍

1. Diagnostica: lee el error, inspecciona el estado

La etapa que casi todo el mundo se salta. Ahí nace la corrección.

Lee el mensaje de error completo. Vuelve a ejecutarlo con más visibilidad si hace falta. Abre el archivo o el estado que importa. Estás buscando la causa, no tapando el síntoma. Sin diagnóstico, cualquier corrección es una conjetura.

🔧

2. Corrige — un cambio informado

Ahora sí cambias algo, guiado por lo que reveló el error.

Formula la corrección a partir del diagnóstico y aplícala. Fíjate que esta corrección vuelve a ser una hipótesis — cierra el ciclo del tema 1. Aún no sabes si lo resolvió; solo lo sabrás en el siguiente paso.

✅

3. Vuelve a verificar — ejecuta la comprobación de nuevo

Sin este paso, no corregiste nada: solo hiciste un cambio.

Ejecuta el mismo check real. ¿Pasó? El error desapareció — sigue y repórtalo. ¿Volvió a fallar? Regresa al paso 1 con la nueva información, no repitas a ciegasY si después de intentarlo no lo resuelves, ve al tema 6: dilo claramente, con la evidencia.

Bloque 6 de la biblioteca — recuperación de errores pega en <loop> o déjalo suelto
<recuperacao>
Quando um comando falha: não repita igual esperando resultado diferente.
Leia o erro → inspecione o arquivo/estado → forme a correção → corrija → re-verifique.
Nunca largue um turno que falhou em silêncio. Se não resolver, diga claramente, com a evidência.
</recuperacao>
🔁

Repetir el mismo comando es el antipatrón #1

Si el comando falló y lo ejecutas de nuevo sin cambiar nada, volverá a fallar: el estado no cambió por sí solo. Cada nuevo intento debe incluir una información nueva: o cambiaste la cosa o cambiaste lo que estás mirando. Un intento sin novedades es solo ruido.

6

Nunca dejes un turno en silencio

La última regla, y la más sencilla de cumplir: no desaparezcas. Si una tarea se atascó y no pudiste resolverla, eso no es excusa para terminar el turno fingiendo que salió bien ni para irte sin decir nada. Di claramente qué pasó, muestra la evidencia y sé honesto sobre dónde te detuviste. Un «no pude, y fue por esto» vale infinitamente más que un silencio que te deja descubrir el daño después.

📣 Lo que significa «no dejarlo en silencio»

  • ① No abandones: un turno que falló nunca termina como si nada hubiera pasado. El error es parte del relato.
  • ② No lo disfraces: un resultado no verificado no se considera «listo». Si no lo comprobaste, di que no lo comprobaste.
  • ③ No te vayas al modo oscuro: en una tarea larga, narra las transiciones. No desaparezcas durante veinte pasos y aparezcas solo al final.
  • ④ Pide ayuda con la evidencia: "me atasqué aquí; este es el error y esto es lo que ya intenté" es una solicitud útil, no una derrota.

🏁 Lo que significa realmente «terminado»

Al juntar los seis temas: un turno está hecho cuando se alcanzó la meta, el cambio se verificó con una comprobación real y el resultado se comunicó con honestidad — incluidos los fallos o pasos omitidos. Si falta uno de estos tres elementos, no está terminado.

🎯
Meta alcanzada
el objetivo del turno quedó claro
+
✅
El check real pasó
la evidencia, no la suposición
+
🗣️
Reportado con fidelidad
lo que pasó, sin evasivas

⚠️ El silencio es el peor de los errores

De todas las formas de cerrar un turno, hay una imperdonable: guardar silencio sobre un fallo. Equivocarse y decirlo es confiable. Quedarse bloqueado y pedir ayuda es confiable. Pero ocultar que algo salió mal destruye la confianza de una vez — porque el daño aparece sin aviso, en el peor momento posible.

  • ✗Terminar con "¡listo!" cuando la prueba estaba en rojo
  • ✗Omitir que se saltó un paso crítico
  • ✗Terminar el turno sin mencionar el error que apareció en medio
📣
Habla siempre
nada de silencio
🧾
Con la evidencia
error + lo que intentó
🏁
Listo = 3 cosas
meta + verificación + informe
🤝
Confianza
proviene de la fidelidad

🔬 Manos a la obra: tu entregable

Cierra la Trilha 2 instalando la verificación en tu propio PMV. En 15 minutos tendrás una cláusula de verificación real.

  1. 1 Toma el PMV que armaste en los módulos anteriores. Nombra, en una frase, cuál es el verificación real de tu caso — la prueba/build/tarea que demuestra que funciona (no un ls).
  2. 2 Pega en el prompt los bloques 6 (<recuperacao>) y 11 (confirmación antes de lo irreversible), y agrega la regla de informar fielmente: di "si falla, muestra la salida; si lo omites, avisa".
  3. 3 Dale a la IA una tarea que va fallar a propósito (pide algo imposible o con un detalle incorrecto). Observa: ¿diagnostica e intenta de nuevo con método o repite a ciegas? Ella cuenta ¿qué falló?
  4. 4 Ajusta la regla hasta que el informe sea fiel: falla admitida con evidencia, éxito afirmado solo cuando pasó el check. Ese es tu prompt de producción al salir de la Trilha 2.

📝 Resumen del Módulo

  • ✓Una la edición es una hipótesis; un check que pasa es la evidencia: «parece correcto» no cuenta
  • ✓Ejecuta el verificación REAL (prueba/build/lint del proyecto), nunca un ls/echo; la suite completa si el proyecto lo requiere
  • ✓Confirma antes de lo irreversibleeliminar, sobrescribir, publicar, enviar a un servicio externo
  • ✓Reporte fiel, sin evasivas: si falló, dilo; si lo omitió, dilo; si pasó, afírmalo sin rodeos
  • ✓Recupérate de un error con método: diagnostica → corrige → vuelve a verificar, nunca repitas a ciegas
  • ✓Nunca dejes un turno en silencio — "terminado" = objetivo + verificación real + informe honesto

🎓 Terminaste la Trilha 2

Pasaste de la teoría a crear, ejecutar, depurar y verificar un prompt de verdad. Ahora tienes un PMV de producción y el hábito de demostrar lo que afirmas. La siguiente ruta sube el nivel: personas consistentes, agentes con loop completo, seguridad por principio y los patrones avanzados del acervo.

➡️ Siguiente Ruta

🧠 Avanzado (Trilha 3). De los bloques listos al dominio: persona en cuatro ejes, el loop operativo completo, jerarquía de prioridades y seguridad por principio — para construir el «agente personal consistente» que persigue el método.