[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M79XSAF3R6RAS4ZEC0H3EDV0":3,"skill-same:01M79XSAF3R6RAS4ZEC0H3EDV0":71},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M79XSAF3R6RAS4ZEC0H3EDV0","deniz-process.systematic-debugging",null,"Use when encountering any bug, test failure, performance regression, or unexpected behavior, before proposing fixes","Blind-Striker\u002Fagent-skills-and-plugins","Blind-Striker","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F1965259?v=4","01M79WFXTE5PH0C1VB7B54ANMN","Deniz İrgin","01M79WFXV5KZ5GST1K8G035DM5",1,"MIT","https:\u002F\u002Fgithub.com\u002FBlind-Striker\u002Fagent-skills-and-plugins\u002Fblob\u002Fmaster\u002Fopencode\u002Fdeniz-process\u002Fskills\u002Fdeniz-process.systematic-debugging\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: deniz-process.systematic-debugging\ndescription: Use when encountering any bug, test failure, performance\n  regression, or unexpected behavior, before proposing fixes\n---\n\n# Systematic Debugging\n\n## Overview\n\n**Core principle:** build a feedback loop, then find the root cause — no fixes before both.\nSymptom fixes are failure. A tight pass\u002Ffail signal for the bug is what bisection, hypotheses,\nand instrumentation all consume; without one, no amount of staring at code will save you.\n\n**Violating the letter of this process is violating the spirit of debugging.**\n\n## The Iron Law\n\n```\nNO FIXES WITHOUT A RED FEEDBACK LOOP AND A ROOT CAUSE\n```\n\nIf you haven't completed Phases 1–3, you cannot propose fixes.\n\n## When to Use\n\nUse for ANY technical issue: test failures, bugs in production, unexpected behavior, performance\nregressions, build failures, integration issues.\n\n**Use this ESPECIALLY when:**\n\n- Under time pressure (emergencies make guessing tempting)\n- \"Just one quick fix\" seems obvious\n- You've already tried multiple fixes\n- The previous fix didn't work\n- You don't fully understand the issue\n\n**Don't skip when:** the issue seems simple (simple bugs have root causes too), you're in a hurry\n(systematic is faster than thrashing), or someone wants it fixed NOW.\n\n## Redact\n\nThis skill has you show commands, outputs and captured artifacts. **Redact every secret first**:\nwrite `\u003CREDACTED>` in its place. Build loops against env vars, so the credential stays in the\nenvironment rather than in what you show. Captured artifacts carry auth headers: quote only the\nlines that carry the signal.\n\nIf the redacted output is not enough to diagnose the bug, say so and ask your human partner.\n\n## Phase 1 — Build a Feedback Loop\n\n**This is the skill. Everything else is mechanical.** If you have a **tight** pass\u002Ffail signal\nthat goes red on *this* bug, you will find the cause. If you don't, stop — build one first.\n\nSpend disproportionate effort here. Be aggressive. Be creative. Refuse to give up.\n\n### Ways to construct one — in roughly this order\n\n1. **Failing test** at whatever seam reaches the bug — unit, integration, e2e.\n2. **Curl \u002F HTTP script** against a running dev server.\n3. **CLI invocation** with a fixture input, diffing stdout against a known-good snapshot.\n4. **Headless browser script** (Playwright \u002F Puppeteer) — drives the UI, asserts on\n   DOM\u002Fconsole\u002Fnetwork.\n5. **Replay a captured trace.** Save a real request \u002F payload \u002F event log to disk; replay it\n   through the code path in isolation.\n6. **Throwaway harness.** Spin up a minimal subset of the system (one service, mocked deps) that\n   exercises the bug code path with a single call.\n7. **Property \u002F fuzz loop.** If the bug is \"sometimes wrong output\", run 1000 random inputs and\n   look for the failure mode.\n8. **Bisection harness.** If the bug appeared between two known states (commit, dataset,\n   version), automate \"boot at state X, check, repeat\" so you can `git bisect run` it.\n9. **Differential loop.** Run the same input through old vs new version (or two configs) and\n   diff outputs.\n10. **Human-in-the-loop script.** Last resort. If a human must click, drive *them* with a\n    structured checklist script whose captured output feeds back to you — still a loop, just a\n    slow one.\n\n### Tighten the loop\n\nTreat the loop as a product:\n\n- **Faster** — cache setup, skip unrelated init, narrow the scope.\n- **Sharper** — assert on the specific symptom, not \"didn't crash\".\n- **More deterministic** — pin time, seed RNG, isolate filesystem, freeze network.\n\nA 30-second flaky loop is barely better than no loop; a 2-second deterministic one is a\ndebugging superpower.\n\n### Non-deterministic bugs\n\nThe goal is not a clean repro but a **higher reproduction rate**. Loop the trigger 100×,\nparallelise, add stress, narrow timing windows, inject sleeps. A 50%-flake is debuggable; 1% is\nnot — keep raising the rate until it is.\n\n### When you genuinely cannot build a loop\n\nStop and say so explicitly. List what you tried. Ask your human partner for (a) access to the\nenvironment that reproduces it, (b) a redacted captured artifact (HAR file, log dump, core dump,\nrecording with timestamps), or (c) permission to add temporary production instrumentation.\nDo **not** proceed to hypothesise without a loop.\n\n### Completion criterion — one command that goes red\n\nPhase 1 is done when you can name **one command** — a script path, a test invocation, a curl —\nthat you have **already run at least once** (show the invocation and its output, redacted), and that is:\n\n- [ ] **Red-capable** — it drives the actual bug code path and asserts the **user's exact\n      symptom**, so it goes red on this bug and green once fixed.\n- [ ] **Deterministic** — same verdict every run (flaky bugs: a pinned, high reproduction rate).\n- [ ] **Fast** — seconds, not minutes.\n- [ ] **Agent-runnable** — you can run it unattended.\n\nIf you catch yourself reading code to build a theory before this command exists, **stop —\njumping straight to a hypothesis is the exact failure this skill prevents.**\n\n## Phase 2 — Reproduce and Minimise\n\nRun the loop. Watch it go red. Confirm:\n\n- [ ] The failure is the one the **user** described — not a different failure that happens to be\n      nearby. Wrong bug = wrong fix.\n- [ ] It reproduces across multiple runs (or at a high enough rate to debug against).\n- [ ] You captured the exact symptom (error message, wrong output, timing) so later phases can\n      verify the fix addresses *it*.\n\nThen shrink the repro to the **smallest scenario that still goes red**: cut inputs, callers,\nconfig, data, and steps **one at a time**, re-running the loop after each cut. Done when **every\nremaining element is load-bearing** — removing any one makes the loop go green. A minimal repro\nshrinks the hypothesis space and becomes the regression test later.\n\n## Phase 3 — Investigate the Root Cause\n\n**Before forming any hypothesis:**\n\n1. **Read error messages carefully.** Complete stack traces, line numbers, error codes — they\n   often contain the exact answer.\n2. **Check recent changes.** Git diff, recent commits, new dependencies, config changes,\n   environmental differences.\n3. **Gather evidence in multi-component systems.** When the path crosses components\n   (CI → build → signing, API → service → database), instrument each boundary — log what enters\n   and exits, verify config propagation — and run once to see WHERE it breaks before asking why.\n4. **Trace data flow.** Where does the bad value originate? What called this with it? Keep\n   tracing up to the source — see `root-cause-tracing.md` in this directory. Fix at the source,\n   not at the symptom.\n5. **Find the pattern.** Locate similar working code in the same codebase; if implementing a\n   reference pattern, read it COMPLETELY. List every difference between working and broken,\n   however small — don't assume \"that can't matter\".\n\n## Phase 4 — Hypothesise and Test\n\nGenerate **3–5 ranked hypotheses** before testing any. Single-hypothesis generation anchors on\nthe first plausible idea.\n\nEach hypothesis must be **falsifiable** — state its prediction:\n\n> \"If \u003CX> is the cause, then \u003Cchanging Y> will make the loop go green \u002F \u003Cchanging Z> will make\n> it worse.\"\n\nIf you cannot state the prediction, it's a vibe — discard or sharpen it.\n\n**Show the ranked list to your human partner before testing.** They often re-rank instantly\n(\"we just deployed a change to #3\") or have already ruled some out. Don't block on it — proceed\nwith your ranking if they're away.\n\nTest minimally: the **smallest possible change**, one variable at a time. Didn't work? Form a\nNEW hypothesis — don't stack fixes. Don't know? Say \"I don't understand X\" and investigate —\nnever pretend to know.\n\n## Phase 5 — Instrument\n\nEach probe must map to a specific prediction from Phase 4. **Change one variable at a time.**\n\n1. **Debugger \u002F REPL inspection** if the environment supports it — one breakpoint beats ten logs.\n2. **Targeted logs** at the boundaries that distinguish hypotheses.\n3. Never \"log everything and grep\".\n\n**Tag every debug log** with a unique prefix, e.g. `[DEBUG-a4f2]` — cleanup becomes a single\ngrep. Untagged logs survive; tagged logs die.\n\n**Performance regressions:** logs are usually the wrong tool. Establish a baseline measurement\n(timing harness, profiler, query plan), then bisect. Measure first, fix second.\n\n## Phase 6 — Fix\n\n1. **Regression test first — at a correct seam.** Turn the minimised repro into a failing test\n   using the deniz-process.test-driven-development skill. A correct seam exercises the real bug\n   pattern as it occurs at the call site; a too-shallow seam gives false confidence. **If no\n   correct seam exists, that itself is a finding** — the architecture is preventing the bug from\n   being locked down. Document it and raise it with your human partner. If you forced the red by\n   mutating code or a fixture, `diff` against a pristine copy to prove the mutation landed before\n   you trust it.\n2. **Implement a single fix** at the root cause. ONE change; no \"while I'm here\" improvements,\n   no bundled refactoring.\n3. **Verify.** Test passes, no other tests broken, and the Phase 1 loop goes green against the\n   original (un-minimised) scenario. Use the deniz-process.verification-before-completion skill\n   before claiming success.\n4. **If the fix doesn't work:** STOP and count. Fewer than 3 attempts → return to Phase 3 with\n   the new information. **3 or more → question the architecture:**\n\n   Each fix revealing a new problem elsewhere, fixes needing \"massive refactoring\", every fix\n   creating new symptoms — that pattern is not a failed hypothesis, it is a wrong architecture.\n   Stop fix attempts on this bug before fix #4. Finish independent work, then bring the\n   architecture question to your human partner with the evidence and your recommendation.\n\n## Phase 7 — Cleanup and Post-Mortem\n\nRequired before declaring done:\n\n- [ ] Original repro no longer reproduces (re-run the Phase 1 loop)\n- [ ] Regression test passes (or the absence of a correct seam is documented)\n- [ ] All `[DEBUG-...]` instrumentation removed (grep the prefix)\n- [ ] Throwaway harnesses and prototypes deleted\n- [ ] The hypothesis that turned out correct is stated in the commit message — the next\n      debugger learns from it\n\n**Then ask: what would have prevented this bug?** If the answer is architectural (no good test\nseam, tangled callers, hidden coupling), raise it with your human partner as its own piece of\nwork — after the fix is in, when you know the most. See `defense-in-depth.md` for adding\nvalidation at multiple layers once the root cause is known.\n\nIf systematic investigation reveals the issue is truly environmental or external: document what\nyou investigated, implement appropriate handling (retry, timeout, error message), add\nmonitoring. But 95% of \"no root cause\" cases are incomplete investigation.\n\n## Red Flags — STOP and Follow the Process\n\nIf you catch yourself thinking:\n\n- \"Quick fix for now, investigate later\"\n- \"Just try changing X and see if it works\"\n- Reading code to build a theory **before a red-capable command exists**\n- \"Add multiple changes, run tests\"\n- \"Skip the test, I'll manually verify\"\n- \"It's probably X, let me fix that\"\n- \"I don't fully understand but this might work\"\n- Proposing solutions before tracing data flow\n- **\"One more fix attempt\" (when already tried 2+)**\n- **Each fix reveals a new problem in a different place**\n\n**ALL of these mean: STOP. Return to the phase you skipped.**\n\n## Common Rationalizations\n\n| Excuse | Reality |\n|--------|---------|\n| \"Issue is simple, don't need process\" | Simple issues have root causes too. The process is fast for simple bugs. |\n| \"Emergency, no time for process\" | Systematic debugging is FASTER than guess-and-check thrashing. |\n| \"A loop is overkill, I can eyeball this\" | Without a red signal you cannot even prove the bug is fixed. |\n| \"Just try this first, then investigate\" | The first fix sets the pattern. Do it right from the start. |\n| \"I'll write the test after confirming the fix\" | Untested fixes don't stick. Red first proves the test can catch it. |\n| \"Multiple fixes at once saves time\" | You can't isolate what worked, and it causes new bugs. |\n| \"Reference too long, I'll adapt the pattern\" | Partial understanding guarantees bugs. Read it completely. |\n| \"I see the problem, let me fix it\" | Seeing symptoms ≠ understanding the root cause. |\n| \"One more fix attempt\" (after 2+) | 3+ failures = architectural problem. Question the pattern, don't fix again. |\n\n## Quick Reference\n\n| Phase | Key activity | Done when |\n|-------|-------------|-----------|\n| **1. Loop** | Construct a tight pass\u002Ffail signal | One red-capable, deterministic, fast command — already run |\n| **2. Reproduce + minimise** | Watch it go red, shrink the repro | Every remaining element is load-bearing |\n| **3. Root cause** | Errors, recent changes, evidence, data flow, patterns | You understand WHAT and WHY |\n| **4. Hypothesise** | 3–5 ranked, falsifiable predictions | One confirmed by minimal test |\n| **5. Instrument** | One probe per prediction, tagged | Hypotheses distinguished by evidence |\n| **6. Fix** | Test-first at a correct seam, single fix | Test green, suite green, loop green |\n| **7. Cleanup** | Remove instrumentation, post-mortem | Checklist above complete |\n\n## Supporting Techniques\n\nAvailable in this directory:\n\n- **`root-cause-tracing.md`** — trace bugs backward through the call stack to the original trigger\n- **`defense-in-depth.md`** — add validation at multiple layers after finding the root cause\n- **`condition-based-waiting.md`** — replace arbitrary timeouts with condition polling\n","# Systematic Debugging\n\n## Overview\n\n**Core principle:** build a feedback loop, then find the root cause — no fixes before both.\nSymptom fixes are failure. A tight pass\u002Ffail signal for the bug is what bisection, hypotheses,\nand instrumentation all consume; without one, no amount of staring at code will save you.\n\n**Violating the letter of this process is violating the spirit of debugging.**\n\n## The Iron Law\n\n```\nNO FIXES WITHOUT A RED FEEDBACK LOOP AND A ROOT CAUSE\n```\n\nIf you haven't completed Phases 1–3, you cannot propose fixes.\n\n## When to Use\n\nUse for ANY technical issue: test failures, bugs in production, unexpected behavior, performance\nregressions, build failures, integration issues.\n\n**Use this ESPECIALLY when:**\n\n- Under time pressure (emergencies make guessing tempting)\n- \"Just one quick fix\" seems obvious\n- You've already tried multiple fixes\n- The previous fix didn't work\n- You don't fully understand the issue\n\n**Don't skip when:** the issue seems simple (simple bugs have root causes too), you're in a hurry\n(systematic is faster than thrashing), or someone wants it fixed NOW.\n\n## Redact\n\nThis skill has you show commands, outputs and captured artifacts. **Redact every secret first**:\nwrite `\u003CREDACTED>` in its place. Build loops against env vars, so the credential stays in the\nenvironment rather than in what you show. Captured artifacts carry auth headers: quote only the\nlines that carry the signal.\n\nIf the redacted output is not enough to diagnose the bug, say so and ask your human partner.\n\n## Phase 1 — Build a Feedback Loop\n\n**This is the skill. Everything else is mechanical.** If you have a **tight** pass\u002Ffail signal\nthat goes red on *this* bug, you will find the cause. If you don't, stop — build one first.\n\nSpend disproportionate effort here. Be aggressive. Be creative. Refuse to give up.\n\n### Ways to construct one — in roughly this order\n\n1. **Failing test** at whatever seam reaches the bug — unit, integration, e2e.\n2. **Curl \u002F HTTP script** against a running dev server.\n3. **CLI invocation** with a fixture input, diffing stdout against a known-good snapshot.\n4. **Headless browser script** (Playwright \u002F Puppeteer) — drives the UI, asserts on\n   DOM\u002Fconsole\u002Fnetwork.\n5. **Replay a captured trace.** Save a real request \u002F payload \u002F event log to disk; replay it\n   through the code path in isolation.\n6. **Throwaway harness.** Spin up a minimal subset of the system (one service, mocked deps) that\n   exercises the bug code path with a single call.\n7. **Property \u002F fuzz loop.** If the bug is \"sometimes wrong output\", run 1000 random inputs and\n   look for the failure mode.\n8. **Bisection harness.** If the bug appeared between two known states (commit, dataset,\n   version), automate \"boot at state X, check, repeat\" so you can `git bisect run` it.\n9. **Differential loop.** Run the same input through old vs new version (or two configs) and\n   diff outputs.\n10. **Human-in-the-loop script.** Last resort. If a human must click, drive *them* with a\n    structured checklist script whose captured output feeds back to you — still a loop, just a\n    slow one.\n\n### Tighten the loop\n\nTreat the loop as a product:\n\n- **Faster** — cache setup, skip unrelated init, narrow the scope.\n- **Sharper** — assert on the specific symptom, not \"didn't crash\".\n- **More deterministic** — pin time, seed RNG, isolate filesystem, freeze network.\n\nA 30-second flaky loop is barely better than no loop; a 2-second deterministic one is a\ndebugging superpower.\n\n### Non-deterministic bugs\n\nThe goal is not a clean repro but a **higher reproduction rate**. Loop the trigger 100×,\nparallelise, add stress, narrow timing windows, inject sleeps. A 50%-flake is debuggable; 1% is\nnot — keep raising the rate until it is.\n\n### When you genuinely cannot build a loop\n\nStop and say so explicitly. List what you tried. Ask your human partner for (a) access to the\nenvironment that reproduces it, (b) a redacted captured artifact (HAR file, log dump, core dump,\nrecording with timestamps), or (c) permission to add temporary production instrumentation.\nDo **not** proceed to hypothesise without a loop.\n\n### Completion criterion — one command that goes red\n\nPhase 1 is done when you can name **one command** — a script path, a test invocation, a curl —\nthat you have **already run at least once** (show the invocation and its output, redacted), and that is:\n\n- [ ] **Red-capable** — it drives the actual bug code path and asserts the **user's exact\n      symptom**, so it goes red on this bug and green once fixed.\n- [ ] **Deterministic** — same verdict every run (flaky bugs: a pinned, high reproduction rate).\n- [ ] **Fast** — seconds, not minutes.\n- [ ] **Agent-runnable** — you can run it unattended.\n\nIf you catch yourself reading code to build a theory before this command exists, **stop —\njumping straight to a hypothesis is the exact failure this skill prevents.**\n\n## Phase 2 — Reproduce and Minimise\n\nRun the loop. Watch it go red. Confirm:\n\n- [ ] The failure is the one the **user** described — not a different failure that happens to be\n      nearby. Wrong bug = wrong fix.\n- [ ] It reproduces across multiple runs (or at a high enough rate to debug against).\n- [ ] You captured the exact symptom (error message, wrong output, timing) so later phases can\n      verify the fix addresses *it*.\n\nThen shrink the repro to the **smallest scenario that still goes red**: cut inputs, callers,\nconfig, data, and steps **one at a time**, re-running the loop after each cut. Done when **every\nremaining element is load-bearing** — removing any one makes the loop go green. A minimal repro\nshrinks the hypothesis space and becomes the regression test later.\n\n## Phase 3 — Investigate the Root Cause\n\n**Before forming any hypothesis:**\n\n1. **Read error messages carefully.** Complete stack traces, line numbers, error codes — they\n   often contain the exact answer.\n2. **Check recent changes.** Git diff, recent commits, new dependencies, config changes,\n   environmental differences.\n3. **Gather evidence in multi-component systems.** When the path crosses components\n   (CI → build → signing, API → service → database), instrument each boundary — log what enters\n   and exits, verify config propagation — and run once to see WHERE it breaks before asking why.\n4. **Trace data flow.** Where does the bad value originate? What called this with it? Keep\n   tracing up to the source — see `root-cause-tracing.md` in this directory. Fix at the source,\n   not at the symptom.\n5. **Find the pattern.** Locate similar working code in the same codebase; if implementing a\n   reference pattern, read it COMPLETELY. List every difference between working and broken,\n   however small — don't assume \"that can't matter\".\n\n## Phase 4 — Hypothesise and Test\n\nGenerate **3–5 ranked hypotheses** before testing any. Single-hypothesis generation anchors on\nthe first plausible idea.\n\nEach hypothesis must be **falsifiable** — state its prediction:\n\n> \"If \u003CX> is the cause, then \u003Cchanging Y> will make the loop go green \u002F \u003Cchanging Z> will make\n> it worse.\"\n\nIf you cannot state the prediction, it's a vibe — discard or sharpen it.\n\n**Show the ranked list to your human partner before testing.** They often re-rank instantly\n(\"we just deployed a change to #3\") or have already ruled some out. Don't block on it — proceed\nwith your ranking if they're away.\n\nTest minimally: the **smallest possible change**, one variable at a time. Didn't work? Form a\nNEW hypothesis — don't stack fixes. Don't know? Say \"I don't understand X\" and investigate —\nnever pretend to know.\n\n## Phase 5 — Instrument\n\nEach probe must map to a specific prediction from Phase 4. **Change one variable at a time.**\n\n1. **Debugger \u002F REPL inspection** if the environment supports it — one breakpoint beats ten logs.\n2. **Targeted logs** at the boundaries that distinguish hypotheses.\n3. Never \"log everything and grep\".\n\n**Tag every debug log** with a unique prefix, e.g. `[DEBUG-a4f2]` — cleanup becomes a single\ngrep. Untagged logs survive; tagged logs die.\n\n**Performance regressions:** logs are usually the wrong tool. Establish a baseline measurement\n(timing harness, profiler, query plan), then bisect. Measure first, fix second.\n\n## Phase 6 — Fix\n\n1. **Regression test first — at a correct seam.** Turn the minimised repro into a failing test\n   using the deniz-process.test-driven-development skill. A correct seam exercises the real bug\n   pattern as it occurs at the call site; a too-shallow seam gives false confidence. **If no\n   correct seam exists, that itself is a finding** — the architecture is preventing the bug from\n   being locked down. Document it and raise it with your human partner. If you forced the red by\n   mutating code or a fixture, `diff` against a pristine copy to prove the mutation landed before\n   you trust it.\n2. **Implement a single fix** at the root cause. ONE change; no \"while I'm here\" improvements,\n   no bundled refactoring.\n3. **Verify.** Test passes, no other tests broken, and the Phase 1 loop goes green against the\n   original (un-minimised) scenario. Use the deniz-process.verification-before-completion skill\n   before claiming success.\n4. **If the fix doesn't work:** STOP and count. Fewer than 3 attempts → return to Phase 3 with\n   the new information. **3 or more → question the architecture:**\n\n   Each fix revealing a new problem elsewhere, fixes needing \"massive refactoring\", every fix\n   creating new symptoms — that pattern is not a failed hypothesis, it is a wrong architecture.\n   Stop fix attempts on this bug before fix #4. Finish independent work, then bring the\n   architecture question to your human partner with the evidence and your recommendation.\n\n## Phase 7 — Cleanup and Post-Mortem\n\nRequired before declaring done:\n\n- [ ] Original repro no longer reproduces (re-run the Phase 1 loop)\n- [ ] Regression test passes (or the absence of a correct seam is documented)\n- [ ] All `[DEBUG-...]` instrumentation removed (grep the prefix)\n- [ ] Throwaway harnesses and prototypes deleted\n- [ ] The hypothesis that turned out correct is stated in the commit message — the next\n      debugger learns from it\n\n**Then ask: what would have prevented this bug?** If the answer is architectural (no good test\nseam, tangled callers, hidden coupling), raise it with your human partner as its own piece of\nwork — after the fix is in, when you know the most. See `defense-in-depth.md` for adding\nvalidation at multiple layers once the root cause is known.\n\nIf systematic investigation reveals the issue is truly environmental or external: document what\nyou investigated, implement appropriate handling (retry, timeout, error message), add\nmonitoring. But 95% of \"no root cause\" cases are incomplete investigation.\n\n## Red Flags — STOP and Follow the Process\n\nIf you catch yourself thinking:\n\n- \"Quick fix for now, investigate later\"\n- \"Just try changing X and see if it works\"\n- Reading code to build a theory **before a red-capable command exists**\n- \"Add multiple changes, run tests\"\n- \"Skip the test, I'll manually verify\"\n- \"It's probably X, let me fix that\"\n- \"I don't fully understand but this might work\"\n- Proposing solutions before tracing data flow\n- **\"One more fix attempt\" (when already tried 2+)**\n- **Each fix reveals a new problem in a different place**\n\n**ALL of these mean: STOP. Return to the phase you skipped.**\n\n## Common Rationalizations\n\n| Excuse | Reality |\n|--------|---------|\n| \"Issue is simple, don't need process\" | Simple issues have root causes too. The process is fast for simple bugs. |\n| \"Emergency, no time for process\" | Systematic debugging is FASTER than guess-and-check thrashing. |\n| \"A loop is overkill, I can eyeball this\" | Without a red signal you cannot even prove the bug is fixed. |\n| \"Just try this first, then investigate\" | The first fix sets the pattern. Do it right from the start. |\n| \"I'll write the test after confirming the fix\" | Untested fixes don't stick. Red first proves the test can catch it. |\n| \"Multiple fixes at once saves time\" | You can't isolate what worked, and it causes new bugs. |\n| \"Reference too long, I'll adapt the pattern\" | Partial understanding guarantees bugs. Read it completely. |\n| \"I see the problem, let me fix it\" | Seeing symptoms ≠ understanding the root cause. |\n| \"One more fix attempt\" (after 2+) | 3+ failures = architectural problem. Question the pattern, don't fix again. |\n\n## Quick Reference\n\n| Phase | Key activity | Done when |\n|-------|-------------|-----------|\n| **1. Loop** | Construct a tight pass\u002Ffail signal | One red-capable, deterministic, fast command — already run |\n| **2. Reproduce + minimise** | Watch it go red, shrink the repro | Every remaining element is load-bearing |\n| **3. Root cause** | Errors, recent changes, evidence, data flow, patterns | You understand WHAT and WHY |\n| **4. Hypothesise** | 3–5 ranked, falsifiable predictions | One confirmed by minimal test |\n| **5. Instrument** | One probe per prediction, tagged | Hypotheses distinguished by evidence |\n| **6. Fix** | Test-first at a correct seam, single fix | Test green, suite green, loop green |\n| **7. Cleanup** | Remove instrumentation, post-mortem | Checklist above complete |\n\n## Supporting Techniques\n\nAvailable in this directory:\n\n- **`root-cause-tracing.md`** — trace bugs backward through the call stack to the original trigger\n- **`defense-in-depth.md`** — add validation at multiple layers after finding the root cause\n- **`condition-based-waiting.md`** — replace arbitrary timeouts with condition polling\n",{"name":5,"description":7},"master","b30b1c1908dbc56a8184128f18803053d762ccb5","opencode\u002Fdeniz-process\u002Fskills\u002Fdeniz-process.systematic-debugging",0,"https:\u002F\u002Fgithub.com\u002FBlind-Striker\u002Fagent-skills-and-plugins","https:\u002F\u002Fgithub.com\u002FBlind-Striker","denizirgin.com","VP of Engineering - \r\n@armutcom @homeruntech @prontopro\r\n |  Speaker \r\n@CodeFiction\r\n, http:\u002F\u002Fcodefiction.tech | Developer, gamer, blogger, maiden iron fan","2026-11-13 00:23:18",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add Blind-Striker\u002Fagent-skills-and-plugins --skill deniz-process.systematic-debugging",{"tool":39,"command":40},"bunx","bunx skills add Blind-Striker\u002Fagent-skills-and-plugins --skill deniz-process.systematic-debugging",{"tool":42,"command":43},"pnpm","pnpm dlx skills add Blind-Striker\u002Fagent-skills-and-plugins --skill deniz-process.systematic-debugging","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FBlind-Striker\u002Fagent-skills-and-plugins\u002Fblob\u002Fmaster\u002Fopencode\u002Fdeniz-process\u002Fskills\u002Fdeniz-process.systematic-debugging\u002FSKILL.md",true,[47,53,59,63,67],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"condition-based-waiting-example.ts","SCRIPT","脚本",5054,"https:\u002F\u002Fgithub.com\u002FBlind-Striker\u002Fagent-skills-and-plugins\u002Fblob\u002Fmaster\u002Fopencode\u002Fdeniz-process\u002Fskills\u002Fdeniz-process.systematic-debugging\u002Fcondition-based-waiting-example.ts",{"path":54,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":57,"sourceHtmlUrl":58},"condition-based-waiting.md","REFERENCE","参考文档",3516,"https:\u002F\u002Fgithub.com\u002FBlind-Striker\u002Fagent-skills-and-plugins\u002Fblob\u002Fmaster\u002Fopencode\u002Fdeniz-process\u002Fskills\u002Fdeniz-process.systematic-debugging\u002Fcondition-based-waiting.md",{"path":60,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":61,"sourceHtmlUrl":62},"defense-in-depth.md",3650,"https:\u002F\u002Fgithub.com\u002FBlind-Striker\u002Fagent-skills-and-plugins\u002Fblob\u002Fmaster\u002Fopencode\u002Fdeniz-process\u002Fskills\u002Fdeniz-process.systematic-debugging\u002Fdefense-in-depth.md",{"path":64,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":65,"sourceHtmlUrl":66},"find-polluter.sh",1986,"https:\u002F\u002Fgithub.com\u002FBlind-Striker\u002Fagent-skills-and-plugins\u002Fblob\u002Fmaster\u002Fopencode\u002Fdeniz-process\u002Fskills\u002Fdeniz-process.systematic-debugging\u002Ffind-polluter.sh",{"path":68,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":69,"sourceHtmlUrl":70},"root-cause-tracing.md",5321,"https:\u002F\u002Fgithub.com\u002FBlind-Striker\u002Fagent-skills-and-plugins\u002Fblob\u002Fmaster\u002Fopencode\u002Fdeniz-process\u002Fskills\u002Fdeniz-process.systematic-debugging\u002Froot-cause-tracing.md",[72,79,86,93,100,107],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":19},"01M79YGWBJ52PHMSTKJ3RJ3AWR","writing-tunit-tests","Write tests in TUnit — the attributes, the async assertion model, data-driven cases, lifecycle hooks, and the parallelism rules. USE FOR writing or fixing a test in a TUnit project, translating a test idea into TUnit syntax, or reviewing TUnit test code for API mistakes. DO NOT USE FOR deciding what to test, judging whether a test is any good, or running tests.","https:\u002F\u002Fgithub.com\u002FBlind-Striker\u002Fagent-skills-and-plugins\u002Fblob\u002Fmaster\u002Fskills\u002Fdeniz-dotnet-general\u002Fwriting-tunit-tests\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":19},"01M79YGR3Y9RCRS6TD71D0KKP8","dotnet-walls","Walls for a .NET change in a repository without its own quality gates — pinned, ephemeral analyzer, format, clone and scanner commands for the verify step, their identity ratchet, and the build traps. Use during a walls preflight, or when a worker's verify step needs .NET quality gates.","https:\u002F\u002Fgithub.com\u002FBlind-Striker\u002Fagent-skills-and-plugins\u002Fblob\u002Fmaster\u002Fskills\u002Fdeniz-dotnet-general\u002Fdotnet-walls\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":19},"01M79YGFNJBST7D803NQW3SBYM","csharp-15","Write, review and modernize C# 15 (.NET 11) code correctly. Covers every C# 15 feature - collection expression arguments (`[with(...), ...]`), union types (`union`, `[Union]`, `IUnion`, custom unions), closed class hierarchies (`closed`), extension indexers, labeled `break`\u002F`continue`, non-virtual static interface members on runtimes without default interface methods, and the preview memory-safety model (`unsafe(expr)`, `safe`, requires-unsafe members). Use when code targets net11.0 or LangVersion 15\u002Fpreview, when the user mentions any of these features, when replacing marker interfaces, OneOf-style results, `goto`\u002Fflag loop exits or capacity\u002Fcomparer boilerplate, or when the build reports CS8121, CS8509, CS8655, CS8510, CS0121\u002FCS0411 on a `with(...)` element, CS9370, CS9380 or CS9363.","https:\u002F\u002Fgithub.com\u002FBlind-Striker\u002Fagent-skills-and-plugins\u002Fblob\u002Fmaster\u002Fskills\u002Fdeniz-dotnet-general\u002Fcsharp-15\u002FSKILL.md",[],[],{"skillNo":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":19},"01M79YGAV031473HSX6FN87ENH","verified-waves","Run one task as verified multi-agent waves. Plans the fan-out, sends findings to fresh skeptics, keeps a ledger, and reports N of M done; small tasks stay solo.","https:\u002F\u002Fgithub.com\u002FBlind-Striker\u002Fagent-skills-and-plugins\u002Fblob\u002Fmaster\u002Fskills\u002Fdeniz-coordination\u002Fverified-waves\u002FSKILL.md",[],[],{"skillNo":101,"name":102,"nameZh":6,"description":103,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":104,"categories":105,"keywords":106,"publishedAt":19},"01M79YG6QXNND4WRPP3GATSY8J","harness","The bundled dispatch harness, which runs a task file on worker models through OpenCode or Codex, fences their writes, escalates their asks to the operator, settles each result from git and its verify commands, and records every step in a ledger. Its commands, task file, modes and write fence, configuration, runs and their recovery, ledger and exit codes.","https:\u002F\u002Fgithub.com\u002FBlind-Striker\u002Fagent-skills-and-plugins\u002Fblob\u002Fmaster\u002Fskills\u002Fdeniz-coordination\u002Fharness\u002FSKILL.md",[],[],{"skillNo":108,"name":109,"nameZh":6,"description":110,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":111,"categories":112,"keywords":113,"publishedAt":19},"01M79YG2P5S91SDTA5912XJ4FV","delegating-to-worker-models","Use when you hand off implementation, a plan, research a decision will rely on, or a review, and you brief the worker and check what comes back. A subagent that searches, reads in parallel, or keeps your context small is ordinary tool use. Covers what stays with you, the mechanism, assigning work by strength, the walls preflight, prompts without contradictions, the worker contract and model profiles, evidence from your own run, review, and the fix-up loop.","https:\u002F\u002Fgithub.com\u002FBlind-Striker\u002Fagent-skills-and-plugins\u002Fblob\u002Fmaster\u002Fskills\u002Fdeniz-coordination\u002Fdelegating-to-worker-models\u002FSKILL.md",[],[]]