Ingresar
ES/EN/PT
Lesson completed!
-

Leccion 5 / 21 · Setup

El cerebro CLAUDE.md

Max Techera
Siguiente

El cerebro CLAUDE.md

La lección pasada corriste /init y te creó un CLAUDE.md. Esta lección es sobre qué poner adentro — porque ese archivo es la diferencia entre un agente que conoce tu proyecto y uno que arranca de cero cada vez que lo abrís.

CLAUDE.md es el cerebro persistente. Claude lo lee al inicio de cada sesión, antes de que escribas una palabra. Es donde viven tu nicho, tu voz, las cuentas que trackeás y tus reglas. Lo escribís una vez, y toda sesión futura ya entiende tu proyecto.

Una routing table, no una novela

El error más común es tratar a CLAUDE.md como documentación y meterle todo adentro. No lo hagas. Mantenelo bajo ~200 líneas. El modelo mental es "a routing table, not a novel" — punteros cortos y de alta señal que le dicen a Claude dónde está todo y cómo comportarse, no prosa larga que tiene que atravesar.

Atención:

Un CLAUDE.md inflado hace al agente peor. Cada línea compite por la atención del modelo. Si no lo pondrías en una ficha para un compañero nuevo, probablemente no va acá. Linkeá a los detalles; mantené el cerebro liviano.

Los builders serios lo mantienen apretado a propósito. Doneyli De Jesus corre 15 agentes y 24 skills enteramente en Claude Code por unos $100/mes, y una de sus reglas duras es CLAUDE.md bajo 300 líneas. El contexto liviano es una feature, no una limitación.

La estructura de carpetas de datos

Tu CLAUDE.md debería apuntar a dónde vive la data. Esta es la estructura que usa todo el sistema — cuatro carpetas, cada una con un solo trabajo:

  • data/mine/ → tus reels (analytics reales, owner-only, traídos de tu cuenta)
  • data/refs/ → posts de competidores, organizados por creador
  • vault/ → hooks.json + ctas.json extraídos de los outliers
  • dashboards/ → los dashboards HTML generados

La decisión de diseño importante: data/mine/ y data/refs/ comparten un mismo schema. Eso es lo que deja al vault rankear hooks cruzando tu contenido y el de tus competidores — en vez de dos pilas de archivos desconectadas. No hace falta que armes estas carpetas ahora; solo las declarás para que Claude conozca el plan.

El CLAUDE.md de ejemplo

Acá tenés un starter completo que podés adaptar. Completá los corchetes con tu nicho y voz, listá las cuentas que querés trackear, y dejá el resto tal cual:

# Mi Content OS
Nicho: [tu nicho]. Idioma/voz: [rioplatense, directo, muestro receipts].
Competidores/referencias que trackeo: @cuenta1, @cuenta2, @cuenta3
Estructura de datos:
- data/mine/     → mis reels (analytics reales, owner-only)
- data/refs/     → posts de competidores (por creador)
- vault/         → hooks.json + ctas.json extraídos de los outliers
- dashboards/    → los HTML generados
Regla: nunca publicar nada automático. El sistema sugiere, yo decido.

Fijate lo poco que es. Nicho y voz en una línea cada uno, tres cuentas, el mapa de carpetas, y una regla. Esa última línea — "nunca publicar nada automático. El sistema sugiere, yo decido" — es el guardrail al que vamos a volver. Va en el cerebro porque es una regla que Claude debería honrar en cada sesión.

Tip:

Pegá esto, cambiá los corchetes por tu nicho y cuentas reales, y guardá. Ese es tu cerebro. Podés hacerlo crecer después, pero aguantá las ganas — cada sesión que arranca limpia es la prueba de que está funcionando.

Knowledge check

¿Cuál es la forma correcta de pensar CLAUDE.md?

Lo que te llevás

CLAUDE.md es el cerebro persistente que Claude lee cada sesión — mantenelo bajo ~200 líneas, una routing table y no una novela. Apuntalo a tus cuatro carpetas de datos (data/mine/, data/refs/, vault/, dashboards/), y horneale la regla que importa: el sistema sugiere, vos decidís. Un cerebro liviano es un cerebro mejor.

Compartir