🎯 O Modelo Mental
Se voce guardar apenas tres palavras deste curso, que sejam estas: Gather, Act, Verify. Este ciclo explica 90% de tudo que Claude Code faz.
GATHER
Coletar informacao antes de agir
ACT
Executar acoes no sistema
VERIFY
Verificar se funcionou
💡 Por que isso importa?
Quando voce entende o ciclo, consegue prever o comportamento de Claude, identificar problemas mais rapido e escrever prompts melhores que aproveitam cada fase.
📥 Fase Gather: Entender Antes de Agir
Na fase Gather, Claude coleta informacoes antes de fazer qualquer mudanca. E aqui que ele le arquivos, explora a estrutura do projeto e faz perguntas.
O que acontece no Gather
- 📄 Le o CLAUDE.md: Primeiro passo de toda sessao
- 🔍 Usa Glob: Encontra arquivos relevantes
- 📖 Usa Read: Le o conteudo dos arquivos
- 🔎 Usa Grep: Busca padroes especificos
- ❓ Faz perguntas: Usa AskUserQuestion para clarificar
✓ Bom Gather
- • Le apenas arquivos necessarios
- • Usa Glob antes de Read
- • Pergunta quando nao tem certeza
- • Busca padrao no codigo existente
✗ Gather Ruim
- • Le arquivos enormes desnecessariamente
- • Ignora CLAUDE.md
- • Assume ao inves de perguntar
- • Consome contexto lendo tudo
⚡ Fase Act: Executando Mudancas
Na fase Act, Claude faz mudancas reais no seu sistema. E aqui que arquivos sao editados, criados, e comandos sao executados.
Ferramentas de Acao
Modifica arquivos
Cria arquivos
Roda comandos
Delega tarefas
⚠️ Cuidados na Fase Act
- • Edit prefere edicoes cirurgicas - nao reescreve arquivos inteiros
- • Bash pode ser perigoso - comandos rodam no seu sistema real
- • Snapshots sao criados - Claude salva estado antes de editar
- • Permissoes sao verificadas - depende do modo (Ask/YOLO)
✅ Fase Verify: Confirmando Resultados
Na fase Verify, Claude confirma que a acao funcionou. E aqui que testes sao rodados, erros sao detectados, e o ciclo pode recomecar se necessario.
Como Claude Verifica
- 🧪 Roda testes: Se existirem, executa a suite de testes
- 📖 Re-le arquivos: Confirma que as mudancas foram aplicadas
- 🔧 Compila/builda: Verifica se o codigo ainda funciona
- 🔄 Corrige erros: Se falhar, volta para Gather/Act
💡 Dica Importante
Incentive Claude a verificar. Prompts como "depois de fazer a mudanca, rode os testes" ou "confirme que funciona" ativam a fase Verify.
🔄 O Loop de Feedback
Quando a verificacao falha, Claude volta ao inicio do ciclo. Este loop continua ate o problema ser resolvido - ou ate voce intervir.
Diagrama do Loop
Se falhar, volta para Gather com novo contexto
⚠️ Perigo: Loop Infinito
Se Claude entrar em loop sem progresso, ele pode consumir todo seu contexto sem resolver o problema. Sinais de alerta:
- • Tentando a mesma solucao repetidamente
- • Contexto passando de 50%
- • Erros identicos aparecendo varias vezes
Solucao: Interrompa, de mais contexto, ou comece nova sessao.
🎯 Exemplo Pratico Completo
Vamos ver o ciclo em acao com um exemplo real: "Corrija o bug de login".
📥 GATHER
- 1. Le CLAUDE.md para entender o projeto
- 2. Usa Glob para encontrar arquivos de autenticacao
- 3. Usa Grep para buscar "login" ou "auth"
- 4. Le os arquivos encontrados
- 5. Identifica a funcao com problema
⚡ ACT
- 1. Planeja a correcao necessaria
- 2. Usa Edit para modificar o arquivo
- 3. Faz edicao cirurgica (apenas o necessario)
- 4. Cria snapshot automatico antes
✅ VERIFY
- 1. Re-le o arquivo para confirmar mudanca
- 2. Roda
npm testpara verificar - 3. Se passar: tarefa completa!
- 4. Se falhar: volta para Gather com erro
🚀 Proximo Passo
Agora que voce entende o ciclo fundamental, no proximo modulo vamos explorar o Gerenciamento de Contexto - como Claude gerencia seus 200K tokens e por que isso importa tanto.
📋 Resumo do Modulo
Proximo Modulo:
1.4 - Gerenciamento de Contexto: A analogia do balde