MODULO 2.8

💬 AskUserQuestion e Interacao com Usuario

Quando Claude precisa de informacoes adicionais, ele pode perguntar ao usuario. Aprenda quando perguntar, como formular questoes efetivas e quando prosseguir sem perguntar.

6
Topicos
30
Minutos
Pratico
Nivel
UX
Tipo
1

❓ Quando Perguntar ao Usuario

Claude Code prefere agir sobre perguntar, mas existem situacoes onde perguntar e a melhor opcao.

✓ Pergunte quando...

  • ✓ Informacao e ambigua ou critica
  • ✓ Escolha afeta arquitetura significativamente
  • ✓ Credenciais ou secrets sao necessarios
  • ✓ Acao e irreversivel

✗ Nao pergunte quando...

  • ✗ Pode inferir do contexto
  • ✗ Escolha e trivial/reversivel
  • ✗ CLAUDE.md ja define a resposta
  • ✗ Usuario ja foi claro no pedido

💡 Principio: Agir > Perguntar

Se voce pode fazer uma escolha razoavel e a acao e reversivel, faca. E melhor agir e ajustar do que interromper o fluxo com perguntas desnecessarias.

2

📝 Formulando Perguntas Efetivas

Uma boa pergunta e especifica, contextualizada e oferece opcoes quando apropriado.

✗

Pergunta Ruim

"Como voce quer que eu faca isso?"

Vaga, sem contexto, sem opcoes

✓

Pergunta Boa

"Para autenticacao, prefere OAuth 2.0 (mais seguro, requer setup) ou JWT simples (mais rapido, menos features)? Seu projeto atual nao tem auth."

Contexto, opcoes claras, trade-offs explicitos

📋 Anatomia de uma Boa Pergunta

  1. 1 Contexto: O que voce ja sabe sobre a situacao
  2. 2 Opcoes: Alternativas claras (quando aplicavel)
  3. 3 Trade-offs: Pros e contras de cada opcao
  4. 4 Recomendacao: Sua sugestao (se tiver)
3

🔐 Confirmacao de Permissoes

Em modo Ask, Claude pede confirmacao antes de executar certas acoes. Entenda o fluxo de confirmacao.

Acoes que Requerem Confirmacao (Ask Mode)

Escrita de Arquivos

Write e Edit pedem confirmacao antes de modificar

Comandos Bash

Comandos que nao estao na whitelist

Operacoes Git

Commits, pushes e outras acoes de versionamento

Acoes Externas

WebFetch, instalacao de pacotes

⚡ Bypass e YOLO Mode

Em modos mais permissivos, confirmacoes sao reduzidas ou eliminadas:

  • Bypass: Comandos na whitelist rodam sem perguntar
  • YOLO: Tudo roda sem confirmacao (use com cuidado)
4

🎯 Evitando Perguntas Excessivas

Perguntas demais interrompem o fluxo e frustram o usuario. Maximize valor por pergunta.

Estrategias para Reduzir Perguntas

  • 1
    Use contexto do projeto

    CLAUDE.md, package.json, estrutura de pastas

  • 2
    Infira de padroes existentes

    Como o codigo atual faz X? Siga o mesmo padrao

  • 3
    Agrupe perguntas relacionadas

    Uma pergunta com multiplos itens > varias perguntas

  • 4
    Faca escolha razoavel e explique

    "Usei X porque Y. Posso mudar se preferir."

⚠️ Anti-Pattern

Nao faca uma pergunta, espere resposta, e imediatamente faca outra pergunta relacionada. Se precisa de varias informacoes, pergunte tudo de uma vez.

5

📋 Usando CLAUDE.md para Reduzir Perguntas

Um CLAUDE.md bem configurado elimina a necessidade de muitas perguntas ao definir preferencias antecipadamente.

📄 O que Documentar no CLAUDE.md

  • • Stack tecnologico do projeto
  • • Convencoes de codigo
  • • Estrutura de pastas
  • • Comandos de build/test
  • • Preferencias de estilo
  • • Bibliotecas preferidas

Exemplo: Evitando Perguntas com CLAUDE.md

# Sem CLAUDE.md, Claude perguntaria:

"Qual framework de teste usar? Jest, Mocha, ou Vitest?"

# Com CLAUDE.md configurado:

## Testing

Use Vitest para todos os testes. Coverage minimo 80%.

6

🔄 Feedback Loop com Usuario

Alem de perguntas explicitas, mantenha um feedback loop constante mostrando progresso e resultados.

📊

Mostrar Progresso

Indique o que esta fazendo antes de fazer. "Vou analisar os testes..."

✅

Confirmar Resultados

Apos completar, resuma o que foi feito e resultados.

🔄

Oferecer Ajustes

"Fiz X. Quer que eu ajuste algo ou prossiga com Y?"

💡 Comunicacao Proativa

Bom feedback nao e so responder perguntas - e antecipar o que o usuario quer saber e fornecer essa informacao proativamente.

📋 Resumo do Modulo

✓
Agir > Perguntar - so pergunte quando realmente necessario
✓
Perguntas efetivas - contexto, opcoes, trade-offs
✓
Use CLAUDE.md - pre-define respostas comuns
✓
Agrupe perguntas - evite interrupcoes repetidas
✓
Feedback proativo - mostre progresso e resultados

Fim da Trilha 2!

Voce completou todos os modulos de Comandos e Ferramentas. Proximo: Trilha 3 - Avancado