# Nodos y aristas (/docs/malla-de-contexto/nodos-y-aristas)

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 [#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.

| Capa | Le llega a |
|---|---|
| `workspace` | Todas las ejecuciones del workspace |
| `project` | Las ejecuciones de issues de ese proyecto |
| `agent` | Las ejecuciones de ese agente |
| `issue` | Las ejecuciones de ese issue. Es obligatoria |

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

## Tipos y ranuras [#tipos-y-ranuras]

| Tipo | Ranura por defecto |
|---|---|
| `rule`, `convention` | `instructions` |
| `skill` | `tools` |
| `memory` | `memory` |
| `plan` | `state` |
| `doc`, `adr`, `repo`, `artifact`, `glossary` | `knowledge` |

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 [#lo-que-lleva-cada-nodo]

| Campo | Qué es | Por defecto |
|---|---|---|
| `weight` | Su peso al puntuar, de 0 a 10 | `1.0` |
| `pinned` | Fijado: es obligatorio | `false` |
| `state` | `active`, `warm`, `cold` o `archived`. Sólo `active` y `warm` llegan al lienzo | `active` |
| `sensitivity` | `low`, `moderate` o `high` | `low` |
| `verified` | Si una persona lo dio por bueno. Un nodo sin verificar pesa menos | `true` si lo crea una persona |
| `helpful_count`, `harmful_count` | Cuá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 [#aristas]

| Relación | Qué hace al armar el lienzo |
|---|---|
| `depends_on` | Si el origen entra, el destino entra con él (hasta cuatro saltos para los nodos obligatorios) |
| `supersedes` | El origen sustituye al destino: el destino queda fuera |
| `contradicts` | Choque: 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_from` | Desde 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 [#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`.