# CLAUDE.md

## Qui je suis
Développeur expérimenté mais qui reprend le code après 30 ans.
Je code en Python. Je comprends la logique mais je suis rouillé sur la syntaxe moderne.

## Comment me parler
- Explique ce que tu fais et POURQUOI
- Pas de raccourcis cryptiques
- Quand tu crées un fichier, dis-moi où et pourquoi
- Commit souvent avec des messages clairs en français

## Stack projet
- Python 3.11+
- SQLite pour le stockage
- FastAPI (plus tard) pour l'API
- LLM : Mammouth (API compatible OpenAI) sur https://mammouth.music.dilain.com
- Forge : Gitea sur forge.dilain.com
- OS : Unraid (Docker) + VPS

## Conventions
- Code en anglais, commentaires en français
- Docstrings en français
- Un virtualenv Python (.venv)
- Requirements dans requirements.txt
- Tests avec pytest

## Git
- Commits en français
- Format : "feat: ...", "fix: ...", "docs: ..."
- Push vers origin sur Gitea