Documentação

Descrevendo o que você precisa

Toda a seção do formulário Novo trabalho, desde a escolha do que criar até o Controle de Qualidade e as configurações avançadas.

Novo trabalho é onde uma pessoa descreve o trabalho no portal. Você descreve o resultado uma única vez. O Coroid verifica a solicitação antes de qualquer coisa ser criada e depois a transforma em uma tarefa, um plano faseado, um relatório ou uma automação.

O trabalho também chega de rastreadores de issues, de seus próprios sistemas e de automações. Veja Formas de iniciar o trabalho.

Novo trabalho
Descreva o resultado desejado. O Coroid encontrará a maneira correta de entregá-lo.
Criar como
AutomáticoTarefaPlano
Coroid escolhe o resultado, ou você pode decidir.
Projeto
web-app
Título do trabalho
Permitir que os clientes exportem suas faturas em formato CSV
Resumo

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.

Anexar arquivos
Próximo: qualificação. Nada foi criado ainda.Continuar

O formulário Novo Trabalho: escolha o que criar, selecione o projeto e descreva o resultado em um título e um breve resumo.

Criar como

A primeira linha define o que a solicitação se tornará:

OpçãoProduz
AutomáticoO Coroid escolhe o caminho durante a Qualificação.
TarefaUma única tarefa, resultando em um único pull request.
PlanoUm plano faseado que você aprova antes que o código seja escrito.
RelatórioUm relatório gerado.
AutomaçãoTrabalho que roda em um cronograma ou quando algo acontece.

Automático é selecionado por padrão. O Coroid lê a solicitação enquanto a qualifica e escolhe o caminho adequado. Escolha um caminho você mesmo quando já souber a resposta: Tarefa quando o trabalho é uma única alteração que um revisor pode ler de uma só vez, Plano quando precisar de várias alterações em uma ordem específica, ou quando quiser ver toda a abordagem antes de se comprometer com alguma delas.

Se você escolher um caminho e a Qualificação recomendar outro, o formulário informará isso antes de qualquer coisa ser criada. Você pode aceitar a recomendação ou editar a solicitação.

O trabalho que abrange mais de um projeto sempre se torna um plano. Ao adicionar um segundo projeto, apenas Automático e Plano estão disponíveis.

O formulário se adapta ao fluxo de trabalho. Os Relatórios solicitam seus próprios detalhes mais abaixo, e as tarefas e planos exibem a seção de especificações. Uma automação possui seu próprio formulário: selecione quando ela será executada e qual ação realizará. Veja Automações.

Dois atalhos ficam 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 assistente de chat.

Projetos

Escolha o projeto ao qual este trabalho pertence. Para Automático e Plano você pode adicionar mais projetos quando o trabalho abrange projetos interdependentes. É assim que o trabalho entre projetos é expresso. Uma tarefa roda em exatamente um projeto.

Descreva o trabalho

Dois campos, e cada um desempenha uma função diferente.

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

Resumo: o conteúdo principal. Resultado esperado, contexto, restrições, material de origem e o que Coroid deve entregar. Escreva sobre o resultado, não sobre a implementação; Coroid transforma isso em uma especificação testável e verifica se o trabalho concluído atende a 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 real. As linhas de escopo fazem a diferença entre uma alteração focada e uma alteração ampla.

Para Automático, Tarefa e Plano você pode arrastar, colar ou anexar arquivos no resumo: capturas de tela, PDFs e notas. As tarefas aceitam imagens; os planos também aceitam PDFs e arquivos de texto.

Especificação

Tarefas e planos possuem uma Especificação seção com duas opções:

  • A partir do resumo: a opção padrão. Coroid redige a especificação a partir do seu resumo (intenção, histórias de usuário e critérios de aceitação) e, então, constrói e verifica o trabalho com base nela.
  • Escrever a minha própria: sua especificação substitui a gerada. Preencha a intenção, as histórias de usuário, os critérios de aceitação, as restrições, o valor comercial, a escopo e o tipo por conta própria.

Com Escrever a minha própria, Estruture com AI rascunha os campos a partir do seu resumo para que você possa editá-los a partir daí. Também exibe um registro de cobertura indicando o que foi preservado, o que foi adicionado e o que não coube, para que você possa confirmar que nada do resumo foi perdido.

Escreva a sua própria quando os critérios de aceitação já existirem, por exemplo, em um requisito de produto. Caso contrário, comece a partir do resumo e corrija o resultado na aba Especificação da tarefa. Veja Desenvolvimento orientado a especificações.

Configurações avançadas

Opcional. Os campos exibidos dependem do caminho.

As configurações avançadas para um plano. As tarefas exibem orçamento máximo de tokens, sprint e versão de destino, em vez de objetivo e restrições.

Use 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. O botão final muda para Preparar trabalho e abre uma preparação guiada em vez de criar o trabalho imediatamente.

Ative essa opção quando o trabalho for relevante o suficiente para que você queira um ponto de verificação antes mesmo de elaborar uma abordagem. Deixe desativado para trabalhos cujo resumo já é inequívoco. Veja O fluxo de trabalho do SDLC.

Qualificar antes do início do trabalho

Ativado por padrão. Quando a política da sua organização permitir, você pode desativar a qualificação para uma solicitação. Nesse caso, será necessário informar um motivo, e o responsável, o motivo, o horário e a política serão registrados permanentemente no histórico de auditoria. Quando a qualificação for ignorada, o título 'Configurações avançadas' indicará isso.

Objetivo

Apenas para planos. O que o plano deve alcançar além de o resumo. O resumo indica o que deve ser construído; o objetivo define para que serve.

AI profile

Quais modelos executam esse trabalho. Veja AI profiles.

Verificações de QA

Qual nível de verificação se aplica. Usar configuração padrão da política herda da política de Controle de Qualidade do projeto ou da organização. Padrão executa as verificações atuais. Detalhado adiciona verificações em tempo real mais rigorosas em relação ao resumo e pode rejeitar trabalhos que o modo Padrão aceitaria.

A política resolvida é definida quando a execução começa. Alterar a política posteriormente não modifica retroativamente o trabalho já em execução. Veja Políticas e barreiras de qualidade.

Prioridade

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

Orçamento de tokens

Para um plano, Orçamento de tokens por tarefa gerada limita quanto contexto cada tarefa gerada pode consumir. Para uma tarefa, Orçamento máximo de tokens limita a própria tarefa; deixe em branco para não haver limite. Aumente o orçamento para trabalhos que precisam ler extensivamente em um código-fonte grande; reduza-o para manter os custos baixos em tarefas rotineiras.

Restrições

Apenas para planos. Restrições do plano, não-objetivos, dependências e regras de entrega. É aqui que os não-objetivos explícitos devem ser incluídos, e este é o campo mais eficaz para evitar o aumento de escopo.

Iniciar de / Inserir pull request em

Indica o branch onde o trabalho começa e para qual branch o pull request direciona. Igual a 'Iniciar de' vem marcado por padrão, então ambos seguem a mesma configuração.

main → new Coroid branch → PR into main

Coroid sempre cria o branch 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 branch existente, e o formulário verifica se os branches existem no repositório remoto antes de prosseguir.

Use-os quando for fazer merge em algo diferente do seu branch padrão, como um develop branch ou um release train.

Sprint e release de destino

Tarefas e Automático solicitações que viram tarefas. Coloque a tarefa em um sprint e vincule-a a um release desde o início, em vez de atribuí-la depois.

Continuar: Qualificação

Nada é criado ao clicar em Continuar. Coroid primeiro analisa a solicitação em busca de credenciais e outros valores sensíveis e, em seguida, executa Qualificação:

Verificações de qualificação

  1. Normalizar e sanitarizar
  2. Filtrar injeção de comandos
  3. Verificar a versão atual
  4. Eliminar duplicatas e agrupar
  5. Verificar ou reproduzir
  6. Avaliar impacto e responsabilidade
  7. Encaminhar o trabalho

Nenhum trabalho existe até que as verificações sejam aprovadas.

QualificadoO trabalho é criado

Uma tarefa entra na fila; um plano inicia o planejamento. Com anexos, relatório ou cronograma, você confirma com Revisão e cria primeiro.

DuplicataJá corrigido

Nenhum novo trabalho. Uma duplicata é mesclada à solicitação que já a abrange.

Não reproduzívelPrecisa de revisão

Edite e tente novamente, feche ou crie mesmo assim com motivo registrado, se tiver permissão.

Todo registro fica sob Controle de Qualidade → Qualificação.

Nada é criado enquanto as verificações são executadas. O resultado determina se a solicitação vira trabalho, e todo registro permanece com suas evidências.

A Qualificação compara a solicitação com o release atual, procura por duplicatas, verifica ou reproduz o que for possível, avalia o impacto, a responsabilidade, o escopo e a complexidade, e define o caminho a seguir. Você pode acompanhar cada verificação em tempo real.

O que acontece a seguir depende do veredito:

  • Qualificado: uma tarefa ou plano sem anexos ou o fluxo de trabalho SDLC é criado assim que a Qualificação for aprovada. Caso contrário, você retorna ao formulário com Revisar e criar, e o botão final indica o que será criado: Criar tarefa, Criar plano, Gerar relatório ou Criar automação. Uma nova tarefa entra na fila imediatamente e um novo plano inicia o processo de planejamento.
  • Duplicado ou Já corrigido: nenhum novo trabalho é criado. Um duplicado é mesclado à solicitação que já o abrange.
  • Já resolvido: o mesmo problema ou falha já está sendo tratado em outra solicitação, em qualquer projeto. A solicitação é vinculada a esse trabalho em vez disso.
  • Nenhuma alteração necessária: a avaliação constatou que o comportamento relatado é intencional. Nenhum trabalho é criado.
  • Adiado: apenas para solicitações que chegam sem uma pessoa responsável, como do API de entrada de trabalho ou do monitoramento. O trabalho se qualifica, mas precisa aguardar sua vez. do mandato capacidade ou orçamento. Uma solicitação feita aqui nunca é adiada.
  • Não reproduzível, Rejeitado ou Precisa de revisão: nenhum trabalho é criado. Edite a solicitação, adicione evidências, tente a Qualificação novamente ou encerre-a.

Quando você discordar de um veredito, alguém com permissão pode Criar trabalho de qualquer forma. A substituição requer um motivo, e esse motivo é registrado.

As solicitações que aguardam uma decisão estão listadas em Factory → Revisão, e cada envio, independentemente do seu veredito, mantém sua própria página com suas verificações, evidências e histórico de auditoria.