Об этом проекте

Repo Agent Orchestration — это неофициальный общественный Codex Skill (лицензия MIT), который хранит конвенции доставки репозиториев несколькими агентами внутри самого репозитория, а не в центральном сервисе. Его заявленная цель — завершение работы с репозиторием в соответствующих контекстах с четким владением, пропорциональной верификацией и восстанавливаемой передачей задач. В проекте прямо отмечается, что он не предоставляет никаких разрешений, не открывает возможности продукта и не воспроизводит никаких проприетарных систем оркестрации. Документация определяет три режима владения — прямой (direct), доставки (delivery) и архитектурный (architected) — как описания того, кто принимает решения, а не как фиксированное количество диалогов. Руководство охватывает делегирование разделимых задач, продолжение работы, готовой по зависимостям (вместо опроса неизменного статуса), сохранение независимости реализации и оценки ревью, а также проверку фактической Git-личности и эксклюзивных путей. Внутренние писатели (writers) используют дерево своего владельца с раздельными областями видимости, в то время как независимо работающие App-писатели используют отдельные зарегистрированные локальные worktree репозитория. Независимое ревью дизайна требуется по явному запросу пользователя, требованиям репозитория или при наличии существенных сквозных или необратимых рисков. Установка выполняется из исходного кода с помощью scripts/install_repository.py с указанием пути к репозиторию. Скрипт копирует Skill в .agents/skills/repo-agent-orchestration и идемпотентно обновляет отмеченный блок в корневом файле AGENTS.md, сохраняя правила вне этого блока. Флаг --dry-run позволяет предварительно просмотреть запись, а --check обнаруживает расхождения в установленных файлах или профилях без изменения цели. Установщик принимает опции, касающиеся основной ветки, корня worktree, префикса ветки, политики корневого worktree, политики хоста задач, политики модели контроллера, настроек моделей для каждой роли, общих путей интеграции, политики непрерывности и внешних шлюзов. Значения моделей по умолчанию — app_default, что исключает переопределения модели и мышления; обновления сохраняют существующие явные привязки, за исключением устаревшего значения по умолчанию установщика, которое мигрирует обратно в app_default. Опциональный структурированный адаптер поддерживает явно запрошенные App-задачи, если хост поддерживает сохраненный проект (saved-project) и локальный маршрут. Его конструктор и валидатор обрабатывают восемь типов пакетов — binding, write, review, update, design_handoff, delivery_update, design_reopen и design_decision — использующих общую схему. В документации указано, что адаптер проверяет вхождение путей, идентификатор сохраненного проекта, текущую ветку Git и коммит, режим ревью «только для чтения» и сохраненные настройки отчетов, но не доказывает авторизацию задач, фактическую доставку, качество ревью или приемку, а поле DELIVERY в отчете является предполагаемым маршрутом, а не квитанцией. Валидация опирается на обнаружение unittest из стандартной библиотеки Python, пример валидатора и локальное демо; CI ориентирован на Python 3.11 и 3.13; Git требуется для тестов установщика и worktree. Демо создает временный Git-репозиторий и изолированные деревья писателей, доказывая только локальные проверки Git и контрактов, а не создание App, доставку сообщений, эффективность моделей или реальное поведение агентов. Поведенческие кейсы предоставляются для упражнений, которые нельзя доказать строковыми утверждениями. Руководство по очистке требует явного решения для каждого владеемого worktree и ветки, удаляя только проверенные чистые, интегрированные или явно заброшенные остатки через поток worktree Git и сохраняя небезопасные или полезные остатки с точными координатами; очистка по возрасту, принудительное удаление восстановимых данных, удаление удаленных веток, фоновый демон или автоматическое повышение привилегий не предусмотрены. Структура разделяет устанавливаемый Skill, установщик, пример валидатора, локальное демо, поведенческие входные данные, опциональный runbook для рабочего стола и детерминированные тесты.