Cuando empiezas un proyecto con Claude Code o quieres mejorar el contexto que Claude tiene de un proyecto existente.
El prompt
Eres un developer que usa Claude Code a diario y ha escrito CLAUDE.md files para más de 20 proyectos. Sabes que un buen CLAUDE.md es la diferencia entre que Claude entienda tu proyecto en 10 segundos o que necesite 10 preguntas.
Crea un CLAUDE.md para mi proyecto con estas secciones:
1. PROYECTO: Qué es, qué hace, para quién. En 3-5 líneas.
2. STACK: Lenguajes, frameworks, base de datos, servicios externos. Tabla limpia.
3. ESTRUCTURA: Carpetas principales y qué contiene cada una. Solo las que importan, no un tree completo.
4. CONVENCIONES:
- Nombrado de archivos y variables
- Estructura de commits
- Reglas de estilo (linting, formatting)
- Patrones del proyecto (cómo se crean endpoints, models, etc.)
5. WORKFLOWS: Skills y slash commands disponibles. Qué hace cada uno y cuándo usarlo.
6. CREDENCIALES: Dónde están las API keys y credenciales (NO los valores, solo las ubicaciones).
7. GOTCHAS: Cosas que no son obvias y que alguien nuevo (o Claude) debería saber antes de tocar el código.
8. REGLAS: Lo que NUNCA debe hacer Claude en este proyecto.
Mi proyecto: [describir]
Stack: [listar tecnologías]
Cómo usarlo
Modelo recomendado: Claude
Ejemplo de input
Proyecto: DigitalBrain - newsletter diaria de IA + academia. Stack: Python scripts, n8n, Google Apps Script, Beehiiv API, Circle.so API. Monorepo con skills de Claude Code.
Ejemplo de output
# DigitalBrain
Newsletter diaria de IA para founders (60K suscriptores) + academia de formación práctica en Circle.so.
Stack
| Herramienta | Uso | | Python | Scripts de automatización | | n8n | Workflows de producción | | Beehiiv | Newsletter (MCP disponible) |
Gotchas
- NUNCA publicar directamente en Beehiiv sin revisión humana
- Las credenciales están en `.claude/credentials.md`, no en .env
- El dashboard usa Intl.NumberFormat con useGrouping: 'always'
Contexto
Cómo crear un CLAUDE.md que haga a Claude Code 10x más útil
CLAUDE.md es el archivo que le dice a Claude Code todo lo que necesita saber sobre tu proyecto: qué es, cómo está organizado, qué convenciones seguir, y qué nunca hacer. Sin él, Claude empieza cada conversación desde cero.
Este prompt genera un CLAUDE.md completo con ocho secciones: descripción del proyecto, stack, estructura de carpetas, convenciones de código, workflows disponibles, ubicación de credenciales, gotchas, y reglas.
La sección de gotchas es donde está el valor real. Son las cosas que un developer nuevo (o Claude) no sabe y que causan problemas: 'las credenciales no están en .env, están en este otro sitio', 'nunca publiques sin revisión humana', 'el dashboard usa este formato específico para números'.
Si ya tienes un CLAUDE.md, úsalo como input y pide que lo mejore. Si no tienes uno, este prompt te crea uno completo en 10 minutos. Es la inversión de tiempo con mejor retorno en cualquier proyecto de Claude Code.