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
Tres capacidades desde un único substrato tipado — pregunta qué se rompe, comprueba quién lo cambió, alcánzalo desde cualquier actor. 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.
Un rastro que cualquiera puede verificar
Cada cambio del estado autoritativo pasa por precondiciones tipadas y deja un testigo Ed25519 en un oplog DAG reproducible y direccionado por contenido. Cualquiera verifica la historia contra las claves del actor — sin fiarse de quien la produjo.
La misma ontología, para cada actor
Personas, agentes y CI leen un único grafo tipado — desde la terminal, desde el IDE, desde el pipeline. Conocimiento que falla en el build cuando se desvía, no en la próxima auditoría.
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.