PTENES
MÓDULO 2.4

🧠 Contexto y tokens

La calidad de un agente no es fija: se deteriora cuanto más larga se vuelve la sesión. Cuanto más se llena la conversación, más se convierte la ventana en ruido y más "se desvía" el agente. Este módulo te da la disciplina para gestionar el contexto y los tokens: saber leer los umbrales, cuándo dar /compact, cuándo dar /clear, y cómo mantener cada sesión breve para que la calidad se mantenga alta de principio a fin.

6
Temas
~40
Minutos
Inter.
Nivel
Disciplina
Tipo
Progreso del módulo 0% · 0 de 6

Piensa en la ventana de contexto como el tanque de combustible de la sesión. Cada mensaje tuyo, cada respuesta del agente, cada archivo leído y cada herramienta cargada ocupa tokens — fragmentos de texto que el modelo tiene que «mantener en la cabeza» al mismo tiempo. El tanque tiene una capacidad fija. A medida que se llena, la calidad no cae de repente: se va degradando. Alrededor de ~60% de uso, los errores empiezan a aparecer. La buena noticia: tienes dos pedales — /compact e /clear — para recuperar el aliento antes de que el tanque se desborde.

Tanque de contexto — se llena a medida que crece la sesión → ~80% ~60% · la calidad empieza a caer alta calidad calidad en descenso ~70% → /compact 85%+ → /clear

Diagrama ilustrativo — el tanque se llena con el historial de la conversación; empieza a «leer el medidor» y usa /compact alrededor del 70% y /clear por encima del 85% para que la calidad no se desplome.

1

🍂 Context rot — degradación después de ~60%

Qué es

Context rot ("deterioro del contexto") es la degradación gradual de la calidad de las respuestas cuanto más larga se vuelve una única sesión. No es un bug ni un modelo «cansado»: es una consecuencia de cómo la atención del modelo funciona. Cuanto más texto hay en la ventana, más cosas tiene que ponderar la IA a la vez; y, pasado cierto punto (en la práctica, alrededor de ~60% de uso), los errores empiezan a aparecer.

¿Qué es?Ventana de contexto — todo lo que el modelo «ve» ahora: tus mensajes, las respuestas, los archivos leídos y las instrucciones. Token — el fragmento de texto que cuenta el modelo (una palabra suele equivaler a entre 1 y 3 tokens). La ventana tiene un límite de tokens.

El mecanismo es fácil de visualizar: a medida que la conversación crece, la ventana se llena de historial ruidoso — intentos fallidos, archivos que ya no usas, idas y vueltas. Los mensajes recientes (que muchas veces no son las más importantes) empiezan a «ahogar» las reglas centrales del principio. El agente empieza a olvidar instrucciones, repetir lo que ya hizo o mezclar cosas: síntomas clásicos de un contexto inflado.

Por qué aprender

Quien no conoce el context rot culpa al modelo («la IA se volvió tonta»), cuando el problema es que la sesión se alargó demasiado. Reconocer el patrón lo cambia todo: en vez de pelearte con el agente, tú vacía el tanque y la calidad vuelve.

  • •Diagnóstico correcto: "está mal" se convierte en "el contexto está lleno", que tiene solución.
  • •Calidad estable: intervienes antes de llegar al ~60%, no después del daño.
  • •Menos trabajo repetido: las sesiones cortas y limpias cometen menos errores y consumen menos tokens.

Conceptos clave

Se degrada gradualmente

No se cae de repente.

~60% es el umbral

Los errores empiezan ahí.

El ruido ahoga la regla

El historial oculta lo esencial.

Atención limitada

Raíz del fenómeno.

2

🚥 Los umbrales (0-50 / 50-70 / 70-85 / 85%+)

Qué es

En lugar de tratar el uso de la ventana como "llena o vacía", divídelo en cuatro niveles con acciones diferentes. Piensa en un semáforo: 0-50% es una zona segura: trabaja con libertad; 50-70% es el amarillo: empieza a pensar en compactar; 70-85% es naranja: ejecuta /compact proactivamente; 85%+ es la zona crítica: dale /clear y empieza de cero.

% de uso de la ventana de contexto → 0–50% · seguro trabaja a gusto 50–70% pensar en /compact 70–85% /compact ahora 85%+ /clear · empieza de nuevo 0% 50% 70% 85% 100%

Diagrama ilustrativo — los números son guías prácticas, no reglas exactas. El hábito que importa es: mira el medidor y actúa antes de llegar a la franja crítica.

Por qué aprender

Los umbrales convierten una sensación vaga («creo que se está volviendo confuso») en una rutina objetiva. Dejas de reaccionar ante el desastre y empiezas a actuar de forma preventiva: al llegar al 70%, compactar ya es un reflejo; al superar el 85%, reiniciar es automático. Es la diferencia entre conducir mirando el tablero y conducir hasta que el auto se detenga en la carretera.

🎯 Consejo práctico

Trata el umbral de 70% como un «checkpoint»: es el momento natural de pausar, ejecutar /compact y reevaluar si todavía tiene sentido continuar con la misma tarea. No esperes a que el agente empiece a equivocarse para mirar el medidor: para entonces ya será tarde.

Conceptos clave

0–50% seguro

Trabaja sin preocupaciones.

50–70% de atención

Considera compactar.

70–85% /compact

Compacta de forma proactiva.

85%+ /clear

Reinicia y vuelve a empezar.

3

🧹 /clear vs /compact

Qué es

Son los dos comandos para gestionar el tanque. /clear é o reinicio total: borra toda la conversación y empieza desde cero, con el contexto vacío: úsalo cuando sea cambiar de tarea o cuando la calidad ya se haya deteriorado por completo. /compact é o resumen inteligente: el agente condensa la conversación, guarda lo que importa (decisiones, estado actual, reglas) y comprime el resto — usa a mitad de una tarea larga, cuando el contexto está al límite pero todavía necesitas el historial.

¿Qué es?/clear = vaciar la caja (se pierde el historial y se gana contexto limpio). /compact = reducir la caja a un resumen (mantiene lo esencial y libera espacio). Regla práctica: cambio de tema → /clear; misma tarea, tanque lleno → /compact.

/clear — reinicio total contexto lleno /clear vacío empieza desde cero /compact — resumen inteligente contexto lleno /compact resumen de lo esencial /clear olvida todo · /compact recuerda lo importante en menos espacio

Diagrama ilustrativo — /clear cero; /compact comprime manteniendo decisiones y estado. Elige según tu intención: cambiar de tarea o continuar con la misma, pero con menos carga.

Por qué aprender

Usar el comando equivocado cuesta caro: dar /clear a mitad de una tarea larga borra el estado que todavía necesitabas (y reconstruyes todo a mano); dar /compact creer que va a "resumir" un cambio de tema deja residuos de la tarea anterior que contaminan la nueva. Saber cuál usar y cuándo es lo que distingue a quien mantiene la calidad de quien lucha con el agente.

✓ /clear cuando…

  • ✓Vas a empezar una tarea nueva y no relacionada.
  • ✓La calidad ya se degradó definitivamente (correcciones repetidas, olvidos).
  • ✓El tanque superó 85% y el historial anterior ya no importa.

✗ /compact cuando NO deberías

  • ✗Cambiar de tema pensando que el resumen «limpia» la tarea anterior.
  • ✗Compactar después de cada mensaje por ansiedad (solo pierdes detalles útiles).
  • ✗Usar /compact para «reparar» una sesión que ya está podrida: ahí es /clear.

🎯 Objetivo: recuperar la calidad cuando el contexto supera ~70%

comando (copia y ejecuta)
/compact

✅ Cómo verificar: el agente devuelve un resumen de lo importante; si la calidad sigue bajando o vas a cambiar de tarea, usa /clear.

Conceptos clave

/clear = borrar

Restablecimiento total de la conversación.

/compact = reducir

Resumen que conserva lo esencial.

¿Cambiaste de tarea?

/clear, siempre.

¿La misma tarea?

/compact a mitad de ella.

4

1️⃣ Una tarea por sesión

Qué es

La regla de higiene más simple y poderosa: una tarea por sesión. Te enfocas en un objetivo, lo terminas y das /clear y solo entonces empieza la siguiente. No reutilices una conversación saturada de una tarea anterior para hacer algo sin relación: ese es el camino más rápido hacia el deterioro del contexto.

¿Qué es?Sesión — una conversación continua con el agente, desde el inicio hasta que la reinicias. Conversación inflada — una sesión que acumuló demasiadas tareas, intentos y archivos, dejando la ventana llena de ruido.

1 inicio (limpio) 2 trabajo en la tarea 3 ~70% → /compact 4 tarea completada 5 cambiar de tarea → /clear Ciclo de vida de una sesión saludable

Diagrama ilustrativo — una tarea empieza limpia, se compacta a mitad de camino cuando pesa y termina en un /clear antes de que empiece la siguiente. Sesión corta = calidad alta.

Por qué aprender

El contexto limpio es precisión. Cuando la sesión solo tiene lo que importa para la tarea actual, el agente acierta más, alucina menos y gasta menos tokens, porque no vuelve a procesar el historial irrelevante en cada respuesta. Mezclar tareas en una misma conversación produce el efecto contrario: diluye el enfoque y quema tokens innecesariamente.

🎯 Consejo práctico

Antes de /clear, pídele al agente un resumen de lo decidido y pega lo esencial en el CLAUDE.md o en una nota. Así, la siguiente sesión empieza limpia e con el contexto correcto ya cargado — sin arrastrar la basura de la conversación anterior.

Conceptos clave

1 tarea = 1 sesión

Termina y luego reinicia.

No reutilices

Conversación inflada = ruido.

Limpio = preciso

Menos errores, menos tokens.

Resume antes

Guarda lo esencial y /clear.

5

🏁 Definir "listo" (evita el loop)

Qué es

Definir "listo" es darle al agente un criterio explícito para saber cuándo parar: una definition of done. Sin esto, un agente diligente sigue trabajando "para asegurarse": busca más, vuelve a hacer las cosas, amplía y consume tokens (y contexto) en un ciclo sin fin. Con un objetivo claro como "exactamente 75 perfiles", sabe cuál es la meta y se detiene al alcanzarla.

¿Qué es?Definición de terminado — la condición objetiva que indica «terminado» (una cantidad, un formato, un archivo generado). Loop — cuando el agente repite pasos sin avanzar, generalmente porque no sabe cuándo es suficiente.

Por qué aprender

Un loop no solo es lento: llena el tanque. Cada búsqueda extra, cada «déjame verificar de nuevo» acumula tokens en la ventana y acelera la degradación del contexto. Definir «listo» elimina el problema de raíz: el agente se detiene en el objetivo, la sesión es breve y no desperdicias tokens ni calidad. Es la forma más barata de proteger el contexto: prevenir el trabajo innecesario antes de que ocurra.

🎯 Objetivo: dar un criterio de detención explícito para evitar bucles y el gasto de tokens

prompt (cópialo y adáptalo)
pesquise exatamente 75 perfis de <cargo> em <setor>;
pare ao atingir 75 e me devolva a lista.

✅ Cómo verificar: el agente entrega 75 elementos y termina, sin quedarse «buscando más para asegurarse». Si continúa, refuerza el límite en el prompt.

🎯 Consejo práctico

Cada vez que pidas algo "abierto" (investigar, recopilar, generar variaciones), incluye un un número, un formato o una condición de parada. "¿Cuántos?", "¿hasta cuándo?", "¿en qué formato?" — responde estas tres preguntas en el propio prompt y el agente no entrará en un ciclo.

Conceptos clave

Objetivo explícito

"Exactamente 75 perfiles".

Condición de parada

Di cuándo «terminó».

Evita el ciclo

Sin «buscar por si acaso».

Ahorra tokens

Trabajo innecesario = cero.

6

💰 Ahorrar: skills, desactivar MCP, CLAUDE.md conciso

Qué es

Incluso antes del primer mensaje, parte del tanque ya está ocupada por cosas que cargan al empezar: o CLAUDE.md, las definiciones de cada servidor MCP, instrucciones de sistema. Ahorrar contexto consiste en accionar tres palancas: usar skills (que se cargan bajo demanda, solo cuando se activan, en vez de estar siempre en CLAUDE.md), desactivar MCP que no usas (cada servidor inyecta definiciones de herramientas en el contexto), y mantener el CLAUDE.md conciso (menos de ~500 líneas, solo lo que sirve para todas las sesiones).

¿Qué es?Skill — una capacidad que el agente carga solo cuando la necesita (bajo demanda), sin ocupar contexto todo el tiempo. MCP — un conector que proporciona herramientas al agente; cada uno añade definiciones a la ventana incluso cuando no se usa. CLAUDE.md — el archivo de instrucciones permanentes, que se carga en cada sesión.

Palancas de ahorro → menos contexto gastado al inicio antes tanque pesado skills bajo demanda en lugar de CLAUDE.md desactivar MCP no usado CLAUDE.md conciso < ~500 líneas después ↑ depósito ligero = más espacio para el trabajo de verdad

Diagrama ilustrativo — cada palanca libera espacio en la ventana. Combina las tres (más «una tarea por sesión») y tendrás una rutina de higiene del contexto.

Por qué aprender

El contexto que gastas al inicio es contexto que no queda para la tarea. Un CLAUDE.md de 1.500 líneas y cinco MCP conectados pueden consumir una parte importante de la capacidad antes de que escribas la primera palabra, y te acercan mucho más rápido al umbral de ~60 %. Mantener el contexto limpio no es un detalle avanzado: es lo que hace que tus sesiones sean largas, económicas y precisas.

✓ Higiene del contexto

  • ✓Skills cargadas bajo demanda, en vez de poner todo en CLAUDE.md.
  • ✓El MCP que no usas hoy se queda desactivado.
  • ✓CLAUDE.md < ~500 líneas, solo lo que sirve para todas las sesiones.
  • ✓Una tarea por sesión; /compact a ~70%, /clear al cambiar.

✗ Conversación inflada para todo

  • ✗Volcar todo el conocimiento en CLAUDE.md «por si acaso».
  • ✗Dejar diez MCPs activados sin usar ninguno durante la sesión.
  • ✗Una sola conversación gigante para todas las tareas del día.
  • ✗Nunca mires el medidor y solo des /clear cuando se bloquea.

Conceptos clave

Skills bajo demanda

Se cargan solo cuando se usan.

Desactivar MCP

Cada uno pesa en el contexto.

CLAUDE.md conciso

< ~500 líneas, solo lo esencial.

Higiene = rutina

Combina todas las palancas.

Al cerrar el módulo: tu medidor de contexto superó 85% y vas a empezar una tarea nueva. ¿Qué comando usar?

📌 Resumen del módulo

✓
Context rot — la calidad se degrada cuanto más larga es la sesión; los errores empiezan alrededor del ~60% de uso.
✓
Umbrales — 0-50% seguro · 50-70% atención · 70-85% /compact · 85%+ /clear.
✓
/clear vs /compact — empezar de cero para cambiar de tarea; resumir a mitad de una tarea larga.
✓
Una tarea por sesión — termina, ejecuta /clear y empieza la siguiente; limpio = preciso y barato.
✓
Definir "listo" — un objetivo explícito («exactamente 75 perfiles») evita bucles y gasto de tokens.
✓
Ahorro de contexto — skills bajo demanda, MCP desactivado, CLAUDE.md conciso: higiene del contexto.

Siguiente módulo:

2.5 — RAG & Datos