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