adv-diagnose

Execute a multi-phase diagnostic workflow to isolate and resolve software bugs.

4|Updated Jan 22, 2026
One-click install
npx skills add https://github.com/Sharper-Flow/Advance --skill adv-diagnose
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adv-diagnose
Source: https://github.com/Sharper-Flow/Advance/tree/main/skills/adv-diagnose
Command: npx skills add https://github.com/Sharper-Flow/Advance --skill adv-diagnose

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill solves the problem of aimless, reactive debugging by enforcing a structured, evidence-based engineering loop that prevents scope drift and ensures fixes are verified.

Core Features & Use Cases

  • Feedback Loop Construction: Prioritizes the creation of deterministic, agent-runnable pass/fail signals before attempting any code changes.
  • Hypothesis-Driven Debugging: Forces the generation of ranked, falsifiable hypotheses to prevent premature or incorrect fixes.
  • Regression Prevention: Integrates regression testing and cleanup protocols to ensure the codebase remains stable and clean after a bug is resolved.

Quick Start

Invoke the adv-diagnose skill to begin a structured debugging session for the reported performance regression in the authentication module.

Frequently Asked Questions about adv-diagnose

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

FAQPage Schema
What is hypothesis-driven debugging and how does it prevent incorrect bug fixes?

A disciplined debugging loop prevents scope drift by enforcing a structured, evidence-based engineering loop. It prioritizes creating deterministic, agent-runnable pass/fail signals before attempting any code changes, ensuring fixes are verified through systematic instrumentation.

How do I isolate a software bug using a deterministic reproduction loop?

To isolate a software bug, prioritize creating deterministic, agent-runnable pass/fail signals before modifying code. This feedback loop construction establishes reliable reproduction, ensuring any code changes are validated against a consistent test signal.

How do I fix a performance regression without introducing new codebase issues?

Fix a performance regression by executing a multi-phase diagnostic workflow that integrates regression testing and cleanup protocols. This systematic instrumentation ensures the codebase remains stable and clean after the bug is resolved and remediation is verified.

Does evidence-based debugging work for complex engineering tasks with non-deterministic behavior?

Evidence-based debugging applies to complex engineering tasks by enforcing deterministic reproduction and hypothesis testing. By requiring agent-runnable pass/fail signals, it handles non-deterministic behavior through rigorous, multi-phase diagnostic workflows and systematic instrumentation.

When should I use a systematic diagnostic workflow instead of standard debugging?

Use a systematic diagnostic workflow for complex engineering tasks requiring deterministic reproduction, hypothesis testing, and verified remediation. It replaces standard debugging when aimless, reactive changes risk scope drift and lack evidence-based regression test coverage.