Use o /dr:plan quando você sabe o que quer construir, mas ainda não decidiu como. Você descreve a tarefa com suas palavras, o comando conversa com você sobre os pontos em aberto e, no final, entrega um plano de implementação completo. Nada é alterado no seu código: é uma conversa de planejamento, e só o plano fica gravado.
Uma frase ou um parágrafo descrevendo a tarefa, no seu idioma, com o contexto que tiver. Não precisa conhecer a estrutura do projeto nem listar arquivos: o comando lê o código por conta própria antes de perguntar qualquer coisa.
Quanto mais claro o objetivo, mais direto o desenho. “Migrar a autenticação de cookies para JWT” já basta para começar.
O comando não supõe o que você quer, mas também não se limita a perguntar. Ele analisa o pedido, resgata o contexto do projeto e começa a desenhar a implementação. Conforme o desenho avança, ele apresenta as alternativas que encontrou, com a recomendação dele em primeiro lugar, e alinha cada uma com você: uma abordagem com dois caminhos possíveis, uma regra de negócio que não está escrita em lugar nenhum, um comportamento que depende do seu contexto. O plano vai sendo construído em conjunto.
Antes de perguntar qualquer coisa, o comando faz um levantamento cuidadoso do que o projeto já sabe: o conhecimento acumulado sobre ele, as convenções em uso e os detalhes que o próprio código mostra. Esse levantamento é o que mantém o plano dentro dos padrões do projeto, e é o que evita que você precise explicar o que já está lá.
Ao final, o comando apresenta o plano consolidado: o que será construído, as decisões de arquitetura, como a mudança se encaixa no que já existe e os riscos. Ele ainda pergunta se a entrega deve incluir testes automatizados e documentação. Se algo não ficou como você queria, peça ajustes, e o plano volta revisado.
Um plano de implementação gravado no projeto, com critérios de aceite e um checklist de tarefas. Depois de dividir o trabalho, o comando seleciona o agente especialista que vai implementar cada tarefa e já mapeia a distribuição para que o máximo de agentes possa trabalhar em paralelo na execução.
Esse é o ponto de partida para a execução: rodar /dr:fast-execute, o próximo passo sugerido, ou /dr:execute é a aprovação do plano. Não há um “confirmar” separado.
Na prática, o planejamento que levaria uma reunião e algumas anotações soltas vira uma conversa de poucos minutos com um registro que a equipe inteira consegue ler.
Como utilizar
Descreva a tarefa em linguagem natural, com o contexto que tiver. As lacunas que o código não resolve viram perguntas, com opções e a recomendação do agente.
Exemplos
/dr:plan migrar a autenticação de cookies para JWT
/dr:plan criar o módulo de relatórios com exportação em CSV e PDF
Na ambiguidade
Se a sua frase pode ser interpretada de mais de uma forma, o comando pergunta antes de escrever (via AskUserQuestion). Em operação de escrita, o comando nunca chuta — a ambiguidade sempre volta para você.
Notas
/dr:plan:interactive é o mesmo fluxo de entrevista. Outras variantes: /dr:plan:auto (sem perguntas: o planner assume as decisões em aberto e as lista no plano), /dr:plan:deep-plan (explora o código, tenta planejar e pergunta a partir das lacunas), /dr:plan:feature-plan (nível de produto, com jornada do usuário) e /dr:plan:workforce (parte de uma task ou feature do Workforce).
Para quem quer saber o que acontece nos bastidores:
- Leitura do projeto: o comando lê os mapas de
.dr_ai/codebase/ (gerados por /dr:codebase-map) ou, se ainda não existirem, explora o código diretamente.
- Gravação do plano: o agente
tech-planner cria a pasta da task em .dr_ai/tasks/<nome>/ com dois arquivos: __TaskPlan.md (o plano, com decisões e critérios de aceite) e __TaskChecklist.json (as tarefas a executar).
- Atribuição: o agente
task-assigner associa um agente especialista a cada item do checklist e marca as dependências entre eles, que é o que /dr:execute e /dr:fast-execute usam para despachar o trabalho em paralelo.
- /dr:execute — executar o checklist gerado pelo plano, com revisão e documentação ao final
- /dr:spawn — despachar tarefas independentes sem plano persistido
- O diretório .dr_ai — onde o plano fica gravado
