Fluxos de trabalho com planejamento primeiro

Os fluxos de trabalho com planejamento primeiro aproveitam o Plan Mode, um modo de execução somente leitura em que o Verdent analisa código, conduz pesquisas e cria planos detalhados antes de executar qualquer mudança. Esse fluxo de trabalho separa o planejamento estratégico da implementação, permitindo revisão e refinamento antes de se comprometer com modificações no código.

Quando usar o Plan Mode

Mudanças complexas em vários arquivos que exigem coordenação
Incerteza sobre a melhor abordagem de implementação
Mudanças de alto risco em código crítico para produção
Tarefas em bases de código desconhecidas onde a exploração é necessária
Necessidades de planejamento estratégico que exigem aprovação antes da execução

Divisão de tarefas assistida por IA

O Verdent decompõe automaticamente solicitações complexas em etapas sequenciais e gerenciáveis por meio da divisão de tarefas assistida por IA.

Processo de divisão

Análise da solicitação

O Verdent analisa sua solicitação em linguagem natural para identificar:

Objetivo principal e resultado desejado
Arquivos, componentes ou sistemas afetados
Operações técnicas e dependências necessárias
Possíveis fatores de complexidade

Contexto da base de código

O Verdent examina a estrutura do seu projeto para entender:

Arquitetura existente e padrões estabelecidos
Organização de arquivos e stack de tecnologia
Implementações atuais que exigem modificação

Decomposição de tarefas

O Verdent divide a solicitação em subtarefas lógicas:

Identifica pontos de quebra naturais e fases de implementação
Ordena as tarefas por dependência (tarefas pré-requisito primeiro)
Agrupa operações relacionadas
Estima o escopo e a complexidade de cada subtarefa

Esclarecimento interativo

O Verdent pode fazer perguntas para refinar a divisão:

"Devo modificar a validação existente ou criar um novo validador?"
"Você quer atualizar os testes de todos os componentes afetados?"
"Essa mudança deve se aplicar tanto aos componentes web quanto aos mobile?"

Características da divisão

Tarefas dimensionadas para 15 a 45 minutos de trabalho focado
Pontos de quebra naturais para testes e validação
Complexas o suficiente para serem significativas, simples o suficiente para serem executadas

Dependências respeitadas (configuração antes da implementação)
Progressão lógica (camada de dados → lógica de negócios → UI)
Etapas de verificação após fases importantes

O formato da divisão do plano pode ser personalizado via plan_rules.md para controlar:

Nível de detalhe (alto nível vs. granular)
Estrutura e seções do plano
Informações incluídas (estimativas de tempo, riscos, dependências)

Revisão e aprovação do plano

Após enviar uma solicitação no Plan Mode, o Verdent gera um plano estruturado exibido na Chat View para sua revisão.

Processo de revisão

Receber o plano estruturado

O Verdent gera um plano com seções claras, etapas numeradas, arquivos afetados e dependências identificadas

Analisar a qualidade do plano

Revise quanto a:

Correção: A abordagem resolve o problema?
Completude: Todas as etapas necessárias estão incluídas?
Eficiência: Esta é a melhor abordagem?
Risco: O que pode dar errado? Casos extremos ou preocupações de segurança?

Fazer perguntas de esclarecimento

Solicite informações adicionais se algo não estiver claro:

Can you explain step 3 in more detail?
Why are we modifying both the service and controller?
What happens if the API call fails in step 5?

Solicitar modificações

Forneça feedback para revisar o plano:

Let's use JWT tokens instead of OAuth2
Can we break step 4 into smaller substeps?
Add error handling considerations to the plan

Escolher sua próxima ação

Depois que o Verdent gerar o plano, duas opções são apresentadas:

Edit: Solicite modificações, faça perguntas de esclarecimento ou refine o plano ainda mais
Start Building: Mude para o Agent Mode e comece a executar o plano aprovado

Opções de interação com o plano

Após revisar o plano gerado, o Verdent apresenta duas opções:

Edit:

Escolha essa opção para:

Solicitar mudanças específicas na abordagem do plano
Fazer perguntas de esclarecimento sobre detalhes de implementação
Adicionar elementos ou considerações ausentes
Simplificar ou expandir determinadas etapas
Explorar abordagens alternativas

Isso mantém você no Plan Mode para refinamento iterativo sem executar nenhuma mudança.

Start Building:

Escolha essa opção para:

Mudar para o Agent Mode e iniciar a execução
Implementar o plano aprovado com total autonomia
Fazer modificações em arquivos e executar comandos conforme planejado

Você também pode optar por:

Implementação manual: Revisar o plano e implementar as mudanças você mesmo
Execução incremental: Pedir ao Verdent para implementar fases específicas com checkpoints de revisão entre os estágios

Use Edit para iterar no plano quantas vezes forem necessárias. Escolha Start Building somente quando estiver confiante de que a abordagem está correta e completa.

Planejamento iterativo

Os usuários podem modificar e iterar livremente os planos escolhendo Edit e fornecendo feedback conversacional. O Verdent trata a geração de planos como um processo interativo e iterativo.

Métodos de modificação

Solicitar mudanças específicas:

Change step 3 to use Redux instead of Context API
Add input validation before the database insert
Swap the order of steps 4 and 5

Adicionar elementos ausentes:

Add error handling for network failures
Include rollback procedures
Add performance optimization considerations

Simplificar ou expandir:

This is too complex - can we simplify the approach?
Break down step 5 into more detailed substeps
Give me more detail on the database schema changes

Explorar alternativas:

What if we used webhooks instead?
Show me an alternative plan using microservices architecture
Can we accomplish this without changing the database schema?

Exemplo de fluxo de iteração

User: "Add user authentication to the API"

[Verdent generates initial plan with JWT tokens]

User: "Actually, let's use OAuth2 instead of JWT"

[Verdent revises plan to use OAuth2]

User: "Add step for migrating existing users"

[Verdent adds migration step to plan]

User: "Can you break down the migration step more?"

[Verdent expands migration with detailed substeps]

User: Chooses **Start Building**

[Verdent switches to Agent Mode and begins execution]

Iterações ilimitadas:

Sem limite para o número de revisões
Cada iteração mantém o contexto da conversa
Versões anteriores preservadas no histórico do chat
Possibilidade de referenciar versões anteriores do plano: "volte para a primeira abordagem"

A rejeição de um plano é uma parte natural do processo de planejamento iterativo. Ela garante que apenas estratégias aprovadas e bem compreendidas sejam executadas, reduzindo o esforço desperdiçado com implementações incorretas.

Perguntas frequentes (FAQs)

O Plan Mode realmente escreve algum código nos meus arquivos?

Não. O Plan Mode é estritamente somente leitura:

O Verdent pode ler arquivos, pesquisar código e analisar sua base de código
Nenhuma gravação, edição ou exclusão de arquivos ocorre durante o Plan Mode
Os planos são exibidos apenas na Chat View
A execução de código começa somente depois que você aprova explicitamente e muda para o Agent Mode

Garantia de segurança: O Plan Mode não consegue modificar seu código acidentalmente. Ele foi projetado para exploração segura e desenvolvimento de estratégias.

Posso executar um plano de forma incremental em vez de tudo de uma vez?

Sim. A execução incremental é totalmente suportada:

Padrão de aprovação incremental:

Let's start with Phase 1 first, then we'll review before continuing
Implement steps 1-3, then stop for review
Do the database migration first, I'll review before the API changes

Como funciona:

O Verdent executa as etapas especificadas
Para em um checkpoint de revisão
Você revisa os resultados e fornece feedback
Continua com a próxima fase ou ajusta a abordagem
Repete até concluir

Melhor para: Mudanças de alto risco, padrões desconhecidos, código crítico para produção onde a implantação em fases reduz o risco.

A execução incremental permite que você aprove partes de um plano enquanto adia outras, útil quando as prioridades mudam no meio da tarefa.

O que acontece se eu rejeitar um plano?

A rejeição de um plano é completamente normal e esperada:

O Verdent gera um novo plano com base no seu feedback
As versões anteriores do plano permanecem no histórico do chat para referência
Nenhuma mudança de código ocorre (o Plan Mode é somente leitura)
Você pode iterar quantas vezes quiser até ficar satisfeito

Motivos comuns de rejeição:

A abordagem é complexa demais ou simples demais
Casos extremos ou tratamento de erros ausentes
Existe uma arquitetura alternativa melhor
Requisitos mal compreendidos

Dica profissional: A rejeição faz parte do processo. É melhor refinar os planos iterativamente do que desperdiçar esforço executando estratégias incorretas.

Como alterno entre o Plan Mode e o Agent Mode?

A alternância é instantânea pela Input Box:

Para entrar no Plan Mode:

Clique no botão Switch Mode na Input Box
Selecione Plan Mode no menu suspenso
OU diga: "Mude para o Plan Mode"

Para sair do Plan Mode:

Clique no botão Switch Mode na Input Box
Selecione Agent Mode no menu suspenso
OU escolha Start Building após revisar um plano

Persistência do modo:

A escolha do modo persiste dentro da sessão atual
Novas sessões começam no Agent Mode padrão
Você pode alternar entre os modos livremente a qualquer momento

Fluxo de trabalho típico: Plan Mode → revisar → Agent Mode → executar → voltar ao Plan Mode para o próximo recurso complexo.

Posso personalizar o formato e o nível de detalhe dos planos gerados?

Sim, usando o plan_rules.md:

Local: ~/.verdent/plan_rules.md (diretório de configuração global)

O que você pode personalizar:

Nível de detalhe: Visão geral de alto nível vs. passo a passo granular
Estrutura do plano: Seções a incluir (resumo, riscos, dependências, testes)
Informações incluídas: Estimativas de tempo, caminhos de arquivos, etapas de verificação
Preferências de formato: Listas numeradas, fases, categorização

Exemplo de plan_rules.md:

# Plan Rules

## Plan Structure
- Start with a brief summary (2-3 sentences)
- Include estimated time for each major step
- List prerequisites before implementation steps
- Identify potential risks and mitigation strategies

## Level of Detail
- Break tasks into subtasks of 15-30 minutes
- Include specific file paths for modifications
- List functions or components to create/modify
- Provide verification steps for each phase

As mudanças se aplicam imediatamente às novas sessões do Plan Mode.

O Plan Mode usa o mesmo contexto que o Agent Mode?

Não, o Plan Mode tem gerenciamento de contexto separado:

Contexto do Plan Mode: Otimizado para análise e pensamento estratégico
Contexto do Agent Mode: Otimizado para execução e implementação
Benefício: Os planos não poluem o contexto de execução com pesquisas exploratórias

Por que a separação importa:

O Plan Mode pode explorar várias abordagens sem sobrecarregar o Agent Mode
Tentativas de planos rejeitados não consomem o contexto do Agent Mode
Um começo limpo ao mudar para a execução

Redefinição de contexto: Alternar entre os modos fornece um contexto novo para o novo tipo de tarefa.

E se o Verdent fizer perguntas de esclarecimento durante o planejamento?

As perguntas de esclarecimento fazem parte do processo de divisão:

Por que as perguntas são feitas:

Requisitos ambíguos precisam de esclarecimento
Existem várias abordagens válidas (escolha uma)
Casos extremos ou restrições ainda não especificados
Preferências não claras na solicitação inicial

Como responder:

Responda diretamente em linguagem conversacional
Forneça exemplos se for útil
Diga "sua escolha" se você confiar no julgamento do Verdent
Faça contraperguntas se estiver em dúvida

Exemplo de troca:

Verdent: "Should I modify the existing validation or create a new validator?"
You: "Create a new validator - we'll deprecate the old one later"
Verdent: [Updates plan with new validator approach]

Dica profissional: As perguntas ajudam o Verdent a gerar planos precisos e relevantes, adaptados às suas necessidades específicas.