Ordewell transforma meta de código em plano editável com tarefas verificadas

O que é o Ordewell

O Ordewell é uma ferramenta open-source (licença Apache 2.0) de orquestração multiagente para coding agents que transforma uma única meta em um plano ordenado de tarefas, cada uma com seu próprio runner, modelo e modo. O usuário controla o plano antes de qualquer execução: o plano é um arquivo editável, e é possível trocar runners, modelos e esforço de raciocínio, adicionar ou remover tarefas e reconfigurar dependências - o trabalho já concluído sobrevive às edições, e nada roda até o usuário autorizar.

Planejamento e verificação

O planejador é somente leitura: pesquisa o repositório, faz perguntas quando a meta está vaga e produz o plano como mensagem final. Leituras rodam em paralelo, acessos fora do workspace pedem permissão uma vez, e comandos que escreveriam arquivos são recusados. A conclusão de uma tarefa só é aceita quando um marcador de conclusão aparece na saída do runner - o código de saída fica como evidência diagnóstica, nenhum modelo avalia o próprio trabalho, e uma tarefa que termina sem o marcador falha de forma visível em vez de passar silenciosamente.

O modelo de planejamento padrão é o DeepSeek V4 Flash, um modelo de baixo custo que pesquisa e planeja mas nunca escreve código. Alternativamente, o próprio Claude Code, Codex ou OpenCode podem servir de planejador (em modo estritamente somente leitura) usando a assinatura que o usuário já possui, sem exigir chave de API extra. Também há 25 provedores reconhecidos por chave própria - entre eles OpenRouter, Anthropic, OpenAI, Gemini, xAI, Groq, DeepSeek, Mistral e outros - além de qualquer endpoint compatível com OpenAI, inclusive servidores de modelos locais.

Execução multi-runner

O sistema suporta vários runners simultâneos: o planejador atribui um por tarefa. Claude Code, Codex e OpenCode vêm embutidos; qualquer outro agente (como Aider ou um CLI próprio) pode ser integrado via manifesto de plugin, sem mudança de código. Tarefas independentes rodam em paralelo, com padrão de 3 sessões concorrentes (configurável de 1 a 5), respeitando o grafo de dependências. Há também modos opcionais de planejamento aprofundado: "grilling" (mínimo de 3 perguntas investigativas antes de traçar o plano), geração de PRD em arquivo e aumento de tarefas com instruções red-green-refactor para TDD - esses fluxos são adaptados das skills MIT de Matt Pocock.

Superfícies e plataformas

Há três interfaces sobre um núcleo comum: extensão para VS Code (com linha do tempo de pesquisa ao vivo e cartões de tarefa), TUI de terminal (que exige tmux em todas as plataformas, incluindo Windows via WSL) e CLI headless - todo comando de barra também é um subcomando, permitindo automação sem interface. Um servidor local em Hono expõe API HTTP e WebSocket na porta 3742, usado pelo CLI e pela TUI.

No Windows, a documentação recomenda instalar os CLIs de agentes com instaladores nativos (um shim .cmd via npm herda o limite de 8191 caracteres do cmd.exe, o que quebra o prompt de sistema maior do planejador) e manter o Git for Windows, cujo shell POSIX é usado para rodar comandos de pesquisa.

Arquitetura

O projeto é organizado em pacotes TypeScript: um núcleo puro sem dependências de UI (Session, PlanStore, VerdictEngine, RunnerRegistry), o CLI, a extensão VS Code e o servidor web. O repositório registrava 112 estrelas e 6 forks no momento da captura.