teefayb/claude-code-setup-demo

Trier cet échec : $ARGUMENTS

Étapes

1. Reproduire. Exécuter uniquement le fichier défaillant : npx vitest run <fichier> (ajouter -t "<nom du test>" pour affiner). Si aucun fichier n’est indiqué, lancer npm test et prendre la première erreur. Si le test passe, l’exécuter 5 fois (npx vitest run <fichier> --repeat 4) pour vérifier son instabilité.
2. Lire la différence d’assertion et la stack trace avant de lire le code. Nommer l’attente défaillante.
3. Trouver ce qui a changé : git log --oneline -10 -- <fichier source> <fichier de test> et git diff main...HEAD -- <fichiers>.
4. Classer la cause et préciser laquelle :
   • Bogue de code — le test est correct ; corriger la source.
   • Test obsolète — le comportement a changé intentionnellement ; mettre à jour le test et indiquer le commit qui a modifié le comportement.
   • Isolation — état partagé entre les tests (fichier de données, variable d’environnement, temps, ordre). Dans ce dépôt, vérifier que le test utilise useTempDataFile() et passe un now explicite à createLink au lieu de se fier à l’horloge.
   • Environnement — version de Node, installation manquante, différence propre à la CI.
5. Corriger la cause racine. Ne jamais ignorer, supprimer ou assouplir une assertion uniquement pour la faire passer, et ne jamais éditer data/seed.json pour satisfaire un test sans le signaler.
6. Ré-exécuter le fichier, puis npm test.
7. Rapporter : cause (une phrase), classification, correction, et commandes exécutées.