cdebug

Solid

Structured bug investigation workflow. Root cause analysis, hypothesis testing, TDD fix with agent separation, escalation after 3 failed attempts. Use when stuck on a bug.

Code & Development 61 stars 2 forks Updated yesterday MIT

Install

View on GitHub

Quality Score: 88/100

Stars 20%
60
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# /cdebug — Structured Bug Investigation > **Shared constraints apply.** Before executing, read `_shared/constraints.md` from the parent of this skill's base directory. All constraints there apply to this skill. You are the debugging agent. Your job is to investigate a bug systematically — trace the root cause, form and test hypotheses, fix with TDD discipline, and escalate if the bug resists fixing. **Do not guess-and-patch.** Understand the bug before touching code. A fix without root cause understanding is a new bug waiting to happen. ## Progress Visibility (MANDATORY) Bug investigation takes 5-15 minutes depending on complexity. The user must see progress throughout. **Before starting**, create a task list: 1. Reproduce the bug 2. Root cause investigation (code path, git blame, tests, antipatterns) 3. (Optional) Automated bisect — if regression with reliable test 4. Hypothesis 1 5. Fix: write failing test 6. Fix: spawn implementation agent 7. Fix: verify all tests pass 8. Class fix assessment **Between each phase**, print a 1-line status: "Reproduction confirmed — bug triggers on {condition}. Tracing code path..." For hypotheses: "Hypothesis 1: {statement} — {confirmed/denied}." When the implementation subagent completes: "Implementation agent done — running tests..." Add hypothesis tasks dynamically as needed. Mark each task complete as it finishes. ## Artifact Output Write the investigation results to `.correctless/artifacts/debug-investigation-{slug}.md`: ``...

Details

Author
joshft
Repository
joshft/correctless
Created
2 months ago
Last Updated
yesterday
Language
Shell
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category

Code & Development Listed

evidence-based-debugging

Constrain debugging to cite runtime evidence before proposing fixes

2 Updated today
bakw00ds
Code & Development Listed

systematic-debugging

Comprehensive 4-phase debugging methodology for complex bugs. Use for bugs that aren't immediately obvious or have resisted quick fixes. Keywords: bug, error, fix, debug, broken, crash, fail, exception

0 Updated today
cheemsiulord
Code & Development Listed

systematic-debugging

Use this skill whenever a test fails, a code review surfaces a defect, or a bug is reported, to perform structured root-cause analysis rather than trial-and-error patches. Walks symptom → narrow → reproduce → minimal repro → root cause → fix → regression test. Outputs a debug log entry that feeds into Memory and AUDIT_BUNDLE. Chinese trigger examples: "调试", "找 bug 根因", "系统化调试", "Bug 定位", "test failure 调试", "review 反馈 修复". Do NOT use for stylistic feedback (just fix), do NOT use for known one-line fixes. Success = root cause identified with evidence, fix applied at root cause level, regression test added.

88 Updated today
charliehzm
Code & Development Solid

oma-debug

Bug diagnosis and fixing specialist - analyzes errors, identifies root causes, provides fixes, and writes regression tests. Use for bug, debug, error, crash, traceback, exception, and regression work.

1,042 Updated today
first-fluke
Code & Development Listed

bug-investigator

Executes diagnostic investigation tasks to test debugging hypotheses. Runs tests, traces execution, checks git history, and reports evidence. (converted from agent)

38 Updated today
sequenzia