Autonomia sem fronteira vira risco
Um agente útil precisa ler contexto, alterar artefatos, executar ferramentas e validar resultados. Quanto maior essa autonomia, maior deve ser a clareza sobre escopo, permissões e estado recuperável. O objetivo não é limitar inteligência; é limitar o raio de impacto de uma decisão errada.
O agente pode explorar caminhos diferentes. O sistema precisa tornar cada caminho observável e reversível.
Isole trabalho, não conhecimento
Cada tarefa deve ter ambiente de execução próprio, enquanto regras, decisões e documentação permanecem compartilhadas como fonte de verdade. Em desenvolvimento, branches ou worktrees permitem que humanos e agentes trabalhem em paralelo sem disputar os mesmos arquivos.
Checkpoint não é apenas commit
Um commit preserva arquivos, mas um checkpoint confiável preserva o estado necessário para decidir: alteração proposta, testes executados, resultados, limitações e identidade do ambiente. Ele deve responder “o que mudou?”, “por que acreditamos que funciona?” e “como voltamos?”.
- Fonte exata utilizada para produzir o artefato.
- Validações reproduzíveis e seus resultados.
- Dependências ou migrações associadas.
- Resumo de risco e caminho de reversão.
Separe propor, validar e promover
O mesmo agente pode executar várias etapas, mas o fluxo deve distingui-las. Primeiro ele propõe uma mudança em ambiente isolado. Depois valida com testes e critérios definidos. Por fim, uma decisão explícita promove o resultado para o ambiente compartilhado.
- Receber tarefa com objetivo e limites verificáveis.
- Executar no workspace isolado.
- Gerar evidência: diff, testes, análise e artefato.
- Solicitar revisão apenas quando o risco ou a política exigir.
- Promover o checkpoint aprovado e registrar o desfecho.
O orquestrador administra estado
O papel central do orquestrador não é escrever todas as respostas. É controlar dependências entre tarefas, distribuir contexto suficiente, aplicar políticas, acompanhar checkpoints e impedir que resultados concorrentes sejam confundidos.
Agentes especializados podem cuidar de implementação, revisão, documentação e testes. O sistema torna-se confiável quando a qualidade não depende de “lembrar de conferir”, mas de gates explícitos e evidência anexada ao próprio fluxo.
Comece com o menor ciclo útil
Antes de construir uma plataforma complexa, valide um ciclo simples: uma tarefa, um workspace isolado, um conjunto de testes, um checkpoint e uma promoção controlada. Meça tempo poupado, retrabalho, falhas detectadas e intervenções humanas.
A evolução natural inclui filas, agentes paralelos, políticas por tipo de ação e memória de longo prazo. Mas a base permanece a mesma: autonomia delimitada, estado rastreável e mudanças que podem ser verificadas antes de afetar o sistema real.