M3 · Trabalho do dia-a-dia: erros, arrumações, testes e git

Em palavras simples

Já sabes o método. Este módulo é o estágio prático: as cinco situações que vais encontrar semana sim, semana sim — algo deu erro, algo está confuso, "será que funciona?", "o que é que isto faz?", e "quero experimentar sem estragar". Para cada uma há uma frase certa a dizer ao Claude.

Bloco 1 — Depurar: quando algo dá erro

Cola o erro. Todo.

Apareceu uma mensagem de erro assustadora? Óptimo — os erros são pistas, e o Claude é excelente a segui-las.

Cola a mensagem de erro completa na sessão — não resumas, não cortes. As linhas mais crípticas são muitas vezes as mais úteis
Acrescenta o contexto humano: "isto acontece quando clico em X", "funcionava ontem, hoje não"
Deixa o Claude investigar: ele vai ler os ficheiros relevantes, encontrar a causa e propor a correcção
Depois de corrigido, pede sempre: "como confirmo que ficou resolvido?" — e fá-lo

Na prática: a diferença entre um principiante e um utilizador experiente não é saber ler erros — é não ter medo deles. O erro é o Claude que o lê; tu só precisas de o entregar.

Bloco 2 — Refazer sem partir (refactoring)

Arrumar a casa sem mudar a casa

Refactoring é melhorar a organização interna de algo sem mudar o que ele faz — como arrumar uma gaveta caótica: fica tudo lá, mas encontrável.

Frases úteis: "este ficheiro está gigante, divide-o em partes lógicas", "simplifica isto sem mudar o comportamento"
A regra de segurança: commit antes de arrumar. Se a arrumação correr mal, voltas atrás num segundo
Depois da arrumação, verifica que tudo continua a funcionar como antes (o Claude ajuda: "confirma que nada mudou de comportamento")

Bloco 3 — Testes: o "será que funciona?" automático

Verificações que correm sozinhas

Um teste é um pequeno programa que verifica se o teu programa faz o que deve. Em vez de testares à mão de cada vez, os testes fazem-no por ti em segundos.

Pede: "escreve testes para isto" — o Claude cria as verificações adequadas
Pede: "corre os testes" — e vês logo o que passa ✅ e o que falha ❌
O ciclo virtuoso: alteraste algo → corres os testes → tudo verde → commit. É o "Verificar" do método, automatizado

Na prática: não precisas de saber escrever testes — precisas de ganhar o hábito de os pedir. "E escreve testes para isso" são cinco palavras que valem horas de dores de cabeça.

Bloco 4 — Entender e documentar o que já existe

O tradutor de código para português

Herdaste um site feito por outra pessoa? Tens uma pasta de scripts que já ninguém percebe? O Claude lê tudo e explica:

"Explica-me o que faz este projecto, como se eu não soubesse programar"
"O que acontece exactamente quando um cliente preenche este formulário?"
"Escreve um README que explique como isto funciona e como se usa"

Isto funciona ao contrário também: no fim de cada projecto teu, pede documentação. O teu "eu" de daqui a seis meses agradece.

Bloco 5 — Branches: experimentar sem estragar

O rascunho paralelo

Um branch (ramo) é uma cópia paralela do teu projecto onde podes experimentar à vontade. Se a experiência resultar, junta-se ao original; se falhar, deita-se fora — e o original nunca soube de nada.

Antes de uma experiência arriscada: "cria um branch para experimentarmos isto"
Gostaste do resultado: "junta este branch ao principal" (chama-se merge)
Não gostaste: "volta ao principal e apaga o branch" — zero consequências
Em equipas, a junção faz-se via PR (pull request) — um pedido de revisão onde outra pessoa aprova antes de entrar. O Claude prepara PRs por ti

Regra de bolso: mudança pequena e segura → directo no principal, com commit. Experiência grande ou arriscada → branch primeiro.

How-to 1 · Depurar

How-to 1 de 3 ~10 min

Resolver um erro de ponta a ponta

Vais provocar um erro de propósito na tua página do Módulo 2 — para perderes o medo em ambiente controlado.

1
Na pasta ~/treino-claude, com o Claude aberto, pede: "introduz um erro subtil na minha página — não me digas qual — para eu treinar depuração".
2
Abre a página no browser e observa o que está estragado (algo não aparece? um botão morreu?).
3
Descreve o sintoma ao Claude como descreverias a um técnico: "o título desapareceu", "a página ficou toda branca".
4
Deixa-o investigar e propor a correcção. Aprova e confirma no browser que voltou ao normal.
5
Fecha o ciclo: "faz um commit — erro corrigido".

How-to 2 · Testes

How-to 2 de 3 ~10 min

Pedir e correr os teus primeiros testes

Qualquer projecto serve — a página de treino, ou algo real teu.

1
Pergunta primeiro: "o que faria sentido testar automaticamente neste projecto?" — repara na resposta: ele identifica os pontos frágeis.
2
Pede: "escreve esses testes e corre-os". Aprova a criação dos ficheiros e a execução.
3
Lê o resultado: quantos passaram? Se algum falhar, é uma descoberta — pede a correcção.
4
Guarda o hábito com o projecto: "acrescenta ao CLAUDE.md: depois de qualquer alteração, correr os testes antes do commit".

How-to 3 · Branch

How-to 3 de 3 ~10 min

Uma experiência num branch — e a decisão final

Vais experimentar uma mudança visual grande sem qualquer risco para o que já tens.

1
Pede: "cria um branch chamado experiencia-visual e muda o design da minha página para algo completamente diferente — surpreende-me".
2
Vê o resultado no browser. Gostas?
3
Se sim: "junta este branch ao principal". Se não: "volta ao principal e apaga o branch".
4
Confirma: "em que branch estou e como está o histórico?" — deves perceber exactamente o que aconteceu. Sentiste? Experimentar deixou de ser arriscado.

← Módulo 2 Módulo 4 · Ensina truques ao teu Claude →