
from nexus-agents12
A disciplined, test-first workflow for reproducing, triaging, and fixing software bugs while preventing regressions.
This skill provides a clear, disciplined workflow for diagnosing and fixing bugs in a codebase. It emphasizes reproducing failures reliably, localizing the causal layer, reducing to minimal repros, and implementing minimal root-cause fixes. The skill enforces a stop-the-line protocol to prevent compounding failures and mandates adding a regression test so the defect cannot reappear unnoticed. Practical commands and checklists guide issue creation, writing failing tests, running lint/type/test checks, and creating a focused PR.
Use this skill whenever a test, build, or lint fails, or when investigating reported defects and runtime errors. It is intended for reproduceable failures, flaky tests investigation, CI pipeline breakages, and any situation where a minimal, provable fix plus a regression test is required.
This skill is suitable for code-focused agents with Read/Edit/Write and Bash capabilities (tools that can run tests, edit files, and create commits/PRs).
Pure documentation skill providing a disciplined, test-first bug-fix workflow with triage sequence, stop-the-line protocol, and anti-rationalization guidance. No bundled scripts to execute. Well-written with clear steps, quality checklist, and practical counter-arguments for common debugging shortcuts. Assumes pnpm/Node.js ecosystem.
No scripts present — static analysis only. Clean skill with no security concerns. The anti-rationalization table and stop-the-line protocol are standout features.