ИИ-программирование больше не лотерея: Archon превращает агентов в конвейер с помощью YAML-воркфлоу

ИИ-программирование больше не лотерея: Archon превращает агентов в конвейер с помощью YAML-воркфлоу

Попросите ИИ исправить баг — три запуска могут дать три разных результата.

Иногда он забывает прогнать тесты, иногда описание 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-review5 параллельных ревьюеров, автоматическое исправление
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 — это не очередной «агент, который пишет за вас код». Он решает более фундаментальную задачу: как добиться одинакового результата при каждом запуске, когда агент уже есть. Командам, настрадавшимся от непредсказуемости ИИ-программирования, этот проект стоит изучить.