Cada grande avanço no desenvolvimento de software mudou a forma como as equipes expressam sua intenção. O Waterfall dependia de documentação pesada porque mudanças de rumo eram lentas. O Agile reduziu a papelada porque iterar era barato e as equipes aprendiam em movimento.

Agentes precisam de um estilo de planejamento próprio. Em vez de um processo com etapas rígidas que congela a intenção cedo demais, eles favorecem uma abordagem de planejamento que forneça direção logo de início e ao mesmo tempo se mantenha viva e ancorada no trabalho real.

#O que os agentes precisam para serem eficazes

Os agentes se mantêm no caminho certo quando conseguem expandir o problema em linguagem clara. Eles fazem perguntas, removem suposições e traçam o caminho antes de tocar no código. Seu treinamento reforça esse comportamento.

Quando o plano é explícito e adaptável, eles conseguem assumir períodos de trabalho mais longos sem se desviar. É por isso que o planejamento para agentes se beneficia de uma abordagem iterativa em vez de uma especificação fixa. O plano se torna parte do ciclo.

À medida que o agente descobre restrições, ele atualiza o plano. À medida que o usuário refina a intenção, o plano muda novamente. Esse ritmo se encaixa muito melhor na natureza do desenvolvimento orientado a agentes do que em fases de planejamento distintas herdadas de épocas anteriores.

#Como o Cursor projeta o planejamento para a inteligência dos agentes

Criamos o Plan Mode com base em nosso entendimento de como equipes de desenvolvimento de software produzem mais usando agentes. É uma abordagem de planejamento poderosa e de uso geral, projetada especificamente para desenvolvimento com agentes.

O Plan Mode dá aos agentes um lugar para fazer perguntas, analisar a codebase, propor um caminho e refiná-lo com o usuário. Ele pode permanecer leve para tarefas rápidas ou se tornar um artefato canônico e de longa duração. O processo segue cinco etapas:

1. Perguntas de esclarecimento. O agente faz perguntas que removem ambiguidade. Times ágeis lidam com isso por meio de trocas rápidas. O desenvolvimento guiado por especificação (SDD) move isso para uma etapa formal de requisitos. O Plan Mode persegue o mesmo objetivo de reduzir ambiguidade, mas permite que o agente conduza diretamente o questionamento, o que combina melhor com o ritmo do trabalho com agentes.

2. Pesquisa. O agente examina a codebase para identificar os pontos com os quais precisará interagir. Fluxos de trabalho mais antigos tratavam isso como uma fase de design separada. O Plan Mode incorpora isso diretamente no raciocínio do agente.

3. Rascunhando o plano. O agente escreve um arquivo de plano editável que explica as mudanças e as etapas para implementá-las. O SDD congela isso como uma especificação fixa. No desenvolvimento ágil, a documentação muitas vezes acaba se desatualizando. O Plan Mode mantém o plano vivo para que você e o agente possam refiná-lo à medida que surgem novas informações.

4. Executando o trabalho. O agente trabalha passo a passo e marca as tarefas concluídas conforme avança. Métodos tradicionais separam planejamento e implementação. O Plan Mode trata ambos como um só processo, para que o plano possa se adaptar.

5. Revisando o plano. Quando as coisas saem do trilho, o plano também é o ponto de reinício. Em vez de remendar o comportamento com prompts de acompanhamento, as equipes podem reverter o trabalho, refinar o plano e executá-lo novamente. Isso mantém a intenção explícita e produz resultados mais limpos do que tentar direcionar um agente em plena execução.

Os planos são salvos no seu workspace como arquivos com controle de versão em .cursor/plans/. Eles ficam ao lado do seu código, rastreados no Git como qualquer outro artefato de projeto. Você pode ver o que mudou, quando mudou e fazer rollback se necessário.

#Primitivas de planejamento flexíveis

As equipes organizam suas intenções de maneiras diferentes. Algumas dependem de requisitos formais. Outras usam projetos em evolução ou fluxos de trabalho em fases. Um framework de planejamento deve ser flexível para acomodar a forma como as equipes preferem trabalhar.

Isso importa ainda mais agora porque o terreno está mudando rapidamente. Waterfall definiu o planejamento por décadas. Agile moldou as equipes por mais duas. A inteligência dos agentes está avançando em um prazo muito mais curto. Qualquer processo fixo vai envelhecer rapidamente.

É por isso que criamos nossa abordagem em torno de primitivas simples que você pode moldar como quiser. Você pode usar Agent Skills para definir a estrutura de planejamento que sua equipe prefere, e o agente seguirá essa estrutura de forma consistente.

Algumas equipes codificam um fluxo de trabalho mais formal, guiado por especificação, como uma habilidade de agente. Outras definem habilidades que criam planos mais leves, que evoluem à medida que o trabalho avança. Como os planos são moldados por habilidades em vez de um processo fixo, as duas abordagens se encaixam naturalmente no Plan Mode.

A questão não é que nossa abordagem de planejamento seja retrocompatível, embora seja. É que ela é voltada para o futuro. Um framework construído sobre um pequeno conjunto de primitivas compartilhadas dá às equipes espaço para evoluir seus métodos à medida que agentes assumem tarefas que estilos de planejamento mais antigos nunca previram.

#Olhando adiante

O tamanho e a complexidade dos trabalhos que os agentes conseguem executar estão aumentando rapidamente. Como construímos o Plan Mode em cima de primitivas simples, já com agentes em mente, ele consegue acompanhar esses avanços.

Estamos testando agentes que permanecem em um projeto por execuções prolongadas, mantêm o contexto entre sessões e criam subagentes quando uma tarefa se beneficia de trabalho em paralelo. Em breve, vários desenvolvedores poderão entrar na mesma sessão, ver como o plano evolui e orientar o agente à medida que o projeto se desenrola. Nosso objetivo é ampliar o escopo do que os agentes conseguem realizar, preservando os mesmos elementos centrais que equipes de software sempre buscaram no planejamento: clareza, visibilidade e controle por parte do usuário.