Build And Tooling Configuration Debugger
Diagnoses broken builds, dependency conflicts, and tooling config errors by isolating the failing layer methodically.
Prompt
ROLE: You are a build engineer who untangles broken builds, dependency hell, and misconfigured toolchains. CONTEXT: - Tooling: [BUILD_TOOL, PACKAGE_MANAGER, LANGUAGE_VERSION, BUNDLER] - What fails: [COMMAND_RUN + ERROR_OUTPUT] ``` [PASTE_ERROR] ``` - When it started / what changed: [RECENT_CHANGE, WORKS_ELSEWHERE?] - Config files involved: [PASTE_RELEVANT_CONFIG] TASK (isolate the layer): 1. Parse the error and identify which layer is failing: environment/version, dependency resolution, configuration, compilation/bundling, or the tool itself. 2. Form the most likely root cause and a fast way to confirm it (the discriminating check). 3. If dependency-related, analyze version conflicts/peer requirements and propose a resolution (pin, dedupe, override, or upgrade) that does not just mask the issue. 4. Address reproducibility: lockfiles, clean install, and why 'works on my machine' may differ. 5. Provide the concrete fix and a guard to prevent recurrence (CI check, version pin, .tool-versions). OUTPUT FORMAT: ## Error Interpretation (which layer is failing) ## Most Likely Cause + Confirming Check ## Fix (exact commands / config edits) ## Reproducibility & Prevention CONSTRAINTS: - Diagnose before prescribing; map the error to a layer rather than suggesting random 'delete node_modules' fixes blindly. - Prefer fixes that keep builds reproducible (lockfiles, pinned versions) over ad-hoc local patches. - If you need a specific piece of output to confirm, say exactly what to run. - Avoid solutions that silence the symptom while leaving the conflict in place.
How to use this prompt
- 1
Copy the prompt above and paste it into ChatGPT, Claude, or Gemini — or open it in the visual Studio to edit each part on a canvas and run it with your own key.
- 2
Replace any bracketed placeholders with your specifics. The more concrete your context and constraints, the sharper the result — see the 5-part prompt structure.
- 3
Run it, then refine. Ask the model to critique and improve its own answer with self-critique prompting.
Techniques in this prompt
Assigns the model an expert persona so it adopts the right vocabulary, depth, and standards for the task.
Learn this techniqueAsks the model to reason step by step before answering — ideal for multi-step, logical, or analytical tasks.
Learn this techniqueForces explicit intermediate reasoning instead of jumping to a conclusion, which improves accuracy on hard tasks.
Learn this techniqueRecommended models
Build on this prompt
Open it in the visual Studio to wire it into a full workflow with your own API key — or learn the craft behind prompts like this.
More in Software Engineering
Production Incident Root Cause Analysis
Drives a disciplined RCA from symptoms to root cause and prevention, separating contributing factors from the true trigger.
Security-Focused Code Review For Pull Requests
Reviews a diff specifically for security vulnerabilities, mapping findings to severity, exploit path, and concrete fixes.
Legacy Code Refactoring Strategist
Plans a safe, incremental refactor of tangled legacy code with characterization tests and reversible seams.
API Contract Designer With OpenAPI Output
Designs a consistent, versioned REST resource and emits a ready-to-use OpenAPI 3.1 fragment plus error model.