Pinguy Learning
Temario · lección 28 de 74
0Empieza aquí
1Por qué fallan los agentes
2Qué es un harness
3Patrones de agentes
4Herramientas
5Ingeniería de contexto
6El repositorio como memoria
7Tareas largas
8Alcance y “hecho” de verdad
9Observabilidad y estado limpio
10Loops y grafos
11Harness reales
12Proyecto final
Ingeniería de contexto· 8 min de lectura

Compactación, notas y subagentes

En 30 segundos

Cuando una tarea es más larga que la ventana, hay tres técnicas: resumir la conversación, escribir notas fuera del contexto y repartir el trabajo entre subagentes.

Cuando el trabajo no cabe

Migrar un código enorme o investigar un tema a fondo puede llevar horas, y el texto generado supera con mucho la ventana. Esperar a ventanas mayores no basta, porque seguiría el context rot. Anthropic propone tres técnicas: compactación, notas estructuradas y subagentes.

1. Compactación

Compactar es coger una conversación a punto de llenar la ventana, resumirla y empezar una ventana nueva con ese resumen. Es la primera palanca para mantener la coherencia a largo plazo.

En Claude Code, el historial se pasa al modelo para que lo comprima conservando lo esencial: decisiones de arquitectura, bugs sin resolver y detalles de implementación; descarta salidas de herramientas y mensajes redundantes. Después continúa con el resumen más los cinco archivos consultados más recientemente.

El arte está en qué conservar. Si compactas con demasiada agresividad, pierdes detalles sutiles cuya importancia solo se ve más tarde. Anthropic aconseja probar el prompt de compactación con trazas reales: primero maximiza que no se pierda nada, luego afina quitando lo sobrante.

La forma más suave y segura es limpiar resultados de herramientas ya usados. Una vez que el agente ejecutó algo hace mucho, ¿para qué necesita ver otra vez el resultado en bruto?

2. Notas estructuradas

Aquí el agente escribe notas fuera de la ventana (en un archivo) y las relee más tarde. Cuesta muy poco y da memoria persistente: una lista de tareas, un NOTES.md.

Anthropic cita a Claude jugando a Pokémon: lleva la cuenta exacta de miles de pasos, dibuja mapas de zonas exploradas y anota qué ataques funcionan mejor. Tras un reinicio de contexto, lee sus notas y sigue.

# NOTES.md
## Hecho
- Migrados los módulos auth y pagos
## Pendiente
- Módulo informes (depende de pagos)
## Decisiones
- Usamos fechas en UTC en todas partes

Esta idea reaparece en el módulo de tareas largas con el diario progress.md.

3. Subagentes

En vez de un agente que lo recuerda todo, varios especializados trabajan con ventanas limpias. El principal coordina con un plan general. Cada subagente puede explorar a fondo, usando decenas de miles de tokens, pero devuelve solo un resumen condensado (a menudo 1.000-2.000 tokens). Así el detalle queda aislado y el agente principal se dedica a sintetizar. Anthropic señala una mejora notable frente a un agente único en tareas de investigación complejas.

Cuál elegir

TécnicaEncaja cuando…
CompactaciónHay mucho ir y venir de conversación
NotasDesarrollo iterativo con hitos claros
SubagentesInvestigación o análisis donde explorar en paralelo compensa
Comprueba lo aprendido

¿Cuál es la ventaja de un subagente?

El detalle de la exploración queda aislado en el subagente; el principal recibe un resumen breve y mantiene su contexto limpio.

Fuentes: Anthropic, Effective context engineering for AI agents