7a336e6e/Systematic Debugging
shared/debugging/SKILL.md
rigorous, evidence-based approach to identifying root causes of bugs using the Scientific Method (Hypothesis -> Experiment -> Conclusion).
$ install --global
skillsauthnpx skillsauth add 7a336e6e/skills Systematic DebuggingInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
4 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
4
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Mar 26, 2026, 2:15 AM88.6s1 file scanned
SKILL.md
- name:
- Systematic Debugging
- description:
- rigorous, evidence-based approach to identifying root causes of bugs using the Scientific Method (Hypothesis -> Experiment -> Conclusion).
Systematic Debugging
Goal
Identify the root cause of a bug through isolation and reproduction, NOT by guessing or randomly changing code.
When to Use
- A test is failing.
- The application behaves unexpectedly.
- An error log appears in production.
- "It works on my machine" but fails elsewhere.
Instructions
1. Reproduce
Create a minimal reproduction case.
- Script: Write a standalone script (e.g.,
repro.py) that triggers the bug. - Test: Write a failing test case in the existing suite.
- Input: Identify the exact inputs (payload, env vars, user state) that cause the crash.
2. Isolate (Binary Search)
Narrow down the scope.
- Code: Comment out half the logic. Does it still fail?
- Data: Remove fields from the input. What is the minimum required payload?
- Time: When did it start failing?
git bisectto find the bad commit.
3. Log & Trace
Don't stare at the code; look at the execution.
- Print: Add
print()orlogger.info()at key decision points. - Inspect: Check variable values immediately before the crash.
- Trace: Follow the data flow across boundaries (API -> Controller -> Service -> DB).
4. Hypothesis & Experiment
Formulate a theory.
- "I think the user ID is null because the session middleware failed."
- Experiment: Log the user ID in the middleware.
- Result: Validates or rejects the hypothesis.
Constraints
✅ Do
- DO: Create a reproduction script/test before changing any implementation code.
- DO: Use
git bisectif the bug is a regression. - DO: Verify the fix by running the reproduction script again (it should pass).
- DO: Remove all temporary debug logging before committing the fix.
❌ Don't
- DON'T: Guess or "shotgun" fixes (changing random lines hoping it works).
- DON'T: Say "I fixed it" without seeing the reproduction case pass.
- DON'T: Ignore error messages; read the entire stack trace.
Output Format
repro_bug_name.py(or similar).DEBUG_LOG.md(optional, for tracking complex investigations).
Dependencies
shared/task-tracking/SKILL.md-- Log the bug and findings.
Related Skills
7a336e6e/Test Driven Development
development
VerifiedTrustedCommunity
Implement features using the Red-Green-Refactor cycle to ensure testability and correctness from the start.
1SKILL.mdUpdated Mar 25, 2026
7a336e6e/task-tracking
data-ai
VerifiedTrustedCommunity
Manage the `tasks.md` ledger with strict locking and collision avoidance protocols to allow multiple agents to work in parallel safely.
1SKILL.mdUpdated Mar 25, 2026
7a336e6e/git-workflow
development
VerifiedTrustedCommunity
The git-workflow skill defines branching conventions, commit message formats, and pull request standards that all agents must follow for consistent version control.
1SKILL.mdUpdated Mar 25, 2026
7a336e6e/environment-config
development
VerifiedTrustedCommunity
The environment-config skill standardizes how agents manage environment variables, secrets, and application configuration across local development and deployed environments.
1SKILL.mdUpdated Mar 25, 2026