📝 O que é modo plano
Novo aqui? Modo plano é um jeito de pedir ao agente: "antes de fazer qualquer coisa, me mostra o que você pretende fazer". Ele escreve o passo a passo, você lê, e só depois de aprovar ele executa de verdade. É a rede de segurança mais simples do curso.
Pensa assim: é a diferença entre um pedreiro que chega e já quebra a parede, e um que primeiro te mostra a planta, explica o que vai derrubar e o que vai levantar, e só pega a marreta depois do seu "pode ir". No dia a dia com um agente de código, essa pausa custa poucos segundos e evita o pior tipo de susto: descobrir depois que ele apagou, sobrescreveu ou publicou algo que você não pediu. Quanto mais nova a relação de confiança com o agente, mais vale manter esse hábito ligado — com o tempo, você aprende em quais tarefas pode relaxar.
💡 Conceito Principal
- •Plano ≠ execução. Nada muda no computador até você aprovar.
- •Você pode aprovar, editar ou cancelar o plano.
- •O plano é sempre texto — nenhum arquivo (o nome que se dá a qualquer documento salvo no computador, seja texto, imagem ou planilha) é criado, apagado ou alterado enquanto ele só está sendo lido.
🔍 Ver por dentro
Enquanto o modo plano está ativo, o agente só está "pensando em voz alta" — o texto do plano fica na conversa, na tela, e nada é gravado no disco do seu computador nem enviado para a internet além do que já é normal na conversa em si. Não há custo extra por usar modo plano: você só está pedindo pra ver antes de autorizar. É o mesmo agente, a mesma sessão — só que com um freio de mão puxado até você soltar.
🔄 O ciclo completo: pedir, revisar, aprovar
Veja o ciclo do começo ao fim — é a mesma sequência em toda tarefa feita em modo plano.
Legenda: o ciclo pode fechar em aprovação (executa de verdade) ou voltar para um novo plano corrigido — nunca executa sem passar pela sua revisão.
Repare que o passo 2 é o único em que o agente "trabalha" antes da sua aprovação — e mesmo assim, esse trabalho é só de leitura e raciocínio: ele pode abrir arquivos existentes pra entender o projeto, mas ainda não grava nada novo. É só no passo 4a, depois do seu sinal verde, que os comandos (as instruções que o agente manda o computador executar, como criar um arquivo ou instalar um programa) realmente rodam. Se você corrige o plano no passo 4b, o agente reescreve a proposta do zero considerando seu ajuste — ele não tenta "emendar" o plano antigo escondido, o novo plano aparece inteiro de novo pra sua revisão.
💡 Dica Prática
Se o plano parece bom mas incompleto, não precisa reprovar tudo — diga exatamente o que falta ("inclui também um teste") e o agente ajusta só aquele ponto, sem jogar fora o resto do raciocínio.
🛠️ Erro comum
Fechar a janela do terminal (o programa de texto onde você conversa com o agente por comandos) achando que isso "cancela" o plano com segurança. Na real, é melhor sempre responder explicitamente "não" ou pedir ajuste — fechar no meio pode deixar a sessão em um estado incerto na próxima vez que você abrir.
⏰ Quando usar (e quando não precisa)
Usar sempre trava o ritmo em tarefas pequenas; nunca usar é arriscado em tarefas grandes. O equilíbrio depende do risco e da reversibilidade da tarefa — quanto mais difícil for desfazer o que o agente vai fazer, mais vale a pausa de revisar o plano antes.
✓ Use modo plano
- ✓Tarefas que mexem em muitos arquivos
- ✓Qualquer coisa que apaga ou publica
- ✓Instalar um programa novo ou mudar configuração do sistema
- ✓A primeira vez que você pede um tipo de tarefa novo
— Opcional
- •Tarefas pequenas e fáceis de desfazer
- •Perguntas que não mudam nada ("me explica isso")
- •Uma tarefa que você já pediu várias vezes e conhece o resultado
Como o risco cresce com o tamanho da tarefa
Ler ou explicar algo
Nada muda no computador — modo plano é dispensável.
Criar um arquivo novo isolado
Fácil de apagar se der errado — modo plano ajuda, mas não é crítico.
Alterar vários arquivos existentes
Difícil de reverter manualmente — use modo plano.
Apagar, sobrescrever ou publicar algo pra internet
Pode ser irreversível — modo plano é obrigatório, sem exceção.
✏️ Editar o plano antes de aprovar
Você pode pedir ajuste no plano ("faz sem o passo 3", "usa outro nome de pasta" — pasta é o espaço onde os arquivos ficam organizados, como uma gaveta dentro do computador) antes de aprovar — corrigir o plano é muito mais barato do que desfazer uma execução já feita.
Editar não é só cortar passo — também dá pra pedir mais detalhe ("qual arquivo exatamente você vai mudar?"), trocar a ordem ("faz o backup antes"), ou pedir uma alternativa mais segura ("em vez de sobrescrever, cria uma cópia nova"). O agente reescreve o plano considerando seu pedido e mostra a versão atualizada — você segue no controle até dizer "pode ir".
💡 Dica Prática
Leia o plano de cima a baixo antes de decidir. Um passo que parece estranho merece uma pergunta antes da aprovação, não depois.
🛠️ Erro comum
Aprovar rápido demais só pra "não travar o trabalho". Aprovar em 2 segundos sem ler anula toda a proteção do modo plano — se você não vai ler o plano, tanto faz ter pedido ele ou não.
🎯 Sinais de que o plano precisa de ajuste
Alguns sinais indicam que vale pedir revisão antes de aprovar. Com a prática, esse julgamento fica rápido — no começo, é melhor pecar pelo excesso de cuidado.
✓ Plano bom
- ✓Passos específicos, com nome de arquivo/pasta
- ✓Só toca no que você pediu
- ✓Explica o "porquê" de cada passo, não só o "o quê"
✗ Plano pra revisar
- ✗Passos vagos ("ajustar arquivos necessários")
- ✗Cita apagar/sobrescrever algo que você não pediu
- ✗Mexe em pasta ou projeto diferente do que você mencionou
Legenda: a mesma pergunta simples decide o caminho — o plano descreve exatamente o que eu pedi, nem mais nem menos?
🏋️ Praticar: peça algo pequeno em modo plano
Novo aqui? Comando é a frase curta que você digita no terminal — a janela de texto onde você conversa com o agente por escrito, sem menus nem botões — pra pedir algo específico. Nada fixa mais que um exemplo real. Peça uma tarefa pequena em modo plano e observe o plano gerado.
Objetivo: ver um plano real antes de aprovar algo pela primeira vez. Como verificar: o agente deve mostrar "vou criar o arquivo notas.txt com..." antes de qualquer coisa acontecer — só executa depois do seu OK.
🛠️ Erros comuns nesse exercício
- •Não achar onde o modo plano se ativa — em geral é uma tecla de atalho ou um comando específico da ferramenta; se não souber qual, pergunte direto ao próprio agente "como eu ativo modo plano aqui?".
- •Ver "Permission denied" (permissão negada) e achar que travou pra sempre — normalmente é só o sistema pedindo confirmação extra antes de deixar o agente escrever no disco; leia a mensagem completa antes de entrar em pânico.
- •Fechar a janela achando que "cancelou" — o jeito certo de cancelar é responder "não" ou "cancela" dentro da própria conversa.
🔍 Por dentro
Repita esse exercício mais duas ou três vezes com pedidos diferentes antes de seguir para o módulo 0.6 — familiaridade com o ciclo é o que transforma "regra decorada" em hábito automático. Tente também um pedido levemente arriscado (por exemplo, "apague o arquivo notas.txt") só pra ver como o plano fica mais explícito quando a ação é mais séria.