Aprendizaje del proyecto

Casi todo lo que un agente aprende sobre tu proyecto lo aprende leyendo código. Por qué una cola se detiene en el primer error de red, por cuál helper pasa cada ruta de pago, cómo resolvió el equipo la última discusión sobre el manejo de errores: un agente lo deduce, lo usa y la sesión termina. El siguiente agente, o el agente de alguien de tu equipo, vuelve a pagar el costo de deducirlo.

El aprendizaje del proyecto conserva esas conclusiones. Un agente guarda lo que dedujo junto con los archivos que leyó, y todos los agentes del espacio de trabajo parten de ahí, mientras el código siga diciendo lo mismo.

Qué es un hallazgo

Un hallazgo es una conclusión a la que un agente llegó a partir de tu código, más los archivos en los que se basa y lo que contenían esos archivos cuando los leyó. Pathrule compara los archivos con lo que hay en el disco antes de aceptar el hallazgo, así que un hallazgo solo se guarda sobre código que existe.

Un hallazgo no es una memoria, ni una regla, ni una skill. Nunca se convierte en ninguna de ellas por sí solo y nunca bloquea nada. Vive en su propia capa, junto al conocimiento que escribió tu equipo.

Cómo llega a los agentes

Los hallazgos llegan en el contexto que un agente le pide a Pathrule, mediante pathrule_get_context. Vienen presentados como consejos que hay que verificar, y a los agentes se les indica que los traten como información y no como instrucciones, para que un texto colocado en un archivo no pueda convertirse en una orden permanente.

Un hallazgo solo se entrega mientras su evidencia se mantenga en tu copia local:

• Fuentes sin cambios. El hallazgo se entrega.
• Cambió una fuente. El hallazgo queda retenido hasta que un agente vuelva a leer el código y lo confirme o lo corrija. A nadie se le entrega una respuesta sobre código que ya no existe.
• Dos hallazgos no coinciden. Ambos quedan retenidos, en lugar de adivinar cuál de los dos vale.

Esta comprobación se hace por cada copia local, así que alguien de tu equipo que trabaja en una rama más antigua o más nueva solo recibe los hallazgos que son ciertos para el código que tiene delante.

Corregir y retirar

Un agente puede corregir un hallazgo registrando uno nuevo que lo reemplace, con fuentes recién verificadas. Si un hallazgo resulta ser incorrecto, la persona cuyo agente lo registró puede retirarlo. La retirada se aplica a todo el espacio de trabajo a la vez, y un reintento antiguo desde una máquina que estaba sin conexión nunca puede recuperarlo.

Los agentes pueden listar los hallazgos vigentes, desactualizados y en conflicto, incluidos los que quedaron retenidos fuera del contexto, para que una persona pueda ver exactamente qué hay en la capa y por qué algo no se entregó.

Aprender de revisiones anteriores

Con acceso a GitHub a través de tu sesión actual de gh, un agente puede leer discusiones de revisiones anteriores del repositorio para ver cómo decidió el equipo una cuestión parecida y citarlo en un hallazgo. Pathrule no almacena los comentarios en sí, y omite las revisiones de bots, las externas y las descartadas. Sin acceso a GitHub, todo lo demás sigue funcionando.

Qué sale de tu máquina

El aprendizaje del proyecto no necesita ningún modelo local y no escribe nada en tu repositorio.

En un espacio de trabajo local, los hallazgos se quedan en su almacenamiento local, en tu máquina. En un espacio de trabajo de Cloud, Pathrule comparte el hallazgo y su origen (las rutas de los archivos y una huella de lo que contenía cada archivo), para que otras copias locales puedan saber si el hallazgo sigue siendo válido. El contenido de los archivos no se sube. Un hallazgo registrado sin conexión espera en una cola y se envía cuando vuelve la conexión.

No hay paso de revisión

Un hallazgo se comparte en cuanto sus fuentes se verifican; ninguna persona lo aprueba antes. Es intencional: los hallazgos son consejos que se vuelven a comprobar contra el código en cada entrega, no políticas del equipo. Todo lo que deba ser obligatorio para todos los agentes sigue correspondiendo a una regla o a una memoria, escrita y revisada por tu equipo.

Las herramientas que hay detrás de esto aparecen en la referencia de herramientas MCP.