Antipatrones de contexto

Ya sabes meter buen contexto (CLAUDE.md, reglas) y dejar que Claude acumule el suyo (auto memory). Esta lección es el reverso: los cuatro hábitos que envenenan el contexto y que verás en casi todo el mundo que pelea con la herramienta. Cada uno tiene su antídoto en lo que ya has aprendido.

Antipatrón 1 · Contexto sin curar

El repo entero no es la ventana de contexto. Apuntar a Claude hacia node_modules/, .next/, dumps enormes o capturas gigantes llena la ventana de ruido, sube el coste y diluye lo que importa.

Se ve así: le pides un cambio pequeño y, antes de tocar nada, se pone a leer ficheros generados y dependencias durante varios turnos.

Antídoto: sé explícito con @ sobre qué mirar ("revisa @src/auth/login.ts"). Para búsquedas amplias por todo el repo, delega en un subagente o una sesión aparte (lo ves en el curso de subagentes) en vez de arrastrarlo todo a la principal. La ventana es escasa: trátala como tal.

Antipatrón 2 · "Haz todo a la vez"

Pedir "refactoriza la app, añade tests y arregla los lints" en un solo prompt. El agente intenta avanzar en tres frentes, mezcla cambios y produce un mejunje difícil de revisar.

Se ve así: el diff toca veinte ficheros por tres motivos distintos y no sabes por dónde empezar a revisarlo.

Antídoto: una tarea acotada por hilo. Ciérrala, revísala, commitea, y entonces la siguiente. /compact si una tarea larga deriva; /clear al cambiar de tarea. El agent loop rinde cuando el objetivo es concreto.

Antipatrón 3 · Aceptar diffs a ciegas

El agente puede equivocarse. Si aceptas cada diff sin leerlo, lo único que has cambiado es a quién culpar cuando algo se rompe.

Se ve así: pulsas "aceptar" en automático y dos horas después descubres que borró una validación que importaba.

Antídoto: lee el diff. ¿Toca lo que esperabas? ¿No se llevó nada por delante? Aprobar es tu trabajo, no un trámite. Y si una corrección se repite, ya sabes: a CLAUDE.md (regla de oro).

Antipatrón 4 · No usar git

Dejar que el agente toque media docena de ficheros sin un solo commit intermedio. Cuando algo sale mal, no tienes punto de retorno y "deshacer" se vuelve arqueología.

Se ve así: algo se rompió en algún punto de la última hora y no hay un commit limpio al que volver.

Antídoto: commitea cada vez que algo funcione. Es gratis y convierte cada paso bueno en un checkpoint. Con red, puedes dejar al agente arriesgar más, porque revertir es un comando.

El hilo común

Los cuatro son la misma idea desde ángulos distintos: el contexto es un recurso que se gestiona, no un cubo donde echarlo todo. Curado, acotado, revisado y respaldado por git.

Qué llevas hasta aquí

• Reconoces los cuatro antipatrones y, más importante, sabes cómo se ven en vivo.
• Tienes el antídoto de cada uno con herramientas que ya usas (@, /clear, leer diffs, git).

Cierre del curso

Tu repo ya no parte de cero en cada sesión: tienes un contrato (CLAUDE.md) bien colocado en su jerarquía, reglas por tema, la memoria del agente bajo control y los antipatrones identificados.

El siguiente paso del plan pasa de lo blando —instrucciones que el agente intenta seguir— a lo que se cumple de verdad: permisos, settings y seguridad, donde decides qué puede hacer el agente sin pedirte permiso.

Fuente oficial: Best practices · Context window