Archon

Что такое Archon

Archon – это инструмент для управления рабочими процессами ИИ-агентов, которые генерируют код. Вы описываете процесс разработки один раз в формате YAML, а потом запускаете его откуда угодно: из терминала, Slack, Telegram, комментария на GitHub или через веб-интерфейс. Каждый запуск работает изолированно, в собственном git-worktree. Это позволяет одному разработчику управлять несколькими параллельными задачами без конфликтов слияния.

Главная проблема, которую решает Archon, – непредсказуемость ИИ-агентов. Когда вы просите агента «исправить баг», результат зависит от модели: она может пропустить планирование, забыть запустить тесты или проигнорировать шаблон описания PR. Archon делает процесс детерминированным. Вы определяете структуру рабочего процесса, а ИИ выполняет интеллектуальные задачи на каждом этапе.

Сервис распространяется бесплатно под лицензией MIT с открытым исходным кодом. Работает локально, не отправляет код или промпты на сторонние серверы. Установка занимает меньше минуты.

Archon подходит разработчикам, которые хотят масштабировать работу с ИИ-агентами без потери контроля. Особенно полезен тем, кто уже использует Claude Code или другие инструменты для генерации кода, но сталкивается с хаосом при параллельной работе над несколькими задачами. Также подходит командам, которым нужно стандартизировать процессы разработки: рабочие процессы хранятся в репозитории и работают одинаково для всех участников.

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

Изолированные рабочие деревья для параллельных задач

Каждый запуск рабочего процесса получает собственное git-worktree. Это означает, что вы можете запустить десять агентов на десять разных задач одновременно, и они не будут мешать друг другу. Нет конфликтов слияния. Нет ситуаций, когда один агент перезаписывает изменения другого.

Проблема, которую это решает: при обычной работе с ИИ-агентами вы привязаны к одной задаче за раз. Запустили агента на исправление бага – ждёте, пока он закончит, прежде чем переключиться на другую задачу. С Archon вы можете запустить три агента из Slack со смартфона, пойти выгулять собаку и вернуться к трём готовым pull request'ам.

На практике это выглядит так: вы в терминале запускаете archon run fix-bug для одной проблемы, затем сразу archon run add-feature для другой, затем из Slack отправляете команду на третью задачу. Все три агента работают параллельно в своих изолированных окружениях. Когда они завершают работу, вы получаете три отдельных PR, готовых к ревью.

Мультиплатформенный запуск рабочих процессов

Archon позволяет запускать рабочие процессы из командной строки, веб-интерфейса, Slack, Telegram или комментария на GitHub. Вы описываете задачу один раз, а потом запускаете её откуда удобно в конкретный момент.

Это решает проблему привязки к рабочему месту. Классический сценарий: вы заметили баг в коде, пока читаете GitHub на телефоне в метро. Вместо того чтобы ждать, пока доберётесь до компьютера, вы оставляете комментарий с описанием проблемы, и Archon запускает рабочий процесс исправления. К моменту, когда вы откроете ноутбук, PR уже готов.

Пример: вы в Slack пишете «исправь ошибку в валидации email», и Archon запускает рабочий процесс fix-bug. Агент создаёт изолированное рабочее дерево, планирует исправление, пишет код, прогоняет тесты и создаёт PR. Вы получаете уведомление со ссылкой на PR и можете сразу начать ревью.

Для работы с платформами чата нужна предварительная настройка: создать бота в Slack или Telegram и указать токены в конфигурации Archon. Интеграция с GitHub работает через GitHub CLI и требует аутентификации. Веб-интерфейс и командная строка работают сразу после установки.

Рабочие процессы как код в формате YAML

Рабочие процессы в Archon описываются в виде YAML-файлов, которые хранятся в папке .archon/workflows/ вашего репозитория. Это направленные ациклические графы (DAG) с поддержкой циклов, условий и контрольных точек. Вы определяете последовательность шагов: планирование, реализация, тестирование, ревью, создание PR.

Проблема, которую это решает: без явного описания процесса каждый запуск ИИ-агента уникален. Один раз агент может написать тесты, другой раз забыть. Один раз создаст подробное описание PR, другой раз ограничится одной строкой. С рабочими процессами структура фиксирована, а ИИ работает только там, где нужна интеллектуальная обработка.

На практике это выглядит так: вы создаёте файл fix-bug.yaml в .archon/workflows/, описываете этапы (анализ проблемы → планирование решения → написание кода → запуск тестов → если тесты не прошли, вернуться к написанию кода → создание PR), коммитите файл в репозиторий. Теперь любой член команды может запустить archon run fix-bug, и процесс будет одинаковым для всех.

Archon поставляется с 19 готовыми рабочими процессами: исправление багов, добавление функций, рефакторинг, написание тестов, ревью кода, обновление документации и другие. Вы можете использовать их как есть или скопировать и настроить под свои нужды. Рабочие процессы с одинаковыми именами в вашем репозитории переопределяют стандартные.

Композиция детерминированных и ИИ-узлов

Рабочий процесс в Archon может включать как детерминированные узлы (bash-скрипты, запуск тестов, git-операции), так и узлы на основе ИИ (планирование, генерация кода, ревью). Нейросеть работает только там, где она действительно полезна, а остальное выполняется предсказуемо.

Это решает проблему избыточного использования ИИ. Если весь процесс отдать на откуп агенту, он может принять неожиданные решения: например, пропустить запуск тестов или изменить файлы, которые не должны были меняться. С композицией вы явно указываете, где нужен ИИ, а где достаточно скрипта.

Пример: рабочий процесс исправления бага может выглядеть так. ИИ-узел анализирует проблему и создаёт план → ИИ-узел пишет код → детерминированный узел запускает тесты → если тесты не прошли, цикл возвращается к написанию кода → детерминированный узел создаёт коммит → ИИ-узел пишет описание PR → детерминированный узел создаёт PR через GitHub CLI.

Циклы с условиями позволяют повторять шаги до достижения нужного результата. Например, агент будет переписывать код и прогонять тесты до тех пор, пока все тесты не пройдут. Контрольные точки (gates) позволяют запросить одобрение человека перед продолжением: агент может подготовить изменения, показать их вам, и только после вашего подтверждения создать PR.

Поддержка нескольких ИИ-провайдеров

Archon работает с разными моделями и провайдерами: Claude Code, Codex и другими. Вы можете переключать провайдера для всего рабочего процесса или для отдельных узлов. Archon выступает слоем оркестрации, а выбор модели остаётся за вами.

Проблема, которую это решает: разные задачи лучше решаются разными моделями. Для генерации кода может быть оптимальна одна модель, для ревью – другая, для написания документации – третья. Без гибкой оркестрации вы привязаны к одному инструменту.

На практике вы можете настроить рабочий процесс так, чтобы узел планирования использовал Claude, узел генерации кода – Codex, а узел ревью – снова Claude. Или использовать одну модель для всех узлов, но иметь возможность быстро переключиться на другую, если первая не справляется с конкретной задачей.

Для работы с провайдером нужно указать путь к его бинарному файлу в конфигурации. Для Claude Code это переменная окружения CLAUDE_BIN_PATH или параметр assistants.claude.claudeBinaryPath в ~/.archon/config.yaml. В Docker-образе Archon Claude Code уже установлен.

Веб-интерфейс для управления и мониторинга

Archon включает веб-панель для общения с агентом, запуска рабочих процессов и отслеживания их выполнения. Интерфейс показывает активность со всех платформ: рабочие процессы, запущенные из командной строки, сообщения из Slack или Telegram, взаимодействие с GitHub – всё в одном месте.

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

Ключевые страницы: чат с потоковой передачей в реальном времени и визуализацией вызовов инструментов, панель управления для мониторинга запущенных рабочих процессов с фильтрацией по проекту, статусу и дате, конструктор рабочих процессов с функцией drag-and-drop для создания DAG, страница выполнения рабочего процесса с пошаговым отображением прогресса.

Для запуска веб-интерфейса из бинарной установки достаточно выполнить archon serve – это загрузит и запустит интерфейс за один шаг. Если вы работаете с исходным кодом, можно попросить агента запустить фронтенд из репозитория Archon или выполнить bun run dev из корневой папки самостоятельно.

Автоматический выбор рабочего процесса

Когда вы описываете задачу в свободной форме, Archon использует маршрутизатор, который выбирает подходящий рабочий процесс из доступных. Вам не нужно помнить точные названия или команды – достаточно объяснить, что нужно сделать.

Это решает проблему когнитивной нагрузки. Если у вас 19 стандартных рабочих процессов плюс несколько кастомных, запоминать, какой из них использовать для конкретной задачи, утомительно. Маршрутизатор берёт эту работу на себя.

Пример: вы пишете «нужно добавить валидацию email в форму регистрации», и маршрутизатор определяет, что это задача на добавление функции, выбирает рабочий процесс add-feature, присваивает имя ветке и запускает изолированное рабочее дерево. Вы можете явно указать рабочий процесс командой archon run add-feature, но это не обязательно.

Маршрутизатор работает на основе описаний рабочих процессов, которые хранятся в файлах Markdown в .archon/commands/. Если вы создаёте кастомный рабочий процесс, добавьте к нему описание, и маршрутизатор сможет его выбирать.

Режим «запустил и забыл»

Вы запускаете рабочий процесс и можете переключиться на другую работу. Archon выполнит все шаги, прогонит тесты, создаст PR и уведомит вас, когда всё будет готово. Вам не нужно сидеть и ждать завершения.

Проблема, которую это решает: классическая работа с ИИ-агентами требует вашего присутствия. Вы запускаете агента, следите за его действиями, вмешиваетесь, если что-то идёт не так. Вы не можете заниматься другими задачами, пока агент работает.

На практике: вы запускаете исправление трёх багов из Slack, идёте на встречу или обед, возвращаетесь к трём готовым PR. Каждый PR содержит изменения кода, результаты тестов и описание, сгенерированное по вашему шаблону. Вам остаётся только провести ревью и смержить.

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

Готовые рабочие процессы для типовых задач

Archon поставляется с 19 рабочими процессами по умолчанию: исправление багов, добавление функций, рефакторинг, написание тестов, ревью кода, обновление документации, миграция зависимостей и другие. Вы можете использовать их сразу после установки или взять за основу для создания собственных.

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

Список доступных рабочих процессов можно посмотреть командой archon workflow list. Каждый рабочий процесс хранится в .archon/workflows/defaults/ в репозитории Archon. Чтобы настроить рабочий процесс под себя, скопируйте его в .archon/workflows/ вашего проекта и отредактируйте. Файлы с одинаковыми именами в вашем репозитории переопределяют стандартные.

Примеры рабочих процессов:

Телеметрия с сохранением приватности

Archon отправляет анонимные события, чтобы разработчики могли понять, какие рабочие процессы используются, на каких платформах и насколько успешно. Это помогает расставлять приоритеты в развитии. Персональные данные не собираются никогда.

Что собирается:

Что не собирается:

Если вы хотите использовать собственный PostHog или другой проект, можно указать POSTHOG_API_KEY и POSTHOG_HOST в переменных окружения.

Условия использования Archon

Archon – это открытый опенсорсный проект, доступный для использования абсолютно бесплатно. Сервис предоставляется на условиях открытой лицензии, что позволяет пользователям свободно использовать, модифицировать и распространять программное обеспечение.

Вы имеете право:

• Использовать Archon в личных и коммерческих целях
• Изучать исходный код и адаптировать его под свои нужды
• Распространять оригинальную или модифицированную версию
• Вносить вклад в развитие проекта через открытый репозиторий

Запрещается:

• Использовать сервис для незаконной деятельности
• Нарушать права интеллектуальной собственности третьих лиц
• Распространять вредоносное ПО через платформу