M2 · O método que muda tudo

Em palavras simples

Imagina que contratas um empreiteiro para remodelar a cozinha. Não lhe dizes só "faz". Primeiro ele vê a casa (Explorar), depois mostra-te o orçamento e o desenho (Planear), depois faz a obra contigo a acompanhar (Programar), e no fim assina-se o auto de entrega (Consolidar). Trabalhar com o Claude Code é exactamente isto.

Bloco 1 — O ciclo agêntico: como o Claude trabalha

O que acontece por baixo, sempre

Quando dás uma tarefa ao Claude Code, ele repete um ciclo de três passos até terminar:

1. Reunir contexto — lê os ficheiros relevantes, percebe como o teu projecto está organizado
2. Agir — edita ficheiros, corre comandos, cria coisas (sempre com a tua aprovação)
3. Verificar — confirma que o resultado funciona; se não, volta ao passo 1

Porque importa: quando percebes este ciclo, percebes porque é que dar bom contexto (passo 1) é o que mais influencia a qualidade do resultado. O resto do módulo ensina-te a alimentar bem este ciclo.

Bloco 2 — Explorar: dar contexto e o ficheiro CLAUDE.md

A memória permanente do teu projecto

CLAUDE.md é um ficheiro de texto simples que vive na pasta do teu projecto. O Claude lê-o automaticamente no início de cada sessão — é onde escreves o que ele deve saber sempre:

O que é o projecto e para que serve
Regras tuas ("responde sempre em português", "nunca apagues nada sem perguntar")
Como se testam e correm as coisas neste projecto

Não precisas de o escrever à mão: o comando /init pede ao Claude que analise o projecto e o crie por ti.

Na prática: sem CLAUDE.md, cada sessão começa com o Claude amnésico. Com CLAUDE.md, ele "chega já ensinado". É o investimento com melhor retorno de todo o curso.

Bloco 3 — Planear: o Plan mode

Ver o orçamento antes da obra

O Plan mode é um modo especial em que o Claude só pode ler e pensar — não pode alterar nada. Ele estuda o problema, desenha um plano e apresenta-to. Só depois de aprovares é que começa a executar.

Para activar: carrega em Shift+Tab dentro da sessão (alterna os modos) ou escreve /plan
Usa-o sempre que a tarefa for grande, delicada ou vaga — "reorganiza-me isto tudo", "muda o design do site"
Para tarefas pequenas e óbvias ("corrige este typo"), não é preciso — seria burocracia

Regra de bolso: se a tarefa te demoraria mais de uma hora a fazer à mão, começa em Plan mode. Corrigir um plano custa segundos; desfazer uma obra mal feita custa tardes.

Bloco 4 — Programar: conduzir a execução

Tu aprovas, ele executa

Durante a execução, o Claude vai-te mostrando cada alteração antes de a fazer:

As alterações aparecem como "antes e depois" — vermelho é o que sai, verde é o que entra
Não precisas de perceber o código: lê a explicação que ele dá e vê se bate certo com o que pediste
Podes sempre responder com correcções: "sim, mas mantém a cor original", "não, prefiro que…"
Esc interrompe a qualquer momento — tu tens sempre o travão de mão

Bloco 5 — Consolidar: git para totós

Pontos de gravação, como nos videojogos

O git é um sistema que guarda "fotografias" do teu projecto ao longo do tempo. Cada fotografia chama-se um commit. Se algo correr mal amanhã, voltas à fotografia de ontem.

A boa notícia: não precisas de aprender git — pedes ao Claude e ele trata dos comandos
No fim de cada tarefa concluída, diz: "faz um commit com o que acabámos de fazer"
O hábito certo: uma tarefa terminada = um commit. Nunca acumules dias de trabalho sem gravar

Na prática: "Consolidar" fecha o ciclo do método. Explorar deu o contexto, Planear evitou asneiras, Programar fez a obra, Consolidar garante que nunca perdes o que ficou bem feito.

Bloco 6 — O modelo certo para cada fase

Economia de modelos

Lembras-te do Haiku/Sonnet/Opus do Módulo 1? O método diz-te quando usar cada um:

Planear algo difícil → modelo forte (Opus): é aqui que o raciocínio conta
Executar o dia-a-dia → Sonnet: o cavalo de trabalho
Tarefas repetitivas simples → Haiku: rápido e barato

Muda a qualquer momento com /model. Se não quiseres pensar nisto, deixa o modelo por omissão — está bem escolhido.

How-to 1 · CLAUDE.md

How-to 1 de 3 ~5 min

Criar o CLAUDE.md do teu projecto com /init

Vais dar memória permanente à tua pasta de treino (ou a um projecto real teu, se já tiveres).

1
No Terminal, entra na pasta e arranca o Claude:
```
cd ~/treino-claude
claude
```
2
Escreve o comando:
```
/init
```
O Claude analisa a pasta e propõe um ficheiro CLAUDE.md. Aprova a criação.
3
Pede-lhe agora um acrescento teu: "Acrescenta ao CLAUDE.md: responde sempre em português de Portugal e pergunta antes de apagar seja o que for."
4
Sai (/exit), arranca de novo (claude) e pergunta: "que regras conheces deste projecto?" — ele deve citar as tuas regras. A memória está viva.

How-to 2 · Plan mode

How-to 2 de 3 ~15 min

Uma tarefa de ponta a ponta em Plan mode

Vais viver o método completo numa tarefa pequena mas real: criar uma página pessoal simples.

1
Na sessão do Claude, carrega em Shift+Tab até aparecer a indicação de plan mode (ou escreve /plan).
2
Pede: "Quero uma página web simples de apresentação pessoal: o meu nome, o que faço e um contacto. Explora o que já existe nesta pasta e propõe um plano."
3
Lê o plano com atenção. Não gostas de algo? Diz — "prefiro fundo claro", "sem fotografia". Ele refaz o plano sem tocar em nada.
4
Quando o plano estiver bom, aprova. O Claude sai do Plan mode e executa, pedindo permissão a cada alteração.
5
No fim, pede: "abre a página no browser para eu ver". Verifica o resultado — o passo "Verificar" do ciclo és tu a fazê-lo.

How-to 3 · Commit

How-to 3 de 3 ~5 min

Consolidar: o teu primeiro commit

A página está feita — vamos gravar a "fotografia" para nunca a perderes.

1
Ainda na sessão, pede: "Prepara esta pasta para usar git, se ainda não usar, e faz um commit com tudo o que fizemos, com uma mensagem clara em português."
2
Aprova os comandos que ele propuser (git init, git add, git commit).
3
Confirma perguntando: "mostra-me o histórico de commits" — deves ver a tua primeira fotografia, com data e mensagem.
4
Fixa o hábito: de agora em diante, toda a tarefa terminada acaba com "faz um commit".

Leva isto contigo

Cheat-sheet imprimível: o método em 1 página — o ciclo, o fluxo e que modelo usar em cada fase.

🖨️ Cheat-sheet M2

← Módulo 1 Módulo 3 · Trabalho do dia-a-dia →

O método que muda tudo: Explorar → Planear → Programar → Consolidar