Tribe

Переносимый протокол координации нескольких агентов в проектах Codex с локальными правилами, ролями и проверяемой передачей работы.

Tribe превращает разовую параллельную работу агентов в небольшой, проверяемый рабочий протокол для репозитория. Он помогает корневому агенту исследовать проект, выделить устойчивые границы ответственности, раздать ограниченные задачи и собрать результат, оставляя правила и состояние рядом с кодом.

Быстрый старт

Для установки в текущий репозиторий агенту передают initialization-инструкцию из публичного источника: https://gitlab.com/EternalLion67/tribe/-/raw/main/docs/INITIALIZATION.md. Она устанавливает переиспользуемый skill в окружение Codex и локальный протокол в текущий проект. Отдельно skill можно установить командой curl -fsSL https://gitlab.com/EternalLion67/tribe/-/raw/main/install.sh | sh.

После установки в новой сессии внутри нужного проекта явно говорят Use Tribe in this project. Это переключатель активации. Обычная просьба запустить несколько агентов не устанавливает постоянные файлы проекта.

Установка и локальный пакет

В проекте появляются управляемый блок в AGENTS.md и каталог .agents/. В нём хранятся карта протокола, правила координации и владения, технические границы ответственности, текущее состояние, принятые решения, известные проблемы, журнал workstreams, шаблоны передачи и политика доказательств. Эти файлы становятся источником правды для следующих сессий: договорённости не нужно восстанавливать из истории чатов, глобальной памяти или внешнего репозитория.

Роли выводятся из устойчивой архитектуры и повторяющихся границ владения. Для крупной работы Tribe допускает layered authority: корень отвечает за интеграцию и релиз, архитектурный владелец — за контракты, менеджер workstream — за ход отдельного направления, а авторы и проверяющие работают в явно ограниченных контурах.

Как проходит работа

Корневой агент сначала читает инструкции, состояние и рабочее дерево. При установке initialization guide требует отдельные discovery- и acceptance-задания, если в среде есть полезные слоты. В обычной работе независимые задания исследуют архитектуру и границы доставки, после чего корень формирует минимальный набор технических границ ответственности. Каждая реализационная граница получает одного активного автора; исследование и проверка остаются read-only, пока для них явно не назначен другой контур.

Перед слиянием отдельная приёмка проверяет весь пакет как систему: полноту шаблонов, отсутствие неразрешённых ссылок и токенов, непротиворечивость границ ответственности, сохранение существующих правил и отсутствие утечек секретов или личного контекста. Валидатор scripts/validate_project.py проверяет наблюдаемую структуру, ссылки, маркеры и гигиену ролей, но не подменяет инженерные тесты проекта.

Граница применения

Tribe — opt-in протокол координации, а не автономный сервис, hosted control plane или система авторизации. Он не заменяет инженерные правила проекта, человеческое ревью, политику безопасности, релизные ограничения и отдельное разрешение на публикацию или деплой. Контракт до версии 0.1 может меняться несовместимо между минорными ревизиями.

Для разработки самого репозитория python3 scripts/stage_templates.py готовит нейтральный scaffold. Затем python3 scripts/materialize_templates.py сначала делает --dry-run, а после проверки одним защищённым действием записывает полный пакет в проект. После установки запускается python3 scripts/validate_project.py. Скрипты рассчитаны на Python 3.13–3.14 и используют только стандартную библиотеку. Валидатор проверяет наблюдаемую структуру, ссылки, маркеры, токены и гигиену ролей, но не доказывает корректность поведения продукта; решение о принятии изменений всё равно принадлежит мейнтейнеру.

Проект распространяется по лицензии MIT. Исходный код и актуальные инструкции доступны в репозитории Tribe на GitLab.