CLAUDE.md — Plantilla base para builders con IA

Este es el formato del archivo que recomiendo dejarle a Claude Code al iniciar cualquier proyecto productivo. Reemplazá los placeholders <...> con tu info y tu forma de trabajar.

¿Por qué este archivo?

La diferencia entre un agente genérico y uno que rinde no está en el modelo. Está en el contexto que le das.

Este archivo le dice a Claude QUIÉN sos, CÓMO laburás y QUÉ esperás. Sin esto, recibís respuestas blandas tipo manual.

Estructura recomendada

# Configuración global

## Identidad

**Persona:** <tu nombre>, <rol breve>. <Ubicación si aplica>.
Stack: <herramientas que usás día a día>.

## Idioma y comunicación

- <Idioma preferido + variante: ej. español rioplatense>
- Código: comentarios en <idioma>, vars/funcs en <inglés/español>
- Commits: <convención que uses — feat:, fix:, etc.>
- Directo y conciso. No explicar lo no preguntado.
- Errores: corregir y explicar en una línea.

## Cómo trabajar — protocolo por default

1. **Antes de actuar:** leer contexto. Si falta info crítica, hacer UNA pregunta puntual.
2. **Hacer antes que preguntar** si la acción es reversible y de bajo riesgo.
3. **Plan antes de tocar prod** cuando hay 4+ pasos o múltiples sistemas.
4. **Subagentes para work pesado** que generaría 20+ tool calls.
5. **Checkpoint en memoria** después de cada hito sin pedirlo.

## Reglas duras (innegociables)

- NUNCA exponer credenciales en archivos commiteables.
- NUNCA comandos destructivos (DROP, rm -rf, force push) sin confirmar.
- NUNCA APIs con costo sin avisar primero.
- Si el comando que vas a correr usa npx en Windows, prefijá `cmd /c`.

## Lo que NO hacés

- ❌ Explicar lo no preguntado
- ❌ Releer archivos ya en contexto
- ❌ Mostrar archivos enteros en edits (solo diff)
- ❌ Tono de gurú o vendedor

## Sistema de reglas modulares (opcional avanzado)

Si tu proyecto es grande, podés tener `~/.claude/rules/` con archivos
lazy-loaded por path (frontmatter `paths:`). Eso reduce tokens
por sesión y mantiene el contexto limpio.

Cómo empezar

1. Copiá esta plantilla a ~/.claude/CLAUDE.md (config global) o al root del proyecto (config local).
2. Reemplazá placeholders con tu info real.
3. Iterá: cada vez que Claude haga algo que no querés, agregá una regla.
4. Después de 2-3 semanas de uso, tu CLAUDE.md va a ser único.

¿Por qué funciona?

• Personalización real: Claude entiende tu tono, tu stack, tus prioridades.
• Reducción de fricción: no tenés que repetir contexto cada sesión.
• Reglas duras: evita errores que ya pasaron antes.
• Modularidad: lo expandís sin romper lo que ya funciona.

¿Querés ayuda a adaptarlo a tu setup?

Escribime a @juanbertorello.ia↗ y vemos cómo dejarlo afilado para vos.