🤖 Plan e Loop Modes

Modo que faz o Claude pensar e propor um plano antes de executar qualquer acao.

Evita erros caros e retrabalho ao planejar primeiro.

Shift+Tab para ativar; plano visivel antes da execucao.

Criterios para decidir se plan mode compensa ou se execucao direta e mais rapida.

Nem toda tarefa precisa de plano; usar sem necessidade desperdiça tokens.

Complexidade, risco, numero de arquivos afetados.

Os componentes que formam um bom plano: objetivo, passos, dependencias, riscos.

Saber ler um plano te permite avaliar se ele vai funcionar antes de aprovar.

Steps, file list, risk assessment, order of operations.

O fluxo de aprovacao onde voce revisa o plano e pode ajustar antes de rodar.

E o ponto de controle: voce decide se executa, modifica ou rejeita.

Approve, reject, refine; feedback loop antes da acao.

Tecnica de pedir ajustes no plano multiplas vezes ate ele ficar ideal.

Um plano refinado economiza horas de correcao depois.

Multi-turn planning; plano como draft vivo.

Erros frequentes: aprovar sem ler, planejar demais, ignorar plano e executar direto.

Reconhecer anti-patterns te mantem no caminho produtivo.

Over-planning; rubber-stamp approval; plan drift.

Estrutura de plano para implementar uma funcionalidade completamente nova.

Features novas sao onde plan mode mais brilha: evita arquitetura errada.

Scoping; interface first; test plan.

Como planejar uma refatoracao segura com cobertura de testes e rollback.

Refactors sem plano viram bolas de neve; com plano, sao cirurgicos.

Strangler pattern; test-first refactor; incremental steps.

Plano para diagnosticar a causa raiz, corrigir e validar sem regressoes.

Bug fixes apressados criam novos bugs; o plano disciplina o fluxo.

Reproduce first; root cause; regression test.

Tecnica de quebrar uma tarefa grande em passos atomicos e independentes.

Tarefas atomicas sao mais faceis de verificar e reverter.

Atomic steps; single responsibility; verifiable output.

Identificar quais passos dependem de outros para definir a ordem correta.

Dependencias erradas = trabalho jogado fora e conflitos.

DAG de tarefas; critical path; blockers.

Como estimar tokens, tempo e iteracoes que um plano vai consumir.

Permite decidir se vale rodar ou se e melhor simplificar o plano.

Token budget; iteration count; complexity heuristics.

Modo que permite ao Claude executar, verificar resultado e iterar automaticamente.

Automatiza o ciclo edit-test-fix que consome horas no modo manual.

--dangerously-skip-permissions; auto-accept; iteration limit.

Criterios para loop mode vs modo interativo normal com aprovacao por passo.

Loop mode sem criterio pode gastar tokens ou fazer mudancas indesejadas.

Confianca no outcome; reversibilidade; custo de supervisao.

Mecanismos para impedir que o loop cause danos: allowedTools, max turns, git worktree.

Seguranca e o que permite confiar no loop e sair pra tomar cafe.

allowedTools; permission scopes; worktree isolation.

Ferramentas para observar o que o loop esta fazendo: logs, diff, test output.

Monitorar permite intervir antes de problemas se acumularem.

Terminal watch; git diff --stat; CI status.

Criterios de parada: testes passando, linter limpo, diff estavel.

Loop infinito = tokens queimados; criterio claro = eficiencia.

Exit conditions; convergence; diminishing returns.

Diferencas entre loop mode local e agentes em background (GitHub Actions, etc).

Cada abordagem tem trade-offs de custo, velocidade e controle.

Local vs remote; latency; cost per iteration.

Rodar testes, corrigir falhas, rodar de novo ate tudo passar.

O pattern mais comum e mais util do loop mode.

pytest/jest loop; error parsing; auto-fix.

Rodar linter, corrigir warnings, re-rodar ate zero erros.

Limpar lint de codebase inteiro em minutos, nao horas.

eslint --fix; black/ruff; iterative cleanup.

Migrar APIs, dependencias ou versoes arquivo por arquivo com validacao.

Migracoes sao tediosas pra humanos, perfeitas pra loops.

File-by-file; type-check gate; incremental commit.

Processar, transformar e validar datasets iterativamente.

Dados sujos precisam de multiplas passadas; loop faz isso sem voce.

Schema validation; data cleaning passes; assertion gates.

Gerar docs, validar links, atualizar exemplos ate tudo consistente.

Docs desatualizados matam projetos; loop mantém sincronizado.

Docstring sync; link checker; example runner.

Combinar criterios de saida: testes + lint + types + build tudo verde.

O loop composto e o mais parecido com CI/CD rodando localmente.

Multi-gate loop; combined exit criteria; script orchestration.

O fluxo ideal: plan mode primeiro, loop mode pra executar, review humano no fim.

E o padrao de ouro para tarefas complexas com Claude Code.

Three-phase pipeline; handoff points; review gate.

Como transicionar do plano aprovado para o loop sem perder contexto.

Handoff mal feito faz o loop ignorar partes do plano.

Context preservation; explicit instructions; checkpoint.

Estrategias para usar plan+loop em projetos com dezenas de arquivos.

Projetos grandes exigem decomposicao; sem ela, o loop se perde.

Phased execution; module boundaries; progressive disclosure.

Coordenar mudancas em multiplos arquivos mantendo consistencia.

A maioria das features toca varios arquivos; orquestrar e essencial.

Cross-file consistency; import graphs; batch edits.

Como desfazer o trabalho do loop quando algo deu errado: git, worktrees, stash.

A seguranca de poder reverter e o que permite arriscar mais no loop.

git reset; worktree discard; incremental commits.

Exemplos reais de pipelines plan+loop em projetos de producao.

Ver casos concretos solidifica o entendimento do fluxo.

Real-world patterns; lessons learned; metrics.

A mudanca de paradigma: de assistente que responde pra agente que age.

Entender a filosofia e o que permite usar os modos com fluencia.

Agentic vs assistive; autonomy spectrum; intent-driven.

Como delegar tarefas ao agente sem microgerenciar nem abandonar.

Delegacao e a skill humana que mais escala com IA agentica.

Clear intent; success criteria; scope boundaries.

A diferenca entre revisar o resultado e controlar cada passo.

Micro-management mata a produtividade; revisao garante qualidade.

Output review; trust but verify; spot checks.

Como ajustar o nivel de confianca no agente conforme experiencia acumula.

Confianca demais = bugs; confianca de menos = lentidao.

Progressive trust; track record; domain-specific confidence.

Como medir se voce esta de fato mais produtivo com agentic coding.

Sem metricas, voce nao sabe se esta evoluindo ou so gastando tokens.

Tasks/day; time-to-merge; rework rate; cost per task.

A transicao mental de "eu codifico" para "eu dirijo e reviso".

O maior bloqueio nao e tecnico, e mental. Quem muda o mindset dispara.

Director mindset; let go of typing; focus on outcomes.