Les checklists

Checklist 1, avant de commencer un projet

Tout ce qui doit être en place avant d'écrire la première ligne de code. Chaque case doit pouvoir se cocher avec une preuve concrète (commande qui passe, fichier qui existe, test manuel validé).

Installation

• VS Code lancé, extension Claude Code visible dans la sidebar
• claude --version affiche une version récente dans le terminal
• Abonnement Anthropic actif (Pro ou Max), vérifié sur console.anthropic.com
• Premier prompt envoyé, Claude répond sans erreur d'auth

Configuration du projet

• CLAUDE.md présent à la racine avec les 8 sections (chapitre 3)
• .claude/commands/ existe et contient au moins un agent
• .claude/settings.local.json présent, permissions pré-autorisées listées
• docs/plans/ créé pour les design docs
• MEMORY.md initialisé avec au moins une entrée (chapitre 10)
• .gitignore exclut .env.local et .claude/settings.local.json

Configuration avancée (optionnel)

• Hook Prettier post-edit actif, un fichier édité ressort formaté
• Hook typecheck pre-commit actif, un commit avec erreur TS est bloqué
• Deny list globale dans ~/.claude/settings.json (rm -rf, force push, db reset) testée
• Serveurs MCP connectés, claude mcp list affiche les bons noms
• Sub-agents d'exploration présents dans ~/.claude/agents/
• Status line configurée, l'alerte de contexte s'affiche à 60%

Infrastructure (si SaaS)

• node --version affiche v22 ou plus
• Projet Supabase créé, npx supabase start démarre sans erreur
• Vercel lié au repo, un git push déclenche un déploiement
• Toutes les variables d'env.example copiées dans .env.local et remplies
• Domaine acheté et DNS configurés (si prêt pour la prod)

Checklist 2, pour chaque feature

Le cycle complet, du brainstorm au commit. Rien n'est coché tant que tu n'as pas la preuve que ça marche.

Phase planification

• 3 à 4 options explorées par écrit avant de choisir
• Design doc écrit : vision, user stories, règles métier
• Plan d'implémentation écrit : tâches numérotées, fichiers touchés, critères de vérification par tâche
• Plan relu et validé avant tout code

Phase exécution

• Claude exécute le plan tâche par tâche, tu supervises
• npm run typecheck passe (zéro erreur) après chaque tâche
• npm run lint passe (zéro warning) après chaque tâche
• Build local OK : npm run build finit sans erreur

Phase validation

• Test visuel sur localhost:3000, chemin nominal validé
• Test visuel des cas d'erreur : saisie invalide, données vides, 404
• Test responsive : fenêtre réduite à 375px, rien ne déborde
• Textes français relus, accents corrects, zéro faute
• 2 à 3 itérations d'ajustement visuel ou fonctionnel effectuées

Phase livraison

• /review lancé, chaque remarque traitée (fixée ou justifiée)
• Tests unitaires écrits et verts si logique métier
• Lighthouse > 90 sur la page touchée (si page publique)
• /commit avec message conventionnel (feat:, fix:, refactor:)
• git push effectué, preview Vercel déployée et testée

Checklist 3, en fin de session

Ce qui doit être fait avant de fermer VS Code.

Sauvegarde

• git status propre, aucun fichier modifié non commité
• git push effectué, le remote est à jour
• "Mets à jour la mémoire projet" exécuté, MEMORY.md reflète les décisions du jour

Préparation de la prochaine session

• Prochaines priorités notées dans MEMORY.md ou TODO.md
• Bugs en suspens documentés avec étapes de repro
• Branche de travail identifiée (main ou feature branch)
• Serveurs locaux arrêtés si tu éteins la machine (Docker, npm run dev)

Version "rapide" pour les jours où tu es pressé

Si tu n'as que 30 minutes, voici le minimum absolu.

Express (30 min)

• Ouvrir le projet dans VS Code + Claude Code
• Décrire la feature en un prompt précis (chapitre 4)
• Laisser Claude coder, superviser
• Test visuel rapide sur localhost
• /commit + git push
• "Mets à jour la mémoire" avant de fermer