Plantilla inicial de CLAUDE.md para Claude Code

Un CLAUDE.md débil hace que cada sesión empiece en frío

Si tienes que repetir las mismas reglas del proyecto a Claude Code, el problema no es solo el prompt. El proyecto necesita un archivo pequeño que guarde comandos, límites, rutas de riesgo y criterios de terminado.

Esta plantilla sirve para un código existente y funciona bien junto a First Task Runbook.

Qué debe contener la plantilla inicial

No necesitas un documento enorme. Empieza con stack, comandos, rutas peligrosas, preferencias de salida y definición de terminado.

# CLAUDE.md

## Project snapshot
- stack: Astro + TypeScript
- package manager: npm
- main app: site/

## Commands
- dev: cd site && npm.cmd run dev
- build: cd site && npm.cmd run build

## Guardrails
- do not touch: .env, dist, generated exports
- ask before: destructive git commands, production deploys, secret rotation

## Definition of done
- code change is applied
- verification command has run
- remaining risks are stated

Con esto, la siguiente sesión ya empieza con más contexto.

Ejemplo para un sitio de contenido

En un sitio Astro multilingüe, añade reglas para usar el mismo slug en todos los idiomas, fijar pubDate y updatedDate, incluir heroImage y verificar en producción h1, canonical, idioma del cuerpo y enlaces CTA.

El fallo típico es tener archivos para todos los idiomas, pero dejar el cuerpo en inglés en páginas no inglesas. El frontmatter correcto no basta.

Cuándo añadir más reglas

CLAUDE.md no debe crecer por costumbre. Añade una regla cuando el mismo fallo se repite: comandos si falla el build, reglas multilingües si hay drift, criterios si las reviews son superficiales.

Siguiente paso

Si necesitas recordar comandos, empieza con el cheatsheet gratis. Si el bloqueo está en permisos, hooks, MCP o CLAUDE.md, usa Setup Guide. Para reglas de equipo, usa la consultoría.