Skip to Content

Chapitre 14.5 — Checklists copiables

⏱️ TL;DR — Les checklists de l’architecte (12.5), en version brute à copier dans ton README, ton wiki d’équipe, ou un fichier docs/. Taille-les à ton contexte.

Kickoff d’un projet

[ ] 4 décisions écrites : problème/périmètre (+ exclus), stack, design, conventions [ ] Plan mode + modèle fort ; plan lu et corrigé avant tout code [ ] CLAUDE.md graine (court, priorisé, tranchable) + « ce qu'on n'utilise pas » [ ] Tokens sémantiques posés + exposés (design system minimal) [ ] Un composant-modèle exemplaire (tokens, types, a11y) [ ] settings.json projet : permissions de base + hooks (format/lint/test) + garde-fous [ ] git init, branche de travail, premier commit vert

Nouvelle feature

[ ] Brief 3 ingrédients : objectif (+ pourquoi), ancrages (fichiers-modèles), critère vérifiable [ ] Plan mode si enjeu/ambiguïté élevés ; plan corrigé [ ] Découpée en tranches vérifiables [ ] Chaque tranche ancrée sur l'existant (conventions, primitives) [ ] Chaque tranche conclue par une preuve (test + flux exercé / rendu vu) [ ] Contexte net (une intention ; /clear si changement de sujet)

Fin de session

[ ] Build + tests + lint verts [ ] Commit propre (message qui porte le POURQUOI) [ ] Si inachevé : /handoff ou note « next steps » [ ] Mémoire à jour (CLAUDE.md/skills si une convention a changé) [ ] État reprenable (rien de cassé laissé en plan)

Avant merge / PR

[ ] Diff relue (cœur métier + fichier-modèle) : hors-périmètre ? contournement ? cas manquant ? complexité ? [ ] /code-review passé (effort selon enjeu) ; findings triés, pas gobés [ ] /security-review si auth / entrées externes / données [ ] CI verte (porte partagée) [ ] Je COMPRENDS ce que je merge (sinon je demande le pourquoi avant) [ ] PR : description qui explique le pourquoi

Quand ça dérape

[ ] Nommer le piège (vibe-coding ? contexte pollué ? culte du prompt ? croire ≠ vérifier ?) [ ] Contexte pollué → /clear + prompt net, ou déléguer à un subagent [ ] Consigne répétée → la cristalliser (CLAUDE.md / hook / skill / modèle) [ ] 2 corrections vagues sans progrès → stop, repartir propre + feedback ciblé [ ] Ça déraille sur l'archi → plan mode, reprendre le jugement [ ] Doute « est-ce que ça marche ? » → exiger la preuve (observer)

Les 5 questions-diagnostic (méta)

1. Je le traite en membre d'équipe ? → contexte + conventions 2. Je mise sur le terrain, pas le prompt ? → CLAUDE.md / hooks / skills 3. Je délègue l'exécution, garde le jugement ? → je décide 4. Je cristallise le volatil ? → j'écris ce qui doit durer 5. Je vérifie par l'observation ? → preuve, filet

Fin du Cookbook. Dernière partie : les Annexes (cheatsheet, glossaire, ressources, quiz).