Ir al contenido
HQ Fabric

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:

RanuraQué lleva
instructionsReglas, convenciones y las instrucciones del agente
knowledgeDocumentos, ADRs, artefactos y el resto de lo que sabe el equipo
toolsLas skills: los patrones que el agente puede seguir
memoryLas lecciones que dejaron otras ejecuciones
stateEl plan y el estado de la tarea
queryLo 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

En esta página