Un libro tratado como un sistema

Un libro de no ficción con estructura repetida —capítulos con las mismas secciones, una terminología que debe significar lo mismo en la página 30 y en la 240, cuadros y tablas que viajan entre formatos— tiene la forma de un sistema de software y casi nunca se trata como tal.

Se trata como una carpeta de documentos. Y entonces aparecen los defectos que cualquiera que haya editado algo largo reconoce: un término que cambia de sentido a mitad de obra, un artefacto derivado que alguien corrigió a mano y que la siguiente exportación borra, una sección que existe en seis capítulos y falta en el séptimo sin que nadie lo note hasta la maqueta final.

Ninguno es un error de escritura. Son errores de integridad estructural, y para esos el oficio editorial tiene convenciones pero no mecanismos.

Qué es Opus

Opus es el sustrato genérico: extracción de documentos, análisis de texto asistido, sugerencias, servidores MCP para trabajar la obra con agentes, y el andamiaje de publicación. Nada de eso es específico de ningún libro.

Lo específico vive en la implementación. Para El camino del Alimento —siete pasos para nutrirte en armonía con la Naturaleza, de Diego Delgado Silvera— la implementación declara su propia estructura, su terminología y su estado, y consume Opus como framework. La separación importa: cuando el segundo libro llegue, no heredará las decisiones del primero.

La parte que no es habitual: la ontología

La obra tiene un dominio gobernado con el protocolo ontoref. Eso significa, en concreto, que hay un puñado de axiomas declarados —no comentados en un README, sino escritos en un fichero que otras cosas leen— y que las decisiones con peso arquitectónico se registran como ADR tipados, no como prosa.

Dos de esos axiomas dan la medida de para qué sirve esto:

Los artefactos derivados no se editan. Si el texto compuesto sale de un pipeline, corregir el resultado en vez del origen garantiza que la corrección se pierda en la siguiente pasada. Es obvio dicho así, y se incumple constantemente porque en el momento siempre es más rápido arreglar lo que tienes delante.

La configuración es la fuente, y va tipada. El estado de cada documento y el vocabulario de la obra viven en ficheros Nickel con contrato. Un contrato no es documentación: es un validador. Cuando alguien añade un campo que el esquema no admite, la exportación falla — no se ignora silenciosamente, que es lo que hace cualquier formato de configuración sin tipos.

Por qué un gate y no una convención

La diferencia entre una convención y un gate es que la convención se cumple mientras alguien se acuerde.

Un ejemplo real de este proyecto: la obra tiene una estructura declarada de siete capítulos con seis secciones cada uno. Eso es una afirmación comprobable. Si el número de documentos no casa con lo que la ontología declara, el gate lo dice; no hace falta que un humano recuente carpetas antes de maquetar.

Otro: el análisis de terminología no lee una lista mantenida a mano en la cabeza del editor, sino el fichero de términos que la propia obra declara. Añadir un término a la obra y añadirlo al análisis son el mismo acto, y por tanto no pueden desincronizarse.

El patrón es siempre el mismo: una lista mantenida a mano junto a otra lista mantenida a mano, sin lector común, es el sitio exacto donde aparece la deriva. Todo lo que este sistema hace se puede resumir en darle a esas dos listas un lector común.

Lo que no resuelve

No escribe. No mejora una frase floja ni decide si un capítulo sobra.

Tampoco elimina el trabajo editorial: lo desplaza. Se dedica menos tiempo a comprobar cosas comprobables —¿está esta sección en todos los capítulos?, ¿este término significa lo mismo en todas partes?, ¿la exportación refleja el último cambio?— y por tanto queda más para lo que nadie puede automatizar, que es si el libro dice lo que quiere decir.

Y tiene un coste honesto: montar el dominio, los contratos y los gates es trabajo por adelantado que no se rentabiliza en un libro corto de estructura libre. Para una obra con estructura repetida, terminología propia y varios formatos de salida, se paga rápido.

El resultado

El camino del Alimento se publica como libro, como programa de educación nutricional acompañado y como actividades presenciales. Tres formatos que comparten una única fuente y una única terminología, porque comparten el sistema que los compone.

Esa es la parte que interesa: no que haya una ontología, sino que los tres formatos no pueden contradecirse entre sí sin que algo falle antes de publicarse.