Loop de triagem de erros de build com Claude Code em 15 minutos

Divida o erro antes de pedir correção

Quando um build Node ou Astro falha, dá vontade de colar o log inteiro no Claude Code. Isso mistura primeira linha falha, causa provável e limpeza desnecessária.

Este loop aplica o template de bug report e o checklist de review a falhas de build. A meta é causa estreita, diagnóstico pequeno e prova depois da correção.

Capture evidências na mesma ordem

Use sempre status, build e teste quando necessário.

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

O primeiro run não precisa passar. Ele precisa preservar a primeira linha que falha, geralmente mais próxima da causa raiz.

Classifique em quatro grupos

Não precisa ser perfeito. Dependência/import, shape em runtime, expectativa de teste e permissão cobrem muitos erros diários.

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

Com essa divisão, você pede o menor diagnóstico em vez de uma correção ampla.

Prompt copiável

Leia este log de build com falha.
Não sugira refactors amplos.
Retorne:
1. primeira linha que falhou
2. causa mais provável
3. menor comando de diagnóstico
4. menor correção de código ou configuração
5. comando de prova após a correção

A linha principal bloqueia grandes refactors. Cada mudança deve ter uma hipótese e um comando de prova.

Falha comum: atualizar dependência cedo demais

Após “Cannot find module”, instalar pacote pode ser ruído se a causa é path. Após “undefined”, null checks podem esconder problema de frontmatter ou arquivo gerado.

Em sites públicos, build local não basta. A rota de receita exige URL pública, h1 correto, canonical, CTA e links Gumroad.

Próximo passo

Use o cheatsheet gratuito para comandos. Compre 50 Prompt Templates para debug e review. Use o Setup Guide e a consultoria para CI/CD e produção.