Context window, prompt y system prompt
Los tres conceptos suenan iguales, y esa confusión explica la mayoría de los fallos visibles con agentes. Operan en capas distintas. Saber cuál estás tocando en cada momento te evita "por qué el agente olvidó X" y "por qué responde raro hoy".
[[system-prompt|System prompt]] define identidad, [[prompts|prompt]] pide tarea, [[context-window]] es la memoria operativa de la sesión.
Las tres capas
System prompt — lo que el agente "es": sus capacidades, convenciones, límites, estilo. Se carga al inicio de la sesión y casi nunca cambia. Es la capa de identidad.
Prompt — lo que pides ahora: "renombra esta función", "implementa el feature X". Es imperativo, específico, efímero.
Context window — todo lo que el agente puede "ver" en esta sesión: los archivos leídos, los mensajes previos, el system prompt, los resultados de herramientas. Tiene un tamaño máximo (miles a cientos de miles de tokens según modelo). Cuando se llena, cosas antiguas se comprimen o se olvidan.
Qué pasa cuando saturas el contexto
El agente pierde detalles de la primera mitad de la sesión. Por eso a las 3 horas, "cambia los tabs a espacios" empieza a afectar archivos que ya eran correctos — olvidó la decisión previa.
Solución: system prompts bien hechos, specs en el repo, sesiones más cortas y enfocadas.
¿Tu sesión típica con Claude Code tiene system prompt explícito? Si no, una línea ahora: "Eres un agente que [stack + convenciones]. Nunca [lista de prohibidos]." Ponla en `CLAUDE.md`.
- System prompt = identidad estable; prompt = tarea efímera; context window = memoria operativa.
- Saturar el contexto hace que el agente "olvide" decisiones anteriores.
- Sesiones cortas + system prompt claro + specs en repo es el patrón para escala.