{"enrichment":{"faq":[{"a":"Debug Investigator guides you through structured investigation: first capture detailed symptoms and build a reproducible feedback loop, then analyze evidence from stacktraces and logs to generate ranked hypotheses about the root cause. For each hypothesis, design targeted instrumentation and bisection strategies to test it. This hypothesis-driven methodology replaces ad-hoc troubleshooting, especially for non-obvious bugs like intermittent failures or performance regressions where native debugging falls short.","q":"How do I debug systematically with Debug Investigator?"},{"a":"Debug Investigator helps you rank competing hypotheses by likelihood and testability. Start by listing all plausible explanations for the observed symptoms, then score each by how well it explains the evidence and how easily you can test it. Prioritize hypotheses that are both probable and quick to validate. This ranking approach focuses your investigation effort on the most promising leads first, accelerating root cause discovery.","q":"What's the best way to rank bug hypotheses?"},{"a":"Debug Investigator incorporates git bisect as a core debugging strategy to narrow down exactly which commit introduced a bug. Bisect performs a binary search through your commit history, testing each midpoint to identify the culprit commit. This is especially powerful when you know a feature worked in the past but fails now\u2014bisect automates the detective work and pinpoints the exact change responsible.","q":"How can git bisect help find when a bug was introduced?"},{"a":"Debug Investigator tackles intermittent and non-obvious failures by designing a minimal reproduction strategy and targeted instrumentation points. Capture timing, concurrency context, and system state around failures. Build a reproducible feedback loop by adding logging or monitoring at suspected failure sites. Generate hypotheses about race conditions or timing-dependent bugs, then use bisection or targeted instrumentation to validate each one systematically.","q":"How do I isolate intermittent failures with no clear stacktrace?"},{"a":"Debug Investigator emphasizes minimal reproduction as a foundation for investigation. Strip away unrelated code and dependencies until you have the smallest possible case that triggers the bug. Document exact steps, inputs, and environment conditions needed to reproduce it. A solid minimal repro enables faster hypothesis testing, easier collaboration with teammates, and clearer root cause analysis once you isolate the problem.","q":"What steps should I follow to create a minimal reproduction?"},{"a":"Debug Investigator excels for complex, non-obvious bugs where native debuggers alone fall short: intermittent failures, performance regressions, race conditions, and issues with no clear stacktrace. Use it when you need structured methodology to generate and rank hypotheses, design bisection strategies, or instrument code systematically. For straightforward bugs with obvious stacktraces, native debugging may be faster; for everything else, Debug Investigator's systematic approach saves time.","q":"When should I use Debug Investigator instead of native debugging?"}],"shadow_tags":["root-cause-analysis","binary-search-debugging","hypothesis-ranking","intermittent-failures","instrumentation-strategy","evidence-driven","feedback-loop","systematic-investigation","minimal-repro","bisection-workflow"],"summary_rewrite":"Debug Investigator replaces ad-hoc troubleshooting with structured investigation: capture symptoms, build a reproducible feedback loop, analyze evidence from stacktraces and logs, generate ranked hypotheses, and design bisection strategies. Use it for non-obvious bugs\u2014intermittent failures, performance regressions, or issues requiring systematic root cause analysis\u2014where native debugging falls short."},"files":[{"bytes":14613,"path":"skills/debug-investigator/SKILL.md","sha256":"85f90b165b847e66227a4f80b996393151375c59942e123e69376cdc1f0a28c8","url":"https://skillfed.io/files/Mathews-Tom/armory/debug-investigator/6c0a0796/SKILL.md"}],"id":"Mathews-Tom/armory/debug-investigator","links":{"html":"https://skillfed.io/Mathews-Tom/armory/debug-investigator","md":"https://skillfed.io/Mathews-Tom/armory/debug-investigator.md","repo":"https://github.com/Mathews-Tom/armory"},"meta":{"agents_supported":[],"first_seen":"2026-07-28","forks":42,"language":"Python","last_updated":"2026-07-21","license":"MIT","name":"debug-investigator","publisher":"Mathews-Tom","stars":274},"relations":{"categories":["development","debugging","devops"],"similar":[{"id":"vinvcn/mattpocock-skills-zh-CN/diagnosing-bugs"},{"id":"NousResearch/hermes-agent/systematic-debugging"},{"id":"tobihagemann/turbo/investigate"},{"id":"mattpocock/skills/diagnosing-bugs"},{"id":"oldwinter/skills/diagnose"},{"id":"ArcReel/ArcReel/diagnosing-bugs"},{"id":"mxyhi/ok-skills/diagnosing-bugs"},{"id":"sammcj/agentic-coding/diagnose-hard-problem"},{"id":"stevesolun/ctx/diagnose"},{"id":"melodic-software/claude-code-plugins/debug"}]},"slug":{"owner":"Mathews-Tom","repo":"armory","skill":"debug-investigator"},"version":"6c0a0796"}