Gestión de contexto en Claude Code: /context, /compact, CLAUDE.md y Obsidian

Muchos problemas con Claude Code no vienen del modelo, sino de una sesión llena de contexto viejo. Gestionar contexto significa decidir qué debe estar ahora, qué debe vivir en archivos y qué debe quedar fuera.

/context muestra uso actual, /compact resume la conversación, /clear empieza de nuevo y /memory confirma los archivos de memoria cargados.

La meta práctica es mantener la sesión principal enfocada mientras la investigación larga, notas crudas y logs antiguos viven fuera de la ventana activa.

Think of the context window as the working desk

La ventana de contexto contiene historial, lecturas de archivos, salidas de herramientas, CLAUDE.md, auto memory, rules y skills. Cuando se llena, las restricciones importantes compiten con salida vieja.

What enters context	Why it gets heavy	Practical response
Conversation	Long discussion and side quests	Cut by task boundary
Files	Reading huge files whole	Search first, then read narrow ranges
Tool output	Long logs and repeated failures	Summarize into a note
Memory	Oversized CLAUDE.md	Move details to rules or docs

Use /context, /compact, /clear, and /memory differently

/context muestra el uso actual. /compact resume y continúa la misma sesión. /clear sirve para un límite real de tarea. /memory muestra CLAUDE.md y auto memory.

/context all
/compact focus on files changed, failing tests, and next command
/clear
/memory

Set a context budget before the task

Antes de empezar, define objetivo, alcance, exclusiones, criterio de terminado y comandos de verificación. No leas todo el repositorio si una búsqueda rg y dos archivos bastan.

# narrow discovery before asking Claude to read files
rg -n "getUserById|User not found|auth middleware" src tests
git diff --stat
npm test -- --runInBand

Copy-paste runbook for long work

Este runbook funciona para refactors, seguridad, artículos largos y experimentos de conversión. Mantiene la sesión pequeña y deja recibo para la siguiente pasada.

## Task brief
- Objective:
- In scope:
- Out of scope:
- Files likely involved:
- Done when:
- Verification commands:

## Handoff receipt
- Changed files:
- Commands run:
- Result:
- Remaining risk:
- Next best action:

What survives compaction

Después de /compact vuelven CLAUDE.md raíz y auto memory. Los CLAUDE.md anidados y rules por ruta vuelven al leer archivos que coinciden. No dejes reglas duraderas solo en el chat.

# CLAUDE.md

## Compact Instructions
- Keep the current business objective and monetization hypothesis.
- Keep changed files, verification commands, deploy state, and blockers.
- Drop raw logs unless a line explains the root cause.
- If article work is in progress, preserve slug, locale list, and quality gaps.

Three use cases: code, content, conversion

1. En refactors grandes, delega investigación amplia a subagent o sesión separada y trae solo un resumen de decisión.
2. En publishing, deja research crudo en Obsidian, reglas editoriales en CLAUDE.md y MDX final en el repositorio.
3. En conversión, guarda métrica, hipótesis, cambio y verificación como ticket pequeño.

Common failures and fixes

1. /compact no es backup completo del transcript; es resumen. Las restricciones duraderas van en archivos.
2. No implementes justo después de discovery masivo; comprime primero en una nota corta.
3. Auto memory no es documentación compartida. Las convenciones compartidas van en CLAUDE.md versionado.

How Obsidian fits in

This workflow works with CLAUDE.md best practices, token optimization, prompt engineering, and Obsidian workflow. Team setup can start from consultation page.

Place	Best information
CLAUDE.md	Short rules needed every session
Obsidian	Long research, hypotheses, article ideas
MDX / docs	Published content, specs, handoff notes
Auto memory	Local preferences and repeated learnings

What was verified

El artículo se actualizó con la documentación oficial de context window, commands y memory. Official references: context window, commands, memory, and common workflows.