# Работа агентов

Agent Teams делает работу агентов видимой через task state, messages, logs и reviewable code changes.

## Режимы

| Режим | Описание |
| --- | --- |
| Solo | Один teammate с самоуправляемыми задачами |
| Team | Несколько teammates, работающих параллельно и ревьюящих друг друга |

В обоих режимах используются одни и те же канбан, task logs и surface для код-ревью.

## Жизненный цикл задачи

| Этап | Что происходит | Владелец |
| --- | --- | --- |
| Provisioning | Приложение запускает runtime, проверяет, что процесс жив, и ждёт подтверждения bootstrap | App |
| Planning | Lead создаёт задачи, опционально назначает teammates и ставит зависимости | Lead или пользователь |
| In progress | Агенты работают параллельно и обновляют статус задач через board MCP tools | Teammates |
| Review | Изменения проверяют агенты или вы перед финальным принятием | Lead или пользователь |
| Done | Принятая работа остаётся связанной с историей задачи и доступна для просмотра | Пользователь |

### Planning → In progress

Когда teammate начинает задачу, статус на доске меняется на `in_progress`. Агент создаёт task comment с планом и продолжает работу. Все native tool actions (read, bash, edit, write) попадают в task log.

### In progress → Review

Когда агент завершает работу, он публикует result comment и помечает задачу как `completed`. Lead может принять задачу сразу или перевести её в review.

### Review → Done

Если изменения в review выглядят корректно, одобрите review. Задача финализируется и связывается с diff.

::: warning Review с правками
Если во время review агенту запрошены изменения, он должен оставить follow-up comment с исправлениями, после чего lead может одобрить задачу.
:::

## Канбан-доска

Доска - основной рабочий экран. Через неё удобно:

- Смотреть открытые, заблокированные и на ревью задачи
- Открывать task detail и читать runtime logs
- Ревьюить changes без ручного чтения session files
- Назначать или переназначать владельцев

::: tip
Используйте quick action buttons на карточках для старта, завершения или запроса ревью без открытия detail panel.
:::

## Сообщения и комментарии

| Канал | Когда использовать |
| --- | --- |
| Direct message | Перенаправить агента, задать быстрый вопрос |
| Task comment | Заметки, относящиеся к конкретной задаче |

Комментарии сохраняют контекст для review и появляются в таймлайне задачи.

::: tip Предпочитайте task comments
Если замечание относится к конкретной задаче, добавьте его как комментарий к задаче, а не direct message. Это сохраняет историю, привязанную к работе.
:::

## Task logs

Task-specific logs изолируют runtime output, actions и messages по одному assignment. Они помогают понять:

- Что агент запускал?
- Почему он изменил этот файл?
- Просил ли он помощи у teammate?
- Какая задача породила diff?

## Параллельная работа

Teammates могут работать над независимыми задачами одновременно. Вы также можете создавать зависимости (`blocked-by`), чтобы одна задача ждала завершения другой. Следите за заблокированными колонками на доске и переназначайте владельцев, если один teammate простаивает, а другой перегружен.

## Live processes

Live process section показывает URLs и running processes, когда агенты поднимают локальные servers или tools. Открывайте URL прямо из приложения. Процессы остаются зарегистрированными до явной остановки или выхода runtime.

## Межкомандное взаимодействие

Агенты могут отправлять сообщения в другие команды, если команды связаны. Используйте это для handoffs, shared libraries или status checks между командами.