Descripción general de la arquitectura

Pathrule es la capa de inteligencia que se ubica entre tú, tu espacio de trabajo y los agentes de programación que ejecutas.

Esa frase dice algo muy concreto, así que vale la pena desarmarla parte por parte. Entre tú y tus agentes, porque una parte de lo que guarda Pathrule es cómo prefieres trabajar, no datos sobre el código. Entre tu espacio de trabajo y tus agentes, porque el resto es lo que un repositorio, y el equipo que lo rodea, ha aprendido sobre sí mismo. Una capa, porque no está dentro de ningún agente: pasar de Claude Code a Codex cambia quién ejecuta, no lo que se sabe.

Lo que Pathrule no es: un modelo de programación, un IDE ni un entorno de ejecución de agentes. No escribe el código de tu aplicación, y tu agente de programación conserva su propio proveedor de modelos.

La forma del sistema

        YOU                        YOUR TEAM
         |                             |
         v                             v
 USER INTELLIGENCE   WORKSPACE INTELLIGENCE   TEAM INTELLIGENCE
  (your machine)     (memories, rules,        (Pathrule Cloud,
                      skills, findings)        human-verified)
         \                   |                    /
          \                  v                   /
           +-------->  TASK-SCOPED DELIVERY  <--+
                             |
                             v
        Claude Code / Codex / Cursor / Copilot / Windsurf

Varias fuentes de conocimiento convergen. Para un trabajo concreto, se selecciona la parte que importa para esa ruta y ese prompt, se prioriza y se entrega al agente mediante el mecanismo que admite su cliente.

Base y clientes

La CLI, la extensión de VS Code y el servidor MCP local son las piezas que instalas. Pathrule CLI, Pathrule para VS Code y Remote MCP describen cada una.

El ciclo de vida

Seis etapas. Cada una es algo que puedes observar en el producto, no un diagrama.

Observar. El trabajo produce evidencia: las memorias, reglas y skills que escriben las personas y los agentes, los hallazgos que los agentes registran sobre el código, la actividad que registran los agentes y qué se entregó a cada sesión.

Comprender. El Intelligence Engine de Pathrule determina qué significa esa evidencia para el trabajo futuro. En Pathrule Cloud, Team Intelligence analiza la evidencia del equipo y la convierte en patrones sugeridos. En una Mac con Apple Silicon, el modelo local opcional convierte lo que enseñas sobre cómo trabajas en una preferencia estructurada y basada en tus propias palabras. Todo lo inferido sigue siendo una sugerencia hasta que una persona lo aprueba.

Compilar. El conocimiento se plasma en los archivos que cada agente ya lee, como CLAUDE.md o AGENTS.md en las rutas que rige, y en un índice local que leen los hooks. Consulta compilación.

Entregar y aplicar. Para cada tarea, el conocimiento que aplica a la ruta y al prompt se selecciona, se prioriza y se entrega dentro de un presupuesto por prompt, y lo que no cabe se lista por título. Una regla puede incluir una restricción ejecutable; una vez que una persona la aprueba, el hook previo a la herramienta puede bloquear una edición que coincida en los clientes cuyos hooks lo admiten. Un requisito escrito por sí solo no crea una comprobación que bloquee.

Verificar. Pathrule registra qué entregó y qué entradas leyó después el agente, de modo que el efecto de un conocimiento se pueda medir en lugar de suponer.

Aprender. Lo que los agentes usaron de verdad influye en lo que se presenta la próxima vez. El conocimiento desactualizado se puede marcar para actualizarlo. En Cloud, los patrones del equipo pasan de borrador a sugerido y a verificado, o bien se rechazan o caducan, y solo los verificados llegan a los agentes.

Palabras que no son sinónimos

El resto de esta documentación depende de mantener estos términos separados.

• Memoria es lo que se registró. Una nota sobre una decisión, escrita en un momento determinado.
• Conocimiento es lo que ese registro significa para el trabajo futuro, junto con la evidencia que lo respalda.
• Inteligencia es el sistema que decide qué conocimiento importa y cuándo.
• Contexto es la respuesta para una tarea: lo que importa, aquí y ahora.
• Hallazgo es una conclusión que un agente registró sobre el código. Es un consejo, se contrasta con el código en cada entrega y nunca se convierte en regla por sí solo.
• Sugerencia es algo que Pathrule o un agente infirió y que una persona no ha aprobado. No se considera confiable.
• Conocimiento verificado es algo que una persona aprobó.
• Regla es una restricción que una persona estableció para un ámbito. Su forma ejecutable solo se aplica después de que una persona la aprueba.
• Entrega es lo que realmente llega al agente para una tarea. Agent IR lo describe.

Una memoria es una entrada. El contexto es una salida. Ninguno de los dos es el producto.

Qué leer a continuación

• Workspace Intelligence: ámbito, autoridad, fuentes, ciclo de vida.
• User Intelligence: qué enseñas, qué controlas y por qué los requisitos del proyecto siguen teniendo prioridad.
• Aprendizaje del proyecto: hallazgos que los agentes registran a partir de tu código, compartidos como consejos.
• El modelo local: el modelo opcional en el dispositivo, su plataforma y para qué se usa.
• Knowledge IR: cómo el tipo y la autoridad de cada conocimiento se conservan durante la entrega.
• Compilación: qué escribe Pathrule en los archivos que leen tus agentes.
• Proposed Knowledge: todo lo que espera a una persona antes de considerarse confiable.
• Agent IR: lo que recibe un agente para una tarea.
• Seguridad y respaldo: qué hace Pathrule cuando no está seguro.

El límite de los paquetes abiertos

Pathrule CLI es de código abierto bajo Apache-2.0 y está publicado en npm como @pathrule/cli. Los repositorios públicos en github.com/pathrule incluyen la CLI, core, patterns y benchmarks bajo Apache-2.0, y el servidor MCP anterior bajo MIT.

Pathrule Cloud y el Intelligence Engine, que abarca la extracción, el aprendizaje, la evaluación, la selección y la priorización, además de las funciones asistidas por modelos, son propietarios. Esta documentación describe lo que hacen por ti, no cómo están construidos.

Consulta Núcleo de código abierto para ver los detalles.