Saltar al contenido
Pathrule

documentación

Proposed Knowledge

Todo lo que Pathrule o un agente propone y que una persona todavía no aprobó. En qué se diferencia una sugerencia de un hallazgo, del conocimiento verificado y de una regla, dónde espera cada tipo de propuesta y qué cambia para tus agentes al aprobarla.

En esta página

Proposed Knowledge es todo lo que espera la intervención de una persona antes de que tus agentes puedan confiar en ello.

Pathrule y tus agentes detectan cosas todo el tiempo: una convención que un equipo sigue de forma constante, una corrección que sigue funcionando, una restricción que parece desprenderse de un párrafo. Detectar algo es una inferencia, y una inferencia no es conocimiento hasta que alguien responde por ella. Lo aprendido nunca se considera confiable de forma automática.

Cinco palabras que no son sinónimos

La diferencia entre ellas es la base de todo el diseño.

Qué es¿Llega a los agentes?
HallazgoUna conclusión que un agente registró a partir de tu código, junto con los archivos en los que se basaSí, como consejo que hay que verificar, y solo mientras sus fuentes no cambien
SugerenciaAlgo que Pathrule o un agente infirió y que nadie aprobóNo
Conocimiento verificadoAlgo que aprobó una personaSí
ReglaUna restricción que una persona definió para un ámbito; su forma ejecutable solo se aplica cuando una persona la apruebaSí, como requisito
EntregaLo que realmente le llega al agente para una tareaEs lo que les llega

De dónde vienen las propuestas y dónde esperan

Tu agente, al configurar un proyecto

Pídele a tu agente "Set up Pathrule for this project" y hará un análisis guiado: lee el proyecto, propone memorias, reglas y skills, y escribe solo las que apruebas en la conversación. Nada de lo que propone se guarda hasta que tú lo indiques.

Fuera de ese análisis, un agente que descubre algo que vale la pena conservar normalmente te lo propone antes de escribirlo. Cuando sí lo escribe, la escritura queda atribuida, versionada y se puede revertir.

Una restricción adjunta a una regla

Una regla puede incluir una restricción ejecutable: un patrón que un cambio no debe contener y qué hacer en su lugar. Cuando un agente adjunta una mediante pathrule_write_rule o pathrule_update_rule, se guarda como propuesta. No se aplica, y ningún agente puede aprobarla. Solo cuando una persona la aprueba, el hook previo a la herramienta puede bloquear una edición que coincida, en los clientes cuyos hooks lo admiten. Consulta las reglas como barreras de protección.

Team Intelligence, en Pathrule Cloud

Team Intelligence analiza la evidencia que produce el trabajo de un equipo y propone patrones. Un patrón pasa de borrador a sugerido, y un propietario o administrador de la organización lo verifica o lo rechaza en la consola web, dentro de la configuración Team guidance de la organización; una sugerencia sobre la que nadie actúa caduca. Solo los patrones verificados llegan a los agentes. Está disponible en los planes Team y Enterprise.

Tus preferencias personales

Una preferencia que enseñas con pathrule me teach se contrasta con tus propias palabras antes de guardarse. Una preferencia que todavía no está en uso aparece en pathrule me list bajo "Not in use yet" y nunca llega a un agente. pathrule me explain <id> muestra en qué se basa, y pathrule me forget <id> la rechaza. Consulta User Intelligence.

Conocimiento desactualizado

Cuando un conocimiento parece desactualizado, se puede marcar como tarea de actualización, por ejemplo, por parte de un agente que notó la desviación y llamó a pathrule_request_refresh. Una tarea de actualización es una propuesta para cambiar un conocimiento existente, y una persona o un agente la resuelve con pathrule refresh o con las herramientas de actualización de MCP. Consulta sugerencias y autoauditoría.

La excepción: los hallazgos

Los hallazgos son el único tipo de conocimiento aprendido que llega a los agentes sin paso de revisión, y eso es deliberado. Un hallazgo es un consejo, no una política:

  • solo se guarda después de comprobar sus archivos de origen en el disco,
  • solo se entrega mientras esos archivos no cambien en la copia de trabajo de quien lo lee,
  • se retiene cuando sus fuentes cambian o cuando contradice otro hallazgo,
  • y nunca se convierte por sí solo en una memoria, una regla o una skill.

Todo lo que deba ser obligatorio para todos los agentes sigue correspondiendo a una regla o una memoria, escrita y revisada por tu equipo.

Qué cambia al aprobar

Aprobar es lo que convierte una sugerencia en conocimiento verificado.

  • Una propuesta aprobada del análisis se convierte en una memoria, regla o skill normal, que se entrega como cualquier otra.
  • Un patrón de equipo verificado empieza a llegar a los agentes en los espacios de trabajo de esa organización.
  • Una restricción de regla aprobada pasa a poder aplicarse mediante el hook previo a la herramienta en los clientes que lo admiten.
  • Una propuesta rechazada sigue rechazada, para que la misma evidencia no la vuelva a traer de inmediato.

Lo que nunca hace

  • Nunca aprueba nada en tu nombre, y nada que requiera aprobación llega a un agente antes de que una persona la dé.
  • Nunca permite que un agente apruebe su propia propuesta.
  • Nunca convierte un hallazgo en una regla.
  • Nunca edita lo que escribió tu equipo sin que una persona o un agente actúe sobre una propuesta.

Para saber qué ocurre una vez que se aprueba un conocimiento, consulta Agent IR y seguridad y respaldo.