nexus-debugging

Nexus Debugging

Route to the correct sub-guide and follow it end-to-end.

---

Compatibility

• Sub-guides: skills/debugging/ci-cd.md, skills/debugging/codebase.md, skills/debugging/frameworks.md
• Shared rules and output formats: skills/debugging/common.md

---

Workflow

Step 1 — Classify the Failure

Pick exactly one track:

Track	Failure origin	Sub-guide
CI/CD	GitHub Actions, Jenkins, CircleCI, or deployment pipeline log	ci-cd.md
Codebase	Failing test, runtime exception, or regression in application code	codebase.md
Framework	Django, FastAPI, Bazel, or other tooling misbehavior	frameworks.md

If unsure: ask "Is the failure in pipeline logs, app code, or a framework?"

Step 2 — Gather Error Context

Before reading the sub-guide, collect:

1. Full error message or stack trace — copy exact text, do not paraphrase
2. What changed recently: last commit, dependency update, config change, environment change
3. Environment details: local vs CI, OS, Python/Node/runtime version
4. Steps to reproduce (minimum reproducible case if possible)

Step 3 — Read Sub-Guide & Execute

Read the appropriate sub-guide. Follow its steps in order. Do not skip steps. Read common.md for shared output format and checklists.

Step 4 — Search for Tool-Specific Errors

If the error is framework-specific or tool-specific:

1. Search: "<exact error message>" <tool-name> <version> — use exact error text
2. Check the official tool changelog for breaking changes in the version in use
3. Check GitHub Issues for the tool repo filtered by the error keyword

Step 5 — Apply Fix & Verify

1. Apply the narrowest fix that addresses the root cause — do not clean up unrelated code
2. Run the exact verification command that confirms the fix (re-run the failing test or job)
3. State what would prevent this from recurring

---

Output Format

## Debug Report
**Track:** [CI/CD | Codebase | Framework]
**Root Cause:** [one sentence — specific, not "something went wrong"]
**Fix:** [exact command or minimal code diff]
**Verification:** [command to run to confirm fix]
**Prevention:** [what change stops this from recurring]