Skip to content

CLAUDE.md

Latest commit

 

History

History
39 lines (26 loc) · 1.48 KB

CLAUDE.md

File metadata and controls

39 lines (26 loc) · 1.48 KB
Raw

CLAUDE.md — {{PROJECT_NAME}}

Règles stables du projet, chargées à chaque session agent. Garder ce fichier maigre.

Contexte

{{PROJECT_DESCRIPTION}}

Domiciliation de l'information (un seul foyer par info)

  • CLAUDE.md (ce fichier) : conventions et règles stables.
  • Notion : couche stratégique vivante — statut, décisions ouvertes, roadmap.
  • README.md : présentation pour humains — installation, usage.
  • docs/ : documentation technique.

En cas d'écart entre Notion et le repo : le signaler explicitement, ne pas trancher seul.

Règles de dev

  • KISS · DRY · YAGNI — factoriser à partir de 3 occurrences ; pas d'abstraction spéculative.
  • Python 3.13+, PEP 8, type hints, pathlib, f-strings, logging (pas de print).
  • Docstrings Google style en français.
  • Dépendances minimales, gérées par uv (uv add …, jamais pip).

Commandes

uv sync --group dev        # installer / mettre à jour l'environnement
uv run pytest              # tests
uv run ruff check . --fix  # lint
uv run ruff format .       # format
uv lock --check            # lockfile à jour (vérifié en CI)

Fin de tâche

Avant de proposer un commit : pytest, ruff check . --fix, ruff format ., uv lock --check, cohérence README/docs. Ne pas commiter soi-même — proposer un message de commit.