diagnose

Diagnose intermittent software bugs and performance regressions through a disciplined debugging workflow.

25|5|Updated Apr 22, 2017
One-click install
npx skills add https://github.com/assofohdz/subspace-infinity --skill diagnose-assofohdz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diagnose
Source: https://github.com/assofohdz/subspace-infinity/tree/main/.agents/skills/diagnose
Command: npx skills add https://github.com/assofohdz/subspace-infinity --skill diagnose-assofohdz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Unstructured, guess-based debugging of hard bugs and performance regressions wastes developer time and often fails to identify root causes, especially for intermittent or non-deterministic issues.

Core Features & Use Cases

  • 6-Phase Disciplined Loop: Enforces a repeatable workflow from building a reproduction loop through cleanup and post-mortem, skipping phases only with explicit justification.
  • Reproduction Loop Guidance: Provides 10 ranked strategies to build fast, deterministic, agent-runnable feedback loops for even flaky bugs, including test harnesses, trace replay, and bisection setups.
  • Use Case: If your Java game server has an intermittent lag spike that only occurs under high load, use this skill to systematically isolate the root cause instead of random log inspection.

Quick Start

Use the diagnose skill to investigate the intermittent server lag spike reported in the latest player feedback.

Frequently Asked Questions about diagnose

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

FAQPage Schema
How do I systematically debug intermittent software bugs instead of guessing?

Systematic bug diagnosis requires building a deterministic reproduction loop and testing falsifiable hypotheses. This enforces a disciplined 6-phase workflow that eliminates ad-hoc investigation by guiding you from reproduction through hypothesis validation and regression testing.

What is the best way to find the root cause of a performance regression?

Root cause analysis for performance regression involves targeted instrumentation and building fast feedback loops. This workflow enforces hypothesis testing and regression tests to validate and lock in fixes, replacing random code inspection with a structured, repeatable debugging process.

How do I create a deterministic reproduction loop for flaky, non-deterministic failures?

Creating a deterministic reproduction loop for flaky failures utilizes ranked strategies like test harnesses, trace replay, and bisection setups. These approaches build fast, agent-runnable feedback loops that reliably trigger intermittent defects for consistent investigation.

Can I skip phases in a structured debugging workflow if I already know the issue?

Skipping phases in the debugging workflow requires explicit justification. The disciplined 6-phase loop enforces progression from reproduction loop building through cleanup and post-mortem, ensuring no critical diagnostic steps are bypassed without documented reasoning.

Does hypothesis testing work for diagnosing hard bugs in high-load server environments?

Hypothesis testing works for diagnosing hard bugs in high-load server environments by generating falsifiable assumptions and applying targeted instrumentation. This isolates root causes of intermittent lag spikes or failures under load, replacing inefficient random log inspection.

Why does random code inspection fail to identify non-deterministic defect root causes?

Random code inspection fails to identify non-deterministic defect root causes because it lacks a deterministic reproduction loop. Without structured hypothesis testing and targeted instrumentation, ad-hoc investigation cannot reliably isolate intermittent failures or validate fixes.