backnotprop/pstack

principle-fix-root-causes

Apply when debugging.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/backnotprop/pstack --skill principle-fix-root-causes

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

Fix Root Causes

Fix the fault, not the place where it surfaced. The root cause is the first place the system did something it should not do, or failed to handle a state it should handle.

  • Reproduce first. Ask "why" until the answer is a wrong decision in the code. When stuck, instrument and read the actual state.
  • Ask whether the state that triggered the symptom is legitimate. If it is, handle it where the code broke. If it should never exist, a check there hides the bug, so find what produced it. Guards, retries, swallowed errors, clamped values, and discarded state are the usual ways to hide a bug.
  • Fix the pattern, not the instance. Find every place with the same fault.
  • If the deciding fact took a deep dig, propose the cheap, always-on signal that would have shown it at first look.
from this repository

More skills

All skills