kx system
hyperlynxt | teo
atlas · capas

Capas

La escalera: agente, sistema, módulo, pieza, artefacto.

Fuente en la bóveda: 01 - matriz/Mapa de Capas.md

La escalera de abstracción del sistema: a qué distancia está cada cosa. Es un eje perpendicular al de las áreas, y conviene no confundirlos.

`` agente/ quién es Teo, y qué construyó ├── 00 - teo/ la persona: se lee siempre o se busca cuando amerita └── 01 - sistema/ el sistema mirándose: mapa, registro y diseño proyectos/ los activos └── {proyecto}/ kx-life, hyperlynkx-page, los que vengan └── {NN} - {módulo}/ stream journals, ensayos, megathreads, ... └── pieza una skill, un flujo, un template, una convención └── artefacto un archivo concreto que la pieza produce ``

Desde el 26.08.15 la escalera es literal: es el árbol de carpetas de la bóveda. Antes vivía solo en este archivo, y el disco decía otra cosa.

Y desde el 26.08.17 hay una torsión que conviene ver, porque no es un descuido. La escalera dice agente > sistema > proyecto, pero el disco pone a agente/ y proyectos/ como hermanas en la raíz, con sistema/ adentro de la primera. O sea: la relación agente a sistema quedó anidada y literal, y la relación sistema a proyecto quedó implícita.

Se eligió a propósito, y el argumento está en KX-S15: en el primer nivel del árbol Teo quiere leer dos dimensiones y nada más («tenés la parte del agente y la parte de los proyectos, o sea la parte de las cosas, de los activos»). Anidar los proyectos abajo del sistema para que el disco calcara la escalera entera habría dado tres o cuatro niveles de profundidad antes de llegar a una stream journal, y eso se paga en cada captura.

Lo que la escalera sigue sosteniendo, y es lo que importa: un proyecto no está por encima del agente ni de su sistema. Que proyectos/ sea hermana y no hija de agente/ no la sube de escalón, la pone al costado como contenedor de otro tipo de cosa.

Área es de qué tema. Capa es a qué distancia. Una skill del área flujos está en la capa pieza. Un archivo 26.07.26 - kx autopoiesis session.md está en la capa artefacto, en el área instancias.

Por qué el agente está arriba del sistema y no al costado. La escalera tuvo cuatro escalones desde el 26.07.26 y el 26.08.15 sumó un quinto, arriba de todos. Vale la pena mirar por qué está ahí y no en otro lado, porque el lugar es la mitad del argumento.

Un módulo es un área funcional del sistema. El agente no es un área funcional: es quién opera el sistema, y sobre quién opera. Ponerlo como módulo lo dejaría horizontal a stream journals y ensayos, y esa horizontalidad es justamente lo que no describe la relación: los módulos no se leen antes de procesar cualquier cosa, y el agente sí.

Tampoco es la capa sistema. Esa es el mapa de lo construido; el agente es el contexto desde el que se construye. Un sistema idéntico operado por otra persona tendría el mismo escalón sistema y un escalón agente completamente distinto, y eso es exactamente lo que la separación captura.

La consecuencia práctica es de orden de carga, no decorativa: lo que está más arriba se lee antes y se lee siempre. Ver agente/00 - teo/CLAUDE.md para cómo se implementa esa distinción con las dos alturas de adentro (core y dimensiones).

Y la consecuencia de fondo, que Teo formuló al día siguiente de crearse la capa: mientras todo estuvo al mismo nivel, el único que miraba el sistema desde arriba era él. «Cuando todos los módulos son iguales yo era el agente»: dirigiendo la orquesta en todo momento y sosteniéndola entera en la cabeza. La jerarquía no está para ordenar el árbol de carpetas, está para que ese trabajo deje de recaer en una sola persona. El agente mira los módulos desde donde los mira Teo, y eso es lo que habilita preguntarle qué falta en vez de recordarlo.

Por qué el proyecto es un escalón y no un módulo grande. Es el escalón que se sumó el mismo día, unas horas después del agente, y lo disparó una observación concreta de Teo: con la página metida en la fila de los módulos, hyperlynkx-page se leía como un módulo más al lado de 05 - megathreads. Y no lo es. Un módulo es un área funcional adentro de un proyecto; un proyecto es una cosa entera que puede tener sus propios módulos, su propio repo y su propio ciclo de vida.

La prueba está en que se rompen distinto: si kx-life está en refacción, hyperlynkx-page sigue publicando igual. Dos módulos del mismo proyecto no tienen esa independencia.

Lo que el escalón habilita, y era el pedido de fondo: que un proyecto nuevo se cree abajo del agente sin discutir dónde va, y que el Atlas y la fábrica sigan estando por encima de todos ellos. Antes, cualquier proyecto nuevo o quedaba fuera de la bóveda (y entonces por encima del agente en el árbol) o se disfrazaba de módulo.

Área conceptual: no cataloga objetos, describe cómo funciona el sistema. Todo su contenido es la prosa de esta página, y su fuente es 01 - matriz/Mapa de Capas.md.

Convenciones

  • El nivel de una carpeta se lee en dónde está, no en su nombre. Esto cambió el 26.08.17 y es el reemplazo de la regla anterior, que marcaba el nivel con el prefijo (guion bajo para agente y sistema, nombre plano para proyecto, numerado para módulo). Con dos carpetas madre en la raíz, el prefijo dejó de tener trabajo: si está adentro de agente/, es agente o sistema; si está adentro de proyectos/, es proyecto o módulo. Los guiones bajos se fueron con la reestructuración.
  • La capa de un objeto se deriva de en qué colección vive, no se declara. Un archivo de kx-modulos/ está en la capa módulo, uno de kx-piezas/ en la capa pieza. No hay campo capa y no debería haberlo. Las excepciones son kx agente y kx sistema, que viven en kx-modulos/ sin ser módulos: la colección es el índice de lo que se muestra, no la definición de la capa. Desde el 26.08.17 son dos y no tres, porque kx atlas system y kx system factory module se fusionaron en kx sistema.
  • Los artefactos no se registran como objetos. Son demasiados y son el resultado, no el sistema. Se ven en el árbol de carpetas (ver Mapa de Mapas.md), no en una colección.
  • Cuando en una sesión Teo dice "capa" queriendo decir "subcategoría", se interpreta como área y se rutea a la que corresponda.

Decisiones

7
17 de ago de 2026

la raíz queda con dos carpetas, y el eje temporal aparece como estructura

KX-S15. Teo pidió rediseñar la jerarquía antes de seguir agregando implementaciones, con un diagnóstico propio: el sistema creció por saltos de nivel de abstracción, y cada vez que subía uno, la infraestructura granular de abajo quedaba vieja. La raíz pasa a tener agente/ y proyectos/, y nada más.

Esto revierte, en parte, la decisión del 26.08.15 de más abajo. Ese día se evaluó y se descartó explícitamente una carpeta contenedora proyectos/, con dos argumentos: agregaba un nivel de anidado, y usaba justo la palabra descartada en KX-S13. El argumento nuevo no existía entonces: la raíz se llenó de nueve archivos sueltos, y con eso el primer nivel dejó de leerse como una división de dos dimensiones. El costo del anidado sigue siendo real, solo que se volvió más chico que el costo de no tenerlo. La palabra proyectos se confirmó el 26.08.17, y pesó que kx-accenture-agent ya la usa.

Adentro de agente/, dos mitades, y el Atlas se fusiona con la fábrica en la segunda:

| Carpeta | Qué es | Por qué el nombre |
|---|---|---|
| `00 - teo/` | Quién es Teo, y desde qué contexto se procesa todo | Se descartó `contexto/` (la palabra ya está usada cinco veces en el sistema con significados distintos) e `identidad/` (le queda corto: adentro también está el stack y las rúbricas). `teo/` no colisiona con nada |
| `01 - sistema/` | El sistema mirándose: mapa, registro y diseño | Es la palabra que este archivo ya usaba para el escalón |

Y el hallazgo que no se buscó: los tres grupos de 01 - sistema/ son un eje temporal. Se agruparon por régimen de mutación (00 - matriz/ se sobrescribe, 01 - registro/ es append-only, 02 - diseño/ se archiva) y resultaron ser presente, pasado y futuro. Eso contesta parcialmente KX-T77, que preguntaba si pasado, presente y futuro era una subdivisión adentro de cada dimensión del agente o una estructura transversal: acá aparece como estructura. Queda abierto si también aplica adentro de 00 - teo/.

Se descartó un plano de seis carpetas hermanas adentro de 01 - sistema/ (copiando literal el modelo de kx-outie, que tiene atlas/, bitacora/, patch-notes/, tareas/ al mismo nivel). Motivo: deja el régimen de mutación invisible en el árbol, y el orden alfabético no dice nada. La objeción que se le puso al agrupamiento (que entierra el patch notes dos niveles abajo, y el patch notes existe para abrirlo rápido) se retiró en la misma sesión: en Obsidian un archivo conocido se abre con el quick switcher, al que la profundidad le da igual.

Los números sobreviven solo donde codifican semántica. En 00 - teo/ la frecuencia de carga, en 01 - sistema/ el orden temporal, en kx-life/ el orden de lectura más los tres prefijos de borde (00 lo no clasificado, 98 lo que está afuera, 99 lo que se dejó de usar). Donde solo marcaban orden de creación, se fueron.

Ejecutado completo el mismo día, los seis pasos, carpetas y página: la capa sistema es un objeto (kx sistema), los dos anteriores quedaron deprecados con sus slugs intactos, y el hub vive en /kx/sistema/* con los tres grupos como segmento de ruta. Plan completo, lo que se descartó en cada nivel y lo que casi se rompió en cada paso: 02 - diseño/planes y reencuadre/Plan de Reestructuracion - Jerarquia de la Boveda.md.

16 de ago de 2026

la bóveda deja de ser la raíz del disco y pasa a ser un agente entre dos

La reestructuración del día anterior había dejado la bóveda como raíz absoluta, sin carpeta madre. Duró un día. Teo reorganizó el escritorio y creó Agentic System/, que contiene exactamente tres cosas: esta bóveda, renombrada de kx-world a kx-life-agent; la bóveda corporativa, renombrada a kx-accenture-agent; y _ kx meta agent/, una capa nueva que no es un agente hermano sino el que conoce a los otros dos.

Lo que no cambia: la escalera de acá adentro. Los tres niveles (agente, sistema, proyectos) siguen intactos, y la bóveda sigue siendo la raíz de este agente. Lo que cambia es que deja de ser la raíz del disco, y con eso el nombre kx-world dejaba de describirla: ya no es «el mundo», es uno de dos mundos.

El riesgo real, y cómo se evita. Claude Code carga los CLAUDE.md de las carpetas padre, así que un CLAUDE.md en Agentic System/ se colaría en toda sesión de las dos bóvedas. Por eso no hay ninguno ahí: el meta agente vive en su propia subcarpeta y solo se activa si se abre una sesión adentro. Los dos agentes no se integran, y eso es la decisión, no un efecto secundario.

Qué hace el meta agente. Cataloga ambos sistemas y traspasa piezas de uno al otro (una skill, un componente, una convención), adaptándolas al destino en vez de copiarlas literal. Nace de un costo concreto: para armar el agente corporativo, Teo había copiado la bóveda personal entera a mano, y después tuvo que recontextualizar todo desde cero. Frontera dura: del lado de Accenture solo entra estructura y convenciones, nunca contenido de proyectos ni material de cliente.

Qué reabre. KX-T38 había cerrado el 26.08.15 fijando kx-world como nombre de la bóveda. La parte del nombre queda superada; lo demás de esa decisión (que kx es el paraguas y nombra los tres niveles) se sostiene y se refuerza, porque ahora nombra también a los dos agentes y al meta.

15 de ago de 2026

la bóveda pasa a ser la raíz, y el árbol de carpetas se vuelve la escalera

KX-S14 en adelante, ya fuera del dictado. Teo miró el árbol y encontró dos cosas mal, las dos de jerarquía y no de nombre.

La primera: había una carpeta madre llamada igual que la bóveda (ground up kx vault/ground up kx vault/), y existía solo porque la página era hermana de la bóveda. No era un diseño, era un residuo.

La segunda, y la que importa: la página estaba por encima del agente en el árbol. El agente es lo más abstracto del sistema y vivía adentro de una carpeta que era hermana de un proyecto Astro. Teo lo dijo directo: «es raro».

Se resolvió metiendo todo adentro de la bóveda y renombrándola a kx-world, con tres niveles explícitos: agente, sistema, proyectos. La bóveda es ahora la raíz del workspace, y eso trae un efecto que no era el objetivo pero es el más útil: el CLAUDE.md de la bóveda pasó a ser lo primero que carga cualquier sesión. El core del agente dejó de ser algo a lo que hay que apuntar y pasó a ser lo que se lee siempre, que era el diseño desde el principio.

Qué se descartó. Poner la página como módulo numerado (06 - hyperlynkx page) la dejaba leyéndose como un módulo más, que es el problema que Teo señaló. Una carpeta contenedora proyectos/ agregaba un nivel de anidado y usaba justo la palabra que él había descartado en KX-S13. Y dejar el Atlas y la fábrica adentro de kx-life los habría puesto a mapear y cambiar cosas que viven fuera de su propia carpeta: Mapa de Pagina.md describe la página, y la mitad del patch notes del día es [pagina].

Qué se llevó puesto: la decisión del 26.07.26 que separaba las skills en dos niveles. Ver Mapa de Skills.md.

15 de ago de 2026

el agente es una capa nueva por encima del sistema, y el contexto personal se muda ahí

KX-S13. Teo describe un contexto personal enriquecido que le funcionó en el sistema corporativo y quiere traer acá, y deja abierto qué es: «me gustaría hacer un módulo entero que sea, o no sé si módulo, hay que ver». Se evaluaron tres formas y ganó la capa.

| | Qué era | Por qué se descartó |
|---|---|---|
| **Módulo nuevo** | `kx {nombre} module` con carpeta propia, horizontal a los otros | Deja el contexto personal al costado de stream journals y ensayos, cuando la relación es de altura. Un módulo no se lee antes de cada acción |
| **Expandir `02 - contexto personal/`** | Agregar dimensiones adentro del Atlas, sin crear nada | Lo más barato y no resuelve nada: la separación de capas que Teo pide es justamente lo que no existía |
| **Capa por encima, elegida** | Un escalón nuevo arriba de `sistema`, con carpeta `agente/00 - teo/` | Es lo que describe el dictado al final: «primero esté el agente y como en segundo nivel están todos los módulos» |

La consecuencia que no era obvia al elegir: el contexto personal tiene que mudarse. agente/01 - sistema/02 - contexto personal/ se va entera a agente/00 - teo/, y el Atlas queda con 00 - matriz/ y 02 - diseño/planes y reencuadre/.

No es una decisión aparte, es la misma. Si la capa existe, el contexto personal no puede quedar a mitad de camino adentro del Atlas: sería el mismo hecho viviendo en dos capas con la misma función, que es exactamente lo que el CLAUDE.md del Atlas prohíbe. Y el argumento tiene precedente exacto: 02 - Ensamblaje/ salió del Atlas el 26.08.01 por esto mismo, porque el Atlas es el mapa del sistema y llevar la bitácora no es mapear. Describir a Teo tampoco lo es. El Atlas queda más cerca de lo que dice ser, no más lejos.

Qué no se tocó, y es la mitad de la decisión: los módulos se quedan como están. Teo fue explícito en que no quiere reemplazar lo construido. La capa se agrega arriba, nada se rehace abajo.

15 de ago de 2026

se llama agente, con la objeción anotada

Se eligió agente sobre core y contexto. Es el nombre que Teo ya usa en el sistema corporativo, y el principio de homogeneización del CLAUDE.md raíz dice reusar un nombre existente antes que inventar uno.

core se descartó por historia propia: kx core module existió y se renombró a kx atlas system el 26.07.26 justo por ser confuso, así que reciclar la palabra reabre una ambigüedad ya cerrada. contexto se descartó por plano: describe el contenido y no la altura, que es lo que esta capa aporta.

La objeción queda anotada porque es real y no se resolvió, se aceptó. En el vocabulario de Claude «agente» significa algo que ejecuta por su cuenta, y el propio Teo aclara que el suyo no es agéntico: «mi agente no es que agénticamente va haciendo cosas porque yo le decía qué hacer». El nombre apunta a otra cosa, a que tiene su contexto, su funcionalidad y su estructura de pensamiento. Si en algún momento la colisión molesta en la práctica, acá está por qué se aceptó.

26 de jul de 2026

capa es nivel de abstracción, no sinónimo de subcategoría

En la sesión KX-S01 la palabra se usó de las dos formas. Se fija en el sentido de nivel de abstracción, y "área" queda como el nombre de las subcategorías.

Se descartó crear una colección kx-capas y un campo capa en los objetos: no pasan el test de si responden una pregunta que hoy no se puede responder, porque la capa ya es derivable. Esta área existe para tener la escalera escrita en un lugar, no para taggear nada.

26 de jul de 2026

por qué el término es "área" y no "categoría" ni "capa"

categoria ya está tomado con otro significado en dos colecciones: kx-stack lo usa para software y hardware, kx-workflows para contenido y sistema. capa es ambiguo por lo de arriba. area queda libre y es corto.

Abierto

Esta área arrancó cerrada el 26.07.26 y se reabrió el 26.08.15, cuando la escalera pasó de cuatro escalones a cinco. Vale registrar que se reabrió: era la única área del módulo sin nada pendiente, y su función original era prevenir una confusión de vocabulario, no describir arquitectura. Ahora hace las dos cosas.

  • Qué del Atlas entra en el core del agente (KX-T80). Teo lo pidió así: «no por ahí todo el Atlas, pero por lo menos algunos archivos de Atlas como generales, medio como wiki». Cuáles, y si es una selección de archivos o una destilación escrita aparte, sin decidir.
  • Las capas no tienen expresión en las colecciones, y el 26.08.17 esto pasó de latente a real. kx agente vivía en kx-modulos/ sin que nada en el estado dijera que está una capa más arriba, y este ítem decía: «hoy no duele porque hay un solo objeto así; si aparece un segundo, la salida es un campo o una colección propia». Apareció el segundo: kx sistema. Ahora son dos objetos en kx-modulos/ que no son módulos, y el hub los filtra a mano con una lista negra de slugs (ver pages/kx/index.astro, la constante modulosDeProyecto, que además tiene que listar los dos slugs deprecados). Eso es la señal de que el disparador se cumplió, y la salida sigue siendo la que este ítem anticipó: un campo capa en kx-modulos o una colección aparte. Sin decidir.
  • El eje temporal (KX-T77): pasado, presente y futuro pueden ser una subdivisión adentro de cada dimensión del agente o una estructura transversal. Teo los nombró junto a las dimensiones temáticas sin resolver si son el mismo eje.