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/
ArtefactoEl 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
ConceptoPropiedades 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.
evitar
  • affordance como propiedad de una OPERACIÓN — qué puede hacer, qué debe valer antes de ejecutarse, si puede deshacerse. Eso es un contrato de capacidad y este término no lo nombra. Avistado el 2026-08-22 en yu-evolution-of-ontology, que pasa «de entidades y relaciones a affordances y acciones» justo en ese sentido: precondiciones, efectos y reversibilidad declarados de una operación. El sentido registrado es el de Fowler — propiedad de un ENTORNO que el arnés encuentra legible, no de un acto que puede ejecutar. Las dos lecturas son defendibles en inglés y la lista de alias ya reclama «affordance» y «affordances», así que quien busque el sentido de operación aterriza en esta entrada queriendo decir otra cosa.
relacionados: Arnesabilidad, GuíaMás información →
Apoptosis
Conceptonace de ADR · adr-089Muerte programada: el colapso deliberado de una célula que habilita la reconstitución. Proyección a escala celular de `pole-collapse` — un colapso elegido y registrado, frente a uno padecido. Una célula cuyo caso pagado ya no existe, o cuya afirmación ha absorbido otra, se retira A PROPÓSITO y su linaje deja constancia; lo que no debe hacer es seguir en el censo respondiendo 'pass a una pregunta que ya nadie hace.
evitar
  • Llamar apoptosis al abandono: una célula que ya nadie evalúa está abandonada, no retirada por diseño
  • Retirar una célula sin dejar constancia en el linaje — una muerte sin documentar no se distingue de una pérdida
relacionados: Colapso Yin/Yang, Célula, Linaje, Latencia celularMás información →
Arista de dependencia
ConceptoLa 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).
evitar
  • tipar un vínculo de gobernanza con una clase DDD (DDD es solo del eje de dependencia)
relacionados: Vínculo, Plano ontoref
Arnesabilidad
ConceptoPropiedad 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
ArtefactoEl 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.
evitar
  • Llamar arnés a ontoref. Los dos posts publicados apuestan por la distinción: el arnés ejecuta al agente, el sujeto es lo que el arnés consulta.
  • Nombrar `*-harness` («*-arnés») a cualquier componente de ontoref: un id de nodo, un módulo, un perfil, un verbo de la CLI. La prohibición anterior va sobre la afirmación; esta va sobre la etiqueta, y la etiqueta filtra la afirmación: quien llega desde los posts lee `X-harness` como el envoltorio del agente, nombre lo que nombre en realidad. Detectado y reparado el 2026-07-26, al renombrar el nodo `audit-harness` (el ejecutor de comprobaciones) a `audit-runner`: el término queda fijado para lo que ejecuta el MODELO, y todo lo que ontoref ejecuta son sensores. Quedan exentas las citas al fichero de sesión .coder/2026-07-05-audit-harness-consolidable.plan.md: un nombre de fichero es historia, no un nombre en uso.
relacionados: Sensor, Guía, ArnesabilidadMás información →
Colapso Yin/Yang
AntipatrónAntipatró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.
así se usa
  • El primer borrador era full systemd (colapso Yang→Yin); la objeción forzó la síntesis
evitar
  • Tratar el colapso como 'al fin tener claridad' — es pérdida de dimensión
relacionados: Espiral, Síntesis, Ondaod
Conocimiento formalizado como DAG
Conceptonace de Axioma · dag-formalizedAxioma 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
Consistencia no es corrección
ConceptoUn check que pasa acredita CONSISTENCIA — que todo lo que miró concuerda — y nunca CORRECCIÓN, que es una afirmación sobre un dominio que al check nadie le dio. La formulación es de Nicolas Figay, en «The Other Ceiling»: un razonador que no devuelve contradicción ha verificado el fragmento que recibió, no el dominio. Su segunda mitad viaja con ella — la decidibilidad no es adecuación: que una máquina siempre pueda responder una pregunta no la convierte en la pregunta que valía la pena hacer. Aquí nombra el límite de todos los gates que este proyecto ejecuta. `validate ontology` respondía «0 hallazgos» mientras el axioma self-describing declaraba tres artefactos que no existían; la respuesta era consistente y no era correcta. El remedio nunca es fiarse más del verde: es declarar lo que el gate NO mira, y por eso un hallazgo que se cierra tiene que decir hasta dónde llega el suelo que lo cerró.
así se usa
  • `ontoref validate ontology` informando «61 nodos · 175 aristas · 0 hallazgos» sobre un axioma cuyos tres artefactos declarados llevaban meses sin existir — expediente 0/10.
  • Una regla de provisión con cierre-en-fallo que juzgaba la recuperación por un código de salida que `describe ` devuelve como 0, de modo que 111 bytes de texto de ayuda volvían como nivel materializado — expediente 111/0.
evitar
  • Leer un gate en verde como afirmación sobre el mundo y no sobre su propia extensión.
  • Cerrar un hallazgo sin declarar lo que el gate nuevo NO cubre: el verde carga entonces con una afirmación que nadie hizo.
  • Citar la formulación sin atribución: es vocabulario adoptado, y la fuente está bajo custodia justamente para que la cita se pueda comprobar.
relacionados: Severidad Hard / Soft, Sensor, Gate, Testigo verificado
Célula
Conceptonace de ADR · adr-088Unidad con un núcleo constitucional y una interfaz de expresión, que participa en procesos operativos y cuya validez la determina su participación real, no su forma. El núcleo no tiene estado y es portable; la memoria, el rol y la cadencia pertenecen al tejido que la expresa. Esa separación no es orden: es lo que hace posible la exportación, porque una célula que carga su propia historia no puede cruzar — esa historia no significa nada en el tejido que la recibe. Su veredicto es ternario ('pass | 'fail | 'unknown), y 'unknown es de primera clase: una célula que declara lo que NECESITA para responder informa 'unknown allí donde ese alcance falta, en vez de excluirse por contexto, que la volvería a soldar a un sitio.
evitar
  • Guardar memoria, rol o cadencia dentro de una célula — cada una de las tres es lo que impediría exportarla
  • Llamar célula a un predicado que no puede alterar ninguna decisión en ningún circuito (ver making-a-difference)
  • Tratar 'unknown como error o como fallo: es la única vía por la que lo imprevisto entra en el modelo
relacionados: Tejido, Núcleo, Membrana, Linaje, Marcar diferencia, GateMás información →
Diferenciación
Procedimientonace de ADR · adr-089Expresar una célula en un tejido sin colapsar su definición: aquí se fijan diana, umbral, circuitos y rol, y el núcleo no se toca. Proyección a escala celular de `synthesis` — la célula conserva su definición general Y adquiere una expresión concreta, en vez de que una sustituya a la otra. La diferenciación no cambia el linaje. En términos de nivel es lo que adr-018 llama Delegate, Override o Compose: una instancia toma la célula del dominio sin cambios, aporta la suya propia para el mismo id, o la envuelve.
evitar
  • Modificar el núcleo y llamarlo diferenciación — eso es una mutación y exige autoría
  • Diferenciar de un modo que cambie lo que la célula AFIRMA en lugar de cómo se expresa
relacionados: Síntesis, Célula, Tejido, Epigenética, LinajeMás información →
Dominio (extensión CLI por repo_kind)
Conceptonace de ADR · adr-064Una 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 domains. `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.
así se usa
  • knowledge-works es un dominio activado por repo_kind KnowledgeBase/ContentProject
evitar
  • NO leer schema_cmd como federación — es dónde vive el esquema, no un enlace cross-dev
  • NO confundir un dominio (activado por repo_kind) con una puerta (entrada de embudo de marketing): ADR-064 fija 4 puertas, y los domains son ahora SEIS — el dominio-de-sí `gov` se añadió el 2026-08-24, después de que ADR-064 contara cinco
relacionados: Puerta (entrada de embudo), Projection (miembro de constelación)Más información →
Eje del vínculo
ConceptoEl 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).
evitar
  • dimensión (reservada para las dimensiones de la máquina de estados)
relacionados: Vínculo, Nodo ontoref, Plano ontoref
Encargo
Prácticanace de ADR · adr-063Paraguas 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.
así se usa
  • Encargo #0: hacer cumplir 'config NCL como fuente de verdad' sobre el fallo que abrió la entrevista
evitar
  • Dejar que el operario redacte el contrato en el mismo gesto con que lo cumple
relacionados: Pliego, Orden de Trabajo (OT), Testigo verificado, GateMás información →
Epigenética
Conceptonace de ADR · adr-089La vía rápida: modulación contextual de cómo se expresa una célula, sin tocar su núcleo — sin alterar su constitución. Es la contraparte de la vía constitucional lenta, y el par es lo importante — las dos velocidades son lo que permite a un tejido adaptarse a diario mientras la identidad y el linaje cambian rara vez y con autoría. Todo lo epigenético es local y reescribible, y puede persistir en su tejido; lo que no hace es cruzar el sobre de linaje, porque una marca es una coordenada en el espacio de expresión de un tejido y no significa nada en el de otro.
evitar
  • Usar la vía rápida para esquivar un núcleo que debería haberse mutado — repetir anulaciones locales por el mismo motivo es prueba de que la afirmación está mal, no de que el tejido sea especial
  • Hacer que algo epigenético forme parte de lo que cruza a otro tejido
relacionados: Diferenciación, Núcleo, Tejido, CélulaMás información →
Espiral
Conceptonace de Tensión · ontology-vs-reflectionForma 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 pole-collapse).
así se usa
  • La revisión del ADR (G→H) es el momento ondaod: quédate en Espiral, no saltes de polo a Yin/automatizado
relacionados: Síntesis, Colapso Yin/Yang, Ondaod
Estado de vinculación
ConceptoEl 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
Artefactonace de Esquema · ontology/schemas/gate.nclPrerrequisitos tipados y políticas que controlan las transiciones de estado de la máquina de estados de un proyecto. Vive en `.ontoref/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
ConceptoControl 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 →
Latencia celular
Conceptonace de ADR · adr-089Tensión sostenida a escala celular: ningún tejido expresa ahora mismo la célula, su linaje está intacto y el criterio para reactivarla está escrito. Proyección a escala celular de `spiral` — la tensión se sostiene en vez de resolverse por borrado. La latencia es un estado declarado con salida, y eso es lo que la distingue de una célula que sencillamente dejó de usarse.
evitar
  • Aparcar como latente una célula que informa 'fail: un fallo silenciado no es una tensión sostenida, es una tensión escondida
  • Declarar latencia sin criterio escrito de reactivación — sin él la célula está abandonada bajo un nombre mejor
relacionados: Espiral, Célula, Apoptosis, LinajeMás información →
Linaje
Artefactonace de ADR · adr-089La cadena de derivación de los núcleos: de qué célula viene una célula, quién la cambió, cuándo y cuál fue el diff. La diferenciación no lo toca; la mutación lo extiende. El linaje es lo que hace auditable una célula que ha cruzado entre tejidos — sin él, mover una célula no es exportar, es copiar y pegar con vocabulario elegante.
evitar
  • Transferencia horizontal sin linaje: copiar una célula entre tejidos sin referencia al padre y sin diff
  • Reescribir el linaje para que la historia quede más limpia — un linaje editable no demuestra nada
relacionados: Núcleo, Célula, Diferenciación, Apoptosis, Linaje del saberMás información →
Linaje del saber
Artefactonace de ADR · adr-080La descendencia de lo que un proyecto sabe: de qué obra externa viene una afirmación, alcanzada por una dirección estable, citada literal y acotada con su localizador, y respaldada por la custodia del artefacto en que se leyó. NO es la lista de fuentes — las fuentes son los artefactos leídos, y el linaje es el recorrido, que incluye lo que una lectura se NEGÓ a concluir: los juicios que no tocaban nada, las anclas medidas ausentes, y lo que resultó ser propio y no heredado. Un proyecto sin él confunde sus logros con dones, y un don no enseña nada sobre cómo repetirlo.
evitar
  • Citar sin localizador: una cita que nadie puede comprobar contra el artefacto es una cita alquilada, que es el defecto que la separación custodia/juicio existe para terminar
  • Publicar una afirmación que no está en el registro de fuentes — la regla generalizada del «una cifra que no esté en esta tabla no se dice en la sala» de la propia charla
  • Registrar solo las lecturas productivas: un mecanismo que no captura nada cuando el veredicto es «esto no toca nada» reproduce el sesgo que hizo falta el registro
  • Inflar una adopción a convergencia, o al revés: lo construido aquí antes de leerse en otro sitio es convergencia, sea cual sea la fecha del otro
relacionados: Linaje, warrant, Testigo verificadoMás información →
Marcar diferenciaBORRADOR
PrácticaEl criterio de validez de una célula: está viva si y solo si su veredicto puede alterar al menos una decisión en al menos un circuito. Proyección a escala celular de adr-070 («existir no es participar») y adr-072 (una comprobación que no podía mirar): esos dos diagnostican la no participación a posteriori y por superficie, mientras que esto la convierte en propiedad permanente del propio predicado. La consecuencia es estructural y no sintáctica — un predicado que no hace nada nunca cambia un resultado, así que aparece en el censo inerte por su propia inutilidad, en vez de tener que cazarlo una auditoría que salga a buscarlo.
evitar
  • Una señal nacida de la operación puede PROPONER una tensión; nunca puede declararla. Detectar un patrón repetido es mecánico, nombrarlo como tensión es una decisión, y un arnés que declara sus propias tensiones es deriva. El arnés propone, la persona ratifica
  • Llamar célula a un predicado cuyo veredicto no consume ningún circuito
  • Responder al censo con una célula que siempre devuelve 'pass porque nada de lo que mira puede variar
relacionados: Célula, Membrana, Apoptosis, Gate, Ondaod
Membrana
Conceptonace de Esquema · ontology/gate.nclFrontera de permeabilidad en cualquier nivel: decide qué cruza y bajo qué condición. Proyección a escala celular de `gate` — mismo concepto, otra escala, y deliberadamente otro id en lugar de una redefinición. Este término cierra un hueco que era medible: `membrane` lleva siendo un campo de `ontology/gate.ncl` sin que ninguna entrada del registro de términos lo definiera, así que la palabra no ataba nada en su punto de uso. Hoy la `opening_condition` de una membrana solo sabe contar dimensiones de tensión y leer prosa; no puede abrirse sobre el estado de un sistema en ejecución, porque no hay nada referenciable con lo que componer esa condición. Eso es lo que aporta una célula.
evitar
  • Redefinir `gate` bajo un nombre biológico en lugar de enlazarlo mediante related_terms
  • Escribir una opening_condition como prosa inglesa cuando el estado que describe se podría componer con células — esa es justo la forma que este vocabulario existe para terminar
relacionados: Gate, Célula, Tejido, Marcar diferencia
Nodo ontoref
ConceptoUn 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)
Núcleo
Artefactonace de ADR · adr-088El `.ncl` de una célula: afirmación, evaluación e interfaz, más la identidad y el linaje que la hacen ser la misma célula en tejidos distintos. Es constitucional y lento — cambiarlo ES una mutación, y una mutación lleva autor, fecha y padre. Es además sin estado por construcción: declara lo que necesita para responder, nunca lo que ha visto. La lentitud es la garantía, no un roce: un núcleo que cambia cada semana no tiene identidad, y su linaje no significa nada.
evitar
  • «Que evolucione solo»: un núcleo cambiado sin autor, fecha y padre es deriva, no evolución. La diferenciación es libre; la mutación va firmada
  • Meter estado de cualquier clase en el núcleo — memoria de participación, último veredicto, última ejecución
relacionados: Célula, Linaje, Epigenética, DiferenciaciónMás información →
Ondaod
Disciplinanace de Tensión · ontology-vs-reflectionDisciplina 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.
así se usa
  • Requerido por el criterio 5 de adr? en cualquier proyecto con ontoref
  • `ontoref qa show ontoref-dao-discipline --format json` devuelve el procedimiento
evitar
  • Elegir un polo como 'la respuesta'
  • Saltarse la lectura de las tensiones nombradas
relacionados: Espiral, Síntesis, Colapso Yin/Yang, adr?
Orden de Trabajo (OT)
Artefactonace de ADR · adr-066La 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`.
así se usa
  • OT-0: la ejecución A rechaza el código real 12/12, la B acepta una configuración limpia, la C caza solo la opción intrusa
evitar
  • Dejar que la Orden de Trabajo reescriba el Pliego que la invocó
relacionados: Encargo, Pliego, Testigo verificadoMás información →
PAP
Conceptonace de Axioma · self-describingProject'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
Prácticanace de Axioma · voluntary-adoptionHerencia en tres niveles para vocabulario: una semilla de protocolo en `reflection/defaults/glossary.ncl` que ontoref distribuye; términos de proyecto añadidos en `.ontoref/ontology/glossary.ncl::project_terms` vía `d.seed_terms @ project_terms`; división opcional por dominio en `.ontoref/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.
así se usa
  • Proyecto provisioning añade lifecycle-plane, data-plane, pole-flip en su propio `.ontoref/ontology/glossary.ncl`
  • Término local que necesita divergir de un concepto protocolo debe usar un id distinto (p. ej. provisioning-discipline) y enlazar vía related_terms
evitar
  • Editar `reflection/defaults/glossary.ncl` en un proyecto consumidor — se sobreescribe en la próxima instalación
  • Redefinir localmente un id del protocolo — el hook glossary-drift lo marca como duplicado
  • Ascender un término específico de proyecto a la semilla de protocolo sin justificación ecosystem-wide
relacionados: on+re, Ondaod, PAP, Conocimiento formalizado como DAG
Peldaño
Conceptonace de Esquema · reflection/schemas/ladder.nclUn eslabón de la escalera: una afirmación sobre lo que ha de sostenerse para que la razón de ser de un proyecto siga siendo COMPROBABLE y no solo recordada. Un peldaño lleva los nodos de la ontología que ya lo cargan, los verbos que lo responden, las condiciones necesarias que una máquina puede comprobar — y, obligatorio y no vacío, lo que pregunta y ninguna comprobación responde. Los peldaños son cadena, no conjunto: cada uno es condición del siguiente, y solo se puede pisar uno si el de abajo aguanta.
evitar
  • Leer las comprobaciones en verde de un peldaño como un peldaño que se sostiene: son condiciones necesarias — el fallo es decisivo, el acierto no
  • Escribir un peldaño con `judgement` vacío para obtener una escalera totalmente mecánica — eso es el proxy léxico de un juicio que el esquema existe para rechazar
  • Llamar a un peldaño paso, nivel o tier: los tres están cogidos (los pasos de un modo, el `level` de un nodo y la jerarquía de adr-018, los tiers de adopción)
relacionados: Linaje del saber, Testigo verificado, Gate
Plano ontoref
ConceptoLa 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
Artefactonace de ADR · adr-066La 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`.
así se usa
  • Pliego-0: contrato = una comprobación que falla si hay un ajuste de ejecución ausente del esquema NCL
evitar
  • Un contrato no comprobable por máquina ('diseña la auth') — eso es prosa otra vez; usa 'Adversario
relacionados: Encargo, Orden de Trabajo (OT), Testigo verificadoMás información →
Projection (miembro de constelación)
Conceptonace de ADR · adr-062En 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).
así se usa
  • assets/ es un Projection(copy): fuente de marca canónica materializada en cada sub-repo
evitar
  • NO confundir con projection-positioning (el revelado de la superficie de posicionamiento sobre el site) — eso es un paso de render, no una categoría de miembro
relacionados: Projection (revelado de posicionamiento), Dominio (extensión CLI por repo_kind)Más información →
Projection (revelado de posicionamiento)
Conceptonace de ADR · adr-057En 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.
así se usa
  • Las cuatro puertas son una projection-positioning de spine.ncl; editar la copia servida está prohibido
evitar
  • NO confundir con projection-member (categoría de la taxonomía ADR-062, una-fuente-sin-repo) — misma palabra, otro eje
relacionados: Projection (miembro de constelación)Más información →
Puerta (entrada de embudo)
Conceptonace de ADR · adr-064Una de las entradas del embudo externo proyectadas desde spine.ncl (ADR-057/064): gov / infrastructure / authoring / personal. Una puerta es un gancho de enrutado orientado a AUDIENCIA que lleva un `tag` de contenido (p. ej. gov, knowledge-works) y rutea a contenido real, nunca argumenta el core. ADR-064 fija CUATRO puertas — un eje distinto de los domains (SEIS desde que se añadió el dominio-de-sí `gov` el 2026-08-24; ADR-064 contaba cinco) y de la ÚNICA membrana de convergencia.
así se usa
  • La puerta authoring (audiencia authoring-knowledge) mapea al tag de contenido knowledge-works
evitar
  • NO equiparar una puerta con un dominio — una puerta es una entrada de audiencia, un dominio es una superficie CLI por repo_kind; rustelo es un dominio pero NO una puerta
  • NO leer una PALABRA COMPARTIDA como colisión — `gov` es id de dominio Y clave de puerta, `personal` igual: dos ejes pueden nombrar cada uno lo suyo con una palabra, y adr-102 registra el día en que se escribió y se refutó una regla que lo prohibía
relacionados: Dominio (extensión CLI por repo_kind), Projection (revelado de posicionamiento)Más información →
Sensor
ConceptoControl 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).
evitar
  • Un sensor cuyo veredicto no declara alcance — cobertura no dicha es cobertura no probada.
  • Severidad `Hard` sobre una tensión nombrada: colapsa la Espiral hacia el polo que prefiriera el autor del check (ADR-050).
  • Un gate que declara más cobertura de la que tiene (`coverage-superset-of-extent`, ADR-072).
relacionados: Guía, Arnés, Arnesabilidad, Severidad Hard / SoftMás información →
Severidad Hard / Soft
Conceptonace de ADR · adr-050La 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».
evitar
  • Traducir los nombres de valor a adjetivo en prosa («fallar en duro», «restricción blanda»): nombran el valor de un tipo, no un grado de dureza.
relacionados: SensorMás información →
Síntesis
ConceptoResolució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.
así se usa
  • Plano de lifecycle queda centralizado; plano de datos sale de Cilium — ambos polos preservados, separados por plano
relacionados: Espiral, Colapso Yin/Yang, Ondaod
Tejido
Conceptonace de ADR · adr-088El contexto que diferencia células, sostiene su memoria de participación y las especializa. Es local y no cruza: la misma célula es sensor en un tejido y política en otro, porque el rol es un eje de expresión que asigna el tejido, no una propiedad de la célula. El tejido es además lo que sabe cuándo preguntó por última vez — la cadencia vive aquí. En la jerarquía de niveles del protocolo el tejido es la instancia de Nivel 3, y el reparto entre lo que converge en el dominio (las declaraciones) y lo que diverge por instancia (ejecución, memoria, cadencia) es el que ya trazó el mecanismo #6 de adr-030.
evitar
  • Un único tejido convergente que sirva a todas las instancias — adr-030 declara las razones del rechazo: dominio de fallo compartido, cadencia de publicación forzada y las claves de firma de todas las instancias en un solo proceso
  • Tratar la memoria del tejido como exportable: no significa nada en otro tejido, y por eso lo que cruza es el núcleo y no el tejido
  • Dejar que la memoria del tejido crezca hasta ser un almacén de métricas — guarda los últimos N veredictos y transiciones, no una serie temporal
relacionados: Célula, Diferenciación, Epigenética, MembranaMás información →
Testigo verificado
Artefactonace de ADR · adr-050Acta 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.
así se usa
  • Una Orden de Trabajo escribe un testigo JSONL con el exit real de la comprobación, no una afirmación
evitar
  • Tratar el testigo como barrera por sí solo — registra, no rechaza
relacionados: Orden de Trabajo (OT), Encargo, GateMás información →
Vínculo
ConceptoRelación tipada entre proyectos (y sus domains) 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?
Procedimientonace de Práctica · adr-lifecycleProcedimiento 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.
evitar
  • Crear un ADR sin confirmación del usuario
  • Saltarse el criterio 5 (ondaod) en proyectos con ontoref
relacionados: Ondaod, PAP
anti-PAP
AntipatrónEnfoque 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
gov (la raíz, no una de sus tres palabras)
Conceptonace de ADR · adr-102`gov` es el id, el alias de CLI y la raíz de host del dominio-de-sí de ontoref (code/domains/gov/). Es la RAÍZ que comparten las tres palabras de gobierno y no abrevia NINGUNA — el inglés tiene las tres, con tres referentes, declarados uno por fila en `referents`: gobernanza, gobernabilidad y gobierno. El dominio lleva el arreglo Y el ejercicio, así que elegir una sola palabra sería un colapso de polo en una pregunta con tres referentes. HOMÓGRAFO, declarado y no heredado: `ontoref governs ` es otro acto — deriva qué restricciones gobiernan una ruta. El despacho compara argv[1] exacto, así que `governs` ≠ `gov` y nada choca mecánicamente; leído `gov` como raíz compartida, los dos son el mismo tronco.
PalabraQué nombraAlcance
gobernanza governanceel ARREGLOfronteras, miembros, qué se publica (los cuatro ADRs del dominio)
gobernabilidad governabilityla CAPACIDADsi el sujeto admite gobierno; propiedad del PROTOCOLO, no de este dominio
gobierno governmentel EJERCICIO y el órganolos siete modos del dominio: release, governed-delivery, ordinary-act, create-pr…
así se usa
  • ontoref gov scope --lens Base
  • gov.ontoref.dev (raíz de host; su propio ADR)
evitar
  • NO expandir `gov` a una de las tres palabras en un título, etiqueta de navegación o copy — «gov (gobernanza)» vuelve a elegir el polo que el id rechaza
  • NO leer `gov` como abreviatura de `government`/gobierno — es la palabra más lejana al arreglo
  • NO confundir `ontoref gov` (el dominio) con `ontoref governs` (deriva restricciones sobre una ruta)
relacionados: Dominio (extensión CLI por repo_kind), Puerta (entrada de embudo), ontorefMás información →
on+re
Prácticanace de Axioma · self-describingAbreviatura de la doble capa de Ontoref: ontología (`.ontoref/ontology/`: core.ncl, state.ncl, gate.ncl, manifest.ncl — lo que ES) + reflexión (`.ontoref/reflection/`: modos, cartera de pendientes, restricciones, qa — lo que DEVIENE). Ambas viven bajo la única raíz oculta `.ontoref/` (ADR-032, propagada por la migración 0023 — el `.ontology/` plano en la raíz del proyecto es el layout ANTERIOR a 0023 y ya no existe). Toda instancia incorporada del proyecto contiene ambas. Un proyecto puede alojar varias instancias on+re en rutas distintas. La mitad «ontología» es el sujeto declarado del PROPIO proyecto: el mapa de un sujeto, comprobable contra ese proyecto y no contra otro. NO es una ontología en el sentido de la ingeniería ontológica: una conceptualización negociada y compartida entre comunidades para que sistemas independientes interoperen. Ontoref hace falsable UN sujeto; no negocia un vocabulario común entre organizaciones, y la ontología de un proyecto no obliga a nadie fuera de él. Cuando dos sujetos deben relacionarse, el protocolo verifica una porción de la declaración ajena sin adoptarla (ADR-028, testigo en lugar de copia) en vez de hacer converger ambos en un modelo compartido.
así se usa
  • `rustelo/` y `website/website-impl/` son dos instancias on+re separadas
evitar
  • Leer la ontología de un proyecto como una conceptualización compartida entre organizaciones: es el sujeto declarado de un proyecto y no obliga a nadie fuera de él.
  • Ofrecer ontoref como respuesta a la interoperabilidad semántica entre organizaciones: el protocolo hace falsable UN sujeto; el acuerdo ENTRE sujetos no es algo que produzca.
relacionados: Gate, onre, Conocimiento formalizado como DAG
onre
ArtefactoAlias 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.
así se usa
  • `ontoref describe project`
  • `ontoref describe constraints`
  • `ontoref sync assets check`
relacionados: on+re
ontoref
Conceptonace de Axioma · self-describingEl protocolo en sí: una superficie tipada y consultable en la que un proyecto declara LO QUE ES (ontología) y CÓMO ACTÚA (reflexión), de modo que una afirmación sobre el proyecto pueda ser contradicha por una máquina y no sólo por un lector. Su doble capa es `on+re`; NO son sinónimos. `ontoref` es el protocolo, la herramienta y el nombre; `on+re` es el par ontología+reflexión que lleva cada instancia. La prosa de cara al exterior dice `ontoref`; `on+re` aparece sólo cuando lo que se discute ES la doble capa, y se glosa la primera vez que se usa.
evitar
  • Usar «on+re» sin glosar en prosa de cara al exterior: es una abreviatura interna y un lector que llega de fuera no puede desplegarla.
  • Tratar «ontoref» y «on+re» como intercambiables: el primero es el protocolo, el segundo es el par de capas.
relacionados: on+re, onre, Gate, PAP, Conocimiento formalizado como DAG
warrant
ConceptoLa evidencia con cuya autoridad algo se admite: un término en un vocabulario, un nodo en el grafo, un resultado en el conjunto verificable. Tomado de ANSI/NISO Z39.19, que admite un término por tres fundamentos distintos que entran en conflicto de forma rutinaria y hay que reconciliar con intención: warrant LITERARIO (el corpus que se describe), warrant DE USUARIO (lo que dicen realmente las personas y las máquinas que buscan) y warrant ORGANIZATIVO (lo que la institución aprueba). En ontoref el concepto tiene DOS CARAS, una por eje, y son la misma pregunta a dos fuerzas de verificación distintas: warrant DECLARADO, en el eje de ontología — `origin = { kind, ref }` en un término, `warrant : Array WarrantRef` en un nodo. Responde «¿con qué autoridad existe esta DECLARACIÓN?». Solo se comprueba confiando en el registro, se audita como Soft y nunca como Hard, porque un warrant obligatorio es captura por ceremonia (adr-029). warrant ATESTIGUADO, en el eje de reflexión — el testigo firmado. Responde «¿con qué autoridad existe este RESULTADO?» y lo responde con un exit code: cualquier tercero lo comprueba sin confiar en quien lo declara. `witness-as-axis-seam` es donde se encuentran las dos, y la asimetría entre ellas es todo el contenido del término: la cara declarada se AFIRMA, la atestiguada se ACREDITA. No leas una como versión débil de la otra — gobiernan objetos distintos (declaraciones frente a actos) y ningún grado de tipado convierte la primera en la segunda.
así se usa
  • Un término del glosario cuyo `origin.kind` es 'External con `ref` vacío reclama warrant literario y no cita corpus alguno — 11 de 35 lo hacían el 2026-08-06.
  • Esta misma entrada: su warrant es el corpus que nombra, y es el primer término del glosario que cita uno de verdad.
  • El veredicto firmado de un sensor es warrant atestiguado del acto de verificar. Una GUÍA del arnés afirma lo que debe cumplirse y no carga warrant ninguno — ese resto es bl-044.
evitar
  • Leer `warrant` como una garantía sobre el futuro. Es evidencia sobre el pasado: el fundamento por el que algo ya fue admitido.
  • Endurecer la cara declarada. Un warrant obligatorio produce campos rellenados para pasar el gate, que es peor que un default honesto porque entonces la mentira supera el tipado.
  • Llamar «acreditado» a un warrant tipado. Acreditado significa firmado y comprobable (sufficient-verification); un warrant declarado se afirma.
relacionados: Gate, SensorMás información →

Usamos cookies para que este sitio funcione, entender el uso del servicio y apoyar acciones de marketing. Política de cookies para más información.