Todos los artículos

    Nota de arquitectura

    29 de marzo de 2026por Gustavo Teixeira Cuco4 min de lectura

    Ingeniería de Contexto

    Contexto de arquitectura

    Método reutilizable

    Información y contexto

    Aplicado en

    Agents & SkillsTHE iCON
    Ingeniería de Contexto
    Ver en LinkedIn

    Lo que solía llamar "documentación" es, en realidad, el producto real de mi trabajo con IA.

    Durante meses construí archivos de contexto, estructuré repositorios con archivos CLAUDE.md, creé sistemas de memoria persistente por proyecto. Lo llamaba "mantener las cosas organizadas". Lo que en realidad estaba haciendo era ingeniería de contexto — solo que no tenía un nombre para ello.

    Tobi Lütke, CEO de Shopify, le puso nombre en junio de 2025: "Me gusta mucho más el término 'ingeniería de contexto' que ingeniería de prompt. Describe mejor la habilidad esencial: el arte de proporcionar todo el contexto necesario para que la tarea sea plausiblemente resoluble por el LLM." Andrej Karpathy afinó la definición: "la ingeniería de contexto es el arte y la ciencia delicados de llenar la ventana de contexto con exactamente la información correcta para el siguiente paso."

    No se trata del prompt perfecto. Se trata de lo que hay en la ventana de contexto cuando el modelo necesita actuar.

    Qué cambió — y por qué ahora

    La ingeniería de prompt tenía sentido en 2022–2023. Era la habilidad de formular la pregunta correcta. Funcionaba para tareas aisladas. Pero cuando los equipos pasaron de las demos a sistemas en producción — agentes, flujos de trabajo multietapa, memoria persistente —, el prompt dejó de ser el cuello de botella.

    La mayoría de los fallos en agentes de producción no son fallos del modelo. Son fallos de contexto. Poco contexto y el modelo alucina. Demasiado, o mal estructurado, y pierde el hilo. El punto óptimo no es trivial — y no se resuelve con una mejor redacción.

    Si la ingeniería de prompt era encontrar la frase mágica, la ingeniería de contexto es escribir el guion completo.

    Cómo es, en la práctica, una arquitectura de contexto real

    El cambio se vuelve concreto cuando se observa cómo están realmente estructurados los sistemas de IA bien gobernados. Una configuración lista para producción no depende de un único archivo de instrucciones. Distribuye el contexto en capas: un prompt de sistema que define comportamiento y salvaguardas; documentación modular que cubre contexto de negocio, arquitectura, reglas de diseño y estado de ejecución; una matriz de disparadores que asocia cada tipo de cambio con el documento exacto que debe actualizarse; y un registro de decisiones que preserva el razonamiento detrás de elecciones no evidentes.

    Cada capa responde a una pregunta distinta que el modelo pueda tener. Juntas, eliminan la necesidad de reexplicar el sistema en cada tarea.

    Eso no es documentación. Es infraestructura.

    La pregunta que realmente importa

    En entornos empresariales, esto no es solo un problema de diseño. Es también un problema de gobernanza: ¿quién es el dueño del contexto, quién lo actualiza y quién es responsable cuando se desactualiza?

    Si estás construyendo con IA en producción, la pregunta ya no es "¿qué modelo deberíamos usar?". Es "¿qué entra en el contexto, en qué orden, y quién es responsable de mantenerlo actualizado?".

    La ingeniería de contexto es la respuesta a esa pregunta. Y, como toda buena ingeniería, empieza con claridad sobre el problema — no con palabras mágicas.

    ¿Cómo estás gestionando el contexto persistente en tus sistemas? Deja un comentario.

    Fuentes