Escribe tu primer CLAUDE.md

Escribe el CLAUDE.md de tu carpeta con lo que aprendiste de la tabla, y compara la misma pregunta en una sesión con y sin él.

Curso gratis. Tu Maestro, una IA, .

En esta página vas a reunir en exoplanetas/CLAUDE.md lo que descubriste sobre planetas.csv en los módulos anteriores y vas a comparar cómo responde una sesión nueva cuando tiene ese archivo frente a cuando empieza en blanco.

Primero, una sesión sin CLAUDE.md

El 31 de octubre de 2026 hicimos una prueba con dos carpetas idénticas en Claude Code (versión 2.1.314). En cada carpeta pusimos únicamente planetas.csv. La primera carpeta tenía solo la tabla; la segunda tenía además el CLAUDE.md que verás más abajo. En ambas abrimos una sesión nueva y escribimos la misma pregunta: "¿Cuántos planetas se descubrieron en 2025 y en 2026, y cuál año tuvo más?"

En la carpeta sin CLAUDE.md, la sesión nunca miró los archivos locales ni abrió planetas.csv. Intentó buscar las cifras en el internet con sus herramientas de búsqueda y descarga de páginas (WebSearch y WebFetch), cuyos permisos estaban denegados en esa corrida, y contestó esto:

No pude consultar las cifras. Se denegaron los permisos de búsqueda web y de descarga de páginas, así que no tengo un dato verificado de cuántos planetas se descubrieron en 2025 ni en 2026. Tampoco quise darte números de memoria.

El principio de la respuesta de la sesión sin CLAUDE.md. Siguió con una consulta a otra tabla de la NASA.Ejecutado el 31 de octubre de 2026 por Maestro.

La respuesta fue honesta: prefirió avisar que le faltaban permisos antes que inventar números de memoria, y enseguida propuso consultar otra tabla del archivo de la NASA (pscomppars). Pero dejó sin tocar el archivo planetas.csv que ya estaba en su carpeta.

Eso ocurrió en esa corrida en particular. Si abres otra sesión sin CLAUDE.md, quizá sí revise la carpeta, encuentre planetas.csv y te dé un número. El problema de fondo es que, al empezar con el vacío, cada sesión decide por su cuenta dónde buscar, qué tabla usar y cómo contar. Incluso si abre planetas.csv, desconoce la de la tabla (que cada fila es una publicación sobre un planeta) y puede contarte las 40,350 filas completas o comparar 2026 contra 2025 sin notar que el año sigue en curso.

Escribe el CLAUDE.md de tu carpeta

Este es el CLAUDE.md que usamos en la segunda carpeta de la prueba. Está dividido en dos partes breves: qué hay en los datos y bajo qué reglas se trabaja aquí.

CLAUDE.md

# Carpeta exoplanetas## Los datos- planetas.csv viene del NASA Exoplanet Archive, tabla ps. Una fila es una publicación sobre un planeta, no un planeta.- Para contar planetas, usa solo las filas con default_flag = 1.- El año en curso está incompleto: no lo compares con años anteriores sin decirlo.## Cómo trabajar aquí- Nunca cambies planetas.csv. Si necesitas otra versión, guárdala con otro nombre.- Cada número que me des sale de código que corriste. Dime cuántas filas usaste.

El CLAUDE.md de la sesión de prueba. Úsalo de punto de partida, pero escríbelo con tus palabras.

Fíjate en cómo están escritas esas cinco líneas. Una frase vaga como "ten cuidado con los datos" o "revisa bien las cuentas" deja a Claude Code igual que antes, porque no le dice qué hacer cuando abre el archivo. En cambio, cada línea del ejemplo nombra algo verificable: el archivo planetas.csv, el filtro exacto default_flag = 1, la advertencia sobre el año en curso y la obligación de decir cuántas filas entraron en el cálculo.

Crea tu propio CLAUDE.md dentro de la carpeta exoplanetas, al lado de planetas.csv. Puedes escribirlo en cualquier editor de texto plano (Bloc de notas en Windows, TextEdit en modo texto sin formato en Mac, o VS Code) o pedirle a Claude Code que cree el archivo con el texto que tú le dictes. Escríbelo con tus propias palabras y agrégale por lo menos una regla tuya de lo que viste en los módulos 2 y 3; por ejemplo, que cuando te arme un resumen en Excel use fórmulas vivas en lugar de números fijos.

Cuidado: Cuida el nombre exacto del archivo

Si creas el archivo desde el Bloc de notas o TextEdit y tu sistema oculta las extensiones, es fácil que se guarde como CLAUDE.md.txt o Claude.md.txt. Para que Claude Code lo cargue al iniciar, el archivo debe llamarse CLAUDE.md exacto, sin .txt al final.

Después, una sesión nueva con CLAUDE.md

Para probar tu archivo, cierra la sesión que tengas abierta (escribe /exit en la o inicia una sesión nueva en la aplicación de escritorio) y abre una nueva en la carpeta exoplanetas.

En nuestra prueba del 31 de octubre de 2026, al abrir una sesión nueva en la carpeta que tenía planetas.csv y el CLAUDE.md de arriba y hacerle la misma pregunta sobre 2025 y 2026, Claude Code listó la carpeta, leyó la tabla local, filtró por default_flag = 1 y respondió:

**2026 tuvo más, con 361 planetas contra 246 en 2025.** Pero 2026 todavía no termina (hoy es 31 de octubre), así que el año completo podría quedar aún más arriba.| Año | Planetas descubiertos ||---|---|| 2025 | 246 || 2026 (año incompleto) | 361 |Los números salen de `planetas.csv`. El archivo tiene 40,350 filas, y usé solo las 6,451 con `default_flag = 1`, porque cada fila es una publicación y no un planeta. Entre esas 6,451 no se repite ningún nombre, así que cada una es un planeta distinto. Los conté por `disc_year`, que no tiene valores vacíos.No modifiqué el archivo.

La respuesta de la sesión con CLAUDE.md, a la misma pregunta.Ejecutado el 31 de octubre de 2026 por Maestro.

Rastrea en esa respuesta cada regla del CLAUDE.md:

Qué representa una fila y cómo contar planetas: explica que el archivo tiene 40,350 filas y que usó solo las 6,451 con default_flag = 1 "porque cada fila es una publicación y no un planeta".
El año en curso: avisa desde la primera oración que "2026 todavía no termina" y etiqueta la fila de la tabla como "2026 (año incompleto)".
Números respaldados por código y conteo de filas: entrega 246 planetas en 2025 y 361 en 2026, detalla cuántas filas leyó y filtró, e indica la columna que usó (disc_year).
Archivo original intacto: cierra confirmando "No modifiqué el archivo".

Ninguna de esas condiciones iba en la pregunta del día. Todas entraron al contexto desde que se abrió la sesión gracias a CLAUDE.md. Si quieres que tu Maestro revise tu borrador de CLAUDE.md, pégaselo aquí.

Inténtalo

Haz la prueba completa en tu carpeta exoplanetas:

Guarda tu CLAUDE.md junto a planetas.csv, escrito con tus palabras y con al menos una regla adicional tuya.
Cierra la sesión actual y abre una sesión nueva en exoplanetas.
Escribe /context y confirma que CLAUDE.md aparece en la lista de archivos cargados en memoria. Si /context no muestra tu archivo, pregúntale a tu Maestro cómo verificar el nombre y la carpeta.
Haz la pregunta: "¿Cuántos planetas se descubrieron en 2025 y en 2026, y cuál año tuvo más?"

Cómo revisar que funcionó: tus números pueden variar si descargaste planetas.csv en otra fecha, pero en el rastro y en la respuesta debes ver tus reglas en acción: que leyó planetas.csv, aplicó default_flag = 1, te dijo cuántas filas usó, advirtió sobre el año en curso y dejó intacto el archivo original. Si alguna regla de tu archivo pasó desapercibida, cámbiala por una instrucción más concreta, abre una sesión nueva y vuelve a probar.

Comprueba lo que sabes: Escribiste tu CLAUDE.md en medio de una sesión y le preguntaste algo en esa misma sesión. La respuesta no sigue tus reglas. ¿Qué haces primero?