Diagnostic Analysis
Diagnostic Analysis guides you through a four-phase debugging methodology that prioritizes root cause investigation over quick fixes. It emphasizes gathering evidence in multi-component systems, comparing working patterns, forming testable hypotheses, and implementing targeted solutions—stopping to question architecture if multiple fixes fail.
Diagnostic Analysis helps you debug issues methodically by finding root causes before attempting any fixes.
AI-generated summary based on this skill's SKILL.md
Install
qodex-ai/ai-agent-skills/diagnostic-analysis · repository language: Python
git clone https://github.com/qodex-ai/ai-agent-skills
cp -r ai-agent-skills ~/.claude/skills/diagnostic-analysisgenerated, unverified - the skill's exact subdirectory could not be determined; check the repository on GitHub
npx skillfed install qodex-ai/ai-agent-skills/diagnostic-analysisFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
What is Diagnostic Analysis and how does it work?
Diagnostic Analysis guides you through a four-phase debugging methodology that prioritizes root cause investigation over quick fixes. It emphasizes gathering evidence in multi-component systems, comparing working patterns, forming testable hypotheses, and implementing targeted solutions—stopping to question architecture if multiple fixes fail.
How do I run diagnostics using Diagnostic Analysis?
Diagnostic Analysis structures the diagnostic process into four phases: first, gather evidence across all system components; second, compare working versus broken patterns to isolate differences; third, form testable hypotheses about the root cause; and fourth, implement targeted solutions. This methodology ensures you address underlying issues rather than symptoms.
Can Diagnostic Analysis perform automated diagnostics?
Yes, Diagnostic Analysis supports automated diagnostics by systematically running checks across multi-component systems. It automates the evidence-gathering phase and helps identify performance problems and system issues, then guides you through structured analysis to determine root causes rather than applying surface-level fixes.
What does a diagnostic report from Diagnostic Analysis include?
Diagnostic Analysis generates diagnostic reports with findings and root cause analysis. Reports document the evidence gathered, patterns compared, hypotheses tested, and targeted solutions implemented. The methodology ensures reports capture the reasoning chain, helping teams understand not just what failed but why.
How does Diagnostic Analysis help with troubleshooting?
Diagnostic Analysis performs health checks and assessments on systems or processes, then uses diagnostic data and insights to guide troubleshooting. By emphasizing root cause investigation, it prevents wasted effort on quick fixes. If multiple fixes fail, it prompts you to question the underlying architecture rather than continuing symptom treatment.
When should I use Diagnostic Analysis for system issues?
Use Diagnostic Analysis whenever you encounter system issues, performance problems, or need health checks on multi-component systems. It's especially valuable when initial fixes don't resolve problems, helping you step back and investigate architecture. The methodology works best when you have access to diagnostic data and can compare working versus broken states.