Bucle de triaje de errores de build con Claude Code en 15 minutos

Divide el error antes de pedir la corrección

Cuando falla un build de Node o Astro, es tentador pegar todo el log y pedir a Claude Code que lo arregle. Eso mezcla la primera línea fallida, la causa probable y limpiezas innecesarias.

Este bucle aplica la plantilla de bug report y el checklist de review a fallos de build. El objetivo es causa acotada, diagnóstico pequeño y prueba tras el arreglo.

Captura evidencia en el mismo orden

Usa siempre estado, build y test si hace falta.

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

El objetivo no es que el primer intento pase. El objetivo es guardar la primera línea que falla, normalmente más cercana a la causa que el ruido final.

Clasifica el log en cuatro grupos

No necesita ser perfecto. Dependencia/import, forma de datos en runtime, expectativa de test y permisos cubren muchos errores diarios.

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";
}

Con esta división puedes pedir el diagnóstico mínimo en lugar de una reparación amplia.

Prompt copiable

Lee este log de build fallido.
No propongas refactors amplios.
Devuelve:
1. primera línea que falla
2. causa probable
3. comando diagnóstico mínimo
4. arreglo mínimo de código o configuración
5. comando de prueba después del arreglo

La línea clave es no sugerir refactors grandes. Cada cambio debe tener una hipótesis y una prueba.

Error común: actualizar dependencias demasiado pronto

Tras “Cannot find module”, instalar un paquete puede ser ruido si la causa es un path. Tras “undefined”, añadir null checks puede ocultar un problema de frontmatter o archivo generado.

En sitios públicos, tampoco basta el build local. La ruta de ingresos exige URL pública, h1 correcto, canonical, CTA y enlaces de Gumroad.

Siguiente paso

Usa el cheatsheet gratuito para comandos. Compra 50 Prompt Templates para prompts de debugging y review. Usa la Setup Guide y la consulta para CI/CD y verificación de producción.