RECURSOS / 08
Fluxo
Etapas em sequência: uma começa quando a anterior fica pronta, no mesmo terminal ou em outro, e o Fluxo mostra quem está trabalhando, quem espera e o que ficou pronto.
Atualizado para o PrumoGrid 0.5.11
Para que serve
Um fluxo é uma sequência de etapas do mesmo projeto, cada uma com a condição para a seguinte começar. O PrumoGrid entrega a instrução da etapa 2 quando a etapa 1 fica pronta, e assim por diante, sem você ficar olhando o terminal para digitar o próximo pedido. A visão Fluxo, ao lado de Grade e Foco, mostra as etapas como cartões, com o agente, o papel, quando cada uma começa e o que a faz ficar pronta. É o mesmo plano que a aba Etapas lista na lateral, desenhado em ordem.
Veja no vídeo
Fluxo simples. Duas etapas no mesmo terminal, com a segunda herdando o contexto da primeira. Legendas e transcrição ↗
Quando usar e quando não usar
Use um fluxo quando uma tarefa depende do resultado de outra: ler e depois sugerir testes, analisar e depois corrigir, corrigir e depois revisar. Ele também serve para pôr dois agentes diferentes na mesma tarefa, um revisando e outro corrigindo.
O Fluxo é opcional. Se você trabalha só com projetos, terminais, a Grade e o Foco, pode ignorar esta parte. Para uma tarefa única, use a Nova etapa ou chame o agente direto no terminal.
Duas tarefas que não se esperam ficam melhor como etapas avulsas.
Passo a passo
Duas etapas no mesmo terminal
O Claude Code lê a regra do frete grátis da loja-api e, na mesma conversa, sugere testes para ela.
- Selecione
loja-apie clique em Fluxo na barra. - Com o Fluxo vazio, clique em Criar fluxo.
- Em Tarefa e destino, escreva
Leia src/frete.cjs e explique em até três linhas a regra do frete grátis.O resumo mostra o agente padrão e o projeto,Claude Code · loja-api. - Clique em Conferir etapa e depois em Adicionar ao planejamento. A etapa 1 aparece como planejada.
- Na barra embaixo dos cartões, clique em + Adicionar etapa.
- Escreva
Agora sugira dois casos de teste para essa regra, uma linha cada. Não altere arquivos. - Confira o destino Continuar neste terminal e o início após a etapa 1 ficar pronta. Clique em Conferir e em Adicionar ao planejamento.
- Clique em Executar fluxo. A etapa 1 começa.
- Quando o Claude termina a etapa 1, o cartão mostra segue sozinha para a etapa 2, e a segunda instrução chega ao mesmo terminal. Na Grade, o terminal do Claude tem os dois pedidos e as duas respostas.
Nada é entregue enquanto o fluxo está planejado. Os cartões dizem "Nenhuma instrução será entregue até você executar o fluxo."
Dois agentes, um arquivo como ponte
O Claude revisa o cupom e grava os achados; o Codex lê os achados e corrige.
- Em Criar fluxo, escreva para a etapa 1:
Revise src/cupom.cjs e grave até três achados em REVISAO.md, com arquivo e linha. Não altere o código.Adicione ao planejamento. - Clique em + Nova etapa no topo. Com um fluxo planejado, ela abre em Acrescentar ao fluxo, depois da etapa 1.
- Em Executa, escolha Codex CLI. Em Onde esta etapa roda, Novo terminal. O início fica após a etapa 1 ficar pronta.
- Escreva
Leia REVISAO.md, corrija só o primeiro achado e rode npm test., escolha Só planejar e confirme. - Clique em Executar fluxo. O Claude começa; o Codex fica esperando a vez.
O Codex não enxerga a conversa do Claude: são programas diferentes, em terminais diferentes. O terminal novo recebe só a próxima instrução, por escrito. Por isso a etapa 1 grava um arquivo e a etapa 2 começa lendo esse arquivo.
O que aparece na tela
| No cartão | O que significa |
|---|---|
Claude Code · modelo: sem dado · analista | O agente, o modelo quando a CLI informa, e o papel da etapa. |
| Começa: | primeira etapa, sem esperar ninguém, quando a etapa 1 estiver pronta ou junto com outra. |
| Pronta: | A condição: Automática, Automática com verificação (com o comando, como npm test), Com sua aprovação ou Verificação e sua aprovação. |
avisou 23:50: pronta (pelo aviso dele, sem conferência) | A etapa ficou pronta pelo aviso do agente. Nenhum comando conferiu. |
segue sozinha para a etapa 2 | A passagem entre os cartões. Com aprovação, diz espera sua aprovação antes da etapa 2. |
terminal próprio | A etapa roda num terminal só dela. Na mesma conversa, diz mesmo terminal da etapa 1. |
A legenda acima dos cartões traz as cores dos estados: planejada, em andamento, precisa de você, concluída, devolvida e reprovada.
A barra do Fluxo
- O seletor no topo mostra o fluxo aberto. Um projeto pode ter vários fluxos, um para cada objetivo, como "Corrigir o cupom PRIMEIRA" e "Atualizar a documentação". O botão Criar fluxo ao lado começa outro.
- Executar fluxo entrega a primeira instrução. Com o fluxo rodando, Pausar novas entregas segura as próximas.
- + Adicionar etapa cria a próxima etapa já encadeada. Salvar como rotina guarda a sequência para outra tarefa; veja Rotinas.
- Os botões de papel (implementador, revisor, verificador, analista e os seus) criam uma etapa planejada já com esse papel. Configurar papéis… abre a tela de papéis. Veja Papéis.
- Regras deste projeto · N conta as regras que valem para os agentes do projeto. Veja Regras.
- Acompanhamento · histórico mostra só o que foi observado, com horário.
Continuar nesta sessão
No fim de um fluxo concluído, com o terminal ainda aberto, Continuar nesta sessão cria outra etapa na mesma conversa. O modelo, o esforço e as permissões continuam os da conversa aberta. A etapa anterior deixa de marcar o fim do fluxo. Se a sessão foi encerrada, essa conversa não pode mais continuar.
Papel e sequência
Em Outras ações, Papel e sequência muda o papel da etapa, a posição dela e se ela marca o fim do fluxo. O agente não reinicia. Uma etapa que já começou continua no terminal em que foi entregue; para devolver trabalho a outro agente, acrescente uma etapa com o destino certo.
Continuar em outro projeto
Para levar uma mudança da loja-api ao portal-web: em Outras ações do cartão de origem, Continuar em outro projeto… abre o diálogo Outro projeto: escolha o Projeto de destino e clique em Planejar no destino. A Nova etapa abre no projeto de destino, onde você escolhe o agente e escreve a tarefa. O cartão do destino mostra Aguardando origem · loja-api e, quando a origem fica pronta, Origem concluída · loja-api. Veja Entre projetos.
Quando o fluxo acaba
A última etapa pode marcar Esta etapa fecha o fluxo, nas opções da etapa. Em Quando fechar, escolha nada (fica registrado), me avisar (notificação, a borda do terminal pisca e uma linha no acompanhamento), rodar um comando (abrir o diff, subir um build) ou iniciar outro fluxo, que recebe o resultado deste. O cartão ganha o selo FIM DO FLUXO.
Dicas
- Escreva cada instrução para o trabalho daquela etapa. A etapa 2 recebe só o texto dela; o contexto vem da conversa, se for o mesmo terminal, ou de um arquivo.
- Grupos paralelos: escolha junto com a etapa N para duas etapas trabalharem ao mesmo tempo. A etapa seguinte espera todas as do grupo ficarem prontas. Duas etapas ao mesmo tempo não podem usar o mesmo terminal.
- Mudar de visão não força uma entrega. Se a próxima etapa não começou, o cartão e a aba Etapas dizem o motivo.
Limites conhecidos
- Até 16 etapas abertas no plano do projeto. Quando falta vaga, a tela avisa e pode oferecer arquivar concluídas antigas.
- Até 64 fluxos no serviço. Uma rotina com várias etapas pode ocupar mais de um.
- O histórico da conversa de um agente não passa para outro terminal. Só a instrução é entregue.
- O avanço automático acontece com a janela aberta. Com a janela fechada, os terminais continuam, mas a próxima etapa só começa quando você reabrir.
- Criar fluxo usa o agente padrão. Para uma etapa com outro agente, use + Nova etapa com o fluxo planejado.