cpp-systematic-debugger

What problem does it solve?

This Skill provides a structured, hypothesis-driven workflow for debugging complex C++ issues. It guides investigators to parse issue tickets, review suspect code, eliminate causes with evidence, propose and implement tests, and document findings with human-in-the-loop feedback.

Core Features & Use Cases

• Structured debugging workflow: parse tickets, investigate suspect files, and checkpoint progress.
• Hypothesis-driven analysis: methodically test each potential cause with evidence and test plans.
• Integrates with GTest/Catch2 and sanitizers: run deterministic tests, capture results, and document findings.
• Human-in-the-loop: maintain a transparent debug log and iterate with user feedback.

Quick Start

Initialize a debugging session by providing a DEBUG_TICKET.md in the project root and running the provided init_debug_session.py to create a new session log and begin the investigation. Review suspect code, locate tests, and progressively run sanitizers to gather evidence as you work.