Engenharia de Agentes
Versão Ilustrada

Como uma cozinha de restaurante explica engenharia com IA

Sem jargão. Sem código. Apenas a história de como pedir uma feature passou a parecer pedir um jantar.

🍝

Antes: o cozinheiro improvisador

Você chega no restaurante e grita o pedido para alguém atrás do balcão. Ele cozinha rápido. O prato vem bonito. Mas tem sal demais. Você pede outro. E outro. E outro. Isso é vibe coding: a IA cozinha rápido, mas resolve o problema errado.

Talento solto sem cardápio é só caos perfumado.
🧑‍🍳

A fundação: a brigada montada

Antes de qualquer prato sair, a cozinha precisa estar de pé: cada um no seu posto, as regras da casa na parede, a comanda viajando com o pedido e um roteiro do serviço do primeiro ao último prato. Não é o que deixa a comida gostosa — é o que faz a cozinha funcionar todo dia, com qualquer time, sem depender de um gênio improvisando.

A cozinha organizada é o chão. Sem ela, todo o resto vira improviso.
📋

A primeira disciplina: o cardápio é o herói

Sobre essa cozinha organizada, a primeira regra: nada vai pro fogo sem ficha técnica. Cada prato tem cardápio — ingredientes, tempo, ponto. O cliente lê, escolhe, confirma. Só então a cozinha começa. É a especificação escrita antes de cozinhar: sem ela, ninguém sabe o que está sendo feito.

A spec é o cardápio. O prompt é só apontar o dedo.
🥄

A segunda disciplina: provar antes de servir

Nenhum prato sai da cozinha sem ser provado. O cozinheiro experimenta a colher: está no ponto? Tem o sal certo? Bate com o que o cardápio prometeu? Se não passa na degustação, volta pro fogo — não vai pra mesa. Cada detalhe do pedido tem que ter sua prova; achar que ficou bom sem provar é só torcer.

Prato que ninguém provou é aposta, não é serviço.
🚦

Quatro conferências no caminho até a mesa

O pedido passa por gente cuidadosa antes de virar jantar. A primeira confere se o pedido foi anotado certo (reflete o desejo do cliente). A segunda confere se a cozinha tem como fazer e com qual técnica. A terceira libera para começar. E no fim, o chef-expedidor olha o prato pronto e assina antes de ele sair pela porta. Demora? Não — evita 40 minutos refazendo o prato errado.

Quatro conferências. A última é o chef assinando o prato antes da mesa.
📓

Tudo escrito na comanda

A comanda anda com o prato. O garçom escreveu o pedido. O sommelier anotou a sugestão. O chef rabiscou o ajuste. O cozinheiro marcou o ponto. Quando o prato chega à mesa, a história inteira está na comanda. Sem WhatsApp, sem 'foi mal, esqueci de avisar'.

O task file é a comanda. Acumula contexto. Não some entre turnos.
⏱️

O resultado: um jantar em vez de uma briga

Um sistema crítico que levaria mais de um ano para ser refeito do jeito tradicional saiu em cerca de dois meses com a squad de agentes — e ainda com features extras de brinde (a história completa está na página de Cases). Não é mágica. É cozinha organizada, cardápio escrito e tudo provado antes de servir.

Velocidade vem da disciplina, não do improviso.

Em uma frase

A IA já sabe escrever código. O que mudou é que aprendemos a tratá-la como uma cozinha de verdade — com a brigada montada, o cardápio escrito antes de cozinhar, cada prato provado antes de servir, e o chef assinando na saída.