Optio: Orquestrando Agentes de Codificação de IA no Kubernetes do Chamado ao PR

Optio é um sistema de orquestração de código aberto para agentes de codificação com IA que gerencia o fluxo de trabalho completo desde a entrada de tarefas até o pull request mesclado, sem exigir supervisão humana constante. Construído com Fastify, Next.js, BullMQ e Drizzle no Postgres, ele é distribuído com um chart Helm para implantação em produção.

Como Funciona

O sistema segue um pipeline de três estágios:

• Entrada – Coleta tarefas de GitHub Issues, Linear ou criação manual
• Execução – Inicia pods Kubernetes isolados por repositório, executa Claude Code ou Codex em worktrees git
• Monitoramento de PR – Monitora verificações de CI, status de revisão e prontidão para mesclagem a cada 30 segundos

O diferencial principal é o loop de feedback. Quando o CI falha, o Optio alimenta a falha de volta para o agente. Quando um revisor solicita alterações, os comentários se tornam o próximo prompt do agente. Ele continua até que o PR seja mesclado ou você o pare manualmente.

Arquitetura e Recursos

O Optio usa uma arquitetura de pod por repositório com um pod Kubernetes de longa duração por repositório. Cada pod mantém isolamento de worktree git para múltiplas tarefas concorrentes. O sistema inclui:

• Auto-recuperação – Reinicia automaticamente o agente em falhas de CI, conflitos de mesclagem ou solicitações de alteração do revisor
• Automação de conclusão – Realiza squash-merge do PR e fecha a issue vinculada quando todas as verificações passam
• Configuração por repositório – Seleção de modelo, templates de prompt, imagens de container, limites de concorrência e comandos de configuração ajustáveis por repositório
• Agente de revisão de código – Lança automaticamente um agente de revisão como subtarefa com prompt e modelo separados
• Painel em tempo real – Streaming de logs ao vivo, progresso do pipeline, análise de custos e monitoramento de saúde do cluster

Implementação Técnica

A arquitetura consiste em três componentes principais:

• Interface Web (Next.js na porta 3100) com painel, gerenciamento de tarefas e streaming ao vivo
• Servidor API (Fastify) com workers para fila de tarefas, monitor de PR, monitoramento de saúde e sincronização de tickets
• Cluster Kubernetes com pods de repositório contendo múltiplos worktrees executando agentes de IA

Os serviços incluem gerenciamento de pool de repositórios, execução de agentes de revisão e tratamento de autenticação/segredos, todos suportados por Postgres para tarefas, logs e eventos.