PrumoGrid

InícioAprendaRecursosEtapas e resultado

RECURSOS / 09

Etapas e resultado

A aba Etapas lista cada tarefa do projeto com o estado dela; o Resultado mostra o que foi observado, a verificação e o próximo passo, inclusive aprovar ou devolver.

Atualizado para o PrumoGrid 0.5.11

Para que serve

A aba Etapas, na lateral direita, é a lista de trabalho do projeto selecionado: cada etapa criada pela Nova etapa, pelo Fluxo ou por uma rotina, com o estado dela e os botões para agir. Quando uma etapa termina, Ver resultado abre o que o PrumoGrid observou: quem fez, qual foi o veredito, o comando de verificação, o código de saída e o horário. É ali que você decide o próximo passo, como revisar as alterações, aprovar uma entrega ou devolver para correção.

Veja no vídeo

VÍDEO 05 · 1:02

Dois agentes, um fluxo. O Claude Code revisa, o Codex corrige e roda os testes, com um arquivo como ponte entre os dois. Legendas e transcrição ↗

Quando usar e quando não usar

Use a aba Etapas para saber, de relance, o que está rodando, o que espera e o que terminou, sem abrir terminal por terminal. Use Ver resultado antes de incorporar um trabalho: ele separa o que o agente disse do que um comando conferiu.

Para a ordem das etapas e quem espera quem, o Fluxo mostra melhor. Para responder a um pedido de permissão, a Atenção é mais rápida. Abrir um resultado não roda nada de novo: para conferir outra vez, use Verificar de novo….

Passo a passo

Ler o resultado de uma correção

Um fluxo da loja-api tem duas etapas: o Claude investiga o cupom PRIMEIRA e grava ANALISE.md; o Codex corrige e roda npm test.

  1. Clique na aba Etapas. O título mostra Etapas do projeto · 2, e o nome do fluxo aparece acima das linhas.
  2. Leia cada linha: Etapa 1 · Investigue por que o cupom PRIMEIRA… com concluída, e Etapa 2 · Leia ANALISE.md, corrija a causa… com o estado dela.
  3. Na etapa 2, clique em Ver resultado. O resultado ocupa a área central.
  4. Leia a identificação da etapa e o veredito: Verificação aprovada, Verificação reprovada ou Sinal de conclusão observado, quando só o agente avisou.
  5. Em O que foi registrado, confira Comando (npm test), Diretório, Código esperado, Código de saída, Veredito e Observado em.
  6. Se reprovou, abra Ver saída da verificação e leia o erro.
  7. Em Sua próxima ação, escolha Revisar alterações, Salvar como rotina ou Voltar ao projeto. Copiar resultado copia o relato para colar num chamado ou numa conversa.

Aprovar ou devolver uma revisão

A etapa 3 do fluxo, com o revisor, tem a condição Com sua aprovação. Quando o revisor termina, ela aparece em Precisa de você e na Atenção.

  1. Clique em Revisar. O diálogo Revisar a entrega mostra o trecho atual do terminal do revisor, com os achados.
  2. Leia os achados. Se estiverem bons, clique em Aprovar e continuar: a próxima etapa, se houver, é liberada.
  3. Se algo precisa mudar, clique em Devolver para correção…. Escolha o Terminal que fará a correção, escreva O que precisa ser ajustado, confira O que será entregue e clique em Enviar correção ao destinatário.

A devolução abre outra rodada no mesmo fluxo: a correção e uma nova revisão acontecem antes de liberar as etapas seguintes. A revisão anterior fica no histórico.

O que aparece na tela

Aba Etapas: cada linha diz o estado da etapa e mostra os botões que fazem sentido para ele.
Ver resultado: o que foi observado, sem reexecutar nada.

Os filtros do topo aparecem quando o projeto tem etapas: Todas, Precisa de você e Resultados. Cada linha tem um ponto e uma palavra de estado:

EstadoO que significaBotões que costumam aparecer
em execuçãoO agente está trabalhando na etapa.Abrir terminal
à esperaA etapa espera a vez, como a anterior ficar pronta.Abrir terminal
precisa de vocêUm pedido de permissão, uma revisão ou uma decisão sua.Ver pedido ou Revisar, Abrir terminal
aguardando permissãoUma etapa já concluída cujo agente voltou a pedir permissão.Ver pedido, Abrir terminal
concluídaA etapa ficou pronta.Continuar nesta sessão, Ver resultado
falhouO agente relatou falha ou a verificação reprovou.Ver saída, Abrir terminal

Mais, no fim de cada linha, guarda as ações menos usadas.

Abaixo das etapas ficam:

  • Instruções enviadas · N: as instruções que o PrumoGrid entregou aos terminais, com horário e origem. Ver todas abre a lista com busca, filtro por projeto e terminal, Ir ao ponto (salta até a instrução na conversa) e Copiar. O atalho é Ctrl+Shift+I. Comandos que você digita à mão no PowerShell ou no CMD não entram.
  • REGISTRO: o que aconteceu: os fatos observados, com horário, e os recibos de regras gravadas. Veja Histórico e gravação.

Revisar alterações

Revisar alterações, no resultado, e Ver mudanças, na etapa, abrem o diff da pasta da etapa.

  1. Confira o diretório mostrado no topo.
  2. Leia as mudanças preparadas e não preparadas para commit. Arquivos novos, ainda não rastreados pelo Git, aparecem só pelo nome: o conteúdo deles não é lido.
  3. Se quiser, escreva a mensagem do commit e clique em Commitar tudo….
  4. Leia a confirmação Commitar mudanças: ela mostra a pasta e a mensagem, e avisa que os arquivos alterados e não rastreados entram com git add -A. O commit é local; nada vai para servidor nenhum.

O diff é o estado atual da pasta, não uma fotografia do momento da etapa. Ele pode incluir mudanças suas ou de outra tarefa na mesma pasta. Para separar trabalhos, use worktrees.

Etapas de sessões encerradas

Quando você encerra a sessão de um terminal, as etapas dele saem da lista padrão e do Fluxo ativo. Para lê-las, use o filtro Resultados e Ver etapas de sessões encerradas (N). Uma queda temporária da conexão com o serviço não conta como sessão encerrada.

Excluir etapa ou encerrar a sessão

São coisas diferentes:

  • Excluir etapa, em Outras ações do cartão no Fluxo, tira a etapa do plano. O terminal dela continua aberto, com a conversa.
  • Encerrar sessão termina o shell e os processos do terminal. A etapa não fica aprovada por isso: término de processo não é conclusão.

Para trocar só o comando que confere a etapa, use Trocar critério em vez de excluir.

Dicas

  • Use o filtro Precisa de você no meio do dia: ele mostra só o que depende de você, em todas as etapas do projeto.
  • Antes de aprovar uma revisão, abra Revisar alterações e leia o diff você mesmo. O revisor é um agente; a aprovação é sua.
  • Copiar resultado leva o comando, o código de saída e o veredito, que é o que um colega precisa para conferir.
  • Instruções enviadas responde "o que exatamente o agente recebeu?" quando a resposta dele parece fora do pedido.

Limites conhecidos

  • O resultado guarda até 200 caracteres da saída da verificação. A verificação roda no serviço, fora do terminal do agente, então procurar a saída dela naquele terminal pode não dar em nada.
  • O resultado mostra só os eventos da mesma etapa. Onde não houve evento, ele não preenche com uma narrativa.
  • O diff pode vir truncado em arquivos grandes, e a tela avisa quando isso acontece.
  • O histórico de eventos da interface guarda até 2.000 eventos.
  • Abrir um resultado ou o filtro Resultados não reexecuta comandos.