Conceptos clave — ontoref
Las palabras que este proyecto usa, y qué significan
Este glosario no está escrito aquí. Se proyecta de .ontoref/ontology/glossary.ncl — el mismo fichero del que responde «ontoref describe term» en la terminal. Si una definición cambia, cambia en un sitio y cambia en los dos.
- .domains-ontoref/
- El contenedor del lado consumidor que lleva un proyecto vinculado: una subcarpeta por dominio vinculado (`.domains-ontoref/
/`). Cada subcarpeta contiene un `bonds.ncl` OBLIGATORIO (un BondSet) y una columna de implementación OPCIONAL (`ontology/schemas/`, `reflection/modes/` federados). La membresía multidominio son simplemente varias subcarpetas — nunca derivada del `repo_kind` escalar del manifest (solo-portador). Detectado por `domain.nu :: project-domains` como tipo `bonded_dir`; sustituye al marcador plano obsoleto `.{dominio}.ontoref/`, y ambos se reconocen durante la ventana de migración 0047.relacionados: Vínculo, Dominio (extensión CLI por repo_kind), Nodo ontoref - Ambient affordances
- Propiedades estructurales que hacen un entorno legible y accionable sin que nadie dé instrucciones: se ve qué se puede hacer con solo mirar. Se deja en inglés en prosa española — no hay forma asentada, e inventar una haría crecer un séptimo vocabulario justo donde el registro existe para evitarlo. Su correlato en ontoref es la arnesabilidad, con una diferencia: las affordances describen un entorno que el arnés encuentra; la arnesabilidad, un sujeto que se declara.relacionados: Arnesabilidad, GuíaMás información →
- Arista de dependencia
- La arista tipada de un vínculo por el eje de DEPENDENCIA, clasificada con una clase del Context-Map de DDD: CustomerSupplier, Partnership, OpenHostService, Conformist, SharedKernel, AnticorruptionLayer. DDD se toma prestado SOLO aquí — como el enum de tipo de la arista de dependencia — nunca como marco general (ese sigue siendo ontoref nativo: nodos / aristas / ejes / planos). El enum crece por evidencia atestiguada, nunca por especulación (enforcement-vs-emergence). Una arista `mutual` (Partnership) es el 2-ciclo que constituye un plano-ontoref. La gobernanza NO se tipa así — usa resolución (Delegate / Override / Compose).relacionados: Vínculo, Plano ontoref
- Arnesabilidad
- Propiedad de un PROYECTO, no de su arnés: cuánto puede un arnés cualquiera averiguar del proyecto PREGUNTANDO, sin que nadie se lo haya explicado antes. Se mide por lo que el proyecto declara y sirve, nunca por lo bien configurado que esté el arnés de turno. Acuñado aquí (2026-07-23) como correlato de las «ambient affordances» de Böckeler, con el eje desplazado del entorno al sujeto: las affordances describen un entorno que el arnés ENCUENTRA; la arnesabilidad, un sujeto que se DECLARA y puede generar su propia respuesta.relacionados: Arnés, Ambient affordances, SensorMás información →
- Arnés
- El envoltorio que ejecuta al modelo: contexto, herramientas, bucle. Un agente es modelo + arnés. El arnés dirige con guías y corrige con sensores. Ontoref NO es un arnés y nunca debe describirse como tal: es lo que un arnés CONSULTA — el sujeto tipado y atestiguado que sobrevive a cualquier arnés concreto y al cambio al siguiente.relacionados: Sensor, Guía, ArnesabilidadMás información →
- Colapso Yin/Yang
- Antipatrón consistente en resolver forzosamente una tensión en Espiral adoptando un polo como 'la respuesta' y descartando el otro. Suele manifestarse como un flip: Yang → Yin (p. ej. todo-centralizado a todo-scripted) o viceversa, cuando lo correcto es la síntesis — mantener cada polo en su plano apropiado.relacionados: Espiral, Síntesis, Ondaod
- Conocimiento formalizado como DAG
- Axioma del proyecto: todo el conocimiento — conceptos, tensiones, decisiones, estado — se formaliza como grafos dirigidos acíclicos. Habilita consultas transversales, análisis de impacto y visibilidad a nivel de ecosistema. La grafía 'dao-formalized' que aparece a veces en conversación es folclore para el mismo axioma.relacionados: on+re
- Dominio (extensión CLI por repo_kind)
- Una extensión CLI activada por repo_kind bajo code/domains/{id}/: el repo_kind de un proyecto enciende su dominio, dando comandos conscientes del tipo de proyecto (p. ej. DD7pasos→knowledge-works, DevWorkspace→provisioning). TODOS los code/domains/* son dominios. `schema_cmd` nombra DÓNDE vive el esquema de un dominio (en ontoref vs el proyecto implementador) — es un campo de ubicación de esquema, NO federación.relacionados: Puerta (entrada de embudo), Projection (miembro de constelación)Más información →
- Eje del vínculo
- El eje por el que corre un vínculo — uno de dos. GOBERNANZA: quién gobierna a quién, un DAG acíclico resuelto con Delegate / Override / Compose. DEPENDENCIA: quién necesita a quién, un plano que admite ciclos, tipado con una arista de dependencia DDD y opcionalmente `mutual`. Un vínculo lleva exactamente un eje; un proyecto se relaciona con un dominio por ambos declarando dos vínculos. La palabra es `eje` / `axis`, NUNCA «dimensión» — ese término queda reservado para las dimensiones de la máquina de estados del proyecto (state.ncl).relacionados: Vínculo, Nodo ontoref, Plano ontoref
- Encargo
- Paraguas de la unidad de gobierno que constriñe a un agente comprobando el entregable contra términos explícitos en vez de fiarse del operario. Un Encargo = un Pliego (los términos) + sus Órdenes de Trabajo (las ejecuciones). Dos reglas atómicas lo vuelven hábito: (1) sin alcance y contrato, no se empieza; (2) sin testigo, no está hecho. Cada elemento mata un fallo concreto: el alcance mínimo mata la deriva, el contrato refutable mata la prosa sin verificar, el testigo mata el "fíate de mi palabra", la propiedad externa mata lo de poner al lobo a cuidar las ovejas, el veredicto acotado mata la propagación de código roto.relacionados: Pliego, Orden de Trabajo (OT), Testigo verificado, GateMás información →
- Espiral
- Forma de resolución de una tensión Yin/Yang en la que ningún polo gana y el sistema oscila entre ellos, con la síntesis emergiendo del propio movimiento. En core.ncl los nodos llevan `pole = 'Spiral` cuando SON la tensión en lugar de una posición dentro de ella. Las Espirales no se colapsan — colapsar una es un antipatrón (ver colapso-yin-yang).relacionados: Síntesis, Colapso Yin/Yang, Ondaod
- Estado de vinculación
- El estado que ocupa un proyecto vinculado en la máquina de estados: None (sin vínculo), Linked (vínculo de dependencia — habita un plano), Node (vínculo de gobernanza — nodo gobernado en el DAG de un dominio) o Managed (ontoref gobierna el desarrollo del proyecto). Las transiciones son `onboard` (subir: None→Linked/Node→Managed), `update` (retipar un vínculo del mismo nivel) y `offboard` (bajar: Managed→Node→None). El vínculo es ortogonal a la gestión: un proyecto alcanza Linked o Node SIN Managed — un vínculo no necesita columna `.ontoref/`.relacionados: Vínculo, Nodo ontoref, Plano ontoref
- Gate
- Prerrequisitos tipados y políticas que controlan las transiciones de estado de la máquina de estados de un proyecto. Vive en `.ontology/gate.ncl`. Cada dimensión declara las condiciones que una transición debe satisfacer (catalizadores presentes, bloqueos despejados); la capa de reflexión evalúa la gate antes de permitir un cambio de estado.relacionados: on+re
- Guía
- Control anticipativo (feedforward) en un arnés de agentes: lo que orienta al modelo ANTES de que escriba — documentación de arquitectura, ficheros de convenciones, skills. En ontoref una guía no es un fichero que el agente deba acordarse de leer: es lo que el sujeto SIRVE cuando se le pregunta (`describe`, `qa`, las vistas por disciplina), de modo que la orientación sobrevive a la sesión y al cambio de arnés. Una guía que hay que recordar no es una guía; es un cartel junto a la carretera.relacionados: Sensor, ArnésMás información →
- Nodo ontoref
- Un proyecto visto por el eje de GOBERNANZA de un vínculo: miembro gobernado del grafo de un dominio. El eje de gobernanza es un DAG (acíclico, jerárquico): un dominio (nivel N) gobierna sus instancias/implementaciones (nivel N+1) con semántica Delegate / Override / Compose (ADR-018, ADR-045). Ser nodo dice quién gobierna y es gobernado — no quién depende de quién (eso es el plano-ontoref). Reflejo Hexagonal: un dominio expone puertos (un `provides` del catalog) que las implementaciones del nodo adaptan.relacionados: Vínculo, Plano ontoref, Dominio (extensión CLI por repo_kind)
- Ondaod
- Disciplina Dao de Ontoref. Antes de cualquier análisis arquitectónico o redacción de ADR, lee las tensiones nombradas en core.ncl, identifica cuáles activa la pregunta y describe el estado de síntesis y la dirección del movimiento — sin colapsar la Espiral eligiendo un polo. Contenido canónico en dos capas vía el CLI instalado: `ontoref qa show ontoref-dao-discipline --format json` para la línea base del protocolo, y `ontoref qa show
-dao-discipline --format json` para extensiones específicas del proyecto.relacionados: Espiral, Síntesis, Colapso Yin/Yang, adr? - Orden de Trabajo (OT)
- La capa de ejecución de un Encargo, ejecutada bajo un Pliego: prescindible, acotada, propiedad del agente. Lleva el entregable, una envoltura de observabilidad (directorio de trabajo, nivel de registro al estilo Rust, salida en JSONL, marcas de inicio y fin), el testigo verificado y un veredicto acotado ('Aceptado | 'Rechazado | 'Escalado). Un fallo muere dentro de la Orden de Trabajo en vez de contaminar la sesión. En código Rust el tipo es `WorkOrder`.relacionados: Encargo, Pliego, Testigo verificadoMás información →
- PAP
- Project's Architecture Principles (Principios de Arquitectura del Proyecto). Conjunto activo de invariantes, patrones y reglas que definen cómo se construye un proyecto concreto — derivado de sus axiomas, ADRs aceptados y prácticas nombradas. Decir que algo es anti-PAP significa que va completamente en contra de la arquitectura establecida.relacionados: anti-PAP, adr?
- Patrón de Extensión del Glosario
- Herencia en tres niveles para vocabulario: una semilla de protocolo en `reflection/defaults/glossary.ncl` que ontoref distribuye; términos de proyecto añadidos en `.ontology/glossary.ncl::project_terms` vía `d.seed_terms @ project_terms`; división opcional por dominio en `.ontology/glossary/
.ncl` cuando el proyecto pasa de ~30 términos. Sin fusión ni copia de la semilla al proyecto — herencia por import. Editar la semilla de protocolo en local está prohibido; redefinir un id de protocolo localmente lo detecta el hook de deriva. Enlaza términos locales con los del protocolo vía `related_terms` para tejer el léxico entre niveles.relacionados: on+re, Ondaod, PAP, Conocimiento formalizado como DAG - Plano ontoref
- La superficie de coexistencia que un proyecto habita por el eje de DEPENDENCIA de un vínculo. A diferencia del DAG de gobernanza, el grafo de dependencia admite ciclos: un vínculo `mutual` (Partnership de DDD — "no hay deploy sin servicio, no hay servicio sin deploy") es un 2-ciclo que CONSTITUYE un plano, donde ningún nodo gobierna al otro pero cada uno exige al otro para existir. El caso constitutivo y mutuo es donde vive el valor (plane-habitability); una dependencia de una vía (CustomerSupplier) es un plano degenerado.relacionados: Vínculo, Nodo ontoref
- Pliego
- La capa de términos de un Encargo: alcance (contexto mínimo + objetivo en una frase), un contrato refutable (una comprobación de máquina, esquema o restricción) y el modo de validación ('Maquina | 'Adversario, firmado o no). Lo posee la persona, fuera de lo que el agente puede editar — esa frontera de propiedad es lo que evita poner al lobo a cuidar las ovejas. Un Pliego autoriza muchas Órdenes de Trabajo. En código Rust el tipo es `Sow`.relacionados: Encargo, Orden de Trabajo (OT), Testigo verificadoMás información →
- Projection (miembro de constelación)
- En la taxonomía de miembros de la constelación (ADR-062), una categoría de miembro: una sola fuente cuya frontera vive DENTRO del build, nunca su propio repo git. Un Projection se materializa en cada superficie que lo necesita (assets, examples, docs), sincronizado no clonado — el driver de repo es una frontera de publicación, y un Projection no tiene ninguna propia. Contrasta con Primary (posee frontera → repo propio) y Addon (arista declarada a un Primary).relacionados: Projection (revelado de posicionamiento), Dominio (extensión CLI por repo_kind)Más información →
- Projection (revelado de posicionamiento)
- En la arquitectura de revelado (ADR-057), el acto de PROYECTAR el grafo de posicionamiento (spine.ncl + generador) sobre el site externo: puertas generadas desde un contrato estructurado, una deriva se arregla re-ejecutando la proyección, nunca editando a mano la copia servida. "La ventana se vuelve la proyección de un estado descrito, no una obra en construcción." Una disciplina de render, no una categoría de miembro.relacionados: Projection (miembro de constelación)Más información →
- Puerta (entrada de embudo)
- Una de las entradas del embudo externo proyectadas desde spine.ncl (ADR-057/064): developer / infrastructure / authoring / personal. Una puerta es un gancho de enrutado orientado a AUDIENCIA que lleva un `tag` de contenido (p. ej. developer, knowledge-works) y rutea a contenido real, nunca argumenta el core. ADR-064 fija CUATRO puertas — un eje distinto de los CINCO dominios y de la ÚNICA membrana de convergencia.relacionados: Dominio (extensión CLI por repo_kind), Projection (revelado de posicionamiento)Más información →
- Sensor
- Control por realimentación en un arnés de agentes: la comprobación que se dispara DESPUÉS de que el modelo genere, y corrige lo que una guía no pudo prevenir. Böckeler divide los sensores en COMPUTACIONALES (deterministas, baratos, milisegundos — linters, tests, comprobaciones estructurales) e INFERENCIALES (un LLM juzgando semántica: más rico, más lento, probabilístico). Ontoref adopta el término entero y le añade un eje que el canon no lleva: un sensor DECLARA QUÉ MIRÓ, y su veredicto va atestiguado. Un check en verde que no declara su alcance no es un sensor: es un arnés que miente por omisión. La severidad es tipada, no elegida: `Hard` solo es legal donde la pregunta es binaria; un sensor que vigila una tensión nombrada puede reportar deriva y dirección, nunca fallo (ADR-050).relacionados: Guía, Arnés, Arnesabilidad, Severidad Hard / SoftMás información →
- Severidad Hard / Soft
- La severidad tipada de una restricción de ADR. `'Hard` VINCULA — una violación rompe. `'Soft` SE AUDITA — se reporta y no bloquea. La severidad dice cuánto obliga la regla; no dice si alguien la comprueba, y ese hueco es la cifra de 95 sobre 212 que este proyecto guarda sobre sí mismo. Se escriben en inglés porque nombran el valor del TIPO, no un adjetivo: «fallar `Hard`», nunca «fallar en duro».relacionados: SensorMás información →
- Síntesis
- Resolución de una tensión en Espiral asignando a cada polo su propio plano de operación en lugar de elegir uno. Ambos polos permanecen activos, aplicados a aspectos distintos. La síntesis es la respuesta productiva a una Espiral; el colapso es la regresiva.relacionados: Espiral, Colapso Yin/Yang, Ondaod
- Testigo verificado
- Acta de un acto, direccionada por contenido y firmada con Ed25519, depositada en la costura witness-as-axis. Demuestra *que* una comprobación se ejecutó y qué devolvió — estructura, nunca veracidad (ADR-050). Necesaria pero no suficiente como barrera: el testigo es evidencia posterior de que X ocurrió, no una gate que impida no-X. Solo se vuelve gate cuando un punto de control se niega a continuar sin un testigo válido (p. ej. un commit rechazado salvo que lleve un testigo firmado de que la verificación previa ocurrió). Es el acta que deposita una Orden de Trabajo al completarse.relacionados: Orden de Trabajo (OT), Encargo, GateMás información →
- Vínculo
- Relación tipada entre proyectos (y sus dominios) dentro del marco ontoref — distinta de un `link`, que es una referencia genérica entre nodos (el esquema `ln`/Link). Un vínculo lleva un EJE: gobernanza (el proyecto es un nodo-ontoref en el DAG de un dominio) o dependencia (el proyecto habita un plano-ontoref con nodos pares). Un vínculo de dependencia se tipa con una clase del Context-Map de DDD (CustomerSupplier, Partnership, OpenHostService, Conformist, SharedKernel, AnticorruptionLayer) y puede ser `mutual`. Todo vínculo resuelve contra las raíces de dominio de ambos extremos — sus definiciones, atributos, estados y capacidades — nunca en la arista. El vínculo es ortogonal a la gestión de proyecto de ontoref: un proyecto puede vincularse al marco gobierne o no ontoref su desarrollo.relacionados: Nodo ontoref, Plano ontoref, Dominio (extensión CLI por repo_kind)
- adr?
- Procedimiento de evaluación que se invoca al final de una sesión o feature. Los cinco criterios deben cumplirse para justificar un ADR: (1) se rechazó conscientemente una alternativa significativa; (2) deja restricciones duraderas para futuros contribuidores; (3) revertirla exige esfuerzo coordinado multi-componente; (4) no está ya capturada en un ADR existente; (5) ondaod — tensiones activadas identificadas y estado de síntesis descrito. Se da el veredicto y la justificación de forma concisa; nada se crea sin confirmación.relacionados: Ondaod, PAP
- anti-PAP
- Enfoque que viola frontalmente el PAP del proyecto. No es 'ligeramente desviado' ni 'en tensión con' — una propuesta calificada como anti-PAP se rechaza en diseño, antes de implementar.relacionados: PAP
- on+re
- Abreviatura de la doble capa de Ontoref: ontología (`.ontology/`: core.ncl, state.ncl, gate.ncl, manifest.ncl — lo que ES) + reflexión (`reflection/`: modos, cartera de pendientes, restricciones, qa — lo que DEVIENE). Toda instancia incorporada del proyecto contiene ambas. Un proyecto puede alojar varias instancias on+re en rutas distintas.relacionados: Gate, onre, Conocimiento formalizado como DAG
- onre
- Alias de shell para el CLI `ontoref`. No es un binario aparte — se invoca como `onre
`, equivalente a `ontoref `. `onre` (on+re) sustituyó al antiguo alias `ore`. Se usa en documentación y conversación como nombre de cara al operador.relacionados: on+re