Saltar al contenido
Pathrule

documentación

Sugerencias y autoauditoría

Cómo se marca como tarea de actualización una memoria o regla obsoleta o desfasada, y cómo tu propia IA la corrige bajo tu control.

En esta página

El conocimiento del equipo se deteriora. Las rutas cambian de nombre, los hitos se entregan, las versiones fijadas de las dependencias se desfasan, una regla deja de coincidir con algo. La respuesta de Pathrule es una tarea de actualización: una marca sobre una memoria o regla que parece obsoleta, con un motivo en lenguaje sencillo, que tu propio asistente corrige bajo tu control.

La propiedad clave: una tarea de actualización solo sugiere. Pathrule nunca edita ni elimina tus memorias, reglas o skills por su cuenta.

Qué revisa la autoauditoría

La auditoría ocurre donde se detecta el desfase: en el propio trabajo. Un asistente que lee tu código es el primero en ver que una memoria describe un archivo que se movió, o que una regla contradice lo que el código hace ahora. Cuando eso pasa durante su trabajo normal, marca la entrada con la herramienta MCP pathrule_request_refresh, indicando la memoria o regla y por qué parece incorrecta. Motivos habituales:

  • Desfase. La entrada describe un estado que ya no coincide con el código, por ejemplo, un archivo que menciona se movió o ya no existe.
  • Contradice el código. La entrada dice una cosa y el código claramente hace otra.
  • Duplicado. Otra memoria o regla ya cubre lo mismo, y mejor.
  • Demasiado específica. La entrada solo aplica a un caso que dejó de existir hace tiempo.
  • Poco clara. No es posible saber qué pide la entrada.

Marcar es idempotente: marcar la misma entrada dos veces devuelve la misma tarea, así que las sesiones repetidas no acumulan duplicados. A los asistentes se les indica que marquen solo el desfase que realmente detectaron, no que salgan a buscarlo.

Una tarea de actualización no guarda nada de tu código fuente. Identifica la entrada e incluye el motivo; el asistente que la corrija después lee el código actual con sus propias herramientas de archivos.

Revisar las sugerencias

Una tarea de actualización es una invitación a tomar una decisión, no una acción. En un espacio de trabajo de Pathrule Cloud puedes gestionarlas desde la terminal:

pathrule refresh list
pathrule refresh claim <refresh-id>
pathrule refresh resolve <refresh-id> --status applied

list muestra las tareas pendientes del espacio de trabajo actual, claim devuelve el resumen completo de una tarea y la marca como en curso, y resolve la cierra como applied o rejected. Un asistente hace lo mismo por MCP con pathrule_list_pending_refreshes, pathrule_get_refresh_brief y pathrule_resolve_refresh.

Para cada tarea puedes dejar que tu asistente aplique la corrección (ver más abajo), editar la entrada tú mismo o rechazar la tarea si la entrada sigue siendo correcta.

Corregir con tu asistente

Pathrule no corrige tu conocimiento automáticamente. Pídele a tu asistente que revise las tareas de actualización pendientes. Entonces:

  1. Lista las tareas pendientes y toma una, lo que la marca como en curso para que otra sesión no la tome al mismo tiempo.
  2. Revisa el código actual y la entrada marcada con sus propias herramientas de acceso a archivos.
  3. Redacta la actualización y la guarda mediante las herramientas de escritura de Pathrule. Si pasa el id de la tarea junto con la actualización, la tarea se cierra como aplicada.
  4. Si no, marca la tarea como aplicada o rechazada de forma explícita.

Mantienes el control en ambos extremos: la corrección la ejecuta tu propio asistente, y el cambio es una edición versionada normal que puedes revisar. Consulta la referencia de herramientas MCP para ver las herramientas de actualización que usa el asistente.

Nada es irreversible

Una corrección es una edición versionada normal. Cada cambio conserva su historial y, en un espacio de trabajo de Pathrule Cloud, una entrada eliminada permanece en el archivo del espacio de trabajo hasta que se elimina de forma permanente; mientras tanto, un propietario o administrador puede restaurarla desde la configuración de la consola web. En VS Code, al eliminar algo se ofrece Undo de inmediato. Si una corrección resulta ser incorrecta, puedes revertirla como cualquier otra edición.