CLAUDE.md — Template de proyecto

# [Nombre del proyecto]

## Stack tecnológico
- Framework: [Next.js 15 / Express / FastAPI / ...]
- Lenguaje: [TypeScript estricto / Python 3.12 / ...]
- Estilos: [Tailwind CSS / styled-components / ...]
- DB: [PostgreSQL + Prisma / MongoDB / ...]
- Auth: [Clerk / NextAuth / custom JWT]
- Deploy: [Vercel / Railway / AWS]

## Estructura del proyecto
```
src/
├── app/           → rutas Next.js App Router
├── components/    → componentes React reutilizables
├── lib/           → lógica de negocio y utilidades
├── hooks/         → custom hooks
└── config/        → constantes y configuración
```

## Convenciones de código
- Componentes: PascalCase, tipos explícitos siempre
- Hooks: use[Feature] en /src/hooks/
- API routes: kebab-case
- Variables de entorno: desde process.env, nunca hardcoded
- Sin `any` en TypeScript — usa tipos explícitos o unknown

## Lo que NO hacer
- No mezclar lógica de negocio en componentes UI
- No usar fetch directo en componentes — usar hooks/actions
- No estilos inline — siempre clases Tailwind
- No añadir features no pedidas — scope conservador

## Contexto del negocio
[2-3 líneas: qué hace la aplicación, para quién y el problema que resuelve]

## Comandos útiles
```bash
npm run dev     # desarrollo
npm run build   # verificar build
npm run test    # tests
```