Ingeniería de contexto

Seleccionar el contexto útil para la siguiente decisión sin arrastrar el repositorio, logs e historial completos a cada llamada.
Actualizado 11 oct 2026

El modelo solo puede utilizar la información que entra en la llamada actual. La ingeniería de contexto consiste en seleccionar qué necesita para la siguiente decisión y mantener fuera el resto hasta que vuelva a ser relevante.

La aplicación puede conservar el repositorio, el historial completo, logs y otros artefactos sin enviarlos todos en cada inferencia. Si después hacen falta, recupera la parte concreta que necesita el modelo.

Seleccionar el contexto de la siguiente llamada El repositorio completo, el historial largo, un log grande y los artefactos siguen disponibles fuera del contexto. La selección recupera solo las instrucciones aplicables, el error actual, el fichero relevante y la información necesaria para la siguiente decisión. Disponible fuera del contexto Repositorio completoHistorial largoLog de 10.000 líneasArtefactos y resultados Seleccionar / recuperar Solo lo necesario ahora Contexto de la siguiente llamada Instrucciones aplicablesError actualFichero relevanteInformación necesaria para decidir Después se puede recuperar más Seleccionar el contexto de la siguiente llamada El repositorio completo, el historial largo, un log grande y los artefactos siguen disponibles fuera del contexto. La selección recupera solo las instrucciones aplicables, el error actual, el fichero relevante y la información necesaria para la siguiente decisión. Disponible fuera del contexto Repositorio completoHistorial largoLog de 10.000 líneasArtefactos y resultados Seleccionar / recuperar Solo lo necesario ahora Contexto de la siguiente llamada Instrucciones aplicablesError actualFichero relevanteInformación necesaria para decidir Después se puede recuperar más
Figura 1. El material completo sigue disponible fuera de la llamada; al contexto solo entra lo necesario para la siguiente decisión.

Contexto para la siguiente decisión

Un agente que está arreglando un test puede necesitar las instrucciones aplicables, el error actual, el fichero que modifica y las decisiones que siguen vigentes. El resto del repositorio y una hora de comandos ya descartados pueden seguir disponibles fuera del contexto.

La selección cambia durante la tarea. Después de modificar el código, el error antiguo puede dejar de importar y el resultado del nuevo test pasa a ser la evidencia principal.

Ficheros como AGENTS.md forman parte del mismo problema. Sus reglas tienen que llegar al modelo cuando aplican, pero unas instrucciones enormes consumen contexto de forma repetida y hacen más difícil localizar lo relevante.

Resultados grandes de tools

Una tool puede producir mucho más contenido del necesario para el siguiente paso. Si un comando devuelve 10.000 líneas, el log completo puede guardarse como artefacto y un filtro determinista extraer errores, coincidencias o una región concreta.

Conviene conservar sin resumir aquello donde el detalle exacto puede cambiar la decisión: un stack trace, un comando, un identificador o un fragmento de código. El modelo puede recibir solo la región necesaria y recuperar el original si después necesita más contexto.

Sesiones largas y compactación

Una sesión larga acumula mensajes, resultados y decisiones anteriores. Al acercarse al límite de contexto, el harness puede compactar parte de esa historia en una representación más pequeña.

Para continuar suelen importar el objetivo, los cambios realizados, las restricciones vigentes y los problemas pendientes. Un resumen puede conservar todo eso y aun así perder una línea concreta de un stack trace o el output exacto de un comando.

Los detalles que deban recuperarse con precisión deberían vivir en ficheros, commits, resultados de test u otros artefactos externos. La compactación mantiene la sesión utilizable; los artefactos conservan la evidencia exacta.

Handoffs

Al pasar el trabajo a otra sesión o agente se aplica la misma selección. Un handoff útil incluye el objetivo, el estado actual, las decisiones que siguen vigentes y referencias a los artefactos importantes. No necesita reproducir toda la conversación para permitir que el trabajo continúe.

Referencias