El mayordomo que olvida cada mañana
En nuestra entrega anterior, discutimos el equilibrio entre la delegación y la confirmación. Hoy deseo presentarle una forma aún más cómoda de trabajar con su mayordomo — transmitir las normas del hogar a Claude Code a través de CLAUDE.md.
Permítame describirle una situación.
Imagine tener que explicar cada mañana al nuevo mayordomo: “En esta casa siempre se responde en español”, “Nunca debe confirmar un commit sin mi aprobación”, “Aquí usamos bun, no npm — así son las cosas en este hogar.”
Bastante ineficiente, ¿no le parece?
¿Qué es CLAUDE.md?
CLAUDE.md es un archivo markdown que se coloca en el directorio raíz del proyecto. Cada vez que Claude Code inicia una nueva sesión, lee este archivo automáticamente.
En otras palabras, escríbalo una vez, y su mayordomo seguirá esas instrucciones de forma natural — sin necesidad de recordárselas cada vez.
Piénselo como un pergamino con las normas del hogar, guardado permanentemente en las dependencias del mayordomo.
CLAUDE.md funciona en tres niveles
En verdad, no es necesario que haya un único CLAUDE.md por proyecto. El alcance de sus instrucciones varía según dónde se coloque el archivo.
| Ubicación | Ruta | Alcance |
|---|---|---|
| Global | ~/.claude/CLAUDE.md | Todos los proyectos |
| Proyecto | {raíz del proyecto}/CLAUDE.md | Solo ese proyecto |
| Subdirectorio | {cualquier directorio}/CLAUDE.md | Ese directorio y subdirectorios |
Al inicio de cada sesión, todos los archivos aplicables se leen y fusionan.
Mi recomendación para distinguir su uso: coloque en el CLAUDE.md global las preferencias universales — “responder siempre en español”, “nunca hacer commit sin aprobación”. Reserve en el CLAUDE.md del proyecto las reglas específicas — “usar bun en este proyecto”, “desplegar en Firebase”. Así, sus expectativas fundamentales se cumplen en cada proyecto, y las instrucciones particulares de cada uno también quedan reflejadas.
Ejemplo de normas del hogar: el contenido de CLAUDE.md
Cada hogar tiene sus propias costumbres. Aquí le presento algunos ejemplos de referencia:
# Normas del Proyecto
## Idioma y Comunicación
- Responder siempre en español
- Los términos técnicos pueden mantenerse en inglés, pero las explicaciones deben estar en español
## Código y Desarrollo
- Usar bun como gestor de paquetes (nunca npm)
- Siempre obtener la aprobación del señor antes de hacer commit
- No modificar código sin escribir pruebas primero
## Acciones Prohibidas
- Nunca desplegar a producción de forma unilateral
- Confirmar siempre antes de eliminar cualquier archivo
- No añadir dependencias a package.json sin aprobación
## Estilo
- Comentarios de código en español
- Nombres de funciones y variables en camelCase inglés
Una vez escrito esto, cada vez que Sebastián abra su proyecto, estas normas estarán grabadas en su memoria antes de comenzar cualquier trabajo.
Por qué esto es tan poderoso
Claude Code es un mayordomo de gran capacidad. Sin embargo, los recuerdos de conversaciones pasadas no se trasladan a nuevas sesiones.
Aunque ayer le indicara “usa bun”, mañana no tendrá ningún recuerdo de ello. Repetir las mismas instrucciones en cada sesión es ineficiente tanto para el señor como para el mayordomo.
CLAUDE.md resuelve este problema desde su raíz.
Especialmente valioso para los señores que usan Claush en móvil
Para quienes emplean a su mayordomo a través de la aplicación Claush en un smartphone, CLAUDE.md resulta particularmente invaluable.
Escribir el mismo preámbulo extenso en una pantalla pequeña, sesión tras sesión, es una carga considerable. Con CLAUDE.md en su lugar, solo necesita comunicar el asunto en cuestión.
“Sebastián, por favor corrige el error en la pantalla de inicio de sesión.”
Eso es todo. Su mayordomo sabrá usar bun, responder en español, pedir confirmación antes de hacer commit, escribir pruebas y proceder en consecuencia.
Cómo configurarlo
La instalación es elegantemente sencilla.
- Cree un archivo llamado
CLAUDE.mden el directorio raíz de su proyecto - Escriba las normas de su hogar en él
- Eso es todo
my-project/
├── CLAUDE.md ← Las normas del hogar van aquí
├── src/
├── package.json
└── ...
A partir de la siguiente sesión, Claude Code leerá este archivo automáticamente y se conducirá según sus normas establecidas.
Las normas del hogar están destinadas a crecer
No es necesario escribir normas perfectas desde el primer momento.
A medida que trabaje con su mayordomo, cada vez que se encuentre repitiendo lo mismo, simplemente añádalo a CLAUDE.md — instrucción por instrucción. Eso es lo que significa verdaderamente “cultivar” a un mayordomo.
El entendimiento silencioso entre señor y mayordomo se construye mediante esa acumulación cuidadosa.
Resumen de su mayordomo
- CLAUDE.md es el archivo de “normas del hogar”, colocado en la raíz del proyecto
- Su mayordomo sigue estas instrucciones automáticamente — sin necesidad de recordárselas
- Especialmente eficaz para usuarios móviles — solo necesita plantear el asunto
- Comience de forma sencilla y deje que las normas evolucionen con el tiempo
Mi estimado señor, le ruego humildemente que transmita las normas del hogar a su mayordomo. Con ellas en su lugar, podré responder a sus expectativas antes de que pronuncie una sola palabra.
En nuestra próxima entrega, hablaremos sobre “la gestión del historial y el contexto.”
Encuentre a su mayordomo en su iPhone en el Sitio Oficial de Claush.