PathruleLa capa de contexto
para programar con IA.
Una capa de contexto indexa por ruta las memorias, reglas y skills de un equipo y entrega solo la parte que aplica a los agentes que usa ese equipo, antes de la primera llamada a herramienta. Estas son las cinco formas en que lo hacen los equipos, y cómo saber cuál encaja.
Sin capa de contexto
- El asistente abre el módulo de pedidos, lee el esquema, sigue los imports hasta precios e impuestos, y lee el gestor de descuentos para deducir dónde se asocia un cupón.
- Escribe un cambio plausible que aplica el descuento al total del pedido. El diff compila. Está mal justo de la manera que el equipo ya conoce.
- Un revisor lo detecta, vuelve a explicar la convención de la línea de pedido y el ciclo se repite. El conocimiento sigue en la cabeza de una persona.
- Muchos archivos leídos, muchas llamadas a herramientas, una ventana de entrada larga y un giro equivocado que cuesta un ciclo de revisión.
Con capa de contexto
- La porción que corresponde a la ruta de pedidos llega desde el hook, antes de la primera llamada a una herramienta. El modelo ya sabe que los cupones se asocian a la línea de pedido.
- Aplica el descuento a la línea de pedido a la primera, porque la regla estaba en el contexto antes de empezar.
- Una regla estricta puede bloquear un cambio que asocia el descuento al sitio equivocado antes de que llegue al código, así que la corrección ocurre antes de la revisión, no después.
- Una ventana de contexto corta y centrada, y un cambio preciso, porque solo se inyectaron las reglas de esta ruta.
Cinco formas de dar contexto a un agente.
- Archivos de instrucciones
- elígelo cuando
- Una persona, un repositorio, pocas convenciones
- el conocimiento llega
- En cada turno, entero
- sobrevive a un cambio de herramienta
- No, cada herramienta lee su propio archivo
- falla
- Con la segunda persona o el segundo agente: cada herramienta quiere su propia copia.
- API de memoria
- elígelo cuando
- Estás integrando memoria en tu propio producto
- el conocimiento llega
- Cuando algo la consulta
- sobrevive a un cambio de herramienta
- Sí, si controlas el punto de llamada
- falla
- Silenciosa por diseño. Una restricción por la que nadie preguntó nunca llega.
- Búsqueda vectorial
- elígelo cuando
- La respuesta está escrita, pero no se sabe dónde
- el conocimiento llega
- Cuando algo la consulta
- sobrevive a un cambio de herramienta
- Sí, aunque el índice lo tienes que mantener tú
- falla
- No puede devolver una decisión que no está en ningún archivo.
- Entorno de trabajo para agentes
- elígelo cuando
- El cuello de botella son los agentes en paralelo
- el conocimiento llega
- Por sesión, no por ruta
- sobrevive a un cambio de herramienta
- No es la cuestión: es la herramienta
- falla
- Un segundo checkout del repositorio no decide qué conocimiento corresponde a cada lugar.
- Capa vinculada a rutas
- elígelo cuando
- Una persona con varios motores, o un equipo en un repositorio
- el conocimiento llega
- Antes de la primera llamada a una herramienta, acotado a la ruta
- sobrevive a un cambio de herramienta
- Sí, el conocimiento vive fuera de todas las herramientas
- falla
- Excesiva para una persona con un solo agente.
Dos de estos no son competidores. Una API de memoria dentro de tu propio producto y una capa de contexto para tus agentes pueden convivir sin problema.
Cuándo no necesitas una.
Una persona, un repositorio, un agente y convenciones que caben en una página: un CLAUDE.md versionado es la respuesta correcta y una capa de contexto es una carga extra. El punto de ruptura no es el tamaño del repositorio, ni tampoco el del equipo. Es el segundo agente o la segunda persona, lo que llegue antes. Un solo desarrollador que usa Claude Code y Codex en el mismo repositorio ya tiene el problema: lo que le enseñas a uno, el otro no lo sabe, y cada uno lee un archivo distinto.
Lo que lleva una capa de contexto
- MemoriasLo que ha aprendido el equipoLos datos del tipo "eso ya lo probamos y no funcionó" que desaparecen cuando se va el ingeniero que los aprendió. Vinculados a la ruta donde se aplican. Más: memoria persistente para agentes de programación con IA.
- ReglasQué hacer o evitarRestricciones orientativas y estrictas. Las barreras firmes (nada de
console.logen/apps/web) y las preferencias suaves (mejor exportaciones con nombre en/packages/ui). Más: reglas para agentes de programación con IA. - SkillsProcedimientos de varios pasosProcedimientos que el equipo ya ha resuelto: cómo añadir una migración, cómo lanzar un feature flag, cómo hacer la revisión de seguridad. Se pueden invocar por su nombre. Más: skills para agentes de programación con IA.
- Indexado por rutasEl conocimiento vive cerca de su trabajoCada memoria, regla y skill está vinculada a una ruta. Una regla para
/services/billingnunca se activa cuando el modelo trabaja en/apps/mobile.
Un solo archivo vs. capa de contexto
- Los archivos de instrucciones nativos pueden vincularse a rutas y compartirse mediante el control de versiones.
- El costo en tokens crece de forma lineal con las reglas del equipo.
- Un asistente por archivo. Cambiar de herramienta hace perder el conocimiento del equipo.
- Lo edita cualquiera con permiso de push. Sin revisión estructurada.
- El conocimiento se transmite de boca en boca.
- Porción vinculada a la ruta del directorio en el que trabaja el modelo.
- El costo en tokens depende de la porción relevante, no del conjunto completo de reglas.
- Una capa, muchos asistentes. Cambiar de herramienta no devuelve al equipo a cero.
- Grafo de conocimiento revisable, con el acceso al espacio de trabajo controlado en el servidor y un detector de reglas obsoletas.
- El conocimiento se escribe una vez y llega automáticamente a la sesión del siguiente compañero.
Asistentes de programación con IA compatibles
Claude CodeCLAUDE.md, hooks con hook de prompt, MCP
CodexAGENTS.md, hooks con hook de prompt, MCP
Cursor.cursor/rules, hooks de sesión y de herramientas, MCP
GitHub CopilotArchivos de instrucciones, hooks de sesión y de herramientas, MCP
WindsurfArchivo de reglas y MCP, sin hooks- Cualquier cliente MCPMemoria por MCP
Preguntas frecuentes.
¿Qué es una capa de contexto para programar con IA?
La capa de enrutamiento entre el conocimiento tipado de un equipo (memorias, reglas y skills) y los asistentes de programación con IA que usa ese equipo. Indexa ese conocimiento por ruta y, desde los hooks, entrega al modelo solo la porción relevante, antes de la primera llamada a una herramienta.
¿En qué se diferencia una capa de contexto de CLAUDE.md o AGENTS.md?
CLAUDE.md y AGENTS.md son archivos planos que envían todas las instrucciones en cada turno. Una capa de contexto está un nivel por encima: guarda el conocimiento en un grafo indexado por rutas y envía al modelo solo el subárbol que corresponde, así que cada instrucción que ve el modelo importa de verdad para la ruta actual.
¿Una capa de contexto es una herramienta de programación con IA?
No. Una capa de contexto no genera código, no ejecuta inferencia ni sustituye a tu IDE. Es la capa entre tu equipo y el asistente de programación con IA que elijas, y hace que cada sesión sea más inteligente sin atar al equipo a una sola herramienta.
¿Qué lleva una capa de contexto?
Tres tipos de conocimiento tipado del equipo: memorias (lo que has aprendido), reglas (qué hacer o evitar) y skills (procedimientos de varios pasos). No lleva tu código fuente ni un índice de tu repositorio.
¿Cómo implementa Pathrule la capa de contexto para programar con IA?
Pathrule guarda el conocimiento del equipo en un grafo indexado por rutas, expone un único servidor MCP y llega a cada agente de la forma que este permite: hooks, incluido un hook de prompt, para Claude Code y Codex; hooks de sesión y de herramientas para Cursor y GitHub Copilot, y un archivo de reglas para Windsurf. Al modelo solo se le entrega la porción que coincide con el directorio de trabajo actual.
¿Una capa de contexto ve el código fuente?
No le hace falta. Pathrule no sube automáticamente el código fuente de tu repositorio. En modo Cloud, Pathrule Cloud almacena las memorias, reglas y skills que escribe el equipo, el comienzo de cada prompt se envía para priorizar lo que aplica, y pathrule snapshot, cuando lo ejecutas tú o tu agente, sube el árbol de archivos, los manifiestos, breves muestras de la documentación y los metadatos recientes de git. En modo local no hay cuenta. El desglose completo está en la página de Seguridad.
¿Qué herramienta de contexto debería elegir?
Depende del problema que tengas de verdad. A una persona que usa un agente en un repositorio le basta con un CLAUDE.md versionado. La memoria dentro de tu propio producto es cosa de una API de memoria. El conocimiento que está escrito pero es difícil de localizar es cosa de la búsqueda vectorial. Los agentes en paralelo en checkouts aislados son cosa de un entorno de trabajo para agentes. Una capa de contexto vinculada a rutas es para el momento en que entra en escena un segundo motor o una segunda persona, que para la mayoría es el segundo motor. Los cinco enfoques, y dónde falla cada uno, se explican más arriba.
¿Qué diferencia hay entre una capa de contexto y una API de memoria?
El momento de la entrega. Una API de memoria responde cuando se la consulta, así que una restricción por la que el agente nunca pensó en preguntar nunca llega. Una capa de contexto lee la ruta en la que el agente está a punto de trabajar y entrega el conocimiento que corresponde antes de la primera llamada a una herramienta, lo hubiera pedido el agente o no.
¿El RAG vectorial es una capa de contexto?
No. La recuperación vectorial encuentra texto que ya está escrito, ordenado por similitud con una consulta. Una capa de contexto lleva decisiones que no están en ningún archivo, asociadas a la ruta a la que se aplican, y puede hacerlas cumplir: una regla tiene un ámbito, una prioridad y un nivel de aplicación, mientras que un almacén devuelve texto. La similitud es una conjetura sobre la relevancia; una ruta es un hecho. En profundidad: RAG vectorial vs. contexto vinculado a rutas.
¿Necesito una capa de contexto si trabajo solo?
Trabajar solo no es realmente la cuestión; lo es cuántos agentes usas. Una persona con un agente y una página de convenciones es justo el caso en el que un archivo de instrucciones funciona bien. Una persona que usa Claude Code, Codex y Cursor en el mismo repositorio ya tiene el problema que resuelve una capa de contexto: lo que le enseñas a uno se queda dentro de él, y cada uno lee un archivo distinto. Por eso Pathrule es gratis para uso individual.