✈️ O IDE é o caça, o modelo é o piloto
Antes de mais nada, uma analogia que organiza tudo: o IDE (AntiGravity, Cursor) é o caça — a máquina onde você voa. O modelo (Claude Code, Gemini) é o piloto — o cérebro que toma as decisões. E o ponto central: você troca o piloto conforme o objetivo da missão.
🧭 A ideia central
Separar a ferramenta (o caça) do cérebro (o piloto) é libertador: sua habilidade não fica presa a um produto. Se um modelo é melhor em design e outro em raciocínio, você escolhe o piloto certo para o voo.
- •O caça não decide nada sozinho — ele dá os instrumentos e o cockpit.
- •O piloto raciocina, escreve e corrige — e pode ser trocado a qualquer momento.
- •Nenhum piloto decola sem checklist — é exatamente o que o framework CODA é.
o IDE
o modelo
por objetivo
= CODA
📝 C — Configure (claude.md)
A primeira etapa do CODA é Configure: criar um arquivo de contexto — claude.md (ou Gemini.md) — em TODO projeto. É a espinha dorsal que o piloto lê antes de tocar em qualquer coisa.
Tech stack & diretórios
Quais tecnologias o projeto usa e onde ficam as pastas-chave. Assim a IA não fica adivinhando a estrutura.
Comandos
Como rodar, buildar e testar o projeto. O piloto precisa saber os comandos para executar e verificar.
Critério de sucesso + como testar
O coração do arquivo: o que significa "pronto" e como provar. Sem isso, todo o resto perde o rumo.
💡 Documento vivo
O claude.md não é escrito uma vez e esquecido. Sempre que o projeto mudar de rumo, atualize o arquivo. Ele é a memória compartilhada entre você e o piloto.
tecnologias
rodar e testar
o que é "pronto"
sempre atualizado
🗺️ O — Outline (Plan Mode)
A segunda etapa é Outline: planejar antes de codar. Aqui mora o segredo dos profissionais — gastar ~95% do tempo definindo o problema e o sucesso ANTES de escrever uma linha de código.
✓ Faça no Plan Mode
- ✓Definir o problema em detalhe
- ✓Conversar de ida e volta com o modelo
- ✓Pedir perguntas clarificadoras
- ✓Usar "ultrathink" para raciocínio profundo
✗ Evite
- ✗Mandar "constrói X" e sair codando
- ✗Pular a definição do sucesso
- ✗Aceitar a primeira interpretação da IA
- ✗Descobrir o requisito só no fim
No Plan Mode, o modelo não escreve código: ele conversa, levanta dúvidas e ajuda a montar a especificação. Quando o plano está sólido, a implementação vira quase um detalhe — porque o problema já foi resolvido no papel.
no plano
ida e volta
clarificadoras
raciocínio fundo
⚡ D — Deploy (agentes em paralelo)
A terceira etapa é Deploy: colocar os agentes para voar. O salto de produtividade vem de rodar vários agentes ao mesmo tempo (5 a 7) — pelo terminal ou pelo próprio IDE.
🛫 Esquadrão de agentes
Em vez de esperar um agente terminar para começar o próximo, você decola um esquadrão. Enquanto um mexe no front, outro ajusta o back, outro escreve testes — todos em paralelo.
Dá até para usar agentes na web conectados a um repositório, rodando mesmo com o laptop fechado. O trabalho continua sem você.
| Onde rodar | Como | Vantagem |
|---|---|---|
| Terminal | várias sessões | controle direto |
| IDE | painéis paralelos | tudo num lugar |
| Web + repo | na nuvem | roda com laptop fechado |
agentes juntos
ou IDE
ligado ao repo
multiplica
🧩 A — Automation (subagentes)
A quarta etapa é Automation: criar subagentes especializados, um por subtarefa. Cada subagente tem a sua própria janela de contexto, evitando que tudo estoure numa conversa só.
🧠 Por que dividir
Cada modelo tem um limite de quanto consegue "lembrar" de uma vez (a janela de contexto). Ao dar uma subtarefa por subagente, você mantém cada conversa enxuta e focada — e nada importante é empurrado para fora da memória.
1 subagente
próprio de cada um
sem ruído
memória sob controle
🔎 R — Review & verify
A última etapa é Review & verify: o pouso. Você dá critérios de sucesso explícitos (escritos no claude.md) para que "pronto" deixe de ser opinião e vire um teste objetivo.
✅ Checklist de sucesso
- ✓Roda sem erros
- ✓Os testes passam
- ✓Sem warnings de lint
- ✓Faz o que foi pedido
- ✓As mudanças são explicáveis
🕵️ Revisão cética
Peça à IA para revisar o próprio trabalho como um "desenvolvedor sênior altamente cético". Esse enquadramento força o modelo a procurar buracos em vez de elogiar — e revela o que quebraria antes do usuário descobrir.
executa limpo
passam
você entende
caça buracos
🪶 Menos é mais
Um contraponto importante ao CODA inteiro: às vezes um prompt curto rende melhor que um super-detalhado. Modelos modernos são bons em inferir — e excesso de instrução pode confundir.
✓ Tente primeiro
- ✓O prompt curto e direto
- ✓Deixar a IA inferir os detalhes
- ✓Só detalhar se ela errar
✗ Cuidado com
- ✗Encher o prompt "por garantia"
- ✗Instruções que se contradizem
- ✗Microgerenciar cada passo
⚖️ O equilíbrio
CODA dá estrutura onde ela importa (contexto, plano, verificação). "Menos é mais" lembra que, no prompt do dia a dia, simplicidade é uma força. Comece simples; adicione detalhe só quando a IA pedir ou errar.
primeiro
deixe a IA
só se errar
economiza
🔬 Exemplo prático
Vamos montar um claude.md para um projeto simples — um site que mostra o clima de 3 cidades — já com critérios de sucesso e teste. Esse é o "C" do CODA na prática.
# Clima de 3 cidades ## Stack - HTML + CSS + JS puro (sem build) - API: open-meteo (sem chave) ## Diretórios - index.html → página única - /assets → css e js ## Comandos - abrir: é só abrir index.html no navegador - testar: rodar manualmente as 3 cidades ## Critério de sucesso - Mostra temperatura atual de São Paulo, Rio e Salvador - Carrega em < 2s, sem erros no console - Funciona offline depois do 1º carregamento (cache) ## Como testar 1. Abrir index.html 2. Conferir as 3 temperaturas aparecendo 3. Abrir o console: não pode ter erro vermelho
Repare: o piloto (modelo) agora sabe o que construir, como rodar e — principalmente — como saber que terminou.
🏋️ Exercício
Hora de pilotar. Faça os dois passos abaixo num projeto seu (pode ser pequeno):
- Escreva um claude.md com critérios de sucesso claros e a seção "como testar".
- Rode 3 agentes em paralelo em subtarefas diferentes (ex.: um na interface, um na lógica, um nos testes).
Ao final, peça a um deles para revisar como "desenvolvedor sênior cético" e anote o que ele encontrou.
⚡ Prompts prontos
Copie, cole no seu assistente de IA e adapte ao seu caso.
Atualize o claude.md com o escopo abaixo do projeto e me faça perguntas para preencher os detalhes que faltam (stack, diretórios, comandos, critério de sucesso e como testar). Escopo: [descreva o projeto em 2-3 frases]
(Plan Mode) Quero construir [X]. Me ajude a definir o problema em detalhe e criar as especificações. Faça perguntas clarificadoras antes de escrever qualquer código. Não comece a implementar até o plano estar fechado.
Revise este código como um desenvolvedor sênior altamente cético: - Roda sem erros? - Os testes passam? Há casos não cobertos? - O que quebraria em produção? Liste os problemas por severidade e proponha a correção de cada um.
✅ Resumo do módulo
Próximo módulo:
5.2 — Biblioteca de Skills & Prompts