Skip to content

lidge-jun/codexclaw / plugins/codexclaw/skills/dev-debugging

cxc-dev-debugging

Unverified

Use for debugging and system comprehension. Triggers: debug this, root cause, how does X work, reverse engineer, 왜 안 돼, 디버깅, 원인 분석, 로직 파악, 뜯어봐.

dev-debugging — Systematic Root Cause Analysis

Boundary: This skill covers how to reason about bugs. For test harness, reproduction frameworks, and verification tooling, see dev-testing. For domain-specific context (API errors, hydration issues, query performance), consult dev-backend or dev-frontend. Comprehension without a defect — understanding how an unknown app, API, AI tool, or codebase works — routes to references/logic-analysis.md.

Class, fast path, rule authority, proof, and safety: dev. Current/public evidence: dev routing.

Core Principle

Check if the problem is structural before debugging code. Before a permanent fix, investigate and explain the cause. During an active incident, an already-authorized, reversible mitigation may precede full RCA; follow dev-devops incident policy and preserve evidence. Diagnosis alone never authorizes a code fix, rollback, production access, or an upstream issue submission.

RCA Entry Gates

STRICT (DEBUG-RCA-EVIDENCE-01): Before investigating any single root-cause hypothesis or making a root-cause claim, write at least three orthogonal hypotheses (H1/H2/H3) and one falsifier for each. Collapse duplicates, test against disconfirming evidence, and do not claim root cause until competing hypotheses have been ruled out by evidence. If fewer than three are plausible, state why.

STRICT (DEBUG-TOGGLE-PROOF-01): Enter implementation only after the captured value matches the hypothesis prediction, the repro repeats, and toggling the suspected cause off/on removes then restores the bug. Write one paragraph explaining the causal mechanism before patching.

Logic Analysis (comprehension without a defect)

When the request is to understand how a system works — closed app, AI tool, undocumented API, unfamiliar codebase — rather than to fix a defect, read Logic analysis. Core rules: "I can't" is a skipped analysis loop, not a limit; missing source/docs is a starting condition; hypothesize from names/strings/errors, observe static AND dynamic, mutate one variable at a time, keep an incremental model with UNKNOWN fields, and prove the model by writing a client that uses it. Honest lab-boundary routing (IDA/Procmon/Cuckoo class) beats both refusal and fabrication.

Security-Sensitive Bugs

For security-sensitive bugs (auth bypass, data leak, injection), use dev-security for controls and dev-devops for incident response. Preserve the same authorization boundary.

Modular References

ConditionReference
Defect diagnosis before permanent repair: phases 0–4 and implementation entry gatesroot-cause-phases.md
Guessing, repeated failures, or suppressive fixesdebugging-pitfalls.md
API 500, hydration mismatch, N+1 query, or flaky-test diagnosis examplesdebugging-scenarios.md
Investigation stalls, needs escalation, or meets postmortem criteriaescalation-and-postmortems.md
Choosing the boundary between debugging and companion skillsskill-boundaries.md
Choosing a debug approachmethodologies.md
Understanding how an unknown system works (no defect)logic-analysis.md
Concurrency issuesasync-debugging.md
Quick cheatsheettool-guides.md
After resolving a significant incidentpostmortem-template.md
Node.js / tsx / Bun / Denoruntimes/node.md
Next.js 16 / React 19runtimes/js/nextjs-react.md
Vite 8 / Vitest 4runtimes/js/vite-vitest.md
Express 5 / Fastify 5 / NestJS 11runtimes/js/node-backend.md
Python (CPython 3.9+)runtimes/python.md
Rustruntimes/rust.md
Goruntimes/go.md
C/C++runtimes/c-cpp.md
Java/Kotlin (JVM)runtimes/jvm.md
Swift / iOS / macOS AppKitruntimes/swift.md
Ruby (3.2+)runtimes/ruby.md
Elixir/Erlang (BEAM)runtimes/beam.md
Browser/web-surface bugstools/playwright.md
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 318kUpdated Claude CodeCodexUnverifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 318kUpdated Claude CodeCodexUnverifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 318kUpdated Claude CodeCodexUnverifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 196kUpdated Claude CodeCodexVerifiedInstall