Modèle de départ CLAUDE.md pour Claude Code

Un CLAUDE.md faible force chaque session à redémarrer à froid

Si tu dois répéter les mêmes règles de projet à Claude Code, le problème n’est pas seulement le prompt. Le projet a besoin d’un petit fichier qui garde les commandes, les limites, les chemins risqués et les critères de fin.

Ce modèle convient à une base de code existante et complète First Task Runbook.

Ce que le modèle doit contenir

Pas besoin d’un document géant. Commence par la stack, les commandes, les chemins risqués, les préférences de sortie et la définition de terminé.

# CLAUDE.md

## Project snapshot
- stack: Astro + TypeScript
- package manager: npm
- main app: site/

## Commands
- dev: cd site && npm.cmd run dev
- build: cd site && npm.cmd run build

## Guardrails
- do not touch: .env, dist, generated exports
- ask before: destructive git commands, production deploys, secret rotation

## Definition of done
- code change is applied
- verification command has run
- remaining risks are stated

Avec cela, la session suivante démarre avec un contexte utile.

Exemple pour un site de contenu

Pour un site Astro multilingue, ajoute des règles sur le slug commun, pubDate, updatedDate, heroImage, puis la vérification publique du h1, canonical, corps de texte et liens CTA.

L’erreur à éviter est d’avoir tous les fichiers de langue mais un corps anglais dans les pages non anglaises. Le frontmatter ne suffit pas.

Quand ajouter des règles

CLAUDE.md ne doit pas grossir sans raison. Ajoute une règle quand une erreur se répète : commandes de build, règles multilingues, critères de review ou vérification de déploiement.

Prochaine étape

Pour les rappels de commandes, commence par le cheatsheet gratuit. Pour permissions, hooks, MCP ou CLAUDE.md, prends le Setup Guide. Pour une équipe, regarde la consultation.