Pídele a un asistente de código con IA que corrija un error en un servicio desconocido y observa lo que hace primero: empieza a leer. Abre un archivo, luego otro, busca el nombre de una función y abre cuatro más. Cada pasada cuesta tokens y tiempo, y el agente llega a la edición a medias — habiendo muestreado la base de código en lugar de comprenderla.
Codna invierte ese orden. Lee el repositorio completo antes de que el agente escriba una sola línea, construyendo un mapa estructural de todo el proyecto en milisegundos. Los agentes leen tu código. Codna lo comprende.
Por qué un asistente de código con IA lee a ciegas
Un repositorio grande no es una carpeta de texto. Es un grafo — de importaciones, sitios de llamada, definiciones de tipos y las convenciones silenciosas que un equipo ha acumulado durante años. Cuando un agente de programación con IA recorre ese grafo archivo por archivo, paga dos veces: una en tokens gastados releyendo lo que ya ha visto, y otra en los errores que comete porque nunca vio la parte que importaba.
El fallo rara vez es dramático. El agente parchea el síntoma y pasa por alto el helper compartido que está tres directorios más allá. Duplica una utilidad que ya existe. Cambia una firma sin advertir los siete llamadores que hay aguas abajo. Ninguno de estos son fallos de razonamiento. Son fallos de contexto — al modelo nunca se le mostró suficiente base de código para saber más.
La mayoría de las malas ediciones de IA no son errores de razonamiento. Son errores de contexto faltante.
La solución habitual es enviar más texto: llenar el prompt de archivos y esperar que las líneas relevantes estén ahí en algún lugar. Eso cambia un problema por otro. Las ventanas de contexto se llenan, los costes suben y la señal que el agente realmente necesita queda enterrada bajo todo lo que no necesita.
Mapear primero, actuar después
La premisa de Codna es que comprender una base de código y editarla son dos trabajos distintos, y deben ejecutarse en dos motores diferentes. El motor de mapeo hace el costoso trabajo estructural una vez y lo mantiene actualizado. El agente de programación hace la escritura, llegando con contexto preciso en lugar de una lista de lecturas.
Ese mapeo ocurre con cero tokens. Codna indexa el repositorio mediante análisis estático en lugar de alimentar código fuente a través de un modelo de lenguaje, de modo que construir y actualizar el mapa de un proyecto de un millón de líneas no cuesta nada en inferencia. El presupuesto del modelo se gasta donde rinde — en el cambio en sí, no en redescubrir el proyecto desde cero en cada sesión.
El resultado es un asistente de programación con IA que trata el contexto de la base de código como infraestructura. El mapa siempre está ahí, siempre actualizado y consultable en el instante antes de que un agente lo necesite.
Comprender. Corregir. Evolucionar.
El bucle tiene cuatro pasos, y se ejecutan en orden cada vez que el agente se pone a trabajar.
Primero, Codna mapea el repositorio — analizando el proyecto en un índice estructural de archivos, símbolos, dependencias y grafos de llamadas. Segundo, comprende ese mapa, resolviendo cómo se relacionan las piezas para que una consulta sobre una función conozca el código que la llama y el código del que depende. Tercero, cuando llega una tarea, Codna recupera el contexto — extrayendo el fragmento exacto de la base de código que toca el cambio, y nada más. Cuarto, guía al agente, entregándole ese contexto enfocado para que el agente de programación edite con la misma conciencia que un ingeniero senior llevaría en la cabeza.
Comprender. Corregir. Evolucionar. El nombre es deliberado. La comprensión precede a la corrección porque una corrección sin comprensión es una suposición, y la evolución — refactorizaciones, migraciones, la mejora gradual de un sistema a lo largo del tiempo — solo es segura cuando cada cambio está fundamentado en el conjunto.
Lo que cambia el contexto preciso
Cuando el agente deja de leer a ciegas, la diferencia se nota en el trabajo, no en la demo.
- Las ediciones aterrizan en el lugar correcto porque el agente puede ver cada llamador de la función que está modificando
- El gasto en tokens cae porque el modelo no paga por releer archivos en cada turno
- Las refactorizaciones son más seguras, ya que el mapa expone el radio de impacto completo de un cambio antes de que se publique
- Incorporarse a un repositorio desconocido deja de ser un juego de adivinanzas — la estructura ya está trazada
Esta es la línea entre un agente de programación con IA y una verdadera inteligencia de código. Uno lee todo lo que puede permitirse. El otro sabe qué leer antes de empezar. Entre las herramientas de asistente de código con IA, la distinción es fácil de pasar por alto en una prueba rápida e imposible de ignorar a lo largo de un trimestre de trabajo real — es lo que separa un autocompletado inteligente del mejor asistente de código con IA para una base de código que realmente hay que mantener.
Construido para los repositorios que ya tienes
Codna funciona con proyectos reales — los grandes, estratificados y parcialmente indocumentados, no los ejemplos ordenados de un tutorial. Trabaja junto a los agentes de programación que los equipos ya usan, incluso como asistente de código con IA para VS Code, de modo que el mapa informa a las herramientas que los desarrolladores utilizan en lugar de reemplazarlas. El objetivo nunca fue añadir otra ventana. Fue hacer que el agente en la ventana que ya tienes llegue sabiendo dónde está.
A medida que los sistemas crecen, la brecha entre leer código y comprenderlo solo se amplía, y los asistentes que la cierren serán los que mapeen antes de actuar. Codna está disponible, y está construido para ese futuro — donde comprender la base de código es lo primero que hacen tus herramientas, no lo último.