systematic-debugging

Diagnose software bugs through a structured four-phase root-cause investigation process.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Root-cause investigation for software bugs and unexpected behavior; prevents premature fixes by enforcing a structured four-phase process. It helps teams reproduce issues reliably, gather evidence, and form testable hypotheses before implementing changes.

Core Features & Use Cases

  • Four-phase root-cause investigation workflow (Phase 1 through Phase 4) with explicit completion criteria.
  • Tooling guidance for using standard developer instruments (read_file, search_files, terminal) to trace data flow, gather evidence, and validate hypotheses.
  • Suitable for debugging failures, flaky tests, and multi-component system problems across code, tests, and deployments.
  • Integrates with delegate tasks and test-driven development workflows to improve regression safety.

Quick Start

Initiate Phase 1 by reading error messages, reproducing the issue consistently, and collecting evidence with the provided tools.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is a systematic debugging workflow for software bugs?

Systematic debugging prevents premature fixes by enforcing a structured four-phase root-cause investigation. It guides engineers to reproduce issues reliably, gather evidence, and form testable hypotheses before implementing code changes.

How do I diagnose flaky tests and multi-component system failures?

You can diagnose flaky tests and multi-component system failures by applying a phase-based investigation process. This approach uses standard developer tools to trace data flow, gather evidence, and validate hypotheses across code, tests, and deployments.

What's the best way to reproduce issues consistently before fixing bugs?

The best way to reproduce issues consistently is to initiate a structured root-cause investigation. Start by reading error messages, reproducing the issue reliably, and collecting evidence with standard developer tools before forming testable hypotheses.

Can I integrate test-driven development with root-cause investigation?

Yes, root-cause investigation integrates with test-driven development workflows and delegate tasks. This integration improves regression safety while you trace data flow and validate hypotheses during bug resolution.

Does this debugging method work for tracing data flow across deployments?

Yes, this debugging method works for tracing data flow across deployments. It provides tooling guidance for using standard developer instruments like terminal, read_file, and search_files to gather evidence and validate hypotheses in multi-component systems.

When should I avoid premature fixes during troubleshooting?

You should avoid premature fixes during troubleshooting when you lack reproducibility and evidence. A disciplined, phase-based workflow enforces explicit completion criteria for reproducibility and hypothesis testing before you implement changes.