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