systematic-debugging
FeaturedUse when encountering a bug, test failure, or unexpected behavior, before proposing fixes
Code & Development 1,179 stars
52 forks Updated yesterday MIT
Install
Quality Score: 93/100
Stars 20%
Recency 20%
Frontmatter 20%
Documentation 15%
Issue Health 10%
License 10%
Description 5%
Skill Content
# Execute
Bug, failure, or unexpected behavior:
1. **Isolate** — read error, reproduce, inspect the diff, and drill upward through diagnostic layers:
L1 symptom → L2 logic → L3 system → L4 architecture → L5 cross-system
contract → L6 platform → L7 spec gap. Layers are observation altitudes,
not one causal chain; the causal shape at the stop altitude is classified
explicitly before any root claim. Stop only when causal proof accounts
for the recurrence generator or reaches a T-class boundary.
2. **Identify owner** — compare working behavior, trace the bad value, locate the
canonical owner, and treat duplicate owners as a finding.
3. **Decide before editing** — Before fixing, run Patch-Shape Triage and Ripple Signal Triage when shared logic,
contracts, fallbacks, adapters, producer/consumer seams, or source-of-truth
boundaries are involved. Surface Change Necessity for any new source-code
path or non-trivial source edit. Run Minimality Check for a new branch,
fallback, adapter, owner, or compatibility path, and Pre-Edit Complexity
Check for an overloaded owner or complexity growth. After Change Necessity
selects `code-change` and before the first repair edit, own the TDD Route for
the repair slice: `off` skips automatic TDD; `auto` selects `strict` on any
behavior, bugfix, shared/core, contract, persistence, permission, migration,
producer/consumer, or meaningful regression signal. `light` requires every
tiny/low-risk/single-own...
Details
- Author
- GanyuanRan
- Repository
- GanyuanRan/Aegis
- Created
- 4 months ago
- Last Updated
- yesterday
- Language
- Python
- License
- MIT
Bundled in these plugins
Similar Skills
Semantically similar based on skill content — not just same category
Code & Development Listed
systematic-debugging
Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes.
0 Updated 1 months ago
sipandey Code & Development Listed
systematic-debugging
Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes.
6 Updated 6 days ago
jamesblackwell Code & Development Listed
systematic-debugging
Use when a bug, failing or flaky test, production incident, unexpected output, or performance regression has an unknown cause.
5 Updated 2 days ago
lawzava