Documentação

Descrevendo o que você precisa

Todos os campos do formulário Novo trabalho, desde o roteamento até as configurações avançadas de planos.

Novo trabalho é a principal forma de inserir trabalho no Coroid. Você descreve o trabalho uma vez e depois o roteia como uma tarefa, um plano faseado, um relatório ou uma programação recorrente.

O formulário Novo trabalho, exibindo as quatro opções de roteamento acima do seletor de projeto e dos campos de descrição do trabalho.
Novo trabalho: roteamento, projetos e descrição do trabalho.

Roteamento — escolha o resultado primeiro

O roteamento é uma escolha sua, não uma suposição feita pelo Coroid. Selecione-o primeiro; o formulário exibirá apenas as opções aplicáveis a esse resultado.

OpçãoProduz
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
ProgramaçãoUm monitoramento recorrente

Escolher uma tarefa executável quando o trabalho consiste em uma única alteração que um revisor pode ler em uma sessão. Escolher plano de trabalho faseado quando são necessárias várias alterações em uma ordem específica, ou quando você deseja ver toda a abordagem antes de se comprometer com qualquer uma delas.

Dois atalhos estão ao lado do formulário: Importar issues traz o trabalho de um rastreador, e Perguntar ao Coroid encarrega o mesmo trabalho ao assistente de chat.

Projetos

Escolha o projeto ao qual este trabalho pertence. Você pode adicionar mais projetos quando o trabalho abrange projetos dependentes — é assim que o trabalho entre projetos é expresso.

Descreva o trabalho

Dois campos, e cada um tem uma função distinta.

Título do trabalho — um nome curto. É o que você buscará nas listas posteriormente.

Resumo — o conteúdo: resultado, contexto, restrições, material de origem e o que o Coroid deve entregar. Descreva o resultado, não a implementação; o Coroid o transforma em uma especificação testável antes que o trabalho seja verificado conforme essas promessas.

Add rate limiting to the public API.

100 requests per minute per API key. Exceeding it returns 429 with a
Retry-After header. Limits are per key, not per IP.

Internal service-to-service calls are exempt — they authenticate with
service tokens, not API keys.

Do not change the existing auth middleware's public interface.

Essa última linha realiza um trabalho importante. As linhas de escopo fazem a diferença entre uma alteração focada e uma alteração dispersa.

Configurações avançadas

Opcional, e normalmente definida antes do início do planejamento.

Configurações avançadas expandidas, mostrando o toggle do fluxo de trabalho SDLC, Meta, perfil AI profile, verificações de QA, Prioridade, orçamento de tokens, Restrições e campos de branch.
Configurações avançadas, expandidas.

Usar o fluxo de trabalho SDLC

Desativado por padrão. Ative-o para revisar uma intenção e uma especificação antes do início do planejamento. Se omitido, o planejamento começa diretamente a partir do seu resumo.

Ative essa opção quando o trabalho for suficientemente importante para exigir um ponto de verificação antes mesmo da elaboração de uma abordagem. Desative-a para tarefas cujo resumo já seja claro.

Objetivo

O que o plano deve alcançar além do resumo. Use-o para definir o resultado por trás da solicitação — o resumo indica o que construir, e o objetivo define para que serve.

AI profile

Quais modelos executarão esse trabalho. Veja Perfis do AI.

Verificações de QA

Qual política de qualidade se aplica. Por padrão, utiliza-se a política de Controle de Qualidade da organização, e a política definida é fixada ao iniciar a execução — alterar a política da organização posteriormente não modifica retroativamente o trabalho já em andamento.

Veja Políticas e portas de qualidade.

Prioridade

P0 para P3, usando como padrão P2. A prioridade ordena a fila quando há mais trabalho aguardando do que vagas disponíveis para agentes. Ela não aumenta a capacidade — veja Capacidade e vagas de agentes.

Orçamento de tokens por tarefa gerada

O limite máximo de contexto que cada tarefa gerada pode consumir. Aumente-o para trabalhos que precisam analisar grande parte de um código-fonte; reduza-o para manter os custos controlados em tarefas rotineiras.

Restrições

Restrições do plano, objetivos não desejados, dependências e regras de entrega. É aqui que os objetivos não desejados devem ser declarados — o campo mais eficaz para evitar o crescimento indesejado do escopo.

Iniciar a partir de / Inserir pull request em

De qual ramo o trabalho começa e para qual ramo o pull request direciona. Igual ao campo 'Iniciar a partir de' está marcado por padrão, fazendo com que ambos sigam a mesma configuração.

main → new Coroid branch → PR into main

Coroid sempre cria o ramo de trabalho. Esses campos apenas alteram o ponto de ramificação e onde o pull request é inserido — eles não permitem que Coroid faça commit diretamente em um ramo existente.

Use-os quando for fazer merge em algo diferente do seu ramo padrão, como um develop ramo ou um trem de lançamento.

Adicionar contexto de apoio

Arquivos opcionais e uma especificação estruturada. Anexe materiais específicos deste trabalho — um ticket, um documento de design, um rastreamento de pilha.

Para materiais que são permanentemente válidos para o projeto, use contexto do projeto em vez disso, para que se aplique a tudo, em vez de precisar ser anexado novamente a cada vez.

Iniciando o processo

Criar e iniciar o planejamento cria o plano a partir do seu resumo e inicia o planejamento imediatamente.