Nova etapa

Para que serve

Uma etapa é uma tarefa entregue a um terminal, com três partes: a instrução (o que você pediria ao agente), quem executa (a CLI, o projeto e o lado, Windows ou WSL) e quando ela fica pronta. O botão laranja + Nova etapa, no alto da janela, monta essa tarefa num diálogo só. Com ela, o PrumoGrid abre o terminal, inicia o agente com a instrução, acompanha o turno e mostra a etapa na aba Etapas como em execução, concluída ou com falha. Se você pedir, ele ainda confere o trabalho com um comando antes de dar a etapa por pronta.

Quando usar e quando não usar

Use a Nova etapa quando quiser que o PrumoGrid acompanhe a tarefa e avise quando ela terminar, quando quiser conferir o resultado com npm test ou quando a tarefa for o começo de uma sequência no Fluxo.

Chamar o agente direto no terminal continua valendo. Para uma pergunta rápida, como "em que linguagem este projeto é escrito?", abra o Claude Code ou o Codex pela linha NOVO e digite. A Nova etapa é opcional e não muda nada nos terminais que você usa à mão.

Ela também não é o lugar para colar um documento inteiro: a instrução tem até 512 caracteres. Para contexto maior, grave um arquivo no projeto e aponte para ele na instrução.

Passo a passo

Primeira etapa na loja-api

1. Selecione o cartão loja-api e clique em + Nova etapa.
2. Em O que precisa ser feito?, escreva: Conte os arquivos das pastas src e tests, incluindo subpastas. Responda só com o número, sem listar nomes.
3. Em Executa, confira Claude Code. A nota embaixo lembra que quem avisa que a etapa terminou é esse agente, pelo fim de turno da própria CLI.
4. Em Onde esta etapa roda, deixe Novo terminal. A linha de resumo mostra o agente, o projeto e o lado: Claude Code · loja-api · Windows nativo.
5. Em Ao criar, deixe Agora.
6. Clique em Criar etapa.
7. Um painel novo, Claude Code, abre na Grade e já recebe a instrução. Quando o agente responde 7 e termina o turno, a aba Etapas mostra a etapa como concluída, com Ver resultado.

Se for a primeira etapa do projeto, o PrumoGrid pergunta antes se pode gravar orientações no CLAUDE.md ou no AGENTS.md da pasta. Veja Gravação nos projetos.

Exigir que os testes passem

1. Em + Nova etapa, escreva Corrija o cupom PRIMEIRA, que dá desconto em dobro com dois itens no carrinho. Escreva um teste que reproduz o caso antes de corrigir e rode npm test.
2. Abra Mais opções.
3. Em Como esta etapa termina e a próxima começa?, escolha Automática com verificação · o comando passa e a próxima começa sozinha.
4. Em Conferir com um comando, confira npm test, indicado como do projeto, e aprova quando terminar com sucesso (0).
5. Clique em Criar etapa.

Agora a etapa só fica pronta se npm test passar depois do turno do agente. O aviso de fim de turno, sozinho, não aprova a etapa. Veja Verificação.

O que aparece na tela

Ampliar captura ↗

Ampliar captura ↗

Dentro de Mais opções:

• Papel (regras): Sem papel adicional, implementador, revisor, verificador, analista ou um papel seu. A linha O agente vai ler mostra o que entra no arquivo de orientações. Veja Papéis.
• Como esta etapa termina e a próxima começa?: Automática (o agente avisa), Automática com verificação (o comando passa), Com sua aprovação (o agente avisa e você aprova) ou Verificação e sua aprovação.
• Conferir com um comando: o comando, o código de saída esperado e o tempo máximo em segundos.
• Opções de etapa: a pasta (Na pasta do projeto, Em um worktree novo ou Em outra pasta…), o lado (Windows ou WSL), Modelo e permissões (opcional) e o que acontece se esta etapa fechar o fluxo. Deixe o modelo em branco para manter a configuração da CLI.

Continuar neste terminal

Quando o projeto já tem uma etapa, Onde esta etapa roda ganha Continuar neste terminal. A nova instrução vai para a mesma conversa, e o agente lembra do que já leu. Com essa opção, Executa mostra o agente daquele terminal e fica travado, porque o agente de uma conversa aberta não muda. Modelo, esforço e permissões também continuam os da sessão.

Com um fluxo planejado, a Nova etapa abre em Acrescentar ao fluxo, depois da etapa N e pergunta quando a etapa começa: imediatamente, após a etapa anterior ficar pronta ou junto com ela.

Outro projeto

Outro projeto liga esta etapa a um fluxo de outro projeto aberto, como uma mudança da loja-api que precisa chegar ao portal-web. Com um projeto só, a opção fica desabilitada; passe o mouse para ler o motivo, Só há um projeto aberto. Com mais projetos, ela pede uma etapa de origem antes. A passagem completa está em Fluxo.

Começar por um chamado

Na lateral direita, Começar por um chamado… traz uma issue do GitHub ou do Jira como etapa. O mesmo está em Ferramentas → Chamados….

1. Cadastre uma fonte: Nome da fonte, De onde os chamados vêm e Comando da fonte. O comando roda na pasta do projeto selecionado e precisa escrever JSON na saída padrão.
2. Clique em Consultar e escolha um chamado da lista.
3. Clique em Criar etapa a partir deste chamado, revise o rascunho, o projeto e o agente, e confirme.

Para ensaiar sem serviço nenhum, crie chamados-demo.json na loja-api e use a fonte Comando com type chamados-demo.json:

[
  {
    "id": "LOJA-42",
    "title": "Cupom PRIMEIRA dá desconto em dobro com dois itens",
    "body": "Com dois ou mais itens no carrinho, o desconto do cupom PRIMEIRA sai em dobro. Esperado: 10% sobre o subtotal.",
    "status": "aberto"
  },
  {
    "id": "LOJA-43",
    "title": "Banner do portal diz 'acima de R$ 200' em vez de 'a partir de'",
    "body": "O texto do banner não segue a regra do frete da loja-api.",
    "status": "aberto"
  }
]

Ampliar captura ↗

Nenhuma credencial fica guardada no PrumoGrid: as fontes GitHub e Jira usam o gh ou o CLI de Jira já autenticados na sua máquina. Importar um chamado não muda o status dele no serviço de origem.

Dicas

• Escreva instruções que digam onde olhar e como responder: arquivo, pasta, formato da resposta. "Leia src/frete.cjs e explique em até três linhas a regra do frete grátis" funciona melhor que "explique o frete".
• O botão Criar etapa fica sempre ativo. Se faltar a instrução, o aviso aparece ao clicar.
• Ao trocar o agente em Executa, o PrumoGrid pode perguntar Usar Claude Code como padrão nas próximas etapas?. O padrão também muda em Ferramentas → Agentes.
• Para tarefas em sequência, crie a primeira etapa aqui e as seguintes no Fluxo.

Limites conhecidos

• A instrução tem até 512 caracteres e vai numa linha só: as quebras de linha viram espaço, porque a instrução entra como argumento do comando que inicia o agente.
• O agente avisar que terminou o turno não comprova que a tarefa está certa. Para isso, use Conferir com um comando.
• Um worktree novo nasce sem dependências instaladas. O resumo do plano mostra o preparo necessário.
• Uma pasta que só existe dentro do WSL não recebe as regras pelo Windows.
• Chamados: até 100 por consulta, e o corpo de cada um até 4.000 caracteres. A saída precisa ser JSON; um CLI que devolve tabela precisa de outro comando.