En pocas palabras
Entrega al agente información detallada solo cuando la tarea y la etapa del trabajo la requieren.
Qué problema resuelve
Contexto saturado de instrucciones irrelevantes que encarece y dificulta el razonamiento.
Cuándo utilizarlo
Agentes con muchas herramientas o dominios. Ejemplo: cargar políticas de pagos únicamente en una tarea de pagos.
De la idea a la práctica
Funcionamiento, ejemplos y decisiones para pasar al siguiente nivel.
En el Radar compartido: Trial (valoración de la edición aportada).
Cómo funciona
La fase inicial presenta capacidades y enlaces. Después se recuperan instrucciones y evidencias pertinentes, manteniendo disponibles los recursos restantes sin cargarlos completos.
Ejemplo de uso
Ofrecer un catálogo de skills con descripciones cortas. Ante una migración, cargar la skill de actualización y la guía del framework; consultar otros documentos solo si aparecen dependencias relacionadas.
Por qué no cargar todo
El contexto de un modelo es limitado y su rendimiento se degrada a medida que crece: la información relevante se diluye entre la irrelevante, aumentan el coste y la latencia, e instrucciones contradictorias compiten entre sí. Cargar «por si acaso» toda la documentación del repositorio suele empeorar los resultados.
Niveles de revelación
| Nivel | Contenido | Ejemplo |
|---|---|---|
| 0. Siempre presente | Instrucciones esenciales y breves | Comandos de build y test, reglas que nunca se rompen |
| 1. Índice | Qué existe y dónde, en una línea cada cosa | Lista de skills, mapa de carpetas, índice de ADR |
| 2. Bajo demanda | Detalle de lo que la tarea necesita | Guía de migración, documentación de un módulo |
| 3. Recuperación puntual | Fragmentos concretos encontrados al buscar | Una función, un párrafo de una norma |
Patrones de implementación
| Patrón | Cómo |
|---|---|
| Instrucciones jerárquicas | Un AGENTS.md raíz breve y otros por subcarpeta que se cargan al trabajar allí |
| Agent Skills | Solo nombre y descripción hasta que se necesitan |
| Herramientas de búsqueda | El agente busca (grep, índices, Context7) en lugar de recibir todo |
| Documentos índice con enlaces | Un README que apunta a guías detalladas en lugar de contenerlas |
| Subagentes | Exploran en su propio contexto y devuelven un resumen |
| Resultados de herramientas acotados | Paginación y resúmenes en lugar de volcar 10 000 filas |
Ejemplo de instrucciones raíz
# AGENTS.md
- Build: `./mvnw -q verify`. Tests rápidos: `./mvnw -q test -pl <módulo>`.
- Nunca edites migraciones ya aplicadas en `db/migrations/`.
- Arquitectura y decisiones: `docs/adr/README.md` (índice; abre solo el ADR relevante).
- Cada módulo tiene su propio `AGENTS.md` con convenciones específicas.
- Procedimientos (despliegue, migraciones de framework): skills en `.claude/skills/`.Diez líneas que dicen dónde encontrar las cosas valen más que mil líneas que intentan contarlo todo.
Evaluar el diseño
- ¿El agente encuentra el documento correcto para tareas representativas? Revisa las trazas de lectura.
- ¿Respeta las reglas del nivel 0 incluso en sesiones largas?
- ¿Cuántos tokens consume una tarea típica antes de empezar a trabajar?
Es una aplicación concreta de context engineering.
Criterios de implementación
Evaluar si el agente encuentra el recurso correcto y si conserva restricciones importantes. Mantener trazabilidad de las fuentes y evitar que documentos recuperados sustituyan instrucciones de mayor prioridad.
Continúa en las fuentes
Documentación oficial para verificar detalles y explorar más.