systematic-debugging

Identify software bug root causes using a four-phase debugging process.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/DaddyElonMusk69/motis-agent --skill systematic-debugging-daddyelonmusk69
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/DaddyElonMusk69/motis-agent/tree/main/skills/software-development/systematic-debugging
Command: npx skills add https://github.com/DaddyElonMusk69/motis-agent --skill systematic-debugging-daddyelonmusk69

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Developers waste time applying superficial fixes without understanding why code fails, leading to regressions and increased technical debt.

Core Features & Use Cases

  • Four‑phase workflow guiding investigation, pattern analysis, hypothesis testing, and verified implementation.
  • Tool integrations such as terminal commands, file reading, and git history searches to gather evidence.
  • Applicable scenarios including test failures, production bugs, performance bottlenecks, and integration errors.

Quick Start

Use the systematic-debugging skill to diagnose and fix a failing test by following the four-phase process.

Frequently Asked Questions about systematic-debugging

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I identify the root cause of a software bug before applying a fix?

To identify a root cause, apply a four-phase systematic debugging workflow that gathers evidence using terminal commands, file searches, and git history to test hypotheses and verify the fix before implementation.

What is the best way to debug test failures without introducing regressions?

The best way to debug test failures is to use a systematic debugging process that investigates patterns, tests hypotheses against gathered evidence, and verifies the implemented fix to prevent regressions.

How do I investigate production crashes and performance issues using terminal and file-search tools?

You investigate production crashes and performance issues by executing terminal commands, reading files, and searching version-control history to collect evidence, analyze patterns, and confirm your hypothesis.

Can I use version-control history to find the root cause of integration problems?

Yes, you can search version-control history, such as git, to gather evidence for integration problems, which helps test hypotheses and verify the root cause during the systematic debugging workflow.

Does systematic debugging work for both performance bottlenecks and software crashes?

Yes, systematic debugging applies to performance bottlenecks, production crashes, test failures, and integration errors by guiding investigation, pattern analysis, hypothesis testing, and verified implementation across all scenarios.

Why do superficial fixes lead to increased technical debt when debugging software?

Superficial fixes lead to technical debt because they apply changes without understanding why code fails, causing regressions; a systematic root-cause debugging process prevents this by verifying fixes against gathered evidence.