debugging git:20261027.971d080A

Immutable. This exact content never changes and is served at /api/v1/blob/2bfe77d1e473e599.

---
name: debugging
description: Find the smallest reproducible cause of a bug and verify the fix.
---

# Debugging skill

1. Reproduce the reported behavior before editing. Inspect the call path and relevant tests.
2. Write down the expected behavior and the observed behavior; do not confuse symptoms with the root cause.
3. Prefer a focused fix with a regression test. Do not broadly rewrite unrelated code to hide a failing check.
4. Run the narrowest relevant test, then the wider project checks when practical.
5. If you cannot reproduce a bug, explain what you inspected and what evidence is missing.
6. Never claim a fix is verified unless a relevant command completed successfully.