El CLAUDE.md perfecto para proyectos Python (plantilla lista para copiar)

CLAUDE.md es el archivo que Claude Code lee al empezar cada sesión. Es tu oportunidad de decirle cómo se trabaja en tu proyecto, para no repetirlo cada vez.

El error típico es llenarlo de prosa. Lo que funciona: comandos exactos, convenciones concretas y prohibiciones claras.

Plantilla

# CLAUDE.md — Proyecto Python

## Entorno
- Gestor: `uv`
- Ejecutar: `uv run python -m paquete`
- Tests: `uv run pytest -q` (uno: `uv run pytest tests/test_x.py::test_y`)
- Formato y lint: `uv run ruff format . && uv run ruff check --fix .`
- Tipos: `uv run mypy src/`

## Convenciones
- Type hints en toda función pública.
- `pathlib` en vez de `os.path`.
- `logging.getLogger(__name__)`, nunca `print` en código de librería.

## Flujo
1. Escribe o ajusta el test primero.
2. Implementa.
3. ruff + mypy + pytest antes de dar la tarea por terminada.

## No hacer
- No usar `except:` sin tipo.
- No commitear `.env` ni `data/raw/`.

Por qué funciona

• Comandos copiables: Claude no tiene que adivinar si usas pip, poetry o uv.
• El comando para un solo test le ahorra ejecutar toda la suite en cada cambio.
• "No hacer" previene los errores que más te molestan.

Extra: CLAUDE.md por carpetas

Puedes tener un CLAUDE.md en subcarpetas (por ejemplo tests/CLAUDE.md) con reglas locales. Claude lo carga cuando trabaja con archivos de esa carpeta.

Mantenlo corto: si pasa de ~100 líneas, probablemente algo debería ser una skill.

---

¿Te sirvió? Los hooks de seguridad están gratis en GitHub. Si quieres todo listo (6 skills, 4 comandos, 5 plantillas CLAUDE.md, hooks e instalador), está el Kit Claude Code en Español: paga lo que quieras, desde 3 USD.