Документация

Способы начать работу

Пути поступления задач в Coroid и четыре возможных результата их обработки.

Задачи попадают в Coroid по нескольким каналам, все они ведут к одному и тому же пути выполнения — спецификация, план, разработка, проверка, рецензирование, pull-запрос.

МаршрутИспользовать, когда
Новая работаКто-то хочет что-то получить и готов описать это.
Импорт задачЗапрос уже существует в Jira, Linear, Trello или GitHub Issues.
Задать вопрос CoroidВы предпочитаете описать всё в неформальной беседе.
РасписанияТриггером служит время.
SentinelТриггером служит выполнение определённого условия.
ХукиТриггером служит событие в платформе.

Вы выбираете итоговый результат.

Как бы ни поступала задача, вы определяете, во что она превратится. Форма «Новая работа» сначала запрашивает этот параметр, а остальные поля формы подстраиваются под ваш ответ:

МаршрутизацияРезультат
Одна исполняемая задачаОдна отдельная задача, завершающаяся созданием одного pull request.
Поэтапный план работПоэтапный план, который вы утверждаете перед написанием кода.
ОтчётСгенерированный отчёт.
РасписаниеПовторяющийся мониторинг.

Задача или план?

Полезный критерий — возможность рецензирования. Если готовый результат — это один pull request, который коллега может прочитать за один присест, значит, это задача. Если для его создания нужны последовательные изменения или вы хотите утвердить подход до начала разработки, значит, это план.

Если сомневаетесь, для всего значимого выбирайте план. План даёт вам точку контроля перед написанием кода — это самое дешёвое место для корректировки решения. Задача, оказавшаяся слишком объёмной, просто не поместится в отведённое ей место.

Импортированная работа

Задачи, импортированные из трекеров, не запускаются автоматически — их всё равно нужно маршрутизировать. Очеред задач — это лишь список пожеланий, и не всё из него должно обрабатываться агентом без вашего участия. Подробнее — Импорт задач.

Автоматизированный ввод

Расписания, Sentinel и хуки запускают задачи без участия человека; различие лишь в триггерах: время, выполнение условия и событие в платформе.

Все три варианта потребляют реальные слоты агентов и вычислительные ресурсы модели. Приоритет автоматизированных задач должен быть ниже, чем у задач, которые ждут вашего внимания — см. Мощности и слоты агентов.

В этом разделе