Limitações e restrições

Arquivos binários não suportados

As ferramentas de arquivo do Verdent funcionam apenas com formatos baseados em texto. Os seguintes não podem ser editados:

Alternativa: arquivos binários podem ser referenciados no código ou discutidos conceitualmente, mas as modificações exigem ferramentas externas.

Limites de linha do file_read

Limitação:

• Arquivos grandes (>10.000 linhas) devem ser lidos em seções
• Ler arquivos grandes inteiros pode esgotar o contexto

Solução: use intervalos de linha: file_read("file.js", start_line=100, max_lines=50)

Tempos limite de comandos bash

Limitação:

• Tempo limite máximo: 120 segundos (2 minutos)
• Operações de longa duração serão encerradas automaticamente

Solução: divida as operações em comandos menores que sejam concluídos em até 2 minutos

Desempenho de busca

Limitação:

• Padrões glob amplos (**/*) podem retornar milhares de resultados
• Buscas com regex são mais lentas que strings literais

Solução: use padrões específicos e exclua diretórios desnecessários

Esgotamento de contexto

Problema: durante sessões longas ou operações complexas, a janela de contexto da IA pode se encher, limitando a capacidade de referenciar conversas anteriores.

Estratégias de mitigação:

• Use subagentes para pesquisa exploratória (os resultados consomem apenas o contexto principal)
• Leia arquivos de forma estratégica com intervalos de linha
• Use grep_file antes de ler o conteúdo completo
• Delegue tarefas em segundo plano ao subagente Explorer

Sem administração de sistema direta

Não consegue:

• Modificar configurações do VS Code de forma programática
• Instalar extensões do VS Code automaticamente
• Alterar configurações em nível de sistema
• Reiniciar o VS Code ou serviços do sistema

Escopo: o Verdent opera dentro do espaço de trabalho do VS Code, não no nível de administração do sistema.

Sem execução autônoma

Controles do Manual Accept Mode:

• Os usuários devem aprovar as execuções de ferramentas no Manual Accept Mode
• Sem operações automatizadas em segundo plano sem aprovação
• Não consegue executar comandos enquanto o VS Code está fechado

Objetivo: segurança e controle do usuário sobre todas as operações.

Sem monitoramento em tempo real

Não consegue:

• Monitorar processos em execução continuamente
• Rastrear alterações no sistema de arquivos em tempo real
• Alertar sobre eventos do sistema
• Transmitir arquivos de log continuamente

Alternativa: use integrações do MCP para ferramentas de monitoramento externas.

Sem operações de rede sem MCP

Limitações integradas:

• Não consegue fazer requisições HTTP arbitrárias (use web_fetch para páginas específicas)
• Sem conexões diretas com banco de dados (requer MCP)
• Não consegue acessar serviços de nuvem diretamente (requer MCP)
• Sem integrações do API em tempo real (requer MCP)

Solução: configure servidores MCP para acesso a sistemas externos.

Modificação de arquivos binários

Limitação: não consegue editar imagens, PDFs ou binários compilados

Soluções alternativas:

• Referencie ferramentas externas em comandos bash: bash("convert input.png -resize 50% output.png")
• Gere scripts que ferramentas externas possam executar
• Documente etapas manuais para operações com arquivos binários

Exemplo:

# Image conversion
bash("convert input.png -resize 50% output.png")

# PDF to text
bash("pdftotext document.pdf output.txt")

Tratamento de arquivos grandes

Limitação: arquivos com mais de 10.000 linhas sobrecarregam a janela de contexto

Soluções alternativas:

• Use intervalos de linha: file_read("large.log", start_line=1000, max_lines=100)
• Faça uma busca primeiro: grep_content("ERROR", glob="large.log") para encontrar as seções relevantes
• Divida os arquivos em módulos menores para facilitar o gerenciamento

Esgotamento da janela de contexto

Limitação: conversas longas enchem a janela de contexto

Soluções alternativas:

• Delegue ao subagente Explorer para pesquisa na base de código
• Use o subagente Verifier para tarefas de validação isoladas
• Inicie uma nova conversa para tarefas distintas
• Use todo_update para acompanhar o progresso entre sessões

Prática recomendada: delegue pesquisas em segundo plano a subagentes para preservar o contexto principal para o desenvolvimento ativo.

Diferenças de comandos entre plataformas

Limitação: os comandos bash diferem entre Windows e Unix

Soluções alternativas:

• Use ferramentas multiplataforma: scripts npm em vez de bash puro
• Comandos condicionais: bash("if [[ \"$OSTYPE\" == \"linux-gnu\"* ]]; then ...; fi")
• AGENTS.md específico do projeto com observações de plataforma

Exemplo:

# Cross-platform
bash("npm run build")

# Platform-specific conditional
bash("if [[ \"$OSTYPE\" == \"linux-gnu\"* ]]; then make; else nmake; fi")