Al principio le tiraba todo. Excels, fotos de dashboards, links de Notion. Pensé que con más información iba a entender mejor. No funcionaba así.
Cuando empecé a usar Claude Code, mi CLAUDE.md era básicamente: "Yo soy Franco Cristaldo, trabajo en Rufus Performance, quiero que pienses como un senior analyst." Y después le mandaba el Excel, la foto del dashboard, a veces le decía "lee todo mi Notion".
No me tomé nunca el tiempo de pensar en qué contexto necesitaba Claude para hacer bien su trabajo. Pensé que eso era problema de Claude, que era suficientemente inteligente para inferirlo. Pero no. No porque Claude sea limitado — sino porque yo nunca le di el mapa.
Me acuerdo de un momento puntual. Teníamos un problema con el pipeline de BigQuery en Rufus: las conversiones no matcheaban. Yo ya sabía por qué — el proceso era manual. "Fácil", pensé. "Le explico a Claude, lo resuelve y listo."
El problema es que Claude no tenía el contexto real. No sabía que había múltiples clientes, múltiples cuentas, conexiones de API que se hicieron en momentos distintos, campañas que venían de diferentes momentos. Yo le decía "el número está mal dimensionado" y me lo dimensionaba — pero solo ese número, sin entender el sistema. Y volvía a la misma conversación a parchear el siguiente problema, y el siguiente.
En algún momento me hice el parate: hay que mapear primero, no resolver. Antes de pedirle que haga algo, que entienda el sistema. Eso fue lo que después aprendí que se llama planning mode.
Eso funcionó. Pero después me pasó otra cosa: volvía al mismo CLAUDE.md para otros problemas y no servía. Mi contexto de performance no tenía nada que ver con la estructura de data. Era como usar el mismo mapa para dos ciudades distintas.
La solución fue obvia cuando la vi: no un CLAUDE.md pesado con todo, sino un CLAUDE.md liviano que apunta al lugar correcto según lo que necesito en ese momento.
La idea es simple. En vez de meter todo el contexto en el CLAUDE.md — lo que hace que se cargue en cada conversación, cueste tokens, y se vuelva inmanejable — el CLAUDE.md funciona como un índice. Una tabla de ruteo.
Definís keywords que vas a usar naturalmente ("felix", "pipeline", "creators") y le decís a Claude: cuando escuches esa palabra, leé este archivo. Así Claude va directo al contexto correcto en un tool call, sin buscar.
Antes: CLAUDE.md con 100+ líneas, contexto mezclado, Claude perdiendo tiempo leyendo todo aunque no lo necesite.
Después: CLAUDE.md con ~50 líneas — reglas de tono, tabla de ruteo, estructura de carpetas. Claude lee solo lo que necesita para esa conversación.
El formato de la tabla es así:
| Keyword | Leer primero | Contexto rápido |
|---|---|---|
| "felix" | clients/felix.md | Cuenta de paid media — presupuesto mensual, campañas activas |
| "pipeline" | data/bq-pipeline.md | Flujo BigQuery → Sheets, Airbyte, proceso de validación |
| "hostel" | projects/hostel/contexto.md | V&S Hostel — agente de reservas, operación |
| "cv" + nombre | job-search/[nombre]/ | Carpeta del candidato — CV, perfil, preparación |
Lo que sigue es el prompt que armé para que cualquier persona — del equipo o no — pueda construir su propio sistema desde cero. Copialo, pegalo en un chat nuevo de Claude Code estando en la carpeta raíz, y dejalo trabajar.
Necesito que me ayudes a armar un sistema de contexto optimizado para trabajar con Claude en esta carpeta. ## Qué quiero lograr 1. Un CLAUDE.md que funcione como routing table — no como documento de contexto pesado. 2. Archivos de contexto separados por tema/proyecto/cliente que se lean on-demand. 3. Que cuando yo diga un keyword corto (ej: "felix", "pipeline", "creators"), vos ya sepas qué archivo leer sin buscar. ## Cómo hacerlo ### Paso 1: Explorá la carpeta Mirá la estructura de archivos y carpetas que ya tengo. Identificá: - Los archivos .md que ya existen y qué contienen - Los temas/proyectos/clientes que manejo - Dónde hay contexto útil y dónde hay redundancia ### Paso 2: Proponé estructura Basándote en lo que encontraste, proponé: - Qué carpetas crear o reorganizar - Qué archivos de contexto faltan - Qué se puede consolidar ### Paso 3: Armá el CLAUDE.md con routing table El CLAUDE.md debe tener máximo ~50 líneas con: - Reglas de tono/formato (3-5 líneas) - Routing table: keyword → archivo → contexto rápido (1 línea) - Estructura de carpetas (referencia visual) Formato de la routing table: | Keyword | Leer primero | Contexto rápido | |---|---|---| | "keyword" | path/to/file.md | Qué es en una línea | ### Paso 4: Mové el contenido pesado - Si el CLAUDE.md actual tiene principios de trabajo, reglas largas → moverlo a archivo separado - Si hay contexto que se carga siempre pero solo se necesita a veces → sacarlo y apuntarlo ### Paso 5: Verificá - El CLAUDE.md no debería pasar de ~50 líneas - Cada keyword de la tabla debería apuntar a un archivo que existe - No debería haber contexto duplicado ## Reglas - No borres nada sin preguntar — solo reorganizá y optimizá - Los archivos de contexto deben tener: qué es, estado actual, decisiones clave, pendientes - Naming descriptivo: el nombre del archivo debe ser suficiente para que Claude infiera de qué se trata - Si algo se repite en múltiples archivos, consolidalo en uno solo
Tres variantes para casos distintos:
Lo que cambió no fue que Claude mejoró. Cambié yo.
Antes había cosas que vivían solo en mi cabeza — contexto que yo cargaba todo el tiempo sin darme cuenta. Ahora ese contexto está mapeado en algún archivo, y yo lo sé. No tengo que recordarlo, tengo que saber dónde buscarlo.
Desapareció la ansiedad de "¿lo tengo mapeado?". Y apareció espacio para pensar cosas nuevas. Puedo concentrarme porque ya sé que lo que armé no se va a perder — está estructurado, puedo mejorarlo, puedo retomarlo.
Lo estoy aplicando a todo: mi CV, mis finanzas, mis proyectos personales. Si quiero actualizar mi CV, no empiezo de cero — ya tengo mi trayectoria estructurada. Si quiero retomar un proyecto, no tengo que reconstruir el contexto — ya está.
La routing table no es una técnica de prompting. Es una forma de pensar cómo organizás tu conocimiento para que otro — Claude hoy, otro LLM mañana — pueda navigarlo sin que vos tengas que estar ahí explicando.
No el contexto que ya documentaste. El que está flotando — el que tenés que reexplicar cada vez que empezás un chat nuevo, o cada vez que alguien del equipo pregunta algo que "ya sabés".