MÓDULO 1.3

🔄 Fluxo de Trabalho Inteligente

Quatro hacks para eliminar retrabalho e garantir que cada iteração com o Claude seja precisa, alinhada e verificada. A diferença entre um fluxo frustrante e um fluxo que acelera.

4
Hacks
80
Minutos
Base
Nível
Fluxo
Tipo
7

📋 Hack 7 — Plan Mode

O Plan Mode é a diferença entre um desenvolvedor que revisita o mesmo problema várias vezes e um que acerta na primeira tentativa. Ativado com Shift+Tab, o modo coloca o Claude em modo de leitura e planejamento — ele analisa, questiona e mapeia a abordagem completa antes de tocar uma linha sequer de código.

💡 Como o Plan Mode funciona

No Plan Mode, o Claude segue um protocolo rígido:

  • 1.
    Leitura completa: Lê todos os arquivos relevantes sem modificar nada.
  • 2.
    Perguntas de esclarecimento: Identifica ambiguidades e as pergunta antes de continuar.
  • 3.
    Mapeamento da abordagem: Descreve cada etapa do que vai fazer, em ordem.
  • 4.
    Aguarda aprovação: Não executa nada até você confirmar o plano.
  • 5.
    Execução aprovada: Implementa o plano exatamente como descrito e aprovado.

💻 Plan Mode na prática

# Ative com Shift+Tab antes de descrever a tarefa

[Plan Mode ATIVO]

"Adicione sistema de notificações em tempo real"

─── Claude planeja ─────────────────────────────

Lerei: socket.ts, api/events.ts, components/...

❓ WebSocket ou Server-Sent Events?

❓ Notificações persistem após reload?

Plano (após suas respostas):

1. Criar socket.ts com conexão WS

2. Adicionar evento 'notification' no server

3. Criar componente NotificationBell

4. Integrar no layout principal

Aprovado? (s/n)

Dica Prática

Use Plan Mode para qualquer tarefa que afete mais de 2 arquivos ou envolva mudanças arquiteturais. Para tarefas simples como corrigir um typo, o mode normal é suficiente. A regra: se você ficaria surpreso com uma escolha errada do Claude, ative o Plan Mode primeiro.

✓ O que FAZER

  • Use Plan Mode para features que impactam múltiplos arquivos
  • Responda todas as perguntas de esclarecimento do Claude antes de aprovar
  • Revise o plano completo antes de aprovar a execução
  • Peça para o Claude ajustar o plano se algo não estiver certo

✗ O que NÃO fazer

  • Deixar o Claude executar mudanças grandes sem plan mode
  • Aprovar o plano sem ler cada etapa proposta
  • Ignorar perguntas de esclarecimento — elas existem por razão
  • Usar plan mode para micro-tarefas que não precisam de validação
8

👨‍💻 Hack 8 — Dev Júnior

Há uma diferença fundamental entre dar um comando e apresentar um problema. Quando você trata o Claude como um dev júnior inteligente — descrevendo o problema, o contexto de negócio e o objetivo — e deixa ele raciocinar sobre a solução, a qualidade do output aumenta visivelmente. O Claude explicita suas suposições e você pode corrigi-las antes da implementação.

💡 Por que apresentar problemas funciona melhor

Quando você descreve um problema em vez de dar um comando:

  • O Claude considera múltiplas abordagens antes de escolher uma
  • Ele explicita as suposições que está fazendo — você pode corrigi-las antes do código
  • Considera edge cases e implicações que um comando direto ignora
  • Produz uma solução adequada ao contexto do negócio, não genérica

💻 Comando vs Problema — Comparação

✗ Comando direto (resultado mediano)

"Escreva uma função que

rastreie o crescimento de

usuários mensalmente."

✓ Apresentação do problema (resultado superior)

"Precisamos entender

por que o crescimento

desacelerou no Q3.

Como você abordaria

o rastreamento disso?"

// Claude responde ao problema:

"Para analisar desaceleração de crescimento no Q3,

sugiro rastrear: novos usuários/semana, churn rate,

retenção D7/D30, e atribuição por canal de aquisição.

Assumindo PostgreSQL como banco — correto?"

Dica Prática

Comece mensagens com "Como devemos..." ou "Qual seria a melhor abordagem para..." em vez de "Escreva...", "Crie..." ou "Faça...". Essa simples mudança de enquadramento ativa o modo de raciocínio colaborativo do Claude ao invés do modo de execução direta.

✓ O que FAZER

  • Descreva o problema de negócio, não a solução técnica desejada
  • Dê contexto sobre por que a funcionalidade é necessária
  • Valide as suposições que o Claude explicitar antes de prosseguir
  • Peça ao Claude para "pensar em voz alta" sobre trade-offs

✗ O que NÃO fazer

  • Especificar a implementação antes de descrever o problema
  • Ignorar as suposições que o Claude coloca — são pistas de ambiguidade
  • Forçar uma solução específica quando o Claude sugere alternativa melhor
  • Omitir contexto de negócio pensando que só o contexto técnico importa
9

❓ Hack 9 — Faça Perguntas

O Claude tende a fazer suposições e avançar quando encontra ambiguidade. Esse comportamento padrão gera retrabalho. A solução é explícita: instrua o Claude a fazer perguntas continuamente até estar 95% confiante de que entendeu exatamente o que precisa ser feito. Cinco minutos de alinhamento evitam uma hora de revisão.

💡 A instrução do 95%

Existem três formas de aplicar essa instrução:

Por sessão (ad-hoc)

"Antes de começar, faça perguntas até estar 95% confiante que entende o que preciso."

No CLAUDE.md (permanente)

Adicione ao CLAUDE.md: Sempre faça perguntas de esclarecimento antes de implementar qualquer feature até estar 95% confiante.

Por tarefa específica

"Antes de refatorar o sistema de auth, me faça todas as perguntas necessárias."

⚠️ Atenção

Se o Claude começa a implementar sem perguntar sobre pontos ambíguos, interrompa e diga: "Espere — que suposições você está fazendo? Tem alguma dúvida antes de continuar?" Cultivar esse hábito de perguntar é mais eficiente do que corrigir implementações erradas depois.

Dica Prática

Inclua no CLAUDE.md do projeto a instrução permanente de perguntar antes de agir. Assim, ela se aplica a todas as sessões automaticamente sem precisar redigitar. Combine com o Plan Mode (Hack 7) para projetos complexos — os dois trabalham em sinergia perfeita.

✓ O que FAZER

  • Instrua o Claude explicitamente a perguntar antes de implementar
  • Adicione a instrução de 95% de confiança no CLAUDE.md
  • Responda as perguntas com detalhes suficientes para eliminar ambiguidade

✗ O que NÃO fazer

  • Deixar o Claude avançar quando há ambiguidades óbvias no pedido
  • Responder as perguntas com "você que sabe" — seja específico
  • Achar que perguntas iniciais custam tempo — elas economizam muito mais
10

✅ Hack 10 — Autoverificação

O Claude, por padrão, avança na lista de tarefas sem verificar se o item anterior funcionou corretamente. Isso cria um efeito cascata: quando uma tarefa falha silenciosamente, as seguintes constroem sobre uma base quebrada. A autoverificação é o protocolo que quebra esse ciclo — verificação explícita em cada etapa antes de avançar.

💡 O protocolo de autoverificação

Para cada tarefa na lista, o Claude deve seguir esta sequência antes de avançar:

1
Construir — implementar a tarefa
2
Screenshot — capturar e verificar visualmente o resultado
3
DevTools — abrir e confirmar ausência de erros no console
4
Confirmar 95% — só avança quando está 95% confiante que a tarefa está correta

💻 Lista de tarefas com autoverificação

# Instrução para o Claude:

"Execute estas tarefas em ordem.

Após cada uma: tire screenshot, verifique

o console sem erros, e só avance quando

estiver 95% confiante que está correto.

# Tarefas:

[ ] 1. Criar componente LoginForm

[ ] 2. Adicionar validação de campos

[ ] 3. Integrar com endpoint /auth/login

[ ] 4. Adicionar feedback de erro ao usuário"

# Claude marca cada item ao verificar:

[✓] 1. LoginForm criado — screenshot OK, sem erros

[✓] 2. Validação adicionada — campos testados manualmente

[…] 3. Integrando endpoint... (em progresso)

Dica Prática

Combine autoverificação com o Plan Mode. No Plan Mode, o Claude cria a lista de tarefas com suas etapas de verificação incluídas. Quando você aprova e ele executa, cada tarefa já vem com o checkpoint de verificação embutido. Essa combinação é o fluxo mais robusto e confiável possível.

✓ O que FAZER

  • Inclua etapas de verificação explícitas em toda lista de tarefas
  • Instrua o Claude a usar screenshot + DevTools em cada etapa
  • Defina o threshold de 95% de confiança explicitamente
  • Combine com Plan Mode para a sequência mais robusta possível

✗ O que NÃO fazer

  • Deixar o Claude avançar para a próxima tarefa sem verificar a atual
  • Assumir que "se compilou, funcionou" — erros visuais e lógicos não são compilação
  • Revisar o resultado apenas no final de uma lista longa de tarefas
  • Ignorar erros no console do DevTools por parecerem menores

🎯 Resumo do Módulo 1.3

Hack 7 — Plan Mode: Shift+Tab ativa o modo de planejamento — o Claude pesquisa, pergunta e propõe o plano para sua aprovação antes de qualquer execução
Hack 8 — Dev Júnior: Apresente problemas, não comandos — o Claude raciocina melhor quando precisa chegar à solução por conta própria
Hack 9 — Faça Perguntas: Instrua o Claude a perguntar até ter 95% de confiança — 5 minutos de alinhamento economizam horas de revisão
Hack 10 — Autoverificação: Sequência construir → screenshot → DevTools → confirmar 95% antes de cada próxima tarefa elimina o efeito cascata de erros

🏆 Trilha 1 Concluída!

Você dominou os 10 hacks fundamentais do Claude Code. Agora tem a base para configurar qualquer projeto, gerenciar contexto eficientemente e trabalhar com um fluxo que elimina retrabalho. Pronto para o nível intermediário?