Comprobar la evidencia

Que un agente diga «implementado» no basta. Cada explicación viene con su evidencia: el código que leyó, las pruebas que ejecutó, los registros de ejecución y las capturas, a un clic de comprobarlo. Cuando alguien pregunte, puedes señalar el lugar exacto.

Qué contiene la evidencia

Abre «Evidencia» en la nota. Los tipos de material habituales son:

4export const GRACE_DAYS = 7;56export function openGrace(subscription, failedAt) {7  if (subscription.graceEndsAt !== undefined) {8    return { ...subscription, lastChargeAttemptAt: failedAt };9  }10  return {11    ...subscription,12    graceEndsAt: addDays(failedAt, GRACE_DAYS),13    lastChargeAttemptAt: failedAt,14  };15}1617export function inGrace(subscription, now) {18  return subscription.graceEndsAt !== undefined19    && now < subscription.graceEndsAt;20}

La salida de comandos, los diffs y las capturas proceden de los registros que el agente dejó al implementar. Noea guarda en cada turno qué comandos ejecutó y qué capturas hizo, de modo que una explicación puede citarlos directamente.

Mira una ubicación de código

Una ubicación de código en mitad de una frase suele mostrarse como el nombre de una función o variable, como openGrace; si no, se muestra como un chip «archivo:línea», como grace.ts:6-18. Si una explicación cita dos archivos con el mismo nombre, el chip añade la carpeta superior.

Deja el puntero sobre un nombre o chip para ver la ruta completa, el intervalo de líneas y el símbolo. Haz clic y el panel de código se abre a la derecha para ese archivo, en las líneas citadas. Si el archivo sigue como lo dejó un turno de implementación, los cambios de ese turno se superponen sobre todo el archivo, así que puedes ver qué turno escribió esas líneas. El menú del botón derecho puede abrir el archivo con su aplicación predeterminada, mostrarlo en Finder o copiar su ruta.

Si el código se ha movido desde entonces, los números de línea del chip y adónde te lleva siguen su posición actual. Si el código citado ha cambiado y solo se encuentra su nombre, el chip aparece atenuado; si el archivo ya no existe o el código ya no se encuentra, el chip aparece atenuado y tachado, y al pasar el cursor se indica el motivo. En ambos casos, lo más probable es que haya que investigar de nuevo la explicación.

Hasta dónde llega la evidencia

Cuando mires un material, primero distingue de qué tipo es:

Explicar e Investigación se apoyan sobre todo en leer código y material existente; no vuelven a ejecutar las pruebas, las compilaciones ni la aplicación cada vez. El agente verifica algo solo cuando leer el código no basta para fijar un hecho del que depende la conclusión. Una buena evidencia dice lo que no verificó, como «No se ejecutó contra el proveedor de pagos real; los resultados del cobro proceden de un doble de prueba». Cuando la evidencia es escasa, no se encontró ninguna implementación o la intención es ambigua, la evidencia y la atención deben decirlo con claridad en lugar de ofrecer una conclusión que solo parece segura.

Ten presente también que una explicación es un registro de investigación con evidencia, no un certificado. Que un agente revise la implementación de otro agente no hace por sí solo que el resultado sea más seguro. El valor de la evidencia es que puedes abrirla y comprobarla, no que la explicación diga «confirmado».

Capturas e interfaz

Algunos comportamientos no se pueden fijar solo con el código, como si un aviso aparece realmente en la interfaz. Si el agente hizo una captura al implementar, la explicación puede enumerarla como evidencia, por ejemplo «Durante el periodo de gracia, aparece un aviso en la parte superior de la página de ajustes del equipo».

Haz clic en la miniatura para ampliarla. Fíjate en qué página muestra, en qué estado y qué ejecución la dejó: una captura demuestra el aspecto que tenía la interfaz entonces; si el código ha cambiado desde entonces, la interfaz puede haber cambiado también.

Comprueba elemento por elemento

Cuando compruebes la evidencia, pregunta de cada elemento:

• ¿Esta referencia señala aquello de lo que trata esta parte de la intención?
• ¿Qué casos cubren las pruebas y están entre ellos los casos límite?
• ¿El resultado respalda realmente la conclusión de la explicación?
• ¿La evidencia dice lo que no se verificó?

Por ejemplo, la evidencia del periodo de gracia dice «se ejecutaron las pruebas del periodo de gracia: las 6 pasan», mientras que la atención anota que «ninguna prueba cubre el caso en que el tercer reintento tiene éxito». Ahora sabes que ese camino se apoya solo en la lectura del código, sin ninguna ejecución que lo demuestre.

Cuando la evidencia no basta

Si falta un caso clave, pasa el cursor sobre el párrafo, haz clic en «Preguntar sobre esto» a su izquierda y pide al agente que lo verifique:

Añade una prueba: el tercer reintento tiene éxito el día 6 del periodo de gracia, así que la suscripción vuelve a la normalidad y no baja de plan. Dime el resultado cuando se haya ejecutado.

Cuando el agente termina, Noea explica el turno por su cuenta; si lo desactivaste, haz clic en «Investigación» a la izquierda del párrafo. La nueva explicación enumera esta ejecución como evidencia.

Si la conclusión de la explicación no coincide con su evidencia, o crees que el agente interpretó mal tu intención, pregunta también aquí, y no cambies tu intención para adaptarla al código. Consulta Escribir lo acordado en la intención.