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
| Visibilidad | Quién puede leer |
|---|---|
| private | el espacio de trabajo, más cualquiera a quien se le haya dado acceso de forma explícita |
| internal | todas las personas de la organización |
| public | cualquiera 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í.