O Cursor escreveu o plano.Verifique-o antes de construir.

O que faz o Plan Mode do Cursor

No Plan Mode, o agente não começa por editar ficheiros. Estuda o seu código, faz-lhe perguntas quando o pedido não é claro e escreve um plano que pode editar antes de se construir seja o que for. Passa para ele com Shift+Tab no campo do Agent.

O plano é o ponto em que uma suposição errada é mais barata de corrigir. Lê-lo com atenção leva alguns minutos; desfazer um plano errado já transformado em código leva muito mais.

Onde o Cursor guarda o plano

Por predefinição, o Cursor guarda os planos como ficheiros Markdown na sua pasta pessoal. A documentação do Cursor diz “home directory” e não indica o caminho exato, por isso a forma mais segura de saber onde está um plano é usar Save to workspace.

Save to workspace põe o plano dentro do projeto. É a definição a preferir: o plano fica junto do código, você e a sua equipa podem encontrá-lo, e pode fazer-se commit dele como qualquer outro ficheiro.

Leia e comente o plano no DotMD

Os passos são os mesmos de qualquer plano escrito por um agente.

1. Adicione a pasta

   Prima ⌘O e escolha a pasta do projeto. Um plano guardado no workspace aparece na barra lateral, formatado com títulos, listas, tabelas e diagramas.

2. Selecione um passo e comente

   Selecione a passagem e prima ⌥⌘M. Escreva o que deve mudar. Os comentários ficam ligados às suas linhas e são guardados pelo DotMD, não no ficheiro do plano.

3. Entregue-os ao agente

   No chat do Cursor escreva: “Go through my comments in DotMD.” O agente lê-os, corrige o plano e devolve cada comentário com uma nota.

Ligue o Cursor uma só vez

O Cursor fala com o DotMD por MCP. Ative o servidor no DotMD em Settings → MCP e depois acrescente isto ao ~/.cursor/mcp.json do Cursor:

{
  "mcpServers": {
    "dotmd": { "type": "http", "url": "http://127.0.0.1:8089/mcp" }
  }
}

O servidor escuta apenas no seu Mac. O guia do Cursor tem a configuração completa, incluindo o Visual Studio Code.

Verifique o que o agente mudou

Depois de o agente corrigir os seus comentários, cada correção é mostrada no plano junto ao comentário a que responde: o texto antigo a vermelho, o novo a verde. Com Accept fica com as boas, com Reopen devolve as restantes com uma nota sobre o motivo. O DotMD também lista as alterações que ninguém pediu em Other changes, onde se escondem as surpresas de um agente. Quando já não há nada a mudar, Approve.

Mais sobre este ciclo: Rever alterações.

O que procurar num plano

É fácil aprovar um plano com um aceno. Três perguntas tornam a leitura útil:

• Falta alguma coisa? Testes, uma migração, uma atualização da documentação. Os agentes tendem a planear o código e a esquecer o que o rodeia.
• A ordem está certa? Um passo que depende de um posterior é um bug no plano.
• O âmbito está certo? Procure ficheiros ou áreas em que não pediu ao agente para tocar e comente-os.

Comente cada um na linha a que diz respeito. Um comentário que diz o que mudar funciona melhor do que “isto está errado”, porque o agente vê apenas os seus comentários e o ficheiro, não o seu ecrã.

Perguntas sobre os planos do Cursor

Mais perguntas