El Archivo CLAUDE.md

> Usa TypeScript estricto
> Los componentes van en src/components
> Usamos Vitest para tests
> El proyecto usa PostgreSQL con Prisma
> No modifiques archivos en /generated
... (repetir en cada sesion)

~/.claude/CLAUDE.md

# Preferencias personales
 
## Estilo de codigo
- Prefiero codigo conciso sobre verboso
- Usar comentarios solo cuando el codigo no es auto-explicativo
- Nombrar variables de forma descriptiva
 
## Comunicacion
- Respuestas en espanol
- Explicar el "por que" ademas del "como"
 
## Herramientas
- Usar pnpm en lugar de npm cuando sea posible
- Preferir Vitest sobre Jest

./CLAUDE.md

./.claude/CLAUDE.md

./CLAUDE.local.md

Politica gestionada (empresa)
        +
Usuario (~/.claude/CLAUDE.md)
        +
Proyecto (./CLAUDE.md)
        +
Subdirectorios (src/CLAUDE.md)
        +
Local (./CLAUDE.local.md)
        =
   Contexto combinado

# Proyecto: E-commerce API
 
Backend REST para tienda online. Maneja catalogo,
carrito, pagos y envios.

## Stack
- Backend: Node.js + Express + TypeScript
- Base de datos: PostgreSQL
- ORM: Prisma
- Cache: Redis
- Tests: Vitest

## Convenciones de codigo
- TypeScript en modo estricto
- Variables y funciones en camelCase
- Clases y tipos en PascalCase
- Interfaces con prefijo I (IUser, IProduct)
- 2 espacios de indentacion
- Punto y coma obligatorio

## Estructura
/src
  /controllers  -> Handlers de rutas
  /services     -> Logica de negocio
  /models       -> Modelos de Prisma
  /middlewares  -> Middlewares de Express
  /utils        -> Funciones utilitarias
  /types        -> Tipos e interfaces

## Comandos
- `npm run dev` -> Desarrollo con hot reload
- `npm run test` -> Ejecutar tests
- `npm run build` -> Build de produccion
- `npm run lint` -> Verificar estilo

## Reglas
- NO modificar archivos en /generated
- NO usar console.log, usar el logger del proyecto
- NO commitear .env o credenciales
- Siempre crear tests para nuevas funciones
- Siempre validar input con Zod

# Proyecto: Mi App
 
Ver @README.md para descripcion completa
Ver @package.json para scripts disponibles
 
## Documentacion adicional
- Arquitectura: @docs/architecture.md
- API: @docs/api-reference.md

.claude/rules/
├── code-style.md      # Estilo de codigo
├── testing.md         # Convenciones de tests
├── api.md             # Diseno de API
└── security.md        # Reglas de seguridad

## Decisiones tecnicas
 
### Autenticacion
Usamos JWT con refresh tokens en lugar de sesiones.
Razon: Necesitamos soporte para multiples clientes (web, movil, API).
 
### Base de datos
PostgreSQL en lugar de MongoDB.
Razon: Necesitamos transacciones ACID para operaciones financieras.

## Gotchas
 
### Prisma y transacciones
Prisma no hace rollback automatico en errores de validacion.
Siempre envuelve operaciones multiples en `$transaction()`.
 
### Variables de entorno
En produccion, las variables se cargan desde AWS Secrets Manager.
NO usar process.env directamente, usar el helper `getConfig()`.
 
### Fechas y zonas horarias
Todas las fechas en la DB estan en UTC.
El frontend convierte a la zona del usuario.
NO usar `new Date()` en el servidor, usar `dayjs.utc()`.

// src/services/user.service.ts
import { db } from '@/lib/db';
import { AppError } from '@/utils/errors';
import type { IUser, ICreateUser } from '@/types';
 
export async function createUser(data: ICreateUser): Promise<IUser> {
  const existing = await db.user.findUnique({
    where: { email: data.email }
  });
 
  if (existing) {
    throw new AppError('EMAIL_EXISTS', 'El email ya esta registrado');
  }
 
  return db.user.create({ data });
}

touch ~/.claude/CLAUDE.md

# Preferencias globales
 
## Idioma y comunicacion
- Responde siempre en espanol
- Se conciso y directo
- Explica el "por que" de las decisiones importantes
 
## Estilo de codigo preferido
- Usa TypeScript siempre que sea posible
- Prefiero funciones arrow sobre function declarations
- Usa async/await en lugar de .then()
 
## Convenciones de nombres
- Variables y funciones: camelCase
- Clases e interfaces: PascalCase
- Constantes globales: UPPER_SNAKE_CASE
- Archivos: kebab-case
 
## Herramientas favoritas
- Testing: Vitest
- Linting: ESLint + Prettier
- Git: commits convencionales (feat:, fix:, docs:)

claude

Analiza la estructura de este proyecto y dame un resumen de:
1. Que tecnologias usa
2. Como esta organizado
3. Que comandos principales tiene

# Proyecto: [Nombre del proyecto]
 
[Descripcion breve de que hace el proyecto]
 
## Stack
- [Lenguaje/Framework principal]
- [Base de datos si aplica]
 
## Estructura
/[carpeta1]  -> [que contiene]
/[carpeta2]  -> [que contiene]
 
## Comandos
- `[comando1]` -> [que hace]
- `[comando2]` -> [que hace]
 
## Convenciones
- [Convencion 1]
- [Convencion 2]
 
## Reglas
- NO [cosa que no debe hacerse]
- Siempre [cosa que debe hacerse]