Documentação

Formas de iniciar o trabalho

Os caminhos pelos quais o trabalho entra no Coroid e os quatro resultados para os quais ele pode ser direcionado.

O trabalho chega ao Coroid por diversos caminhos, todos convergindo para o mesmo trajeto de execução — especificação, plano, construção, verificação, revisão, pull request.

RotaUsar quando
Novo trabalhoAlguém deseja algo e está aqui para descrevê-lo.
Importar issuesA solicitação já existe no Jira, Linear, Trello ou no GitHub Issues.
Perguntar ao CoroidVocê prefere descrever o pedido de forma conversacional.
AgendasO gatilho é o tempo.
SentinelO gatilho é uma condição que se torna verdadeira.
HooksO gatilho é um evento da plataforma.

Você escolhe o resultado.

Independentemente de como o trabalho chega, você decide o que ele se tornará. O formulário de Novo trabalho solicita isso primeiro, e o restante do formulário se adapta à sua resposta:

RoteamentoProduz
Uma tarefa executávelUma única tarefa, resultando em um pull request.
Plano de trabalho faseadoUm plano faseado que você aprova antes da escrita do código.
RelatórioUm relatório gerado.
AgendaUm monitoramento recorrente.

Tarefa ou plano?

O teste útil é a capacidade de revisão. Se o trabalho finalizado for um pull request que um colega possa ler em uma única sessão, trata-se de uma tarefa. Se exigir várias alterações em uma ordem definida, ou se você quiser aprovar a abordagem antes de qualquer parte ser construída, trata-se de um plano.

Quando em dúvida, prefira um plano para qualquer item substancial. Um plano oferece um ponto de aprovação antes da existência do código, que é o momento mais barato para mudar de ideia. Uma tarefa que se revele muito grande simplesmente esgotará seu espaço.

Trabalho importado

Issues importados de um rastreador não são executados automaticamente — você ainda precisa roteá-los. Uma lista de pendências é uma lista de desejos, e nem tudo nela deve ser construído por um agente sem que alguém decida. Veja Importando trabalho.

Entrada automatizada

Agendas, Sentinel e hooks iniciam o trabalho sem intervenção humana, diferenciando-se apenas pelo gatilho: tempo, uma condição observada e um evento da plataforma.

Todos os três consomem slots de agentes reais e gastos com modelo reais. Dê ao trabalho automatizado uma prioridade menor do que o trabalho aguardado por alguém — veja Capacidade e slots de agentes.

Nesta seção