Pisa firme, con paso ligero.
Tu proyecto, tu infra, tu obra, tu vida: ¿sigues yendo a donde dijiste?
Un proyecto, una infraestructura, una vida: ¿sigues yendo a donde dijiste que ibas?
Cuando tu razón de ser es verificable y no solo declarada, mantener el rumbo deja de costar esfuerzo.
Lo que dejas dicho, alguien podrá comprobarlo.
Lo que puede hacer un proyecto que se conoce
Conocer, actuar, verificar — desde un único substrato tipado que personas, agentes y CI leen por igual, desde la terminal, el IDE o el pipeline. Independiente de cualquier tiempo de ejecución.
El radio de impacto, antes del diff
Pregunta en qué repercute un cambio — qué nodos, qué invariantes, qué ADRs — antes de escribir una línea. El código que acabas de heredar puede decirte qué es lo que sostiene el peso.
Procedimientos que corren sobre lo que sabe
Un modo es un DAG tipado —actores, pasos, dependencias, guardas—, no un runbook en prosa. Lee las declaraciones del proyecto y actúa sobre ellas: el modo release calcula el salto de versión a partir de las aristas de dependencia declaradas y después verifica lo que recibe de verdad un desconocido.
Una afirmación vale mientras un check la sostiene
Cada check que puede bloquear declara cómo falla —una rotura plantada que debe ponerlo en rojo— o por qué nada puede hacerlo fallar. La firma es otra elección: un proyecto que adopta la gobernanza de firma firma dentro de un núcleo que firmó su propietario (foedus · mandatum · warden), no en el protocolo.
Arquitectura
Capas del protocolo — entry point → NCL declarativo → Nushell operacional → tiempo de ejecución Rust opcional. Cada capa es testeable de forma independiente.
Adoptar en Cualquier Proyecto
Tres comandos. Sin lock-in.
ontoref setup
Genera el scaffold de .ontology/ y reflection/ con ficheros NCL tipados. Idempotente — seguro de re-ejecutar tras actualizaciones.
ontoref describe project
Consulta la identidad, axiomas, tensiones y estado de la máquina de estados de tu proyecto desde el terminal. Actor-agnostic — misma salida para developer, agente o CI.
ontoref run start
Arranca el daemon para UI HTTP y MCP. Configurable via ~/.config/ontoref/config.ncl. El protocolo funciona sin él.
Estructura el Conocimiento de Tu Proyecto
Instala el CLI, ejecuta ontoref setup y tu proyecto gana invariantes consultables por máquina, ADRs vivos, modos operacionales con actor-awareness y compartición opcional de contexto del daemon.