Aegis: El compilador de contexto que reduce el consumo de tokens de Claude hasta 12 veces

Un desarrollador ha presentado una solución alternativa a las técnicas convencionales de Retrieval-Augmented Generation (RAG) que promete reducir drásticamente el consumo de tokens y acelerar significativamente el tiempo de respuesta de Claude al trabajar con grandes bases de código. El proyecto, llamado Aegis, implementa un enfoque determinista basado en grafos acíclicos dirigidos (DAG) para proporcionar contexto arquitectónico a los modelos de IA de manera más eficiente. El problema que aborda es bien conocido entre los equipos que utilizan Claude Code CLI y agentes basados en Sonnet 3.5 y Opus: cuando el modelo necesita implementar una funcionalidad en un archivo específico, tiende a explorar el repositorio de forma ineficiente, utilizando herramientas como grep y find para intentar adivinar los patrones arquitectónicos del proyecto. Los sistemas RAG tradicionales, aunque sofisticados, fallan en captar las reglas arquitectónicas abstractas, como convenciones de diseño o patrones específicos de la empresa, porque se basan en búsquedas semánticas imprecisas. Esta "brecha semántica" genera alucinaciones arquitectónicas, produce código que no respeta los principios del proyecto y consume cantidades masivas de tokens en el proceso de exploración. Aegis funciona como un servidor Model Context Protocol (MCP) que implementa un compilador de contexto determinista. En lugar de depender de búsquedas vectoriales difusas, utiliza un grafo acíclico dirigido respaldado por SQLite para mapear directamente rutas de archivos a documentos de arquitectura en formato Markdown. Cuando Claude planifica editar un archivo específico, invoca la herramienta aegis_compile_context, que mapea automáticamente ese archivo a su documentación arquitectónica relevante. El sistema recorre el DAG para identificar dependencias: si la documentación de casos de uso depende de directrices de entidades, ambos documentos se compilan y se devuelven a Claude al instante. Los resultados obtenidos en pruebas realizadas con Claude Opus en un proyecto Laravel con más de 140 casos de uso demuestran la efectividad del enfoque. Sin Aegis, Claude realizaba búsquedas en más de 30 archivos, ejecutaba 55 llamadas a herramientas y consumía 65.400 tokens solo para explorar el repositorio e intentar comprender la estructura de un caso de uso, con un tiempo de respuesta de 2 minutos y 32 segundos. Con Aegis, el código generado respetaba automáticamente las reglas arquitectónicas, requería solo 6 llamadas a herramientas, consumía 1.800 tokens de salida y se completaba en 43 segundos. Esto representa una reducción de 12 veces en el desperdicio de tokens y una aceleración de 3,5 veces en la velocidad de ejecución. Más allá de las métricas, el aspecto más significativo es que el código generado respeta de hecho las decisiones arquitectónicas del proyecto, ya que Claude es obligado a leer primero la documentación relevante compilada por Aegis. El sistema funciona completamente en el entorno local, sin dependencias externas, lo que lo hace particularmente atractivo para equipos que priorizan la privacidad y la independencia de servicios externos. Esta solución llega en un momento en que muchos equipos de desarrollo están reconsiderando sus estrategias de prompting y composición de contexto para trabajar con modelos de IA. Mientras que RAG se ha convertido en un patrón ampliamente adoptado para proporcionar contexto a sistemas de IA, esta implementación sugiere que para casos de uso específicos como la asistencia en desarrollo de software, los enfoques deterministas y basados en estructura pueden ser más efectivos que los basados en similitud semántica. La propuesta plantea preguntas importantes sobre cómo diseñar mejor los sistemas que alimentan de contexto a los modelos de IA: ¿es la búsqueda semántica siempre la mejor opción, o debemos explorar más profundamente cómo incorporar reglas de dominio y estructura explícita?