wastech-orchestrator
Transforma uma tarefa escrita em um pull request para a sua revisão.
Os agentes fazem as alterações, e o orquestrador conduz o fluxo e todo o trabalho com o Git ao redor deles, da branch ao pull request. Cada etapa é salva em um banco de dados SQLite local, então cada execução deixa um registro que você pode acompanhar depois.
Por que está aqui
Uso este orquestrador no meu próprio trabalho para desenvolver funcionalidades, escrever textos e explorar ideias. Ele é um exemplo do que eu poderia configurar para você e a sua equipe, e o código e a documentação são públicos, então você pode ler como ele funciona antes de decidir qualquer coisa.
Problema
Antes que um revisor consiga acompanhar a alteração de um agente, ela precisa de várias etapas ao redor. Quando ninguém cuida dessas etapas, o pull request de um agente fica difícil de revisar e o resultado, difícil de repetir. Esse é um dos motivos pelos quais o trabalho com agentes trava, ao lado da qualidade do contexto que o agente lê.
Solução
O orquestrador assume o processo e o trabalho com o Git, e os agentes não são instruídos a fazer commit nem push. Um fluxo descreve as etapas, e as tarefas são escritas de acordo com ele. O pull request é aberto depois que as verificações que você configurou e a revisão de um agente passam, com um resumo escrito do que mudou.
- Uma tarefa vai para um agente e volta como pull request depois que passam as verificações que você configurou para o seu repositório.
- As etapas ficam escritas como um fluxo, então cada execução segue os estágios que você definiu para ele.
- Um commit de auditoria opcional coloca o arquivo da tarefa e o resumo dela ao lado do código.
Principais funcionalidades
- Da tarefa ao pull requestUma tarefa em Markdown vira uma branch, uma alteração, as verificações do seu repositório e um pull request com um resumo escrito.
- Dois agentes, uma interfaceOpenAI Codex e Anthropic Claude Code são intercambiáveis e, com os dois configurados, uma execução passa para o outro diante de uma falha de infraestrutura.
- O Git fica com o orquestradorOs agentes não são instruídos a fazer commit nem push. Com o isolamento estrito ativado e um host capaz de rodá-los em sandbox, eles não conseguem escrever em .git, e o preflight avisa quando essa proteção está faltando.
- Execuções retomáveisCada etapa é salva em um ponto de controle, então um reinício retoma a tarefa em andamento sem fazer o commit duas vezes nem reabrir um pull request.
Pipeline
- TarefaUm arquivo Markdown no seu repositórioVocê
- BranchCriada a partir da sua branch baseOrquestrador
- Etapas do fluxoPlanejamento e alterações, uma etapa de cada vezAgentes de IA
- VerificaçõesSeus próprios comandos de teste e lint, depois de cada alteraçãoOrquestrador
- RevisãoLeem a mudança e devolvem os apontamentos para correçãoAgentes de IA
- CommitUm commit restrito à tarefa e depois o pushOrquestrador
- Pull requestAberto com um resumo para a sua revisãoOrquestrador
Para quem é
- Pessoas e equipes que querem trabalhar com agentes de IA.
- Tech leads que querem que cada alteração de um agente passe por revisão e deixe um registro.
Stack
- Núcleo
- Python 3.12+
- Agentes
- OpenAI Codex CLI
- Anthropic Claude Code CLI
- Estado
- SQLite (estado com pontos de controle, tabelas de auditoria)
- Git
- git
- GitHub CLI (gh)
Instalação
pipx install "git+https://github.com/VladimirMakarevich/wastech-orchestrator.git"cd path/to/your-repoworc install .worc preflightLimitações
- Executa uma tarefa por vez, do início ao fim.
- Abre pull requests apenas no GitHub, pela CLI gh.
- A etapa de verificações só bloqueia uma tarefa depois que você lista seus comandos de teste e lint na configuração; uma instalação nova não lista nenhum.
- Uma instalação nova deixa o isolamento estrito desativado, e um host sem sandbox do sistema operacional, como o Windows nativo, não consegue bloquear a escrita em .git.