Verdent Docs
Configuração

Otimização de configuração

Otimizando Verdent para o seu fluxo de trabalho

Otimize Verdent for VS Code para equilibrar velocidade, custo e profundidade de acordo com os requisitos do seu fluxo de trabalho. Configure presets de modelo, modos de execução e estratégias de gerenciamento de contexto para um desempenho ideal.

Áreas de otimização

  • Seleção de preset de modelo para equilibrar custo e desempenho
  • Configuração do modo de execução para eficiência do fluxo de trabalho
  • Gerenciamento de contexto para bases de código grandes
  • Personalização por projeto e por espaço de trabalho

Ajustando configurações para o seu fluxo de trabalho

Seleção de preset de modelo

Escolha o preset de modelo apropriado com base na complexidade da tarefa e no orçamento:

PresetCustoEficiência de custoMelhor para
Efficiency~0,3x Balance (redução de 70%)3,2x mais eficiente que o SonnetTarefas simples, correções rápidas, prototipagem ágil
Balance (Padrão)1x base1x baseTarefas de desenvolvimento gerais, codificação do dia a dia
Performance1-2x Balance0,5x de eficiência (2x de custo, 1M de contexto)Decisões arquiteturais complexas, refatoração intrincada

Modelos adicionais:

  • Claude-4.5-sonnet: Modelo equilibrado de uso geral (1x base)
  • Claude-4.5-sonnet-1m: Contexto estendido para tarefas complexas (0,5x de eficiência, 2x de custo quando a entrada excede 200k tokens)
  • Claude-4.5-haiku: O mais rápido e econômico (3,2x mais eficiente que o Sonnet)
  • GPT-5 / GPT-5-codex: Foco em raciocínio e criatividade (Beta, 1,3x mais eficiente que o Sonnet)
  • Minimax-m2: Rápido e econômico (Beta, gratuito até 10 de novembro)

Configuração do modo de execução

  • Autonomia total sem prompts de aprovação
  • Sem interrupções para permissões
  • Maior risco - use apenas em ambientes automatizados
  • Comandos exigem aprovação, operações de arquivo automáticas
  • Menos prompts de permissão
  • Menor risco, com segurança mantida para operações perigosas
  • Toda operação exige aprovação
  • Visibilidade e controle completos
  • O mais lento, porém o mais seguro - melhor para aprendizado e código de produção
  • Planejamento estratégico antes da execução
  • Fase de análise somente leitura
  • Revise e aprove antes de qualquer alteração

Think Hard Mode

Ative para tarefas de raciocínio complexo:

  • Profundidade: Profundidade máxima de raciocínio para problemas sofisticados
  • Velocidade: Mais lenta devido ao orçamento estendido de raciocínio
  • Melhor para: Decisões arquiteturais, depuração complexa, análise intrincada

Compromissos entre velocidade e profundidade

Equilibre a velocidade de execução com a profundidade da análise de acordo com os requisitos da tarefa.

Configuração:

  • Modelo: preset Efficiency (Claude-4.5-haiku)
  • Modo de permissão: Auto-Run Mode
  • Modo de execução: Agent Mode para execução direta
  • Casos de uso: Correções rápidas, operações de rotina, tarefas simples

Benefícios:

  • Tempos de resposta mais rápidos
  • Interrupções mínimas
  • Redução de 70% no custo em relação ao preset Balance

Configuração:

  • Modelo: preset Performance (Claude-4.5-sonnet-1m)
  • Modo de permissão: Manual Accept Mode
  • Modo de execução: Plan Mode para revisão estratégica
  • Think Hard: Ativado para raciocínio sofisticado
  • Casos de uso: Recursos complexos, código de produção, decisões arquiteturais

Benefícios:

  • Janela de contexto máxima (1M de tokens)
  • Visibilidade e controle completos
  • Raciocínio profundo para problemas complexos
  • Revisão antes da execução

A maioria dos usuários se beneficia da alternância de contexto entre configurações:

  • Correções rápidas: Efficiency + Agent Mode
  • Recursos complexos: Balance/Performance + Plan Mode
  • Exploração: Plan Mode para estratégia e, em seguida, Agent Mode para execução

Estratégia: Adapte a configuração ao tipo de tarefa em vez de usar uma abordagem única para tudo.

Use Auto-Run Mode para projetos confiáveis a fim de reduzir os prompts de permissão, mantendo a segurança para operações perigosas. Isso agiliza o fluxo de trabalho sem sacrificar proteções críticas.


Configuração no nível do espaço de trabalho

Verdent oferece suporte à configuração por projeto e por espaço de trabalho para garantir consistência em toda a equipe.

Configuração específica do projeto

Regras do projeto (AGENTS.md):

  • Localização: Diretório raiz do projeto ou pasta do espaço de trabalho
  • Escopo: Aplicado somente ao projeto atual
  • Controle de versão: Faça commit no git para padrões válidos em toda a equipe
  • Conteúdo: Padrões de codificação, requisitos de teste, padrões arquiteturais

Exemplo:

# Project Rules

## Code Standards
- Use TypeScript strict mode
- Generate unit tests for all new functions
- Follow MVC pattern

## Testing
- All endpoints require input validation
- Run tests before committing

Configurações de espaço de trabalho do VS Code

Configure as definições da extensão no nível do espaço de trabalho:

Localização: .vscode/settings.json na raiz do espaço de trabalho

Exemplo:

{
  "verdent.enableCheckpoints": true
}

Prioridade de configuração

Quando as configurações entram em conflito, Verdent aplica esta ordem de prioridade:

  1. Regras do projeto (AGENTS.md) - Prioridade mais alta (específica do projeto)
  2. Configurações do espaço de trabalho - configurações no nível do espaço de trabalho do VS Code
  3. Regras do usuário (VERDENT.md) - Preferências globais do usuário
  4. Configurações padrão - padrões integrados do Verdent

Personalização específica do projeto

Gerenciamento de contexto para projetos grandes

  • Delegue operações complexas a subagentes com janelas de contexto separadas
  • Apenas os resultados do subagente consomem o contexto principal, não todo o processo
  • Evita que o contexto principal se encha de detalhes de implementação
  • Adicione explicitamente apenas os arquivos relevantes usando @filename
  • Evite carregar todo o projeto no contexto desnecessariamente
  • Direcione componentes específicos para uma análise focada
  • Divida tarefas grandes em partes menores e concluíveis
  • Inicie novas sessões para recursos ou componentes distintos
  • Pontos de quebra naturais evitam o esgotamento do contexto
  • Revise a abordagem antes de consumir o contexto de execução
  • Reduz o desperdício de contexto em implementações incorretas
  • Plan Mode possui gerenciamento de contexto separado

Otimização de desempenho

Ative checkpoints seletivamente:

A configuração verdent.enableCheckpoints usa o git para controle de versão:

  • Pode impactar o desempenho em repositórios muito grandes
  • Ative apenas quando a funcionalidade de checkpoint for necessária
  • Desative para o máximo desempenho em bases de código grandes

Ative checkpoints seletivamente apenas para tarefas críticas; o uso excessivo de checkpoints torna os fluxos de trabalho mais lentos sem agregar valor.

Seleção de modelo:

  • Use o preset Efficiency (Haiku) para tarefas simples e isoladas
  • Reserve o preset Performance (Sonnet-1M) para operações com muito contexto
  • Use o preset Balance para trabalho geral

Modo de execução:

  • Auto-Run Mode reduz o contexto consumido por prompts de permissão
  • Skip Permissions Mode maximiza a eficiência para ambientes automatizados

Cenários com múltiplos espaços de trabalho aplicam automaticamente as regras de projeto apropriadas ao alternar entre espaços de trabalho. Não é necessário trocar a configuração manualmente.

Configurações com múltiplos espaços de trabalho permitem otimizar as definições por tipo de projeto, desenvolvimento vs produção, monorepo vs microsserviços.


Veja também