Ir al contenido
HQ Fabric

Nodos y aristas

Las capas, los tipos, los estados y las relaciones con las que se construye la Malla de Contexto.

Cada pieza de contexto es un nodo. Tiene un tipo, una capa, una ranura del lienzo, un estado, un peso y un cuerpo de texto. Las aristas los conectan, y el ensamblado del lienzo las lee para resolver choques y seguir dependencias.

Capas

La capa dice a quién le toca un nodo. Se heredan: un agente que trabaja en un issue recibe lo de las cuatro.

CapaLe llega a
workspaceTodas las ejecuciones del workspace
projectLas ejecuciones de issues de ese proyecto
agentLas ejecuciones de ese agente
issueLas ejecuciones de ese issue. Es obligatoria

Cuanto más concreta la capa, más pesa el nodo al puntuar.

Tipos y ranuras

TipoRanura por defecto
rule, conventioninstructions
skilltools
memorymemory
planstate
doc, adr, repo, artifact, glossaryknowledge

Puedes poner otra ranura al crear el nodo. Un nodo de tipo rule o convention, o de la ranura instructions, es obligatorio sea de la capa que sea: entra antes que el resto, si cabe en el presupuesto.

Lo que lleva cada nodo

CampoQué esPor defecto
weightSu peso al puntuar, de 0 a 101.0
pinnedFijado: es obligatoriofalse
stateactive, warm, cold o archived. Sólo active y warm llegan al lienzoactive
sensitivitylow, moderate o highlow
verifiedSi una persona lo dio por bueno. Un nodo sin verificar pesa menostrue si lo crea una persona
helpful_count, harmful_countCuántas veces un agente dijo que le sirvió o le estorbó0

La sensitivity controla quién lo recibe. Cada agente tiene una sensibilidad máxima (moderate por defecto), y un nodo que la supera no entra en su lienzo.

Aristas

RelaciónQué hace al armar el lienzo
depends_onSi el origen entra, el destino entra con él (hasta cuatro saltos para los nodos obligatorios)
supersedesEl origen sustituye al destino: el destino queda fuera
contradictsChoque: entra el mejor de los dos (verificado, después fijado, después mayor puntuación) y el otro queda fuera como choque
references, refines, applies_to, derived_fromDesde un nodo que entra, suben la puntuación del nodo destino

Cada arista tiene su propio peso, que multiplica lo que transmite.

De dónde salen los nodos

  • Los creas tú, en Malla de contexto → Nuevo nodo, o con POST /api/w/{ws}/context/nodes. Nacen verificados.
  • Los deja un agente: sus lecciones se convierten en nodos de memoria, sin verificar, con peso 0,8.
  • Un artefacto aprobado del SDLC (intent, spec, plan) entra en la capa del issue, fijado y verificado. Su versión anterior se archiva con una arista supersedes.
  • Una respuesta a un hueco de conocimiento puede convertirse en un nodo de conocimiento.

Para conectar dos nodos, Conectar nodos en la web, o POST /api/w/{ws}/context/edges.

En esta página