wastech-orchestrator

Превращает описанную задачу в pull request для вашего ревью.

  • Открытый код
  • Активно развивается
  • Apache License 2.0

Правки вносят агенты, а оркестратор ведёт сценарий и всю работу с Git вокруг них, от ветки до pull request. Каждый шаг сохраняется в локальной базе SQLite, поэтому у любого запуска остаётся запись, по которой его можно потом проследить.

Открыть репозиторийЧитать документацию

Почему он здесь

Я сам пользуюсь этим оркестратором для разработки, написания текстов и анализа идей. Это один из примеров того, что я мог бы настроить для вас и вашей команды. Код и документация открыты, так что можно разобраться, как он устроен, прежде чем что-то решать.

Проблема

Чтобы ревьюер мог разобраться в правке агента, вокруг неё нужно несколько шагов. Если за эти шаги никто не отвечает, pull request от агента трудно проверить, а результат трудно повторить. Это одна из причин, по которым работа с агентами буксует, наряду с качеством контекста, который агент читает.

Решение

Оркестратор берёт на себя процесс и работу с Git, и агентов не просят делать commit и push. Сценарий описывает шаги, а задачи пишутся под него. Pull request открывается, когда пройдены настроенные вами проверки и ревью агентом, и к нему прилагается описание того, что изменилось.

  • Задача уходит агенту и возвращается в виде pull request, когда пройдены проверки, настроенные для вашего репозитория.
  • Шаги записаны в виде сценария, поэтому каждый запуск проходит те этапы, которые вы для него задали.
  • Необязательный аудит-коммит кладёт файл задачи и её итог рядом с кодом.

Ключевые возможности

  • От задачи до pull requestЗадача в Markdown превращается в ветку, правку, проверки вашего репозитория и pull request с описанием.
  • Два агента, один интерфейсOpenAI Codex и Anthropic Claude Code взаимозаменяемы, и если настроены оба, при инфраструктурном сбое запуск переходит на другой.
  • Git остаётся за оркестраторомАгентов не просят делать commit и push. При строгой изоляции на хосте, который умеет запускать их в песочнице, они не могут писать в .git, а preflight предупреждает, если такой защиты нет.
  • Возобновляемые запускиКаждый шаг сохраняется в контрольной точке, поэтому после перезапуска незавершённая задача продолжается без повторного коммита и без второго pull request.

Пайплайн

  1. ЗадачаMarkdown-файл в вашем репозиторииВы
  2. ВеткаСоздаётся от вашей базовой веткиОркестратор
  3. Шаги сценарияПланирование и правки, по одному шагуИИ-агенты
  4. ПроверкиВаши команды тестов и линтера после каждой правкиОркестратор
  5. РевьюЧитают изменение и возвращают замечания на доработкуИИ-агенты
  6. КоммитКоммит в рамках задачи, затем pushОркестратор
  7. Pull requestОткрывается с описанием для вашего ревьюОркестратор

Для кого

  • Люди и команды, которые хотят работать с ИИ-агентами.
  • Техлиды, которым нужно, чтобы каждое изменение агента проходило ревью и оставляло след.

Стек

Ядро
  • Python 3.12+
Агенты
  • OpenAI Codex CLI
  • Anthropic Claude Code CLI
Состояние
  • SQLite (контрольные точки, таблицы аудита)
Git
  • git
  • GitHub CLI (gh)

Установка

pipx install "git+https://github.com/VladimirMakarevich/wastech-orchestrator.git"cd path/to/your-repoworc install .worc preflight
Нужны Python 3.12+, git и CLI codex или claude в PATH. GitHub CLI требуется, только если pull request должны открываться автоматически. Мастер установки настраивает репозиторий, а preflight проверяет агентов и политику изоляции, не запуская задачу.

Ограничения

  • Выполняет одну задачу за раз, от начала до конца.
  • Открывает pull request только на GitHub, через gh CLI.
  • Шаг проверок останавливает задачу, только если вы указали в конфигурации свои команды тестов и линтера. Сразу после установки их там нет.
  • Сразу после установки строгая изоляция выключена, а хост без песочницы на уровне ОС, например нативный Windows, не может запретить запись в .git.

Хотите, чтобы ваша команда работала так же?

Написать мне