Conceptos

Seis ideas explican la mayor parte del producto.

El documento

Markdown con una cabecera de metadatos (front matter) que declara spec: "1". La prosa es prosa. Unas pocas formas tienen un significado que define la especificación: una línea que empieza con una palabra clave, como MUST:, es una regla que el agente recibe etiquetada, y un bloque delimitado con un tipo, como :::example o ::person{id=owner}, es una orientación, una declaración o datos, que el agente recibe bajo un encabezado que nombra su tipo. Los comentarios, la cabecera de metadatos (Detalles, en el estudio) y las notas finales (backmatter; Notas, en el estudio) nunca se entregan.

Versiones

Publicar crea una versión inmutable con un resumen criptográfico (digest) calculado sobre los bytes que escribió el autor. Las versiones nunca se editan. El borrador es independiente y compartido: todas las personas con permiso de edición trabajan en un mismo borrador, con el mecanismo de «comparar e intercambiar» (compare-and-swap), de modo que dos personas no pueden sobrescribirse la una a la otra sin darse cuenta.

Referencias

Una referencia es un nombre que apunta a una versión: @latest, @stable o el que tú crees. Los agentes siguen referencias, así que cambias lo que ejecutan moviendo una referencia, no editando un documento. Revertir es mover una referencia hacia atrás, y por eso es instantáneo y deja el historial intacto.

Las referencias pueden llevar una política: solo versiones firmadas, solo versiones de una propuesta aprobada, solo ciertos publicadores.

Visibilidad y permisos

VisibilidadQuién puede leer
privateel espacio de trabajo, más cualquiera a quien se le haya dado acceso de forma explícita
internaltodas las personas de la organización
publiccualquiera que haya iniciado sesión en el registro alojado por nosotros; un registro autoalojado puede admitir también agentes anónimos

Además, los permisos dan a una persona, un agente, un servicio o un grupo uno de estos derechos: leer (read), editar (edit), publicar (publish) o gestionar (manage). Los agentes y los servicios llegan como mucho a publish: solo una persona tiene manage. Para quien no tiene acceso, una instrucción privada aparece como «no encontrada» y no como «prohibida», así que su existencia no se filtra.

Propuestas

Cualquiera que pueda leer una instrucción puede proponer un cambio: un documento completo, las diferencias (diff) y una justificación. Alguien con el permiso publish la aprueba y la fusiona, y los autores nunca aprueban sus propias propuestas. Así es como un agente de IA contribuye sin poder publicar: abre una propuesta y una persona decide.

Consumidores

Los agentes que leen una instrucción aparecen como consumidores: suscripciones activas, vinculaciones declaradas, la versión que aplicó cada uno, si va con retraso y cuánto tardó la adopción. La auditoría registra quién leyó y cambió qué, con resúmenes criptográficos, y nunca el contenido en sí.