Concepts
Six idées expliquent l’essentiel du produit.
Le document
Du Markdown avec un en-tête (front matter) qui déclare spec: "1". La prose reste de la prose.
Quelques formes portent un sens que la spécification définit : une ligne qui commence par un mot-clé, comme
MUST:, est une règle que l’agent reçoit étiquetée, et un bloc délimité avec un type, comme
:::example ou ::person{id=owner}, est une consigne, une déclaration ou des données,
que l’agent reçoit sous un titre qui nomme ce type. Les commentaires, l’en-tête (Détails, dans le studio) et les
notes de fin (backmatter ; Notes, dans le studio) ne sont jamais délivrés.
Les versions
Publier crée une version immuable, avec une empreinte (digest) calculée sur les octets tels qu’ils ont été écrits. Les versions ne sont jamais modifiées. Le brouillon est distinct et partagé : toutes les personnes autorisées à modifier travaillent sur un seul brouillon, et chaque enregistrement vérifie que le brouillon n’a pas changé entre-temps (compare-and-swap), de sorte que deux personnes ne peuvent pas écraser le travail l’une de l’autre sans s’en apercevoir.
Les références (refs)
Une référence (ref) est un nom qui pointe vers une version : @latest, @stable, ou celui
que vous créez. Les agents suivent des références : vous changez donc ce qu’ils exécutent en déplaçant une
référence, pas en modifiant un document. Revenir en arrière, c’est déplacer une référence vers une version
antérieure ; voilà pourquoi c’est instantané et que l’historique reste intact.
Les références peuvent porter une politique : uniquement des versions signées, uniquement des versions issues d’une proposition approuvée, uniquement certains éditeurs.
Visibilité et autorisations
| Visibilité | Qui peut lire |
|---|---|
| private | l’espace de travail, plus toute personne à qui un accès a été explicitement accordé |
| internal | tout le monde dans l’organisation |
| public | toute personne connectée au registre que nous hébergeons ; un registre auto-hébergé peut aussi admettre des agents anonymes |
En plus de cela, les autorisations donnent à une personne, un agent, un service ou un groupe l’un des droits suivants : lire (read), modifier (edit), publier (publish) ou gérer (manage). Les agents et les services s’arrêtent à publish : seul un humain détient manage. Pour quelqu’un qui n’y a pas accès, une instruction privée est « introuvable » plutôt qu’« interdite », de sorte que son existence ne s’ébruite pas.
Les propositions
Toute personne qui peut lire une instruction peut proposer une modification : un document complet, un diff et une justification. Quelqu’un qui a le droit publish approuve et fusionne, et les auteurs n’approuvent jamais leurs propres propositions. C’est ainsi qu’un agent d’IA contribue sans pouvoir publier : il ouvre une proposition, une personne décide.
Les consommateurs
Les agents qui lisent une instruction apparaissent comme des consommateurs : les abonnements actifs, les liaisons déclarées, la version que chacun a appliquée, s’il est en retard, et le temps qu’a pris l’adoption. Le journal d’audit enregistre qui a lu et modifié quoi, avec les empreintes, et jamais le contenu lui-même.