Princípios

Projetos, terminais e Foco vêm primeiro

O centro do PrumoGrid cabe numa frase: vários projetos, vários terminais em cada um, e o Foco para ler um terminal com calma. Todo o resto (etapas, fluxos, rotinas, regras, papéis) é acréscimo. Você pode passar semanas usando só projetos, terminais, Grade e Foco, e o aplicativo continua útil.

Na prática:

• Cada projeto é uma pasta. Os terminais abrem dentro dela e aparecem no cartão do projeto. Veja Projetos.
• Selecionar um projeto troca a Grade e a lateral juntas. Você olha um trabalho de cada vez, e a Atenção avisa quando outro projeto precisa de você.
• A Grade serve para acompanhar vários terminais; o Foco, para ler ou conversar com um deles. Veja Grade e Foco.

Quando surgir repetição (o mesmo pedido em vários terminais, a mesma sequência de implementar e revisar, a mesma orientação para todos os agentes), é a hora de adotar o recurso que resolve aquela repetição. Não antes.

O daemon guarda as sessões

Os terminais não rodam dentro da janela. Eles rodam num serviço em segundo plano, o daemon, e a janela só se conecta a ele. O rodapé mostra daemon conectado quando está tudo certo.

Por isso o diálogo Fechar esta janela? aparece quando há trabalho que depende da janela aberta: ele avisa que o fluxo não vai avançar até você voltar. Veja Retomar após reinício.

Os agentes são CLIs suas

O PrumoGrid não tem modelo de IA nem conta própria. Quando uma etapa diz Executa: Claude Code, o que roda é o Claude Code instalado no seu computador, com a sua conta, o seu plano, as suas permissões e o seu custo. O mesmo vale para o Codex, o Gemini ou qualquer outra CLI cadastrada em Ferramentas → Perfis de agente….

Consequências:

• Instalar, autenticar e escolher o modelo padrão de cada CLI é com você. O campo de modelo de uma etapa vazio quer dizer "o padrão da CLI".
• Cada CLI tem seu próprio jeito de pedir permissão. O PrumoGrid mostra o pedido, mas quem decide é você, no diálogo ou no terminal.
• Agentes diferentes não compartilham conversa. Quando o Codex precisa do que o Claude Code descobriu, a ponte é um arquivo, como ANALISE.md. Veja a receita Dois agentes, um arquivo de passagem.
• O aviso de que o agente terminou o turno vem da própria CLI. O PrumoGrid põe esse aviso no comando com que abre o agente, sem mexer na configuração da sua conta.

O PrumoGrid acompanha o trabalho

O terminal continua sendo seu. Você pode digitar em qualquer painel, abrir o agente à mão com claude ou codex, rodar seus scripts e usar seu próprio harness. A Nova etapa, o Fluxo e as Rotinas são opcionais: servem para quando você quer que o PrumoGrid entregue a tarefa, espere a condição combinada e avise.

O que o PrumoGrid faz é observar e registrar: qual instrução foi entregue a qual terminal, quando o agente avisou o fim do turno, o que a verificação respondeu, quem aprovou. O que ele não faz é decidir por você. Pedidos de permissão e aprovações de revisão continuam sendo respondidos por uma pessoa, e um pedido de permissão mostrado no diálogo é lido da tela do terminal: se mudar, feche e abra de novo antes de responder.

A verificação precisa poder reprovar

"O agente disse que terminou" e "o teste passou" são fatos diferentes, e o PrumoGrid mostra os dois separados. Uma etapa sem verificação fica pronta quando o agente avisa o fim do turno. Uma etapa com verificação só fica pronta quando o comando escolhido termina como esperado.

Uma verificação útil é aquela que falha enquanto o trabalho não está feito. echo ok sempre passa e não prova nada. Para o bug do cupom da loja-api (desconto em dobro com dois itens), a verificação certa é npm test com um teste que reproduz o caso: ele reprova antes da correção e passa depois.

Mesmo assim, o código de saída só prova o que o comando testou. A qualidade da solução, a clareza do código e o que ficou fora dos testes continuam pedindo leitura humana. Veja Verificação.

Nada sai da máquina pelo PrumoGrid

O PrumoGrid não pede conta, não tem servidor de dados e não envia o conteúdo dos seus terminais a lugar nenhum. Projetos, layout, rotinas, histórico e regras gerais ficam em %APPDATA%\TerminalGrid, no seu computador.

O que pode usar a rede:

• As CLIs de agente que você executa, conforme a conta e a configuração de cada uma. É por elas que o código chega ao provedor do modelo.
• Os comandos que você roda nos terminais, como npm install ou git push.
• A busca de atualizações, que consulta o manifesto publicado (Verificar agora, ou ao abrir e a cada 6 horas, se a opção estiver ligada).
• Os plugins que você instala, que executam código com os direitos da sua conta.

Quando o PrumoGrid precisa escrever no seu repositório (o bloco de orientações no CLAUDE.md ou no AGENTS.md), ele pergunta antes, pasta por pasta, e mostra o que vai gravar. Veja Regras.