# Plantilla de CLAUDE.md Copiá este archivo a la raíz de tu proyecto con el nombre exacto `CLAUDE.md`. Claude Code lo lee solo, al arrancar, en cada sesión. No hay que pedírselo. Completá lo que aplique y borrá lo que no. Un archivo corto y verdadero sirve más que uno largo y aspiracional: si escribís reglas que no cumplís, la IA las va a cumplir igual y te va a estorbar. Donde veas `[ ____ ]`, ahí escribís vos. --- ## Qué es este proyecto `[ Una o dos líneas: qué hace y para quién. Escribilo como se lo explicarías a alguien que entra a trabajar mañana. ]` **Estado:** `[ idea / en construcción / en producción ]` **URL:** `[ ____ ]` --- ## Con qué está construido - **Lenguaje / framework:** `[ ____ ]` - **Base de datos:** `[ ____ ]` - **Hosting:** `[ ____ ]` - **Otros servicios:** `[ pagos, correo, analítica, autenticación ]` `[ Si alguna decisión técnica fue deliberada y no querés que la cambien, decilo acá y por qué. Ejemplo: "No usamos ORM a propósito, las consultas van en SQL plano para poder leerlas." ]` --- ## Cómo se corre ```bash # Instalar dependencias [ ____ ] # Levantar en local [ ____ ] # Correr las pruebas [ ____ ] # Publicar [ ____ ] ``` --- ## Cómo está organizado `[ Solo lo que no se deduce mirando las carpetas. Dónde vive cada cosa, qué carpeta es para qué, qué archivos son generados y no hay que editar a mano. ]` --- ## Reglas que no se rompen Escribí acá lo que no es negociable. Son las que más te van a ahorrar. - `[ Ejemplo: nunca hacer merge directo a main; siempre rama y pull request ]` - `[ Ejemplo: no instalar librerías nuevas sin preguntar primero ]` - `[ Ejemplo: todo el texto visible va en español, con voseo ]` - `[ Ejemplo: no tocar los archivos de la carpeta legacy/ ]` - `[ Ejemplo: nada de claves ni tokens en el código, van en variables de entorno ]` --- ## Convenciones - **Nombres:** `[ cómo se nombran archivos, funciones, variables ]` - **Estilo:** `[ formateador, reglas de lint, largo de línea ]` - **Commits:** `[ formato del mensaje, si aplica ]` - **Comentarios:** `[ cuántos, en qué idioma ]` --- ## Errores ya cometidos La sección más útil del archivo y la que casi nadie escribe. Cada vez que la IA haga algo que tuviste que deshacer, anotalo acá en una línea. Deja de pasar. - `[ ____ ]` - `[ ____ ]` --- ## Qué NO tiene que hacer `[ Lo que preferís decidir vos. Ejemplos: no refactorizar código que no pediste tocar; no cambiar la paleta de colores; no agregar dependencias para resolver algo de tres líneas; no borrar archivos sin avisar. ]` --- ## Contexto de negocio `[ Opcional pero potente. Quién es el cliente, qué le importa, cuál es la métrica que mueve la aguja. La IA toma mejores decisiones de producto cuando sabe para qué existe lo que está construyendo. ]` --- *Este archivo es vivo. Actualizalo cuando el proyecto cambie y, sobre todo, cada vez que tengas que corregir lo mismo dos veces.*