Verdent Docs
Fluxos de trabalho comuns

Exemplos de tarefas em várias etapas

Lidando com tarefas complexas em várias etapas usando Verdent

Verdent for VS Code se destaca em decompor tarefas complexas em várias etapas de forma autônoma. Este guia oferece fluxos de trabalho passo a passo para cenários comuns de várias etapas, mostrando exatamente como Verdent lida com a decomposição de tarefas, o gerenciamento de dependências e a execução progressiva.


Usando Plan Mode para implementações complexas

Suponha que você queira revisar um plano detalhado antes que Verdent faça qualquer alteração na sua base de código.

Mude para Plan Mode

Clique no botão "Switch Mode" na interface e selecione "Plan Mode".

Plan Mode é somente leitura: Verdent pode analisar código, conduzir pesquisas e criar planos sem modificar arquivos ou executar comandos.

Envie sua solicitação complexa

Refactor this codebase to replace our custom authentication with OAuth 2.0

Verdent analisa minuciosamente sua implementação atual.

Responda às perguntas esclarecedoras

Verdent pode fazer perguntas para eliminar incertezas:

  • Qual provedor OAuth devemos usar?
  • Os tokens devem ser armazenados em localStorage ou cookies?
  • Precisamos oferecer suporte a vários provedores OAuth?

Responda a essas perguntas para refinar o plano.

Revise o plano detalhado

Verdent apresenta um plano abrangente mostrando:

  • Arquivos a serem criados
  • Arquivos existentes a modificar
  • Etapas de implementação em ordem lógica
  • Dependências entre as etapas

Revise esse plano com atenção antes de prosseguir.

Escolha sua próxima ação

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

  • Escolha Edit para solicitar modificações ou fazer perguntas esclarecedoras
  • Escolha Start Building para mudar para Agent Mode e iniciar a execução

Você pode iterar sobre o plano quantas vezes precisar antes de construir.

Dicas:

  • Use Plan Mode para recursos que afetam vários arquivos
  • Faça várias rodadas de revisão do plano para refinar a abordagem
  • Salve o plano em um arquivo para discussão em equipe antes da execução
  • Plan Mode ajuda a garantir o alinhamento entre suas expectativas e a solução proposta por Verdent
  • Personalize o formato do plano: Acesse Settings → Rules → Plan Rules para controlar a estrutura do plano, o nível de detalhe e as preferências de formatação

Decompondo grandes solicitações de recursos

Suponha que você esteja construindo um sistema complexo de checkout de e-commerce com vários componentes integrados.

Forneça o objetivo de alto nível

Build a complete checkout system with cart management, payment processing, order confirmation, and inventory updates

Verdent analisa o que precisa ser feito.

Verdent cria subtarefas lógicas

O sistema decompõe isso de forma autônoma em:

  1. Criar o modelo de dados do carrinho de compras e API
  2. Construir a UI do carrinho com adicionar/remover/atualizar itens
  3. Implementar a página de checkout com formulário de endereço de entrega
  4. Integrar o gateway de pagamento (Stripe ou provedor configurado)
  5. Criar a página de confirmação do pedido
  6. Adicionar a lógica de atualização de estoque
  7. Implementar o sistema de confirmação por e-mail
  8. Escrever testes de integração

Cada subtarefa é exibida na lista de tarefas com descrições claras.

Verdent lida com as dependências automaticamente

Verdent executa as subtarefas na ordem correta:

  • Cria os modelos de dados antes dos endpoints API que os utilizam
  • Constrói os endpoints de backend antes dos componentes de frontend que os chamam
  • Implementa os recursos principais antes de adicionar testes

As dependências são gerenciadas automaticamente, sem intervenção manual.

Acompanhe o progresso em tempo real

Observe a lista de tarefas se atualizar em tempo real enquanto Verdent trabalha em cada subtarefa. Os itens passam de pendente → em andamento → concluído.

Dicas:

  • Deixe Verdent lidar com a decomposição de forma autônoma na maioria das tarefas
  • Use Plan Mode se você quiser revisar a decomposição antes da execução
  • Verdent ajusta sua abordagem quando encontra casos extremos ou novos requisitos
  • A lista de tarefas visível oferece transparência sobre a execução em várias etapas

Projetos de refatoração em várias fases

Suponha que você esteja refatorando uma grande base de código e queira abordá-la em fases gerenciáveis.

Defina a abordagem em várias fases

In Plan Mode: Refactor this codebase to replace our custom authentication with OAuth 2.0. I want this done in phases so we can test incrementally.

Verdent propõe a divisão em fases

Verdent sugere um plano em várias fases:

  • Fase 1: Adicionar a biblioteca OAuth e configurar os endpoints
  • Fase 2: Atualizar o modelo de usuário e o esquema do banco de dados
  • Fase 3: Migrar a lógica de autenticação existente
  • Fase 4: Remover o código de autenticação obsoleto
  • Fase 5: Atualizar os testes e a documentação

Cada fase é testável de forma independente.

Execute fase por fase

Aprove a Fase 1, permita que Verdent a execute e, em seguida, teste:

npm test

Assim que a Fase 1 for verificada como funcional, avance para a Fase 2.

Ajuste as fases seguintes se necessário

Com base no que você aprende na Fase 1, é possível ajustar a abordagem das fases restantes:

For Phase 2, let's also add user role migration to the database schema changes

Conclua todas as fases de forma incremental

Trabalhe em todas as fases com testes e verificação entre cada uma, garantindo segurança e permitindo correções de rumo.

Dicas:

  • A refatoração em várias fases reduz o risco ao permitir testes incrementais
  • Cada fase deve deixar a base de código em estado funcional
  • Faça commit após cada fase para facilitar o rollback se necessário
  • Ajuste as fases posteriores com base nos aprendizados das fases anteriores

Coordenando alterações de backend e frontend

Suponha que você esteja adicionando um recurso que exige atualizações sincronizadas tanto nos APIs do backend quanto nos componentes do frontend.

Descreva o recurso full-stack

Add a commenting system where users can add comments to blog posts. Include backend API, database schema, and frontend UI

Verdent coordena a abordagem backend-first

Verdent normalmente trabalha backend-first para recursos full-stack:

  1. Criar a migração de banco de dados para a tabela de comentários
  2. Adicionar o endpoint API para criar comentários
  3. Adicionar o endpoint API para recuperar comentários
  4. Definir as interfaces TypeScript para os dados de comentários
  5. Construir o componente de formulário de comentários do frontend
  6. Criar o componente de exibição de comentários
  7. Conectar o frontend aos endpoints API

Verdent garante a consistência

Verdent garante que:

  • As interfaces TypeScript do frontend correspondam às estruturas de dados do backend
  • As URLs dos endpoints API sejam referenciadas corretamente no código do frontend
  • Os formatos de requisição/resposta estejam alinhados entre backend e frontend
  • O tratamento de erros seja consistente em toda a stack

Teste de integração

Write integration tests for the commenting system covering the full stack

Verdent cria testes que verificam se o backend e o frontend funcionam corretamente em conjunto.

Dicas:

  • A abordagem backend-first garante que o frontend tenha APIs funcionais para integração
  • Verdent mantém a consistência entre o código de backend e frontend automaticamente
  • As interfaces TypeScript ajudam a detectar problemas de integração em tempo de compilação
  • Os testes de integração verificam se o recurso completo funciona de ponta a ponta

Usando subagentes para execução paralela

Suponha que você tenha várias tarefas independentes que poderiam ser feitas simultaneamente.

Identifique tarefas paralelizáveis

Generate unit tests for all service classes in the src/services directory

Esses arquivos de teste são independentes e podem ser criados em paralelo.

Verdent delega para vários subagentes

Verdent usa automaticamente vários subagentes para trabalhar em tarefas independentes de forma concorrente:

  • Subagente 1: Cria testes para UserService
  • Subagente 2: Cria testes para PaymentService
  • Subagente 3: Cria testes para NotificationService
  • Subagente 4: Cria testes para AuthService

Todo o trabalho acontece em paralelo, economizando tempo.

Os resultados são integrados

Cada subagente retorna seus resultados. Verdent integra todos os arquivos de teste ao projeto com a nomenclatura e a estrutura adequadas.

Verificação sequencial

Após a criação paralela, execute os testes sequencialmente para verificar se todos funcionam:

npm test

Dicas:

  • Verdent paraleliza automaticamente tarefas independentes usando subagentes
  • Trabalhos fracamente acoplados (arquivos de teste separados, componentes independentes) se beneficiam da paralelização
  • Trabalhos fortemente acoplados (arquivos com dependências) são feitos sequencialmente para garantir a correção
  • A execução paralela acelera significativamente alterações em larga escala

Perguntas frequentes

Posso interromper Verdent no meio de uma tarefa em várias etapas?

Sim. Você pode interromper a execução a qualquer momento. Verdent concluirá a etapa atual em que está trabalhando e então parará. O progresso até esse ponto é preservado. Você pode revisar o que foi feito, fazer ajustes e continuar ou adotar uma abordagem diferente.

Como sei o que Verdent está fazendo agora em uma tarefa longa?

Observe a lista de tarefas. Ela mostra o status em tempo real, com um item marcado como "em andamento" a cada momento. O item ativo mostra exatamente em que Verdent está trabalhando no momento. Os itens concluídos são marcados como feitos, e os pendentes mostram o que falta.

E se eu discordar de como Verdent decompôs minha tarefa?

Use Plan Mode para revisar e ajustar a decomposição antes da execução. No Plan Mode, você pode dar feedback como "Divida o trabalho de frontend em componentes separados" ou "Combine essas duas etapas". Verdent revisará o plano com base na sua entrada antes que qualquer código seja escrito.

Devo usar Plan Mode para toda tarefa em várias etapas?

Não necessariamente. Use Plan Mode para recursos complexos que afetam muitos arquivos, grandes refatorações ou quando quiser revisar a abordagem primeiro. Para tarefas familiares e diretas, Verdent pode executar diretamente com a visibilidade da lista de tarefas em tempo real. Plan Mode adiciona uma etapa de revisão para alterações de maior risco.

Posso modificar o plano de Verdent depois que a execução começou?

Você pode fornecer orientações corretivas enquanto Verdent trabalha. Diga "Na verdade, use uma abordagem diferente para a integração API" e Verdent ajustará as etapas restantes. Para grandes mudanças de plano, é melhor parar, fazer commit do que foi feito e iniciar uma nova sessão com a abordagem revisada.


Veja também