Higiene de Contexto
La práctica mensual de auditar el Índice de Contexto en busca de obsolescencia, redundancia y vacíos para mantener la calidad del conocimiento consumido por los agentes.
Definición
La Higiene de Contexto es la práctica mensual de auditar el Índice de Contexto en busca de obsolescencia, redundancia y vacíos. La calidad de la salida del agente se degrada cuando la base de conocimiento que consume contiene información desactualizada — esquemas de API obsoletos, decisiones arquitectónicas reemplazadas o documentación de dominio caducada. La Higiene de Contexto previene esta degradación mediante una revisión sistemática.
La ceremonia es responsabilidad del Arquitecto de Contexto y generalmente dura de dos a cuatro horas, dependiendo del tamaño del Índice de Contexto.
Las actividades incluyen:
- Eliminar contenido obsoleto — identificar y archivar esquemas de API para endpoints retirados, documentación de bibliotecas desactualizada, registros de decisiones arquitectónicas reemplazadas y ejemplos de código que hacen referencia a patrones obsoletos. Dejar contenido obsoleto en el Índice de Contexto arriesga que los agentes generen código contra interfaces que ya no existen.
- Añadir contexto para nuevos sistemas — cuando se hayan introducido nuevos servicios, API o módulos desde la última revisión, añadir sus esquemas, documentación y Muestras Doradas relevantes al Índice de Contexto. Las lagunas en la cobertura obligan a los agentes a inferir el comportamiento en lugar de consultar la documentación, lo que aumenta la Tasa de Corrección.
- Validar referencias de Live Spec — verificar que las Especificaciones en Vivo activas hagan referencia a fuentes actuales en el Índice de Contexto. Una especificación que haga referencia a un esquema de API obsoleto producirá una salida de agente que se compilará contra la interfaz incorrecta. Esta interconexión detecta enlaces rotos entre las especificaciones y el conocimiento del que dependen.
- Deduplicar y consolidar — identificar entradas redundantes que cubren la misma información en diferentes formatos o con diferentes granularidades. La redundancia malgasta el Presupuesto de Tokens cuando los agentes recuperan contenido superpuesto y aumenta el riesgo de información contradictoria.
La cadencia es mensual porque la deriva del Índice de Contexto es gradual — las entradas individuales no se vuelven obsoletas de la noche a la mañana, pero a lo largo de las semanas el efecto acumulativo es medible. Los equipos con bases de código que evolucionan rápidamente o cambios frecuentes de API pueden beneficiarse de revisiones quincenales.
La Higiene de Contexto se enmarca dentro de la cadencia de ceremonias mensuales más amplia, junto con la Auditoría de Límites y la Revisión de FinOps.