Orquestrador Maestro

Faça qualquer IA trabalhar com o mesmo processo: entender o pedido, ler o contexto necessário, executar com limites, verificar o resultado e deixar um rastro útil para a próxima sessão.

O Orquestrador Maestro é para quem usa Codex, Claude, OpenCode, Cursor, Gemini e outras ferramentas de IA em projetos reais. Ele não é um modelo nem substitui sua ferramenta favorita: prepara o ambiente para que ela trabalhe com menos desperdício, mais previsibilidade e evidência antes de dizer que terminou.

Escolha seu próximo passo

| Você quer… | Vá direto para… | | --- | --- | | Entender a ideia em 1 minuto | Como funciona | | Instalar agora | Comece em dois minutos | | Ver o benchmark | Veja os números | | Descobrir qual skill usar | Escolha por objetivo | | Configurar memória e contexto | Guias técnicos | | Conhecer CLI, workflows e adaptadores | Referência completa |

Por que usar

Quando uma IA recebe só um prompt, ela pode abrir contexto demais, improvisar o processo e declarar uma tarefa pronta sem prova suficiente. O Maestro organiza o caminho antes da execução.

| Sem orquestração | Com Orquestrador Maestro | | --- | --- | | A IA decide sozinha o que ler | Ela começa pelas regras, pelo estado e pela skill certa | | Contexto cresce sem critério | Lê o mínimo suficiente e aprofunda sob demanda | | “Pronto” pode ser apenas uma afirmação | Verificação e handoff fazem parte do trabalho | | Cada ferramenta cria seu próprio ritual | O processo se mantém entre ferramentas e sessões |

O que muda na prática

• Menos contexto desnecessário. Índices compactos e documentação de projeto evitam carregar catálogos e históricos inteiros.
• Menos surpresa na entrega. Regras, escopo e verificação entram antes da mudança, não no fim.
• Menos recomeço entre sessões. O estado útil fica no projeto, legível por pessoas e por outras ferramentas.

Comece em dois minutos

Requer Node.js 20 ou superior.

npm install -g @iapro/orquestrador-maestro-cli@latest
orquestrador-maestro install
orquestrador-maestro verify

Prefere instalar pelo repositório? Use o guia de instalação, que inclui Windows, Linux, macOS, bootstrap, dry-run e rollback.

Próximo passo: verifique a instalação e configure o primeiro projeto.

Depois, abra sua ferramenta de IA no projeto e peça:

Use o Orquestrador Maestro. Leia as instruções do usuário e do projeto,
abra somente o contexto necessário, resolva esta tarefa, verifique o resultado
e registre o estado útil para a próxima sessão.

Um processo, várias ferramentas

O Maestro começa com instruções globais e locais, encontra a skill adequada e usa DEV/ para manter objetivo, decisões, verificação e próximo passo no próprio projeto. Assim, você não depende de a conversa anterior ainda estar disponível — nem de trocar de ferramenta sem perder o método.

Ele integra fluxos para Codex, Claude Code, OpenCode, Cursor, Gemini CLI, Grok CLI, MiMo Code, Kimi Code, Windsurf e Antigravity. Cada ferramenta continua responsável pelo próprio runtime, login, modelo e credenciais.

Para o funcionamento técnico, consulte como o Orquestrador funciona, economia de contexto, memória de projeto com DEV/ e perfis de ferramentas.

Próximo passo: aprenda o fluxo que a IA deve seguir ou configure um workflow declarativo.

Skills: especialização sob demanda

Skills são capacidades especializadas que o Maestro roteia conforme objetivo, risco e ambiente. Nem toda skill precisa estar instalada em todas as ferramentas: algumas são nativas, outras ficam sob demanda na biblioteca e algumas são condicionais, pois exigem um serviço, navegador ou autorização.

Escolha o caminho mais útil:

• Escolher por objetivo
• Consultar receitas e combinações
• Abrir o catálogo completo

Benchmark: veja os números na sua máquina

O benchmark compara condições com o mesmo cenário, modelo e critérios de aceitação. Ele mede tokens apenas em tarefas aceitas e preserva evidência para auditoria.

Exemplo ilustrativo. Os valores no gráfico não são uma promessa nem um resultado oficial. O efeito real varia por modelo, tarefa e ambiente. Rode o benchmark para produzir e inspecionar sua própria evidência.

O evidence gate impede que resultados sem verificação apropriada virem claim público. Em vez de pedir confiança, o projeto mostra como conferir modelo, cenário, execução e evidência.

Para preparar o ambiente e executar uma comparação, siga o quick start do benchmark. A metodologia explica limites, métricas e o que os resultados não permitem concluir.

Próximo passo: inspecione a evidência gerada antes de transformar qualquer número em claim.

Guias técnicos

| Se você quer… | Comece aqui | | --- | --- | | Instalar ou atualizar | Guia de instalação · opções | | Entender o método | Guia operacional para IAs · referência técnica | | Reduzir custo de contexto | Economia de contexto | | Exigir qualidade verificável | Engenharia guiada | | Avaliar privacidade | Modelo de privacidade | | Retomar tarefas longas | Workflows · contratos | | Organizar memória | Hierarquia DEV/ · escopos | | Trabalhar com skills | Portal · escolher · catálogo | | Consultar CLI, arquitetura e comandos avançados | Referência técnica completa | | Resolver problemas | Troubleshooting | | Ver tudo | Índice de documentação |

Privacidade por padrão

Este é um snapshot público e sanitizado: compartilha estrutura e comportamento, não conteúdo privado da máquina que o originou. Credenciais, sessões, logs, caches, caminhos locais e memórias privadas ficam fora do repositório.

Leia o modelo de privacidade para saber exatamente o que entra, o que fica local e como a telemetria anônima funciona.

O CLI mede instalações anônimas ativas por padrão, nunca pessoas únicas. Envia somente comando, resultado, versão e ambiente técnico ao PostHog Cloud (US); não envia caminhos, argumentos, prompts, arquivos, nomes, IP armazenado pelo produto ou credenciais. Desative com orquestrador-maestro telemetry disable ou ORQUESTRADOR_MAESTRO_TELEMETRY=0.

Próximo passo: confira o modelo completo de privacidade antes de sincronizar uma instalação pública.

Próximo passo

Instale em dois minutos para usar o mesmo processo nas suas ferramentas de IA. Depois, rode o benchmark para ver os dados no seu ambiente. Encontrou algo que pode melhorar? Contribua.

Licença

Consulte LICENSE. Este projeto organiza o processo de trabalho; decisões, credenciais e efeitos externos continuam sob controle humano.