Ciclo de vida y memoria
Cómo envejecen los nodos de la malla y cómo aprende de cada ejecución el bucle de lecciones.
La malla cambia sola. Cada hora recalcula el estado de cada nodo según su uso y su utilidad. Al terminar cada ejecución, el agente deja lecciones y opina sobre el contexto que recibió, y la malla lo incorpora sin reescribir lo que ya sabe.
Sólo se añade. Nada se reescribe.
El ciclo de vida
Cada hora, y cuando un admin pulsa Recalcular ciclo de vida en la Malla de contexto, cada nodo recibe una puntuación:
puntuación = peso × (1 + útil) / (1 + útil + 2 × estorbo) × e^(−días sin uso / 30)Los días cuentan desde su último uso o, si nunca se usó, desde que se creó. Con esa puntuación, el nodo pasa a un estado, en este orden:
| Condición | Estado |
|---|---|
| Está fijado | active |
| Tres marcas dañinas o más, y más dañinas que útiles | archived |
| Puntuación ≥ 0,5 | active |
| Puntuación ≥ 0,25, o verificado y creado por una persona | warm |
| Puntuación ≥ 0,1 | cold |
| El resto | archived |
Sólo los nodos active y warm llegan a los lienzos. Un nodo archivado se puede restaurar desde la web.
El bucle de lecciones
El agente escribe sus lecciones
Antes de terminar, el agente deja .hqf/LESSONS.md en su worktree, con este formato:
## Lessons
- [section: errores] Los handlers devuelven el error; no llaman a panic. [scope: project]
## Feedback
- helpful: ctx-1a2b3c4d
- harmful: ctx-5e6f7a8b (habla de la API vieja)Las lecciones de menos de 12 caracteres se descartan. ctx-… es el identificador que cada nodo lleva en el lienzo.
Durante la tarea, el agente también puede guardar una lección con hqf agent remember.
El daemon la entrega
Al terminar la tarea, el daemon manda el fichero al servidor, que redacta los secretos. Si la tarea se canceló, no se aprende nada de ella.
El Curador la aplica
El Curador es determinista y trabaja en una sola transacción:
- Una lección parecida a una memoria que ya existe (similitud de texto de 0,6 o más, en la misma capa) no crea otro nodo: suma un «útil» a la existente.
- Una lección nueva crea un nodo de memoria sin verificar, con peso 0,8. Va a la capa que pidió el agente o, si no pidió ninguna, a la del proyecto del issue (a la del workspace, si el issue no tiene proyecto). Si no cabe en la audiencia del issue, baja a la capa del issue.
- El feedback suma «útil» o «estorbo» sólo a nodos que estaban en el lienzo de esa tarea.
Cada cambio queda como un delta en el Historial de deltas del nodo.
Revisar la memoria
Malla de contexto → Memoria del equipo lista las lecciones de los agentes. Las que verificas pesan más en los lienzos siguientes; las que estorban, archívalas. En la tarea, la pestaña Lecciones muestra lo que dejó esa ejecución.