Manejo de Contexto

El Contexto Lo Es Todo

🔄 Repaso rápido: En la lección anterior, exploramos los comandos esenciales como /add, /clear y /compact. Ahora construyamos sobre esa base para aprender a usar esos comandos estratégicamente.

Las respuestas de Claude Code son tan buenas como el contexto que le das. Dale los archivos correctos y te da respuestas geniales. Dale cosas irrelevantes y te da respuestas confusas.

El manejo de contexto no es solo agregar archivos. Es curar estratégicamente lo que Claude ve para obtener los resultados que necesitas.

Cómo Funciona el Contexto

Piensa en el contexto de Claude como un escritorio. Superficie limitada. Todo lo que está en el escritorio compite por atención.

Escritorio pequeño y organizado: Encuentras las cosas. Trabajas eficientemente.

Escritorio enorme y desordenado: Las cosas se pierden. Pierdes el foco.

Lo mismo con Claude. Unos pocos archivos relevantes le ganan a docenas de archivos vagamente relacionados.

El Principio de Contexto Mínimo Viable

Antes de agregar cualquier cosa, pregúntate: “¿Claude necesita esto para la tarea actual?”

Sí, agrégalo:

• Archivos que estás preguntando o modificando
• Archivos que definen interfaces que se están usando
• Archivos con patrones que quieres que siga
• Archivos de tests que muestran comportamiento esperado

No, déjalo fuera:

• Directorios completos “por si acaso”
• Archivos tangencialmente relacionados al tema
• Archivos de configuración grandes que Claude no va a cambiar
• Documentación que Claude no necesita referenciar

Cuando no estés seguro: Empieza sin el archivo. Agrégalo si Claude parece estar perdiendo información.

Estrategia de Capas de Contexto

Construye el contexto en capas, de lo general a lo específico.

Capa 1: Entendimiento del Proyecto

/add README.md package.json

Info de alto nivel. ¿Qué es esto? ¿Qué stack usa?

Capa 2: Contexto Arquitectónico

/add src/index.js src/routes.js

Puntos de entrada y estructura. ¿Cómo está organizado?

Capa 3: Contexto de Feature

/add src/auth/*.js

El área específica en la que estás trabajando.

Capa 4: Contexto de Tarea

/add src/auth/login.js src/auth/types.ts

Los archivos exactos para tu tarea actual.

No siempre necesitas todas las capas. Para un bug fix simple, ve directo a la capa 4.

✅ Revisión Rápida: Si necesitas arreglar un bug en un solo archivo, ¿necesitas las 4 capas de contexto? ¿Por qué sí o por qué no?

Leyendo las Señales del Contexto

Claude te dice cuando el contexto anda mal:

“No veo…” Le falta un archivo. Agrégalo.

Referencias a código que no existe Claude está adivinando porque no tiene el código real. Agrega los archivos fuente.

Estilo o patrones inconsistentes Claude no ha visto tu código existente. Agrega ejemplos de los patrones que quieres.

Respuestas muy lentas El contexto puede estar demasiado grande. Prueba /compact.

Respuestas que referencian trabajo viejo e irrelevante El contexto está saturado con info desactualizada. Considera /clear y reconstruir.

Estrategias de Contexto por Tarea

Arreglar Bugs

/clear
/add [archivo con el bug]
/add [archivos relacionados que podrían estar involucrados]
> Este es el error: [mensaje de error]
> Encuentra y arregla el bug.

Contexto mínimo y enfocado. Solo lo necesario para entender y arreglar el problema.

Desarrollo de Features

/clear
/add src/feature-similar/*           # Patrón a seguir
/add src/types/*.ts                  # Definiciones de tipos
/add tests/feature-similar.test.js   # Patrones de test
> Crea una nueva feature que haga X. Sigue los patrones existentes.

El contexto le muestra a Claude qué patrones seguir.

Code Review

/add $(git diff --name-only HEAD~1)  # Solo archivos cambiados
> Revisa estos cambios buscando bugs, problemas de estilo y potenciales issues.

Enfocado en lo que realmente cambió.

Refactoring

/add [todos los archivos involucrados en el refactor]
> Refactoriza [componente] para usar [patrón nuevo].
> Actualiza todos los usos en estos archivos.

Todos los archivos afectados de entrada para cambios coordinados.

Entender Código Desconocido

/add src/modulo-misterioso/*
> Explica cómo funciona este módulo. ¿Cuál es el punto de entrada principal? ¿Cómo se conectan las piezas?

Deja que Claude explore y explique antes de que tú te metas.

Chunking de Contexto para Tareas Grandes

Algunas tareas necesitan más contexto del que cabe cómodamente. La solución: divide el trabajo.

En vez de:

/add src/**/*                    # Todo — demasiado
> Refactoriza todo el codebase para usar TypeScript

Haz esto:

# Sesión 1
/add src/utils/*
> Convierte utils a TypeScript. Aquí está nuestro tsconfig.

# Sesión 2
/clear
/add src/models/*
> Convierte models a TypeScript. Sigue los patrones de utils.

# Sesión 3
/clear
/add src/services/*
> Convierte services a TypeScript.

Cada sesión tiene contexto enfocado. El trabajo es incremental.

Ejercicio Práctico

Prueba este ejercicio de manejo de contexto:

1. Abre Claude Code en un proyecto
2. Agrega demasiados archivos:

   /add **/*.js
   

3. Haz una pregunta específica sobre una función
4. Nota cómo la respuesta puede referenciar código irrelevante
5. Ahora /clear y agrega solo el archivo relevante
6. Haz la misma pregunta
7. Compara la calidad de las respuestas

El contexto enfocado generalmente gana.

Checklist de Manejo de Contexto

Antes de empezar una tarea:

• /clear o /compact si el contexto previo es irrelevante
• Identificar los archivos mínimos necesarios
• Agregar archivos en orden lógico (patrones primero, luego archivos objetivo)
• Verificar con /ls que el contexto se ve bien

Durante la tarea:

• Agregar archivos conforme sea necesario cuando Claude parece carecer de info
• Usar /compact si las respuestas se ponen lentas
• No agregar archivos “por si acaso”

Al terminar la tarea:

• Considerar /compact antes de la siguiente tarea si el contexto se va a superponer
• /clear si vas a trabajar en algo no relacionado

Conclusiones Clave

• La calidad del contexto le gana a la cantidad de contexto
• Contexto mínimo viable: solo lo necesario para la tarea actual
• Construye el contexto en capas de lo general a lo específico según la complejidad
• Pon atención a las señales de que el contexto necesita ajuste
• Divide tareas grandes en sesiones enfocadas

Lo que sigue: orquestar tareas de múltiples pasos para que Claude haga más del trabajo pesado.

Siguiente: En la próxima lección, nos sumergiremos en la Orquestación de Tareas.