Plantilla de CLAUDE.md para que Claude deje de picar a ciegas

«Un prompt más y ya.» Llevas tres semanas diciendo lo mismo.

Le pides los pagos y te rompe la web. Le pides que lo arregle y rompe otra cosa. Y vuelta a empezar.

La IA no es el problema. El problema es que trabaja como un minero sin mapa: cada vez que entras, pica en una dirección distinta.

Por qué cada sesión empieza sin memoria

Cada sesión nueva de Claude Code empieza con el contexto en blanco. No recuerda lo que hablasteis ayer, qué decidiste, qué está a medias ni qué no se puede tocar. Tú lo tienes en la cabeza. Claude, no.

Así que cuando le pides «añade los pagos», hace lo que puede con lo que ve en ese momento: abre archivos, supone cosas y cambia lo que le parece. A veces acierta. Otras, te rompe la web.

Los que terminan sus proyectos hacen dos cosas:

1. El plan antes que el código

Antes de cualquier cambio grande, no le dejes empezar a escribir. Pídele primero qué va a hacer, en qué orden y qué archivos va a tocar. Así ves el problema antes de que pase, no después.

Puedes hacerlo con este prompt (también va dentro de la plantilla):

No escribas nada todavía. Lee CLAUDE.md, dime qué vas a hacer, en qué orden y qué archivos vas a tocar. Espera mi OK antes de empezar.

En Claude Code también tienes el plan mode, que hace esto mismo de forma automática: Claude revisa el proyecto sin tocar nada hasta que apruebas. Lo explicamos en la guía de plan mode en Claude Code.

2. El mapa por escrito: CLAUDE.md

CLAUDE.md es un archivo de texto que pones en la carpeta principal de tu proyecto. Claude Code lo lee solo al empezar cada sesión, sin que tengas que pegarlo en el chat. Es el mapa de la mina: qué estás construyendo, para quién, qué está hecho, qué falta y qué reglas tiene que cumplir.

Si quieres entender a fondo qué poner y qué no, lo tienes en CLAUDE.md: el archivo que multiplica a Claude. Aquí vamos a lo práctico: la plantilla.

La plantilla de CLAUDE.md

Cópiala, crea un archivo llamado CLAUDE.md en la raíz de tu proyecto y rellena lo que va entre los signos < >:

# CLAUDE.md — <nombre del proyecto>

> Claude Code lee este archivo al empezar cada sesión. Mantenlo corto (lo esencial cabe en 1 pantalla) y actualízalo al terminar cada tarea.

## Qué construyo
<Una frase: qué es y qué problema resuelve. Ej.: «Web de reservas para mi peluquería».>

## Para quién
<Quién lo usa y qué necesita hacer. Ej.: «Mis clientes reservan cita desde el móvil en menos de 1 minuto».>

## Stack
- Front: <Next.js / HTML…>
- Datos: <Supabase / SQLite…>
- Pagos: <Stripe / Kunfupay…>
- Dónde se publica: <Vercel / Hostinger…>

## Estado
- ✅ Hecho: <lista corta>
- 🚧 En curso: <lo de esta semana>
- ⏳ Falta: <lo siguiente, en orden>

## Reglas para Claude
- Antes de cambiar más de un archivo: enséñame el plan y espera mi OK.
- No toques <carpetas/archivos sensibles> sin preguntar.
- Nada de claves ni contraseñas en el código: van en `.env`.
- Al terminar una tarea: actualiza la sección «Estado» de este archivo.
- Si algo no está claro, pregunta en vez de inventar.

## Cómo se prueba
<Comando para arrancarlo en local y qué comprobar. Ej.: `npm run dev` → reservar una cita de prueba.>

---

### Prompt para el plan (pégalo antes de cualquier cambio grande)
```
No escribas nada todavía. Lee CLAUDE.md, dime qué vas a hacer, en qué orden
y qué archivos vas a tocar. Espera mi OK antes de empezar.
```

Cómo rellenarla bien

• Qué construyo y para quién: una frase cada uno. Si no cabe en una frase, todavía no lo tienes claro (y Claude tampoco).
• Stack: solo lo que usas de verdad. Así Claude no mete otra librería «porque sí».
• Estado: es la parte que más ayuda. Con «Hecho / En curso / Falta», cada sesión sabe dónde está y qué toca después.
• Reglas: pocas y directas. Las que más errores evitan son las que dicen qué no hacer.
• Cómo se prueba: el comando para arrancarlo y qué mirar. Así Claude puede comprobar su propio trabajo.

Cómo comprobar que Claude lo lee

1. Guarda el archivo como CLAUDE.md en la carpeta principal del proyecto (o en .claude/CLAUDE.md).
2. Abre una sesión nueva de Claude Code en esa carpeta.
3. Escribe /context y busca tu CLAUDE.md en la lista de archivos de memoria.
4. Prueba rápida: pregúntale «¿qué estoy construyendo y qué falta?». Si te lo dice, el mapa funciona.

Con el plan antes que el código y el mapa por escrito, cada sesión pica en la misma dirección. Y el proyecto, por fin, se termina.

Fuente: cómo recuerda Claude tu proyecto, documentación oficial de Claude Code.