Archivos que cambian juntos

Algunos archivos van en pareja. Una ruta y su validador. Una migración y el tipo que la refleja. Un componente y el archivo de tokens que lee. Nadie lo deja por escrito, y rara vez se nota en la estructura de carpetas, pero todo el equipo lo sabe después de unos meses.

Pathrule lo aprende del propio trabajo. Cuando tus agentes registran lo que hicieron, cada entrada incluye las rutas que tocaron. Si dos rutas aparecen una y otra vez en el mismo trabajo, Pathrule registra que cambian juntas. En un espacio de trabajo de Cloud, además, arranca con ventaja gracias a tu historial de git, así que la señal resulta útil desde la primera semana y no después de unos meses.

Qué aporta a la recuperación

Tanto el alcance por ruta como la coincidencia por significado parten de donde estás. El cambio conjunto añade los archivos que tienes al lado.

Cuando el asistente trabaja en /apps/api/payments/refund.ts, la recuperación ya tiene en cuenta lo que está fijado a esa ruta y lo que coincide con la intención. El cambio conjunto permite que también suba el conocimiento vinculado a las rutas que suelen cambiar con ella. Así, una regla sobre el escritor del libro contable puede llegar a una sesión que nunca mencionó el libro contable, porque en este código los reembolsos y el libro contable siempre se han editado juntos.

Esto importa sobre todo para el conocimiento que a nadie se le ocurrió vincular en dos lugares. Una decisión registrada una sola vez, en el archivo donde se tomó, puede igualmente llegar a las sesiones que la necesitan.

Qué ve el asistente

En un espacio de trabajo de Cloud, el cambio conjunto aparece en el contexto que un agente pide a Pathrule (mediante pathrule_get_context) en tres lugares:

• Un aviso. Cuando un archivo vecino cambia con especial frecuencia junto con el archivo que tiene delante el asistente, este recibe una sola línea que lo indica: ese archivo suele cambiar junto con este. Como máximo una línea, y solo cuando la relación es fuerte, para que se lea como una advertencia y no como ruido.
• Rutas relacionadas. Junto con el contexto de una petición enfocada o profunda, el asistente recibe una lista breve de las rutas que suelen cambiar con la que está trabajando.
• Áreas acopladas en una respuesta profunda. Cuando un agente pide contexto profundo, la respuesta nombra las partes del espacio de trabajo acopladas al área en cuestión, con los títulos de las memorias, reglas y skills vinculadas a ellas.

Esto se obtiene por separado, de modo que si falla la obtención, el turno no pierde las memorias y reglas a las que debía acompañar.

Cómo se mide la relación

Un par registrado cuenta cuando ambas rutas aparecen en el mismo trabajo registrado. Compartir carpeta no basta, y tampoco que tareas distintas las cambien el mismo día. La unidad es un único trabajo, porque eso es lo que indica una dependencia real y no una coincidencia de estructura.

Las relaciones se reconstruyen a partir de la actividad reciente, así que una relación que deja de darse se va desvaneciendo sin que nadie tenga que eliminarla. Una refactorización que separa dos archivos se refleja en que su relación se debilita durante las semanas siguientes.

La ventaja inicial del historial de git

Un espacio de trabajo nuevo todavía no tiene trabajo registrado, que es justo cuando más ayudaría conocer a los vecinos. Por eso, en un espacio de trabajo de Cloud, la primera vez que un agente pide a Pathrule contexto profundo, el runtime local lee las rutas de archivos del historial reciente de git. Los archivos cambiados en el mismo commit forman un par, y los commits muy grandes, que suelen ser refactorizaciones o renombrados, se omiten porque emparejan todo con todo. Los pares de rutas resultantes, con la frecuencia de cada par, se guardan en el espacio de trabajo en Pathrule Cloud.

Esto ocurre una sola vez, sin pedir confirmación, y no lee nada más que rutas de archivos. A medida que tu equipo registra trabajo, las relaciones que registra pesan más y la carga inicial desde git pesa menos, así que la imagen pasa de cómo cambió el código en el pasado a cómo trabaja tu equipo con él ahora.

De qué se construye y de qué no

La señal se construye solo a partir de rutas de archivos: las rutas del trabajo que registran tus agentes y, en un espacio de trabajo de Cloud, las rutas de archivos del historial reciente de git. Pathrule no lee tu código fuente, tus diffs ni tus mensajes de commit para calcularla, y nada de un archivo aparte de su ruta forma parte de ella.

Un espacio de trabajo local, usado sin cuenta, no tiene carga inicial desde git. Sus pares salen solo del trabajo registrado, lo que tiene una consecuencia práctica que conviene conocer: necesita un historial de edición real. Un espacio de trabajo en el que cada tarea registrada toca exactamente un archivo no produce ningún par, porque no hay nada que emparejar. En ese caso, la recuperación sigue funcionando con el alcance por ruta y el significado, y el cambio conjunto no aporta nada en lugar de adivinar.

Además, funciona por espacio de trabajo. Las relaciones aprendidas en un espacio de trabajo no se trasladan a otro, y la señal está sujeta al mismo control de acceso que el resto de tu conocimiento.

Dónde mirar

El cambio conjunto funciona en segundo plano, así que no hay nada que configurar ni que activar. Se vuelve más útil a medida que tu equipo registra más trabajo, que es lo mismo que hace más útiles los episodios de trabajo y las sugerencias. Si tus agentes ya registran su trabajo, esto ya se está acumulando. Lo que Pathrule calcula detalla lo que Pathrule lee de una copia de trabajo.