mcpField
D
debug

debug

github.com/owainlewisDevelopment423191 installsUpdated 1d ago
Repository

About debug

A debugging skill for coding agents that guides investigation from reproducing a failure through a root-cause fix and verification, with emphasis on focused changes and clear reporting.

Key features

  1. 01Reproduce failures
  2. 02Trace root causes
  3. 03Add regression tests when practical
  4. 04Make the smallest effective fix
  5. 05Run checks and report results

Use cases

  1. 01Investigating a reproducible bug
  2. 02Verifying a fix with a regression test
  3. 03Reporting unexplained behavior or blockers

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/owainlewis/blueprint --skill debug

After installing, type/debugin Claude Code to confirm it loaded.

Details

From the project README

Debug

  1. Reproduce the failure. If you cannot, keep gathering information and report what you observed.
  2. Trace it to the root cause and explain why it happens.
  3. Add a small failing regression test when practical, then make the smallest fix that passes it. If no useful test is practical, say why and verify another way.
  4. Run relevant checks. Report the cause, the fix, how it was verified, and anything still unexplained.

Rules

  • Fix the cause, not the symptom. Do not delete the failing check, swallow the error, or weaken the assertion unless that is the real fix.
  • One bug at a time.
  • Do not pull unrelated failures or flaky infrastructure into the task.
  • Stop when the fix needs a product or code-owner decision.

Comments

Markdown supported