Основні поняття

Шість ідей пояснюють більшу частину продукту.

Документ

Markdown із початковими метаданими (front matter), які оголошують spec: "1". Проза залишається прозою. Кілька форм мають значення, яке визначає специфікація: рядок, що починається з ключового слова, як-от MUST:, є правилом, яке агент отримує з позначкою, а блок, обгороджений із зазначенням виду, як-от :::example чи ::person{id=owner}, є настановою, оголошенням або даними, які агент отримує під заголовком, що називає їхній вид. Коментарі, початкові метадані (у студії — Details) та прикінцеві нотатки (backmatter; у студії — Notes) ніколи не доставляються.

Версії

Публікація створює незмінну версію з дайджестом, обчисленим за байтами, які написав автор. Версії ніколи не редагуються. Чернетка окрема і спільна: усі, хто має право редагувати, працюють над однією чернеткою, а зміни записуються за принципом «порівняй і заміни» (compare-and-swap), тож двоє людей не можуть непомітно перезаписати роботу одне одного.

Посилання (refs)

Посилання (ref) — це ім’я, яке вказує на версію: @latest, @stable або будь-яке, що ви створите. Агенти стежать за посиланнями, тож ви змінюєте те, що вони виконують, пересуваючи посилання, а не редагуючи документ. Відкотитися — означає пересунути посилання назад, тому це відбувається миттєво й залишає історію недоторканою.

Посилання можуть мати політику: лише підписані версії, лише версії зі схваленої пропозиції, лише певні видавці.

Видимість і доступи

ВидимістьХто може читати
privateробочий простір і всі, кому явно надано доступ
internalусі в організації
publicбудь-хто, хто ввійшов у реєстр, розміщений у нас; реєстр на власному хостингу може також допускати анонімних агентів

Понад це, доступи дають людині, агентові, сервісу або групі одне з прав: читати (read), редагувати (edit), публікувати (publish) або керувати (manage). Агенти й сервіси зупиняються на publish: manage має лише людина. Для того, хто не має доступу, приватна інструкція виглядає як «не знайдено», а не «заборонено», тож про саме її існування дізнатися не можна.

Пропозиції

Кожен, хто може читати інструкцію, може запропонувати зміну: повний документ, різницю (diff) і обґрунтування. Хтось із правом publish схвалює її та зливає, і автори ніколи не схвалюють власних пропозицій. Саме так ШІ-агент робить свій внесок, не маючи змоги публікувати: він відкриває пропозицію, а вирішує людина.

Споживачі

Агенти, які читають інструкцію, видно як споживачів: активні підписки, оголошені прив’язки, версія, яку застосував кожен, чи він відстає і скільки часу зайняв перехід. Журнал аудиту записує, хто що читав і змінював, із дайджестами, і ніколи не записує сам вміст.