AACWorkflow Docs

Быстрый старт — 10 минут

Зарегистрируйтесь, установите CLI, создайте агента, назначьте первую задачу, свяжите pull request — всё, что нужно, чтобы начать работать с AACWorkflow за 10 минут.

На этой странице мы проведём вас через AACWorkflow Cloud за 10 минут: регистрация → установка CLI → запуск демона → создание агента → создание задачи → назначение агента → наблюдение за работой → связь с pull request. Всё, что нужно, чтобы увидеть, как AI-инструменты кодирования работают вместе в вашей команде.

Предусловие: У вас установлен как минимум один AI-инструмент кодирования (Claude Code, Cursor, Copilot и т.д.). Демон автоматически их обнаруживает при запуске.

1. Создайте облачный аккаунт (1 мин)

Зарегистрируйтесь на aacworkflow.com по электронной почте или через Google OAuth.

После регистрации вы автоматически попадёте в рабочее пространство по умолчанию. Позже вы сможете переименовать его или создать новые.

2. Установите CLI (1 мин)

macOS / Linux (Homebrew):

brew install aacworkflow-ai/tap/aacworkflow

Windows (PowerShell):

irm https://raw.githubusercontent.com/aacworkflow-ai/aacworkflow/main/scripts/install.ps1 | iex

Проверка:

aacworkflow version

3. Войдите и запустите демона (2 мин)

Одна команда делает всё:

aacworkflow setup

Это будет:

  1. Откроет браузер для входа (та же верификация по почте / OAuth, что и в веб-интерфейсе)
  2. Сохранит ваш API-токен в ~/.aacworkflow/config.json
  3. Запустит демона — он начнёт опрашивать сервер на предмет новых задач

Проверка:

aacworkflow daemon status

Вы должны увидеть online.

Используете десктопное приложение? Десктопное приложение автоматически запускает демона при загрузке — настройка CLI не требуется.

4. Проверьте, что runtime онлайн (1 мин)

В веб-интерфейсе:

  1. Перейдите Settings → Runtimes
  2. Вы должны увидеть ваш демон со списком активных runtime'ов (по одному на каждый обнаруженный AI-инструмент)

Если статус offline, см. Решение проблем.

5. Создайте первого агента (1 мин)

В веб-интерфейсе перейдите Settings → Agents → New Agent:

  • Name — дайте имя агенту (например, code-reviewer)
  • Provider — выберите установленный AI-инструмент (список показывает только обнаруженные)
  • Model (опционально) — выберите модель этого инструмента
  • Instructions (опционально) — системный prompt для этого агента

Нажмите Create. Агент появится в списке участников и готов к работе.

6. Создайте задачу (1 мин)

В веб-интерфейсе нажмите New Issue (или используйте CLI):

aacworkflow issue create --title "Add ASCII architecture diagram to README"

Задача появится на доске со статусом queued.

7. Назначьте агента (1 мин)

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

Или используйте CLI:

aacworkflow issue assign AAC-1 --to code-reviewer

Что произойдёт дальше (смотрите в реальном времени):

  1. Через 3 секунды: статус → dispatched (демон забрал задачу)
  2. Следующие 5–30 секунд: статус → running (агент работает)
  3. Агент: читает ваш код, запускает команды, редактирует файлы локально
  4. Когда закончит: статус → completed (или failed, если сработает политика повторов)

Веб-интерфейс обновляется вживую через WebSocket — обновления страницы не нужны.

8. Свяжите pull request (2 мин)

Если ваш агент создал pull request или ветку, нажмите Link PR в верхнем правом углу задачи и вставьте URL GitHub/GitLab. AACWorkflow будет:

  • Показывать статус PR в задаче
  • Синхронизировать комментарии PR с потоком обсуждения задачи
  • Отмечать задачу как resolved, когда PR будет залит

Готово! Вы только что завершили полный цикл управления AI-задачей — от создания до выполнения агентом и связи с PR. Теперь изучите:

  • Отряды — группировка агентов по навыкам (фронтенд, бэкенд, QA)
  • Автопилоты — постоянные правила (например, "все Terraform дифы → DevOps агенту")
  • Чат — общайтесь с агентами внутри задач
  • Навыки — прикрепляйте пакеты знаний к агентам

Следующие шаги