Conceptos clave

Pathrule tiene un modelo de datos pequeño a propósito: tres tipos de contenido, un árbol de nodos y un alcance basado en rutas. Una vez que tienes clara esa forma, todo lo demás en Pathrule se desprende de ella.

Algo que conviene tener presente mientras lees esta página: los tres tipos de contenido que se describen abajo son la superficie de autoría. Son lo que una persona escribe, edita y discute, y son entradas. Lo que recibe un agente depende de la tarea: solo las entradas que aplican al trabajo que tiene delante, priorizadas y ajustadas a esa tarea. La descripción general de la arquitectura cubre ese lado; esta página cubre lo que tú escribes.

El árbol del espacio de trabajo

Un espacio de trabajo es un árbol de nodos. La raíz es el propio espacio de trabajo. Los hijos son carpetas o archivos que reflejan las partes de tu repositorio sobre las que tu equipo escribe conocimiento.

/                            workspace root
  /apps                      folder node
    /apps/web                folder node
      /apps/web/auth         folder node
        /apps/web/auth/login.tsx   file node

No necesitas crear el árbol a mano. Cuando escribes una memoria en /apps/web/auth, Pathrule crea la cadena de nodos según haga falta. Los nodos vacíos no cuestan nada y es fácil eliminarlos más adelante si la ruta deja de ser útil.

Memorias

Una memoria es un documento breve en Markdown que alguien del equipo escribe para que el asistente pueda leerlo después.

• Hechos: notas sobre el esquema, decisiones de diseño, trampas conocidas.
• Postmortems: qué falló, qué aprendimos, cómo lo corregimos.
• Convenciones: la forma en que este equipo prefiere hacer algo.

Por defecto, las memorias son orientativas. Aparecen en el contexto del asistente cuando el hook decide que son relevantes para la ruta en la que está trabajando.

La mayoría de las memorias las escriben personas o un asistente que trabaja contigo. En un espacio de trabajo de Cloud, Pathrule también agrega algunas por su cuenta: notas breves sobre tecnologías en la raíz del espacio de trabajo, como "TypeScript project" o "Docker containerization", que reconoce a partir de los nombres de archivo la primera vez que un agente pide contexto profundo. Son memorias normales, así que puedes editarlas o eliminarlas como cualquier otra.

Reglas

Una regla es una restricción que el asistente debe respetar dentro de un alcance.

Las reglas tienen:

• Un tipo de alcance. folder significa que la regla aplica dentro de un directorio. file_type significa que aplica a un patrón de archivos como *.tsx. project significa que aplica en todo el espacio de trabajo.
• Una prioridad. high para las restricciones más importantes, medium para pautas generales, low para preferencias de estilo. La prioridad controla con cuánta fuerza aparece una regla, no si bloquea.
• Un modo de aplicación. Las reglas advisory acompañan como contexto y el asistente decide cómo aplicarlas. Una regla strict incluye una restricción ejecutable que una persona aprobó, y puede bloquear un cambio que coincida antes de que se aplique, en clientes cuyos hooks se ejecutan antes de una llamada a herramienta.
• Un cuerpo. Lo que mejor funciona es una lista breve de viñetas en imperativo.

Las reglas de mayor prioridad aparecen primero cuando su alcance coincide con la ruta actual. Las de menor prioridad aparecen cuando es probable que ayuden.

Skills

Una skill es un procedimiento con nombre que el asistente puede invocar en lugar de volver a deducir los pasos cada vez.

Ejemplos:

• replay-stripe-webhook: una lista de verificación con el comando exacto de la CLI y los pasos de seguridad antes de ejecutarlo.
• regenerate-fixtures: la ruta del script, las entradas y la salida esperada.
• release-check: la lista de verificación previa al lanzamiento que el equipo siempre quiere que el asistente recorra.

Las skills se descubren por nombre. El asistente puede pedirle a Pathrule las skills asociadas a la ruta actual y elegir la que corresponde a la tarea.

Alcance por ruta

Cada memoria, regla y skill vive en la ruta de un nodo. La ruta decide dónde aparece.

• Una memoria en /apps/web es relevante para cualquier trabajo dentro de apps/web.
• Una memoria en / es relevante en todas partes.
• Una skill en /services/billing se le ofrece al asistente cuando el trabajo ocurre dentro del servicio de facturación.

El alcance por ruta es lo que mantiene pequeña la ventana de contexto del asistente. Un ajuste de interfaz en apps/web/dashboard no necesita ver las reglas sobre migraciones de base de datos.

Prioridad y aplicación

La prioridad y la aplicación son dos ajustes independientes.

• La prioridad (high, medium, low) determina con cuánta fuerza aparece una regla. Usa high con moderación, para las restricciones más importantes.
• La aplicación (advisory o strict) decide qué pasa cuando hay un incumplimiento. Las reglas orientativas aparecen como contexto y el asistente decide cómo aplicarlas, y toda regla nueva empieza como orientativa. Un agente puede proponer una restricción ejecutable para una regla; se guarda como propuesta y no se aplica. Una vez que una persona la aprueba, el hook local revisa cualquier edición que coincida antes de que se aplique, puede bloquear el cambio y muestra la regla como motivo.

La CLI de Pathrule y la extensión de VS Code registran los hooks disponibles para Claude Code, Codex, Cursor y GitHub Copilot, y el bloqueo aplica donde el hook del cliente puede detener una llamada a herramienta. Windsurf no tiene hooks y el Remote MCP no instala ninguno: ambos reciben las reglas como contexto, sin ningún evento de bloqueo de Pathrule previo a la escritura.

Cómo encaja todo

• Lo que Pathrule calcula cubre la capa derivada que rodea a estos tres tipos de contenido escrito.
• Cómo funcionan los hooks describe cómo el entorno de ejecución elige la porción que se envía.
• Descripción general de MCP enumera las herramientas que usa el asistente para leer y escribir nodos.
• Inicio rápido es la forma más rápida de ver este modelo en acción.