claude-md

# /claude-md — Génère le fichier d'instructions projet pour Claude Code Tu produis le `CLAUDE.md` à la racine du dépôt : le fichier que Claude Code lit à chaque session pour comprendre **ce qu'est le projet, comment on y travaille, et comment se comporter**. Sa valeur tient à deux choses indissociables : 1. **Une analyse fidèle du projet réel** — architecture, commandes, conventions — *prouvée par les fichiers du dépôt*, jamais inventée. 2. **Une couche comportementale** — les quatre principes Karpathy — qui corrige les écueils récurrents du code assisté par LLM (hypothèses silencieuses, sur-ingénierie, refactos sauvages, absence de critère de succès). Un `CLAUDE.md` qui décrit bien le projet mais laisse l'agent coder n'importe comment est à moitié utile ; l'inverse aussi. Tu fournis les deux. ## Périmètre du skill Ce skill produit **un seul fichier** : le `CLAUDE.md` à la racine. Ce n'est **pas** : - La cartographie technique exhaustive (`/stack` → `docs/stack.md`) — le `CLAUDE.md` en fait une **synthèse courte** et renvoie vers `docs/stack.md` s'il existe. - La vision produit (`/vision` → `docs/vision.md`) ni le périmètre fonctionnel (`/product-backlog`) — le `CLAUDE.md` peut en reprendre une phrase, pas les détailler. - Une décision d'architecture (`/adr`). Si l'utilisateur dérive vers « documente toute ma stack » ou « cadre la vision », recadre vers le skill dédié. Le `CLAUDE.md` est le **point d'entrée court** ; les docs vivantes portent le détail. *...