ferrox-systematic-debugging

Investigate bugs and failures to identify root causes before fixing.

21|9|Updated Jul 21, 2026
One-click install
npx skills add https://github.com/FerroxLabs/ferrox-factory --skill ferrox-systematic-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ferrox-systematic-debugging
Source: https://github.com/FerroxLabs/ferrox-factory/tree/main/skills-vendored/ferrox-systematic-debugging
Command: npx skills add https://github.com/FerroxLabs/ferrox-factory --skill ferrox-systematic-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you debug bugs, test failures, and unexpected behavior without guessing, so you can stop wasting time on symptom-fixes that create new problems.

Core Features & Use Cases

  • Root Cause Investigation: Read errors carefully, reproduce issues consistently, and check recent changes before proposing any fix.
  • Systematic Analysis: Compare against working examples, trace data flow through multi-component systems, and form a single testable hypothesis.
  • Safe Implementation: Create a failing test first, apply one minimal fix at a time, and verify the result before moving on.
  • Use Case: A flaky CI test, a production timeout, or a mysterious integration failure can be investigated in a disciplined sequence instead of with random patches.

Quick Start

Use the ferrox-systematic-debugging skill to investigate this failure step by step and identify the root cause before suggesting any fix.

Frequently Asked Questions about ferrox-systematic-debugging

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

FAQPage Schema
How do I find the root cause of a flaky CI test failure instead of just patching symptoms?

To find the root cause of a flaky CI test failure, you need systematic debugging that reproduces the issue consistently, checks recent changes, and traces data flow before attempting a fix. This approach forms a single testable hypothesis and creates a failing test to verify the exact failure point.

What is the best way to investigate a production timeout with unclear behavior?

The best way to investigate a production timeout is through disciplined root cause analysis that reads errors carefully and traces data flow through multi-component systems. By applying minimal hypothesis testing and verifying one fix at a time, you resolve the underlying timeout trigger without introducing new problems.

How do I debug integration issues without randomly guessing the fix?

Debugging integration issues without guessing requires a systematic investigation sequence: reproduce the issue, compare against working examples, and trace data flow across components. You then form a single testable hypothesis and apply one minimal fix at a time, verifying the result before moving on.

Can I use systematic debugging for both performance problems and unexpected application behavior?

Yes, systematic debugging applies to performance problems and unexpected behavior by identifying the root cause before any fix is attempted. It handles unclear behavior by requiring careful reproduction, pattern comparison, minimal hypothesis testing, and verification of each applied fix to ensure the issue is truly resolved.

When should I not use a systematic debugging approach for test failures?

You should bypass systematic debugging for test failures only when the root cause is already explicitly known and verified. If the failure has unclear behavior or stems from multi-component integration issues, a quick patch risks creating new problems, making disciplined investigation necessary.