Las mejores plantillas de CLAUDE.md para empezar tu proyecto

Casi todas las plantillas de CLAUDE.md que circulan tienen el mismo problema: son larguísimas.

Cuatrocientas líneas explicando convenciones de código, estilo de comentarios, cómo nombrar variables y treinta reglas más que el modelo va a leer entero cada vez que abras el proyecto. Eso no es contexto, es ruido caro. Y lo peor es que cuando todo es importante, nada lo es: la regla que de verdad te importaba se pierde entre las otras veintinueve.

Las mías son cortas. Y son cortas a propósito.

¿Qué plantilla de CLAUDE.md me sirve?

Depende de qué tenga tu proyecto dentro. Estas son las cuatro que uso y a quién le sirve cada una.

| Plantilla | Para quién | Qué lleva dentro | Dónde falla | Veredicto | |---|---|---|---|---| | Cerebro digital | Notas, documentación, contenido personal | Dónde vive cada cosa y cómo se escribe | Se queda corta si metes código | La que recomiendo para empezar | | Proyecto de código | Web o aplicación que estás construyendo | Comandos, estructura, reglas de prueba | Envejece rápido si el proyecto cambia mucho | Imprescindible en cuanto hay build | | Negocio | Quien gestiona contenido, clientes y números | Contexto de negocio y a dónde va cada dato | Tiende a engordar sin control | La más útil a medio plazo | | Mínima | Quien acaba de empezar y no sabe qué poner | Cinco líneas y para adelante | Se te queda pequeña en dos semanas | La mejor primera versión |

Ninguna de las cuatro pasa de una pantalla. Si la tuya no cabe en una pantalla, probablemente le sobra la mitad.

La plantilla mínima (empieza por aquí)

Si no has escrito nunca un CLAUDE.md, esto es todo lo que necesitas el primer día:

`markdown # Proyecto

De qué va esto: [una frase]

Cómo trabajo aquí

• Escribe en español de España.
• Los archivos nuevos van en [carpeta].
• Antes de crear algo nuevo, comprueba si ya existe.

Lo que nunca hay que hacer

• [una cosa concreta que ya te ha molestado]

`

Ese último apartado es el más importante y el que casi nadie pone al principio, porque todavía no sabes qué te va a molestar. Por eso la regla de oro: el CLAUDE.md no se escribe entero al principio, se escribe a trozos cada vez que algo sale mal.

Cada vez que te toque corregir lo mismo por segunda vez, eso es una línea nueva. Ni antes ni después.

La plantilla de cerebro digital

Esta es la que uso para todo lo que no es código: notas, documentación, borradores.

`markdown # [Nombre]: cerebro digital

Estructura

• notas/: notas atómicas, una idea por archivo
• proyectos/: un archivo por proyecto activo
• archivo/: lo terminado, no se toca

Reglas

• Un archivo, una idea. Si trata dos cosas, son dos archivos.
• Los índices son mapas: una línea por entrada, nunca contenido.
• Al crear una nota, enlázala desde el índice de su carpeta.
• Nombres de archivo en minúsculas, sin tildes, con guiones.

Cómo escribo

• Español de España, ortografía completa.
• Frases cortas. Sin relleno.

`

La regla de los índices como mapas la aprendí a base de sustos. Si dejas que el índice acumule contenido, en dos meses tienes un archivo enorme que se carga en cada conversación y te come el contexto sin aportar nada. Un índice es una lista de puertas, no una habitación.

Y la del archivo por idea es la que más se nota con el tiempo, porque es la que hace que buscar funcione.

La plantilla de proyecto de código

Aquí sí hacen falta datos concretos, y son menos de los que la gente cree:

`markdown # [Proyecto]

Stack: [lenguaje / framework / base de datos]

Comandos

• Arrancar: npm run dev
• Pruebas: npm test
• Compilar: npm run build

Estructura

• src/: código
• src/lib/: utilidades compartidas
• tests/: pruebas

Reglas

• Antes de dar algo por terminado, ejecuta las pruebas.
• Si tocas algo del panel de administración, comprueba que sigue siendo accesible desde el menú.
• No inventes dependencias nuevas: usa las que ya están.

`

Lo importante de esta plantilla no es la lista de carpetas, es la sección de comandos. La cantidad de tiempo que ahorras porque el asistente sepa arrancar y probar sin preguntarte es enorme, y es la parte que más gente se deja.

La segunda regla, la del panel, es un ejemplo de lo que decía antes: eso está ahí porque me pasó. Terminé una funcionalidad tres veces y tres veces se quedó sin enlace en el menú. A la tercera se convirtió en línea.

La plantilla de negocio

Esta es la más difícil de mantener a raya, porque un negocio tiene muchas cosas y todas parecen importantes.

`markdown # [Negocio]

Qué vendo: [productos, en una línea cada uno] A quién: [una frase]

Dónde va cada cosa

• Decisiones de negocio → decisiones.md
• Números y facturación → finanzas/
• Contenido publicado → contenido/

Reglas

• Las cifras no se estiman: si no la tengo, la pido.
• Cada decisión se apunta con la fecha y el porqué.
• No inventes datos de clientes ni de ingresos.

`

Esa última regla vale por las otras diez. Un asistente que rellena un hueco con un número plausible en un documento de negocio te crea un problema que descubres tres meses después.

Lo que sobra en casi todas las plantillas que circulan

Voy con la parte incómoda.

Sobra el estilo de código detallado. Comillas simples o dobles, punto y coma sí o no, cuántos espacios. Eso lo resuelve el formateador automático en medio segundo. Ocupar contexto con ello es tirar dinero.

Sobra la lista de dependencias. Está en el archivo de configuración del proyecto y ahí está siempre actualizada. En el CLAUDE.md está desactualizada desde el día siguiente.

Sobra el "sé conciso y profesional". No hace nada. Lo que sí hace algo es un ejemplo concreto de cómo quieres que te hable.

Sobra la documentación de la arquitectura. Si tu proyecto es tan grande que necesita eso, va en su propio archivo y se lee cuando toca, no en cada arranque de conversación.

Mi criterio para decidir si una línea se queda: ¿esto ha causado un problema real alguna vez? Si la respuesta es no, fuera. Escribo más sobre el porqué de todo esto en cómo escribir un CLAUDE.md que sirva.

¿Y ahora qué?

Coge la mínima, pégala en tu proyecto y trabaja una semana normal. Cada vez que corrijas lo mismo dos veces, añade una línea. En un mes vas a tener una plantilla mejor que cualquiera de las cuatro de aquí arriba, porque va a ser la tuya.

Si acabas de aterrizar y aún estás en la parte de instalar y perderle el miedo, empieza por Claude Code para no programadores y vuelve a esto cuando lleves unos días usándolo. Y cuando el archivo se te empiece a quedar largo, la salida no es recortarlo a lo bruto: es mover lo específico a habilidades separadas que se cargan solo cuando hacen falta, algo que cuento en las mejores skills de Claude Code.

Si lo que te interesa es montar el sistema completo, con tu negocio de una persona funcionando encima de esto, es justo lo que enseño en Yo, S.A.

Ver Yo, S.A.