Malla de Contexto
El contexto de tus agentes como un grafo de nodos tipados, del que sale el lienzo que recibe cada ejecución.
Un agente trabaja tan bien como el contexto que recibe. La Malla de Contexto guarda ese contexto como un grafo: reglas, convenciones, documentos, decisiones, memoria del equipo. De ahí sale, para cada ejecución, un lienzo con un presupuesto de tokens, armado sin LLM y con cada decisión registrada.
El tejido es estable. El lienzo cambia con cada tarea.
Cómo funciona
La malla tiene nodos y aristas. Un nodo es una pieza de contexto: una regla («los errores se devuelven, no se tiran»), un documento, una ADR, una lección que dejó un agente. Cada nodo vive en una capa (workspace, proyecto, agente o issue) y va a una ranura del lienzo. Las aristas dicen cómo se relacionan: uno depende de otro, uno sustituye a otro, dos se contradicen.
Cuando un agente reclama una tarea, el servidor arma su lienzo. Toma los nodos activos de las capas que tocan
a esa tarea, los puntúa por peso, utilidad y relevancia, resuelve los choques, sigue las dependencias y elige hasta
llenar el presupuesto. El resultado llega al agente en .hqf/CONTEXT.md, en seis ranuras:
| Ranura | Qué lleva |
|---|---|
instructions | Reglas, convenciones y las instrucciones del agente |
knowledge | Documentos, ADRs, artefactos y el resto de lo que sabe el equipo |
tools | Las skills: los patrones que el agente puede seguir |
memory | Las lecciones que dejaron otras ejecuciones |
state | El plan y el estado de la tarea |
query | Lo que se le pide ahora |
Lo que no cabe o no aplica queda fuera, con su razón: no cabe en el presupuesto, perdió un choque, no tiene relación con la tarea. Lo ves después de cada ejecución.
Dónde lo ves
- Malla de contexto, en el menú: el grafo, la lista de nodos, la memoria del equipo y la salud de la malla.
- Contexto, en cada tarea: el lienzo que recibió esa ejecución, con lo que entró, lo que quedó fuera y los tokens por ranura.
- La vista previa del lienzo, en el issue, antes de lanzar al agente.
- En la API, bajo
/api/w/{ws}/context/y/api/w/{ws}/tasks/{tid}/bundle. Empieza por listar los nodos o la vista previa del lienzo.
Límites
La relevancia se calcula por palabras en común entre el nodo y la tarea, no por significado. La base de datos tiene una columna para embeddings, pero hoy ningún código la usa. El ensamblado es determinista: la misma malla y la misma tarea dan el mismo lienzo.
En esta sección
- Nodos y aristas: capas, tipos, estados y relaciones.
- El lienzo de una ejecución: cómo se arma, paso a paso.
- Presupuesto y métricas: los números y cómo leerlos.
- Ciclo de vida y memoria: cómo envejecen los nodos y cómo aprende la malla de cada ejecución.