Boucle de triage des erreurs de build avec Claude Code en 15 minutes

Séparer l’erreur avant de demander le correctif

Quand un build Node ou Astro échoue, on a envie de coller tout le log à Claude Code. Cela mélange souvent première ligne d’échec, cause probable et nettoyage inutile.

Cette boucle applique le modèle de bug report et la checklist de review aux builds. Objectif : cause réduite, petit diagnostic et preuve après correction.

Capturer les preuves dans le même ordre

Toujours état, build, puis test si nécessaire.

git status --short
npm.cmd run build
npm.cmd run test -- --runInBand

Le premier run n’a pas besoin de passer. Il doit préserver la première ligne d’échec, souvent plus proche de la racine que le bruit final.

Classer le log en quatre familles

La classification n’a pas besoin d’être parfaite. Dépendance/import, shape runtime, attente de test et permission couvrent beaucoup d’échecs quotidiens.

const patterns = [
  [/Cannot find module|ERR_MODULE_NOT_FOUND/i, "dependency or import path"],
  [/TypeError:.*undefined|undefined is not/i, "runtime null or shape mismatch"],
  [/Expected.*received|AssertionError/i, "test expectation drift"],
  [/EACCES|permission denied/i, "permission or sandbox boundary"],
];

export function classifyBuildLine(line) {
  const hit = patterns.find(([regex]) => regex.test(line));
  return hit ? hit[1] : "needs manual reading";
}

Cette séparation permet de demander le plus petit diagnostic au lieu d’une réparation large.

Prompt de triage copiable

Lis ce log de build en échec.
Ne propose pas de grands refactors.
Retourne:
1. première ligne en échec
2. cause la plus probable
3. plus petite commande de diagnostic
4. plus petite correction code ou config
5. commande de preuve après correction

La ligne clé interdit les grands refactors. Un triage efficace relie une hypothèse à une commande de preuve.

Échec fréquent : mettre à jour trop tôt

Après “Cannot find module”, ajouter un paquet peut être faux si le problème est un chemin. Après “undefined”, ajouter des null checks peut masquer un problème de frontmatter ou de fichier généré.

Pour un site public, le build local ne suffit pas. Le chemin de revenus exige URL publique, h1 correct, canonical, CTA et liens Gumroad.

Prochaine étape

Prenez le cheatsheet gratuit pour les commandes. Achetez 50 Prompt Templates pour debug et review. Utilisez le Setup Guide et la consultation pour CI/CD et production.