Fase 03 · Modos de desenvolvimento
Modos: Ask, Plan e Agent
Usar o modo certo para cada momento: entender sem editar, planejar antes de executar, executar com supervisão.
3.1 Ask / Chat — entender sem editar
Modo de leitura: a IA explora o código e responde, sem alterar nada. Use para:
- Entender um módulo desconhecido ("como funciona o fluxo de cobrança?")
- Investigar um bug antes de decidir a correção
- Avaliar impacto ("quais lugares chamam essa função?")
3.2 Plan — planejar antes de executar
A IA analisa o código e apresenta um plano de implementação para sua aprovação antes de qualquer mudança. É o modo mais importante para tarefas não triviais:
- Você revisa a abordagem antes de gastar tempo revisando código errado
- Erros de entendimento aparecem no plano, onde custam barato
- O plano aprovado vira o contrato da execução
Regra prática: mudou mais de um arquivo ou toca lógica de negócio? Começa em Plan. Ajuste pontual e óbvio? Pode ir direto.
3.3 Agent / Auto — executar com supervisão
A IA edita arquivos, roda comandos e testes. A supervisão é graduada por permissões:
- Aprovação por ação: você confirma cada edição/comando — bom no início.
- Auto-accept: a IA executa o plano aprovado sem parar a cada passo — bom quando já existe plano e testes.
- Sem permissões (yolo): só em ambiente descartável/sandbox. Nunca em produção ou repositório sem branch.
3.4 O fluxo recomendado
Explorar → Planejar → Executar → Revisar
- Explorar (Ask): a IA lê o código relevante e confirma o entendimento.
- Planejar (Plan): plano passo a passo; você corrige o plano, não o código.
- Executar (Agent): implementação com testes rodando.
- Revisar (você): diff completo, testes, e a pergunta "eu aprovaria esse PR de um colega?"
Nomes por ferramenta
Claude Code: Plan Mode, modo normal e auto-accept. Cursor: Ask,
Agent e Manual. Os conceitos são os mesmos; só o rótulo muda.
Material de apoio
Checklist da fase
Marque cada item ao concluir. O progresso fica salvo neste navegador.