Saltar al contenido
Pathrule

documentación

Cómo se acumula el conocimiento

Pathrule es un ciclo, no un archivador. El contexto se entrega antes del trabajo, el conocimiento se captura durante él en escrituras que puedes ver y deshacer, el conocimiento inferido espera a una persona y la priorización aprende qué ayuda.

En esta página

Es fácil ver Pathrule como un lugar donde archivar a mano memorias, reglas y skills. Esa es la parte más pequeña. Lo importante es un ciclo que funciona sobre el trabajo real y mejora cuanto más lo usa el equipo.

El ciclo tiene tres pasos: entregar, capturar y puntuar. Se repiten en cada sesión.

Entregar antes del trabajo

Antes de que el asistente empiece a actuar, la parte del conocimiento de tu equipo vinculada a la ruta ya está en el contexto. No tienes que pegarla, y el asistente no tiene que salir a buscarla. Si trabajas en /apps/api/payments, aparece lo que está fijado ahí, más lo que hereda de las rutas superiores. En Claude Code y Codex, un hook de prompt lo entrega antes de la primera llamada a herramienta; Cursor y GitHub Copilot lo reciben mediante hooks de sesión y de herramientas, y Windsurf, mediante su archivo de reglas y MCP. Esta es la parte de la entrega que casi todo el mundo ve primero, y se explica en Cómo funcionan los hooks.

Capturar durante el trabajo

El conocimiento no tiene que escribirse en una sesión aparte. La mayor parte se acumula a partir del propio trabajo.

Mientras trabaja, el asistente está atento a lo que vale la pena conservar: una decisión que acabas de tomar, la solución a un problema con el que tropezaba una y otra vez, una convención que hubo que explicarle, una trampa que hizo perder tiempo. Cuando encuentra algo así, propone guardarlo como memoria, regla o skill en la ruta a la que pertenece, y lo guarda con las herramientas de escritura de Pathrule. También puedes pedirle que guarde algo directamente.

Aquí importan dos propiedades:

  • Puedes ver y deshacer cada escritura. Una escritura hecha por un asistente queda marcada como del asistente, versionada y reversible. Pathrule no edita ni elimina tu conocimiento por su cuenta: el conocimiento desactualizado o contradictorio se plantea como una tarea de actualización para que la resuelvas tú o tu agente.
  • El mantenimiento es prácticamente nulo. Como la captura acompaña al trabajo normal, la base de conocimiento crece sin la tarea adicional de escribir documentación. Aun así, puedes crear contenido directamente con la CLI, en la extensión de VS Code o desde un cliente MCP cuando quieras.

Qué se escribe automáticamente y qué espera a una persona

Algunas escrituras ocurren sin un paso de confirmación, y aquí se enumeran para que ninguna te tome por sorpresa:

  • Las escrituras propias de un asistente. Normalmente, un asistente propone primero y guarda cuando estás de acuerdo. Pathrule no añade un paso de confirmación propio delante de estas escrituras; en su lugar, hace que cada una sea visible y reversible.
  • El registro del trabajo. Lo que se entregó, lo que consultó el asistente y cómo fue el turno se registran mientras ocurre el trabajo, porque alimentan la priorización. Consulta qué calcula Pathrule.
  • Una semilla única, en un espacio de trabajo de Cloud. La primera vez que un agente pide contexto profundo, Pathrule guarda los pares de rutas de archivos que leyó del historial reciente de git, el punto de partida de los archivos que cambian juntos, y unas pocas memorias breves sobre tecnologías en la raíz del espacio de trabajo, identificadas a partir de los nombres de archivo. Para esto no se leen contenidos de archivos, diffs ni mensajes de commit.
  • El aprendizaje del proyecto. Un hallazgo al que llegó un agente leyendo tu código se guarda junto con los archivos en los que se basa y se comparte con todos los agentes del espacio de trabajo, sin paso de revisión. Llega como un consejo que hay que verificar, nunca como una regla, y solo mientras sus fuentes no cambien en esa copia de trabajo; un hallazgo que resulte incorrecto puede retirarse para todos a la vez. Consulta Aprendizaje del proyecto.

Todo lo demás que se infirió, en lugar de escribirlo una persona, espera a una:

  • El escaneo del proyecto que ejecuta tu agente cuando le pides que configure Pathrule para un proyecto propone memorias, reglas y skills, y solo se escriben las que apruebas.
  • Team Intelligence, en Pathrule Cloud, convierte la evidencia del equipo en patrones sugeridos. Solo llegan a los agentes las entradas que una persona verificó.
  • Las correcciones de conocimiento desactualizado, contradictorio o duplicado no cambian nada hasta que se resuelve una tarea de actualización, ya sea tú o un agente al que se lo pidas.

Puntuar, para que lo mejor aparezca primero

La priorización decide cuáles de los candidatos relevantes aparecen para una solicitud y en qué orden. En modo Cloud, Pathrule también registra qué conocimiento ayudó de verdad en trabajos similares y lo usa para ordenar los resultados futuros, de modo que lo más valioso aparezca primero. Las sesiones se mantienen precisas en lugar de llenarse de ruido, y una entrada que un agente considere desactualizada puede marcarse como tarea de actualización para revisarla. Consulta Sugerencias y autoauditoría para ver cómo funciona.

El aprendizaje cambia el orden, no la elegibilidad. Una entrada tiene que seguir siendo relevante para la solicitud actual. Una memoria que ayudó en varias migraciones no puede entrar en un turno de diseño sin relación solo porque tenga un buen historial.

Cómo el ruido se queda fuera del prompt

El ciclo es selectivo a propósito. De forma predeterminada, la documentación general se ofrece para revisión en lugar de importarse como instrucción activa. El conocimiento inferido espera a una persona, y cada escritura es visible y reversible. El alcance de la ruta limita dónde puede aparecer una entrada, y dentro de ese alcance sigue aplicándose la relevancia para la solicitud.

Después se miden la entrega y el uso. El conocimiento que un agente encuentra desactualizado, contradicho por el código o duplicado se plantea para revisión como tarea de actualización. Las correcciones están versionadas y son reversibles, así que el equipo puede mejorar el conjunto sin perder su historial.

El resultado es un conjunto pequeño de decisiones y trampas concretas y revisables, no un volcado de documentación de todo el repositorio. Cómo demuestra Pathrule sus afirmaciones más exigentes documenta cada filtro.

Por qué el ciclo es el producto

Un archivo estático o la memoria integrada de una sola herramienta pueden encargarse de la entrega. Lo que se acumula es el ciclo: cada tarea puede dejar al equipo un poco más sabio, y la siguiente sesión parte de ahí.

Esta acumulación no es abstracta. Cada vuelta del ciclo deja algo que la siguiente puede aprovechar: un registro medido de lo que se entregó y de cómo fue el turno, evidencia de lo que ayuda en cada tipo de trabajo, una relación entre dos archivos que siguen cambiando juntos, un fallo asociado a una ruta. Lo que Pathrule calcula enumera cada una de esas capas y lo que las alimenta. Las entradas escritas, por sí solas, no se acumulan, porque nada en ellas cambia cuando el trabajo sale bien o mal.

Como el conocimiento vive fuera de cualquier agente concreto, es portable. Las mismas memorias, reglas y skills llegan a Claude Code, Codex, Cursor, GitHub Copilot y Windsurf mediante la CLI o la extensión de VS Code, y a cualquier cliente MCP mediante el MCP local o Remote MCP. Una función de memoria nativa dentro de una herramienta no sustituye esto, porque esa memoria se queda dentro de esa herramienta. El valor duradero es el conocimiento acumulado del equipo, no una regla o un archivo de prompt en particular.