← todos os projetos

Fluxo de Agentes

Ferramenta de IA

Uma pasta que se coloca em qualquer projeto para rodar um time de IAs pelo terminal: o arquiteto planeja, você aprova, o executor implementa, checks sem IA validam e um revisor diferente dá o veredito.

O que é

O Fluxo de Agentes é uma ferramenta de linha de comando, em Node.js, para programar com vários assistentes de IA trabalhando em etapas. Ela vive numa pasta que se coloca dentro de qualquer projeto e roda pelo terminal.

Em vez de pedir tudo a um assistente só, o trabalho é dividido em papéis: um arquiteto que planeja, um executor que implementa e um revisor que dá o veredito, com uma etapa de aprovação humana no meio e verificações automáticas que não dependem de IA.

O problema

Quem usa assistentes de código no dia a dia esbarra em três limites. A cota acaba no meio da tarefa e o trabalho para. Usar o modelo mais caro para tudo gasta a cota em tarefas que um modelo mais simples resolveria. E quando a mesma IA escreve e revisa o próprio código, ela tende a repetir os mesmos pontos cegos.

O Fluxo de Agentes foi feito para atacar esses três pontos de uma vez, organizando quem faz o quê.

Como funciona

O fluxo tem cinco passos. Primeiro, o arquiteto lê o pedido e monta um plano. Depois, você lê o plano e aprova (ou não): nada é implementado sem esse aval. Com o plano aprovado, o executor faz as mudanças. Em seguida rodam checks sem IA, que conferem o resultado de forma determinística. Por último, um revisor dá o veredito sobre o que foi feito.

Cada etapa pode usar um assistente diferente: Claude, Codex, Copilot e outros. Se um deles bate o limite de uso, o fluxo passa automaticamente para o próximo da lista e o trabalho continua.

Decisões de projeto

Modelo forte planeja, modelo barato executa. O plano é a parte que mais exige raciocínio; com ele pronto e aprovado, a implementação pode ficar com um modelo mais barato, o que economiza cota.

O revisor é sempre uma IA diferente da que escreveu o código. É o mesmo princípio de uma revisão entre pessoas: quem não escreveu enxerga o que o autor deixou passar.

A aprovação humana fica antes da implementação, e não só no fim: é mais barato corrigir um plano do que desfazer código. E os checks sem IA existem porque o veredito de um modelo não substitui uma verificação que dá sempre o mesmo resultado.

A ferramenta funciona no Windows e no macOS. O código não é público.

Destaques

Stack

Node.js, CLI, Codex, Automação, IA

Projeto de Victor de Melo da Rosa.