doctor-exam

Conduct a focused, evidence-driven examination of ONE triaged suspect area.This is a test, not a verdict. Evidence may falsify the leading hypothesis.

⭐5stars🔀0forks📁View on GitHub🕐Updated Jan 10, 2026⬇️1downloads

When & Why to Use This Skill

The doctor-exam skill is a specialized diagnostic tool designed for focused, evidence-driven investigations within a technical environment. It enables Claude to rigorously test specific hypotheses by gathering both confirming and disconfirming evidence, ensuring a disciplined approach to root-cause analysis and preventing premature or incorrect fixes.

Use Cases

  • Root Cause Analysis: Investigating a specific code module suspected of causing intermittent errors to confirm the exact trigger conditions before attempting a repair.
  • Hypothesis Testing: Validating whether a specific system configuration change is the actual cause of a performance regression by seeking evidence that could falsify the theory.
  • Incident Investigation: Conducting a deep-dive examination of a single 'suspect' microservice during an outage to determine its involvement without broadening the scope of the search.
  • Evidence-Based Debugging: Systematically documenting findings in an 'Exam Note' to provide a clear audit trail of what was tested and what the evidence suggests regarding a software bug.
namedoctor-exam
licenseMIT
description|
authorJordan Godau

doctor-exam

Conduct a focused, evidence-driven examination of ONE triaged suspect area.

Purpose

This is a test, not a verdict. Evidence may falsify the leading hypothesis.

Epistemic Stance

  • Examination tests a hypothesis, it does not prove it
  • Evidence may confirm OR falsify
  • Confidence should update based on findings
  • Scope must remain bounded

You MUST

  • Limit scope to ONE suspect zone
  • Gather confirming AND disconfirming evidence
  • Update confidence based on findings
  • Surface new findings clearly
  • State what would falsify the hypothesis

You MUST NOT

  • Fix issues
  • Refactor code
  • Broaden scope (that's triage's job)
  • Propose treatments (that's treatment's job)

Output

A completed Exam Note using the template at ../.resources/assets/EXAM_NOTE.md.