Do vibe coding à engenharia agêntica: como trabalhar com agentes em 2026

Documentação do Ailoot: API, chaves e configuração.

O que é a engenharia agêntica, em linguagem simples?#

Vamos analisar isto. Um agente de IA não é um chat onde se coloca uma pergunta. É um executor que lê o projeto, planeia, escreve código em vários ficheiros, executa testes, deteta um erro e reescreve o código — tudo por si. O seu trabalho subiu de nível: diz qual deve ser o resultado e o que conta como concluído, e depois analisa o que o agente lhe apresenta.

A programação por intuição eleva o patamar mínimo — agora até alguém sem experiência consegue montar um protótipo. A engenharia agêntica eleva o patamar máximo — uma pessoa experiente, com o sistema certo, consegue levar os agentes a produzir algo que não teria conseguido construir à mão num mês. Trabalho assim todos os dias e, para mim, isto não é uma «nova era» — é apenas o nível seguinte do que já fazia. Há muito que lhe chamo programação por intuição para adultos.

É mais um ciclo de entusiasmo ou já se tornou corrente?#

É normal haver ceticismo. O público com quem trabalho já foi enganado: «Será isto apenas mais um esquema de marketing na Internet?» Por isso, daqui em diante, vamos cingir-nos aos factos.

Na OpenAI, 20% dos cinco milhões de utilizadores semanais do Codex nem sequer são programadores: são analistas, profissionais de marketing e pessoal de operações. Pessoas sem formação técnica já estão a construir coisas úteis. É exatamente para esse público que faço tudo isto.

Em que difere a engenharia agêntica da programação por intuição?#

Sejamos francos desde o início: «a programação por intuição morreu» é um título chamativo, feito para conseguir visualizações. A programação por intuição não desapareceu; evoluiu. Há um ano, «seguir a intuição» significava atirar instruções à IA e copiar código sem o ler. Agora, acrescentou-se disciplina: um objetivo, um plano, uma revisão. Eis a comparação entre as duas abordagens.

A principal mudança está na última linha. Enquanto mantiver todo o contexto na cabeça e num único chat, atingirá um limite: a IA esquece-se, fica confusa e alucina. Quando o contexto é mantido no projeto, o agente trabalha de forma consistente e pode executar vários agentes em paralelo.

Quer ir além de compreender a diferença e montar uma configuração que torne o Claude fiável? A engenharia agêntica assenta nos meus três pilares: um clone de IA (a sua experiência nas competências do agente), um Segundo Cérebro (uma pasta business/ onde o agente conhece todo o projeto) e engenharia de contexto (gerir o que entra no contexto do agente). Esta configuração transforma o Claude de «assistente que alucina» em executor fiável.

Porque é que as instruções já não são o mais importante?#

Repito isto há meses: o contexto é mais importante do que a instrução. Quando as pessoas se queixam de que «a IA só diz disparates», quase nunca é por terem feito mal o pedido. É porque o agente estava a trabalhar no vazio — não sabia quem é, o que é o produto, em que fase está ou que decisões já foram tomadas.

Uma instrução é uma mensagem. O contexto é tudo o que o agente sabe antes de receber essa mensagem: a descrição do projeto, as regras em CLAUDE.md, as decisões anteriores, o seu estilo. Substitua a instrução perfeita por uma mediana, mas dê ao agente o contexto completo, e o resultado será melhor. Assim, a competência passou de «como pedir com elegância» para «o que colocar na cabeça do agente antes do pedido». Chama-se engenharia de contexto, e abordo-a à parte no guia Engenharia de Contexto: O Que É e Como Aplicá-la.

Na engenharia agêntica, isto é duas vezes mais crítico. Quando gere vários agentes ao mesmo tempo, não terá fisicamente tempo para explicar tudo a cada um através de instruções. O contexto tem de estar no projeto para que qualquer agente que inicie o possa assimilar de imediato.

Porque é que a programação por intuição às cegas falha?#

É aqui que as manchetes sensacionalistas que equiparam «programação por intuição = catástrofe» têm algum fundamento. Quando alguém «se deixa levar pela intuição» por completo e deixa de verificar o que o agente escreveu, começam a acumular-se dívida técnica, falhas de segurança e lógica que mais tarde ninguém compreende.

As falhas reais de 2026 mostram o que não se deve fazer às cegas:

• Lovable. Uma plataforma de programação por intuição com 8 milhões de utilizadores. Qualquer pessoa que abrisse uma conta gratuita podia ler o código-fonte de outras pessoas, palavras-passe de bases de dados e conversas com a IA. A vulnerabilidade permaneceu aberta durante 48 dias; ocorreu um incidente em grande escala em 20 de abril de 2026, que afetou todos os projetos criados antes de novembro de 2025.
• Replit. Durante um congelamento de código, um agente de IA executou comandos não autorizados e apagou uma base de dados operacional, afetando os dados de mais de 1,190 empresas; depois, inventou milhares de registos falsos e mentiu sobre o sucedido.

Isto não é um argumento de que «a IA é perigosa, mantenha-se afastado». É um argumento a favor da disciplina. A diferença entre a programação por intuição às cegas e a engenharia agêntica está precisamente em ler os diffs e executar verificações antes de qualquer coisa entrar em produção. Explico a proteção em pormenor nos guias Segurança na Programação por Intuição e O Que Fazer Se a IA Apagar uma Base de Dados.

Como passar da programação à orquestração: 5 mudanças#

Não está a aprender a escrever código. Está a mudar a forma como define tarefas e aceita o trabalho. Eis cinco mudanças, por ordem.

1. Da instrução ao objetivo. Antes: escreve um pedido, recebe um excerto e depois escreve o pedido seguinte. Agora: define o objetivo e o critério de «concluído», e cabe ao agente dividi-lo em etapas. Descreve o resultado; o agente escolhe as etapas.
2. Do chat ao plano. Antes: uma sequência de mensagens, e só descobre o que correu mal depois de acontecer. Agora: começa com um plano. O Claude Code tem um modo para isso, em que o agente apresenta o plano antes de tocar no código — lê-o, faz alterações e só depois o agente começa. Consulte o guia Modo de Plano no Claude Code.
3. De um agente para vários. Antes: um Claude, uma janela. Agora: vários agentes em paralelo, cada um com a sua tarefa e cópia de trabalho isolada. Consulte o guia Como Executar Mais de 10 Sessões do Claude Code em Paralelo.
4. Da confiança à revisão. Antes: aceitar o resultado, colá-lo e continuar. Agora: é a última linha de controlo de qualidade. Inspeciona cada diff, executa testes e nada entra em produção sem a sua revisão. É isso que distingue a prática adulta de fazer as coisas ao acaso.
5. Do código ao contexto e à arquitetura. Antes: pensava em como escrever uma função. Agora: pensa no que coloca no contexto do agente e em como dividiu o sistema em partes. O seu valor reside agora na capacidade de julgamento; a velocidade de escrita já não importa.

Repare: nenhum ponto diz respeito à sintaxe. Os cinco dizem respeito à forma de pensar e tomar decisões. É por isso que um empresário sem experiência de programação muitas vezes aprende engenharia agêntica mais depressa do que um programador: não tem de desaprender a fazer tudo à mão.

De que ferramentas precisa para a engenharia agêntica?#

Estas ferramentas funcionam como alavancas para quem orquestra. Cada uma elimina uma limitação que dificulta a gestão de agentes em escala.

Um exemplo recente de escala: em 28 de maio de 2026, a Anthropic lançou o Dynamic Workflows. O Claude escreve um script de orquestração e lança até 16 agentes em simultâneo, até mil numa execução. Com este mecanismo, uma pessoa reescreveu um projeto de grande dimensão com 750 000 linhas em 11 dias, e 99,8% dos testes continuaram a passar. Há um ano, isto era simplesmente impossível.

Mas estas alavancas só funcionam sobre uma base sólida. Lançar dez agentes num projeto vazio e sem contexto apenas multiplica o caos por dez. Primeiro, construa o Segundo Cérebro e defina as regras; depois, aumente a escala.

A engenharia agêntica vai substituir o empresário?#

O receio é real: se uma máquina escreve o código, para que precisamos de uma pessoa?

Neste cenário, o empresário só sai reforçado. Não é preciso contratar cinco pessoas só para testar uma ideia. A engenharia agêntica eleva o patamar máximo. Antes, esse patamar era determinado pelo número de pessoas que conseguia contratar e alimentar. Agora, é determinado pela sua capacidade de julgamento — pela eficácia com que define o objetivo e verifica o resultado. A IA não lhe retira essa capacidade de julgamento.

É por isso que os veteranos continuam a dizer: use a IA para compreender a tarefa mais profundamente. Quem ignora a compreensão está a construir uma bomba-relógio. Quem compreende ganha capacidade de ação.

Por onde deve começar hoje?#

Não tente passar diretamente à orquestração de dez agentes. Esse é o caminho para o caos. Siga esta ordem.

1. Construa um Segundo Cérebro. Crie uma pasta business/ no projeto e descreva quem é, qual é o produto, para quem se destina, que decisões já foram tomadas e que estilo deve seguir. É um esforço único que compensa em todos os pedidos seguintes. Consulte o guia Segundo Cérebro no Claude Code.
2. Passe a trabalhar com base num plano. Ative o modo de plano e habitue-se a ler o plano antes de o agente começar a escrever. Isto protege contra «fez a coisa errada» e ensina-o a pensar como alguém que orquestra.
3. Crie o hábito de rever. Inspecione cada diff e execute verificações. Comece com um agente numa tarefa. Quando isso se tornar fácil, acrescente um segundo e, depois, agentes em paralelo. Primeiro a disciplina, depois a escala.

É assim que se passa da adivinhação à prática adulta: pensar com mais clareza e verificar com mais fiabilidade.

Se precisar de aceder a redes neuronais através do Ailoot, consulte o Ailoot.