Eu vou trabalhar com Laravel, Node e Astro nesta série. Para começar, escolhi o Laravel porque ele deixa a arquitetura do sistema visível enquanto você desenvolve com IA. A rota recebe a requisição, o middleware confere o acesso, a policy define a permissão e a migration registra a mudança do banco. Esses nomes ajudam você a descrever uma alteração e, depois, localizar o que o agente modificou.

Quando aprendi a dirigir, fiz autoescola em um Fox vermelho. Aquele carro me ensinou a sair, frear, subir uma ladeira e observar o trânsito. O modelo mudou, mas os fundamentos continuaram comigo. Quero usar o Laravel na Promovaweb do mesmo jeito: como um framework concreto para você aprender a estrutura de uma aplicação e reconhecer os mesmos problemas quando trabalhar com Node, Python ou outra stack.

Direto ao ponto

Escolhi o Laravel para Vibe Coding porque ele oferece uma estrutura conhecida para o código gerado pela IA. Você consegue indicar onde uma permissão deve ser aplicada, como uma mudança no banco será registrada e qual teste deve confirmar o comportamento. A documentação e as convenções do framework também oferecem referências que o agente consegue consultar durante o trabalho.

Essa escolha ganha valor depois que a primeira tela fica pronta. Um sistema recebe novos recursos, muda a estrutura do banco, processa tarefas em segundo plano e precisa preservar permissões já existentes. O Laravel distribui essas responsabilidades por partes reconhecíveis do projeto, o que permite revisar a alteração no arquivo certo e conferir o resultado com testes.

Um framework dá nomes ao sistema que a IA modifica

Uma instrução como “crie uma área para administrar os membros de uma empresa” abre vários trabalhos dentro da aplicação. Existe a tela, a rota usada para gravar o formulário, a validação dos campos e a permissão que separa um membro comum de um administrador. Quando o projeto segue as convenções do Laravel, cada responsabilidade possui um nome que você pode citar na instrução enviada ao agente e encontrar no repositório.

Esse vocabulário muda a qualidade da revisão. Você pode abrir a policy para conferir a autorização, ler a migration associada ao novo campo e executar o teste que reproduz o acesso permitido e a recusa. A resposta escrita pelo agente explica o trabalho realizado, enquanto os arquivos registram o comportamento que a aplicação executará.

Eu considero esse aprendizado mais útil do que decorar a sintaxe de PHP. A IA consegue escrever uma função, completar um controller e sugerir um teste. Você precisa reconhecer a função de cada parte para conferir se o conjunto ainda representa o sistema que pretende colocar em uso.

O projeto continua compreensível depois do primeiro prompt

A primeira versão costuma caber numa instrução curta: cadastro, painel e alguns botões. Depois chegam os convites entre membros, as assinaturas, os emails e as tarefas que devem rodar fora da requisição principal. Um projeto improvisado espalha essas responsabilidades pelos arquivos criados durante cada alteração. O Laravel oferece lugares conhecidos para cada uma delas.

Quando você adiciona a data de aceite de um convite, a migration mostra como o banco mudou e a policy revela qual membro pode concluir a ação. Se o convite também envia um email, o job mantém esse trabalho fora da resposta principal. O teste reúne essas partes num comportamento executável, então uma nova sessão com a IA consegue reconstruir a mudança pelos arquivos do repositório, mesmo depois que o histórico do chat anterior foi encerrado.

O framework também impõe limites úteis ao agente. Um arquivo fora da pasta esperada, uma classe com nome incompatível ou uma migration mal formada pode produzir uma falha visível. A convenção oferece uma forma de localizar o desvio e corrigi-lo na mesma parte do projeto.

Laravel Boost conecta o agente ao projeto e à documentação

O Laravel existe há anos, possui documentação extensa e mantém convenções adotadas por uma comunidade ampla. Quando um agente encontra uma rota, uma Form Request ou uma relação do Eloquent, ele pode consultar material público sobre aquela estrutura. O mesmo trabalho fica mais difícil num projeto cuja arquitetura foi criada durante instruções sucessivas e nunca recebeu documentação.

O Laravel Boost aproxima ainda mais o framework dos agentes de código. Ele fornece acesso a informações da aplicação e à documentação correspondente. O agente consegue consultar rotas, configurações e o esquema do banco enquanto trabalha. Esse acesso oferece uma fonte mais precisa para a implementação. A comparação dos arquivos alterados e a execução dos testes continuam necessárias.

Eu uso esse acesso para aproximar a implementação do projeto real. O agente consulta os arquivos, escreve a alteração e executa as verificações. Durante o trabalho, acompanho a estrutura escolhida, a permissão aplicada e o comportamento que será entregue.

Starter kits encurtam o caminho até uma aplicação real

Login, recuperação de senha, validação e navegação responsiva aparecem cedo num sistema usado por clientes. Um projeto novo também precisa manter a integração entre o backend e a interface enquanto essas telas evoluem. Os starter kits do Laravel entregam uma estrutura inicial com escolhas conhecidas pela comunidade.

Você ainda define como os membros entram e o que cada papel pode fazer. Ao adicionar um convite para a empresa, por exemplo, a autenticação do starter kit já oferece arquivos de rota e de interface que podem ser abertos no repositório. O agente modifica essa base, e você confere a nova permissão e a tela do convite nos arquivos ligados ao recurso.

Essa base também evita que cada novo projeto invente uma forma diferente de resolver tarefas comuns. Eu prefiro aproveitar um componente mantido pelo framework ou pela comunidade quando ele atende ao sistema. A implementação autoral fica reservada para a parte que realmente diferencia o produto.

A estrutura continua exigindo leitura. O agente pode colocar uma autorização na policy correta e escrever uma condição incompatível com o requisito. O arquivo conhecido facilita a conferência, e o teste precisa reproduzir tanto o acesso aceito quanto a tentativa recusada.

Telescope, filas e testes acompanham o sistema funcionando

O código pode parecer correto durante a leitura e falhar quando recebe uma requisição real. O Laravel Telescope mostra requisições, exceções, consultas ao banco e jobs dentro da aplicação. Quando uma tela demora ou uma tarefa falha, você consegue abrir o painel e identificar a requisição, a consulta ou o job associado ao problema.

As filas retiram trabalhos demorados da resposta principal. Um email, uma importação ou um processamento pesado pode ser executado por um job, com tentativas e falhas registradas. O Laravel oferece essa estrutura e permite que o agente implemente a tarefa dentro de um mecanismo já conhecido.

Os testes fecham a revisão pelo comportamento. No artigo sobre como testar código gerado por IA com Laravel, mostro com mais detalhe como policies, migrations e testes ajudam a conferir uma alteração. Aqui, eles cumprem outra função no argumento: fazem parte da arquitetura que você aprende no Laravel e reconhece em outros frameworks.

O que você aprende continua útil fora do Laravel

Node, Python, Ruby e outras stacks organizam as mesmas responsabilidades com nomes e implementações próprios. Uma chamada HTTP ainda precisa chegar a uma rota, a entrada precisa ser validada e uma permissão precisa recusar o acesso indevido. O trabalho demorado também precisa sair da resposta principal, e um teste deve reproduzir o comportamento esperado. Depois de acompanhar essas partes no Laravel, você consegue procurá-las no framework usado pelo próximo projeto.

Essa é a relação com a autoescola. O Fox vermelho foi o carro concreto usado para aprender a dirigir. O Laravel é o framework concreto que escolhi para explicar arquitetura no Vibe Coding. Trocar de stack exige conhecer novos comandos e novas convenções, enquanto rotas, autorizações, filas, migrations e testes continuam respondendo a necessidades reconhecíveis.

A formação IA Makers da Promovaweb trabalha esse desenvolvimento acompanhado, da especificação à publicação do sistema. Você também pode conhecer a nossa abordagem de Vibe Coding e ler como um agente usa memória, skills e ferramentas para continuar uma tarefa. O Laravel entra nessa rotina como a estrutura que dá nome ao trabalho, deixa os arquivos localizáveis e permite conferir o que a IA alterou.