Попросите ИИ исправить баг — три запуска могут дать три разных результата.
Иногда он забывает прогнать тесты, иногда описание PR получается невнятным, а иногда он пропускает этап планирования и сразу пишет код — каждый запуск зависит от «настроения» модели. Главная боль ИИ-инструментов для программирования — не недостаток способностей, а отсутствие детерминированности.
У Archon (coleam00/Archon) решение простое: Dockerfile стандартизировал инфраструктуру, GitHub Actions стандартизировал CI/CD — значит, и процесс ИИ-кодирования тоже нуждается в стандартизации.
От конструктора агентов к движку воркфлоу
Проект полностью переписали — с Python на TypeScript, а позиционирование сменилось с «конструктора ИИ-агентов» на «движок рабочих процессов для ИИ-кодирования». Ключевое изменение: вместо того чтобы заставлять ИИ самому решать, что делать, процесс разработки кодируется в YAML-воркфлоу, а ИИ подключается только там, где нужен интеллектуальный выбор.
Типичный воркфлоу выглядит так:
nodes:
- id: plan
prompt: "Explore the codebase and create an implementation plan"
- id: implement
depends_on: [plan]
loop:
prompt: "Read the plan. Implement the next task. Run validation."
until: ALL_TASKS_COMPLETE
- id: run-tests
depends_on: [implement]
bash: "bun run validate" # Детерминированный шаг, ИИ не нужен
- id: review
depends_on: [run-tests]
prompt: "Review all changes against the plan."
- id: create-pr
depends_on: [review]
prompt: "Push changes and create a pull request"
Пять узлов: планирование → реализация → тестирование → ревью → PR. ИИ нужен только в implement и review, а run-tests выполняется полностью детерминированно. ИИ больше не «полноценный агент», а «интеллектуальный модуль по запросу».
17 предустановленных воркфлоу
Archon поставляется с 17 воркфлоу, покрывающими большинство сценариев повседневной разработки:
| Воркфлоу | Назначение |
|---|---|
| archon-fix-github-issue | Классификация → исследование → реализация → верификация → PR → ревью → самовосстановление |
| archon-idea-to-pr | Идея → планирование → реализация → верификация → PR → 5 параллельных ревью → самовосстановление |
| archon-comprehensive-pr-review | 5 параллельных ревьюеров, автоматическое исправление |
| archon-smart-pr-review | Классификация по сложности, запуск специфичного ревью |
| archon-architect | Архитектурное сканирование, снижение сложности |
| archon-refactor-safely | Безопасный рефакторинг с хуками проверки типов |
| archon-resolve-conflicts | Обнаружение → анализ → разрешение → верификация конфликтов |
| archon-plan-to-pr | Выполнение готового плана до создания PR |
Вы также можете определить собственные YAML-воркфлоу в директории .archon/workflows/ — после коммита в репозиторий вся команда будет работать по единому процессу.
Ключевая архитектура: изоляция через git worktree
Каждый запуск воркфлоу выполняется в изолированном git worktree. Это значит, что вы можете одновременно запустить 5 задач по исправлению — они не будут конфликтовать, каждая работает в своём бранче. По завершении вы оказываетесь на бранче с уже созданным PR.
«Fire and forget» — запустил и забыл, вернулся и забрал PR.
Мультиканальный запуск
Помимо CLI и Web UI, Archon поддерживает удалённый запуск воркфлоу из Slack, Telegram, Discord и GitHub Webhooks. Telegram и Discord подключаются за 5 минут, Slack и GitHub — за 15.
Web UI включает чат-интерфейс, панель мониторинга воркфлоу в реальном времени, drag-and-drop редактор воркфлоу и единый центр сообщений — все сообщения со всех платформ собираются в одном месте.
Архитектура и зависимости
Platform Adapters (Web/CLI/Telegram/Slack/Discord/GitHub)
↓
Orchestrator
↓ ↓
Command Workflow AI Assistants (Claude / Codex / Pi)
Handler Executor
Слой хранения — SQLite или PostgreSQL (7 таблиц), управление репозиториями, диалогами, сессиями и записями запусков воркфлоу.
На данный момент основная зависимость — Claude Code (также поддерживаются Codex и Pi). Установка через Homebrew, скрипт одной командой или Docker. Сборка из исходников требует Bun + Claude Code.
Данные
- ⭐ 20.5k звёзд, 3.1k форков
- 1 355 коммитов, последний — 9 часов назад
- Написан на TypeScript, активная ветка разработки
- Лицензия MIT
- Сайт: archon.diy
Archon — это не очередной «агент, который пишет за вас код». Он решает более фундаментальную задачу: как добиться одинакового результата при каждом запуске, когда агент уже есть. Командам, настрадавшимся от непредсказуемости ИИ-программирования, этот проект стоит изучить.