Uma tarefa é uma unidade de trabalho que resulta em um pull request. Comece uma a partir de Novo trabalho, e selecione Tarefa em Criar como. Deixando-o em Automático permite que o Coroid escolha entre uma tarefa e um plano.
Escolha uma boa primeira tarefa
A melhor primeira tarefa é pequena, real e próxima de testes existentes. Algo como
"adicionar um --json parâmetro ao comando de exportação, compatível com o formato que o comando de importação
já aceita" dá ao Coroid um alvo claro e oferece a você uma avaliação precisa
do resultado.
Evite, para uma primeira execução:
- qualquer coisa relacionada a autenticação, pagamentos ou migração de dados
- trabalho que precise de uma decisão de design ainda não tomada
- limpezas vagas — "melhorar o tratamento de erros" não tem um fim definido
Descreva o que você deseja
Escreva o resultado esperado, não a implementação. Indique o que deve ser verdadeiro após a conclusão do trabalho e mencione tudo que não seja óbvio: arquivos relevantes, convenções a seguir ou partes que não devem ser alteradas.
Você não precisa escrever o plano. Essa é a primeira coisa que o Coroid gera, e você pode aprová-lo.
Se houver contexto que o código não contenha — uma ADR, um guia de estilo, um ticket — anexe-o. Consulte Contexto do projeto para saber o que o Coroid já conhece sem precisar ser informado.
As equipes financeiras sempre pedem suas faturas em planilha. Adicione um botão de exportação à lista de faturas que baixe o filtro atual como CSV.
Concluído quando: o arquivo abrir no Excel e no Numbers, os valores usarem a moeda da conta e exportações com mais de 10.000 linhas não apresentarem timeout.
O formulário Novo Trabalho: escolha o que criar, selecione o projeto e descreva o resultado em um título e um breve resumo.
Continuar pelo processo de Qualificação
Selecione Continuar. Nada foi criado ainda: o Coroid analisa a solicitação, verifica se ela confere com a versão atual, procura por duplicatas e confirma o caminho a seguir. Quando aprovada, a tarefa é criada e entra na fila. Se a etapa de Qualificação a bloquear, os motivos serão informados, e você poderá editar a solicitação e tentar novamente. Veja Descrevendo o que você precisa.
Revisar as Especificações
O Coroid transforma sua descrição em uma especificação: o que será construído, o que está fora do escopo e os critérios de aceitação que definem o sucesso. Ela aparece na aba Especificações da tarefa.
Leia-a antes de qualquer construção. Se os critérios de aceitação não corresponderem ao que você deseja, corrija-os agora — são eles que serão usados na fase de verificação posterior. Veja Especificações.
Aprovar o plano
Para alterações além de mudanças triviais, a especificação vira um plano: um conjunto ordenado de etapas. Você o aprova antes que o código seja escrito.
Este é o momento mais barato para intervir. Rejeitar um plano custa apenas um minuto. Rejeitar um pull request já finalizado custa uma execução inteira.
Acompanhar a execução
Uma vez criada, a tarefa entra em PENDING até que uma vaga de agente esteja disponível, então
IN_PROGRESS. Você pode acompanhar a execução em tempo real: as etapas realizadas, as ferramentas utilizadas, os arquivos modificados e a saída dos testes à medida que são gerados.
Você não precisa assistir. As Notificações informarão quando precisar intervir ou quando a tarefa estiver concluída.
O que esperar
- Duração é determinada pelo tamanho da alteração e pelo tempo que seu conjunto de testes leva, não pelo número de vagas de agente que você possui. As vagas controlam quantas tarefas podem ser executadas simultaneamente.
NEEDS_HUMAN_REVIEWnão é uma falha. Isso significa que o Coroid chegou a uma decisão que só você pode tomar. Responda e a tarefa continuará.- Retrabalho é normal. Se o revisor encontrar algo, a tarefa retorna ao desenvolvedor antes que você a veja.
Próximo
Revisar e mesclar o resultado — o que chega e o que verificar.