La ingeniería de contexto es decidir qué entra en la ventana de contexto del modelo en cada paso y qué queda afuera: instrucciones, archivos de reglas, resultados de herramientas, historial, documentos recuperados y resúmenes. Con un agente que trabaja muchos pasos, pesa más que la frase exacta del prompt, porque el modelo solo sabe lo que le llega.
Una pregunta de la app. Elige una respuesta.
El plan está aprobado, pero la charla arrastra tres intentos fallidos. ¿Cómo sigues?
Le llega lo que sirve y nada del ruido. El plan aprobado ya es el resumen que vale la pena llevar.
Lo sabe, pero los intentos fallidos siguen en su contexto y pueden llevarlo de vuelta a una idea que ya descartaste.
Es el mismo ruido en otra ventana. Pasar todo no es pasar lo importante.
Escribir bien un prompt es cuidar tu pedido. En un chat corto, el pedido es casi todo lo que el modelo ve. En un agente de código que va por el paso 30, tu pedido es una parte chica de la ventana de contexto: también están sus instrucciones, las reglas del proyecto, la descripción de cada herramienta, lo que devolvieron los 29 pasos anteriores y la charla.
El agente decide su próximo paso mirando todo eso junto. Si ahí falta un dato o sobra ruido, el mejor prompt no lo salva. Por eso se habla de ingeniería de contexto: el trabajo es armar lo que el modelo ve en cada paso, no solo la frase con que empiezas.
Lo fijo, que se carga siempre: un archivo como CLAUDE.md, corto, con lo que no se deduce del código. Lo que se trae cuando hace falta: un archivo que el agente abre, los fragmentos que encuentra una búsqueda con RAG o un skill que carga sus instrucciones solo para esa tarea.
Y lo que se recorta: un log de 5.000 líneas entra mejor como las 20 líneas del error; una charla larga, como un resumen; una búsqueda que lee medio repo, en un subagente que devuelve solo lo que encontró.
Una ventana llena cuesta más tokens en cada paso, y en textos muy largos muchos modelos atienden menos lo que está en el medio. Un dato viejo puede contradecir al nuevo: si la ventana tiene la versión anterior de un archivo y la actual, el modelo puede tomar la equivocada.
El orden también cuenta para el costo. Con caché de prompts, lo que va al principio y no cambia (instrucciones, reglas) se cobra más barato en cada paso. Si eso cambia a cada rato, la caché no sirve.
«Con una ventana enorme, le paso todo.» Entra, pero se paga y se diluye. «Es otro nombre para escribir prompts.» El prompt es una pieza; el contexto es todo lo que el modelo ve. «Es cosa de empresas grandes.» Si eliges qué documento pegar en el chat y qué parte, ya lo estás haciendo.