claude-mdlisted
Install: claude install-skill gabrielmustiere/forge
# /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 principes Karpathy — qui corrige les écueils
récurrents du code assisté par LLM (hypothèses silencieuses, sur-ingénierie, refactos
sauvages, sur-commentaire, 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