diagnose

Diagnose hard bugs and performance regressions through a structured reproduction and testing loop.

1|Updated Aug 12, 2023

Search Tags:#instrumentation #diagnose #phases #hypothesis-testing #regression-testing #bug-reproduction #debugging-loop

Ready to run

npx skills add https://github.com/nktfh100/nixos-config --skill diagnose-nktfh100

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: diagnose
Source: https://github.com/nktfh100/nixos-config/tree/main/claude/skills/diagnose
Command: npx skills add https://github.com/nktfh100/nixos-config --skill diagnose-nktfh100

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

A disciplined, end-to-end debugging loop that reduces time-to-resolution for hard bugs and performance regressions by guiding structured reproduction, hypothesis generation, instrumentation, and regression testing.

Core Features & Use Cases

Reproduce bugs deterministically using a structured workflow.
Generate and rank hypotheses before testing.
Instrument code paths and collect targeted signals to validate predictions.
Conduct regression tests to ensure fixes hold across releases.
Suitable for reports of crashes, hangs, or slowdowns in complex systems.

Quick Start

Apply the six-phase diagnose loop to reproduce, hypothesise, instrument, and verify a fix.

Frequently Asked Questions about diagnose

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

FAQPage Schema

What is a structured debugging loop for resolving hard bugs and performance regressions?▼

A structured debugging loop is a disciplined workflow that reduces time-to-resolution for hard bugs by guiding deterministic reproduction, hypothesis generation, instrumentation, and regression testing.

How do I reproduce crashes and slowdowns deterministically during diagnosis?▼

You reproduce crashes and slowdowns deterministically by applying a structured workflow that isolates triggers, instruments targeted code paths, and collects signals to validate bug reproduction.

What's the best way to generate and rank hypotheses when debugging complex system hangs?▼

The best way to debug complex system hangs is using a disciplined diagnosis loop that generates and ranks hypotheses before testing them against targeted instrumentation signals.

How do I conduct regression testing to ensure bug fixes hold across releases?▼

You conduct regression testing by running test harnesses after applying a fix, verifying that the deterministic reproduction case fails safely and the fix holds without introducing new crashes.

Do I need test harnesses and instrumentation strategies to diagnose hard bugs?▼

Yes, diagnosing hard bugs requires test harnesses, instrumentation strategies, and clear rollback procedures to ensure deterministic diagnostics and validate hypothesis predictions accurately.