# Malla de Contexto (/docs/malla-de-contexto)

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 [#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 [#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](/docs/referencia/api/malla-de-contexto/list-context-nodes) o
  [la vista previa del lienzo](/docs/referencia/api/malla-de-contexto/context-preview).

## Límites [#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 [#en-esta-sección]

- [Nodos y aristas](/docs/malla-de-contexto/nodos-y-aristas): capas, tipos, estados y relaciones.
- [El lienzo de una ejecución](/docs/malla-de-contexto/lienzo-de-una-ejecucion): cómo se arma, paso a paso.
- [Presupuesto y métricas](/docs/malla-de-contexto/presupuesto-y-metricas): los números y cómo leerlos.
- [Ciclo de vida y memoria](/docs/malla-de-contexto/ciclo-de-vida-y-memoria): cómo envejecen los nodos y cómo
  aprende la malla de cada ejecución.