systematic-debugging

Diagnose software defects through a four-phase root cause analysis methodology.

Updated Jul 4, 2026
One-click install
npx skills add https://github.com/kimen-dev/kimen --skill systematic-debugging-kimen-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/kimen-dev/kimen/tree/main/.agents/skills/systematic-debugging
Command: npx skills add https://github.com/kimen-dev/kimen --skill systematic-debugging-kimen-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill prevents the common trap of applying superficial patches to symptoms, which often leads to recurring issues and technical debt. It enforces a disciplined, four-phase approach to ensure that every fix addresses the underlying root cause.

Core Features & Use Cases

  • Root Cause Investigation: Provides a structured framework to trace errors back to their origin rather than guessing at solutions.
  • Deterministic Reproduction: Mandates the creation of failing tests as the primary gate for any bug fix, ensuring long-term regression protection.
  • Architectural Escalation: Includes clear thresholds for when to stop patching and instead question the fundamental architecture of the system.

Quick Start

Invoke the systematic debugging skill to begin a root cause analysis for the current test failure by following the four-phase methodology.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
How do I fix recurring software bugs instead of just patching the symptoms?

Fixing recurring software bugs permanently requires prioritizing root cause analysis over symptom-based patching. A rigorous four-phase methodology traces errors back to their origin, enforcing deterministic reproduction and architectural validation to prevent technical debt.

Why do I need a failing test before fixing a production bug?

You need a failing test before fixing a production bug because deterministic reproduction is the primary gate for any bug fix. This strict adherence ensures long-term regression protection by validating that the root cause is resolved without introducing new defects.

When should I stop patching a defect and question my system architecture instead?

You should stop patching a defect and question your system architecture when the issue hits clear architectural escalation thresholds. If root cause investigation reveals fundamental design flaws causing unexpected system behaviors, architectural rework is necessary.

What is the best way to reproduce intermittent test failures for root cause investigation?

The best way to reproduce intermittent test failures for root cause investigation is to enforce strict deterministic reproduction. This methodology mandates creating a consistent failing test that reliably triggers the unexpected system behavior before attempting any resolution.

Does this debugging methodology work for troubleshooting unexpected system behaviors in production?

Yes, this debugging methodology works for troubleshooting unexpected system behaviors in production. It applies the same rigorous root-cause-first framework to technical troubleshooting scenarios including production bugs and test failures, ensuring reliable quality assurance.