diagnose

Reproduce failure paths and trace execution to identify root causes.

Updated Jul 9, 2026
One-click install
npx skills add https://github.com/Covcloud-LLC/adhd-workflow --skill diagnose-covcloud-llc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diagnose
Source: https://github.com/Covcloud-LLC/adhd-workflow/tree/main/skills/diagnose
Command: npx skills add https://github.com/Covcloud-LLC/adhd-workflow --skill diagnose-covcloud-llc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of shallow bug fixing by forcing a rigorous, evidence-based investigation into the root cause of a defect before any code changes are proposed.

Core Features & Use Cases

  • Evidence-Based Tracing: Requires reproduction of the failure and verification via git history or code tracing to distinguish symptoms from root causes.
  • Structured Reporting: Automatically appends a formal diagnosis to the defect file, including confidence levels and specific recommended fixes.
  • Use Case: When a recurring bug appears in a production branch, use this skill to trace the failure to the exact line of code and generate a verified fix recommendation that avoids common pitfalls like symptom-masking.

Quick Start

Invoke the diagnose skill by asking the agent to root-cause the most recent defect found in the docs defects directory.

Frequently Asked Questions about diagnose

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

FAQPage Schema
How do I find the root cause of a software defect instead of just fixing the symptom?

To find the root cause of a software defect, you need evidence-based analysis that reproduces the failure path and traces execution. This approach validates hypotheses against git history and code evidence to identify the underlying mechanism before proposing fixes.

What is the best way to debug recurring bugs in a production branch?

The best way to debug recurring bugs in a production branch is to use structured defect tracking that traces the failure to the exact line of code. This generates a verified fix recommendation and appends a formal diagnosis with confidence levels to the defect file.

How do I trace code execution to identify the exact line of code causing a failure?

To trace code execution and identify the exact line of code causing a failure, reproduce the failure path and execute diagnostic commands within the repository file system. This confirms the failure mechanism by validating hypotheses against the actual code evidence.

Do I need git history access to perform evidence-based code analysis?

Yes, you need git history access to perform evidence-based code analysis. Validating hypotheses against git history is required to distinguish symptoms from root causes and verify the exact mechanism of failure within the structured documentation workflow.

Can I use repository file system access to execute diagnostic commands for defect tracking?

Yes, you can use repository file system access to execute diagnostic commands for defect tracking. The investigation requires the ability to execute these commands within the repository environment to confirm the failure mechanism and append a formal diagnosis to the defect file.