Розробникам

Зрізи, які вже можна читати

Шматки субстрату, опубліковані в міру того, як кожен ставав досить цілісним, щоб читатися окремо, — поки що в GitHub-організації та на акаунті засновника; опубліковані ще до вибору імені Synoetic, тож деякі з них досі носять давнішу робочу назву субстрату:

• docs-for-agents — методологія для документів, які агенти завантажують і читають: що писати, наскільки стисло, де їх тримати. Прев'ю.
• adrs-for-agents — чотири легкі записи рішень про те, як будувати документацію в кодовій базі, з якою працюють агенти, — плюс конвенція, за якою вони написані.
• docs-by-agents — набір, з яким агенти пишуть продуктову документацію кодової бази: кожне твердження звірене з кодом, прогалини позначені, а не вигадані.
• terseness-techniques — gist: техніки документації, яку агенти читають, витрачаючи менше контексту.

Нічого екзотичного під капотом

Версійований репозиторій звичайних текстових файлів — конституція, робочі конвенції, плани й запис кожного шматка роботи, — в якому люди й агенти працюють разом. Агентна сторона — звичайний агент для коду з командного рядка, який завантажує правила репозиторію так само, як інструкції будь-якого проєкту. Рев'ю включає моделі інших вендорів, яким доручено знаходити те, чого не помічає модельна родина автора. Контроль версій — jj, Git-сумісна система, чиї конфлікти як повноцінний стан і журнал операцій підходять багатьом авторам однієї історії.

Що робить сесія, одним рядком: читає поле, бере наступний шматок роботи, робить його, здає на рев'ю, записує як тривкий слід, передає далі. Сліди і є координацією — без процесу-диригента, без шини повідомлень. Сесії бувають і автономними — агент годинами працює без людини, а кожна передача йде через поле: наступна сесія починає зі слідів у полі, а не з пам'яті попередньої.

Що готуємо до публікації

Сам субстрат — конституція, конвенції, документи координації, скрипти, що ведуть сесії та раунди рев'ю, — чистимо перед публікацією на github.com/synoetic. Дати не обіцяємо. Зрізи вище — те, що вже винесено назовні: воно теж у роботі, але читати його можна.

Ще не як пакет

Колонія Synoetic поки одна — робоча практика одного засновника, — а опубліковані зрізи — щоб читати, а не готовий спосіб запустити власну колонію. Якщо ви будуєте агентні системи і хочете придивитись ближче — або спробувати конвенції у власному репозиторії, — пишіть на hello@synoetic.org. Адреса synoetic.dev веде на цю сторінку.