Documentação

Tarefas

A visualização de detalhes da tarefa — fluxo de trabalho dos agentes, critérios de aceitação, histórico de execução e tudo o que foi registrado.

Uma tarefa é uma unidade de trabalho que resulta em um pull request. É o que realmente é executado — planos, sprints e lanes são formas de organizar tarefas.

O cabeçalho

Uma linha de chips resume a tarefa de forma rápida: seu projeto, sua tipo, o AI profile que a executa, e as verificações de QA aplicadas — exibidas como nome da política, origem e versão, por exemplo Standard · From plan · Organisation policy · v6.

Um cadeado no AI profile indica que ele está fixo e não pode ser alterado agora. A política de QA resolvida também é travada ao iniciar a execução, para que mudanças na política da organização não afetem retroativamente o trabalho já em andamento.

Visualização de detalhes da Tarefa: a árvore de planejamento à esquerda e, à direita, a linha de chips, o fluxo de trabalho dos agentes, os critérios de aceitação e o histórico de execução.
Uma Tarefa dentro de um plano, com seu fluxo de trabalho de agentes e critérios de aceitação.

Fluxo de trabalho dos agentes

Cada um dos quatro agentes de entrega exibe seu próprio status — Pendente, em execução ou concluído. No modo padrão, eles operam sequencialmente:

Arquiteto → Desenvolvedor → QA → Revisor

Esta é a resposta mais clara para a pergunta "onde está esta tarefa?". Uma tarefa com status Desenvolvedor concluído e QA Pendente está aguardando verificação, não parada.

No modo coordenador, o coordenador escolhe qual agente será executado em seguida, permitindo que a ordem se repita: desenvolvedor, QA, desenvolvedor novamente após uma falha, QA mais uma vez. A sequência também pode ser mais curta: quando o código já faz o que a tarefa solicita, o QA verifica o código sem alterações, o desenvolvedor não é executado e a tarefa é concluída sem um pull request. Consulte Funções dos agentes.

Observe que uma etapa pode legitimamente exibir Pendente mesmo em uma tarefa finalizada — as tarefas geradas a partir de um plano já possuem sua especificação e plano de implementação, portanto a etapa de Arquiteto não tem mais nada a fazer.

Consulte Funções dos agentes para saber o que cada um pode ou não fazer.

Critérios de aceitação

Os critérios provenientes da especificação, como uma lista de verificação com um status para cada item — Verified OK quando um critério foi confirmado.

Os status seguem a etapa atual do pipeline, de modo que os critérios são verificados à medida que a tarefa avança, e não apenas no final.

Este painel é essencial para avaliar uma tarefa concluída. Ele indica o que foi prometido e o que foi efetivamente confirmado, o que é mais relevante do que simplesmente saber se os testes foram aprovados.

Histórico de execução

Toda execução registrada para a tarefa. Cada entrada revela o agente, sua atividade, o resultado e o custo:

DEV · Generating code · Completed
4m 41s / 608.9k tokens · 16.2 g Est. CO2e / deepseek-v4-flash-0731

Duração, uso de tokens, emissão estimada de carbono e o modelo exato são todos registrados por execução — assim, se uma tarefa custar mais que o esperado, você poderá identificar qual etapa e qual modelo causaram isso.

Histórico de execução expandido listando cada etapa: arquivos lidos, comandos executados, respostas dos agentes e arquivos alterados com contagem de linhas.
Execução expandida, passo a passo.

Ao expandir uma execução, você visualiza o histórico passo a passo completo: arquivos lidos, comandos executados, raciocínio do agente e todos os arquivos alterados com suas contagens de linhas+25 / −0). As entradas de tokens mostram a eficiência do cache (9.1k used (90% cached)), que geralmente determina se uma execução é cara ou barata.

Esta é a visão a ser aberta quando você deseja saber como algo foi feito, em vez de apenas o que mudou.

As seções restantes

SeçãoExibe
EspecificaçãoOs requisitos derivados do plano
Plano de implementaçãoAs etapas e seu status de conclusão
Qualidade e descobertasEstado de verificação e contagem de testes
Uso e cronogramaCusto, tokens e número de tentativas
Dependências e contextoDependências vinculadas com seus respectivos status

Uso e cronograma relata tentativas e custo — 1 attempts significa que foi bem-sucedido na primeira tentativa. Um número maior indica retrabalho, o que é o sinal mais útil sobre a qualidade da especificação.

A seção Dependências e contexto, exibindo o projeto e dez dependências vinculadas, cada uma com seu respectivo status.
Dependências e contexto, em modo expandido.

Dependências e contexto lista o projeto e todas as dependências vinculadas com seu status. Isso permite saber se uma tarefa está aguardando algo ou realmente bloqueada.

Prioridade

As tarefas possuem P0 (maior) até P3, assumindo o valor P2. A prioridade ordena a fila quando há mais tarefas aguardando do que vagas disponíveis.

Ela não aumenta a capacidade. Se tudo estiver P0, nada será processado — veja Capacidade e vagas de agentes.

Status

Todo status de tarefa e as ações correspondentes estão descritos em Status das tarefas. Os dois mais importantes aqui são:

  • PENDING não está travada. Ela está na fila, aguardando uma vaga.
  • NEEDS_HUMAN_REVIEW não é uma falha. É uma questão pendente. Responda-a e a tarefa continuará.

Intervenção

Enquanto uma tarefa está em execução, você pode pausá-la, cancelá-la ou enviá-la de volta com comentários para retrabalho. Para saber qual opção escolher, consulte Quando uma tarefa trava ou falha.