El Sistema CLAUDE.md

Esto suena aburrido pero es la parte mas importante de usar Claude Code. Es la diferencia entre realmente shipear tu app vs frustrarte y abandonar.

El Problema

Tenes tu app creada. Perfecta, no? NO.

Aca viene el problema que nadie te cuenta: La proxima vez que arranques Claude, va a olvidar todo. Tu arquitectura, tus decisiones, tus convenciones. Vas a empezar de cero.

La Solucion: CLAUDE.md

El sistema CLAUDE.md permite que Claude mantenga memoria entre sesiones:

• Decisiones arquitecturales
• Convenciones de codigo
• Patrones que debe respetar

Sin esto, Claude "olvida" todo cada vez que empezas un chat nuevo.

Inicializar CLAUDE.md

Cuando Claude termine de crear tu app (o cuando abras un proyecto existente), escribi:

/init

Este comando hace que Claude:

1. Revise todo el proyecto
2. Analice la estructura
3. Cree un archivo CLAUDE.md

Estructura de un CLAUDE.md

Un archivo bien configurado se ve asi:

# CLAUDE.md
 
This file provides guidance to Claude Code when working with this repository.
 
## Architecture
 
This is a full-stack personal finance tracker with a React frontend and Node.js/Express backend:
 
- **Frontend**: React 18 with Vite, single-page application
- **Backend**: Express.js REST API with SQLite database
- **Database**: SQLite3 with three main tables
- **Communication**: Frontend calls backend API at `http://localhost:3001/api/`
 
## Key Patterns
 
- Always use error boundaries around components that make API calls
- Use Zod for input validation on all endpoints
- Follow the existing naming conventions for files
 
## Database Schema
 
- `categories`: id, name, color, icon
- `transactions`: id, type, amount, description, category_id, date
- `savings_goals`: id, title, target_amount, current_amount

Actualizar CLAUDE.md en Tiempo Real

Mientras chateas con Claude, podes agregar reglas usando el comando #:

# Always use error boundaries around components that make API calls

Esto agrega la regla directamente al archivo CLAUDE.md.

Te recomiendo tener el habito de hacer esto mientras trabajas y notas patrones que queres que Claude haga o deje de hacer.

Jerarquia de Archivos CLAUDE.md

Claude Code soporta multiples archivos CLAUDE.md en diferentes niveles:

~/.claude/CLAUDE.md                    # Global user preferences
~/dev/                                 # Parent directory
├── CLAUDE.md                          # Organization/team standards
└── finance-tracker-pro/
    ├── CLAUDE.md                      # Project-specific knowledge
    ├── backend/
    │   └── CLAUDE.md                  # Backend-specific patterns
    ├── frontend/
    │   └── CLAUDE.md                  # Frontend-specific patterns
    └── docs/
        └── CLAUDE.md                  # Documentation guidelines

Como Claude Procesa la Jerarquia

• Claude lee todos los archivos CLAUDE.md que apliquen
• Archivos mas especificos sobreescriben a los generales
• Todo el contexto relevante se combina automaticamente
• Claude prioriza la guia mas especifica para cada situacion

Documentacion Adicional

Ademas de los archivos CLAUDE.md, agrega una carpeta docs con:

• PRD inicial
• Arquitectura
• Principios de diseno
• Esquemas de base de datos

En tu CLAUDE.md, referencia esta documentacion:

# Finance Tracker Pro - Main Documentation
 
@docs/architecture.md
@docs/design-standards.md
@docs/database-schema.md
@docs/testing-strategy.md
 
## Project Overview
 
[Your main project description]

Esto separa lo que va en el prompt (los CLAUDE.md) de lo que se mantiene afuera hasta que sea referenciado.

Colaborar y Control de Versiones

Los archivos CLAUDE.md deben ser tratados como infraestructura critica:

• Agregalos a tu repositorio
• Incluilos en tu proceso de code review
• Usa mensajes de commit convencionales
• Taggealos como cambios mayores

Estrategias Avanzadas

1. Decile a Claude que lo Haga por Vos

Simplemente decile a Claude que actualice la documentacion cuando hayas terminado una funcionalidad grande. Tiene todo el contexto del trabajo que acaba de terminar.

2. Estandares de Calidad

Agrega estandares de calidad directamente en tus archivos:

## Code Quality Standards
 
- All functions must have JSDoc comments
- No any types in TypeScript
- Minimum 80% test coverage for new features

3. Onboarding de Nuevos Miembros

Nuevos desarrolladores pueden empezar super rapido:

Explica la arquitectura de este proyecto y como empiezo a contribuir

Claude lee el CLAUDE.md y da un overview completo.

Error Comun: CLAUDE.md Desactualizado

El error: Agregue features pero no actualice CLAUDE.md con las nuevas decisiones.

El costo: Claude "olvido" decisiones arquitecturales y recreo codigo viejo. Tuve que refactorear dos veces.

La leccion: Actualizar CLAUDE.md es parte del workflow de desarrollo, no es opcional.

Siguiente Paso

Ahora que tenes memoria persistente, vamos a aprender a manejar el contexto durante sesiones largas.