Controlador de Desenvolvimento com IA
Um controlador determinístico que transforma issues do Linear em trabalho de agentes com dependências, mudanças validadas e pull requests em rascunho.
Papel:Design do sistema, motor de workflow, roteamento de provedores, política de segurança e operação
- TypeScript
- Linear
- GitHub
- Orca
- SQLite
- Vitest
- Windows
Problema
Desenvolvimento guiado por agentes fica difícil de confiar quando planejamento, tentativas, dependências, escolha de provedores e evidências existem apenas dentro de prompts.
Restrição
Modelos podem recomendar ações, mas não podem controlar transições protegidas, fazer merge, ignorar dependências ou repetir indefinidamente.
Decisão
Construí um controlador TypeScript determinístico em torno de Linear, Orca e GitHub, com ciclo de vida persistido, ondas de dependências, recuperação limitada, comandos verificados e validação independente.
Resultado
Issues avançam da curadoria ao pull request em rascunho por uma máquina de estados auditável, enquanto bloqueios reais aparecem com evidências e políticas mecânicas permanecem fora do modelo.
Issue do Linear → PR em rascunho
Caminho de entrega
Ondas por dependências integradas
Modelo de agendamento
Limitada e retomável
Política de recuperação
Visão geral
O Controlador de Desenvolvimento com IA é a camada determinística por baixo de um fluxo de engenharia com agentes. Linear continua como superfície de planejamento, Orca executa workers isolados e GitHub recebe pull requests em rascunho; o controlador decide quais transições são mecanicamente permitidas.
Decisões de produto
Modelos produzem recomendações, não autoridade. O controlador verifica pré-condições do ciclo de vida, dependências, revisão base, segurança dos comandos, evidências de validação e orçamento de tentativas antes de registrar uma transição. Uma dependência só é atendida após o merge do pull request.
Estado e auditoria ficam persistidos em SQLite para que reinícios não apaguem claims nem repitam trabalho silenciosamente. Disponibilidade e roteamento de provedores partem do mesmo snapshot de elegibilidade, enquanto a recuperação limitada diferencia correção rotineira de bloqueio humano real.
O que eu construí
- Curadoria de issues do Linear e máquina de estados persistida até a criação do pull request.
- Agendamento por dependências, preparação de worktrees, roteamento, pontuação e recuperação.
- Comandos verificados por segurança, contratos imutáveis de validação e revisão independente.
- Operação por CLI/TUI e supervisor de usuário no Windows para retomada após reinícios.
Estado atual
Este é um protótipo público funcional e um projeto de pesquisa operacional. Ele é descrito como controlador, não como engenheiro autônomo generalista ou plataforma hospedada concluída.