Formas de iniciar o trabalho

O trabalho chega ao Coroid por meio de pessoas no portal, no Slack ou no Telegram, de seus próprios sistemas e assistentes, e também da automação do próprio Coroid. O Novo trabalho, em que uma pessoa descreve a tarefa no portal, é uma dessas rotas. Todas elas convergem para o mesmo caminho de execução — especificação, plano, construção, verificação, revisão, pull request.

Verificado, depois encaminhado#

Uma solicitação do Novo trabalho ou de importação não é criada assim que chega. Primeiro, passa pela Qualificação. O Coroid a analisa em busca de valores sensíveis, a compara com a versão atual, procura duplicatas, verifica o que pode ser feito e decide o que deve se tornar. Nada é criado até que seja aprovado. Veja Descrever o que você precisa.

As solicitações da captação de trabalho API também passam por ela, assim como os eventos que uma automação de eventos envia à Qualificação.

O que se torna é uma de quatro rotas:

No formulário de Novo trabalho, você pode escolher a rota ou deixar que seja definida automaticamente Automático e deixe que a Qualificação decida. Quando você escolhe uma opção e a Qualificação recomenda outra, você vê a recomendação e decide.

O Ask Coroid funciona de maneira diferente. No modo Assistente, o assistente de chat cria tarefas e planos diretamente, sem passar pela Qualificação. Um chat de Preparar trabalho, o fluxo de trabalho SDLC guiado, envia sua especificação aprovada para a Qualificação antes do início do planejamento. Veja Assistente de chat.

As outras rotas criam trabalho diretamente, sem passar pela Qualificação, e suas próprias configurações determinam o que pode ser iniciado. Para o servidor MCP, essas são suas aprovações e políticas de automação.

Quando o trabalho começa#

Ninguém espera no portal por uma solicitação do sistema de entrada de trabalho API ou por uma automação de eventos. O Coroid cria seu trabalho poucos minutos após a Qualificação aprová-lo. Se uma tarefa também será iniciada automaticamente depende da origem da solicitação:

Uma tarefa que não inicia automaticamente aguarda que alguém a inicie. A Qualificação mostra a solicitação como aguardando início, com um link para a tarefa. Os planos nunca iniciam sozinhos: eles aguardam aprovação, como sempre. Um agendamento aguarda na revisão para que uma pessoa decida quando será executado.

O Coroid cria o trabalho como o primeiro membro ativo desta lista: a pessoa que fez a solicitação ou configurou a automação, o criador da conta de serviço, o criador do projeto e um proprietário da organização.

Uma solicitação que não especifica projeto vai para o único projeto da organização. Se houver vários, a solicitação aguarda revisão na Qualificação, e o revisor escolhe o projeto ao aceitá-la.

Tarefa ou plano?#

O critério útil é a possibilidade de revisão. Se o trabalho concluído for um pull request que um colega consiga ler de uma só vez, é uma tarefa. Se exigir várias alterações em uma ordem definida, ou se você quiser aprovar a abordagem antes de qualquer implementação, é um plano.

Em caso de dúvida, prefira um plano para qualquer coisa 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 tornar muito grande simplesmente ficará sem espaço.

Trabalho importado#

Os problemas importados de um rastreador passam pelo mesmo processo de Qualificação. Duplicatas, problemas já corrigidos e solicitações que não podem ser verificadas são interrompidas nesse estágio, e o restante se torna tarefas ou planos. Um backlog é uma lista de desejos, portanto essa filtragem é ainda mais importante para importações do que em qualquer outro lugar. Veja Importando trabalho.

Dos seus próprios sistemas#

Outro sistema pode enviar solicitações por meio do canal de entrada de trabalho API: um formulário de solicitação de recurso no seu próprio produto, por exemplo, ou uma ferramenta de suporte que repassa o que os clientes pedem.

O API requer uma Conta de serviço, que está incluída nos planos Professional e Enterprise. Crie uma em Configurações → Contas de serviço. A chave do API precisa ter esse escopo: intake:write. A chave é exibida uma única vez, ao criá-la, e a desativação da conta de serviço invalida todas as suas chaves.

Envie cada solicitação para o gateway do API, usando a chave como token Bearer:

curl -X POST https://api.coroid.ai/api/v1/organizations/work/intake \
  -H "Authorization: Bearer ak_…" \
  -H "Content-Type: application/json" \
  -d '{"title": "Export invoices as CSV", "content": "Customers want to download their invoices as CSV from the billing page."}'

Sem um tipo de trabalho definido, a Qualificação escolhe o caminho a seguir. A Qualificação é executada em todas as solicitações do API e não pode ser ignorada.

Quando a solicitação vem de monitoramento ou outra fonte automatizada, descreva seu sinal. O Coroid usa esse dado para identificar incidentes duplicados em qualquer projeto e para elaborar o contrato de resultado.

Com routes e minExposure, o contrato é mensurável: o incidente deve permanecer silencioso. Sem eles, o contrato registra que não é possível medir isso. A ordem pode recusar-se a iniciar trabalhos impossíveis de medir.

Uma tarefa qualificada proveniente de uma conta de serviço aguarda que alguém a inicie. Um proprietário ou administrador pode alterar essa configuração para a conta em Contas de serviço com esta opção: Iniciar trabalho qualificado automaticamente. Ative-a somente quando todo o trabalho enviado pela conta vier de pessoas em quem você confia. Veja Quando o trabalho começa.

Eventos no GitHub, Slack, Telegram e Jira também podem se tornar solicitações, sem necessidade de redigitá-los. Uma automação de eventos os encaminha para a Qualificação. Veja Gatilhos e destinos.

Dos seus assistentes#

Um assistente ou agente que você executa, como Hermes, Codex ou Claude Code, pode trabalhar com Coroid por meio de seu servidor MCP. Ele pode ler seus projetos e trabalhos, e criar, executar e entregar tarefas dentro dos escopos que você conceder. O trabalho que ele cria não passa pela Qualificação. Veja Coroid como servidor MCP.

Entrada automatizada#

Agendas e gatilhos abrem trabalhos sem intervenção humana, diferenciando-se apenas no gatilho: tempo ou algo que acontece. Ambos são automações, listados na fábrica e criados em Novo trabalho.

As verificações de qualidade também geram tarefas de correção. Quando uma política de qualidade analisa um relatório e encontra problemas no produto, Coroid abre uma tarefa de remediação para eles. Factory → Revisão lista falhas de teste que não pertencem a nenhuma tarefa. Corrigir transforma uma delas em uma tarefa de correção.

Tudo isso consome slots reais de agente e custos reais de modelo. Dê à automação uma prioridade menor que ao trabalho aguardado por alguém — veja Capacidade e slots de agente.

Nesta seção#

• Descrevendo o que você precisa
• Tarefas
• Importando trabalho
• Planos
• Sprints
• Lançamentos