📱 O Exercício: App de Notas com IA
App web simples: criar notas, organizar por tags, e ter um botão "resumir com IA". Pequeno o suficiente pra terminar em 1h, completo o suficiente pra exercitar o fluxo inteiro. Escolher o tamanho certo é parte da disciplina agentic.
📐 Escopo do exercício — o que entra e o que NÃO entra
- ✓Criar/editar/excluir nota
- ✓Lista de notas na tela inicial
- ✓Tags simples (texto separado por vírgula)
- ✓Botão "Resumir com IA" via OpenAI
- ✓Persistência local (Convex ou localStorage)
- ✗Login, autenticação, multi-usuário
- ✗Compartilhamento, colaboração realtime
- ✗Deploy em produção
- ✗Mobile responsivo perfeito
- ✗Dark/light mode, theming, i18n
📌 Por que esse tamanho
Grande demais (com auth, deploy, mobile), o agente se perde, você gasta 4 horas e não vê o fluxo todo. Pequeno demais (só Hello World), não exercita revisão de diff nem PR review. Notas + tags + IA bate o sweet spot: 5 arquivos, 200 linhas, 1 chamada externa.
✍️ Prompt Inicial e Plan Mode
Em vez de pedir "construa o app", você pede "proponha um plano em 5 etapas para construir o app". O agente expõe a abordagem antes de escrever uma linha. Discutir o plano em 30 segundos evita refatorar 200 linhas depois.
❌ Prompt ruim (vibe)
- • Sem stack definida
- • Sem critério de pronto
- • Agente decide tudo sozinho
- • Você só descobre se errou no fim
✓ Prompt bom (agentic)
- ✓ Stack explícita
- ✓ Plano antes de código
- ✓ Estrutura clara do plano
- ✓ Você aprova ou ajusta antes
💡 O ciclo plan-approve-execute
Plan mode é o equivalente agentic de "design review": você captura erros de abordagem antes que virem código. 30 segundos lendo um plano de 5 bullets evita 20 minutos de retrabalho. Quando o plano vier errado, peça revisão: "Etapa 3 está errada, quero usar X em vez de Y. Reescreva o plano."
👀 Acompanhando o Agente Trabalhar
Durante a execução, o agente lê arquivos, edita, roda comandos, abre o browser. Você observa em tempo real e intervém quando vê algo errado. Saber quando intervir e quando deixar continuar é uma habilidade calibrada.
🚦 Sinais — quando interromper, quando aguardar
📊 A regra da paciência produtiva
Iniciante interrompe demais — quebra o flow do agente, gera retrabalho. Veterano interrompe pouco — perde 20 minutos pro agente ir num caminho ruim. O ponto certo: 1 interrupção a cada 5–8 minutos quando algo te incomoda. Se está tudo no plano, deixa rodar.
🔍 Revisando o Diff Antes de Aprovar
Antes de aceitar mudanças, você lê o diff. É a última linha de defesa antes do código entrar no repo. 5 minutos de revisão evita horas de bug em produção.
🔎 Checklist de revisão de diff
⚠️ O bug clássico de IA: secret no código
Agentes às vezes hardcoded API keys porque "fica funcionando rápido". Se você commitar isso e fizer push pra repo público, OpenAI revoga sua key em minutos e seu cartão pode tomar cobrança não autorizada. Toda revisão começa por: "Tem alguma string que parece chave secreta?".
📝 Commit e Pull Request — O Agente Cuida da Papelada
Você pede ao Codex para fazer commit com mensagem semântica e abrir PR no GitHub com descrição estruturada. PRs bem descritas diferenciam código profissional de protótipo. O agente entrega isso de graça se você pedir corretamente.
- Adiciona CRUD de notas com persistência via Convex
- Implementa botão "Resumir com IA" usando GPT-4o-mini
- Sistema de tags simples por separação de vírgula
- - [ ] Criar nota com título e corpo, verificar que aparece na lista
- - [ ] Adicionar tag "urgente", filtrar por tag, validar resultado
- - [ ] Clicar em "Resumir com IA", verificar que retorna 2-3 frases
- - [ ] Refresh da página: notas persistem
📌 Conventional commits + template de PR
Peça sempre: "commit message no formato conventional commits, PR com seções Summary e Test plan". Isso vira release notes automáticas depois e facilita revisão por outros (humanos ou agentes). PR sem descrição é PR que ninguém revisa direito — você está perdendo a metade do valor.
🤖 @codex review — A IA Revisando a IA
Você comenta @codex review na PR. Outro agente Codex (independente) lê o código, comenta sugestões, identifica bugs e aponta riscos. Quando você está sozinho, ter um "segundo par de olhos" automatizado eleva a qualidade sem custo de tempo.
🔄 Ciclo write → review → merge
💬 Exemplo de revisão automatizada
💡 Por que isso muda tudo
Dev solo nunca tem code reviewer. Com @codex review, você ganha um sênior automatizado que nunca dorme, lê 100% do diff e te aponta os 2–3 problemas reais. Custa quase nada e eleva qualidade de "freelancer médio" pra "agência boutique". Esse é o fim da Trilha 1: você agora tem o fluxo profissional inteiro rodando.
🇧🇷 Estudos de Caso: Primeiro Fluxo Agentic na Prática
Três histórias de devs e empreendedores brasileiros que rodaram o fluxo prompt → PR pela primeira vez e mediram o impacto direto na rotina.
Bento Imóveis
Curitiba · ImobiliáriaDetalhe técnico: aprovação do PR final em apenas 2 commits — diff curto, mensagem clara e checklist de revisão aplicado antes do merge.
Studio Mind
Recife · Estúdio de animaçãoDetalhe técnico: uso de Plan Mode antes de cada componente — ler e ajustar plano em 30s evitou retrabalho em hero, grid e página de cases.
Verde Foods
Belo Horizonte · Delivery saudávelDetalhe técnico: reverse prompting deixou o agente escolher a stack (Next.js + Tailwind + Supabase) com base nos requisitos do MVP, sem decisão prévia do fundador.
✅ O que Aprendemos
Trilha 1 concluída! Próxima:
Trilha 2 — Agentes em Profundidade: AGENTS.md, skills, plan mode avançado, definition of done, e o método disciplinado que separa vibe de produto vendável.