Limitaciones y restricciones

Archivos binarios no compatibles

Las herramientas de archivos de Verdent solo funcionan con formatos basados en texto. Los siguientes no se pueden editar:

Solución alternativa: Los archivos binarios pueden referenciarse en el código o tratarse conceptualmente, pero las modificaciones requieren herramientas externas.

Límites de líneas de file_read

Limitación:

• Los archivos grandes (>10.000 líneas) deben leerse por secciones
• Leer archivos grandes completos puede agotar el contexto

Solución: Usa rangos de líneas: file_read("file.js", start_line=100, max_lines=50)

Tiempos de espera de comandos bash

Limitación:

• Tiempo de espera máximo: 120 segundos (2 minutos)
• Las operaciones de larga duración se terminan automáticamente

Solución: Divide las operaciones en comandos más pequeños que se completen en menos de 2 minutos

Rendimiento de búsqueda

Limitación:

• Los patrones glob amplios (**/*) pueden devolver miles de resultados
• Las búsquedas con regex son más lentas que las de cadenas literales

Solución: Usa patrones específicos y excluye directorios innecesarios

Agotamiento del contexto

Problema: Durante sesiones largas u operaciones complejas, la ventana de contexto de la IA puede llenarse, lo que limita la capacidad de hacer referencia a partes anteriores de la conversación.

Estrategias de mitigación:

• Usa subagentes para investigación exploratoria (los resultados solo consumen el contexto principal)
• Lee archivos de forma estratégica con rangos de líneas
• Usa grep_file antes de leer el contenido completo
• Delega tareas en segundo plano al subagente Explorer

Sin administración directa del sistema

No puede:

• Modificar la configuración de VS Code de forma programática
• Instalar extensiones de VS Code automáticamente
• Cambiar configuraciones a nivel de sistema
• Reiniciar VS Code o servicios del sistema

Alcance: Verdent opera dentro del espacio de trabajo de VS Code, no a nivel de administración del sistema.

Sin ejecución autónoma

Controles de Manual Accept Mode:

• Debes aprobar las ejecuciones de herramientas en Manual Accept Mode
• No hay operaciones automatizadas en segundo plano sin aprobación
• No puede ejecutar comandos mientras VS Code está cerrado

Propósito: Seguridad y control del usuario sobre todas las operaciones.

Sin monitoreo en tiempo real

No puede:

• Monitorear procesos en ejecución de forma continua
• Rastrear cambios del sistema de archivos en tiempo real
• Alertar sobre eventos del sistema
• Transmitir archivos de registro de forma continua

Alternativa: Usa integraciones de MCP para herramientas de monitoreo externas.

Sin operaciones de red sin MCP

Limitaciones integradas:

• No puede hacer solicitudes HTTP arbitrarias (usa web_fetch para páginas específicas)
• No hay conexiones directas a bases de datos (requiere MCP)
• No puede acceder a servicios en la nube directamente (requiere MCP)
• No hay integraciones en tiempo real con API (requiere MCP)

Solución: Configura servidores MCP para acceder a sistemas externos.

Modificación de archivos binarios

Limitación: No puede editar imágenes, PDF ni binarios compilados

Soluciones alternativas:

• Referencia herramientas externas en comandos bash: bash("convert input.png -resize 50% output.png")
• Genera scripts que las herramientas externas puedan ejecutar
• Documenta los pasos manuales para las operaciones con archivos binarios

Ejemplo:

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

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

Manejo de archivos grandes

Limitación: Los archivos de más de 10.000 líneas sobrecargan la ventana de contexto

Soluciones alternativas:

• Usa rangos de líneas: file_read("large.log", start_line=1000, max_lines=100)
• Busca primero: grep_content("ERROR", glob="large.log") para encontrar las secciones relevantes
• Divide los archivos en módulos más pequeños para facilitar su gestión

Agotamiento de la ventana de contexto

Limitación: Las conversaciones largas llenan la ventana de contexto

Soluciones alternativas:

• Delega en el subagente Explorer la investigación del código base
• Usa el subagente Verifier para tareas de validación aisladas
• Inicia una nueva conversación para tareas distintas
• Usa todo_update para hacer seguimiento del progreso entre sesiones

Práctica recomendada: Delega la investigación en segundo plano a los subagentes para preservar el contexto principal para el desarrollo activo.

Diferencias de comandos entre plataformas

Limitación: Los comandos bash difieren entre Windows y Unix

Soluciones alternativas:

• Usa herramientas multiplataforma: scripts de npm en lugar de bash directo
• Comandos condicionales: bash("if [[ \"$OSTYPE\" == \"linux-gnu\"* ]]; then ...; fi")
• AGENTS.md específico del proyecto con notas sobre la plataforma

Ejemplo:

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

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