fix-issue

Root-cause debugging involves reproducing the bug with clear steps, identifying where it originates in the code, and applying a minimal fix. This Skill automates that workflow by guiding reproduction, tracing the cause, implementing targeted changes, and validating against the full test suite to ensure no regressions occur.

Start by creating a minimal test case that triggers the reported issue consistently. Document the exact conditions and inputs, then trace execution through your code to find where the failure originates. This Skill structures that process and validates your findings against existing tests.

Yes. This Skill handles both scenarios—investigating test failures in your test suite and resolving production issues. It applies the same root-cause methodology: reproduce the failure, identify the source, apply a minimal fix, and run the full test suite to confirm no regressions.

After applying your fix, run the entire test suite with Jest or pytest. This Skill validates changes against all tests, catching regressions before they reach production. It emphasizes minimal, focused fixes that address only the root cause.

Minimal fixes reduce regression risk by changing only what's necessary to resolve the root cause. Broad refactoring introduces more code paths and edge cases to test. This Skill prioritizes focused changes paired with comprehensive test validation.