Настройка агентов

Подключи своих ИИ Coding-агентов к bd CLI, чтобы они могли создавать, обновлять и закрывать bead. Beadbox показывает их работу в реальном времени.

Предварительные требования

Перед настройкой агентов тебе нужно:

  • Установленный bd CLI в PATH (Начало работы)
  • Минимум один инициализированный воркспейс (bd init в каталоге проекта)
  • Запущенный Beadbox, подключённый к этому воркспейсу

Идентичность агента

Каждому агенту нужен файл CLAUDE.md (или аналогичный системный промпт), определяющий:

  • За что отвечает агент (реализация, QA, эксплуатация)
  • За что агент не отвечает (предотвращает выход за рамки своей роли)
  • Как коммуницировать (комментировать bead, отчитываться координатору)

Вот минимальная идентичность для инженерного агента:

## Identity
Engineer for MyProject. You implement features, fix bugs,
and write tests. You own implementation quality.

## Boundary with QA
QA validates your work independently. You provide QA with
executable verification steps. If your DONE comment doesn't
let QA verify without reading source code, it's incomplete.

Раздел границ не даёт агенту выполнять работу QA. Без явных границ агенты сами себя проверяют и пропускают независимый ревью.

Основные команды

Вот команды bd, которые твои агенты используют чаще всего:

Создать bead

bd create --title="Fix login bug" --type=bug --priority=2

Просмотреть bead

bd show BEAD-ID

Обновить статус и взять задачу

bd update BEAD-ID --claim --actor agent-name
bd update BEAD-ID --status in_progress

Опубликовать план или отчёт о завершении

bd comments add BEAD-ID --author agent-name "PLAN: ..."
bd comments add BEAD-ID --author agent-name "DONE: ..."

Список bead

bd list --status=open --assignee=agent-name

Закрыть завершённый bead

bd close BEAD-ID

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

Команда bd prime

Самый быстрый способ обучить нового агента bd CLI:

bd prime

Выводит контекстный блок, предназначенный для ИИ-ассистентов. Он охватывает полный набор команд, форматы вывода и типичные рабочие процессы. Вставь его в системный промпт или контекстное окно агента.

Запусти bd prime из каталога воркспейса, чтобы включить контекст, специфичный для этого воркспейса.

Рабочий процесс агента

Типичный рабочий процесс агента для одного bead:

  1. Взять bead
  2. Прокомментировать план перед написанием кода
  3. Реализовать изменение
  4. Запустить тесты
  5. Прокомментировать завершение с шагами верификации
  6. Запушить и обновить статус на ready_for_qa
# Full workflow example
bd update proj-a1b2 --claim --actor eng1
bd comments add proj-a1b2 --author eng1 "PLAN: 1. Fix auth check 2. Add test"

# ... implement and test ...

bd comments add proj-a1b2 --author eng1 "DONE: Fixed auth. Commit: abc123"
git push
bd update proj-a1b2 --status ready_for_qa

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

Обратная связь в реальном времени

Когда агент выполняет команду bd, Beadbox обнаруживает изменение в базе данных и обновляет интерфейс в течение двух секунд. Ручное обновление не требуется.

Это значит, что ты можешь наблюдать за работой агентов в реальном времени: видеть, как bead переходят из open в in_progress, как планы появляются в виде комментариев, и ловить блокеры в момент их возникновения.

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