Reglas con `.claude/rules`

Tu CLAUDE.md crece. Empiezas a meter convenciones de tests, de API, de estilo… y se acerca a las 200 líneas que perjudican la adherencia. Aquí está la solución: partirlo por temas con .claude/rules/, y —lo más potente— hacer que cada regla solo entre en contexto cuando es relevante.

Partir por temas

Coloca ficheros markdown en .claude/rules/, uno por tema:

mi-proyecto/
└── .claude/
    ├── CLAUDE.md           # instrucciones generales del proyecto
    └── rules/
        ├── code-style.md   # estilo de código
        ├── testing.md      # convenciones de tests
        └── security.md     # requisitos de seguridad

Se descubren recursivamente, así que puedes organizarlos en subcarpetas (frontend/, backend/). Una regla sin condiciones se carga en cada sesión, con la misma prioridad que .claude/CLAUDE.md.

Lo potente: reglas por ruta

Una regla puede limitarse a ciertos ficheros con un frontmatter paths. Así solo entra en contexto cuando Claude trabaja con ficheros que casan — no gastas contexto en reglas de la API mientras tocas el CSS.

---
paths:
  - "src/api/**/*.ts"
---

# Reglas de la API
- Todo endpoint valida su entrada.
- Usa el formato de error estándar del proyecto.

Patrones útiles en paths:

Patrón	Casa
`*/.ts`	todos los TypeScript
`src/*/`	todo bajo `src/`
`src/components/*.tsx`	componentes de una carpeta concreta
`src/*/.{ts,tsx}`	varias extensiones de una vez

Las reglas con paths se activan cuando Claude lee un fichero que casa, no en cada turno.

¿CLAUDE.md, regla o skill?

Tres herramientas para no mezclar:

Úsalo para…	Herramienta
Hechos que aplican a todo y a cada sesión	`CLAUDE.md`
Instrucciones de un área del repo (ciertos ficheros)	`.claude/rules/` con `paths`
Un procedimiento de varios pasos que se invoca cuando hace falta	una skill (curso de slash commands y skills)

Regla mental: si es un hecho siempre cierto, CLAUDE.md. Si es un hecho solo para parte del código, una rule con paths. Si es un cómo se hace paso a paso, una skill.

Reglas personales

¿Preferencias tuyas para todos los proyectos? ~/.claude/rules/. Se cargan antes que las del proyecto, así que las del proyecto tienen prioridad.

Qué llevas hasta aquí

.claude/rules/ parte instrucciones por temas, evitando el CLAUDE.md gigante.
El frontmatter paths limita una regla a ciertos ficheros: contexto solo cuando importa.
Sabes elegir entre CLAUDE.md / rule / skill según sea un hecho global, un hecho local o un procedimiento.

Hasta aquí, todo lo que escribes tú. En la siguiente lección, lo que Claude escribe solo: la auto memory.

Fuente oficial: How Claude remembers your project

¿Quieres llevar la cuenta de las lecciones que has terminado?

Entrar para guardar progreso

Reglas con .claude/rules