Engenharia de Software com IA: Spec Driven Design na Prática (Hands-on)

A era do prompt acabou? No desenvolvimento de software com IA, a resposta é sim e não. Neste episódio épico do PPT Não Compila, mergulhamos no Spec-Driven Design, a metodologia que redefine como construímos software de alta qualidade e manutenível. Esqueça prompts genéricos: aqui o foco está na documentação robusta e no contexto bem definido para guiar a inteligência artificial e escalar processos de Engenharia de Software com IA.

Com a presença especial de Gustavo Passi, que assume o papel de "corneteiro" e questionador, Wellington Cruz conduz um hands-on de quase 3 horas desenvolvendo um gerenciador de decks de Pokémon. Você verá como dois agentes de IA — Gemini como planejador e Claude como programador — interagem com especificações detalhadas em arquivos Markdown. Da arquitetura com React, Next.js, Spring Boot e Java, passando por Docker, Kubernetes e Google Cloud (GCP), até a integração com a PokiAPI, Swagger, SQLite e Secret Manager, cada etapa é cuidadosamente planejada para gerar código limpo e funcional.

Este episódio prova que o conhecimento técnico do arquiteto e do desenvolvedor é mais crucial do que nunca para direcionar a IA com precisão, garantindo a qualidade e longevidade do produto final. Confira o código-fonte e a documentação no GitHub (link na descrição), inscreva-se para não perder a continuação sobre QA, DevOps e code review com IA, e deixe seu comentário!

Convidados

Gustavo Passihttps://www.linkedin.com/in/gustavo-passi/

00:00:00 O Fim da Era do Prompt: Por Que a Documentação Guia a IA?

00:00:50 Boas-Vindas e o Retorno do Corneteiro: Gustavo Passe no PPT Não Compila

00:01:30 Spec-Driven Design Explicado: O Segredo para uma IA Produtiva

00:02:16 Preparando o Terreno: Estrutura do Projeto e o Poder do Markdown para LLMs

00:02:50 Desvendando o `project.md`: As 10 Regras Inegociáveis para Nossos Agentes de IA

00:05:01 Arquitetura Detalhada: Stack Frontend/Backend, Segurança e Persistência de Dados

00:08:43 Regras de Negócio e Layout: Definindo a Experiência do Usuário e o Core do Pokedeck

01:04:16 Planejamento Ágil com IA: Dividindo o Desenvolvimento em Sprints Validadas

01:09:00 Gemini Entra em Ação: O Agente Planejador Detalhando as Especificações

01:14:00 Validação da Arquitetura: Detalhes Técnicos, Modelagem de Dados e API Design

01:21:00 Riscos e Decisões Pendentes: A IA Revela Falhas na Especificação Humana

01:25:00 Refinamento das Regras de Negócio: Corrigindo a Lógica de Transferência de Pokémon

01:30:00 Detalhando o Layout e Infra: Cores, Componentes e Pipeline de CI/CD

01:40:00 Planejando a Sprint 1: O Detalhamento Minucioso para o Desenvolvedor

01:45:00 Gemini Conclui o Planejamento: Todas as 9 Sprints Detalhadas e Prontas

01:50:00 Cloud Entra em Cena: O Agente Programador Identifica Inconsistências

01:55:00 Diálogo com a IA: Corrigindo as Pendências do Planejamento

02:00:00 Início da Sprint 1: Cloud Começa a Gerar Código e Estrutura

02:05:00 Desafios da Automatização: Lidando com Permissões e Dependências

02:15:00 Scaffold Completo: A Estrutura Básica do Projeto Ganha Vida

02:20:00 Validação da Sprint 1: Rodando o Backend (Spring Boot) e o Frontend (Next.js)

02:25:00 Sprint 2: Mock do Web Service – API Design e DTOs em Ação

02:30:00 Validação da Sprint 2: Explorando a API Mockada do Pokedeck

02:35:00 Sprint 3: Mock do Frontend – A Interface do Usuário Ganhando Forma

02:40:00 Validação da Sprint 3: A Experiência Visual do Pokedeck

02:41:43 Conclusão e Próximos Passos: O Poder da Engenharia de Contexto com IA

Github: https://github.com/wellingtoncruz/pptnc-pokedeck/

Youtube: https://youtu.be/xGeU0eKB-qE

Outras plataformas: https://linktr.ee/pptnaocompila