Dar el contexto adecuado a un agente de código

Le pides un nuevo endpoint. El agente lo produce: correcto, probado, legible. Utiliza requests cuando todo el proyecto está en httpx, devuelve un diccionario sin procesar donde tus otras doce rutas devuelven un esquema Pydantic, y escribe sus mensajes de error en inglés en una base completamente francófona. Pasas veinte minutos adaptando ese código a las normas de la casa, veinte minutos que te habrías ahorrado escribiendo tres líneas de contexto al principio.

Es el error de planteamiento más frecuente y el peor diagnosticado. Se atribuye a la herramienta («no entiende mi proyecto») cuando es puramente informacional: un agente solo ve lo que entra en su ventana de contexto. Tus convenciones no están escritas en ninguna parte, viven en la repetición de un patrón a lo largo de decenas de archivos: algo que una persona absorbe en una semana de lectura y que una máquina solo puede inferir si le muestras los archivos pertinentes. El reflejo contrario es igual de costoso: mostrarlo todo degrada la calidad en lugar de mejorarla. La competencia, aquí, consiste en elegir.