El archivo que Claude Code lee al inicio de cada sesión. Pon tus reglas una sola vez y no vuelves a repetirlas.
# CLAUDE.md — [Nombre de tu proyecto] > Plantilla de @johancodes. Pon este archivo en la raíz de tu proyecto. > Cambia todo lo que está entre [corchetes] y borra lo que no uses. > Corto es mejor: Claude lo lee al inicio de cada sesión. ## Qué es este proyecto [Una o dos frases. Ej: "App web para que restaurantes reciban pedidos por WhatsApp y los asignen a mensajeros."] ## Stack - Lenguaje: [TypeScript] - Framework: [Next.js 15 (App Router)] - Base de datos: [PostgreSQL con Prisma] - Estilos: [Tailwind CSS] - Tests: [Vitest + Playwright] ## Comandos - Instalar: `[npm install]` - Desarrollo: `[npm run dev]` - Tests: `[npm test]` - Lint / formato: `[npm run lint]` - Build: `[npm run build]` ## Estructura - `[src/app/]` → páginas y rutas - `[src/components/]` → componentes reutilizables - `[src/lib/]` → lógica y utilidades - `[tests/]` → pruebas ## Reglas de código - Usa TypeScript estricto. Nada de `any`. - Funciones pequeñas, con nombres claros. - Sigue el estilo de los archivos que ya existen antes de inventar uno nuevo. - Reutiliza componentes y utilidades existentes antes de crear otros. - Comenta el "por qué", no el "qué". ## Cómo quiero que trabajes 1. Para cambios grandes, primero propón un plan y espera mi OK. 2. Haz cambios pequeños y fáciles de revisar. 3. Después de cada cambio, corre los tests y el lint. 4. Si un test falla, arréglalo antes de seguir. 5. Si algo no está claro, pregúntame en vez de adivinar. ## Tests - Toda función nueva lleva su test. - No borres ni desactives tests para que "pasen". ## Git - Commits pequeños, en español, con mensajes claros. Ej: `feat: agrega filtro por fecha`. - Nunca hagas push ni force-push sin preguntarme. ## No toques - `[.env]` ni ningún archivo con claves o contraseñas. - `[src/legacy/]` → código viejo, no se modifica. - [Agrega aquí carpetas o archivos prohibidos.] ## Notas del proyecto - [Cosas que Claude debe saber y que no se ven en el código. Ej: "Los precios siempre van en centavos." / "El cliente principal usa iPhone, prueba en móvil primero."]
Hago apps, sitios web y sistemas a la medida.