Кілька агентів, один репозиторій: правила володіння з реальних інцидентів

👥 Що йде не так

Один агент у репозиторії поводиться як один уважний колега. Кілька агентів поводяться як кілька колег, які одночасно правлять той самий документ, де нічиїх імен не вказано. Трапляється три речі. Вони перезаписують роботу одне одного. Коміт захоплює чиюсь недописану зміну. І ніхто потім не може сказати, хто саме щось змінив, тож ніхто не може усунути причину.

📅 Два інциденти

21 вересня 2026 року агент записав застарілу копію спільного керівного файлу поверх свіжої. У файлі був реєстр чинних ініціатив. Він втратив п'ятнадцять ключів і три записи конвеєра, зокрема посилання на ухвалене архітектурне рішення.

26 вересня 2026 року два агенти одночасно редагували те саме тимчасове робоче дерево. Коміт одного з них захопив би незавершені зміни іншого. Другий агент також змінив власника теки, що зламало тестовий прогін першого.

📐 Правила, які ми записали

1. Одне робоче дерево на агента. Кожен агент створює власну теку, названу за ним і за завданням, і пише в ній невеликий файл власника: агент, ідентифікатор процесу, час, завдання. Якщо знайшли файл власника, який не ваш, зупиніться й повідомте людину.
2. Лише явні шляхи. Додавайте файли за назвою. Ніколи не використовуйте «додати все», бо в спільному дереві завжди лежать чужі зміни.
3. Керівні файли правлять по одному запису за раз. Перечитайте файл безпосередньо перед записом. Якщо ваш інструмент не вміє точкової правки, поверніть запропонований текст власнику замість того, щоб писати файл.
4. У кожної ініціативи є власник. Власник її реалізує. Інші пропонують зміни у звіті.
5. Завершуйте комітом. Зміна, залишена незакоміченою в спільному дереві після завершення завдання, — це дефект: ніхто її не прийме, чийсь коміт може її захопити, або вона просто загубиться.

🧪 Тест на файли, що «худнуть»

Втрату 21 вересня можна було зловити дешевим тестом. Наш порівнює керівні файли в робочому дереві із закоміченою версією і падає, коли запис, який був у коміті, зник. Повідомлення про збій починається з фіксованого слова, щоб його було легко знайти пошуком. Файл тесту містить 4 тести і виконується в нічному гейті.

🛠️ Практика: налаштуйте це за годину

1. Створіть робоче дерево на агента скриптом, який заодно пише файл власника.
2. Зробіть так, щоб «додати все» падало: через обгортку або перевірку перед комітом, яка виводить підготовлені шляхи й вимагає назвати кожен із них у завданні.
3. Виберіть три файли, які керують вашою системою: реєстр, список конвеєра, конфігурацію. Запишіть їх.
4. Напишіть тест, який завантажує кожен із них з коміту й з дерева та падає, коли зник ключ або запис.
5. Додайте поле власника до кожної ініціативи.
6. Додайте правило: завдання не завершене, поки не зроблено коміт і пуш.

✅ Перевірте себе

• Запустіть два агенти на двох завданнях. Їхні теки різні, і в кожній є файл власника.
• Видаліть запис із керівного файлу й запустіть тест. Він падає і називає цей запис.
• Спробуйте підготувати все до коміту. Перевірка зупиняє вас і виводить те, що побачила.
• Наприкінці завдання git status у спільному дереві не показує нічого вашого.

🚧 Коли це не працює

• Конфлікти злиття залишаються. Окремі робочі дерева переносять конфлікт на момент злиття. Саме правило власника тримає його малим.
• Згенеровані файли. Файли, які кожен агент генерує заново, конфліктуватимуть завжди. Тримайте їх поза git або серіалізуйте доступ до них.
• Витрати на диск і збирання. Кожному робочому дереву потрібні місце й збирання. Для легких завдань використовуйте полегшені налаштування.
• Агенти, які ігнорують інструкції. Правило у файлі — це не примус. Важливі правила переносьте в перевірки.
• Правки людей. Люди, які пишуть у спільне дерево, ламають модель. Дайте й їм робоче дерево.

📊 Докази

➡️ Далі

Дізнайтеся, як розподіляти роботу між агентами, у статті Розподіл роботи між агентами, і коли цього робити не варто, і як передавати роботу з критеріями в статті Розробка на основі специфікацій.

Джерела

• Розподіл роботи між агентами, і коли цього робити не варто: дизайн рою.
• Розробка на основі специфікацій із наявними пакетами завдань: передача роботи з критеріями.
• AGENTS.md і файли правил: де живуть правила.
• Політика використання AI та реєстр, який може забезпечити невелика команда: право власності в реєстрі.