El secreto de las mejores aplicaciones de IA no está en el modelo... está en el contexto

Search for a command to run...

No comments yet. Be the first to comment.
Línea de apertura (opcional, para el feed): Claude Code empieza cada sesión desde cero. No recuerda qué archivos modificaste ayer. No recuerda el bug que arreglaste la semana pasada. No recuerda que m

Línea de apertura (opcional, para el feed): En cada sesión nueva, Claude abre el README, escanea el árbol de directorios, busca el pom.xml, encuentra src/main/java... 33 tool calls para orientarse. Co

Línea de apertura (opcional, para el feed): Llevas tres meses usando Claude en tu proyecto Java. Los mismos errores de hace tres meses siguen apareciendo. == para comparar BigDecimal. LocalDate.now()

Línea de apertura (opcional, para el feed): Tu equipo hizo commit directo a main porque "era un cambio pequeño". Dos horas después, toda la rama de producción estaba rota, tres desarrolladores bloquea

Línea de apertura (opcional, para el feed): Llevas seis meses usando Claude para tus decisiones de arquitectura Java. Eres más rápido. Pero ya no sabes si elegirías Spring Security + JWT o Keycloak si

Cuando la mayoría de las personas empieza a desarrollar aplicaciones con IA, suele pensar que el camino para obtener mejores resultados es:
Usar un modelo más potente.
Escribir mejores prompts.
Aumentar la ventana de contexto.
Pero los equipos que construyen productos como GitHub Copilot, Claude Code, Cursor o Amazon Q saben que existe otro factor mucho más importante:
La forma en que organizas y entregas el contexto a la IA.
No se trata de enviar más información.
Se trata de enviar la información correcta, en el momento correcto.
Veamos tres técnicas que están detrás de muchas aplicaciones modernas de IA.
Imagina que alguien pregunta:
"¿Cómo despliego un microservicio Spring Boot en Kubernetes?"
Una IA mal diseñada podría cargar toda la documentación de:
Java
Spring
Docker
Kubernetes
Azure
Terraform
Kafka
Oracle Database
Seguridad
Microservicios
Aunque gran parte de esa información nunca será utilizada.
Una IA bien diseñada hace algo diferente.
Divide el conocimiento en pequeñas habilidades especializadas.
Resolver consulta │
├── Java / Spring Boot
├── Docker
├── Kubernetes
└── Cloud (Azure / OCI / AWS)
Cuando llega una consulta, solo activa las habilidades necesarias.
Es exactamente el mismo principio que usamos al construir microservicios:
componentes pequeños,
especializados,
fáciles de mantener.
✅ Menor consumo de tokens.
✅ Menor costo.
✅ Respuestas más rápidas.
✅ Mejor precisión.
Ahora imagina una empresa con miles de documentos.
Si preguntas:
"¿Cómo funcionan los Virtual Threads?"
La IA no debería revisar absolutamente toda la documentación.
Lo ideal es darle una pista.
Por ejemplo:
Si la consulta es sobre Java 21, consulta primero:
/java-21/*
ó
Si la consulta es sobre Kubernetes, usa:
/kubernetes/*
Las Discovery Hints funcionan como los letreros de un aeropuerto.
No contienen la respuesta.
Simplemente indican el camino correcto.
Gracias a eso, la IA encuentra mucho más rápido la información relevante.
Este problema lo hemos sufrido todos los desarrolladores.
Preguntas:
"¿Cómo implementar Virtual Threads?"
Y la respuesta mezcla ejemplos de Java 19, Java 21 y Java 25.
Resultado:
❌ Código incorrecto.
❌ APIs obsoletas.
❌ Ejemplos incompatibles.
Una buena arquitectura de IA mantiene el conocimiento separado por versiones.
Java 25 │
├── Structured Concurrency
├── Scoped Values
└── Virtual Threads
Java 21 │
└── Virtual Threads
Java 17 │
└── Sin Virtual Threads
Cuando el usuario indica la versión, la IA carga únicamente la documentación correspondiente.
Así evita mezclar conceptos de distintas versiones.
Las tres persiguen exactamente el mismo objetivo:
Reducir el ruido y aumentar la precisión.
Muchas personas creen que mientras más contexto tenga un modelo, mejores serán sus respuestas.
En la práctica ocurre algo diferente.
Cuando mezclamos demasiada información:
aumenta el costo,
aumenta la latencia,
aumenta la probabilidad de errores,
y la IA pierde el foco.
Una buena arquitectura de contexto consiste en entregar solo aquello que realmente necesita.
Supongamos que un desarrollador pregunta:
"¿Cómo desplegar un microservicio Spring Boot en Azure Kubernetes Service?"
La IA podría activar únicamente estas habilidades:
Consulta
│
▼
Java 21
│
Spring Boot
│
Docker
│
Kubernetes
│
Azure AKS
No necesita cargar documentación sobre Kafka, Oracle Database, Terraform o Quarkus si la consulta no está relacionada con ellos.
Eso hace que la respuesta sea más rápida, más precisa y más económica.
Cuando hablamos de IA solemos enfocarnos en el modelo.
Pero, a medida que las aplicaciones crecen, la arquitectura del contexto se vuelve tan importante como el propio modelo.
Los mejores asistentes de IA no destacan porque "lo saben todo".
Destacan porque saben exactamente qué conocimiento utilizar para cada tarea.
En otras palabras:
🧩 Dividen el conocimiento en habilidades especializadas (Skill Composition).
🧭 Guían a la IA hacia la información correcta (Discovery Hints).
🏷️ Cargan únicamente la documentación de la versión adecuada (Version-Specific Context).
Ese enfoque permite construir aplicaciones de IA más rápidas, más precisas y con un menor costo operativo.
💡 La IA no es más inteligente porque tenga más contexto. Es más inteligente cuando recibe únicamente el contexto correcto.
Esa es una de las ideas que está detrás de muchas de las aplicaciones de IA más avanzadas que usamos hoy.
Enjoy!
Joe