Recipes Core Pack · Debug

Build Failure Debug Recipe

Paste full build logs and get prioritized root causes plus verification commands.

Practical tip

Include the entire log, especially the first failing stack section, for higher accuracy.

Build Failure Analysis Prompt

Copy and use

"I need to debug a failing build quickly. Create a priority-based debugging plan from the inputs below. [Inputs] - Full build log: [BUILD_LOG] - Package manager: [npm/pnpm/yarn] - Local Node version: [LOCAL_NODE] - CI Node version: [CI_NODE] - Recent changed files: [CHANGED_FILES] [Output requirements] 1) Top 3 root-cause candidates (with confidence) 2) Verification commands per candidate 3) Immediate fix plan 4) Regression-prevention checklist 5) PR description template"

Copy this prompt and paste it into your AI chat.

Baseline diagnostic commands

terminal

node -v
npm -v

npm ci
npm run build

# If available
npm run typecheck

Execution Checklist

0/5 done

Reproduce locallyRun npm ci && npm run build

Compare Node versionsCheck local vs CI runtime versions

Validate lockfile consistencyDetect dependency drift

Separate type/lint failuresClassify by failing stage

Rebuild after fixVerify same commit now passes

Build Failure

General build troubleshooting

Build OOM

Memory-related failures

Last updated: February 22, 2026 · Version: v0.0.1

Send Feedback

Opens a new issue page with your message.

Open GitHub Issue