As 6 camadas que eu uso pra entregar software com IAsem virar bagunça em produção.
O código que a IA escreve é só o começo. Aqui eu abro cada uma dessas camadas: o que é, por que importa e como o agente executa sozinho seguindo as regras. É o caminho pro seu primeiro software de verdade feito com IA.
Leitura de uns 7 minutos. Salva essa página.
Essa página é pra você se…
- pede uma feature pra IA e cada uma sai num padrão diferente;
- já perdeu um fim de semana com um bug que a IA criou e você não entendeu;
- tem medo de fazer deploy porque não sabe o que vai quebrar;
- já pagou curso de arquitetura, viu teoria e não conseguiu aplicar no seu projeto;
- acha que arquitetura é coisa de empresa grande, não pro seu projeto;
- e não sabe se o sistema está seguro pra guardar dado de cliente.
A culpa não é da IA. Prompt solto não constrói sistema. E eu não vou te dizer que é fácil.
Também não vou te pedir pra acreditar em mim. Vou te mostrar como funciona, camada por camada, do jeito que eu faço todo dia.
Por que eu consigo tocar tudo isso sozinho
A primeira parte: o código vem de dois lugares, e os dois trabalham ao mesmo tempo.
A segunda: quem entrega software grande não revisa linha por linha nem refaz tudo na mão. Automatiza. Enquanto a maioria pede código solto pra IA e passa a tarde arrumando, eu entrego pro agente uma documentação feita pra ele, com as regras, os exemplos e o mapa do código.
- Você descreve a feature. Do jeito que já vem pronto no método.
- O agente implementa. Seguindo a arquitetura, sozinho.
- O CI confere. Testes e guards dizem se está pronto. Você não monta nada do zero.
É assim que eu toco um sistema com mais de 1.000 módulos sozinho, com mais de 5 mil testes rodando a cada push.
Telas reais do ecossistema. Toca pra ampliar.
As 6 camadas
Em cada uma: o que é, por que importa e como a IA executa.
Arquitetura: um padrão que o agente não fura
- O QUE É
- Cada funcionalidade organizada nas mesmas camadas: rota, controller, caso de uso e repositório, com contratos claros entre elas.
- POR QUE IMPORTA
- Feature nova nasce igual à anterior. Dá pra trocar uma integração sem mexer no resto.
- COMO A IA EXECUTA
- A documentação mostra ao agente onde cada coisa mora, e um guard reprova o PR que mistura as camadas.
O erro que mais vejo: a pessoa pede a feature, a IA coloca a regra de negócio dentro da rota e o acesso ao banco no componente, e funciona. Até a segunda feature.
$ python tools/guards/check_architecture.py … ✓ architecture guards pass — 1021 modules, 49 waived.
Segurança: o que ninguém pede pra IA fazerA QUE MAIS FALTA
Presta atenção nessa, porque ela é a que mais falta.
- O QUE É
- Autenticação, permissões por papel, criptografia e regras de LGPD desde o primeiro endpoint.
- POR QUE IMPORTA
- Vazamento de dado de cliente não tem volta. E a LGPD cobra de quem guarda o dado, não da IA.
- COMO A IA EXECUTA
- O agente segue o checklist de segurança de cada feature, e o próprio banco isola os dados por usuário (RLS) mesmo se o código errar.
# api/infra/database/rls_policies.py f"CREATE POLICY {table}_owner ON {qualified} " f"USING ({predicate}) WITH CHECK ({predicate})"
Dados: nada se perde, nada se mistura
- O QUE É
- Banco com regras de acesso, migrations versionadas e integridade garantida no backend.
- POR QUE IMPORTA
- Dado errado é pior que dado nenhum: relatório errado, cobrança errada, cliente perdido.
- COMO A IA EXECUTA
- Cada mudança no banco vira uma migration revisável, e o CI confere se o modelo e o banco batem antes do merge.
Frontend: interface que não vira labirinto
- O QUE É
- Pastas por funcionalidade, design system e componentes reutilizáveis.
- POR QUE IMPORTA
- É no frontend que o projeto feito com IA mais se repete: o mesmo botão de dez jeitos diferentes.
- COMO A IA EXECUTA
- O agente consulta o catálogo de componentes antes de criar um novo, e o lint reprova cor e estilo fora do sistema.
Entrega: deploy sem frio na barriga
- O QUE É
- Containers, ambientes isolados, pipelines de integração contínua, arquivos de configuração e Makefiles.
- POR QUE IMPORTA
- Se o deploy depende de você lembrar dez passos, uma hora você esquece um. Na sexta à noite.
- COMO A IA EXECUTA
- O CI roda lint, tipos, testes e build a cada push, e a imagem que passou em stage é a mesma promovida pra produção.
✓ api-tests ✓ arch-guards ✓ docs-guards ✓ app-quality ✓ landing-quality ✓ db-migrations-check ✓ docker-build
Operação: você sabe do problema antes do cliente
- O QUE É
- Backup, processamento paralelo, logs estruturados e auditoria de erros.
- POR QUE IMPORTA
- Sistema no ar é sistema que falha um dia. A diferença é descobrir em minutos ou pelo cliente.
- COMO A IA EXECUTA
- Tarefas pesadas vão pra fila e rodam em paralelo, e cada erro fica registrado com o rastro completo pra você, ou o agente, achar a causa.
Parece muita coisa, mas não é
Seis camadas parece muita coisa. Mas não é. Você não aplica as seis no primeiro dia.
- Escolhe uma camada. A que mais dói hoje no seu projeto.
- Entrega pro agente. A documentação diz como; você revisa o que importa.
- Soma a próxima. Depois de rodando, aplica outra. Quanto mais camadas, menos retrabalho.
Eu falo isso porque é o que eu faço todo dia. Esse é o resultado do guard no meu repositório:
Saída real do guard: 1.021 módulos verificados, nenhum fora do padrão.
Como isso aparece no seu celular
Quando as camadas rodam juntas no automático, é isso que aparece no celular:
Ilustração com eventos reais do repositório da Devaiana.
Você deve estar pensando…
A IA vai fazer arquitetura sozinha daqui a pouco.
Ela já escreve código sozinha, e é por isso mesmo que arquitetura importa mais: quanto mais rápido o agente, mais rápido ele espalha um padrão ruim. Quem define as regras continua sendo você.
É código pronto pra copiar?
Não. É uma arquitetura de referência documentada, com curso, guias e instruções para agentes. Você aplica no seu projeto, camada por camada.
Funciona com o Codex, ou só com o Claude?
A documentação é organizada pra orientar qualquer agente com regras, padrões e contexto. Os resultados dependem do modelo, das instruções e da sua validação.
Não sou programador sênior.
Os cursos e guias explicam cada conceito, e o agente faz a parte pesada. Projetos complexos ainda podem pedir acompanhamento técnico, e eu não vou fingir que não.
Já comprei curso de arquitetura e não funcionou.
Curso que só mostra teoria não ensina. Aqui cada camada vem com o que entregar pro agente aplicar no seu projeto.
Meu projeto já está no ar, não dá pra reescrever.
Não precisa. A arquitetura é modular: você aplica a camada que mais dói, com o sistema rodando.
Isso é coisa de empresa grande.
Empresa grande tem um time pra segurar a bagunça. Você tem o agente. É justamente quem trabalha sozinho que mais precisa de regra escrita.
Eu construí a Devaiana do jeito que ensino aqui: arquitetura primeiro, agentes de IA implementando depois.
O repositório dos prints é o meu dia a dia: mais de mil módulos, mais de 5 mil testes, deploy automatizado e uma documentação que o Claude e o Codex leem antes de escrever uma linha.
Eu não aprendi isso de uma vez. Aprendi errando, refazendo e anotando cada regra que evitava o mesmo erro de novo. O Ecossistema Devaiana é esse caderno, organizado pra você.
Quero que o seu próximo projeto já nasça com essa base.
Agora você tem um caminho
Se você quer parar de arrumar o que a IA faz e começar a entregar software de verdade, eu te mostro o caminho, camada por camada.
Ecossistema Devaiana
Você pode começar hoje com o Ecossistema Devaiana: as 6 camadas desta página, aula por aula, com a documentação pronta pro seu agente.
- Arquitetura modular
- Segurança e LGPD
- Dados com integridade
- Frontend organizado
- Entrega automatizada
- Operação que avisa
- Curso com aulas animadas
- Começa no seu projeto atual
2. Responde umas perguntas rápidas sobre o seu projeto.
3. No final aparece o Ecossistema Devaiana com o seu desconto e o botão pra entrar.
Perguntas
O que é o Ecossistema Devaiana?
Uma arquitetura de referência para software feito com IA: curso com aulas animadas, documentação das 6 camadas para Claude e Codex, guias práticos e uma biblioteca de skills e tools.
Quanto custa?
Você descobre no final do teste, com uma condição especial pra quem chegou por aqui.
Preciso ser programador?
Não necessariamente. Os cursos e guias explicam os conceitos, e a documentação orientada para IA apoia quem está construindo com agentes. Projetos complexos ainda podem exigir acompanhamento técnico.
Funciona com Claude e Codex?
Sim. A documentação é organizada para orientar essas ferramentas com regras, padrões e contexto arquitetural. Os resultados dependem do modelo, das instruções e da validação.
Daqui a um tempo
Imagina o seu projeto com testes rodando a cada push, deploy sem medo e um agente que acerta de primeira. Ou amanhã igual a hoje: a mesma feature pedida três vezes, o mesmo bug, o mesmo medo do deploy.
Eu não vou te prometer resultado. O que eu posso é te mostrar o caminho que eu já fiz. A decisão é sua.
O desconto aparece no final do teste.