O que vnx-orchestration faz?
Orquestração com governança em primeiro lugar para Claude Code, Codex e Gemini CLI — workers paralelos, recibos, portões de qualidade e proveniência completa.
Visão Geral
Esta skill permite coordenar múltiplos agentes de IA (como Claude Code, Codex e Gemini CLI) de forma paralela e segura, aplicando controles de governança em cada etapa. Você pode definir workers que executam tarefas específicas, monitorar seu progresso, aplicar portões de qualidade antes de avançar e gerar recibos detalhados de cada execução.
Como Usar
Para começar, configure um arquivo de orquestração com a definição dos workers:
workers:
- id: "worker-001"
agent: "claude-code"
task: "Revisar código do módulo de autenticação"
quality_gates:
- type: "test_coverage"
min: 80
- type: "security_scan"
enabled: true
Em seguida, execute a orquestração:
vnx orchestrate --config orchestration.yaml
Funcionalidades Principais
- Workers Paralelos: Execute múltiplos workers simultaneamente, cada um em seu próprio agente de IA.
- Portões de Qualidade: Defina critérios que cada worker deve atender antes de ser considerado concluído.
- Recibos de Execução: Cada worker gera um recibo imutável com detalhes de tempo, custo, agentes envolvidos e resultados.
- Proveniência Total: Rastreie cada decisão e ação desde a definição da tarefa até a entrega final.
- Suporte Multi-Agente: Compatível com Claude Code, Codex e Gemini CLI.
Configuração
A skill lê as variáveis de ambiente necessárias para autenticação e logs:
VNX_API_KEY: Chave de API para comunicação com a skill.VNX_LOG_LEVEL: Nível de log (DEBUG, INFO, WARN, ERROR).CLAUDE_CODE_HOME: Caminho para a instalação do Claude Code (opcional).CODEX_HOME: Caminho para a instalação do Codex (opcional).GEMINI_CLI_HOME: Caminho para a instalação do Gemini CLI (opcional).
Exemplo de Uso com Múltiplos Agentes
# Executar tarefa de revisão em paralelo com dois agentes
vnx orchestrate \
--workers worker-001,worker-002 \
--quality-gates "test_coverage>=75,security_scan" \
--output receipts/
Governança e Compliance
A skill mantém um registro completo de todas as ações, incluindo:
- Identidade do worker e agente utilizado
- Timestamps de início e fim
- Resultado de cada portão de qualidade
- Recibos em formato JSON assinados
- Logs de auditoria para conformidade com políticas internas
Referências
Contribuição
Contribuições são bem-vindas! Consulte o repositório principal para instruções de desenvolvimento e pull requests.